# SPEC-002: 复习系统总门户导航页（docs/index.html）规格说明书

- **规格编号**：`SPEC-002`
- **关联项目**：四川省成都市高二理科备考系统（生物与化学·人教版2019）
- **统一语言依据**：[`CONTEXT.md`](../../CONTEXT.md)
- **协议依据**：[`AGENTS.md`](../../AGENTS.md)（自主执行闭环协议与实体资产留痕优先原则）
- **标签**：`ready-for-agent`

---

## 1. 背景与问题陈述 (Problem Statement)

目前项目已交付：
1. `docs/10月月考/`（生物.html、化学.html）
2. `docs/期中/`（生物.html、化学.html）
3. `docs/期末/`（生物.html、化学.html）
4. 以及一系列调研研报、架构决策、规格与复盘笔记。

然而，学生或家长在访问时缺乏一个统一的一站式导航入口（Dashboard），各个复习包页面中的“返回全科索引”链接（`../index.html`）目前指向缺失。必须构建一个功能完备、视觉精美、免受网络限制的本地化门户索引页 `docs/index.html`。

---

## 2. 解决方案与交付边界 (Solution Scope)

交付单个独立的高交互 Web 入口：`docs/index.html`。
- **0 外部依赖**：纯原生 HTML5 ＋ CSS3 ＋ 原生 JavaScript，断网可用。
- **三色主题**：支持浅色清晰、羊皮纸护眼（Paper）、极简深色（Dark）三种主题，并与子页面共享 theme 机制。
- **全局资产聚合**：
  - 10月月考复习包（生物、化学）
  - 期中复习包（生物、化学）
  - 期末复习包（生物、化学）
  - 工程知识库与复盘资产导航
- **全局易错打卡进度总览**：自动读取 `localStorage` 中各子页面的打卡数据，汇总全局掌握进度。

---

## 3. 验收标准 (Acceptance Criteria)

1. **超链接完整性**：
   - 页面中指向的所有子页面和文档链接（`./10月月考/生物.html`、`./10月月考/化学.html`、`./期中/生物.html`、`./期中/化学.html`、`./期末/生物.html`、`./期末/化学.html`、`./复习规划.md`、`./research/...`、`./adr/...`、`./specs/...`、`./retros/...`）100% 存在且有效。
2. **符号与排版规范**：
   - 0 个 LaTeX `$` 残留；
   - 0 个 Markdown `**` 残留；
   - HTML 标签 100% 正常闭合。
3. **响应式与交互性**：
   - 支持桌面端、平板、手机等不同屏幕尺寸；
   - 主题切换在 `default`、`paper`、`dark` 间顺畅循环并持久化；
   - 动态打卡雷达展示总体完成情况。