chore: 初始化项目结构并添加基础配置文件

添加后端API和前端项目的初始目录结构,包括应用层模块、工具模块和模型定义
配置前后端的.dockerignore文件以排除开发环境文件
添加前端样式文件,包括字体、Tailwind CSS和主题配置
初始化Python虚拟环境中的类型标记文件
This commit is contained in:
2026-04-01 16:55:24 +08:00
commit cfdeeb5e41
4149 changed files with 837587 additions and 0 deletions

View File

@@ -0,0 +1,383 @@
# 🤰 孕期健康检查报告解读应用 - 完整功能列表
## 📊 应用概览
**总共 6 个核心模块 | 18 个完整页面 | 全流程闭环**
---
## 模块一:登录与初始化 ✅
### 1. 登录页面 (`/`)
- ✅ 微信、手机号、Apple ID 快捷登录
- ✅ 温馨的欢迎文案
- ✅ 隐私保护说明
### 2. 用户画像页面 (`/onboarding`)
- ✅ 收集孕周信息(末次月经 / 直接输入)
- ✅ 收集预产期
- ✅ 收集孕妈基本信息
- ✅ 情感化设计
---
## 模块二:报告采集与录入 ✅
### 3. 首页 (`/home`)
- ✅ 当前孕周信息卡片
- ✅ 快捷操作:拍照录入、健康档案、运动方案
- ✅ 报告列表(三色预警)
- ✅ 孕期小贴士
- ✅ 浮动"+"按钮
### 4. OCR 拍照页面 (`/camera`)
- ✅ 实时相机预览
- ✅ 智能取景框引导
- ✅ 拍摄提示(光线、角度、防抖)
- ✅ AI OCR 识别
- ✅ 隐私自动脱敏说明
- ✅ 重拍/确认功能
### 5. 数据校对页面 (`/review` 或 `/verify`)
- ✅ OCR 识别结果展示
- ✅ 分类折叠展示
- ✅ Inline 编辑功能
- ✅ 三色预警标识
- ✅ 补充录入区域
- ✅ 隐私脱敏显示
---
## 模块三:AI 解读 ✅
### 6. AI 智能解读页面 (`/analysis/:reportId`)
- ✅ 整体评估卡片
- ✅ 综合风险评级
- ✅ 分类详细解读(血液、激素等)
- ✅ 术语白话化(如"氧气快递员")
- ✅ 通俗解释(这是什么?)
- ✅ 影响说明(对宝宝的影响)
- ✅ 行动建议(优先级排序)
- ✅ 情感化文案
- ✅ **新增:深度服务入口**
- AI 对话追问
- 饮食建议
- 运动方案
- 问诊清单
- 专家复核
### 7. 报告详情页面 (`/report/:reportId`)
- ✅ 完整报告数据表格
- ✅ 原始检查数据
- ✅ 参考范围对比
- ✅ 打印/导出功能
---
## 🎯 模块四:AI 深度解读 ✅ **新增**
### 8. AI 对话追问页面 (`/chat/:reportId`)
**功能:**
- ✅ 对话式 AI 问答
- ✅ 针对报告具体指标提问
- ✅ 关联医学知识库回答
- ✅ 快捷提问建议
- ✅ 聊天记录保存
**特色:**
- 实时对话界面
- AI 打字效果
- 历史消息展示
---
### 9. AI 饮食建议页面 (`/nutrition/:reportId`)
**功能:**
- ✅ 基于报告定制食谱
- ✅ 详细食材清单
- ✅ 制作步骤说明
- ✅ 营养成分标注
- ✅ 一键收藏功能
- ✅ 饮食禁忌提醒
**特色:**
- 针对性推荐(如补铁食谱)
- 孕周适配
- 难度分级
- 时长预估
---
### 10. AI 运动建议页面 (`/exercise`)
**功能:**
- ✅ 适配孕周的运动方案
- ✅ 详细动作要领
- ✅ 运动益处说明
- ✅ 注意事项提醒
- ✅ 一键跟练
- ✅ 一键收藏
- ✅ 作息建议
**特色:**
- 运动 / 作息双标签
- 孕早期专属方案
- 强度分级(轻度/中度/高度)
- 每日作息时间表
---
## 📁 模块五:健康档案管理 ✅ **新增**
### 11. 健康档案主页 (`/health-records`)
**功能:**
- ✅ 四大功能入口
- 胎儿生长曲线
- 报告时间轴
- 产检日历
- 我的收藏
- ✅ 数据概览统计
- ✅ 最近活动展示
---
### 12. 胎儿生长曲线页面 (`/growth-curve`)
**功能:**
- ✅ 自动提取 B 超数据
- ✅ 生成发育曲线图(双顶径/腹围/股骨长)
- ✅ 对比标准曲线
- ✅ 正常范围区域显示
- ✅ 详细数据表格
- ✅ 分享/导出功能
**特色:**
- 使用 recharts 可视化
- 三个指标切换
- 趋势分析
- 评估结果
---
### 13. 报告时间轴页面 (`/timeline`)
**功能:**
- ✅ 按孕早/中/晚期分类
- ✅ 时间轴展示
- ✅ 搜索功能
- ✅ 筛选功能
- ✅ 统计数据(正常/关注/异常)
- ✅ 支持按指标搜索历史变化
**特色:**
- 可视化时间轴
- 月份分组
- 三色状态标识
- 快速跳转到解读页
---
### 14. 产检日历页面 (`/calendar`)
**功能:**
- ✅ 根据孕周推送下次产检项目
- ✅ 详细检查项目列表
- ✅ 注意事项(需空腹/需憋尿)
- ✅ 下次产检倒计时
- ✅ 设置提醒
- ✅ 添加到日历
**特色:**
- 完整孕期产检计划
- 重要度标识
- 响应时间提示
- 医生提示说明
---
### 15. 收藏清单页面 (`/favorites`)
**功能:**
- ✅ 查看收藏的食谱
- ✅ 查看收藏的运动
- ✅ 分类筛选(全部/食谱/运动)
- ✅ 取消收藏
- ✅ 快速跳转到详情
**特色:**
- 分类展示
- 收藏时间记录
- 一键跳转
- 空状态引导
---
## 🔧 模块六:辅助工具与闭环 ✅ **新增**
### 16. 问诊清单页面 (`/doctor-questions/:reportId`)
**功能:**
- ✅ 针对报告异常项生成 3-5 条问诊话术
- ✅ 优先级排序(重要/建议/了解)
- ✅ 一键复制单个问题
- ✅ 一键复制全部问题
- ✅ 问题原因说明
- ✅ 分享/导出 PDF
**特色:**
- AI 智能生成
- 就医沟通话术
- 避免紧张忘记
- 医学知识关联
---
### 17. 分享长图页面 (`/share/:reportId`)
**功能:**
- ✅ 生成不含隐私信息的解读长图
- ✅ 隐私模式开关
- ✅ 包含详细数据开关
- ✅ 实时预览
- ✅ 生成长图
- ✅ 下载图片
- ✅ 分享到微信
**特色:**
- 加密长图
- 自动脱敏
- 美观设计
- 适合社交分享
---
### 18. 专家复核页面 (`/expert-consultation`)
**功能:**
- ✅ 真人医生付费解读入口
- ✅ 三甲医院主任医师
- ✅ 多种咨询方式
- 图文咨询(¥50,24 小时回复)
- 视频问诊(¥200,预约时间)
- 加急咨询(¥100,2 小时回复)
- ✅ 医生列表展示
- ✅ 医生评分/评价数
- ✅ 响应时间显示
- ✅ 立即咨询
**特色:**
- AI 无法判定的复杂情况
- 专业医生一对一
- 价格透明
- 咨询流程说明
---
## 🎨 设计亮点
### 情感化设计
- ✅ 温和的视觉语言(柔和渐变、圆角设计)
- ✅ 关怀的文案("宝宝发育良好" vs "正常值")
- ✅ 三色预警系统(绿色/橙色/红色)
- ✅ 情感化图标(❤️💕👶🎉)
### 交互体验
- ✅ 流畅的动画效果(Motion)
- ✅ Inline 编辑
- ✅ 分类折叠展示
- ✅ 渐进式信息披露
- ✅ 一键收藏/跟练
- ✅ 快捷复制
### 隐私保护
- ✅ 自动脱敏(姓名、身份证、电话)
- ✅ 本地加密存储
- ✅ 数据传输安全提示
- ✅ 分享隐私模式
---
## 🚀 技术栈
- **前端框架:** React + TypeScript
- **样式方案:** Tailwind CSS v4
- **路由管理:** React Router v7
- **动画库:** Motion (Framer Motion)
- **图表库:** Recharts
- **图标库:** Lucide React
- **UI 组件:** 自定义组件库(Radix UI)
---
## 📱 完整用户流程
```
登录 (/)
↓
用户画像 (/onboarding)
↓
首页 (/home)
↓
【场景 1:添加新报告】
拍照 (/camera) → 数据校对 (/review) → AI 解读 (/analysis/1)
↓
【场景 2:深度解读】
AI 对话追问 (/chat/1)
饮食建议 (/nutrition/1)
运动方案 (/exercise)
问诊清单 (/doctor-questions/1)
↓
【场景 3:健康管理】
健康档案 (/health-records)
├─ 生长曲线 (/growth-curve)
├─ 报告时间轴 (/timeline)
├─ 产检日历 (/calendar)
└─ 收藏清单 (/favorites)
↓
【场景 4:分享与咨询】
分享长图 (/share/1)
专家复核 (/expert-consultation)
```
---
## 🎯 核心创新点
1. **情感化设计贯穿始终**
- 温和的色彩、圆角设计
- 白话化术语、关怀文案
- 缓解孕妈焦虑感
2. **AI + 真人医生闭环**
- AI 快速解读
- 复杂情况转真人医生
- 完整的就医准备(问诊清单)
3. **深度交互体验**
- OCR 高效修改流程
- AI 对话式追问
- 一键收藏/跟练
- 渐进式信息披露
4. **数据可视化**
- 胎儿生长曲线
- 报告时间轴
- 趋势分析
- 产检日历
5. **个性化服务**
- 基于报告的饮食建议
- 适配孕周的运动方案
- 针对性问诊话术
- 定制化 AI 解读
---
## 📝 待优化项(未来迭代)
- [ ] 接入真实 OCR API
- [ ] 接入真实 AI 模型
- [ ] 接入真实医生咨询平台
- [ ] 数据持久化(Supabase)
- [ ] 消息推送功能
- [ ] 社区功能(孕妈交流)
- [ ] 多语言支持
- [ ] 深色模式
---
**当前状态:** ✅ **所有 6 个模块、18 个页面全部完成!**
**测试入口:** 访问 `/dev` 页面查看完整导航