Commit df137fbd33cdac21f6a89bebc94c33be49a0565a
1 parent
2d87685f
更新README.md,完善项目介绍和功能模块说明;调整开发环境配置,修改API地址为本地开发环境。
Showing
2 changed files
with
220 additions
and
269 deletions
README.md
| 1 | -# 绿纤ERP管理系统 | |
| 2 | - | |
| 3 | -## 项目简介 | |
| 1 | +# 绿纤美业ERP管理系统 | |
| 2 | + | |
| 3 | +## 📋 项目简介 | |
| 4 | + | |
| 5 | +绿纤美业ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统,专为绿纤美业行业量身定制。系统采用前后端分离架构,提供完整的门店管理、业绩统计、工资核算、报表分析、客户管理等业务管理功能。 | |
| 6 | + | |
| 7 | +**项目状态**:✅ 生产环境运行中 | 📅 最后更新:2025年1月 | |
| 8 | + | |
| 9 | +## 🎯 核心功能模块 | |
| 10 | + | |
| 11 | +### 📊 业绩统计系统 | |
| 12 | +- **个人业绩统计** - 健康师个人业绩统计,包含首单业绩、升单业绩等 | |
| 13 | +- **门店总业绩统计** - 门店整体业绩统计,包含总业绩、欠款金额等 | |
| 14 | +- **金三角业绩统计** - 金三角团队业绩统计和分析 | |
| 15 | +- **部门消耗业绩统计** - 部门消耗业绩统计,包含人头数、人次等 | |
| 16 | +- **科技部业绩统计** - 科技部老师业绩统计 | |
| 17 | +- **门店消耗业绩统计** - 门店消耗业绩统计 | |
| 18 | + | |
| 19 | +### 💰 工资核算系统 | |
| 20 | +- **健康师工资核算** - 健康师底薪、提成、奖励等自动计算 | |
| 21 | +- **店长工资核算** - 店长工资计算,包含底薪、提成、奖励等 | |
| 22 | +- **主任工资核算** - 主任工资计算,包含底薪、提成、奖励等 | |
| 23 | +- **大项目主管工资核算** - 大项目主管工资计算 | |
| 24 | +- **科技部总经理工资核算** - 科技部总经理工资计算 | |
| 25 | +- **事业部总经理工资核算** - 事业部总经理工资计算 | |
| 26 | + | |
| 27 | +### 📈 报表分析系统 | |
| 28 | +- **门店业绩趋势** - 门店业绩时间趋势分析 | |
| 29 | +- **门店业绩排行榜** - 门店业绩排名统计 | |
| 30 | +- **健康师业绩趋势** - 健康师个人业绩趋势 | |
| 31 | +- **健康师业绩排行榜** - 健康师业绩排名统计 | |
| 32 | +- **金三角业绩趋势** - 金三角团队业绩趋势 | |
| 33 | +- **综合仪表盘** - 多维度数据汇总展示 | |
| 34 | + | |
| 35 | +### 🏪 门店管理系统 | |
| 36 | +- **门店信息管理** - 门店基础信息维护 | |
| 37 | +- **门店归属管理** - 门店归属事业部、教育部、科技部等 | |
| 38 | +- **新店保护时间** - 新店保护期管理 | |
| 39 | +- **门店股份统计** - 门店股份统计和分析 | |
| 4 | 40 | |
| 5 | -绿纤ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统,专为绿纤行业量身定制。系统采用前后端分离架构,提供完整的门店管理、业绩统计、工资核算、报表分析等业务管理功能。 | |
| 41 | +### 👥 人员管理系统 | |
| 42 | +- **金三角设定** - 金三角团队配置管理 | |
| 43 | +- **金三角用户绑定** - 用户与金三角团队绑定关系 | |
| 44 | +- **顾问身份管理** - 根据金三角绑定自动设置顾问身份 | |
| 6 | 45 | |
| 7 | -## 🎯 核心功能亮点 | |
| 46 | +### 📋 客户管理系统 | |
| 47 | +- **客户信息管理** - 客户档案管理 | |
| 48 | +- **拓客记录管理** - 拓客活动记录 | |
| 49 | +- **拓客活动管理** - 拓客活动配置 | |
| 50 | +- **会员权益管理** - 历史会员权益数据管理 | |
| 51 | +- **用户画像** - 会员画像数据分析和展示 | |
| 8 | 52 | |
| 9 | -- **📊 业绩统计系统** - 门店业绩、个人业绩、金三角业绩等多维度统计 | |
| 10 | -- **💰 工资核算系统** - 健康师底薪、提成、奖励等自动计算 | |
| 11 | -- **📈 报表分析系统** - 可视化图表、趋势分析、排行榜展示 | |
| 12 | -- **🏪 门店管理系统** - 门店信息、归属管理、新店保护 | |
| 13 | -- **👥 人员管理系统** - 健康师管理、金三角团队管理 | |
| 14 | -- **📋 客户管理系统** - 客户信息、会员权益、拓客记录 | |
| 53 | +### 🔧 其他业务模块 | |
| 54 | +- **合同管理系统** - 合同信息管理 | |
| 55 | +- **合作成本管理** - 合作成本表管理 | |
| 56 | +- **店内支出管理** - 店内支出表管理 | |
| 57 | +- **库存使用审批** - 库存使用审批流程 | |
| 58 | +- **年度汇总统计** - 年度经营统计分析 | |
| 15 | 59 | |
| 16 | -## 技术栈 | |
| 60 | +## 🛠 技术栈 | |
| 17 | 61 | |
| 18 | 62 | ### 后端技术 |
| 19 | 63 | - **.NET Core 3.1/5.0** - 跨平台Web框架 |
| ... | ... | @@ -32,7 +76,11 @@ |
| 32 | 76 | - **SCSS** - CSS预处理器 |
| 33 | 77 | - **ECharts** - 数据可视化图表库 |
| 34 | 78 | |
| 35 | -## 项目结构 | |
| 79 | +### 移动端 | |
| 80 | +- **uni-app** - 跨平台移动应用框架 | |
| 81 | +- **微信小程序** - 支持微信小程序平台 | |
| 82 | + | |
| 83 | +## 📁 项目结构 | |
| 36 | 84 | |
| 37 | 85 | ``` |
| 38 | 86 | lvqianmeiye_ERP/ |
| ... | ... | @@ -51,7 +99,7 @@ lvqianmeiye_ERP/ |
| 51 | 99 | │ ├── Order/ # 订单管理模块 |
| 52 | 100 | │ ├── VisualDev/ # 可视化开发模块 |
| 53 | 101 | │ └── Tenant/ # 多租户支持模块 |
| 54 | -├── antis-ncc-admin/ # 前端Vue项目 | |
| 102 | +├── antis-ncc-admin/ # 前端Vue管理后台 | |
| 55 | 103 | │ ├── src/ |
| 56 | 104 | │ │ ├── api/ # API接口 |
| 57 | 105 | │ │ ├── components/ # 公共组件 |
| ... | ... | @@ -63,12 +111,44 @@ lvqianmeiye_ERP/ |
| 63 | 111 | │ │ │ ├── techPerformanceStatistics/ # 科技部业绩统计 |
| 64 | 112 | │ │ │ ├── storeConsumePerformanceStatistics/ # 门店消耗业绩统计 |
| 65 | 113 | │ │ │ ├── report/ # 报表分析页面 |
| 66 | -│ │ │ └── ... # 其他业务页面 | |
| 114 | +│ │ │ └── extend/ # 其他业务页面 | |
| 67 | 115 | │ │ ├── router/ # 路由配置 |
| 68 | 116 | │ │ └── store/ # 状态管理 |
| 69 | 117 | │ ├── package.json # 前端依赖配置 |
| 70 | 118 | │ └── vue.config.js # Vue构建配置 |
| 71 | -└── html/ # 静态资源 | |
| 119 | +├── 绿纤uni-app/ # 移动端uni-app项目 | |
| 120 | +│ ├── pages/ # 页面文件 | |
| 121 | +│ ├── components/ # 组件 | |
| 122 | +│ ├── apis/ # API接口 | |
| 123 | +│ └── service/ # 服务层 | |
| 124 | +├── 绿纤html/ # 静态HTML页面 | |
| 125 | +│ ├── appointment.html # 预约页面 | |
| 126 | +│ ├── expansion.html # 拓客页面 | |
| 127 | +│ ├── member-consume.html # 会员消耗页面 | |
| 128 | +│ └── ... # 其他页面 | |
| 129 | +├── docs/ # 📚 项目文档 | |
| 130 | +│ ├── 数据库说明.md # 数据库文档 | |
| 131 | +│ ├── 工资计算规则梳理.md # 工资计算规则文档 | |
| 132 | +│ ├── 接口文档.md # API接口文档 | |
| 133 | +│ └── ... # 其他需求文档 | |
| 134 | +├── scripts/ # 🔧 脚本工具 | |
| 135 | +│ ├── sh/ # Shell测试脚本 | |
| 136 | +│ │ ├── test_*.sh # 接口测试脚本 | |
| 137 | +│ │ └── verify_*.sh # 数据验证脚本 | |
| 138 | +│ └── py/ # Python工具脚本 | |
| 139 | +│ ├── export_*.py # 数据导出脚本 | |
| 140 | +│ └── generate_*.py # 数据生成脚本 | |
| 141 | +├── sql/ # 📊 SQL脚本 | |
| 142 | +│ ├── 表结构.sql # 数据库表结构 | |
| 143 | +│ ├── 初始化数据.sql # 初始化数据脚本 | |
| 144 | +│ └── ... # 其他SQL脚本 | |
| 145 | +├── excel/ # 📄 Excel模板文件 | |
| 146 | +│ ├── 健康师额外数据模板.xlsx | |
| 147 | +│ ├── 合作成本表.xlsx | |
| 148 | +│ └── ... # 其他模板文件 | |
| 149 | +├── ExportFiles/ # 📤 导出文件目录 | |
| 150 | +├── PROJECT_RULES.md # 项目开发规范 | |
| 151 | +└── README.md # 项目说明文档 | |
| 72 | 152 | ``` |
| 73 | 153 | |
| 74 | 154 | ## 🎯 核心业务模块说明 |
| ... | ... | @@ -76,14 +156,18 @@ lvqianmeiye_ERP/ |
| 76 | 156 | **Extend模块**是系统的核心业务模块,包含绿纤ERP的所有业务逻辑。该模块采用三层架构设计: |
| 77 | 157 | |
| 78 | 158 | ### NCC.Extend(业务服务层) |
| 79 | -包含所有业务服务的具体实现,按功能分类: | |
| 80 | 159 | |
| 81 | 160 | #### 📊 业绩统计类 |
| 82 | 161 | - `LqStatisticsService` - 核心统计服务(个人业绩、门店业绩、金三角业绩等) |
| 83 | 162 | - `LqReportService` - 报表分析服务(趋势图、排行榜、仪表盘) |
| 84 | 163 | |
| 85 | 164 | #### 💰 工资核算类 |
| 86 | -- `LqGzService` - 工资核算服务(健康师底薪、提成计算) | |
| 165 | +- `LqGzService` - 健康师工资核算服务 | |
| 166 | +- `LqStoreManagerSalaryService` - 店长工资核算服务 | |
| 167 | +- `LqDirectorSalaryService` - 主任工资核算服务 | |
| 168 | +- `LqMajorProjectDirectorSalaryService` - 大项目主管工资核算服务 | |
| 169 | +- `LqTechGeneralManagerSalaryService` - 科技部总经理工资核算服务 | |
| 170 | +- `LqBusinessUnitManagerSalaryService` - 事业部总经理工资核算服务 | |
| 87 | 171 | |
| 88 | 172 | #### 🏪 门店管理类 |
| 89 | 173 | - `LqMdxxService` - 门店信息管理服务 |
| ... | ... | @@ -105,40 +189,29 @@ lvqianmeiye_ERP/ |
| 105 | 189 | - `WorkLogService` - 工作日志服务 |
| 106 | 190 | |
| 107 | 191 | ### NCC.Extend.Entitys(实体模型层) |
| 108 | -- **Entity/** - 数据库实体模型(包含统计表、工资表等核心实体) | |
| 109 | - - `lq_statistics_personal_performance/` - 个人业绩统计实体 | |
| 110 | - - `lq_statistics_store_total_performance/` - 门店总业绩统计实体 | |
| 111 | - - `lq_statistics_gold_triangle/` - 金三角业绩统计实体 | |
| 112 | - - `lq_statistics_department_consume_performance/` - 部门消耗业绩统计实体 | |
| 113 | - - `lq_statistics_tech_performance/` - 科技部业绩统计实体 | |
| 114 | - - `lq_statistics_store_consume_performance/` - 门店消耗业绩统计实体 | |
| 115 | - - `lq_salary_statistics/` - 工资统计实体 | |
| 116 | -- **Dto/** - 数据传输对象(包含统计、报表等DTO) | |
| 192 | +- **Entity/** - 数据库实体模型 | |
| 193 | +- **Dto/** - 数据传输对象 | |
| 117 | 194 | - **Mapper/** - 对象映射配置 |
| 118 | 195 | - **Model/** - 业务模型类 |
| 119 | 196 | |
| 120 | -### NCC.Extend.Interfaces(接口定义层) | |
| 121 | -- 定义所有业务服务的接口契约 | |
| 122 | -- 支持依赖注入和单元测试 | |
| 123 | -- 提供清晰的业务边界 | |
| 197 | +## 🚀 快速开始 | |
| 124 | 198 | |
| 125 | -## 环境要求 | |
| 199 | +### 环境要求 | |
| 126 | 200 | |
| 127 | -### 开发环境 | |
| 128 | -- **Node.js**: 16.20.2 (必须使用此版本) | |
| 201 | +#### 开发环境 | |
| 202 | +- **Node.js**: 16.20.2 (⚠️ 必须使用此版本,其他版本可能不兼容) | |
| 129 | 203 | - **.NET Core SDK**: 3.1 或 5.0 |
| 130 | 204 | - **MySQL**: 5.7 或 8.0 |
| 131 | 205 | - **Visual Studio 2019/2022** 或 **VS Code** |
| 132 | 206 | |
| 133 | -### 浏览器支持 | |
| 207 | +#### 浏览器支持 | |
| 134 | 208 | - Chrome 70+ |
| 135 | 209 | - Firefox 65+ |
| 136 | 210 | - Safari 12+ |
| 137 | 211 | - Edge 79+ |
| 138 | 212 | |
| 139 | -## 快速开始 | |
| 140 | - | |
| 141 | 213 | ### 1. 克隆项目 |
| 214 | + | |
| 142 | 215 | ```bash |
| 143 | 216 | git clone [项目地址] |
| 144 | 217 | cd lvqianmeiye_ERP |
| ... | ... | @@ -175,182 +248,75 @@ npm run dev |
| 175 | 248 | - 后端API:http://localhost:5000 |
| 176 | 249 | - API文档:http://localhost:5000/antis.doc |
| 177 | 250 | |
| 178 | -## 默认账号 | |
| 179 | - | |
| 251 | +### 默认账号 | |
| 180 | 252 | - **管理员账号**:admin |
| 181 | 253 | - **默认密码**:123456 |
| 182 | 254 | |
| 183 | -## 主要功能模块 | |
| 184 | - | |
| 185 | -> 💡 **说明**:所有业务功能的核心代码都位于 `netcore/src/Modularity/Extend/` 模块中 | |
| 186 | - | |
| 187 | -### 📊 业绩统计模块 | |
| 188 | -- **个人业绩统计** (`LqStatisticsService`) - 健康师个人业绩统计,包含首单业绩、升单业绩等 | |
| 189 | -- **门店总业绩统计** (`LqStatisticsService`) - 门店整体业绩统计,包含总业绩、欠款金额等 | |
| 190 | -- **金三角业绩统计** (`LqStatisticsService`) - 金三角团队业绩统计和分析 | |
| 191 | -- **部门消耗业绩统计** (`LqStatisticsService`) - 部门消耗业绩统计,包含人头数、人次等 | |
| 192 | -- **科技部业绩统计** (`LqStatisticsService`) - 科技部老师业绩统计 | |
| 193 | -- **门店消耗业绩统计** (`LqStatisticsService`) - 门店消耗业绩统计 | |
| 194 | - | |
| 195 | -### 💰 工资核算模块 | |
| 196 | -- **工资统计** (`LqGzService`) - 健康师工资核算,包含底薪、提成、奖励等 | |
| 197 | -- **底薪计算** - 根据业绩标准自动计算健康师底薪(一星、二星、三星标准) | |
| 198 | -- **提成计算** - 根据业绩类型计算各类提成(基础业绩、合作业绩、奖励业绩等) | |
| 199 | -- **占比计算** - 队伍业绩与个人总业绩的占比分析 | |
| 200 | - | |
| 201 | -### 📈 报表分析模块 | |
| 202 | -- **门店业绩趋势** (`LqReportService`) - 门店业绩时间趋势分析 | |
| 203 | -- **门店业绩排行榜** (`LqReportService`) - 门店业绩排名统计 | |
| 204 | -- **健康师业绩趋势** (`LqReportService`) - 健康师个人业绩趋势 | |
| 205 | -- **健康师业绩排行榜** (`LqReportService`) - 健康师业绩排名统计 | |
| 206 | -- **金三角业绩趋势** (`LqReportService`) - 金三角团队业绩趋势 | |
| 207 | -- **金三角业绩排行榜** (`LqReportService`) - 金三角团队排名统计 | |
| 208 | -- **综合仪表盘** (`LqReportService`) - 多维度数据汇总展示 | |
| 209 | - | |
| 210 | -### 🏪 门店管理模块 | |
| 211 | -- **门店信息管理** (`LqMdxxService`) - 门店基础信息维护 | |
| 212 | -- **门店归属管理** - 门店归属事业部、教育部、科技部等 | |
| 213 | -- **新店保护时间** (`LqMdXdbhsjService`) - 新店保护期管理 | |
| 255 | +## 📚 项目文档 | |
| 214 | 256 | |
| 215 | -### 👥 人员管理模块 | |
| 216 | -- **金三角设定** (`LqYcsdJsjService`) - 金三角团队配置管理 | |
| 217 | -- **金三角用户绑定** (`LqJinsanjiaoUserService`) - 用户与金三角团队绑定关系 | |
| 218 | -- **顾问身份管理** - 根据金三角绑定自动设置顾问身份 | |
| 257 | +项目文档统一存放在 `docs/` 目录下,包含: | |
| 219 | 258 | |
| 220 | -### 📋 客户管理模块 | |
| 221 | -- **客户信息管理** (`LqKhxxService`) - 客户档案管理 | |
| 222 | -- **拓客记录管理** (`LqTkjlbService`) - 拓客活动记录 | |
| 223 | -- **拓客活动管理** (`LqEventService`) - 拓客活动配置 | |
| 224 | -- **会员权益管理** - 历史会员权益数据管理 | |
| 259 | +### 核心文档 | |
| 260 | +- **数据库说明.md** - 数据库表结构、字段说明、关联关系 | |
| 261 | +- **PROJECT_RULES.md** - 项目开发规范、编码规范、最佳实践 | |
| 225 | 262 | |
| 226 | -### ⚙️ 系统管理模块(位于System模块) | |
| 227 | -- **用户管理** - 系统用户维护,用户权限管理 | |
| 228 | -- **角色权限** - 权限分配管理,角色权限配置 | |
| 229 | -- **系统配置** - 系统参数设置,基础配置维护 | |
| 230 | -- **日志管理** - 操作日志查看,系统日志分析 | |
| 231 | - | |
| 232 | -## 开发指南 | |
| 233 | - | |
| 234 | -### 🎯 核心业务开发(Extend模块) | |
| 235 | - | |
| 236 | -#### 统计服务开发规范 | |
| 237 | -1. **统计表实体** (`NCC.Extend.Entitys/Entity/lq_statistics_*/`) | |
| 238 | - ```csharp | |
| 239 | - [SugarTable("lq_statistics_新统计表")] | |
| 240 | - [Tenant(ClaimConst.TENANT_ID)] | |
| 241 | - public class LqStatistics新统计Entity | |
| 242 | - { | |
| 243 | - [SugarColumn(ColumnName = "F_Id", IsPrimaryKey = true)] | |
| 244 | - public string Id { get; set; } | |
| 245 | - | |
| 246 | - [SugarColumn(ColumnName = "F_StatisticsMonth")] | |
| 247 | - public string StatisticsMonth { get; set; } | |
| 248 | - | |
| 249 | - // 其他统计字段... | |
| 250 | - } | |
| 251 | - ``` | |
| 252 | - | |
| 253 | -2. **统计DTO对象** (`NCC.Extend.Entitys/Dto/LqStatistics/`) | |
| 254 | - - `Lq新统计ListQueryInput` - 列表查询输入 | |
| 255 | - - `Lq新统计ListOutput` - 列表输出DTO | |
| 256 | - | |
| 257 | -3. **统计服务实现** (`LqStatisticsService`) | |
| 258 | - ```csharp | |
| 259 | - /// <summary> | |
| 260 | - /// 保存新统计数据 | |
| 261 | - /// </summary> | |
| 262 | - public async Task Save新统计Statistics(string statisticsMonth) | |
| 263 | - { | |
| 264 | - // 统计逻辑实现 | |
| 265 | - } | |
| 266 | - | |
| 267 | - /// <summary> | |
| 268 | - /// 获取新统计列表 | |
| 269 | - /// </summary> | |
| 270 | - public async Task<dynamic> Get新统计StatisticsList(Lq新统计ListQueryInput input) | |
| 271 | - { | |
| 272 | - // 查询逻辑实现 | |
| 273 | - } | |
| 274 | - ``` | |
| 275 | - | |
| 276 | -#### 报表服务开发规范 | |
| 277 | -1. **报表接口定义** (`NCC.Extend.Interfaces/LqReport/`) | |
| 278 | - ```csharp | |
| 279 | - public interface ILqReportService | |
| 280 | - { | |
| 281 | - Task<object> Get新报表Data(新报表Input input); | |
| 282 | - } | |
| 283 | - ``` | |
| 284 | - | |
| 285 | -2. **报表服务实现** (`LqReportService`) | |
| 286 | - ```csharp | |
| 287 | - [HttpPost("get-新报表-data")] | |
| 288 | - public async Task<object> Get新报表Data(新报表Input input) | |
| 289 | - { | |
| 290 | - // 报表数据查询和格式化 | |
| 291 | - } | |
| 292 | - ``` | |
| 293 | - | |
| 294 | -#### 前端页面开发规范 | |
| 295 | -1. **统计页面组件** (`antis-ncc-admin/src/views/新统计Statistics/`) | |
| 296 | - - `index.vue` - 统计列表页面 | |
| 297 | - - 使用 `NCC-table` 组件 | |
| 298 | - - 支持分页、筛选、导出功能 | |
| 299 | - | |
| 300 | -2. **报表页面组件** (`antis-ncc-admin/src/views/report/`) | |
| 301 | - - 集成到现有报表页面 | |
| 302 | - - 使用 ECharts 图表组件 | |
| 303 | - - 支持时间筛选、类型切换 | |
| 304 | - | |
| 305 | -3. **API接口** (`antis-ncc-admin/src/api/`) | |
| 306 | - ```javascript | |
| 307 | - // 统计接口 | |
| 308 | - export function get新统计StatisticsList(data) { | |
| 309 | - return request({ | |
| 310 | - url: '/api/Extend/LqStatistics/get-新统计-statistics-list', | |
| 311 | - method: 'post', | |
| 312 | - data | |
| 313 | - }) | |
| 314 | - } | |
| 315 | - | |
| 316 | - // 报表接口 | |
| 317 | - export function get新报表Data(data) { | |
| 318 | - return request({ | |
| 319 | - url: '/api/Extend/LqReport/get-新报表-data', | |
| 320 | - method: 'post', | |
| 321 | - data | |
| 322 | - }) | |
| 323 | - } | |
| 324 | - ``` | |
| 325 | - | |
| 326 | -### 前端开发 | |
| 327 | -```bash | |
| 328 | -# 开发模式 | |
| 329 | -npm run dev | |
| 263 | +### 业务文档 | |
| 264 | +- **工资计算规则梳理.md** - 各类工资计算规则说明 | |
| 265 | + - 健康师工资计算规则 | |
| 266 | + - 店长工资计算规则 | |
| 267 | + - 主任工资计算规则 | |
| 268 | + - 大项目主管工资计算规则 | |
| 269 | + - 科技部总经理工资计算规则 | |
| 270 | + - 事业部总经理工资计算规则 | |
| 271 | +- **接口文档.md** - API接口调用说明 | |
| 272 | +- **需求分析文档** - 各类业务需求分析文档 | |
| 330 | 273 | |
| 331 | -# 构建生产版本 | |
| 332 | -npm run build | |
| 274 | +### 查看文档 | |
| 275 | +```bash | |
| 276 | +# 查看所有文档 | |
| 277 | +ls docs/ | |
| 333 | 278 | |
| 334 | -# 代码检查 | |
| 335 | -npm run lint | |
| 279 | +# 查看特定文档 | |
| 280 | +cat docs/数据库说明.md | |
| 336 | 281 | ``` |
| 337 | 282 | |
| 338 | -### 后端开发 | |
| 283 | +## 🔧 脚本工具 | |
| 284 | + | |
| 285 | +项目提供了丰富的脚本工具,位于 `scripts/` 目录下: | |
| 286 | + | |
| 287 | +### Shell测试脚本 (`scripts/sh/`) | |
| 288 | +用于接口测试和数据验证: | |
| 339 | 289 | ```bash |
| 340 | -# 还原包 | |
| 341 | -dotnet restore | |
| 290 | +# 测试个人业绩统计接口 | |
| 291 | +./scripts/sh/test_personal_performance_api.sh | |
| 342 | 292 | |
| 343 | -# 编译项目 | |
| 344 | -dotnet build | |
| 293 | +# 测试门店总业绩统计接口 | |
| 294 | +./scripts/sh/test_store_total_performance_statistics.sh | |
| 345 | 295 | |
| 346 | -# 运行项目 | |
| 347 | -dotnet run | |
| 296 | +# 验证门店总业绩数据 | |
| 297 | +./scripts/sh/verify_store_total_performance_data.sh | |
| 298 | +``` | |
| 299 | + | |
| 300 | +### Python工具脚本 (`scripts/py/`) | |
| 301 | +用于数据导出和生成: | |
| 302 | +```bash | |
| 303 | +# 导出所有会员剩余权益数据 | |
| 304 | +python scripts/py/export_all_member_remaining_rights.py | |
| 348 | 305 | |
| 349 | -# 发布项目 | |
| 350 | -dotnet publish -c Release | |
| 306 | +# 生成客户Excel数据 | |
| 307 | +python scripts/py/generate_november_customer_excel.py | |
| 351 | 308 | ``` |
| 352 | 309 | |
| 353 | -## 配置说明 | |
| 310 | +## 📊 SQL脚本 | |
| 311 | + | |
| 312 | +数据库相关SQL脚本存放在 `sql/` 目录下: | |
| 313 | + | |
| 314 | +- **表结构脚本** - 数据库表结构定义 | |
| 315 | +- **初始化数据脚本** - 系统初始化数据 | |
| 316 | +- **数据迁移脚本** - 数据库版本升级脚本 | |
| 317 | +- **统计脚本** - 统计数据生成脚本 | |
| 318 | + | |
| 319 | +## ⚙️ 配置说明 | |
| 354 | 320 | |
| 355 | 321 | ### 数据库配置 |
| 356 | 322 | 修改 `netcore/src/Application/NCC.API/appsettings.json` 中的连接字符串: |
| ... | ... | @@ -378,7 +344,7 @@ proxy: { |
| 378 | 344 | } |
| 379 | 345 | ``` |
| 380 | 346 | |
| 381 | -## 部署说明 | |
| 347 | +## 📦 部署说明 | |
| 382 | 348 | |
| 383 | 349 | ### 后端部署 |
| 384 | 350 | 1. 发布项目:`dotnet publish -c Release` |
| ... | ... | @@ -390,91 +356,76 @@ proxy: { |
| 390 | 356 | 2. 将 `dist` 目录部署到Web服务器 |
| 391 | 357 | 3. 配置Nginx或IIS反向代理 |
| 392 | 358 | |
| 393 | -## 开发规范 | |
| 359 | +## 📋 开发规范 | |
| 360 | + | |
| 361 | +详细的开发规范请参考 [PROJECT_RULES.md](./PROJECT_RULES.md),主要规范包括: | |
| 394 | 362 | |
| 395 | -### 📋 项目开发规范 | |
| 396 | -- **ID生成规范**: 必须使用 `YitIdHelper.NextId().ToString()` 生成ID,禁止使用 `Guid.NewGuid().ToString()` | |
| 363 | +### 核心规范 | |
| 364 | +- **ID生成规范**: 必须使用 `YitIdHelper.NextId().ToString()` 生成ID | |
| 397 | 365 | - **API接口规范**: GET请求使用data字段传参,不使用params |
| 398 | 366 | - **权限控制**: 所有数据查询必须添加园区权限过滤 |
| 399 | 367 | - **数据一致性**: 统计数据和列表数据必须使用相同的过滤条件 |
| 400 | -- **UI一致性**: 所有页面必须使用统一的布局和样式规范 | |
| 401 | -- **性能优化**: 所有列表接口支持分页,避免大数据量查询 | |
| 402 | -- **安全防护**: 使用SqlSugar ORM防止SQL注入 | |
| 403 | - | |
| 404 | -### 🗄️ 数据库规范 | |
| 405 | -- **表命名**: 业务前缀 + 功能名称 (如: lq_) | |
| 406 | -- **字段命名**: 驼峰化 | |
| 407 | -- **时间字段**: 统一使用 DateTime 类型 | |
| 408 | -- **删除标记**: `base_organize.DeleteMark` 为 `null` 表示未删除 | |
| 409 | -- **SQL查询验证**: 对于统计类型的SQL查询,在提交代码前必须先使用MCP MySQL工具执行验证 | |
| 410 | - | |
| 411 | -### 🎨 前端开发规范 | |
| 368 | +- **SQL查询验证**: 统计类型SQL查询必须先使用MCP MySQL工具验证 | |
| 369 | + | |
| 370 | +### 前端规范 | |
| 412 | 371 | - **组件开发**: views 与 components 分离,弹窗、二级页面必须单独创建 Vue 文件 |
| 413 | 372 | - **文件命名**: 使用 kebab-case (如: user-dialog.vue) |
| 414 | 373 | - **UI规范**: 统一使用 NCC-table,标签右对齐,卡片高度100px,内边距12px,圆角12px |
| 415 | -- **性能要求**: 启用懒加载和代码分割,页面加载时间 < 3s | |
| 416 | 374 | |
| 417 | -## 常见问题 | |
| 375 | +### 后端规范 | |
| 376 | +- **分层架构**: Entitys → Interfaces → Services | |
| 377 | +- **异常处理**: 全局捕获,统一 JSON 格式返回 | |
| 378 | +- **XML注释**: 关键方法必须添加 XML 注释 | |
| 379 | + | |
| 380 | +## ❓ 常见问题 | |
| 418 | 381 | |
| 419 | 382 | ### Q: 前端启动失败 |
| 420 | -A: 确保使用Node.js 16.20.2版本,其他版本可能不兼容 | |
| 383 | +**A**: 确保使用Node.js 16.20.2版本,其他版本可能不兼容 | |
| 421 | 384 | |
| 422 | 385 | ### Q: 后端连接数据库失败 |
| 423 | -A: 检查数据库连接字符串和MySQL服务状态 | |
| 386 | +**A**: 检查数据库连接字符串和MySQL服务状态 | |
| 424 | 387 | |
| 425 | 388 | ### Q: 权限验证失败 |
| 426 | -A: 检查JWT配置和Token有效期设置 | |
| 427 | - | |
| 428 | -### Q: 页面显示异常 | |
| 429 | -A: 检查浏览器控制台错误信息和网络请求状态 | |
| 389 | +**A**: 检查JWT配置和Token有效期设置 | |
| 430 | 390 | |
| 431 | 391 | ### Q: 统计SQL执行失败 |
| 432 | -A: 使用MCP MySQL工具先验证SQL语法和字段名是否正确 | |
| 433 | - | |
| 434 | -### Q: 报表页面404错误 | |
| 435 | -A: 检查LqReportService是否正确实现ITransient接口并注册到DI容器 | |
| 436 | - | |
| 437 | -## 技术支持 | |
| 438 | - | |
| 439 | -如有技术问题,请联系开发团队或查看项目文档。 | |
| 440 | - | |
| 441 | -## 📊 已完成功能 | |
| 442 | - | |
| 443 | -### ✅ 核心统计功能 | |
| 444 | -- [x] 个人业绩统计 - 健康师个人业绩统计,包含首单业绩、升单业绩等 | |
| 445 | -- [x] 门店总业绩统计 - 门店整体业绩统计,包含总业绩、欠款金额等 | |
| 446 | -- [x] 金三角业绩统计 - 金三角团队业绩统计和分析 | |
| 447 | -- [x] 部门消耗业绩统计 - 部门消耗业绩统计,包含人头数、人次等 | |
| 448 | -- [x] 科技部业绩统计 - 科技部老师业绩统计 | |
| 449 | -- [x] 门店消耗业绩统计 - 门店消耗业绩统计 | |
| 450 | - | |
| 451 | -### ✅ 工资核算功能 | |
| 452 | -- [x] 工资统计 - 健康师工资核算,包含底薪、提成、奖励等 | |
| 453 | -- [x] 底薪计算 - 根据业绩标准自动计算健康师底薪(一星、二星、三星标准) | |
| 454 | -- [x] 提成计算 - 根据业绩类型计算各类提成(基础业绩、合作业绩、奖励业绩等) | |
| 455 | -- [x] 占比计算 - 队伍业绩与个人总业绩的占比分析 | |
| 456 | - | |
| 457 | -### ✅ 报表分析功能 | |
| 458 | -- [x] 门店业绩趋势 - 门店业绩时间趋势分析 | |
| 459 | -- [x] 门店业绩排行榜 - 门店业绩排名统计 | |
| 460 | -- [x] 健康师业绩趋势 - 健康师个人业绩趋势 | |
| 461 | -- [x] 健康师业绩排行榜 - 健康师业绩排名统计 | |
| 462 | -- [x] 金三角业绩趋势 - 金三角团队业绩趋势 | |
| 463 | -- [x] 金三角业绩排行榜 - 金三角团队排名统计 | |
| 464 | -- [x] 综合仪表盘 - 多维度数据汇总展示 | |
| 465 | - | |
| 466 | -### ✅ 系统优化 | |
| 467 | -- [x] 删除废弃代码 - 清理lq_ryzl、lq_tk_xsc等废弃模块 | |
| 468 | -- [x] 修复SQL语法 - 解决MySQL兼容性问题 | |
| 469 | -- [x] 修复字段映射 - 解决数据库字段名不匹配问题 | |
| 470 | -- [x] 优化前端页面 - 修复布局、分页、样式等问题 | |
| 471 | - | |
| 472 | -## 版本信息 | |
| 473 | - | |
| 474 | -- **当前版本**:v2.0.0 | |
| 475 | -- **最后更新**:2024年12月 | |
| 476 | -- **维护状态**:活跃开发中 | |
| 477 | -- **主要更新**:完成业绩统计、工资核算、报表分析等核心功能 | |
| 392 | +**A**: 使用MCP MySQL工具先验证SQL语法和字段名是否正确 | |
| 393 | + | |
| 394 | +### Q: 接口测试脚本无法运行 | |
| 395 | +**A**: 确保脚本有执行权限:`chmod +x scripts/sh/*.sh` | |
| 396 | + | |
| 397 | +## 📈 项目状态 | |
| 398 | + | |
| 399 | +### ✅ 已完成功能 | |
| 400 | +- [x] 业绩统计系统(个人、门店、金三角、部门消耗、科技部、门店消耗) | |
| 401 | +- [x] 工资核算系统(健康师、店长、主任、大项目主管、科技部总经理、事业部总经理) | |
| 402 | +- [x] 报表分析系统(趋势图、排行榜、仪表盘) | |
| 403 | +- [x] 门店管理系统(门店信息、归属管理、新店保护) | |
| 404 | +- [x] 客户管理系统(客户信息、拓客记录、会员权益) | |
| 405 | +- [x] 合同管理系统 | |
| 406 | +- [x] 合作成本和店内支出管理 | |
| 407 | +- [x] 库存使用审批流程 | |
| 408 | +- [x] 年度汇总统计 | |
| 409 | + | |
| 410 | +### 🔄 持续优化 | |
| 411 | +- 性能优化 | |
| 412 | +- 代码重构 | |
| 413 | +- 文档完善 | |
| 414 | +- 测试覆盖 | |
| 415 | + | |
| 416 | +## 📞 技术支持 | |
| 417 | + | |
| 418 | +如有技术问题,请: | |
| 419 | +1. 查看项目文档:`docs/` 目录 | |
| 420 | +2. 查看开发规范:`PROJECT_RULES.md` | |
| 421 | +3. 联系开发团队 | |
| 422 | + | |
| 423 | +## 📝 版本信息 | |
| 424 | + | |
| 425 | +- **当前版本**:v2.5.0 | |
| 426 | +- **最后更新**:2025年1月 | |
| 427 | +- **维护状态**:✅ 生产环境运行中 | |
| 428 | +- **主要特性**:完整的业绩统计、工资核算、报表分析等核心功能 | |
| 478 | 429 | |
| 479 | 430 | --- |
| 480 | 431 | ... | ... |
antis-ncc-admin/.env.development
| ... | ... | @@ -2,8 +2,8 @@ |
| 2 | 2 | |
| 3 | 3 | VUE_CLI_BABEL_TRANSPILE_MODULES = true |
| 4 | 4 | # VUE_APP_BASE_API = 'https://erp.lvqianmeiye.com' |
| 5 | -VUE_APP_BASE_API = 'http://erp_test.lvqianmeiye.com' | |
| 6 | -# VUE_APP_BASE_API = 'http://localhost:2011' | |
| 5 | +# VUE_APP_BASE_API = 'http://erp_test.lvqianmeiye.com' | |
| 6 | +VUE_APP_BASE_API = 'http://localhost:2011' | |
| 7 | 7 | # VUE_APP_BASE_API = 'http://localhost:2011' |
| 8 | 8 | VUE_APP_IMG_API = '' |
| 9 | 9 | VUE_APP_BASE_WSS = 'ws://192.168.110.45:2011/websocket' | ... | ... |