spa/docs/完整系统功能设计方案.md

# SPA管理系统 - 完整功能设计方案

## 一、系统架构

### 1.1 系统角色
- **超级管理员**：系统最高权限
- **店长/管理员**：门店管理权限
- **财务**：财务管理权限
- **代理**：推广技师和下级代理
- **技师**：提供服务
- **用户/客户**：消费和推广

---

## 二、核心功能模块（15大模块）

### 模块1：用户管理系统

#### 1.1 用户基础信息
- 用户注册/登录（手机号、微信、支付宝）
- 用户资料管理
- 实名认证
- 用户标签分类

#### 1.2 用户推广体系 ⭐
- 专属邀请码/二维码
- 推广链接生成
- 推广海报生成
- 3级推广关系（永久绑定）
- 推广收益查询
- 团队管理

#### 1.3 用户等级体系
- 普通用户
- 银卡会员
- 金卡会员
- 钻石会员
- 等级权益配置

---

### 模块2：会员卡系统

#### 2.1 储值卡
- 充值金额
- 赠送金额
- 余额查询
- 充值记录
- 消费记录

#### 2.2 次卡
- 购买次数
- 剩余次数
- 使用记录
- 过期管理

#### 2.3 时长卡
- 购买时长（分钟）
- 剩余时长
- 使用记录
- 过期管理

#### 2.4 套餐卡
- 套餐内容配置
- 套餐使用规则
- 套餐核销记录

---

### 模块3：优惠券系统

#### 3.1 优惠券类型
- 满减券
- 折扣券
- 代金券
- 新人券
- 生日券

#### 3.2 优惠券管理
- 优惠券创建
- 发放规则
- 使用规则
- 叠加规则
- 过期管理

#### 3.3 优惠券发放
- 手动发放
- 自动发放（注册、生日、消费满额）
- 批量发放
- 领券中心

---

### 模块4：积分系统

#### 4.1 积分获取
- 消费积分（消费金额比例）
- 签到积分
- 评价积分
- 分享积分
- 任务积分

#### 4.2 积分使用
- 积分抵扣
- 积分兑换商品
- 积分兑换优惠券
- 积分抽奖

#### 4.3 积分管理
- 积分规则配置
- 积分有效期
- 积分明细
- 积分统计

---

### 模块5：代理管理系统 ⭐

#### 5.1 代理基础信息
- 代理注册/审核
- 代理资料管理
- 代理等级（一级/二级/三级）
- 代理状态管理

#### 5.2 代理推广体系
- 技师邀请码
- 代理邀请码
- 推广素材库
- 推广数据看板

#### 5.3 代理团队管理
- 直属技师列表
- 下级代理列表
- 团队架构图
- 业绩排行榜

#### 5.4 代理收益管理
- 收益概览
- 分佣明细
- 提现管理
- 月度报表

---

### 模块6：技师管理系统

#### 6.1 技师基础信息
- 技师档案
- 技师等级
- 专业技能
- 资格证书
- 服务年限

#### 6.2 技师排班管理
- 班次设置
- 周期性排班
- 临时请假
- 调班申请
- 排班日历

#### 6.3 技师考勤管理
- 签到签退
- 考勤统计
- 迟到早退
- 缺勤记录
- 考勤报表

#### 6.4 技师服务项目
- 擅长项目
- 服务次数
- 客户评价
- 服务质量

#### 6.5 技师收益管理
- 提成查询
- 收益明细
- 工资单
- 绩效奖金

#### 6.6 技师客户管理
- 我的客户
- 客户偏好
- 服务记录
- 客户标签

---

### 模块7：服务项目管理

#### 7.1 项目分类
- 一级分类
- 二级分类
- 分类排序

#### 7.2 项目信息
- 项目名称
- 项目描述
- 服务时长
- 价格体系
- 项目图片

#### 7.3 项目规则
- 技师要求
- 提成规则
- 服务流程
- 注意事项

#### 7.4 项目统计
- 销量统计
- 评价统计
- 收入统计

---

### 模块8：预约订单系统

#### 8.1 预约管理
- 在线预约
- 电话预约
- 到店预约
- 预约规则
- 预约提醒

#### 8.2 订单管理
- 订单创建
- 订单支付
- 订单状态流转
- 订单取消
- 订单退款

#### 8.3 订单详情
- 客户信息
- 服务项目
- 技师信息
- 订单金额
- 支付方式

