refactor: ready to update the arch for better dev

Author: Charliechen114514

.templates/platform-tutorial-template.md

@@ -0,0 +1,53 @@
+---
+title: "平台教程标题"
+series: stm32f1|esp32|rp2040
+chapter: XX
+section: XX
+difficulty: beginner|intermediate|advanced
+tags: [tag1, tag2]
+cpp_standard: "C++XX"
+created: YYYY-MM-DD
+author: charliechen
+hardware:
+  platform: STM32F103C8T6
+  board: Blue Pill
+  peripherals: [GPIO, UART, ...]
+---
+
+# 教程标题
+
+## 本章目标
+
+一句话说明这一章要解决什么问题。
+
+## 硬件原理
+
+只讲这一章对应 feature 的硬件原理。
+
+## HAL 接口
+
+只讲这一章对应 feature 的 HAL API。
+
+## 最小 Demo
+
+给出可以直接跑的最小例子。
+
+## C++23 封装
+
+演示如何用现代 C++ 改善接口。
+
+## 常见坑
+
+列出最常见的问题。
+
+## 练习题
+
+让读者自己扩展。
+
+## 可复用代码片段
+
+沉淀到 code/ 目录中的模块。
+
+## 本章小结
+
+总结本章唯一核心 feature。

.templates/todo-template.md

@@ -0,0 +1,35 @@
+---
+id: XXX
+title: "描述性标题"
+category: architecture|content|automation|branding|mkdocs|community|translation|interactive
+priority: P0|P1|P2|P3
+status: pending|in-progress|blocked|done
+created: YYYY-MM-DD
+assignee: charliechen
+depends_on: []
+blocks: []
+estimated_effort: small|medium|large|epic
+---
+
+# 标题
+
+## 目标
+
+一段话说明要做什么和为什么。
+
+## 验收标准
+
+- [ ] 标准 1
+- [ ] 标准 2
+
+## 实施说明
+
+技术细节、方案、注意事项。
+
+## 涉及文件
+
+- path/to/file
+
+## 参考资料
+
+- 链接

todo/README.md

@@ -0,0 +1,71 @@
+# TODO 追踪系统
+
+本目录是 Tutorial_AwesomeModernCPP 仓库的 TODO 追踪系统，按方向分类管理所有待办事项。
+
+## 目录结构
+
+```
+todo/
+├── architecture/    # 架构和重构 TODO（P0 优先）
+├── content/         # 内容创建 TODO（P0-P1 优先）
+├── automation/      # CI/CD 和自动化 TODO（P1 优先）
+├── branding/        # 品牌和推广 TODO（P2 优先）
+├── mkdocs/          # MkDocs 优化 TODO（P1 优先）
+├── community/       # 社区和贡献 TODO（P2 优先）
+├── translation/     # 翻译流水线 TODO（P2 优先）
+└── interactive/     # 交互式元素 TODO（P3 优先）
+```
+
+## 优先级定义
+
+| 级别 | 含义 | 示例 |
+|------|------|------|
+| P0 | 必须先做，阻塞其他工作 | 目录迁移、MkDocs 配置更新 |
+| P1 | 重要，影响下一个 Release | STM32F1 外设教程、RTOS 调度器、CI 编译 |
+| P2 | 显著价值提升 | ESP32/RP2040、品牌建设、翻译流水线 |
+| P3 | 锦上添花 | 在线编译器、汇编查看器、视频内容 |
+
+## TODO 文件规范
+
+每个 TODO 是一个独立的 Markdown 文件，使用以下 frontmatter：
+
+```yaml
+---
+id: XXX                          # 唯一编号，与文件名编号一致
+title: "描述性标题"
+category: architecture|content|automation|branding|mkdocs|community|translation|interactive
+priority: P0|P1|P2|P3
+status: pending|in-progress|blocked|done
+created: YYYY-MM-DD
+assignee: charliechen
+depends_on: []                   # 依赖的 TODO ID 列表
+blocks: []                       # 被本 TODO 阻塞的 TODO ID 列表
+estimated_effort: small|medium|large|epic
+---
+```
+
+文件体包含：目标、验收标准（可勾选）、实施说明、涉及文件、参考资料。
+
+## 状态说明
+
+| 状态 | 含义 |
+|------|------|
+| pending | 未开始 |
+| in-progress | 进行中 |
+| blocked | 被阻塞（等待依赖完成） |
+| done | 已完成 |
+
+## 编号规则
+
+- `001-009`：架构相关（architecture/）
+- `010-049`：内容相关（content/）
+- `050-069`：自动化相关（automation/）
+- `070-079`：品牌相关（branding/）
+- `080-089`：MkDocs 相关（mkdocs/）
+- `090-099`：社区相关（community/）
+- `100-109`：翻译相关（translation/）
+- `110-119`：交互相关（interactive/）
+
+## 模板
+
+新建 TODO 文件时，使用 `.templates/todo-template.md` 模板。

