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 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'
... ...