用户端功能模块与微服务对应关系

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

📋 文档说明

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

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

一、架构总览

1.1 微服务列表

序号微服务名称端口核心职责用户端功能模块数用户端功能点数
1maiban-auth8401认证授权1个3个
2maiban-user8080用户体系3个24个
3maiban-nurse8082技师体系3个30个
4maiban-order8083订单管理2个24个
5maiban-payment8084支付财务2个11个
6maiban-health-service8087健康管理3个16个
7maiban-marketing8090营销运营6个46个
8maiban-im8085通讯推送4个24个
9maiban-mall8091商城电商2个13个
10maiban-search8089搜索引擎1个3个
合计10个微服务--26个模块171个功能点

1.2 端口与路由映射

微服务服务端口网关路由前缀访问示例
maiban-auth8401/api/v1/auth/**http://localhost:8201/api/v1/auth/login
maiban-user8080/api/v1/user/**http://localhost:8201/api/v1/user/info
maiban-nurse8082/api/v1/nurse/**http://localhost:8201/api/v1/nurse/list
maiban-order8083/api/v1/order/**http://localhost:8201/api/v1/order/create
maiban-payment8084/api/v1/payment/**http://localhost:8201/api/v1/payment/pay
maiban-health-service8087/api/v1/health/**http://localhost:8201/api/v1/health/records
maiban-marketing8090/api/v1/marketing/**http://localhost:8201/api/v1/marketing/coupons
maiban-im8085/api/v1/im/**http://localhost:8201/api/v1/im/send
maiban-mall8091/api/v1/mall/**http://localhost:8201/api/v1/mall/products
maiban-search8089/api/v1/search/**http://localhost:8201/api/v1/search/nurses

说明：

  • 所有请求通过API网关（端口8201）统一转发
  • 网关负责鉴权、限流、日志记录
  • 微服务之间使用服务名调用（通过Nacos服务发现）

二、用户端功能模块对应关系

2.1 核心业务模块（7个模块，48个功能）

模块1：账户系统（4个功能）

功能归属微服务API示例说明
手机号注册/登录maiban-authPOST /api/v1/auth/login短信验证码登录
微信授权登录maiban-authPOST /api/v1/auth/wechat微信快捷登录
实名认证maiban-authPOST /api/v1/auth/realname身份证+人脸识别
账号注销maiban-userDELETE /api/v1/user/account账号注销

微服务职责划分：

  • maiban-auth：负责登录、Token生成、身份认证
  • maiban-user：负责用户信息管理、账号注销

模块2：首页与技术老师选择（13个功能）

功能归属微服务API示例说明
服务类别展示maiban-nurseGET /api/v1/nurse/categories5大服务类别
技术老师列表maiban-nurseGET /api/v1/nurse/list技师列表+筛选
技术老师筛选maiban-nurseGET /api/v1/nurse/filter距离/评分/价格/项目筛选
技术老师详情页maiban-nurseGET /api/v1/nurse/{id}技师详情+商家信息+LBS信息
技术老师形象展示maiban-nurseGET /api/v1/nurse/{id}/media照片/视频
技术老师荣誉展示maiban-nurseGET /api/v1/nurse/{id}/honors证书/荣誉
营业时间显示maiban-nurseGET /api/v1/nurse/{id}/hours营业时间
收藏技术老师maiban-userPOST /api/v1/user/favorites收藏
推荐技术老师maiban-nurseGET /api/v1/nurse/recommendAI推荐算法
用户群体识别maiban-userGET /api/v1/user/profile/group识别用户群体
搜索技术老师maiban-searchGET /api/v1/search/nursesES搜索
城市切换maiban-nurseGET /api/v1/nurse/cities城市列表
健康知识maiban-health-serviceGET /api/v1/health/knowledge健康科普

微服务职责划分：

  • maiban-nurse：技师核心数据、列表、详情、推荐算法
  • maiban-user：用户收藏、用户群体识别
  • maiban-search：技师搜索（Elasticsearch）
  • maiban-health-service：健康知识内容

服务间调用：

  • maiban-nurse → maiban-order：查询技师接单量、好评率
  • maiban-search → maiban-nurse：从技师服务同步数据到ES

模块3：下单与支付（9个功能）

功能归属微服务API示例说明
选择服务类别maiban-nurseGET /api/v1/nurse/service-categories5大类
选择服务项目maiban-nurseGET /api/v1/nurse/services服务项目
选择技术老师maiban-nurseGET /api/v1/nurse/{id}技师信息
选择服务地址maiban-userGET /api/v1/user/addresses地址列表
差异化预约时间maiban-orderGET /api/v1/order/available-times可预约时间
营业时间智能提示maiban-nurseGET /api/v1/nurse/{id}/available营业时间
团购下单maiban-orderPOST /api/v1/order/group团购订单
在线支付maiban-paymentPOST /api/v1/payment/pay支付
价格计算maiban-orderPOST /api/v1/order/calc-price价格计算（含夜间服务费）

微服务职责划分：

  • maiban-nurse：服务类别、服务项目、技师信息、营业时间
  • maiban-user：用户地址管理
  • maiban-order：订单创建、预约时间、价格计算、团购订单
  • maiban-payment：支付处理

价格计算逻辑（maiban-order）：

  • 基础服务费
  • 距离费（5km以上）
  • 夜间服务费（22:00-08:00加收30%）
  • 节假日加收
  • 优惠抵扣（调用maiban-marketing）

模块4：订单管理（11个功能）

功能归属微服务API示例说明
订单列表maiban-orderGET /api/v1/order/list订单列表
订单详情maiban-orderGET /api/v1/order/{id}订单详情
实时位置追踪maiban-orderGET /api/v1/order/{id}/location技师位置（Redis GEO）
心率监测记录查看maiban-health-serviceGET /api/v1/health/heart-rate/{orderId}心率记录
服务延时maiban-orderPOST /api/v1/order/{id}/extend延时申请
取消订单maiban-orderPOST /api/v1/order/{id}/cancel取消订单
售后申请maiban-orderPOST /api/v1/order/{id}/after-sale售后/退款
服务日志查看maiban-health-serviceGET /api/v1/health/service-log/{orderId}服务记录
团购订单管理maiban-orderGET /api/v1/order/group/{id}团购订单详情
订单评价maiban-orderPOST /api/v1/order/{id}/review评价
电子发票maiban-paymentPOST /api/v1/payment/invoice申请发票

微服务职责划分：

  • maiban-order：订单核心数据、状态流转、评价、团购订单
  • maiban-health-service：心率监测记录、服务日志
  • maiban-payment：电子发票

服务间调用：

  • 订单取消 → 调用 maiban-payment 退款
  • 订单完成 → 调用 maiban-payment 结算分账
  • 订单评价 → 调用 maiban-nurse 更新技师评分

模块5：健康档案（4个功能）

功能归属微服务API示例说明
家庭成员管理maiban-userGET /api/v1/user/family成员列表
健康档案maiban-health-serviceGET /api/v1/health/profile/{memberId}健康档案
服务记录maiban-health-serviceGET /api/v1/health/records/{memberId}服务记录
健康报告maiban-health-serviceGET /api/v1/health/report/{memberId}PDF导出

微服务职责划分：

  • maiban-user：家庭成员基本信息
  • maiban-health-service：健康档案、服务记录、健康报告

模块6：投诉建议（2个功能）

功能归属微服务API示例说明
投诉技术老师maiban-orderPOST /api/v1/order/complaint投诉
服务建议maiban-imPOST /api/v1/im/feedback建议

微服务职责划分：

  • maiban-order：订单相关投诉
  • maiban-im：平台建议反馈

模块7：个人中心（10个功能）

功能归属微服务API示例说明
个人信息管理maiban-userGET /api/v1/user/profile个人信息
地址管理maiban-userGET /api/v1/user/addresses地址管理
我的钱包maiban-paymentGET /api/v1/payment/wallet储值账单+消费记录
我的收藏maiban-userGET /api/v1/user/favorites收藏列表
会员中心maiban-marketingGET /api/v1/marketing/member会员信息
积分中心maiban-marketingGET /api/v1/marketing/points积分余额
套餐计划maiban-mallGET /api/v1/mall/packages套餐列表
邀请好友maiban-userPOST /api/v1/user/invite邀请码生成
客服中心maiban-imPOST /api/v1/im/contact-service在线客服
设置maiban-userPUT /api/v1/user/settings设置

微服务职责划分：

  • maiban-user：个人信息、地址、收藏、邀请、设置
  • maiban-payment：钱包、储值、消费记录
  • maiban-marketing：会员、积分
  • maiban-mall：套餐计划
  • maiban-im：客服

2.2 增值服务模块（4个模块，20个功能）

模块8：服务项目管理（4个功能）

功能归属微服务API示例说明
项目详情页maiban-nurseGET /api/v1/nurse/service/{id}项目详情
服务类别详细说明maiban-nurseGET /api/v1/nurse/categories/{id}类别说明
项目分类浏览maiban-nurseGET /api/v1/nurse/services/categories分类
项目搜索maiban-searchGET /api/v1/search/services项目搜索

模块9：积分系统（6个功能）

功能归属微服务API示例说明
积分余额maiban-marketingGET /api/v1/marketing/points/balance积分余额
签到送积分maiban-marketingPOST /api/v1/marketing/points/checkin签到
积分累计maiban-marketingPOST /api/v1/marketing/points/earn累计积分
积分兑换maiban-marketingPOST /api/v1/marketing/points/redeem兑换
积分明细maiban-marketingGET /api/v1/marketing/points/history明细
积分升级项目maiban-marketingPOST /api/v1/marketing/points/upgrade升级

积分触发场景（MQ异步）：

  • 订单完成 → maiban-order 发送MQ → maiban-marketing 累计积分
  • 签到 → maiban-marketing 直接处理
  • 邀请好友 → maiban-user 发送MQ → maiban-marketing 累计积分

模块10：会员系统（5个功能）

功能归属微服务API示例说明
消费自动升级maiban-marketingPOST /api/v1/marketing/member/upgrade自动升级
会员等级体系maiban-marketingGET /api/v1/marketing/member/levels等级体系
等级权益maiban-marketingGET /api/v1/marketing/member/benefits权益说明
会员专属券maiban-marketingGET /api/v1/marketing/coupons/member会员券
AI体测权益maiban-health-serviceGET /api/v1/health/ai-testAI体测

会员升级逻辑（定时任务）：

  • XXL-Job 每日凌晨计算年度消费次数
  • 自动升级/降级会员等级
  • 发放对应等级的专属券

模块11：健康管理（7个功能）

功能归属微服务API示例说明
体检报告上传maiban-health-servicePOST /api/v1/health/report/upload上传报告
体检报告AI分析maiban-health-servicePOST /api/v1/health/report/analyzeAI分析
身体对应点选择maiban-health-servicePOST /api/v1/health/body-map选择部位
项目推荐maiban-nurseGET /api/v1/nurse/recommend-by-health健康推荐
营养推荐maiban-health-serviceGET /api/v1/health/nutrition营养方案
健康计划管理maiban-health-serviceGET /api/v1/health/plan健康计划
健康数据对比maiban-health-serviceGET /api/v1/health/compare数据对比

2.3 智能化模块（2个模块，13个功能）

模块12：物联网设备集成（7个功能）

功能归属微服务API示例说明
设备购买跳转maiban-mallGET /api/v1/mall/devices设备商品
扫码绑定设备maiban-health-servicePOST /api/v1/health/device/bind绑定
亲人关注功能maiban-userPOST /api/v1/user/family/follow关注
设备绑定maiban-health-servicePOST /api/v1/health/device/connect连接
实时数据同步maiban-health-servicePOST /api/v1/health/device/sync同步
数据展示maiban-health-serviceGET /api/v1/health/device/data数据
异常预警maiban-health-serviceGET /api/v1/health/device/alerts预警

物联网数据流：

  1. 设备数据 → MQTT Broker → maiban-health-service
  2. 数据存储 → MongoDB（时序数据）
  3. 异常预警 → maiban-im 推送通知

模块13：商城功能（8个功能）

功能归属微服务API示例说明
商品分类浏览maiban-mallGET /api/v1/mall/categories分类
商品列表maiban-mallGET /api/v1/mall/products商品列表
商品详情页maiban-mallGET /api/v1/mall/products/{id}商品详情
商品搜索maiban-searchGET /api/v1/search/products商品搜索
购物车maiban-mallGET /api/v1/mall/cart购物车
商品订单管理maiban-mallGET /api/v1/mall/orders商品订单
退货退款maiban-mallPOST /api/v1/mall/orders/{id}/refund退货
商品评价maiban-mallPOST /api/v1/mall/orders/{id}/review评价

2.4 社交互动模块（3个模块，17个功能）

模块14：社交互动（4个功能）

功能归属微服务API示例说明
点赞功能maiban-imPOST /api/v1/im/like点赞
评论互动maiban-imPOST /api/v1/im/comment评论
分享功能maiban-imPOST /api/v1/im/share分享
社区动态maiban-imGET /api/v1/im/feeds动态

模块15：通知系统（6个功能）

功能归属微服务API示例说明
订单通知maiban-im-MQ触发推送
系统通知maiban-imPOST /api/v1/im/notice系统消息
活动通知maiban-imPOST /api/v1/im/activity活动消息
养护提醒maiban-health-servicePOST /api/v1/health/reminder提醒
设备预警通知maiban-health-service-自动触发
消息中心+通知方式设置maiban-imGET /api/v1/im/messages消息中心

通知触发机制（MQ）：

  • 订单状态变化 → maiban-order 发送MQ → maiban-im 推送通知
  • 支付成功 → maiban-payment 发送MQ → maiban-im 推送通知
  • 设备异常 → maiban-health-service 发送MQ → maiban-im 推送通知

模块16：内容社区（7个功能）

功能归属微服务API示例说明
经验分享maiban-imPOST /api/v1/im/postUGC内容
健康知识文章maiban-health-serviceGET /api/v1/health/articlesPGC内容
直播maiban-imPOST /api/v1/im/live直播
话题讨论区maiban-imGET /api/v1/im/topics话题
问答社区maiban-imPOST /api/v1/im/qa问答
内容互动maiban-imPOST /api/v1/im/interact互动
内容推荐maiban-marketingGET /api/v1/marketing/content-recommend基于兴趣推荐

内容推荐逻辑（maiban-marketing）：

  • 基于用户浏览历史、订单记录、健康档案等数据
  • 推荐相关的健康知识文章、直播预告、话题讨论
  • 使用协同过滤算法，推荐相似用户感兴趣的内容
  • 实时更新推荐结果

2.5 运营增长模块（6个模块，45个功能）

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

功能归属微服务API示例说明
一对一聊天maiban-imWebSocket /ws/chatWebSocket
消息类型支持maiban-imPOST /api/v1/im/send文字/图片/语音
消息已读状态maiban-imPUT /api/v1/im/read已读
聊天记录保存maiban-imGET /api/v1/im/history历史记录
敏感词过滤maiban-im-自动过滤
客服介入maiban-imPOST /api/v1/im/service客服
消息提醒maiban-im-推送

IM技术方案：

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

模块18：优惠券系统（10个功能）

功能归属微服务API示例说明
券中心maiban-marketingGET /api/v1/marketing/coupon-center券中心
促销券/优惠券分类maiban-marketingGET /api/v1/marketing/coupons券列表
抢券功能maiban-marketingPOST /api/v1/marketing/coupons/grab抢券
按等级发放maiban-marketing-自动发放
我的优惠券maiban-marketingGET /api/v1/marketing/my-coupons我的券
优惠券使用maiban-marketingPOST /api/v1/marketing/coupons/use使用券
优惠券兑换码maiban-marketingPOST /api/v1/marketing/coupons/redeem兑换
优惠券到期提醒maiban-marketing-定时任务
优惠券叠加规则maiban-marketingPOST /api/v1/marketing/coupons/calc计算
优惠券核销记录maiban-marketingGET /api/v1/marketing/coupons/history历史

优惠券核心逻辑：

  • 库存扣减：Redis分布式锁（防止超发）
  • 到期提醒：XXL-Job定时任务
  • 自动发放：会员等级变化触发（MQ）

模块19：套餐计划（5个功能）

功能归属微服务API示例说明
套餐购买maiban-mallPOST /api/v1/mall/packages/buy购买套餐
套餐确认maiban-orderPOST /api/v1/order/package/confirm客户确认（v3.0新增）
套餐核销maiban-orderPOST /api/v1/order/package/use核销
套餐记录maiban-mallGET /api/v1/mall/packages/records记录
复购跳转maiban-mallGET /api/v1/mall/packages/repurchase复购

v3.0套餐确认机制：

  1. 技师完成服务 → maiban-order 创建确认请求
  2. 用户24小时内确认 → maiban-order 更新状态
  3. 确认后 → maiban-payment 发放技师提成
  4. 超时自动确认 → XXL-Job 定时任务

模块20：新手引导与帮助（6个功能）

功能归属微服务API示例说明
首次使用引导maiban-userGET /api/v1/user/guide引导页
新手任务maiban-marketingGET /api/v1/marketing/tasks/newbie新手任务
视频教程中心maiban-imGET /api/v1/im/tutorials教程
图文帮助手册maiban-imGET /api/v1/im/help帮助
常见问题FAQmaiban-imGET /api/v1/im/faqFAQ
智能客服机器人maiban-imPOST /api/v1/im/botAI客服

模块21：运营活动系统（9个功能）

功能归属微服务API示例说明
限时秒杀maiban-marketingPOST /api/v1/marketing/seckill秒杀
拼团购买maiban-marketingPOST /api/v1/marketing/group-buy拼团
新人专享礼包maiban-marketingGET /api/v1/marketing/newbie-pack新人礼包
签到打卡maiban-marketingPOST /api/v1/marketing/checkin签到
任务中心maiban-marketingGET /api/v1/marketing/tasks任务
会员等级体系maiban-marketingGET /api/v1/marketing/member会员
成长值系统maiban-marketingGET /api/v1/marketing/growth成长值
节日活动maiban-marketingGET /api/v1/marketing/festivals节日活动
满减活动maiban-marketingGET /api/v1/marketing/discount满减

模块22：红包系统（6个功能）

功能归属微服务API示例说明
现金红包maiban-marketingPOST /api/v1/marketing/redpacket/cash拉新、促活现金红包
随机红包maiban-marketingPOST /api/v1/marketing/redpacket/random拆红包随机金额
口令红包maiban-marketingPOST /api/v1/marketing/redpacket/code输入口令领取
生日红包maiban-marketingGET /api/v1/marketing/redpacket/birthday生日当天专属红包
节日红包maiban-marketingGET /api/v1/marketing/redpacket/festival春节、国庆等节日红包
红包雨活动maiban-marketingPOST /api/v1/marketing/redpacket/rain限时红包雨互动

红包系统核心逻辑：

  • 现金红包：直接抵扣订单金额或到账余额，有效期7-30天
  • 随机红包：设置总额和个数，随机分配金额，最佳手气奖励
  • 口令红包：输入特定口令领取，每个口令限领1次
  • 生日红包：生日当天自动发放（20-50元），含订单9折特权
  • 节日红包：按节日主题发放（春节、国庆、母亲节等）
  • 红包雨活动：特定时间段红包掉落，点击抢红包，实时排行榜

技术实现：

  • 库存控制：Redis原子操作防止超发
  • 分布式锁：保证红包领取的并发安全
  • 异步发放：MQ异步处理红包到账
  • 风控策略：同一用户限制领取次数，防止羊毛党

2.6 用户体验模块（2个模块，15个功能）

模块23：老年人适配功能（8个功能）

功能归属微服务API示例说明
大字体模式前端本地-客户端实现
简化模式前端本地-客户端实现
语音输入第三方SDK-语音识别
语音播报前端本地-客户端实现
语音搜索maiban-searchPOST /api/v1/search/voice语音搜索
一键呼叫客服maiban-imPOST /api/v1/im/call呼叫
远程协助maiban-userPOST /api/v1/user/remote-assist远程协助
无障碍模式前端本地-客户端实现

模块24：用户体验优化（7个功能）

功能归属微服务API示例说明
深色模式前端本地-客户端实现
主题切换前端本地-客户端实现
手势操作前端本地-客户端实现
搜索历史maiban-searchGET /api/v1/search/history搜索历史
浏览历史maiban-userGET /api/v1/user/history浏览历史
最近联系人maiban-imGET /api/v1/im/recent最近联系
快捷操作前端本地-客户端实现

2.7 安全合规模块（2个模块，11个功能）

模块25：安全保障（3个功能）

功能归属微服务API示例说明
技师实名认证maiban-authPOST /api/v1/auth/realname实名认证
服务录音maiban-orderPOST /api/v1/order/{id}/recording录音
安全手环集成maiban-health-servicePOST /api/v1/health/bracelet手环数据

模块26：隐私与安全强化（8个功能）

功能归属微服务API示例说明
隐私设置中心maiban-userGET /api/v1/user/privacy隐私设置
登录设备管理maiban-authGET /api/v1/auth/devices设备管理
异常登录提醒maiban-auth-异地登录
敏感操作验证maiban-authPOST /api/v1/auth/verify二次验证
数据导出maiban-userPOST /api/v1/user/export导出数据
账号注销优化maiban-userDELETE /api/v1/user/account注销
权限管理maiban-userGET /api/v1/user/permissions权限
隐私协议更新maiban-userGET /api/v1/user/privacy-policy隐私协议

三、v3.0新增功能映射

3.1 用户端v3.0新增功能

新增功能归属微服务API示例说明
套餐确认机制maiban-orderPOST /api/v1/order/package/confirm客户确认后技师才能领提成
夜间服务费maiban-order + maiban-payment-22:00-08:00自动加收30%
LBS位置信息maiban-orderGET /api/v1/order/{id}/lbs-info距离、打车费用、预计时间
通知方式设置maiban-imPUT /api/v1/im/notification-settings静音/振动/铃声可选
我的钱包maiban-paymentGET /api/v1/payment/wallet储值账单+消费记录分离

四、相关文档

五、更新日志

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

  • 将原综合文档拆分为用户端和技师端独立文档
  • 用户端功能：26个模块，171个功能点
  • 更新模块编号，使用连续编号（模块1-26）
  • 优化文档结构，便于前端开发团队查阅

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