BMGO 宝妈AI · 微信小程序 功能模块详细设计文档

0. 文档说明​

0.1 编写目的​

将现有 宝妈AI Web 演示页 承载的产品形态，转化为一份可直接指导微信小程序开发的功能模块详细设计文档：明确模块边界、页面清单、数据模型、关键流程、接口清单、非功能与合规要求，并给出借助 AI 的研发周期评估。

0.2 信息基础与局限声明（重要）​

本设计的原始输入是一个对外演示页，而非完整需求文档或接口文档。演示页实际可采集到的信息为：

• 站点标题：BMGO 宝妈AI · 全功能演示
• 首页搜索占位文案：搜索活动、商品、帖子、新闻 → 说明平台存在 活动 / 商品 / 帖子 / 新闻 四类内容
• 运营 Banner：本周精选亲子手作市集·周末专场 / 9月2日 14:22 · 西湖区
• 首页模块：本周活动（含"查看全部"），列表项字段为「区域 / 标题 / 时间 / 场地 / 已报名 x/y / 立即报名」
• 会员模块：杭城十万宝妈会员 · 专属权益、真功夫水饺大礼包 · SVIP高级会员享 20% 推广返佣、VIP会员 ¥365/年、SVIP会员 ¥1314/年
• 地域信息：杭州（西湖区、滨江区、拱墅区、余杭区、萧山区、下城区）

因此：

⚠️ 结论：演示页只覆盖了首页与会员两块，其余模块（商城订单、社区发帖、分销结算、AI 能力）为基于"全功能演示"定位的推断设计。第 9 章列出了必须与业务方确认的问题清单。文档中的模块划分可直接用于需求评审的骨架。

0.3 术语表​

1. 产品定位与总体设计​

1.1 产品定位​

一句话定位：面向杭州宝妈人群的「本地亲子活动 + 会员制好物 + 同城社区 + AI 育儿助手」一体化服务平台。

差异化三支柱：

1. 线下活动——高频、强信任、天然具备社交裂变属性（亲子活动适合晒照传播）；
2. 会员制——¥365 / ¥1314 两档年费，用权益（礼包、折扣、优先报名、返佣）锁定长期复购；
3. AI（品牌名"宝妈AI"）——用于育儿问答、智能推荐、内容审核与客服降本。

1.2 目标用户与角色​

1.3 商业模式画布（简）​

1.4 核心业务闭环​

公域拉新（活动海报/社群分享）
   → 小程序注册（微信一键登录 + 手机号）
   → 浏览本周活动 / 内容种草
   → 开卡（VIP/SVIP）或直接报名
   → 线下参与 + 晒单（内容回流社区）
   → 会员权益持续消费（商城/活动）
   → 推广返佣裂变（SVIP 带新）
   → 回到"公域拉新"

1.5 信息架构（站点地图）​

BMGO 宝妈AI 小程序
├── 首页（Tab1）
│   ├── 搜索（全站：活动/商品/帖子/新闻）
│   ├── 运营 Banner 轮播
│   ├── 快捷金刚区
│   ├── 本周活动（卡片流 + 查看全部）
│   └── 会员权益入口
├── 活动（Tab2）
│   ├── 活动列表（区域/时间/类型筛选、排序）
│   ├── 活动详情
│   ├── 报名表单 / 支付
│   ├── 我的报名 + 核销码
│   └── 活动评价/晒单
├── 好物（Tab3，商城）
│   ├── 商品分类 / 列表 / 搜索
│   ├── 商品详情（SKU/库存/会员价）
│   ├── 购物车
│   ├── 结算下单（微信支付）
│   ├── 订单列表/详情/物流
│   └── 退款/售后
├── 社区（Tab4）
│   ├── 帖子流（推荐/关注/同城/话题）
│   ├── 发帖（图文/视频 + 话题）
│   ├── 帖子详情（点赞/评论/收藏/分享）
│   └── 用户主页（关注/粉丝）
├── 我的（Tab5）
│   ├── 会员卡 / 开卡续费
│   ├── 我的订单 / 我的报名 / 我的帖子 / 我的收藏
│   ├── 积分 / 优惠券 / 佣金
│   ├── 宝宝档案
│   ├── 地址管理
│   └── 客服 / 帮助 / 设置
└── 二级附属
    ├── 资讯（新闻列表/详情）
    ├── AI 助手（对话式育儿问答）
    ├── 消息中心
    ├── 分销中心（推广海报/佣金/提现/团队）
    └── 运营管理后台（H5/PC，独立端）