#### 8.4 订单评价
- 服务评价
- 技师评价
- 环境评价
- 评价回复

---

### 模块9：分佣结算系统 ⭐

#### 9.1 分佣规则配置
- 技师提成规则
- 代理分佣规则
- 用户推广分佣规则
- 阶梯分佣规则
- 特殊奖励规则

#### 9.2 分佣计算引擎
- 实时分佣计算
- 多级分佣追溯
- 分佣记录生成
- 分佣统计报表

#### 9.3 收入结算
- 技师工资结算
- 代理分佣结算
- 用户推广结算
- 结算周期配置
- 结算审核流程

#### 9.4 提现管理
- 提现申请
- 提现审核
- 提现处理
- 提现记录
- 手续费配置

---

### 模块10：门店管理系统

#### 10.1 门店信息
- 门店基础信息
- 门店地址
- 营业时间
- 联系方式
- 门店图片

#### 10.2 多门店支持
- 门店列表
- 门店切换
- 门店权限
- 数据隔离

#### 10.3 门店设置
- 预约规则
- 服务项目
- 技师分配
- 价格策略

---

### 模块11：营销活动系统

#### 11.1 限时折扣
- 活动创建
- 折扣设置
- 时间限制
- 库存限制

#### 11.2 拼团活动
- 拼团规则
- 成团人数
- 拼团价格
- 拼团进度

#### 11.3 秒杀活动
- 秒杀商品
- 秒杀时间
- 秒杀库存
- 秒杀限购

#### 11.4 满减活动
- 满减规则
- 阶梯满减
- 活动时间
- 适用范围

---

### 模块12：商品管理系统

#### 12.1 商品信息
- 商品分类
- 商品名称
- 商品描述
- 商品图片
- 商品价格

#### 12.2 库存管理
- 库存数量
- 库存预警
- 入库记录
- 出库记录
- 盘点管理

#### 12.3 商品销售
- 商品订单
- 销售统计
- 库存扣减
- 退货管理

---

### 模块13：财务管理系统

#### 13.1 收入管理
- 订单收入
- 充值收入
- 商品收入
- 收入统计

#### 13.2 支出管理
- 技师工资
- 代理分佣
- 用户推广分佣
- 运营成本

#### 13.3 对账管理
- 日对账
- 月对账
- 支付渠道对账
- 差异处理

#### 13.4 发票管理
- 发票申请
- 发票开具
- 发票记录

---

### 模块14：数据报表系统

#### 14.1 经营报表
- 营业额统计
- 订单量统计
- 客户量统计
- 利润分析

#### 14.2 技师报表
- 技师业绩
- 技师排名
- 服务质量
- 客户满意度

#### 14.3 代理报表
- 代理业绩
- 团队规模
- 分佣收入
- 推广效果

#### 14.4 用户报表
- 用户增长
- 用户活跃
- 消费分析
- 推广效果

#### 14.5 财务报表
- 收入报表
- 支出报表
- 利润报表
- 现金流报表

---

### 模块15：系统管理

#### 15.1 权限管理
- 角色管理
- 权限配置
- 菜单权限
- 数据权限

#### 15.2 系统配置
- 基础配置
- 支付配置
- 短信配置
- 推送配置

#### 15.3 操作日志
- 登录日志
- 操作日志
- 异常日志
- 日志查询

#### 15.4 通知管理
- 短信通知
- 推送通知
- 站内消息
- 通知模板

---

## 三、数据库表设计（50+张表）

### 3.1 用户相关（8张表）
1. spa_customer - 客户信息表
2. spa_customer_referral - 用户推广关系表
3. spa_customer_level - 用户等级表
4. spa_customer_balance - 用户余额表
5. spa_customer_points - 用户积分表
6. spa_customer_card - 用户会员卡表
7. spa_customer_coupon - 用户优惠券表
8. spa_invite_code - 邀请码表

### 3.2 代理相关（6张表）
9. spa_agent - 代理信息表
10. spa_agent_income - 代理收入记录表
11. spa_agent_withdraw - 代理提现记录表
12. spa_agent_team_performance - 代理团队业绩表
13. spa_technician_agent_bind - 技师代理绑定表
14. spa_agent_referral - 代理推广关系表

