feat: PLANNING体系首版（00路线图/02任务总表/03执行协议/I-03/I-04/registry42口径）+M1止血交付

2026-09-12 14:25:25 +08:00
commit 8242e730b4
482 changed files with 37029 additions and 0 deletions
@@ -0,0 +1,329 @@
+# 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. 提供良好的用户体验和界面一致性