# Android 与 Web 端功能对齐计划

## 一、功能差异分析

### Web 端功能清单（60+ 页面）

| 模块 | 页面 | 路由 | 核心功能 |
|------|------|------|----------|
| **首页** | Home | `/` | Hero区域、快捷入口、最新更新日志、热门API、精选文章、学习路径、实用工具 |
| **学习** | Learn | `/learn` | 课程分类筛选、难度筛选、排序、收藏、分页 |
| | CourseLearn | `/course-learn` | 课程详情学习页 |
| **工具集** | Utility | `/utility` | 工具分类、搜索、排序、收藏、使用次数统计 |
| | JsonFormatter | `/utility/json-formatter` | JSON格式化 |
| | Base64Tool | `/utility/base64` | Base64编解码 |
| | TimestampTool | `/utility/timestamp` | 时间戳转换 |
| | RegexTool | `/utility/regex` | 正则表达式测试 |
| | TextDiff | `/utility/text-diff` | 文本对比 |
| | EncodingConverter | `/utility/encoding-converter` | 编码转换 |
| | CharsetConverter | `/utility/charset-converter` | 字符集转换 |
| | ColorConverter | `/utility/color-converter` | 颜色转换 |
| | CodeFormatter | `/utility/code-formatter` | 代码格式化 |
| | QRCodeGenerator | `/qrcode-generator` | 二维码生成 |
| | ImageCompressor | `/utility/image-compressor` | 图片压缩 |
| | Calculator | `/utility/calculator` | 计算器 |
| | DateCalculator | `/utility/date-calculator` | 日期计算 |
| | ImageEditor | `/utility/image-editor` | 图片编辑 |
| | ColorPicker | `/color-picker` | 颜色选择器 |
| **API** | ApiDirectory | `/api` | API目录展示 |
| | ApiDetail | `/api-detail/:id` | API详情 |
| | ApiDocs | `/api-docs` | API文档 |
| | ToolDetail | `/tool-detail` | 工具详情 |
| **文章** | Articles | `/articles` | 文章列表 |
| | ArticleDetail | `/article/:id` | 文章详情 |
| | ArticleManage | `/article-manage` | 文章管理 |
| | ArticleEditor | `/article-editor` | 文章编辑 |
| **消息** | Messages | `/messages` | 回复、@我、点赞、系统通知 |
| | SystemMessage | `/system-message` | 系统消息详情 |
| | Chat | `/chat` | 即时聊天 |
| **用户** | Profile | `/profile` | 个人资料 |
| | ProfileEmail | `/profile/email` | 邮箱设置 |
| | ProfilePhone | `/profile/phone` | 手机号设置 |
| | ProfileChangePassword | `/profile/change-password` | 修改密码 |
| | UserHome | `/user/:id` | 用户主页 |
| | Settings | `/settings` | 系统设置 |
| | History | `/history` | 历史记录 |
| | Favorites | `/favorites` | 收藏列表 |
| | Search | `/search` | 全局搜索 |
| **钱包** | Points | `/wallet/points` | 积分 |
| | Coins | `/wallet/coins` | 金币 |
| | Recharge | `/wallet/coins/recharge` | 充值 |
| | Invite | `/wallet/invite` | 邀请 |
| **任务** | TaskCenter | `/task-center` | 任务中心 |
| **反馈** | Bug | `/bug` | Bug反馈 |
| | BugDetail | `/bug-detail` | Bug详情 |
| **其他** | Changelog | `/changelog` | 更新日志 |
| | IPLocation | `/ip-location` | IP定位 |
| | CurrencyDetail | `/currency-detail` | 货币详情 |
| | AQIDetails | `/api/air-quality-details` | 空气质量详情 |
| | WeatherDetail | `/api/weather-details` | 天气详情 |
| | ShortUrlDetail | `/shorturl-detail` | 短链接详情 |
| | Manual | `/manual` | 使用手册 |
| | Privacy | `/privacy` | 隐私政策 |
| | UserAgreement | `/agreement` | 用户协议 |
| | ForgotPassword | `/forgot-password` | 忘记密码 |
| | InviteRedirect | `/invite/:code` | 邀请重定向 |
| | Console | `/console` | 控制台 |

### Android 端现有功能（9 个屏幕）

| 页面 | 文件 | 状态 |
|------|------|------|
| 首页 | HomeScreen.kt | ⚠️ 仅有工具分类网格，缺少Hero、快捷入口、文章、学习路径等 |
| 课程列表 | CourseListScreen.kt | ⚠️ 基础列表，缺少分类筛选、排序、收藏 |
| 课程详情 | CourseDetailScreen.kt | ⚠️ 基础详情，缺少进度、收藏 |
| 章节阅读 | ChapterReaderScreen.kt | ✅ 基础功能完整 |
| 登录 | LoginScreen.kt | ✅ 完整 |
| 确认登录 | ConfirmLoginScreen.kt | ✅ 完整 |
| 扫码登录 | ScanLoginScreen.kt | ✅ 完整 |
| 个人资料 | ProfileScreen.kt | ⚠️ 基础信息，缺少邮箱/手机/密码设置入口 |
| 设置 | SettingsScreen.kt | ⚠️ 基础设置，功能较少 |
| 课程管理 | CourseManageScreen.kt | ⚠️ 占位页面 |

