技师端功能模块与微服务对应关系

项目名称: 麦瓣健康 - 技师端功能模块与微服务对应关系
文档版本: v3.1.1
最后更新: 2025-10-24
关联文档:

• 技师端APP功能清单v3.0
• 用户端功能模块与微服务对应关系
• 后端技术架构文档

📋 文档说明

本文档定义了技师端APP功能模块（11个模块，88个功能点）与后端微服务（10个业务服务）的对应关系，帮助开发团队明确：

1. 职责边界：每个微服务负责哪些功能模块
2. 接口归属：前端调用哪个微服务的API
3. 服务依赖：微服务之间的调用关系
4. 开发协作：前后端开发人员的协作边界

一、架构总览

1.1 微服务列表

1.2 端口与路由映射

说明：

• 所有请求通过API网关（端口8201）统一转发
• 技师端API通常包含 /nurse/ 路径标识
• 微服务之间使用服务名调用（通过Nacos服务发现）

二、技师端功能模块对应关系

2.1 核心业务模块（6个模块，52个功能）

模块1：账户系统（8个功能，89个细分需求点，50个API接口）

模块定位：技师端APP入口模块，负责技师注册、登录、实名认证、资质审核、服务类别选择、归属关系等核心功能，是技师入驻平台的第一步。

API说明：下表展示核心业务API（18个），完整API列表（50个）参见需求明细文档。

微服务职责划分：

• maiban-auth（2个功能）：
  • 手机号注册/登录（验证码发送、Token管理、设备管理）
  • 实名认证（身份证OCR、人脸识别、公安验证）
• maiban-nurse（6个功能）：
  • 资质证书管理（上传、验证、到期提醒）
  • 营业执照/灵活就业证明管理
  • 健康证明管理（健康证+无犯罪记录）
  • 服务类别准入管理（资质匹配、审核）
  • 性别验证与限制
  • 技师归属类型管理（平台/商户/团队）

关键业务流程：

新技师注册流程：
手机号登录 → 实名认证（身份证+人脸） → 资质上传（证书验证） 
→ 个体户执照上传 → 健康证明上传 → 服务类别选择 → 平台审核 → 开通接单权限

时间节点：
- 前端注册：3分钟完成
- 平台审核：2-3个工作日
- 专业严选：需线下考核，预约后7天内

准入控制规则：

技师归属类型对比：

归属切换规则：

• 技师可在"个人中心-归属管理"中切换归属类型
• 切换需先解除当前归属关系（商户/团队需双方确认）
• 平台技师→商户技师：需商户审核通过
• 平台技师→团队技师：需团队长审核通过
• 商户/团队技师→平台技师：需结算完当前订单收入
• 冷静期：解除归属后15天内不可再次加入同一商户/团队

关键指标：

• 注册转化率 ≥ 60%
• 审核通过率 ≥ 80%
• 资质真实率 = 100%
• 账户安全事故 = 0
• 平台技师占比 ≥ 60%（保持平台活跃度）
• 商户技师占比 ≤ 30%（控制商户依赖度）
• 团队技师占比 ≤ 10%（鼓励个体入驻）

安全机制：

• 数据传输：HTTPS + TLS 1.3
• 敏感数据：AES-256加密存储（身份证号、手机号）
• 防刷机制：同一手机号每天最多5次验证码，同一IP每小时最多10次
• 防暴力破解：验证码错误3次锁定5分钟
• 权限控制：未完成认证的技师无法接单

详细需求：参见 技师端账户系统需求明细文档

模块2：接单管理（11个功能）

微服务职责划分：

• maiban-nurse：在线状态、AI推荐订单
• maiban-order：订单核心流程、接单拒单
• maiban-user：用户群体信息
• maiban-im：消息中心

v3.0 LBS信息展示：

• 显示技师到用户的距离（km）
• 预估打车费用（基于高德地图API）
• 预计到达时间（分钟）
• 帮助技师决策是否接单

模块3：服务流程（13个功能）

微服务职责划分：

• maiban-order：服务流程核心状态管理、打卡、导航
• maiban-health-service：心率监测、服务日志、考核单
• maiban-payment：时薪计算、收入统计

关键业务规则：

操作前心率监测（v2.0核心功能）：

