项目管理与实施计划
文档版本:2.0 最后更新:2026-04-27 维护者:Reflekt Health 产品团队 状态:正式交付稿
文档依据:
raw_requirements_context.md、functional_requirements.md、business_architecture.md、technical_architecture.md、data_model_design.md、project_brief.md、non_functional_requirements.md、user_stories.md、project_team_roster.md、meeting_notes.md、constraints_and_dependencies.md、technical_debt_and_risks.md、20260427_project_completion_status.md原型依据:
static/ui/fap/(FAP家属端)、static/ui/lsp/(LSP老人端)、static/ui/acp/(ACP运营管理端) 场景依据:static/_wiki_assets/raw_context/20260427_系统整体应用场景.md里程碑依据:docs/01_project/01_03_milestones.md
1. 协同规范约定
1.1 Git 分支管理
| 分支 | 用途 | 保护策略 |
|---|---|---|
main | 生产分支,受保护,禁止直接推送 | 至少 1 人 PR Approve + CI 通过 |
develop | 开发主干,所有 feature 分支合并至此 | 至少 1 人 PR Approve |
feature/* | 功能分支,按模块命名(如 feature/fap-auth、feature/ai-dialog) | 至少 1 人 Code Review |
hotfix/* | 生产问题修复分支 | 至少 1 人 Approve + CI 通过 |
1.2 代码提交规范(Conventional Commits)
格式:<type>(<scope>): <description>
| Type | 说明 | 示例 |
|---|---|---|
feat | 新功能 | feat(fap): add login with phone verification |
fix | Bug 修复 | fix(da): resolve MQTT reconnection timeout |
docs | 文档修改 | docs: update API spec for alert endpoint |
style | 代码格式(不影响功能) | style: format device card component |
refactor | 重构(非新功能非修复) | refactor(api): simplify notification routing |
perf | 性能优化 | perf(ai): cache GPT responses in Redis |
test | 测试相关 | test(be): add unit tests for escalation logic |
build | 构建或依赖变更 | build(deps): upgrade Spring Boot to 3.2 |
ci | CI 配置变更 | ci: add GitHub Actions matrix for multi-service |
chore | 杂项(工具、辅助工具变更) | chore: update .gitignore |
1.3 代码评审要求
- 至少 1 人 Approve(除
chore外所有提交) - 必须通过 CI 检查(编译、单元测试、lint)
- PR 描述必须包含:功能说明、关联用户故事(US-XXX)、验收标准
- 评审未通过不得合并
1.4 团队分工与责任人
| 模块 | 责任人 | 辅助 |
|---|---|---|
| D4 AI 大脑服务 | 龙 | Daniel Yin(架构评审) |
| FAP 前端(UniApp) | 子豪 | 佩宜(设计对齐) |
| LSP 前端(原生 Android) | 凯哥 | 陈增焕(辅助)、佩宜(设计对齐) |
| ACP 前端(运营管理后台) | 陈增焕 | 子豪(辅助) |
| D1 设备接入服务 | 凯哥 | 龙(MQTT 集成) |
| D2 家属端服务 | 龙 | 子豪(API 对齐) |
| D3 运营管理服务 | 龙 | 凯哥(设备联动) |
| D5 通知告警服务 | 龙 | 妙锋(端到端测试) |
| 测试 | 妙锋 | 全体(联调支持) |
| 项目管理 | 陈增焕 | Daniel Yin |
2. 系统架构概述
2.1 三大端与设备
| 端 | 设备 | 技术栈 | 屏幕尺寸 | 文件路径 |
|---|---|---|---|---|
| FAP (Family App) | 家属手机(iOS/Android) | UniApp + Vue3 + TypeScript | 390×844px (iPhone 16 Pro) | static/ui/fap/ |
| LSP (Luma Smart Speaker) | 老人智能音箱 | 原生 Android | 1280×800px | static/ui/lsp/ |
| ACP (Admin Control Panel) |