---

## 二、功能对齐计划

### P0: 核心框架与基础功能（优先级最高）

#### 1. 完善首页（HomeScreen）
- [ ] 添加 Hero 区域（标题、副标题）
- [ ] 添加快捷入口（学习、工具、文章、API）
- [ ] 添加热门工具展示
- [ ] 添加入口导航功能
- [ ] 添加搜索功能跳转

#### 2. 完善个人资料（ProfileScreen）
- [ ] 添加邮箱设置入口
- [ ] 添加手机号设置入口
- [ ] 添加修改密码入口
- [ ] 添加用户等级/积分展示

#### 3. 新增消息中心
- [ ] 创建 MessagesScreen（回复、@我、点赞、系统通知）
- [ ] 创建 SystemMessageScreen
- [ ] 添加未读消息计数
- [ ] 添加消息已读/未读功能

#### 4. 新增搜索功能
- [ ] 创建 SearchScreen
- [ ] 添加工具、课程、文章搜索
- [ ] 添加搜索历史

#### 5. 新增收藏功能
- [ ] 创建 FavoritesScreen
- [ ] 添加工具收藏、课程收藏、文章收藏
- [ ] 添加收藏取消功能

#### 6. 新增历史记录
- [ ] 创建 HistoryScreen
- [ ] 添加浏览历史记录
- [ ] 添加历史清除功能

### P1: 内容模块

#### 1. 文章系统
- [ ] 创建 ArticlesScreen（文章列表）
- [ ] 创建 ArticleDetailScreen（文章详情）
- [ ] 添加文章分类筛选
- [ ] 添加文章点赞/评论

#### 2. 学习系统增强
- [ ] 完善 CourseListScreen（分类筛选、排序、收藏）
- [ ] 完善 CourseDetailScreen（进度显示、收藏）
- [ ] 创建 CourseLearnScreen（课程学习页）

#### 3. 工具集
- [ ] 创建 UtilityScreen（工具列表）
- [ ] 添加工具分类筛选
- [ ] 添加工具搜索
- [ ] 添加工具收藏
- [ ] 创建常用工具详情页（计算器、JSON格式化等）

### P2: 用户系统与钱包

#### 1. 钱包系统
- [ ] 创建 WalletScreen（积分、金币总览）
- [ ] 创建 PointsScreen（积分明细）
- [ ] 创建 CoinsScreen（金币明细）
- [ ] 创建 RechargeScreen（充值）

#### 2. 任务中心
- [ ] 创建 TaskCenterScreen
- [ ] 添加每日任务
- [ ] 添加任务奖励

#### 3. Bug反馈
- [ ] 创建 BugScreen（反馈列表）
- [ ] 创建 BugDetailScreen（反馈详情）
- [ ] 添加提交反馈功能

### P3: 高级功能

#### 1. API目录
- [ ] 创建 ApiDirectoryScreen
- [ ] 创建 ApiDetailScreen
- [ ] 创建 ApiDocsScreen

#### 2. 即时聊天
- [ ] 创建 ChatScreen
- [ ] 添加消息发送/接收

#### 3. 用户主页
- [ ] 创建 UserHomeScreen
- [ ] 添加用户动态

#### 4. 其他页面
- [ ] 创建 ChangelogScreen
- [ ] 创建 ManualScreen
- [ ] 创建 PrivacyScreen
- [ ] 创建 UserAgreementScreen

---

## 三、API 接口需求

### 需要新增的 API

| API | 端点 | 用途 |
|-----|------|------|
| MessageApi | `/api/messages/` | 消息列表 |
| | `/api/messages/unread_count/` | 未读消息数 |
| | `/api/messages/mark_read/` | 标记已读 |
| | `/api/messages/delete/` | 删除消息 |
| SearchApi | `/api/search/` | 全局搜索 |
| HistoryApi | `/api/history/` | 历史记录 |
| FavoritesApi | `/api/favorites/` | 收藏列表 |
| | `/api/favorites/toggle/` | 收藏/取消收藏 |
| ArticleApi | `/api/articles/` | 文章列表 |
| | `/api/articles/{id}/` | 文章详情 |
| WalletApi | `/api/wallet/` | 钱包信息 |
| | `/api/wallet/recharge/` | 充值 |
| TaskApi | `/api/tasks/` | 任务列表 |
| | `/api/tasks/complete/` | 完成任务 |
| BugApi | `/api/bugs/` | Bug反馈 |
| UserApi | `/api/user/{id}/` | 用户主页 |