• 所有服务项目开始前必须进行心率监测
• 心率异常（<50或>120）系统提示：建议用户先休息
• 严重异常（<40或>140）强制提示：建议暂停服务，联系医生
• 未完成心率监测不能点击"开始服务"按钮

套餐服务确认（v3.0新增）：

• 技师完成服务后标记"服务完成"
• 系统自动通知客户端确认
• 客户24小时内需确认，超时自动确认
• 客户确认后，技师才能领取本次套餐提成
• 提成状态：待确认（冻结收入）、已确认（可提现余额）、有异议（平台处理中）

夜间服务费（v3.0新增）：

• 适用时段：22:00-次日08:00
• 适用服务：功能型服务中的手法通乳/手法回乳
• 费用计算：订单金额自动加收30%
• 夜间服务费全额归技师（平台不抽佣）
• 订单标识：显示"夜间"标签，明细显示"夜间服务费：+XX元"

时薪实时显示（v2.0优化）：

• 基础计算：(订单金额-平台佣金)÷服务时长
• 夜间服务：((基础服务费×1.3)-平台佣金)÷服务时长
• 实时更新，包含所有加成

模块4：收入管理（6个功能）

v3.0收入明细增强：

• 显示套餐订单确认状态（待确认/已确认）
• 显示夜间服务费金额
• 冻结收入与可提现余额分离

提成计算规则（maiban-payment）：

• 基础提成：订单金额×（1-平台佣金比例）
• 夜间服务费：全额归技师（不抽佣）
• 里程补贴：超过5km，每公里补贴2元
• 套餐订单：客户确认后才计入可提现余额

模块5：个人中心（9个功能）

关键业务规则：

营业时间设置（v2.0新增）：

• 专业严选、健康管理、功能型服务：标准时间 9:00-21:00
• 差旅放松：可营业至 23:00（延长服务）
• 肩颈快按：可营业至 22:00（延长服务）
• 技师可自定义每日营业时间段，非营业时间段系统自动拒绝新订单推送

荣誉墙管理（v2.0增强）：

• 可上传客户锦旗、表彰信、外部获奖证明（最多各20张）
• 平台自动颁发荣誉：年度金牌、月度之星、零投诉等
• 荣誉等级：铜牌（≥50单，好评率≥85%）、银牌（≥200单，好评率≥90%）、金牌（≥500单，好评率≥95%）、钻石（≥1000单，好评率≥98%，零投诉）、明星（平台特别表彰）

业绩统计（v3.0增强）：

• 夜间服务统计：夜间订单数、夜间服务费收入单独展示
• 套餐订单统计：待确认/已确认数量和收入分别统计
• 支持按服务类型筛选（5大类别）

学习中心（v3.0优化）：

• 健康知识库：5大服务类别专业知识、急救知识
• 技能培训视频：服务技巧、沟通话术
• 夜间服务安全培训：通乳类技师必修（v3.0新增）

模块6：服务类别管理（5个功能）

5大服务类别准入规则（v2.0核心功能）：

资质匹配验证逻辑（maiban-nurse）：

• 系统自动验证技师资质与服务类别的匹配度
• 健康管理类：自动验证技师性别，男性技师无法注册
• 专业严选：需联系客服预约线下考核，考核通过后开通
• 资质证书到期前30天提醒更新，过期自动关闭对应服务类别

服务类别切换（灵活接单）：

• 技师可根据当前情况切换接单的服务类别
• 例如：白天接"健康管理"，晚上切换到"差旅放松"（营业至23:00）
• 支持同时开启多个类别接单
• 不同类别有不同的营业时间限制

服务前准备清单（接单后自动推送）：

• 专业严选：携带专业评估工具（骨态测量仪等）、服务记录表
• 健康管理：携带香灸、推拿用品，注意女性隐私保护
• 功能型服务：携带对应服务所需用品
• 差旅放松：携带足部护理用品，准备放松音乐
• 肩颈快按：携带便携式按摩工具，确认是否为团购订单

2.2 增值服务模块（5个模块，36个功能）

模块7：即时通讯IM系统（7个功能）

技术方案：

• WebSocket：实时双向通信
• 消息存储：MongoDB（聊天记录）
• 离线消息：Redis（待推送队列）
• 推送：极光推送JPush

