文件
huaqiapp/docs/README.md
linda d243ece39c feat: 补齐 M1–M9 全部 47 个功能点并打通前后端
后端(新增 7 控制器 + 2 服务 + 17 张表)
- Prepare:排卵预测、BBT(双向体温识别)、试纸识别(规则引擎+额度)、备孕任务、同房指导
- Family:邀请码绑定(≤5)、话术库、爱心积分、私密留言、家庭健康视图
- Health:按周期阶段输出饮食/运动/睡眠/痛经四类建议
- Relation:关系测评、引导卡、冲突工具、课程下单、双人任务(联动记忆)、纪念日
- Parenting:宝宝档案、成长记录、月龄活动匹配、共育任务、育儿情绪、疫苗儿保排期
- Consult:咨询师(资质/定价/时段)、预约下单/取消、量表测评(4 套)、危机干预转介
- Setting:自定义提醒 CRUD、数据备份快照与恢复(保留 5 份)
- Mood 增补急救包;Home 提醒合并自定义提醒
- 服务层:ContentService(统一内容/锁态/购买态)、AssessmentService(计分分级+危机识别)

前端(新增 8 页面)
- 备孕、家人共护、健康建议、两性关系、亲子教育、心理咨询、测评执行页、情绪急救包
- 首页快捷入口扩至 8 个模块;我的页新增提醒中心与数据备份
- utils/api.js 扩至 84 个接口

数据(可重复执行脚本)
- 03_modules.sql:fa_reminder/bbt/lh_test/task/family_bind/care_message/point_log/memory/
  assessment(+record)/course_order/baby/growth_record/vaccine/counselor/consult_order/user_backup
- 04_module_seed.sql:话术6/引导卡6/冲突3/急救4/同房3/课程6/活动6/育儿情绪4/知识7、
  4 套量表、17 项疫苗儿保、3 位咨询师

验证(全部通过)
- 接口全链路 82 项断言(M1–M9,含高风险测评危机干预、备份恢复)
- 契约校验 84 接口 0 偏差;Vue SFC 19/19、SCSS 18/18 编译通过
- 修复 3 个真实缺陷:action 内调用 action 导致响应被劫持、coTasks 返回数组、
  咨询时段跨年错误
2026-11-05 23:27:21 +08:00

2.5 KiB

花期 APP 项目文档

文档 内容 适用对象
01-产品功能模块清单 9 大模块 / 47 个功能点,含付费模式、优先级、开发要点;营销付费体系与权益矩阵 产品、运营、开发、测试
02-开发文档 技术架构、仓库结构、环境与部署、前后端开发约定、模块实现映射、迭代计划、测试、合规、已知问题 开发、运维
03-数据模型与接口设计 表结构草案(DDL)、接口清单、业务规则、落地顺序 后端、前端
04-前端设计系统与联调验证 暖色调设计令牌、组件规范、页面地图、接口契约表、全链路验证报告 设计、前端、测试
05-功能覆盖度与实现说明 M1–M9 共 47 个功能点逐条对照、接口与表映射、验证结论、已知限制 产品、开发、测试、运营

快速了解

  • 产品:女性生理周期 + 情绪疗愈 + 科学备孕 + 家人共护 + 两性关系 + 亲子教育 + 心理服务
  • 技术:uni-app(Vue 3)小程序/App + FastAdmin(ThinkPHP 5.0) 后端 + MySQL 5.7
  • 仓库:前端在根目录,后端源码在 server/(与线上服务器同步)
  • 上线节奏:V1.0(P0,19 项)→ V1.1(P1,18 项)→ V2.0(P2,10 项)
  • 当前进度:M1–M9 共 47 个功能点全部实现并联调通过(详见 05 文档)
  • 变现:会员订阅为主轴(月/年/终身),课程与咨询/测评为副,按次增值补充;坚持零广告
  • 设计:暖色调(花红 #E8604C + 蜜橙 #F5A65B + 暖米白 #FFF9F5),设计令牌见 uni.scss

验证脚本

python3 scripts/verify/api_flow_test.py     # 后端接口全链路(82 项断言,M1–M9)
python3 scripts/verify/contract_check.py    # 前后端契约静态校验
node scripts/verify/vue_compile_check.mjs   # Vue SFC 编译(需 @vue/compiler-sfc)
node scripts/verify/scss_compile_check.mjs  # SCSS 编译(需 sass)

重要约定

  • 后台入口是隐藏入口(非 /admin),具体地址见 02-开发文档 4.1
  • PHP 8.5 兼容垫片(error_reporting 抑制弃用告警)不可删除,否则验证码与页面会 500/404
  • .env、AGENTS.md(含密钥)禁止入库,已在 .gitignore 中强制排除