banxiang/CODE-MAP.md

CODE MAP（Flutter 项目）

1) 目录树（文件级，聚焦 lib/）

banxiang_app/
├── README.md
├── analysis_options.yaml
├── pubspec.yaml
├── pubspec.lock
├── lib/
│   ├── main.dart
│   ├── main.dart.bak
│   ├── theme.dart
│   ├── models/
│   │   ├── activity.dart
│   │   ├── hospital.dart
│   │   ├── message.dart
│   │   └── user.dart
│   ├── screens/
│   │   ├── activity_detail_screen.dart
│   │   ├── activity_list_screen.dart
│   │   ├── ai_chat_screen.dart
│   │   ├── booking_screen.dart
│   │   ├── create_activity_screen.dart
│   │   ├── department_screen.dart
│   │   ├── doctor_list_screen.dart
│   │   ├── home_screen.dart
│   │   ├── hospital_list_screen.dart
│   │   ├── login_screen.dart
│   │   ├── main_screen.dart
│   │   ├── medical_screen.dart
│   │   ├── messages_screen.dart
│   │   ├── order_list_screen.dart
│   │   ├── payment_screen.dart
│   │   ├── profile_screen.dart
│   │   ├── profile_setup_screen.dart
│   │   ├── publish_screen.dart
│   │   └── services_screen.dart
│   ├── services/
│   │   ├── activity_service.dart
│   │   ├── ai_service.dart
│   │   ├── auth_service.dart
│   │   └── medical_service.dart
│   └── utils/
│       └── constants.dart
├── test/
│   └── widget_test.dart
├── android/...
├── ios/...
├── web/...
├── linux/...
├── macos/...
└── windows/...

2) Dart 文件一行说明

文件	说明
lib/main.dart	应用入口，读取本地 token 后决定进入登录页或活动广场页。
lib/theme.dart	定义全局浅色主题 AppTheme.lightTheme（色彩、按钮、输入框、导航栏等）。
lib/models/activity.dart	活动实体模型，承载标题、分类、时间、地点、人数等基础字段。
lib/models/hospital.dart	医疗相关实体定义，包含 Hospital、Doctor、Appointment 三类模型。
lib/models/message.dart	聊天消息模型，包含文本、发送方与消息时间。
lib/models/user.dart	用户资料模型，包含手机号、昵称、性别、兴趣等信息。
lib/screens/activity_detail_screen.dart	活动详情页，含图片轮播、评论区、点赞与报名底栏。
lib/screens/activity_list_screen.dart	活动广场页，瀑布流展示活动卡片并提供底部导航和发布入口。
lib/screens/ai_chat_screen.dart	AI 聊天页，支持快捷提问、消息渲染和自动滚动到底部。
lib/screens/booking_screen.dart	预约挂号下单页，收集就诊信息并创建 Appointment 后跳转支付。
lib/screens/create_activity_screen.dart	发起活动表单页，填写后写入 ActivityService。
lib/screens/department_screen.dart	医院科室选择页，点击科室进入医生列表。
lib/screens/doctor_list_screen.dart	医生列表页，按科室读取医生并进入预约页。
lib/screens/home_screen.dart	另一版首页实现（分类筛选 + 活动列表 + 发起活动入口）。
lib/screens/hospital_list_screen.dart	医院列表页，展示医院与科室标签并进入科室选择。
lib/screens/login_screen.dart	手机验证码模拟登录页，登录后按是否新用户分流到资料完善或活动页。
lib/screens/main_screen.dart	底部 Tab 主容器，聚合首页/服务/AI/消息/我的五个页面。
lib/screens/medical_screen.dart	医疗健康服务聚合页，含医院、科室、医生弹层和在线问诊弹窗。
lib/screens/messages_screen.dart	消息通知页，展示活动/支付/问诊等系统通知卡片。
lib/screens/order_list_screen.dart	订单列表页，展示挂号订单并支持取消或去支付。
lib/screens/payment_screen.dart	支付确认页，模拟支付流程并更新预约状态。
lib/screens/profile_screen.dart	个人资料编辑页，读取并保存昵称、城市和兴趣到本地。
lib/screens/profile_setup_screen.dart	新用户三步资料完善流程，最终调用 AuthService.updateProfile。
lib/screens/publish_screen.dart	发布页，支持图片/视频二选一上传、预览删除与发布校验。
lib/screens/services_screen.dart	生活服务总入口页，提供医疗健康分类与快捷入口。
lib/services/activity_service.dart	活动 mock 数据服务，提供活动分类、查询和新增。
lib/services/ai_service.dart	AI 回复 mock 服务，基于关键词规则返回双消息（用户+助手）。
lib/services/auth_service.dart	认证与用户资料服务，管理登录态、验证码、登录、资料更新和退出。
lib/services/medical_service.dart	医疗 mock 数据服务，提供医院/医生数据与预约列表维护。
lib/utils/constants.dart	应用常量定义（应用名、口号、活动分类、兴趣标签等）。

3) Core Methods Index

格式：filename | method_name | one-line description