模块8：激励运营系统（8个功能）

激励触发机制（MQ异步）：

• 订单完成 → maiban-order 发送MQ → maiban-payment 发放完单奖励
• 收到好评 → maiban-order 发送MQ → maiban-payment 发放好评奖励
• 签到 → maiban-marketing 直接处理，累计签到天数

模块9：通知系统（7个功能）

通知触发机制（MQ）：

• 新订单 → maiban-order 发送MQ → maiban-im 推送通知
• 收入到账 → maiban-payment 发送MQ → maiban-im 推送通知
• 证书到期 → XXL-Job 定时任务 → maiban-im 推送通知

v3.0通知方式设置：

• 订单通知铃声：静音/振动/系统默认/自定义铃声
• 通知时段设置：休息时段可设置免打扰
• 通知类型开关：订单通知、收入通知、活动通知独立开关

模块10：业绩统计增强（6个功能）

数据统计维度：

• 按时间：日/周/月/年
• 按类别：5大服务类别分别统计
• 按时段：夜间订单单独统计
• 同行对比：同城市、同类别技师平均水平

模块11：老带新系统（8个功能）

模块定位：技师推广拉新系统，包括"技师邀请技师"（师徒关系）和"技师带用户"（绑定服务关系）两大功能。

技师邀请技师（师徒关系）规则：

• 邀请奖励：徒弟注册并完成首单，师傅获得100元奖励
• 徒弟提成：徒弟前30单，师傅获得每单5%的额外提成
• 师徒关系：有效期1年，期满自动解除（可续期）
• 徒弟上限：每个师傅最多带20个徒弟

技师带用户（绑定服务关系）规则：

• 绑定方式：
  • ① 技师生成专属邀请码/二维码，用户注册时填写
  • ② 技师通过手机号邀请，用户确认后绑定
  • ③ 用户首次下单选择技师，自动绑定（需用户同意）
• 绑定奖励：
  • 用户注册成功：技师获得50元奖励
  • 用户首单完成：技师额外获得100元奖励
• 长期提成：
  • 绑定用户在平台的所有订单（不限技师），技师获得订单金额的3%提成
  • 如用户指定绑定技师服务，技师获得正常服务收入+3%绑定提成
• 绑定关系：
  • 有效期：永久（除非用户/技师主动解除）
  • 用户上限：每个技师最多绑定500个用户
  • 独占性：用户只能绑定1个技师，绑定后其他技师无法邀请
• 解除规则：
  • 用户/技师均可主动解除绑定
  • 解除后15天冷静期，期间不可重新绑定
  • 解除前已产生的订单提成仍正常结算

双通道对比：

业务价值：

• 技师视角：打造私域流量，建立稳定客户群，获得长期被动收入
• 用户视角：绑定信任的技师，享受专属服务和优惠
• 平台视角：提升用户留存率，降低获客成本，形成技师-用户强绑定生态

三、v3.0新增功能映射

3.1 技师端v3.0新增功能

四、微服务间调用关系

4.1 技师端关键调用场景

场景1：技师接单

[技师端] 接单
  └─> [Gateway]
       └─> [Order服务] 接单
            ├─> [Nurse服务] 更新技师状态
            ├─> [User服务] 查询用户信息
            └─> [IM服务] 发送MQ通知用户

场景2：技师完成服务

[技师端] 完成服务
  └─> [Gateway]
       └─> [Order服务] 订单完成
            ├─> [Health服务] 保存服务日志
            ├─> [Payment服务] 结算提成
            │    ├─> [Nurse服务] 查询技师等级
            │    └─> [Marketing服务] 发放奖励（MQ）
            └─> [IM服务] 推送完成通知

场景3：套餐确认发放提成（v3.0新增）

[技师端] 完成套餐服务
  └─> [Gateway]
       └─> [Order服务] 标记服务完成
            └─> [IM服务] 通知用户确认（MQ）
                 
[用户端] 确认服务完成
  └─> [Gateway]
       └─> [Order服务] 更新确认状态
            └─> [Payment服务] 发放技师提成
                 ├─> 更新收入明细（待确认→已确认）
                 └─> [IM服务] 通知技师提成到账（MQ）

场景4：夜间服务费计算（v3.0新增）

