# CODE MAP（Flutter 项目）

> 版本：v1.1.0+2 | 更新：2026-02-17

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

```
banxiang_app/
├── lib/
│   ├── main.dart
│   ├── 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
```

## 2) 文件说明

| 文件 | 说明 |
|---|---|
| main.dart | 应用入口，读取本地token后决定进入登录页或活动广场页 |
| theme.dart | 定义全局浅色主题 AppTheme.lightTheme |
| models/activity.dart | 活动实体模型，承载标题、分类、时间、地点、人数等基础字段 |
| models/hospital.dart | 医疗相关实体，含 Hospital、Doctor、Appointment 三类模型 |
| models/message.dart | 聊天消息模型，含文本、发送方与时间 |
| models/user.dart | 用户资料模型，含手机号、昵称、性别、兴趣等 |
| screens/activity_list_screen.dart | 活动广场页，瀑布流展示活动卡片+底部导航+发布入口 |
| screens/activity_detail_screen.dart | 活动详情页，含图片轮播、评论区、点赞与报名底栏 |
| screens/login_screen.dart | 手机验证码模拟登录页，登录后按新老用户分流 |
| screens/profile_setup_screen.dart | 新用户三步资料完善流程 |
| screens/profile_screen.dart | 个人资料编辑页 |
| screens/publish_screen.dart | 发布页，支持图片/视频上传 |
| screens/ai_chat_screen.dart | AI聊天页，支持快捷提问和消息渲染 |
| screens/services_screen.dart | 生活服务总入口页 |
| screens/medical_screen.dart | 医疗健康服务聚合页 |
| screens/messages_screen.dart | 消息通知页（空壳） |
| screens/main_screen.dart | 底部Tab主容器（旧版，已不作入口） |
| services/auth_service.dart | 认证与用户资料服务，管理登录态与资料更新 |
| services/activity_service.dart | 活动 mock 数据服务 |
| services/ai_service.dart | AI回复 mock 服务，基于关键词规则 |
| services/medical_service.dart | 医疗 mock 数据服务 |
| utils/constants.dart | 应用常量（应用名、活动分类、兴趣标签等） |

## 3) 核心方法索引

| 文件 | 方法 | 说明 |
|---|---|---|
| main.dart | main | 读取token决定首屏 |
| login_screen.dart | _login | 校验验证码+写token+登录分流 |
| profile_setup_screen.dart | _finishSetup | 提交资料跳转活动页 |
| activity_list_screen.dart | _buildBody | 构建瀑布流活动列表 |
| activity_list_screen.dart | _buildFloatingActionButton | 构建中心悬浮发布按钮 |
| activity_detail_screen.dart | _toggleLike | 切换点赞状态 |
| activity_detail_screen.dart | _postComment | 发布评论 |
| publish_screen.dart | _publish | 校验并发布 |
| publish_screen.dart | _pickImages | 多选图片（最多9张） |
| auth_service.dart | checkLoginStatus | 读取token恢复登录态 |
| auth_service.dart | updateProfile | 更新用户资料 |
| activity_service.dart | getActivities | 按分类筛选活动 |
| ai_service.dart | mockChat | 基于关键词返回AI回复 |

## 4) 数据模型汇总

| 模型 | 主要字段 | 用途 |
|---|---|---|
| Activity | id, title, category, time, location, maxParticipants, currentParticipants | 社区活动核心实体 |
| User | id, phone, nickname, avatar, birthYear, gender, city, interests | 用户画像 |
| Hospital | id, name, address, departments | 医院实体 |
| Doctor | id, name, department, title, fee | 医生实体 |
| Appointment | id, hospitalName, doctorName, time, status, fee | 预约订单 |
| Message | text, isUser, time | AI聊天消息 |