CareyShop（简称 CS）是一套基于 ThinkPHP5 框架开发的高性能商城框架系统，秉承简洁、快速、极致的开发理念，框架内使用面向对象模块化调用，在多终端、跨平台时采用 REST API 架构来进行数据交互，可直接对接 PC、移动设备、小程序、云部署，构建 Android、IOS 的 APP。

放眼移动热潮、新零售概念、各类终端的增多，服务端会与各类前端进行交互，和第三方相互协作也更加紧密、频繁。出于这样的整体环境，我们摒弃传统开发方向，直接以 REST 架构为基础，将各类业务处理层模块化。

框架所有的业务处理逻辑存放在公共模块目录中，对于框架内的其他模块可通过面向对象的方式调用公共模块，而外部则以 API 接口进行交互，如此真正做到业务处理层的入口路径统一。具体开发使用请参见「CareyShop 完全开发手册」

CareyShop 整体的架构理念为前后端分离，这样更容易创建出私有云、微服务、分布式等。商城后台管理系统根据框架所提供的 API 接口而配套的后台管理系统，覆盖了所有管理需要用到的功能模块。

在您使用本项目前，请先安装好 node。项目技术栈基于 es2015+、vue、vuex、vue-router 、vue-cli4 、axios 和 element-ui，所有的请求数据都基于 rest 协议。

我们欢迎您在 CareyShop 项目的 GitHub 上报告 issue 或者 pull request。

如果您还不熟悉 GitHub 的 Fork and Pull 开发模式，您可以 阅读GitHub的文档 获得更多的信息。

官方网站

https://www.careyshop.cn

后端仓库

Github 仓库 | 码云仓库 | Coding 仓库 | Demo API 沙盒

后台仓库

Github 仓库 | 码云仓库 | Coding 仓库 | Demo 预览地址

https://doc.careyshop.cn

客户组API 使用手册

管理组API 使用手册

数据库词典

CareyShop 交流一群（QQ）：714593455

如果您以前运行过 webpack 项目，并且本机 node 版本 >= 8，可以忽略这一步。

node

在 node.js 官网下载合适您系统的 node.js（推荐 10 以上的版本），安装完毕后可查看版本号。

node -v
v10.13.0

npm -v
6.12.0

@vue/cli

此依赖建议全局安装，在适合的命令环境下输入： npm install -g @vue/cli

API 接口参数采用动态配置（发包后依旧可以修改配置文件），在「public\static\config」路径下存在「development」与「production」文件夹，分别代表开发环境与生产环境。

在各自文件夹下只能存在一个.json为后缀的配置文件（为了相对安全，文件名可以任意填写），具体配置如下：

{
  "BASE_API": "//demo.careyshop.cn/api",            // API 接口访问地址
  "APP_KEY": "86757125",                            // 后端获取的 App应用 钥匙
  "APP_SECRET": "ea1bd533d001fd73b09944f04c96a6fc"  // 后端获取的 App应用 密钥
}

# 克隆项目
git clone https://github.com/dnyz520/careyshop-admin.git

# 安装依赖
npm install
或
yarn

# 启动服务
npm run serve

# 正式发布
npm run build

# 检测修复
npm run lint

# 单元测试
npm run test:unit