1.6 页面清单（共 48 页）​

2. 技术选型与总体架构​

2.1 前端技术选型（🟡 建议）​

推荐组合：

• 框架：小程序原生 + TypeScript + Skyline 渲染（可按需）
• UI 组件库：TDesign MiniProgram 或 Vant Weapp
• 状态管理：mobx-miniprogram（或轻量自研 store）
• 请求层：自研 request 封装（拦截器 + 登录态刷新 + 重试 + 埋点）
• 分包：主包仅放首页/登录/我的，活动、商城、社区、分销各自独立分包（控制主包 ≤ 2MB，总包 ≤ 20MB）

2.2 服务端技术选型（🟡 建议）​

推荐：NestJS + MySQL 8 + Redis + 腾讯云 COS + 微信支付 V3。理由：AI 对 TypeScript 生态的代码生成质量最高，能最大化本项目的"AI 提效"目标。

2.3 第三方能力依赖​

2.4 总体架构图​

┌─────────────────────────────────────────────────────────┐
│  微信小程序（原生 + TS）                                  │
│  首页 │ 活动 │ 好物 │ 社区 │ 我的   +  独立分包            │
└───────────────────────┬─────────────────────────────────┘
                        │ HTTPS / JSON (JWT)
┌───────────────────────▼─────────────────────────────────┐
│  API 网关（鉴权 / 限流 / 幂等 / 日志 / 埋点）              │
└───────────────────────┬─────────────────────────────────┘
        ┌───────────────┼────────────────┬───────────────┐
        ▼               ▼                ▼               ▼
   业务服务域       会员域           交易域           内容域
   活动/报名      会员卡/权益      订单/支付        帖子/资讯
   分销/佣金      积分/签到        商品/SKU         审核/推荐
        │               │                │               │
        └───────────────┴────────┬───────┴───────────────┘
                                 ▼
        MySQL 8（主从） │ Redis（缓存/队列/分布式锁）
        COS+CDN（媒体） │ 消息队列（佣金结算异步化）
                                 │
                    ┌────────────┴────────────┐
                    ▼                         ▼
             运营管理后台（Web）          定时任务/对账

3. 功能模块详细设计​

说明：每个模块按「模块目标 → 功能点表 → 页面与交互 → 数据模型 → 接口 → 边界与异常 → 埋点」组织。优先级 P0 = MVP 必须，P1 = 正式版，P2 = 迭代增强。

M01 账号与登录认证模块 ✅/🔶​

模块目标：完成用户身份建立、登录态维护、必要的资质认证，为会员/订单/分销提供唯一用户标识。

关键交互：

• 首启 → pages/auth/login（不强制），点击"报名/下单/开卡"时才弹授权；
• 手机号授权被拒 → 降级为"短信验证码"兜底路径。

边界与异常：session_key 过期；手机号已被其他账号绑定（需合并策略）；同一微信 unionid 多小程序账号收敛。

M02 首页与全站搜索模块 ✅​

模块目标：承载运营分发与全站流量分发，对应演示页的"搜索 + Banner + 本周活动 + 会员权益"。

首页首屏布局（还原演示页）：