### 3.3 技师相关（8张表）
15. spa_technician - 技师信息表
16. spa_technician_schedule - 技师排班表
17. spa_technician_attendance - 技师考勤表
18. spa_technician_service - 技师服务项目关联表
19. spa_technician_income - 技师收入记录表
20. spa_technician_salary - 技师月度工资表
21. spa_technician_performance - 技师月度绩效表
22. spa_technician_customer - 技师客户关系表

### 3.4 服务项目相关（3张表）
23. spa_service_category - 服务项目分类表
24. spa_service_item - 服务项目表
25. spa_service_item_sku - 服务项目SKU表

### 3.5 订单相关（5张表）
26. spa_order - 订单主表
27. spa_order_item - 订单项目明细表
28. spa_order_commission - 订单分佣记录表
29. spa_order_refund - 订单退款表
30. spa_order_evaluation - 订单评价表

### 3.6 会员卡相关（5张表）
31. spa_card_template - 会员卡模板表
32. spa_card_recharge - 充值记录表
33. spa_card_consume - 消费记录表
34. spa_card_times - 次卡记录表
35. spa_card_duration - 时长卡记录表

### 3.7 优惠券相关（3张表）
36. spa_coupon_template - 优惠券模板表
37. spa_coupon_issue - 优惠券发放记录表
38. spa_coupon_use - 优惠券使用记录表

### 3.8 积分相关（2张表）
39. spa_points_rule - 积分规则表
40. spa_points_log - 积分明细表

### 3.9 营销活动相关（4张表）
41. spa_activity - 营销活动表
42. spa_activity_discount - 限时折扣表
43. spa_activity_group - 拼团活动表
44. spa_activity_seckill - 秒杀活动表

### 3.10 商品相关（4张表）
45. spa_product - 商品表
46. spa_product_category - 商品分类表
47. spa_product_stock - 库存表
48. spa_product_stock_log - 库存流水表

### 3.11 门店相关（2张表）
49. spa_store - 门店表
50. spa_store_config - 门店配置表

### 3.12 财务相关（3张表）
51. spa_finance_income - 收入记录表
52. spa_finance_expense - 支出记录表
53. spa_finance_invoice - 发票表

### 3.13 分佣规则相关（2张表）
54. spa_commission_rule - 分佣规则配置表
55. spa_commission_settlement - 分佣结算表

### 3.14 系统相关（5张表）
56. spa_system_config - 系统配置表
57. spa_operation_log - 操作日志表
58. spa_login_log - 登录日志表
59. spa_message_template - 消息模板表
60. spa_message_log - 消息发送记录表

---

## 四、技术实现要点

### 4.1 分佣计算引擎
- 订单完成后触发分佣计算
- 查询技师的代理链路（3级）
- 查询用户的推广链路（3级）
- 查询适用的分佣规则
- 计算各方分佣金额
- 写入分佣记录
- 更新账户余额
- 发送分佣通知

### 4.2 会员卡核销
- 支持多种卡类型混合使用
- 优先级：次卡 > 时长卡 > 储值卡
- 自动扣减卡内余额/次数/时长
- 记录核销明细

### 4.3 优惠券叠加
- 配置优惠券叠加规则
- 计算最优优惠组合
- 自动应用最大优惠

### 4.4 积分抵扣
- 配置积分抵扣比例
- 限制最大抵扣金额
- 订单完成后返还积分

---

## 五、实施优先级

### P0（核心功能，第1-2周）
- 用户管理
- 技师管理
- 服务项目管理
- 订单管理
- 基础分佣计算

### P1（重要功能，第3-4周）
- 代理管理
- 用户推广体系
- 会员卡系统
- 优惠券系统
- 提现管理

### P2（增值功能，第5-6周）
- 积分系统
- 营销活动
- 商品管理
- 数据报表
- 财务管理

### P3（优化功能，第7-8周）
- 门店管理
- 权限管理
- 操作日志
- 通知系统
- 性能优化

---

## 六、成功指标

### 业务指标
- 月活跃用户 > 10000
- 推广用户占比 > 40%
- 用户复购率 > 60%
- 技师留存率 > 85%
- 代理活跃率 > 70%

### 财务指标
- 月交易额 > 100万
- 平台利润率 > 15%
- 分佣支出占比 < 35%
- 用户充值率 > 50%

---

**方案版本**：v2.0（完整版）
**更新时间**：2025-12-30
**设计者**：产品经理 AI Agent