Add harness coding documentation

docs/routes.md

@@ -0,0 +1,79 @@
+# 路由与页面结构
+
+> 本文约定前台页面路由、页面职责和组件归属。
+
+## 页面路由
+
+| 路由 | 页面 | MVP 说明 |
+| --- | --- | --- |
+| `/` | 首页 | 展示场景入口、推荐骨架、最新文章。 |
+| `/scenarios/` | 场景总览页 | 展示所有场景分类。 |
+| `/scenarios/{slug}/` | 场景详情 / 列表页 | 展示某个场景下的骨架项目。 |
+| `/projects/` | 骨架项目列表页 | 支持语言、框架、数据库、AI 分数和关键词筛选。 |
+| `/projects/{slug}/` | 骨架详情页 | 展示项目详情、评分、推荐理由和外部链接。 |
+| `/languages/{slug}/` | 语言聚合页 | MVP 可由筛选页替代。 |
+| `/frameworks/{slug}/` | 框架聚合页 | MVP 可由筛选页替代。 |
+| `/articles/` | 文章列表页 | 展示评测、对比、避坑指南。 |
+| `/articles/{slug}/` | 文章详情页 | 展示文章正文。 |
+| `/admin/` | Wagtail Admin | 后台内容维护。 |
+
+## 页面职责
+
+### 首页
+
+- 展示主场景分类。
+- 展示推荐骨架项目。
+- 展示最新文章。
+- 引导进入项目列表和场景页。
+
+### 场景页
+
+- 展示该场景说明。
+- 展示该场景下骨架项目。
+- 支持跳转项目详情。
+- 无项目时展示空状态。
+
+### 项目列表页
+
+- 展示所有已发布骨架项目。
+- 支持按语言、框架、数据库、AI 分数、关键词筛选。
+- 筛选条件体现在 URL 查询参数中。
+- 展示当前筛选条件和清除筛选入口。
+
+### 项目详情页
+
+- 根据 slug 定位单个骨架项目。
+- 展示核心信息、技术栈、评分、适用场景、不适用场景、推荐理由。
+- 外部链接打开到 GitHub / 官网。
+- 如果是赞助项目，展示 Sponsored 标识。
+
+### 文章页
+
+- 展示评测、对比、避坑指南。
+- 文章可以链接到骨架详情页。
+
+### 后台
+
+- 使用 Wagtail Admin。
+- 编辑者维护项目、分类、标签、评分和文章。
+- 不开发单独后台前端。
+
+## 模板 / 组件建议
+
+| 模板 / 组件 | 归属 | 说明 |
+| --- | --- | --- |
+| `base.html` | 全局 | 页面框架、导航、SEO block、页脚。 |
+| `home_page.html` | 首页 | 场景入口、推荐项目、最新文章。 |
+| `project_card.html` | 通用 include | 项目卡片。 |
+| `project_filters.html` | 列表页 include | 筛选控件。 |
+| `score_badge.html` | 通用 include | AI 友好度评分展示。 |
+| `sponsored_badge.html` | 通用 include | 赞助标识。 |
+| `empty_state.html` | 通用 include | 无结果状态。 |
+
+## 导航规则
+
+- 首页进入场景页：点击场景入口。
+- 场景页进入项目详情：点击项目卡片。
+- 项目列表保留筛选条件，清除筛选后回到 `/projects/`。
+- 后台只通过 `/admin/` 访问。
+- 权限不足使用 Wagtail 默认后台权限处理。