79 lines
2.1 KiB
Markdown
79 lines
2.1 KiB
Markdown
# Cordys CRM 前端工程
|
|
|
|
## 工程简介
|
|
|
|
使用 `monorepo` 模式管理前端工程，拆分为`lib-shared`公共资源包、`mobile`移动端工程包和`web`工程包。
|
|
|
|
## 工程结构
|
|
|
|
```plaintext
|
|
├── packages
|
|
│ ├── lib-shared # 公共库模块
|
|
│ │ ├── api # API 封装
|
|
│ │ ├── assets # 静态资源
|
|
│ │ ├── enums # 枚举
|
|
│ │ ├── hooks # 钩子函数
|
|
│ │ ├── locale # 国际化封装
|
|
│ │ ├── method # 工具函数
|
|
│ │ ├── model # 数据模型
|
|
│ │ ├── types # 全局类型声明
|
|
│ ├── mobile # 移动端项目
|
|
│ ├── web # WEB 端项目
|
|
```
|
|
|
|
## 工程初始化&运行
|
|
|
|
在`/packages`目录下运行依赖安装命令：
|
|
|
|
```node
|
|
pnpm i -w
|
|
```
|
|
|
|
统一构建工程：
|
|
|
|
```node
|
|
npm run build
|
|
```
|
|
|
|
## mobile 移动端工程包
|
|
|
|
移动端工程由 Vite+Vue3+TS+Vant-UI 基础框架组成。
|
|
|
|
运行移动端项目：
|
|
|
|
```node
|
|
cd package/mobile
|
|
npm run dev
|
|
```
|
|
|
|
在`package/mobile`下单独构建移动端项目：
|
|
|
|
```node
|
|
npm run build
|
|
```
|
|
|
|
### mobile 调试&开发
|
|
|
|
移动端项目接入了企业微信登录，所以在 PC 上开发调试时需要模拟登录态方便快速开发调试：
|
|
|
|
1. 先运行 `web` 项目，并登录，登录后打开控制台，将`localStorage`中的`sessionId`和`csrfToken`俩属性及值复制
|
|
2. 运行 `mobile` 项目，打开控制台，将第 1 步复制的`localStorage`属性值粘贴后，刷新页面即可模拟完成登录（登录过期的话重新登录`web`后再复制新的属性值到`mobile`页面中替换即可）
|
|
3. 在手机端调试，进入页面授权登录后，切换到`我的`菜单，短时间内点击 10 次用户名区域可唤出`Eruda`调试工具
|
|
|
|
## WEB 端工程包
|
|
|
|
WEB 端工程由 Vite+Vue3+TS+Naive-UI 基础框架组成。
|
|
|
|
运行 WEB 端项目：
|
|
|
|
```node
|
|
cd package/web
|
|
npm run dev
|
|
```
|
|
|
|
在`package/web`下单独构建 WEB 端项目：
|
|
|
|
```node
|
|
npm run build
|
|
```
|