From 47d33dcab5b64c9160d9f3d96e7d70d2e4c79cce Mon Sep 17 00:00:00 2001
From: “wangming” <“wangming@antissoft.com”>
Date: Wed, 1 Oct 2025 10:57:18 +0800
Subject: [PATCH] 国庆快乐~
---
README.md | 311 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++----------------------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlCrInput.cs | 87 ---------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlInfoOutput.cs | 87 ---------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlListOutput.cs | 86 --------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlListQueryInput.cs | 98 --------------------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlUpInput.cs | 17 -----------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscCrInput.cs | 82 ----------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscInfoOutput.cs | 82 ----------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscListOutput.cs | 81 ---------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscListQueryInput.cs | 93 ---------------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscUpInput.cs | 17 -----------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Entity/README.md | 6 +++---
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Entity/lq_ryzl/LqRyzlEntity.cs | 105 ---------------------------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Entity/lq_tk_xsc/LqTkXscEntity.cs | 99 ---------------------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Mapper/LqRyzlMapper.cs | 14 --------------
netcore/src/Modularity/Extend/NCC.Extend.Entitys/Mapper/LqTkXscMapper.cs | 14 --------------
netcore/src/Modularity/Extend/NCC.Extend.Interfaces/ILqRyzlService.cs | 6 ------
netcore/src/Modularity/Extend/NCC.Extend.Interfaces/ILqTkXscService.cs | 6 ------
netcore/src/Modularity/Extend/NCC.Extend/LqRyzlService.cs | 289 -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend/LqTkXscService.cs | 289 -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
netcore/src/Modularity/Extend/NCC.Extend/LqTkjlbService.cs | 1 -
21 files changed, 214 insertions(+), 1656 deletions(-)
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlCrInput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlInfoOutput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlListOutput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlListQueryInput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqRyzl/LqRyzlUpInput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscCrInput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscInfoOutput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscListOutput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscListQueryInput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqTkXsc/LqTkXscUpInput.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Entity/lq_ryzl/LqRyzlEntity.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Entity/lq_tk_xsc/LqTkXscEntity.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Mapper/LqRyzlMapper.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Entitys/Mapper/LqTkXscMapper.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Interfaces/ILqRyzlService.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend.Interfaces/ILqTkXscService.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend/LqRyzlService.cs
delete mode 100644 netcore/src/Modularity/Extend/NCC.Extend/LqTkXscService.cs
diff --git a/README.md b/README.md
index 9c72122..167e850 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,16 @@
## 项目简介
-绿纤ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统,专为绿纤行业量身定制。系统采用前后端分离架构,提供完整的生产、销售、库存、财务等业务管理功能。
+绿纤ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统,专为绿纤行业量身定制。系统采用前后端分离架构,提供完整的门店管理、业绩统计、工资核算、报表分析等业务管理功能。
+
+## 🎯 核心功能亮点
+
+- **📊 业绩统计系统** - 门店业绩、个人业绩、金三角业绩等多维度统计
+- **💰 工资核算系统** - 健康师底薪、提成、奖励等自动计算
+- **📈 报表分析系统** - 可视化图表、趋势分析、排行榜展示
+- **🏪 门店管理系统** - 门店信息、归属管理、新店保护
+- **👥 人员管理系统** - 健康师管理、金三角团队管理
+- **📋 客户管理系统** - 客户信息、会员权益、拓客记录
## 技术栈
@@ -21,6 +30,7 @@
- **Vue Router** - 路由管理
- **Axios** - HTTP客户端
- **SCSS** - CSS预处理器
+- **ECharts** - 数据可视化图表库
## 项目结构
@@ -46,9 +56,13 @@ lvqianmeiye_ERP/
│ │ ├── api/ # API接口
│ │ ├── components/ # 公共组件
│ │ ├── views/ # 页面视图
-│ │ │ ├── lqBmzb/ # 部门管理页面
-│ │ │ ├── lqCpxx/ # 产品信息页面
-│ │ │ ├── lqHygl/ # 会员管理页面
+│ │ │ ├── salaryStatistics/ # 工资统计页面
+│ │ │ ├── personalPerformanceStatistics/ # 个人业绩统计
+│ │ │ ├── storeTotalPerformanceStatistics/ # 门店总业绩统计
+│ │ │ ├── departmentConsumePerformanceStatistics/ # 部门消耗业绩统计
+│ │ │ ├── techPerformanceStatistics/ # 科技部业绩统计
+│ │ │ ├── storeConsumePerformanceStatistics/ # 门店消耗业绩统计
+│ │ │ ├── report/ # 报表分析页面
│ │ │ └── ... # 其他业务页面
│ │ ├── router/ # 路由配置
│ │ └── store/ # 状态管理
@@ -64,33 +78,25 @@ lvqianmeiye_ERP/
### NCC.Extend(业务服务层)
包含所有业务服务的具体实现,按功能分类:
-#### 📋 基础管理类
-- `LqCpxxService` - 产品信息管理服务
+#### 📊 业绩统计类
+- `LqStatisticsService` - 核心统计服务(个人业绩、门店业绩、金三角业绩等)
+- `LqReportService` - 报表分析服务(趋势图、排行榜、仪表盘)
+
+#### 💰 工资核算类
+- `LqGzService` - 工资核算服务(健康师底薪、提成计算)
+
+#### 🏪 门店管理类
+- `LqMdxxService` - 门店信息管理服务
+- `LqMdXdbhsjService` - 门店新店保护时间管理
+
+#### 👥 人员管理类
+- `LqYcsdJsjService` - 金三角设定管理服务
+- `LqJinsanjiaoUserService` - 金三角用户绑定管理
+
+#### 📋 客户管理类
- `LqKhxxService` - 客户信息管理服务
-- `LqRyzlService` - 人员资料管理服务
-
-#### 🏭 生产管理类
-- `LqJsfaService` - 工艺方案管理服务
-- `LqSbtjbService` - 设备统计管理服务
-- `LqYcsdJsjService` - 技术数据管理服务
-- `LqYcsdJjlftjsService` - 技术方案管理服务
-- `LqYcsdMdlbjhsxxService` - 模具管理服务
-
-#### 💰 销售管理类
-- `LqXhHyhkService` - 销售回款管理服务
-- `LqXhmxbService` - 销售明细管理服务
-- `LqTkXscService` - 提成管理服务
-- `LqTkjlbService` - 提成记录管理服务
-
-#### 📦 库存管理类
-- `LqKqhzbService` - 库存汇总管理服务
-- `LqLssjService` - 历史数据管理服务
-- `LqYjmxbService` - 原料明细管理服务
-
-#### 📊 财务管理类
-- `LqSkzhService` - 收款账户管理服务
-- `LqHzfService` - 汇总费用管理服务
-- `LqJdqdService` - 季度清单管理服务
+- `LqTkjlbService` - 拓客记录管理服务
+- `LqEventService` - 拓客活动管理服务
#### 🔧 系统工具类
- `EmailService` - 邮件服务
@@ -99,9 +105,16 @@ lvqianmeiye_ERP/
- `WorkLogService` - 工作日志服务
### NCC.Extend.Entitys(实体模型层)
-- **Entity/** - 数据库实体模型(66个实体)
-- **Dto/** - 数据传输对象(304个DTO)
-- **Mapper/** - 对象映射配置(50个映射器)
+- **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)
+- **Mapper/** - 对象映射配置
- **Model/** - 业务模型类
### NCC.Extend.Interfaces(接口定义层)
@@ -171,39 +184,44 @@ npm run dev
> 💡 **说明**:所有业务功能的核心代码都位于 `netcore/src/Modularity/Extend/` 模块中
-### 📋 基础管理模块
-- **产品信息** (`LqCpxxService`) - 产品档案管理,产品分类维护
-- **客户信息** (`LqKhxxService`) - 客户档案管理,客户关系维护
-- **人员资料** (`LqRyzlService`) - 员工信息管理,人员档案维护
-
-### 🏭 生产管理模块
-- **工艺方案** (`LqJsfaService`) - 生产工艺配置,工艺流程管理
-- **设备统计** (`LqSbtjbService`) - 设备使用情况统计,设备维护管理
-- **技术数据** (`LqYcsdJsjService`) - 技术参数管理,工艺数据维护
-- **技术方案** (`LqYcsdJjlftjsService`) - 技术方案管理,工艺优化
-- **模具管理** (`LqYcsdMdlbjhsxxService`) - 模具档案管理,模具维护
-
-### 💰 销售管理模块
-- **销售回款** (`LqXhHyhkService`) - 销售回款管理,资金回笼跟踪
-- **销售明细** (`LqXhmxbService`) - 销售明细管理,销售数据分析
-- **提成管理** (`LqTkXscService`) - 销售提成计算,提成规则维护
-- **提成记录** (`LqTkjlbService`) - 提成记录管理,提成发放跟踪
-
-### 📦 库存管理模块
-- **库存汇总** (`LqKqhzbService`) - 库存数据分析,库存统计报表
-- **历史数据** (`LqLssjService`) - 历史数据管理,数据归档
-- **原料明细** (`LqYjmxbService`) - 原料库存管理,原料使用跟踪
-
-### 📊 财务管理模块
-- **收款账户** (`LqSkzhService`) - 收款账户管理,资金账户维护
-- **汇总费用** (`LqHzfService`) - 费用汇总管理,成本分析
-- **季度清单** (`LqJdqdService`) - 季度财务清单,财务报告
-
-### 🔧 系统工具模块
-- **邮件服务** (`EmailService`) - 邮件发送,通知提醒
-- **文档管理** (`DocumentService`) - 文档存储,文件管理
-- **大数据分析** (`BigDataService`) - 数据分析,报表生成
-- **工作日志** (`WorkLogService`) - 工作日志记录,操作跟踪
+### 📊 业绩统计模块
+- **个人业绩统计** (`LqStatisticsService`) - 健康师个人业绩统计,包含首单业绩、升单业绩等
+- **门店总业绩统计** (`LqStatisticsService`) - 门店整体业绩统计,包含总业绩、欠款金额等
+- **金三角业绩统计** (`LqStatisticsService`) - 金三角团队业绩统计和分析
+- **部门消耗业绩统计** (`LqStatisticsService`) - 部门消耗业绩统计,包含人头数、人次等
+- **科技部业绩统计** (`LqStatisticsService`) - 科技部老师业绩统计
+- **门店消耗业绩统计** (`LqStatisticsService`) - 门店消耗业绩统计
+
+### 💰 工资核算模块
+- **工资统计** (`LqGzService`) - 健康师工资核算,包含底薪、提成、奖励等
+- **底薪计算** - 根据业绩标准自动计算健康师底薪(一星、二星、三星标准)
+- **提成计算** - 根据业绩类型计算各类提成(基础业绩、合作业绩、奖励业绩等)
+- **占比计算** - 队伍业绩与个人总业绩的占比分析
+
+### 📈 报表分析模块
+- **门店业绩趋势** (`LqReportService`) - 门店业绩时间趋势分析
+- **门店业绩排行榜** (`LqReportService`) - 门店业绩排名统计
+- **健康师业绩趋势** (`LqReportService`) - 健康师个人业绩趋势
+- **健康师业绩排行榜** (`LqReportService`) - 健康师业绩排名统计
+- **金三角业绩趋势** (`LqReportService`) - 金三角团队业绩趋势
+- **金三角业绩排行榜** (`LqReportService`) - 金三角团队排名统计
+- **综合仪表盘** (`LqReportService`) - 多维度数据汇总展示
+
+### 🏪 门店管理模块
+- **门店信息管理** (`LqMdxxService`) - 门店基础信息维护
+- **门店归属管理** - 门店归属事业部、教育部、科技部等
+- **新店保护时间** (`LqMdXdbhsjService`) - 新店保护期管理
+
+### 👥 人员管理模块
+- **金三角设定** (`LqYcsdJsjService`) - 金三角团队配置管理
+- **金三角用户绑定** (`LqJinsanjiaoUserService`) - 用户与金三角团队绑定关系
+- **顾问身份管理** - 根据金三角绑定自动设置顾问身份
+
+### 📋 客户管理模块
+- **客户信息管理** (`LqKhxxService`) - 客户档案管理
+- **拓客记录管理** (`LqTkjlbService`) - 拓客活动记录
+- **拓客活动管理** (`LqEventService`) - 拓客活动配置
+- **会员权益管理** - 历史会员权益数据管理
### ⚙️ 系统管理模块(位于System模块)
- **用户管理** - 系统用户维护,用户权限管理
@@ -215,60 +233,91 @@ npm run dev
### 🎯 核心业务开发(Extend模块)
-#### 添加新的业务服务
-1. **创建实体模型** (`NCC.Extend.Entitys/Entity/`)
+#### 统计服务开发规范
+1. **统计表实体** (`NCC.Extend.Entitys/Entity/lq_statistics_*/`)
```csharp
- [SugarTable("lq_新表名")]
+ [SugarTable("lq_statistics_新统计表")]
[Tenant(ClaimConst.TENANT_ID)]
- public class Lq新实体Entity
+ 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/`)
- - `Lq新实体ListQueryInput` - 列表查询输入
- - `Lq新实体CrInput` - 创建输入
- - `Lq新实体UpInput` - 更新输入
- - `Lq新实体InfoOutput` - 详情输出
- - `Lq新实体ListOutput` - 列表输出
+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)
+ {
+ // 查询逻辑实现
+ }
+ ```
-3. **创建接口定义** (`NCC.Extend.Interfaces/`)
+#### 报表服务开发规范
+1. **报表接口定义** (`NCC.Extend.Interfaces/LqReport/`)
```csharp
- public interface ILq新实体Service : ITransient
+ public interface ILqReportService
{
- Task GetInfo(string id);
- Task GetList(Lq新实体ListQueryInput input);
- Task Create(Lq新实体CrInput input);
- Task Update(string id, Lq新实体UpInput input);
- Task Delete(string id);
+ Task