[技师端] 22:00后接单
  └─> [Gateway]
       └─> [Order服务] 接单
            ├─> 检测服务时间段（22:00-08:00）
            ├─> 计算基础服务费×1.3
            ├─> 标记订单为"夜间订单"
            └─> [Payment服务] 记录夜间服务费
                 └─> 夜间服务费全额归技师（不抽佣）

4.2 消息队列（MQ）异步通信

五、相关文档

• 技师端APP功能清单v3.0
• 用户端功能模块与微服务对应关系
• 后端技术架构文档
• 数据库设计文档
• 分布式事务一致性设计

六、更新日志

v3.1.1 (2025-10-24 - API数量说明完善)：

• 📋 API统计说明：明确账户系统API数量
  • 模块1标题更新：新增"50个API接口"说明
  • 新增API说明：明确表格中展示18个核心API，完整50个API见需求明细文档
  • 表头更新："API示例" → "核心API示例"
  • 添加需求明细文档链接，方便查看完整API列表
• 🔗 文档一致性：确保架构文档与需求明细文档API数量一致性

v3.1.0 (2025-10-24 - 技师归属关系与用户绑定系统)：

• 🎯 重要新增：技师归属类型管理（平台技师/商户技师/团队技师）
  • 账户系统新增"技师归属类型选择"功能（第8个功能）
  • 支持3种归属类型：①平台技师（个体入驻）②商户技师（归属商户）③团队技师（加入团队）
  • 归属类型对比表：入驻方式、订单来源、结算方式、佣金比例、适用场景
  • 归属切换规则：解除关系、审核流程、15天冷静期
  • 关键指标：平台技师≥60%、商户技师≤30%、团队技师≤10%
• 🎯 重要新增：技师带用户系统（私域流量）
  • 老带新系统扩展为8个功能（原6个+新增2个）
  • 新增"技师带用户"功能：邀请码/二维码绑定、手机号邀请、首单自动绑定
  • 新增"用户绑定关系管理"功能：查看绑定用户、解除绑定
  • 绑定奖励：注册50元+首单100元
  • 长期提成：绑定用户所有订单永久3%提成（打造私域流量）
  • 绑定关系：永久有效、用户上限500个、独占性（用户只能绑定1个技师）
  • 双通道对比：技师邀请技师 vs 技师带用户
  • 业务价值：技师私域流量、用户留存、技师-用户强绑定生态
• 📊 功能点统计更新：
  • 总功能点：85个 → 88个（+3个）
  • maiban-nurse: 26个 → 27个（账户系统+1，老带新+2-1=+1）
  • maiban-payment: 13个 → 16个（老带新+3）
• 🔧 微服务职责更新：
  • maiban-nurse新增：技师归属类型管理、技师带用户、用户绑定关系管理
  • maiban-payment新增：绑定用户长期提成结算

v3.0.5 (2025-10-24 - 账户系统模块详细化)：

• 完善"模块1：账户系统"，与需求明细文档保持完全一致
• 新增：89个细分需求点说明
• 新增：详细的核心业务规则（每个功能点的关键规则）
• 新增：微服务职责详细划分（maiban-auth 2个功能，maiban-nurse 5个功能）
• 新增：关键业务流程图（新技师注册流程+时间节点）
• 新增：准入控制规则表（5大服务类别详细要求）
• 新增：关键指标、安全机制说明
• 新增：关联需求明细文档链接

v3.0.4 (2025-10-24 - 微服务统计修正)：

• 修正1.1微服务列表中的功能点统计，与账户系统需求明细保持一致
• maiban-auth: 2个功能（手机号注册/登录、实名认证）
• maiban-nurse: 26个功能，涉及8个模块
• maiban-order: 18个功能，涉及4个模块
• maiban-payment: 13个功能，涉及6个模块
• maiban-health-service: 4个功能
• maiban-marketing: 5个功能
• maiban-im: 16个功能，涉及5个模块

v3.0.3 (2025-10-24 - 文档拆分)：

• 将原综合文档拆分为用户端和技师端独立文档
• 技师端功能：11个模块，85个功能点
• 更新模块编号，使用连续编号（模块1-11）
• 优化文档结构，便于技师端开发团队查阅
• 补充技师端特有的业务规则说明

维护者：麦瓣健康架构团队