filename	method_name	one-line description
lib/main.dart	main	初始化 Flutter 与 SharedPreferences，根据 token 决定首屏。
lib/main.dart	BanxiangApp.build	构建 MaterialApp 并设置主题与首页路由。
lib/screens/activity_list_screen.dart	_onItemTapped	处理底部导航点击，中间按钮进入发布页。
lib/screens/activity_list_screen.dart	_buildBody	构建支持下拉刷新的瀑布流活动列表。
lib/screens/activity_list_screen.dart	_buildActivityCard	渲染单个活动卡片并点击跳转详情页。
lib/screens/activity_list_screen.dart	_buildBottomNavigationBar	绘制自定义底部导航容器。
lib/screens/activity_list_screen.dart	_buildNavItem	构建导航项并处理选中态样式。
lib/screens/activity_list_screen.dart	_buildFloatingActionButton	构建中心悬浮发布按钮。
lib/screens/activity_detail_screen.dart	initState	根据活动报名人数初始化点赞数。
lib/screens/activity_detail_screen.dart	_toggleLike	切换点赞状态并同步点赞计数。
lib/screens/activity_detail_screen.dart	_postComment	校验并发布评论，更新评论列表与提示。
lib/screens/activity_detail_screen.dart	_buildCommentItem	构建单条评论 UI。
lib/screens/activity_detail_screen.dart	_buildBottomBar	构建评论输入、点赞和报名操作栏。
lib/screens/activity_detail_screen.dart	dispose	释放评论输入框控制器。
lib/screens/publish_screen.dart	_pickImages	从相册多选图片并限制最多 9 张。
lib/screens/publish_screen.dart	_pickVideo	从相册选择视频并与图片互斥。
lib/screens/publish_screen.dart	_removeImage	删除指定下标图片。
lib/screens/publish_screen.dart	_removeVideo	清空已选视频并重置模式。
lib/screens/publish_screen.dart	_publish	校验标题和媒体后执行发布成功提示。
lib/screens/publish_screen.dart	_buildMediaGrid	根据图片/视频状态渲染媒体区与添加按钮。
lib/screens/publish_screen.dart	_buildAddButton	打开底部弹窗选择图片或视频。
lib/screens/login_screen.dart	_sendCode	校验手机号后模拟发送验证码。
lib/screens/login_screen.dart	_login	校验验证码并写入本地 token 后完成登录分流。
lib/screens/profile_setup_screen.dart	_nextStep	驱动资料完善流程页切换或触发完成。
lib/screens/profile_setup_screen.dart	_finishSetup	提交资料到 AuthService 并跳转活动页。
lib/screens/profile_setup_screen.dart	_genderButton	构建性别选择按钮并维护选中态。
lib/screens/profile_screen.dart	_loadProfile	从本地读取昵称/城市/兴趣并回填表单。
lib/screens/profile_screen.dart	_save	保存个人资料到本地并给出反馈。
lib/screens/services_screen.dart	_serviceCard	渲染服务分类卡片并处理可用/未开放逻辑。
lib/screens/services_screen.dart	_quickAccess	构建服务快捷入口卡片。
lib/screens/medical_screen.dart	_hospitalCard	构建医院信息卡片。
lib/screens/medical_screen.dart	_showDoctors	弹出底部抽屉展示指定科室医生列表。
lib/screens/medical_screen.dart	_doctorTile	渲染医生卡片与可预约时段。
lib/screens/medical_screen.dart	_showConsultationDialog	展示在线问诊输入与提交确认弹窗。
lib/screens/doctor_list_screen.dart	build	按科室读取医生并跳转预约页面。
lib/screens/booking_screen.dart	_submit	创建预约订单并写入 MedicalService，随后跳转支付。
lib/screens/payment_screen.dart	_pay	模拟支付、更新订单状态并展示成功弹窗。
lib/screens/order_list_screen.dart	_buildStatusChip	按订单状态渲染不同颜色状态标签。
lib/screens/order_list_screen.dart	_buildInfoRow	构建订单信息行（图标 + 文本）。
lib/screens/ai_chat_screen.dart	_sendMessage	发送用户消息并调用 AIService.mockChat 追加回复。
lib/screens/ai_chat_screen.dart	_buildQuickButton	构建快捷提问按钮并直接触发发送。
lib/screens/ai_chat_screen.dart	_buildMessageBubble	按角色渲染左右对齐聊天气泡。
lib/screens/create_activity_screen.dart	_submit	组装 Activity 并调用服务新增活动。
lib/screens/home_screen.dart	_loadActivities	加载活动列表并关闭 loading 状态。
lib/screens/home_screen.dart	_ActivityCard._categoryEmoji	将活动分类映射为表情符号。
lib/services/activity_service.dart	getActivities	按分类过滤并返回活动列表。
lib/services/activity_service.dart	addActivity	向活动 mock 列表新增一条活动。
lib/services/ai_service.dart	mockChat	根据关键词生成助手回复并返回消息对。
lib/services/auth_service.dart	checkLoginStatus	读取本地 token 并恢复当前登录用户。
lib/services/auth_service.dart	sendCode	模拟验证码发送接口。
lib/services/auth_service.dart	login	模拟登录并持久化 token/手机号。
lib/services/auth_service.dart	updateProfile	更新并缓存当前用户资料。
lib/services/auth_service.dart	logout	清理本地登录信息并退出。
lib/services/medical_service.dart	getDoctorsByDepartment	按科室筛选医生。
lib/services/medical_service.dart	addAppointment	将预约单加入内存订单列表。
lib/theme.dart	AppTheme.lightTheme	返回全局浅色主题配置。

4) 数据模型汇总

格式：model name | fields | brief purpose

model name	fields	brief purpose
Activity	id, title, category, time, location, maxParticipants, currentParticipants, creatorName, description	社区活动核心实体，描述活动基础信息与报名进度。
Hospital	id, name, address, departments	医院实体，提供医院基础信息及可选科室。
Doctor	id, name, department, title, fee	医生实体，供科室医生列表与预约流程使用。
Appointment	id, hospitalName, doctorName, department, time, status, fee	预约订单实体，承载挂号到支付阶段的状态流转。
Message	text, isUser, time	聊天消息实体，用于 AI 对话列表渲染。
User	id, phone, nickname, avatar, birthYear, gender, city, interests	用户画像实体，支持登录态与资料完善/编辑。