产品与能力总览

乐橙智康的核心产品，是一套围绕肿瘤患者与慢病人群运动康复场景构建的 App、backend 与 AI/RAG 系统。对外品牌表达使用“乐橙智康 / 动养AI”，对内工程与仓库仍保留 FitDoc 代码名。

这份总览优先回答四个交接问题：产品当前服务什么场景、用户主闭环如何形成、哪些能力已经在当前入口中可达、哪些能力只是代码保留或仍需继续核对。

产品结构

能力域	当前形态	App 承载位置	对应工程文档
鉴权与注册	手机号验证码注册、密码登录、注册成功后进入建档或主页分流	`Splash`、`PhoneInput`、`VerificationCode`、`PasswordLogin`	`/app-pages/`、`/frontend/route-map`、`/api/auth`
健康档案	7 步 Onboarding，支持首次建档与编辑模式复用	`OnboardingFlow`、`PersonalInfo`、`Profile`	`/app-pages/core-pages`、`/api/user`、`/database/`
首页与概览	首页/日历双顶层 tab，首页展示档案摘要、评估摘要、处方卡片与康复知识卡	`HomeScreen`、`DashboardPage`、`CalendarScreen`	`/app-pages/main-flow`、`/frontend/state-management`
AI 咨询	Chat 会话、历史会话抽屉、处方生成入口	`ChatScreen`、`ChatHistory`	`/app-pages/core-pages`、`/ai-rag/`、`/api/chat`
运动处方与执行	当前处方、静态动作库、运动执行、反馈、运动历史	`ExerciseScreen`、`ExerciseExecution`、`ExerciseHistory`	`/app-pages/core-pages`、`/api/prescription`、`/api/sport`
个人中心	资料查看、健康档案编辑、今日状态、设置、关于、退出登录	`ProfilePage`、`SettingsScreen`	`/app-pages/core-pages`、`/frontend/`
代码保留但入口隐藏	健康总览、周报	`HealthOverviewScreen`、`WeeklyReportScreen`	`/frontend/route-map`

用户主闭环

mermaid

flowchart LR
  Access["启动与准入\nSplash / Auth"] --> Profile["健康档案\nOnboarding"]
  Profile --> Home["主页\nHomeScreen"]
  Home --> Chat["AI 咨询\nChat"]
  Chat --> Exercise["运动处方与执行\nExercise"]
  Exercise --> History["反馈与历史\nHistory"]

当前产品边界

边界	当前事实	交接含义
主入口	`MaterialApp.home` 指向 `SplashScreen`，启动页按登录态分流	当前产品首先按移动端 App 理解，页面、状态和导航都以 Flutter 为中心
准入链路	密码登录按 `healthInfoCompleted` 分流；密码注册进入建档；短信验证码注册成功页承接确认后进入建档	注册/登录不是单一路径，改鉴权或建档时必须分别核对三条分支
主业务闭环	建档 -> 首页摘要 -> Chat / 处方 -> 运动中心 -> 执行反馈 / 历史	当前最稳定的产品叙事是“AI 建议落到运动执行记录”，不是单纯聊天工具
数据接入	处方、对话、运动日志等已有后端链路；首页部分展示和运动动作库仍有静态 / mock 内容	页面可见不等于数据已完全动态化，联调时需要逐项核对数据来源
保留能力	`HealthOverviewScreen`、`WeeklyReportScreen` 代码与路由仍存在，但当前入口隐藏	文档和验收不能把它们写成当前主入口，也不能据此倒推用户路径

接手优先级

优先级	能力	需要先理解的原因	推荐深读
1	登录与建档	决定用户能否进入主业务闭环，也决定 profile 是否足以支撑处方与评估	主流程与跳转关系
2	首页与评估摘要	决定用户每天从哪里开始动作，以及处方、评估、日历如何被组织到主容器	核心页面详解
3	Chat 与处方	决定 AI 建议如何进入运动康复场景，以及后端 RAG / LLM 如何进入业务结果	后端核心链路
4	运动执行与历史	决定建议是否落到行为记录、反馈和后续回看	页面状态与交互规范

这四组能力分别对应准入、入口、智能建议和行为落地。读者先抓住这条链，再进入 API、数据库或 RAG reference，会更容易判断每个模块在产品中的位置。

阅读入口

想了解什么	推荐入口
先看用户在 App 中怎么走	页面总览与截图索引
看主流程和跳转关系	主流程与跳转关系
看每个核心页面做什么	核心页面详解
看页面状态和交互边界	页面状态与交互规范
看视觉风格和 theme 基线	视觉风格与组件规范
看 Flutter 工程如何组织	App 前端工程
看后端与 AI/RAG 如何支撑	后端服务 / AI / RAG / LLM

来源锚点

Flutter entry：apps/flutter_app/lib/main.dart
主页与底部导航：apps/flutter_app/lib/screens/home/home_screen.dart
Chat：apps/flutter_app/lib/screens/chat/chat_screen.dart
运动中心：apps/flutter_app/lib/screens/exercise/exercise_screen.dart
健康档案：apps/flutter_app/lib/screens/onboarding/onboarding_flow_screen.dart
官网表达：home.html

产品与能力总览 ​

产品结构 ​

用户主闭环 ​

当前产品边界 ​

接手优先级 ​

阅读入口 ​