# 绿纤美业ERP管理系统 ## 📋 项目简介 绿纤美业ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统，专为绿纤美业行业量身定制。系统采用前后端分离架构，提供完整的门店管理、业绩统计、工资核算、报表分析、客户管理等业务管理功能。 **项目状态**：✅ 生产环境运行中 | 📅 最后更新：2025年1月 ## 🎯 核心功能模块 ### 📊 业绩统计系统 - **个人业绩统计** - 健康师个人业绩统计，包含首单业绩、升单业绩等 - **门店总业绩统计** - 门店整体业绩统计，包含总业绩、欠款金额等 - **金三角业绩统计** - 金三角团队业绩统计和分析 - **部门消耗业绩统计** - 部门消耗业绩统计，包含人头数、人次等 - **科技部业绩统计** - 科技部老师业绩统计 - **门店消耗业绩统计** - 门店消耗业绩统计 ### 💰 工资核算系统 - **健康师工资核算** - 健康师底薪、提成、奖励等自动计算 - **店长工资核算** - 店长工资计算，包含底薪、提成、奖励等 - **主任工资核算** - 主任工资计算，包含底薪、提成、奖励等 - **大项目主管工资核算** - 大项目主管工资计算 - **科技部总经理工资核算** - 科技部总经理工资计算 - **事业部总经理工资核算** - 事业部总经理工资计算 ### 📈 报表分析系统 - **门店业绩趋势** - 门店业绩时间趋势分析 - **门店业绩排行榜** - 门店业绩排名统计 - **健康师业绩趋势** - 健康师个人业绩趋势 - **健康师业绩排行榜** - 健康师业绩排名统计 - **金三角业绩趋势** - 金三角团队业绩趋势 - **综合仪表盘** - 多维度数据汇总展示 ### 🏪 门店管理系统 - **门店信息管理** - 门店基础信息维护 - **门店归属管理** - 门店归属事业部、教育部、科技部等 - **新店保护时间** - 新店保护期管理 - **门店股份统计** - 门店股份统计和分析 ### 👥 人员管理系统 - **金三角设定** - 金三角团队配置管理 - **金三角用户绑定** - 用户与金三角团队绑定关系 - **顾问身份管理** - 根据金三角绑定自动设置顾问身份 ### 📋 客户管理系统 - **客户信息管理** - 客户档案管理 - **拓客记录管理** - 拓客活动记录 - **拓客活动管理** - 拓客活动配置 - **会员权益管理** - 历史会员权益数据管理 - **用户画像** - 会员画像数据分析和展示 ### 🔧 其他业务模块 - **合同管理系统** - 合同信息管理 - **合作成本管理** - 合作成本表管理 - **店内支出管理** - 店内支出表管理 - **库存使用审批** - 库存使用审批流程 - **年度汇总统计** - 年度经营统计分析 ## 🛠 技术栈 ### 后端技术 - **.NET Core 3.1/5.0** - 跨平台Web框架 - **SqlSugar** - 轻量级ORM框架 - **MySQL** - 关系型数据库 - **JWT** - 身份认证 - **Serilog** - 结构化日志 - **Swagger** - API文档 ### 前端技术 - **Vue 2.6** - 渐进式JavaScript框架 - **Element UI** - 企业级UI组件库 - **Vuex** - 状态管理 - **Vue Router** - 路由管理 - **Axios** - HTTP客户端 - **SCSS** - CSS预处理器 - **ECharts** - 数据可视化图表库 ### 移动端 - **uni-app** - 跨平台移动应用框架 - **微信小程序** - 支持微信小程序平台 ## 📁 项目结构 ``` lvqianmeiye_ERP/ ├── netcore/ # 后端.NET Core项目 │ └── src/ │ ├── Application/ # 应用层 │ ├── Infrastructure/ # 基础设施层 │ └── Modularity/ # 业务模块层 │ ├── System/ # 系统管理模块 │ ├── Extend/ # 🎯 核心业务模块（绿纤ERP业务逻辑） │ │ ├── NCC.Extend/ # 业务服务层 │ │ ├── NCC.Extend.Entitys/ # 实体模型层 │ │ └── NCC.Extend.Interfaces/ # 接口定义层 │ ├── OAuth/ # 身份认证模块 │ ├── Message/ # 消息中心模块 │ ├── Order/ # 订单管理模块 │ ├── VisualDev/ # 可视化开发模块 │ └── Tenant/ # 多租户支持模块 ├── antis-ncc-admin/ # 前端Vue管理后台 │ ├── src/ │ │ ├── api/ # API接口 │ │ ├── components/ # 公共组件 │ │ ├── views/ # 页面视图 │ │ │ ├── salaryStatistics/ # 工资统计页面 │ │ │ ├── personalPerformanceStatistics/ # 个人业绩统计 │ │ │ ├── storeTotalPerformanceStatistics/ # 门店总业绩统计 │ │ │ ├── departmentConsumePerformanceStatistics/ # 部门消耗业绩统计 │ │ │ ├── techPerformanceStatistics/ # 科技部业绩统计 │ │ │ ├── storeConsumePerformanceStatistics/ # 门店消耗业绩统计 │ │ │ ├── report/ # 报表分析页面 │ │ │ └── extend/ # 其他业务页面 │ │ ├── router/ # 路由配置 │ │ └── store/ # 状态管理 │ ├── package.json # 前端依赖配置 │ └── vue.config.js # Vue构建配置 ├── 绿纤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 # 项目说明文档 ``` ## 🎯 核心业务模块说明 **Extend模块**是系统的核心业务模块，包含绿纤ERP的所有业务逻辑。该模块采用三层架构设计： ### NCC.Extend（业务服务层） #### 📊 业绩统计类 - `LqStatisticsService` - 核心统计服务（个人业绩、门店业绩、金三角业绩等） - `LqReportService` - 报表分析服务（趋势图、排行榜、仪表盘） #### 💰 工资核算类 - `LqGzService` - 健康师工资核算服务 - `LqStoreManagerSalaryService` - 店长工资核算服务 - `LqDirectorSalaryService` - 主任工资核算服务 - `LqMajorProjectDirectorSalaryService` - 大项目主管工资核算服务 - `LqTechGeneralManagerSalaryService` - 科技部总经理工资核算服务 - `LqBusinessUnitManagerSalaryService` - 事业部总经理工资核算服务 #### 🏪 门店管理类 - `LqMdxxService` - 门店信息管理服务 - `LqMdXdbhsjService` - 门店新店保护时间管理 #### 👥 人员管理类 - `LqYcsdJsjService` - 金三角设定管理服务 - `LqJinsanjiaoUserService` - 金三角用户绑定管理 #### 📋 客户管理类 - `LqKhxxService` - 客户信息管理服务 - `LqTkjlbService` - 拓客记录管理服务 - `LqEventService` - 拓客活动管理服务 #### 🔧 系统工具类 - `EmailService` - 邮件服务 - `DocumentService` - 文档管理服务 - `BigDataService` - 大数据分析服务 - `WorkLogService` - 工作日志服务 ### NCC.Extend.Entitys（实体模型层） - **Entity/** - 数据库实体模型 - **Dto/** - 数据传输对象 - **Mapper/** - 对象映射配置 - **Model/** - 业务模型类 ## 🚀 快速开始 ### 环境要求 #### 开发环境 - **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 ``` ### 2. 后端启动 #### 方式一：Visual Studio 1. 打开 `netcore/smart.agriculture.platform.NET.sln` 2. 设置 `NCC.API` 为启动项目 3. 按 F5 运行 #### 方式二：命令行 ```bash cd netcore/src/Application/NCC.API dotnet restore dotnet run ``` ### 3. 前端启动 ```bash cd antis-ncc-admin # 安装依赖 npm install # 启动开发服务器 npm run dev ``` ### 4. 访问系统 - 前端地址：http://localhost:3000 - 后端API：http://localhost:5000 - API文档：http://localhost:5000/antis.doc ### 默认账号 - **管理员账号**：admin - **默认密码**：123456 ## 📚 项目文档 项目文档统一存放在 `docs/` 目录下，包含： ### 核心文档 - **数据库说明.md** - 数据库表结构、字段说明、关联关系 - **PROJECT_RULES.md** - 项目开发规范、编码规范、最佳实践 ### 业务文档 - **工资计算规则梳理.md** - 各类工资计算规则说明 - 健康师工资计算规则 - 店长工资计算规则 - 主任工资计算规则 - 大项目主管工资计算规则 - 科技部总经理工资计算规则 - 事业部总经理工资计算规则 - **接口文档.md** - API接口调用说明 - **需求分析文档** - 各类业务需求分析文档 ### 查看文档 ```bash # 查看所有文档 ls docs/ # 查看特定文档 cat docs/数据库说明.md ``` ## 🔧 脚本工具 项目提供了丰富的脚本工具，位于 `scripts/` 目录下： ### Shell测试脚本 (`scripts/sh/`) 用于接口测试和数据验证： ```bash # 测试个人业绩统计接口 ./scripts/sh/test_personal_performance_api.sh # 测试门店总业绩统计接口 ./scripts/sh/test_store_total_performance_statistics.sh # 验证门店总业绩数据 ./scripts/sh/verify_store_total_performance_data.sh ``` ### Python工具脚本 (`scripts/py/`) 用于数据导出和生成： ```bash # 导出所有会员剩余权益数据 python scripts/py/export_all_member_remaining_rights.py # 生成客户Excel数据 python scripts/py/generate_november_customer_excel.py ``` ## 📊 SQL脚本 数据库相关SQL脚本存放在 `sql/` 目录下： - **表结构脚本** - 数据库表结构定义 - **初始化数据脚本** - 系统初始化数据 - **数据迁移脚本** - 数据库版本升级脚本 - **统计脚本** - 统计数据生成脚本 ## ⚙️ 配置说明 ### 数据库配置 修改 `netcore/src/Application/NCC.API/appsettings.json` 中的连接字符串： ```json { "ConnectionStrings": { "DefaultConnection": "Database=lqerp;Data Source=localhost;Port=3306;User Id=root;Password=yourpassword;Charset=utf8;" } } ``` ### 前端代理配置 修改 `antis-ncc-admin/vue.config.js` 中的代理地址： ```javascript proxy: { '/dev': { target: 'http://localhost:5000', // 后端API地址 changeOrigin: true, pathRewrite: { '^/dev': '' } } } ``` ## 📦 部署说明 ### 后端部署 1. 发布项目：`dotnet publish -c Release` 2. 配置数据库连接字符串 3. 部署到IIS或Linux服务器 ### 前端部署 1. 构建项目：`npm run build` 2. 将 `dist` 目录部署到Web服务器 3. 配置Nginx或IIS反向代理 ## 📋 开发规范 详细的开发规范请参考 [PROJECT_RULES.md](./PROJECT_RULES.md)，主要规范包括： ### 核心规范 - **ID生成规范**: 必须使用 `YitIdHelper.NextId().ToString()` 生成ID - **API接口规范**: GET请求使用data字段传参，不使用params - **权限控制**: 所有数据查询必须添加园区权限过滤 - **数据一致性**: 统计数据和列表数据必须使用相同的过滤条件 - **SQL查询验证**: 统计类型SQL查询必须先使用MCP MySQL工具验证 ### 前端规范 - **组件开发**: views 与 components 分离，弹窗、二级页面必须单独创建 Vue 文件 - **文件命名**: 使用 kebab-case (如: user-dialog.vue) - **UI规范**: 统一使用 NCC-table，标签右对齐，卡片高度100px，内边距12px，圆角12px ### 后端规范 - **分层架构**: Entitys → Interfaces → Services - **异常处理**: 全局捕获，统一 JSON 格式返回 - **XML注释**: 关键方法必须添加 XML 注释 ## ❓ 常见问题 ### Q: 前端启动失败 **A**: 确保使用Node.js 16.20.2版本，其他版本可能不兼容 ### Q: 后端连接数据库失败 **A**: 检查数据库连接字符串和MySQL服务状态 ### Q: 权限验证失败 **A**: 检查JWT配置和Token有效期设置 ### Q: 统计SQL执行失败 **A**: 使用MCP MySQL工具先验证SQL语法和字段名是否正确 ### Q: 接口测试脚本无法运行 **A**: 确保脚本有执行权限：`chmod +x scripts/sh/*.sh` ## 📈 项目状态 ### ✅ 已完成功能 - [x] 业绩统计系统（个人、门店、金三角、部门消耗、科技部、门店消耗） - [x] 工资核算系统（健康师、店长、主任、大项目主管、科技部总经理、事业部总经理） - [x] 报表分析系统（趋势图、排行榜、仪表盘） - [x] 门店管理系统（门店信息、归属管理、新店保护） - [x] 客户管理系统（客户信息、拓客记录、会员权益） - [x] 合同管理系统 - [x] 合作成本和店内支出管理 - [x] 库存使用审批流程 - [x] 年度汇总统计 ### 🔄 持续优化 - 性能优化 - 代码重构 - 文档完善 - 测试覆盖 ## 📞 技术支持 如有技术问题，请： 1. 查看项目文档：`docs/` 目录 2. 查看开发规范：`PROJECT_RULES.md` 3. 联系开发团队 ## 📝 版本信息 - **当前版本**：v2.5.0 - **最后更新**：2025年1月 - **维护状态**：✅ 生产环境运行中 - **主要特性**：完整的业绩统计、工资核算、报表分析等核心功能 --- **注意**：本项目仅供学习和内部使用，请勿用于商业用途。