---

## 四、实施步骤

### 第一阶段：修复编译错误 + 完善基础
1. 修复现有代码编译错误
2. 完善 HomeScreen（添加Hero、快捷入口）
3. 完善 ProfileScreen（添加设置入口）
4. 更新导航结构

### 第二阶段：核心功能
1. 实现消息中心
2. 实现搜索功能
3. 实现收藏功能
4. 实现历史记录

### 第三阶段：内容模块
1. 实现文章系统
2. 完善学习系统
3. 实现工具集

### 第四阶段：扩展功能
1. 实现钱包系统
2. 实现任务中心
3. 实现Bug反馈
4. 实现其他辅助页面

---

## 五、文件结构规划

```
app/src/main/java/com/chunyu/app/
├── data/
│   ├── api/
│   │   ├── AuthApi.kt (已有)
│   │   ├── LearnApi.kt (已有)
│   │   ├── ToolApi.kt (已有)
│   │   ├── UserApi.kt (已有)
│   │   ├── MessageApi.kt (新增)
│   │   ├── SearchApi.kt (新增)
│   │   ├── HistoryApi.kt (新增)
│   │   ├── FavoritesApi.kt (新增)
│   │   ├── ArticleApi.kt (新增)
│   │   ├── WalletApi.kt (新增)
│   │   ├── TaskApi.kt (新增)
│   │   └── BugApi.kt (新增)
│   └── repository/
│       ├── AuthRepository.kt (已有)
│       ├── ToolRepository.kt (已有)
│       ├── UserRepository.kt (已有)
│       ├── MessageRepository.kt (新增)
│       ├── SearchRepository.kt (新增)
│       ├── HistoryRepository.kt (新增)
│       ├── FavoritesRepository.kt (新增)
│       ├── ArticleRepository.kt (新增)
│       ├── WalletRepository.kt (新增)
│       ├── TaskRepository.kt (新增)
│       └── BugRepository.kt (新增)
├── ui/
│   └── screens/
│       ├── home/
│       │   └── HomeScreen.kt (完善)
│       ├── learn/
│       │   ├── CourseListScreen.kt (完善)
│       │   ├── CourseDetailScreen.kt (完善)
│       │   ├── CourseLearnScreen.kt (新增)
│       │   └── ChapterReaderScreen.kt (已有)
│       ├── tools/
│       │   ├── UtilityScreen.kt (新增)
│       │   ├── CalculatorScreen.kt (新增)
│       │   ├── JsonFormatterScreen.kt (新增)
│       │   └── ... (其他工具)
│       ├── articles/
│       │   ├── ArticlesScreen.kt (新增)
│       │   └── ArticleDetailScreen.kt (新增)
│       ├── messages/
│       │   ├── MessagesScreen.kt (新增)
│       │   ├── SystemMessageScreen.kt (新增)
│       │   └── ChatScreen.kt (新增)
│       ├── profile/
│       │   ├── ProfileScreen.kt (完善)
│       │   ├── ProfileEmailScreen.kt (新增)
│       │   ├── ProfilePhoneScreen.kt (新增)
│       │   └── ProfileChangePasswordScreen.kt (新增)
│       ├── wallet/
│       │   ├── WalletScreen.kt (新增)
│       │   ├── PointsScreen.kt (新增)
│       │   ├── CoinsScreen.kt (新增)
│       │   └── RechargeScreen.kt (新增)
│       ├── search/
│       │   └── SearchScreen.kt (新增)
│       ├── history/
│       │   └── HistoryScreen.kt (新增)
│       ├── favorites/
│       │   └── FavoritesScreen.kt (新增)
│       ├── task/
│       │   └── TaskCenterScreen.kt (新增)
│       ├── bug/
│       │   ├── BugScreen.kt (新增)
│       │   └── BugDetailScreen.kt (新增)
│       ├── settings/
│       │   └── SettingsScreen.kt (完善)
│       └── other/
│           ├── ChangelogScreen.kt (新增)
│           ├── ManualScreen.kt (新增)
│           ├── PrivacyScreen.kt (新增)
│           └── UserAgreementScreen.kt (新增)
└── navigation/
    └── AppNavHost.kt (更新)
```

---

## 六、预期成果

完成本计划后，Android 端将：
1. 覆盖 Web 端 90% 以上的核心功能
2. 拥有完整的用户系统（资料、钱包、任务）
3. 拥有完整的内容系统（文章、学习、工具）
4. 拥有完整的消息系统（通知、聊天）
5. 拥有完善的历史记录和收藏功能
6. 提供良好的用户体验和界面一致性