todo/architecture/001-create-legacy-branch.md

@@ -0,0 +1,76 @@
+---
+id: 001
+title: "创建 archive/v0-legacy 分支保留旧结构快照"
+category: architecture
+priority: P0
+status: pending
+created: 2026-04-15
+assignee: charliechen
+depends_on: []
+blocks: [002]
+estimated_effort: small
+---
+
+# 创建 archive/v0-legacy 分支保留旧结构快照
+
+## 目标
+
+在开始目录重构之前，从当前 `main` 分支创建一个名为 `archive/v0-legacy` 的分支，作为旧内容结构的永久快照。任何想要查看重构前目录布局（`tutorial/` + `codes_and_assets/` 结构）的贡献者或读者，都可以切换到该分支浏览。
+
+这是整个架构重构的前置安全网，确保历史内容不会因为后续的大量 `git mv` 操作而难以回溯。
+
+## 验收标准
+
+- [ ] `archive/v0-legacy` 分支已从当前 `main` 的 HEAD 创建
+- [ ] 分支已推送到远程仓库 (`origin/archive/v0-legacy`)
+- [ ] 主仓库 `README.md` 中新增一段说明，指引访问者前往 `archive/v0-legacy` 查看旧版内容结构
+- [ ] 在分支创建后，验证该分支上的目录结构完整（`tutorial/`、`codes_and_assets/`、`scripts/` 等目录均存在）
+- [ ] GitHub 上可以通过分支选择器看到 `archive/v0-legacy`
+
+## 实施说明
+
+### 创建分支
+
+```bash
+# 确保当前在 main 分支且工作区干净
+git checkout main
+git pull origin main
+git status  # 确认 clean
+
+# 创建归档分支
+git branch archive/v0-legacy
+
+# 推送到远程
+git push origin archive/v0-legacy
+```
+
+### 更新 README.md
+
+在 `README.md` 中合适位置（建议在"项目结构"或"快速开始"章节之前）添加如下提示框：
+
+```markdown
+> **历史版本**: 如果你需要查看 2026 年 4 月重构之前的目录结构（`tutorial/` + `codes_and_assets/`），
+> 请切换到 [`archive/v0-legacy`](https://github.com/Charliechen114514/Tutorial_AwesomeModernCPP/tree/archive/v0-legacy) 分支。
+```
+
+### 验证步骤
+
+1. 在浏览器中访问 `https://github.com/Charliechen114514/Tutorial_AwesomeModernCPP/tree/archive/v0-legacy`，确认文件结构完整
+2. 确认分支保护：考虑在 GitHub 仓库设置中将该分支设为 protected（禁止 force push 和删除），防止意外丢失
+3. 确认本地 `git branch -r` 输出中包含 `origin/archive/v0-legacy`
+
+### 注意事项
+
+- 此操作不涉及任何文件移动或修改（除 README.md 的提示文本），风险极低
+- 分支命名使用 `archive/` 前缀，符合常见的归档分支命名惯例
+- 不要在此分支上做任何后续开发，它仅作为历史快照
+
+## 涉及文件
+
+- `README.md`（仅添加归档分支提示文本）
+- 无其他文件变更（纯 git 操作）
+
+## 参考资料
+
+- [Git Branching - Branch Management](https://git-scm.com/book/en/v2/Git-Branching-Branch-Management)
+- [GitHub: About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)