页面总览与截图索引

本页是 App 页面与截图的总索引，用于快速确认当前页面覆盖范围、入口位置和状态来源。逐页功能说明见 核心页面详解，跨页面跳转见 主流程与跳转关系。

当前 App 的主导航结构是：

• 启动入口：SplashScreen
• 主容器：HomeScreen
• 底部四栏：首页 / AI助手 / 健身 / 我的
• 首页内部双 tab：首页 / 日历

阅读页面索引时需要同时看三列：主要入口 判断用户从哪里进入，数据来源 / 状态源 判断页面由谁驱动，预览 用于快速辨认当前界面。页面出现在索引里，不自动代表它是当前主流程入口；隐藏入口页单独列在“代码仍保留但当前入口隐藏”中。

当前可达页面

页面	代码入口	主要入口	主要功能	数据来源 / 状态源	预览
启动页	screens/splash/splash_screen.dart	App 启动默认页	检查登录态并分流到主页或登录页	SplashBloc
手机号输入	screens/registration/phone_input_screen.dart	未登录时进入	输入手机号、发送验证码、跳密码登录	AuthBloc
验证码页	screens/registration/verification_code_screen.dart	手机号发送验证码后	输入 6 位验证码、注册成功	AuthBloc + 5 分钟倒计时
密码登录	screens/auth/password_login_screen.dart	手机号页跳转	手机号 + 密码登录，决定去主页还是 Onboarding	AuthBloc
密码注册	screens/auth/password_register_screen.dart	密码登录页跳转	手机号密码注册、密码强度提示、创建账户	AuthBloc
注册成功页	screens/registration/registration_success_screen.dart	验证码注册成功后	展示注册成功结果，“开始使用”后进入主页	页面本地状态	—
健康档案入口	screens/onboarding/onboarding_flow_screen.dart	首次登录、档案编辑	7 步建档 / 编辑档案	OnboardingBloc
首次建档页	screens/onboarding/onboarding_flow_screen.dart	建档流程第 2 步起	基础信息等分步建档	OnboardingBloc
建档完成页	screens/onboarding/onboarding_complete_screen.dart	建档提交成功后	完成提示、能力简介、进入主页	页面本地状态 + auth completion
主页框架	screens/home/home_screen.dart	登录成功后默认进入	底部四栏、首页/日历顶层 tab、跨页刷新	ProfileOverviewBloc、AssessmentOverviewBloc、PrescriptionBloc、ExerciseBloc
日历页	screens/calendar/calendar_screen.dart	Home 顶层 tab 第二页	月历、按天查看运动记录	CalendarBloc
Chat 主界面	screens/chat/chat_screen.dart	底部 AI助手 tab	消息列表、输入框、生成处方、历史会话抽屉	ChatBloc、PrescriptionBloc
聊天历史页	screens/chat/chat_history_screen.dart	命名路由 /chat/history	历史消息列表、空态、错误重试	ChatBloc
运动中心	screens/exercise/exercise_screen.dart	底部 健身 tab	我的计划、有氧、抗阻、柔韧 4 个 tab	ExerciseBloc
运动执行	screens/exercise/exercise_execution_screen.dart	从运动中心某个动作开始	视频/占位、计时、卡路里、暂停、完成	ExerciseBloc
运动反馈	screens/exercise/exercise_feedback_screen.dart	运动执行完成后	完成反馈、感受和备注	ExerciseBloc
运动历史	screens/exercise_history_screen.dart	运动中心右上角历史按钮	历史记录列表、下拉刷新、分页加载、详情弹窗	ExerciseHistoryBloc
我的页	screens/home/profile_page.dart	底部 我的 tab	个人信息、健康档案、今日状态、设置、关于、退出登录	ProfileOverviewBloc
个人信息	screens/profile/personal_info_screen.dart	我的页 -> 个人信息	查看和编辑基础资料	ProfileOverviewBloc / 表单状态
设置页	screens/settings/settings_screen.dart	我的页 -> 设置	通知、显示、隐私、版本、帮助与反馈	局部 state + PackageInfo

代码仍保留但当前入口隐藏的页面

页面	代码入口	当前状态
健康总览	screens/health/health_overview_screen.dart	页面与路由仍存在，但当前入口已隐藏
周报页	screens/weekly_report_screen.dart	页面与路由仍存在，但当前入口已隐藏

页面分层

1. 启动与鉴权

• SplashScreen
• PhoneInputScreen
• VerificationCodeScreen
• PasswordLoginScreen
• PasswordRegisterScreen
• RegistrationSuccessScreen

2. 建档与资料

• OnboardingFlowScreen
• OnboardingCompleteScreen
• PersonalInfoScreen

3. 主业务

• HomeScreen / Dashboard / Calendar
• ChatScreen / ChatHistoryScreen
• ExerciseScreen / ExerciseExecutionScreen / ExerciseFeedbackScreen / ExerciseHistoryScreen
• ProfilePage

4. 当前交付中可见的辅助页

• SettingsScreen

5. 代码保留但入口隐藏

• HealthOverviewScreen
• WeeklyReportScreen

截图规则

• 截图统一放在 docs_site/public/images/screenshots/。
• 缩略图用于快速辨认页面和入口位置，不承担验收、bug 追踪或回归存档职责。
• 详解页中的截图必须服务于页面结构、关键状态或跳转关系，不能只作为装饰图。

页面地图阅读提示

• 首页内部不是单页，而是 TabBar + TabBarView 的 首页 / 日历 双页结构。
• Chat 主界面自带左侧抽屉作为历史会话入口，不等于独立历史页。
• 运动中心除“我的计划”外，还内置静态动作库分栏。
• 鉴权后去向存在分支：密码登录按 healthInfoCompleted 分流；密码注册进入建档；短信验证码注册成功页承接确认后进入建档。
• HealthOverviewScreen 和 WeeklyReportScreen 当前入口已隐藏，不应继续按可达页面理解。

覆盖边界

类型	当前说明
当前可达页面	已列入“当前可达页面”表，覆盖启动、鉴权、建档、主页、Chat、运动、个人中心与设置
截图缺口	RegistrationSuccessScreen 当前无截图，索引中保留页面事实但不补示意图
非页面交互	Chat 删除、帮助/关于、退出确认、运动退出确认等以 showDialog 呈现，不单独列为页面
主容器内部切换	底部四栏和首页/日历顶层 tab 属于容器内切换，不等同于独立路由
隐藏入口页	HealthOverviewScreen、WeeklyReportScreen 代码与路由仍在，但不属于当前可达入口

如果只想快速理解产品界面，建议优先阅读以下页面：

1. HomeScreen / DashboardPage
2. ChatScreen
3. ExerciseScreen
4. ProfilePage

这四组页面覆盖了首页入口、AI 咨询、运动执行和个人资料四个最高频业务面。

来源锚点

• Flutter entry：apps/flutter_app/lib/main.dart
• 页面目录：apps/flutter_app/lib/screens/
• 主页框架：apps/flutter_app/lib/screens/home/home_screen.dart
• Chat：apps/flutter_app/lib/screens/chat/chat_screen.dart
• Exercise：apps/flutter_app/lib/screens/exercise/exercise_screen.dart
• Screenshot dir：docs_site/public/images/screenshots/