┌──────────────────────────────┐
│  [搜索活动、商品、帖子、新闻]  │  ← 吸顶
├──────────────────────────────┤
│  Banner：本周精选亲子手作市集  │
│  9月2日 14:22 · 西湖区         │  ← 轮播
├──────────────────────────────┤
│  本周活动            [查看全部] │
│  ┌────────────────────────┐  │
│  │ 西湖区 亲子手作市集·周末专场│  │
│  │ 9月2日 14:22  西湖文化广场 │  │
│  │ 已报名 26/30      [立即报名]│  │
│  └────────────────────────┘  │
│  ……（共 6 条，横向/纵向卡片）  │
├──────────────────────────────┤
│  杭城十万宝妈会员 · 专属权益   │
│  真功夫水饺大礼包              │
│  SVIP 高级会员享 20% 推广返佣  │
│  VIP ¥365/年  SVIP ¥1314/年   │
└──────────────────────────────┘

接口：GET /home/layout（聚合首页所有区块）、GET /search/suggest、GET /search、GET /activity/list?week=1。

M03 活动报名模块 ✅（核心）​

模块目标：平台最高频、最具粘性的模块。实现"发现 → 报名 → 支付 → 到场核销 → 晒单"闭环。

关键流程（报名）：

列表 → 详情 → 点击"立即报名"
   → 校验：登录? 名额? 是否已报名?
   → 填报名表单
   → 费用 0? ──是──→ 直接创建报名单 → 凭证页
             └─否──→ 微信支付 → 支付回调 → 创建报名单 → 凭证页
   → 订阅消息授权（报名成功 / 开始前提醒）
   → 分享（海报/小程序卡片）→ 带来新用户

边界与异常：

• 并发抢名额：DECR 原子操作 + 支付超时释放（15 分钟未支付自动回滚名额）；
• 支付成功但回调延迟：前端轮询 + 服务端补单任务；
• 活动取消：批量退款 + 全员通知；
• 重复报名校验：user_id + activity_id 唯一索引。

核心表：activity、activity_session、activity_signup、activity_review、activity_custom_field。

M04 商城 · 商品与订单模块 🔶​

模块目标：承载"商品"内容类型与"会员价/权益礼包"变现，形成活动之外的第二消费场景。

订单状态机：

待付款 --支付成功--> 待发货 --发货--> 待收货 --确认收货--> 已完成
   │                   │                │
   ├─超时取消--> 已取消   └─退款--> 已退款  └─售后--> 售后中--> 已退款

边界与异常：重复支付、支付超时、库存回滚、并发下单、优惠券互斥规则、退款金额不会超过实付。

M05 社区 · 帖子模块 🔶​

模块目标：承载"帖子"内容类型，形成宝妈同城社交与 UGC 沉淀，反哺活动与商品转化。

边界与异常：图片/视频上传（COS 直传 + 压缩）、审核失败提示、重复提交、拉黑后的内容屏蔽。

M06 资讯 · 新闻模块 🔶​

模块目标：承载"新闻"内容类型，做 SEO/品牌背书与留存，为 AI 提供知识来源。

M07 会员与权益模块 ✅（核心变现）​

模块目标：实现 VIP ¥365/年、SVIP ¥1314/年两档会员的开通、续费、权益发放与到期管理。

权益对照（还原演示页 + 推断）：

⚠️ 表中比例/折扣为推断值，需业务确认（见第 9 章 Q7）。

M08 积分、签到与成长模块 🟡​

M09 分销 · 推广返佣模块 ✅（增长核心）​

模块目标：实现演示页明确出现的"SVIP 高级会员享 20% 推广返佣"，驱动低成本裂变。

⚠️ 合规红线（必须遵守）：

• 分销佣金仅限二级以内（一级 + 二级），严禁三级及以上；
• 佣金只能由真实商品/服务交易产生，不得以"人头费"作为主要收益；
• 提现需实名 + 代扣代缴个税说明；
• 页面文案避免"拉人头""躺赚""无限级"等违规表述。

核心表：distributor、dist_relation、commission_record、withdraw_order。

M10 AI 能力模块 🔶（品牌"宝妈AI"）​

模块目标：兑现"宝妈AI"品牌名，用 AI 提升用户体验与运营效率。建议先做降本增效型 AI（客服/审核/内容），再做用户端 AI 助手。

关键设计：

