01 项目概述
1.1 项目定位
ecshopx-admin 是 ECShopX 的后台管理端,用于承载平台、商户、店铺及运营人员的日常管理操作。前端以 Vue 单页应用运行,通过统一请求层访问后端 API。
核心能力包括:登录与用户信息、菜单和权限、商品/订单/营销/店铺/系统管理、店铺装修、多语言、主题样式、文件上传和异常处理。
1.2 技术栈
| 层次 | 技术 |
|---|---|
| UI 框架 | Vue 2 |
| 构建工具 | Vue CLI 4、Webpack |
| 路由 | Vue Router |
| 状态管理 | Vuex |
| HTTP | Axios |
| UI 组件 | Element UI、项目公共组件 |
| 国际化 | Vue I18n |
| 样式 | Sass/SCSS |
| 语言 | JavaScript |
1.3 运行时结构
text
浏览器 → src/main.js → Bootstrap 初始化
├─ Vue、插件和全局组件
├─ Vuex Store
├─ Router / 权限
└─ i18n
→ App.vue → views/components → API request → 后端1.4 目录职责
text
src/
├── api/ 请求封装和业务 API
├── bootstrap/ 应用启动初始化
├── components/ 公共组件
├── layouts/ 页面布局
├── router/ 路由、权限和导航处理
├── store/ Vuex 状态模块
├── views/ 业务页面
├── i18n/ 国际化配置和语言资源
├── styles/ 全局样式和主题
├── utils/ 工具函数
└── App.vue 根组件新增功能时应按现有目录职责放置文件,避免在页面中重复实现请求、Token 和权限逻辑。
