From df137fbd33cdac21f6a89bebc94c33be49a0565a Mon Sep 17 00:00:00 2001
From: “wangming” <“wangming@antissoft.com”>
Date: Sun, 4 Jan 2026 11:33:52 +0800
Subject: [PATCH] 更新README.md,完善项目介绍和功能模块说明;调整开发环境配置,修改API地址为本地开发环境。
---
README.md | 485 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
antis-ncc-admin/.env.development | 4 ++--
2 files changed, 220 insertions(+), 269 deletions(-)
diff --git a/README.md b/README.md
index 167e850..739ffcd 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,63 @@
-# 绿纤ERP管理系统
-
-## 项目简介
+# 绿纤美业ERP管理系统
+
+## 📋 项目简介
+
+绿纤美业ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统,专为绿纤美业行业量身定制。系统采用前后端分离架构,提供完整的门店管理、业绩统计、工资核算、报表分析、客户管理等业务管理功能。
+
+**项目状态**:✅ 生产环境运行中 | 📅 最后更新:2025年1月
+
+## 🎯 核心功能模块
+
+### 📊 业绩统计系统
+- **个人业绩统计** - 健康师个人业绩统计,包含首单业绩、升单业绩等
+- **门店总业绩统计** - 门店整体业绩统计,包含总业绩、欠款金额等
+- **金三角业绩统计** - 金三角团队业绩统计和分析
+- **部门消耗业绩统计** - 部门消耗业绩统计,包含人头数、人次等
+- **科技部业绩统计** - 科技部老师业绩统计
+- **门店消耗业绩统计** - 门店消耗业绩统计
+
+### 💰 工资核算系统
+- **健康师工资核算** - 健康师底薪、提成、奖励等自动计算
+- **店长工资核算** - 店长工资计算,包含底薪、提成、奖励等
+- **主任工资核算** - 主任工资计算,包含底薪、提成、奖励等
+- **大项目主管工资核算** - 大项目主管工资计算
+- **科技部总经理工资核算** - 科技部总经理工资计算
+- **事业部总经理工资核算** - 事业部总经理工资计算
+
+### 📈 报表分析系统
+- **门店业绩趋势** - 门店业绩时间趋势分析
+- **门店业绩排行榜** - 门店业绩排名统计
+- **健康师业绩趋势** - 健康师个人业绩趋势
+- **健康师业绩排行榜** - 健康师业绩排名统计
+- **金三角业绩趋势** - 金三角团队业绩趋势
+- **综合仪表盘** - 多维度数据汇总展示
+
+### 🏪 门店管理系统
+- **门店信息管理** - 门店基础信息维护
+- **门店归属管理** - 门店归属事业部、教育部、科技部等
+- **新店保护时间** - 新店保护期管理
+- **门店股份统计** - 门店股份统计和分析
-绿纤ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统,专为绿纤行业量身定制。系统采用前后端分离架构,提供完整的门店管理、业绩统计、工资核算、报表分析等业务管理功能。
+### 👥 人员管理系统
+- **金三角设定** - 金三角团队配置管理
+- **金三角用户绑定** - 用户与金三角团队绑定关系
+- **顾问身份管理** - 根据金三角绑定自动设置顾问身份
-## 🎯 核心功能亮点
+### 📋 客户管理系统
+- **客户信息管理** - 客户档案管理
+- **拓客记录管理** - 拓客活动记录
+- **拓客活动管理** - 拓客活动配置
+- **会员权益管理** - 历史会员权益数据管理
+- **用户画像** - 会员画像数据分析和展示
-- **📊 业绩统计系统** - 门店业绩、个人业绩、金三角业绩等多维度统计
-- **💰 工资核算系统** - 健康师底薪、提成、奖励等自动计算
-- **📈 报表分析系统** - 可视化图表、趋势分析、排行榜展示
-- **🏪 门店管理系统** - 门店信息、归属管理、新店保护
-- **👥 人员管理系统** - 健康师管理、金三角团队管理
-- **📋 客户管理系统** - 客户信息、会员权益、拓客记录
+### 🔧 其他业务模块
+- **合同管理系统** - 合同信息管理
+- **合作成本管理** - 合作成本表管理
+- **店内支出管理** - 店内支出表管理
+- **库存使用审批** - 库存使用审批流程
+- **年度汇总统计** - 年度经营统计分析
-## 技术栈
+## 🛠 技术栈
### 后端技术
- **.NET Core 3.1/5.0** - 跨平台Web框架
@@ -32,7 +76,11 @@
- **SCSS** - CSS预处理器
- **ECharts** - 数据可视化图表库
-## 项目结构
+### 移动端
+- **uni-app** - 跨平台移动应用框架
+- **微信小程序** - 支持微信小程序平台
+
+## 📁 项目结构
```
lvqianmeiye_ERP/
@@ -51,7 +99,7 @@ lvqianmeiye_ERP/
│ ├── Order/ # 订单管理模块
│ ├── VisualDev/ # 可视化开发模块
│ └── Tenant/ # 多租户支持模块
-├── antis-ncc-admin/ # 前端Vue项目
+├── antis-ncc-admin/ # 前端Vue管理后台
│ ├── src/
│ │ ├── api/ # API接口
│ │ ├── components/ # 公共组件
@@ -63,12 +111,44 @@ lvqianmeiye_ERP/
│ │ │ ├── techPerformanceStatistics/ # 科技部业绩统计
│ │ │ ├── storeConsumePerformanceStatistics/ # 门店消耗业绩统计
│ │ │ ├── report/ # 报表分析页面
-│ │ │ └── ... # 其他业务页面
+│ │ │ └── extend/ # 其他业务页面
│ │ ├── router/ # 路由配置
│ │ └── store/ # 状态管理
│ ├── package.json # 前端依赖配置
│ └── vue.config.js # Vue构建配置
-└── html/ # 静态资源
+├── 绿纤uni-app/ # 移动端uni-app项目
+│ ├── pages/ # 页面文件
+│ ├── components/ # 组件
+│ ├── apis/ # API接口
+│ └── service/ # 服务层
+├── 绿纤html/ # 静态HTML页面
+│ ├── appointment.html # 预约页面
+│ ├── expansion.html # 拓客页面
+│ ├── member-consume.html # 会员消耗页面
+│ └── ... # 其他页面
+├── docs/ # 📚 项目文档
+│ ├── 数据库说明.md # 数据库文档
+│ ├── 工资计算规则梳理.md # 工资计算规则文档
+│ ├── 接口文档.md # API接口文档
+│ └── ... # 其他需求文档
+├── scripts/ # 🔧 脚本工具
+│ ├── sh/ # Shell测试脚本
+│ │ ├── test_*.sh # 接口测试脚本
+│ │ └── verify_*.sh # 数据验证脚本
+│ └── py/ # Python工具脚本
+│ ├── export_*.py # 数据导出脚本
+│ └── generate_*.py # 数据生成脚本
+├── sql/ # 📊 SQL脚本
+│ ├── 表结构.sql # 数据库表结构
+│ ├── 初始化数据.sql # 初始化数据脚本
+│ └── ... # 其他SQL脚本
+├── excel/ # 📄 Excel模板文件
+│ ├── 健康师额外数据模板.xlsx
+│ ├── 合作成本表.xlsx
+│ └── ... # 其他模板文件
+├── ExportFiles/ # 📤 导出文件目录
+├── PROJECT_RULES.md # 项目开发规范
+└── README.md # 项目说明文档
```
## 🎯 核心业务模块说明
@@ -76,14 +156,18 @@ lvqianmeiye_ERP/
**Extend模块**是系统的核心业务模块,包含绿纤ERP的所有业务逻辑。该模块采用三层架构设计:
### NCC.Extend(业务服务层)
-包含所有业务服务的具体实现,按功能分类:
#### 📊 业绩统计类
- `LqStatisticsService` - 核心统计服务(个人业绩、门店业绩、金三角业绩等)
- `LqReportService` - 报表分析服务(趋势图、排行榜、仪表盘)
#### 💰 工资核算类
-- `LqGzService` - 工资核算服务(健康师底薪、提成计算)
+- `LqGzService` - 健康师工资核算服务
+- `LqStoreManagerSalaryService` - 店长工资核算服务
+- `LqDirectorSalaryService` - 主任工资核算服务
+- `LqMajorProjectDirectorSalaryService` - 大项目主管工资核算服务
+- `LqTechGeneralManagerSalaryService` - 科技部总经理工资核算服务
+- `LqBusinessUnitManagerSalaryService` - 事业部总经理工资核算服务
#### 🏪 门店管理类
- `LqMdxxService` - 门店信息管理服务
@@ -105,40 +189,29 @@ lvqianmeiye_ERP/
- `WorkLogService` - 工作日志服务
### NCC.Extend.Entitys(实体模型层)
-- **Entity/** - 数据库实体模型(包含统计表、工资表等核心实体)
- - `lq_statistics_personal_performance/` - 个人业绩统计实体
- - `lq_statistics_store_total_performance/` - 门店总业绩统计实体
- - `lq_statistics_gold_triangle/` - 金三角业绩统计实体
- - `lq_statistics_department_consume_performance/` - 部门消耗业绩统计实体
- - `lq_statistics_tech_performance/` - 科技部业绩统计实体
- - `lq_statistics_store_consume_performance/` - 门店消耗业绩统计实体
- - `lq_salary_statistics/` - 工资统计实体
-- **Dto/** - 数据传输对象(包含统计、报表等DTO)
+- **Entity/** - 数据库实体模型
+- **Dto/** - 数据传输对象
- **Mapper/** - 对象映射配置
- **Model/** - 业务模型类
-### NCC.Extend.Interfaces(接口定义层)
-- 定义所有业务服务的接口契约
-- 支持依赖注入和单元测试
-- 提供清晰的业务边界
+## 🚀 快速开始
-## 环境要求
+### 环境要求
-### 开发环境
-- **Node.js**: 16.20.2 (必须使用此版本)
+#### 开发环境
+- **Node.js**: 16.20.2 (⚠️ 必须使用此版本,其他版本可能不兼容)
- **.NET Core SDK**: 3.1 或 5.0
- **MySQL**: 5.7 或 8.0
- **Visual Studio 2019/2022** 或 **VS Code**
-### 浏览器支持
+#### 浏览器支持
- Chrome 70+
- Firefox 65+
- Safari 12+
- Edge 79+
-## 快速开始
-
### 1. 克隆项目
+
```bash
git clone [项目地址]
cd lvqianmeiye_ERP
@@ -175,182 +248,75 @@ npm run dev
- 后端API:http://localhost:5000
- API文档:http://localhost:5000/antis.doc
-## 默认账号
-
+### 默认账号
- **管理员账号**:admin
- **默认密码**:123456
-## 主要功能模块
-
-> 💡 **说明**:所有业务功能的核心代码都位于 `netcore/src/Modularity/Extend/` 模块中
-
-### 📊 业绩统计模块
-- **个人业绩统计** (`LqStatisticsService`) - 健康师个人业绩统计,包含首单业绩、升单业绩等
-- **门店总业绩统计** (`LqStatisticsService`) - 门店整体业绩统计,包含总业绩、欠款金额等
-- **金三角业绩统计** (`LqStatisticsService`) - 金三角团队业绩统计和分析
-- **部门消耗业绩统计** (`LqStatisticsService`) - 部门消耗业绩统计,包含人头数、人次等
-- **科技部业绩统计** (`LqStatisticsService`) - 科技部老师业绩统计
-- **门店消耗业绩统计** (`LqStatisticsService`) - 门店消耗业绩统计
-
-### 💰 工资核算模块
-- **工资统计** (`LqGzService`) - 健康师工资核算,包含底薪、提成、奖励等
-- **底薪计算** - 根据业绩标准自动计算健康师底薪(一星、二星、三星标准)
-- **提成计算** - 根据业绩类型计算各类提成(基础业绩、合作业绩、奖励业绩等)
-- **占比计算** - 队伍业绩与个人总业绩的占比分析
-
-### 📈 报表分析模块
-- **门店业绩趋势** (`LqReportService`) - 门店业绩时间趋势分析
-- **门店业绩排行榜** (`LqReportService`) - 门店业绩排名统计
-- **健康师业绩趋势** (`LqReportService`) - 健康师个人业绩趋势
-- **健康师业绩排行榜** (`LqReportService`) - 健康师业绩排名统计
-- **金三角业绩趋势** (`LqReportService`) - 金三角团队业绩趋势
-- **金三角业绩排行榜** (`LqReportService`) - 金三角团队排名统计
-- **综合仪表盘** (`LqReportService`) - 多维度数据汇总展示
-
-### 🏪 门店管理模块
-- **门店信息管理** (`LqMdxxService`) - 门店基础信息维护
-- **门店归属管理** - 门店归属事业部、教育部、科技部等
-- **新店保护时间** (`LqMdXdbhsjService`) - 新店保护期管理
+## 📚 项目文档
-### 👥 人员管理模块
-- **金三角设定** (`LqYcsdJsjService`) - 金三角团队配置管理
-- **金三角用户绑定** (`LqJinsanjiaoUserService`) - 用户与金三角团队绑定关系
-- **顾问身份管理** - 根据金三角绑定自动设置顾问身份
+项目文档统一存放在 `docs/` 目录下,包含:
-### 📋 客户管理模块
-- **客户信息管理** (`LqKhxxService`) - 客户档案管理
-- **拓客记录管理** (`LqTkjlbService`) - 拓客活动记录
-- **拓客活动管理** (`LqEventService`) - 拓客活动配置
-- **会员权益管理** - 历史会员权益数据管理
+### 核心文档
+- **数据库说明.md** - 数据库表结构、字段说明、关联关系
+- **PROJECT_RULES.md** - 项目开发规范、编码规范、最佳实践
-### ⚙️ 系统管理模块(位于System模块)
-- **用户管理** - 系统用户维护,用户权限管理
-- **角色权限** - 权限分配管理,角色权限配置
-- **系统配置** - 系统参数设置,基础配置维护
-- **日志管理** - 操作日志查看,系统日志分析
-
-## 开发指南
-
-### 🎯 核心业务开发(Extend模块)
-
-#### 统计服务开发规范
-1. **统计表实体** (`NCC.Extend.Entitys/Entity/lq_statistics_*/`)
- ```csharp
- [SugarTable("lq_statistics_新统计表")]
- [Tenant(ClaimConst.TENANT_ID)]
- public class LqStatistics新统计Entity
- {
- [SugarColumn(ColumnName = "F_Id", IsPrimaryKey = true)]
- public string Id { get; set; }
-
- [SugarColumn(ColumnName = "F_StatisticsMonth")]
- public string StatisticsMonth { get; set; }
-
- // 其他统计字段...
- }
- ```
-
-2. **统计DTO对象** (`NCC.Extend.Entitys/Dto/LqStatistics/`)
- - `Lq新统计ListQueryInput` - 列表查询输入
- - `Lq新统计ListOutput` - 列表输出DTO
-
-3. **统计服务实现** (`LqStatisticsService`)
- ```csharp
- ///
- /// 保存新统计数据
- ///
- public async Task Save新统计Statistics(string statisticsMonth)
- {
- // 统计逻辑实现
- }
-
- ///
- /// 获取新统计列表
- ///
- public async Task Get新统计StatisticsList(Lq新统计ListQueryInput input)
- {
- // 查询逻辑实现
- }
- ```
-
-#### 报表服务开发规范
-1. **报表接口定义** (`NCC.Extend.Interfaces/LqReport/`)
- ```csharp
- public interface ILqReportService
- {
- Task