• 模型层抽象（LLMProvider 接口），支持混元 / DeepSeek / 通义等可切换，避免供应商锁定；
• RAG 检索用平台自有内容（活动、商品、资讯、FAQ），向量库可用腾讯云 VectorDB；
• 护栏优先：育儿/医疗类问题必须给"非医疗建议"声明，涉及儿童健康引导至线下就医。

边界与异常：模型超时降级（返回兜底话术）、内容风控拦截、上下文长度控制、成本上限熔断。

M11 消息通知模块 🔶​

触发场景清单：报名成功、活动开始前 24h/2h、活动取消、订单支付成功、发货、退款、会员到期前 7/3/1 天、佣金到账、提现结果、帖子被评论/点赞、审核结果。

M12 个人中心模块 ✅​

M13 运营管理后台模块 🔶​

形态：独立 Web（PC 优先，移动端自适应）。这是AI 提效最大的模块（大量 CRUD）。

M14 公共基础能力模块 🔶​

4. 核心业务流程​

4.1 会员开通与返佣绑定（最关键的资金流程）​

点击开卡 → 选卡（VIP ¥365 / SVIP ¥1314）
  → 微信支付 V3 下单（out_trade_no 幂等）
  → 用户支付 → 微信回调 → 校验签名 → 幂等落库
  → 会员卡生效（有效期 = 起算日 + 365 天 / 叠加）
  → 发放权益礼包（券/兑换码/实物）
  → 绑定分销关系（若来源带邀请码，首单卡关系）
  → 生成佣金记录（状态：待结算，T+N 后可提现）
  → 订阅消息通知（开卡成功 + 权益到账）

幂等与对账：以 out_trade_no 唯一约束；每日定时任务拉取微信对账单，处理"支付成功但业务未处理"的补单。

4.2 活动报名（含并发抢名额）​

详情页 → 报名 → 校验（登录/名额/重复报名）
  → Redis DECR 预占名额（原子）
  → 生成报名单（状态：待支付/待确认）
  → 收费活动 → 微信支付 → 回调 → 报名单转"已报名" + 发凭证
  → 15 分钟未支付 → 定时任务释放名额（INCR）
  → 订阅消息：报名成功 / 活动前 24h / 活动前 2h
  → 到场扫码核销 → 状态转"已参加" → 触发评价邀请

4.3 商城下单支付​

加购 → 结算页（地址/优惠券/积分/运费）→ 创建订单（锁库存）
  → 微信支付 → 回调 → 订单转"待发货" + 扣库存 + 返积分
  → 发货 → 物流 → 确认收货 → 完成后 T+N 结算分销佣金

4.4 AI 助手对话​

用户提问 → 意图识别（日常育儿/平台业务/需转人工）
  → RAG 检索（平台知识库 + FAQ + 活动商品库）
  → 组装 Prompt（含护栏与免责声明）→ LLM 流式输出
  → 内容风控过滤 → 返回
  → 未命中/高风险 → 转人工客服 / 引导线下就医

5. 数据模型设计（核心表）​

字段仅为设计要点，未穷举；均含 id / created_at / updated_at / deleted_at 通用字段。

6. 接口清单（示例，约 60 个）​

统一规范：GET/POST /api/v1/{module}/{resource}；返回 { code, message, data, trace_id }；鉴权用 Authorization: Bearer <accessToken>。

账号（M01）

首页 / 搜索（M02）

活动（M03）

商城与订单（M04）

社区（M05）

资讯（M06）：GET /news/list、GET /news/detail/{id}、GET /news/{id}/related

会员（M07）

积分签到（M08）：GET /points/account、GET /points/logs、POST /points/checkin、GET /points/checkin/status、POST /points/exchange

分销（M09）

AI（M10）：POST /ai/chat（SSE 流式）、GET /ai/sessions、GET /ai/session/{id}/messages、POST /ai/feedback

消息 / 通用（M11、M14）：GET /message/list、POST /message/read、GET /message/unread、POST /upload/sign（COS 直传签名）、POST /feedback、GET /config/agreements

