chore: initial commit

frontend/REDEME.md

@@ -0,0 +1,78 @@
+# 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
+```