Commit df137fbd33cdac21f6a89bebc94c33be49a0565a

Authored by “wangming”
1 parent 2d87685f

更新README.md,完善项目介绍和功能模块说明;调整开发环境配置,修改API地址为本地开发环境。

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 - **.NET Core 3.1/5.0** - 跨平台Web框架 63 - **.NET Core 3.1/5.0** - 跨平台Web框架
@@ -32,7 +76,11 @@ @@ -32,7 +76,11 @@
32 - **SCSS** - CSS预处理器 76 - **SCSS** - CSS预处理器
33 - **ECharts** - 数据可视化图表库 77 - **ECharts** - 数据可视化图表库
34 78
35 -## 项目结构 79 +### 移动端
  80 +- **uni-app** - 跨平台移动应用框架
  81 +- **微信小程序** - 支持微信小程序平台
  82 +
  83 +## 📁 项目结构
36 84
37 ``` 85 ```
38 lvqianmeiye_ERP/ 86 lvqianmeiye_ERP/
@@ -51,7 +99,7 @@ lvqianmeiye_ERP/ @@ -51,7 +99,7 @@ lvqianmeiye_ERP/
51 │ ├── Order/ # 订单管理模块 99 │ ├── Order/ # 订单管理模块
52 │ ├── VisualDev/ # 可视化开发模块 100 │ ├── VisualDev/ # 可视化开发模块
53 │ └── Tenant/ # 多租户支持模块 101 │ └── Tenant/ # 多租户支持模块
54 -├── antis-ncc-admin/ # 前端Vue项目 102 +├── antis-ncc-admin/ # 前端Vue管理后台
55 │ ├── src/ 103 │ ├── src/
56 │ │ ├── api/ # API接口 104 │ │ ├── api/ # API接口
57 │ │ ├── components/ # 公共组件 105 │ │ ├── components/ # 公共组件
@@ -63,12 +111,44 @@ lvqianmeiye_ERP/ @@ -63,12 +111,44 @@ lvqianmeiye_ERP/
63 │ │ │ ├── techPerformanceStatistics/ # 科技部业绩统计 111 │ │ │ ├── techPerformanceStatistics/ # 科技部业绩统计
64 │ │ │ ├── storeConsumePerformanceStatistics/ # 门店消耗业绩统计 112 │ │ │ ├── storeConsumePerformanceStatistics/ # 门店消耗业绩统计
65 │ │ │ ├── report/ # 报表分析页面 113 │ │ │ ├── report/ # 报表分析页面
66 -│ │ │ └── ... # 其他业务页面 114 +│ │ │ └── extend/ # 其他业务页面
67 │ │ ├── router/ # 路由配置 115 │ │ ├── router/ # 路由配置
68 │ │ └── store/ # 状态管理 116 │ │ └── store/ # 状态管理
69 │ ├── package.json # 前端依赖配置 117 │ ├── package.json # 前端依赖配置
70 │ └── vue.config.js # Vue构建配置 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,14 +156,18 @@ lvqianmeiye_ERP/
76 **Extend模块**是系统的核心业务模块,包含绿纤ERP的所有业务逻辑。该模块采用三层架构设计: 156 **Extend模块**是系统的核心业务模块,包含绿纤ERP的所有业务逻辑。该模块采用三层架构设计:
77 157
78 ### NCC.Extend(业务服务层) 158 ### NCC.Extend(业务服务层)
79 -包含所有业务服务的具体实现,按功能分类:  
80 159
81 #### 📊 业绩统计类 160 #### 📊 业绩统计类
82 - `LqStatisticsService` - 核心统计服务(个人业绩、门店业绩、金三角业绩等) 161 - `LqStatisticsService` - 核心统计服务(个人业绩、门店业绩、金三角业绩等)
83 - `LqReportService` - 报表分析服务(趋势图、排行榜、仪表盘) 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 - `LqMdxxService` - 门店信息管理服务 173 - `LqMdxxService` - 门店信息管理服务
@@ -105,40 +189,29 @@ lvqianmeiye_ERP/ @@ -105,40 +189,29 @@ lvqianmeiye_ERP/
105 - `WorkLogService` - 工作日志服务 189 - `WorkLogService` - 工作日志服务
106 190
107 ### NCC.Extend.Entitys(实体模型层) 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 - **Mapper/** - 对象映射配置 194 - **Mapper/** - 对象映射配置
118 - **Model/** - 业务模型类 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 - **.NET Core SDK**: 3.1 或 5.0 203 - **.NET Core SDK**: 3.1 或 5.0
130 - **MySQL**: 5.7 或 8.0 204 - **MySQL**: 5.7 或 8.0
131 - **Visual Studio 2019/2022** 或 **VS Code** 205 - **Visual Studio 2019/2022** 或 **VS Code**
132 206
133 -### 浏览器支持 207 +#### 浏览器支持
134 - Chrome 70+ 208 - Chrome 70+
135 - Firefox 65+ 209 - Firefox 65+
136 - Safari 12+ 210 - Safari 12+
137 - Edge 79+ 211 - Edge 79+
138 212
139 -## 快速开始  
140 -  
141 ### 1. 克隆项目 213 ### 1. 克隆项目
  214 +
142 ```bash 215 ```bash
143 git clone [项目地址] 216 git clone [项目地址]
144 cd lvqianmeiye_ERP 217 cd lvqianmeiye_ERP
@@ -175,182 +248,75 @@ npm run dev @@ -175,182 +248,75 @@ npm run dev
175 - 后端API:http://localhost:5000 248 - 后端API:http://localhost:5000
176 - API文档:http://localhost:5000/antis.doc 249 - API文档:http://localhost:5000/antis.doc
177 250
178 -## 默认账号  
179 - 251 +### 默认账号
180 - **管理员账号**:admin 252 - **管理员账号**:admin
181 - **默认密码**:123456 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 ```bash 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 修改 `netcore/src/Application/NCC.API/appsettings.json` 中的连接字符串: 322 修改 `netcore/src/Application/NCC.API/appsettings.json` 中的连接字符串:
@@ -378,7 +344,7 @@ proxy: { @@ -378,7 +344,7 @@ proxy: {
378 } 344 }
379 ``` 345 ```
380 346
381 -## 部署说明 347 +## 📦 部署说明
382 348
383 ### 后端部署 349 ### 后端部署
384 1. 发布项目:`dotnet publish -c Release` 350 1. 发布项目:`dotnet publish -c Release`
@@ -390,91 +356,76 @@ proxy: { @@ -390,91 +356,76 @@ proxy: {
390 2. 将 `dist` 目录部署到Web服务器 356 2. 将 `dist` 目录部署到Web服务器
391 3. 配置Nginx或IIS反向代理 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 - **API接口规范**: GET请求使用data字段传参,不使用params 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 - **组件开发**: views 与 components 分离,弹窗、二级页面必须单独创建 Vue 文件 371 - **组件开发**: views 与 components 分离,弹窗、二级页面必须单独创建 Vue 文件
413 - **文件命名**: 使用 kebab-case (如: user-dialog.vue) 372 - **文件命名**: 使用 kebab-case (如: user-dialog.vue)
414 - **UI规范**: 统一使用 NCC-table,标签右对齐,卡片高度100px,内边距12px,圆角12px 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 ### Q: 前端启动失败 382 ### Q: 前端启动失败
420 -A: 确保使用Node.js 16.20.2版本,其他版本可能不兼容 383 +**A**: 确保使用Node.js 16.20.2版本,其他版本可能不兼容
421 384
422 ### Q: 后端连接数据库失败 385 ### Q: 后端连接数据库失败
423 -A: 检查数据库连接字符串和MySQL服务状态 386 +**A**: 检查数据库连接字符串和MySQL服务状态
424 387
425 ### Q: 权限验证失败 388 ### Q: 权限验证失败
426 -A: 检查JWT配置和Token有效期设置  
427 -  
428 -### Q: 页面显示异常  
429 -A: 检查浏览器控制台错误信息和网络请求状态 389 +**A**: 检查JWT配置和Token有效期设置
430 390
431 ### Q: 统计SQL执行失败 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,8 +2,8 @@
2 2
3 VUE_CLI_BABEL_TRANSPILE_MODULES = true 3 VUE_CLI_BABEL_TRANSPILE_MODULES = true
4 # VUE_APP_BASE_API = 'https://erp.lvqianmeiye.com' 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 # VUE_APP_BASE_API = 'http://localhost:2011' 7 # VUE_APP_BASE_API = 'http://localhost:2011'
8 VUE_APP_IMG_API = '' 8 VUE_APP_IMG_API = ''
9 VUE_APP_BASE_WSS = 'ws://192.168.110.45:2011/websocket' 9 VUE_APP_BASE_WSS = 'ws://192.168.110.45:2011/websocket'