编辑“︁CHSOC Wiki 移动应用实施启动计划”︁（章节）

== 第一阶段：基础框架实施（第1-3周） ==

=== 第1周任务：项目初始化 + 核心架构 ===

==== 今日任务（2026-02-14 剩余时间） ====

'''任务1.1：创建项目仓库'''
<pre>
# 1. 创建项目根目录
mkdir CHSOCWiki-Mobile
cd CHSOCWiki-Mobile

# 2. 初始化 Git 仓库
git init
echo "# CHSOC Wiki 移动应用" > README.md
echo "基于官方 MediaWiki App 设计的中医知识库移动应用" >> README.md

# 3. 创建项目结构
mkdir -p docs/{design,architecture,api}
mkdir -p android/ ios/ shared/
mkdir -p assets/{icons,screenshots,design}

# 4. 创建 .gitignore
cat > .gitignore << 'EOF'
# Android
*.iml
.gradle
/local.properties
/.idea/caches
/.idea/libraries
/.idea/modules.xml
/.idea/workspace.xml
/build
/captures

# iOS
.DS_Store
*.swp
*.swo
*~
build/
DerivedData/
*.pbxuser
*.mode1v3
*.mode2v3
*.perspectivev3
xcuserdata/

# 通用
*.log
node_modules/
.env
*.apk
*.ipa
EOF

# 5. 初始提交
git add .
git commit -m "初始提交：CHSOC Wiki 移动应用项目结构"
</pre>

'''任务1.2：Android 项目初始化'''
<pre>
# 进入 Android 目录
cd android/

# 创建 Android 项目结构
# 1. 打开 Android Studio
# 2. 选择 "New Project"
# 3. 选择 "Empty Activity"
# 4. 配置：
#    - Name: CHSOCWiki
#    - Package: com.chsoc.wiki
#    - Language: Kotlin
#    - Minimum SDK: API 24

# 同步 Gradle
./gradlew clean
./gradlew build
</pre>

'''任务1.3：iOS 项目初始化'''
<pre>
# 进入 iOS 目录
cd ../ios/

# 创建 Xcode 项目
# 1. 打开 Xcode
# 2. 选择 "Create a new Xcode project"
# 3. 选择 "iOS" → "App"
# 4. 配置：
#    - Product Name: CHSOCWiki
#    - Interface: SwiftUI
#    - Language: Swift
#    - Minimum Deployments: iOS 15.0

# 或创建项目结构
mkdir -p CHSOCWiki/CHSOCWiki/{App,Models,Services,Views,ViewModels,Utilities}
mkdir -p CHSOCWiki/CHSOCWikiTests
mkdir -p CHSOCWiki/CHSOCWikiUITests
</pre>

'''任务1.4：共享文档创建'''
<pre>
# 返回项目根目录
cd ../

# 创建开发文档
# docs/architecture/TECHNICAL_ARCHITECTURE.md
# docs/api/MEDIAWIKI_API.md
</pre>

'''任务1.5：今日完成检查'''
<pre>
# 检查项目结构
tree -L 3

# 预期结构：
# CHSOCWiki-Mobile/
# ├── android/          # Android 项目
# ├── ios/            # iOS 项目
# ├── docs/           # 文档
# ├── shared/         # 共享资源
# ├── assets/         # 设计资源
# └── README.md       # 项目说明
</pre>

==== 明日计划（2026-02-15） ====

'''任务1.6：网络层实现'''
* '''Android 网络层'''：实现 RetrofitClient、ApiService、数据模型，测试 API 连接功能
* '''iOS 网络层'''：实现 APIClient、Endpoints、数据模型，测试 API 连接功能

'''任务1.7：设计系统创建'''
* '''Android 设计系统'''：创建主题系统 (Theme.kt, Typography.kt)，创建基础组件库，配置 Material Design 3
* '''iOS 设计系统'''：创建 Color+Extension.swift，创建 Font+Extension.swift，创建基础组件

=== 第2周任务：设计系统 + 基础UI ===

'''任务2.1：UI/UX 设计'''
<pre>
# 创建设计资源目录
mkdir -p assets/design/{screens,components,icons}

# 设计文件结构
# assets/design/
# ├── screens/        # 页面设计
# │   ├── login.fig
# │   ├── home.fig
# │   └── article.fig
# ├── components/     # 组件设计
# │   ├── buttons.fig
# │   ├── cards.fig
# │   └── navigation.fig
# └── icons/          # 图标资源
#     ├── app-icon.svg
#     └── tab-icons/
</pre>

'''任务2.2：登录界面实现'''
* '''Android 登录界面'''：实现 LoginScreen.kt，实现 LoginViewModel.kt，集成 API 认证
* '''iOS 登录界面'''：实现 LoginView.swift，实现 LoginViewModel.swift，集成 API 认证

'''任务2.3：导航架构'''
* '''Android 导航'''：配置 Navigation Compose，创建 AppNavigation.kt，实现底部导航
* '''iOS 导航'''：配置 NavigationStack，创建 AppNavigation.swift，实现 TabView 导航

=== 第3周任务：核心数据层 ===

'''任务3.1：数据库设计'''
* '''Android 数据库'''：创建 Room 数据库，定义数据实体 (User, WikiPage, SearchHistory)，创建 DAO 接口，实现 Repository
* '''iOS 数据库'''：创建 CoreData 模型，定义 ManagedObject 子类，创建 DataController，实现 Repository 模式

'''任务3.2：缓存策略'''
<pre>
缓存策略:
  1. 内存缓存: LruCache
  2. 磁盘缓存: Room/CoreData
  3. 网络缓存: OkHttp Cache
  4. 图片缓存: Coil/Kingfisher
</pre>

'''任务3.3：错误处理'''
* 统一错误处理机制
* 网络错误处理
* 本地错误处理
* 用户友好错误提示