运营后台（M13）：/admin/** 分组（活动/报名/商品/订单/会员/审核/分销/财务/看板），另含 /admin/auth/login、/admin/rbac/*。

7. 非功能性需求与合规​

7.1 性能​

7.2 安全​

• 全站 HTTPS；服务端校验签名、拒绝客户端传价格；
• 支付回调验签 + 幂等；
• 越权校验（用户只能访问自己的订单/报名/佣金）；
• 敏感数据加密存储（手机号、收款账号）；日志脱敏；
• 后台最小权限 + 操作审计；提现二次验证。

7.3 合规（重点，容易踩坑）​

8. 借助 AI 的研发周期评估​

8.1 评估口径与假设​

评估假设（需与实际团队核对）：

AI 提效系数定义：提效系数 = AI 辅助后工时 / 传统工时。系数越低，AI 提效越明显。

• 纯页面/CRUD/表单：0.35–0.45（AI 提效最大，页面与接口可由 AI 一次成型）
• 常规业务逻辑：0.5–0.6
• 资金/分佣/支付/对账与并发：0.6–0.75（AI 只能提速，无法替代人工严谨性）
• UI 设计（AI 生成稿 + 人工调优）：0.4
• 测试用例与自动化：0.5

8.2 模块工作量分解​

加上非开发工作：

总人力投入：传统 ≈ 304 人天 → AI 辅助 ≈ 155 人天（整体提效约 1.96×）

8.3 分期交付计划​

场景 A：MVP 优先上线（推荐，先跑通闭环）

MVP 范围：M01、M02、M03、M07、M11（简）、M12、M14 + M13 的活动/报名/会员/运营位子集。

场景 B：完整版（含商城、社区、资讯、积分、分销、AI）

场景 C：单人全栈 + 重度 AI

8.4 AI 提效策略（怎么用才真的快）​

⚠️ AI 不适合放手的地方（必须人工主导）：

1. 资金链路：支付签名、回调幂等、对账、分佣结算、提现 —— 必须人工设计与评审；
2. 并发与数据一致性：名额扣减、库存锁定、分布式事务；
3. 权限与越权：后台 RBAC、用户数据隔离；
4. 合规文案与规则：分销层级、儿童信息授权、AI 免责声明；
5. 微信审核适配：类目、资质、隐私接口声明（AI 常给出过时或不准确的平台规则）。

8.5 关键路径与不可压缩项​

结论：技术开发可以被 AI 压缩到 5-9 周，但资质与备案是硬约束——项目关键路径 = max(开发周期, 资质周期)。建议第一天就并行启动备案与支付资质申请。

8.6 风险清单​

8.7 结论（一句话）​

借 AI 之力，MVP 约 7 周（±1 周）、完整版约 12 周、单人全栈约 20-26 周；整体研发效率相比传统方式约 2×，其中后台管理端与 CRUD 类页面提效最显著（约 3×），而支付、分佣、并发一致性仍需人工兜底。真正的瓶颈不是代码，而是备案、支付资质与需求确认——这三件事应该在第一周同时启动。

9. 待业务方确认清单（Q&A）​

附录 A：开发排期甘特图（完整版，13 周）​

周次      1   2   3   4   5   6   7   8   9  10  11  12  13
需求/PRD  ██
UI 设计   ████████
备案/资质 ████████████████  (并行，可能长于开发)
前端开发      ████████████████████████████████
后端开发      ████████████████████████████████
后台开发          ████████████████████
联调测试                              ██████████████
提审/上线                                         ████████

附录 B：上线前检查清单​

• 小程序备案完成、主体资质齐全
• 隐私协议/用户协议已上线且首次启动弹窗
• 支付回调幂等与对账任务已上线并验证
• 活动名额并发压测通过（≥1000 QPS）
• 内容安全检测接入并验证
• 分销层级合规审查（≤2 级）已通过
• 儿童个人信息授权流程已实现
• 订阅消息模板全部报备通过
• 监控告警（接口错误率、支付成功率、AI 成本）已配置
• 客服人力与前 7 天应急排班已就位

文档结束 · V1.0 · 基于 https://baoma.icemoon.top 演示页反推设计