绿纤美业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. 克隆项目

git clone [项目地址]
cd lvqianmeiye_ERP

2. 后端启动

方式一：Visual Studio

1. 打开 netcore/smart.agriculture.platform.NET.sln
2. 设置 NCC.API 为启动项目
3. 按 F5 运行

方式二：命令行

cd netcore/src/Application/NCC.API
dotnet restore
dotnet run

3. 前端启动

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接口调用说明
• 需求分析文档 - 各类业务需求分析文档

查看文档

# 查看所有文档
ls docs/

# 查看特定文档
cat docs/数据库说明.md

🔧 脚本工具

项目提供了丰富的脚本工具，位于 scripts/ 目录下：

Shell测试脚本 (scripts/sh/)

用于接口测试和数据验证：

# 测试个人业绩统计接口
./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/)

用于数据导出和生成：

# 导出所有会员剩余权益数据
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 中的连接字符串：

{
  "ConnectionStrings": {
    "DefaultConnection": "Database=lqerp;Data Source=localhost;Port=3306;User Id=root;Password=yourpassword;Charset=utf8;"
  }
}

前端代理配置

修改 antis-ncc-admin/vue.config.js 中的代理地址：

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，主要规范包括：

核心规范

• 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月
• 维护状态：✅ 生产环境运行中
• 主要特性：完整的业绩统计、工资核算、报表分析等核心功能

---

注意：本项目仅供学习和内部使用，请勿用于商业用途。