主题
文档地图（唯一来源登记表）
规则很简单：每个主题只有一个权威出处，其他地方（README、代码注释、本站其他页）只放指针或摘要。新增权威文档时必须在本表登记一行；同一事实在两处各维护一份，就是违规。
本表不登记快照数字（测试数、覆盖率、行数），它们只活在 CI 报告和各轮 changelog 里，登记了很快就会过期。登记面最后复核于 2026-10-16（简化重构轮：SIMPLIFICATION-PLAN 入册，S1 至 S4 已落码）。
仓内文档（docs/、editor/docs/refactor/、design/）一律在文首带「AI 维护文档」标记，那是给 AI 延续性阅读用的；人类读者从本站出发就够了。
上图是全仓文档的四个群落：本站负责给人读，治理与规格文档约束怎么写代码，记录族沉淀过程证据，机器真源是代码和 CI 直接消费的数据。箭头方向就是「谁引用谁」。
入门与导航（本站即权威）
| 主题 | 权威出处 |
|---|---|
| 从零开始 / 快速入门 | docs-site/src/guide/start.md |
| 功能全景（逐域导览，含实现归属） | docs-site/src/guide/features.md |
| 技术选型与理由 | docs-site/src/guide/tech-stack.md |
| 设计原则（摘要） | docs-site/src/guide/principles.md（铁律原文见下表） |
| 架构总览 | docs-site/src/guide/architecture.md |
| 目录职责 | docs-site/src/guide/directory.md |
| 开发规范（速查；铁律原文权威见 ARCHITECTURE-RULES） | docs-site/src/guide/standards.md |
| 测试策略 | docs-site/src/guide/testing.md |
| 配置参考（文档格式 / 值词表 / 迁移 / 端点 / CI） | docs-site/src/guide/config.md |
| 构建与部署 | docs-site/src/guide/build-deploy.md |
| 参与指南 | docs-site/src/guide/contribute.md |
| 演进史 | docs-site/src/guide/evolution.md |
| 常见问题 | docs-site/src/guide/faq.md |
| 术语表 | docs-site/src/reference/glossary.md |
| ADR 摘要 | docs-site/src/reference/adr.md |
| 本表 | docs-site/src/reference/doc-map.md |
仓内持续维护的权威（原地不动，被代码 / CI 锚定）
治理（editor/docs/refactor/）
| 主题 | 权威出处 | 锚定者 |
|---|---|---|
| 架构铁律原文（分层 / 状态 / 模板 / IO / 测试纪律，含 §11 宪法前身存录） | editor/docs/refactor/ARCHITECTURE-RULES.md | docs-site/guide/standards 摘要；tests/architecture.test.ts 固化 |
| 开发细则（状态管理 / RxJS 边界 / 复用登记 / 迁移引导 / 风险台账 RK-xx） | editor/docs/refactor/DEVELOPMENT-GUIDE.md | 评审对照 |
| 重构变更日志（R 轮逐轮明细与门禁终态） | editor/docs/refactor/REFACTOR-CHANGELOG.md | 各轮提交同步 |
| 简化重构评估与排期（2026-10-16 全量读码体检：S1 至 S6 本轮项、N1 至 N8 下一轮项） | editor/docs/refactor/SIMPLIFICATION-PLAN.md | S1 至 S4 已落码（core/map/style-diff.ts、core/config/basemap-delivery.ts、core/spec-tables.ts、UiService.notifyStyleLocked() 单源守卫）；S5 至 S6 与 N1 至 N8 待做 |
| 双引擎能力矩阵 | editor/docs/refactor/MAP-CAPABILITY-MATRIX.md + core/map/map-capabilities.ts（机器真源） | 三问门禁 + 对账测试 |
规格（docs/spec/）
| 主题 | 权威出处 | 锚定者 |
|---|---|---|
| 交互规格（静态 T 表 + 动态 feature-state，附录 A/B 并档原 interaction-spec） | docs/spec/dynamic-interactions-spec.md | interaction-engine.ts、interaction.model.ts 注释锚点 |
| 双文档编解码规格（FormDoc 与样式文档的双向转换） | docs/spec/form-style-codec-spec.md | core/form/、core/config/layer-config-codec.ts |
| ms-config schema（机器真源） | docs/spec/config-simplification/mapstudio-config.schema.json + example.mapstudio-config.json + examples/ 三件套 | tests/app/core/config/config-schema.test.ts 读盘 |
| 需求 / 任务台账（R-xx / T-xx 含状态列） | docs/spec/full-requirements/mapstudio-requirements.csv + mapstudio-tasks.csv | roadmap / 用例文档编号体系 |
| 人工验收用例（逐域全功能手册） | docs/spec/full-requirements/manual-acceptance.md | 里程碑与发版验收 |
| 用例文档（功能域用例表 UC-NN） | docs/spec/usecases/*.md | e2e-tests/traceability.mjs 双向匹配（文档 ⟷ uc 套件一一对应） |
| 设计令牌（记录值） | docs/spec/design-tokens.json | editor/src/styles.css 头部段（生成声明） |
记录（docs/notes · docs/testing · docs/analysis · e2e-audit）
| 主题 | 权威出处 | 锚定者 |
|---|---|---|
| 路线图（索引式台账：用户决策 D1 至 D5、轮次链、开放待办） | docs/notes/roadmap.md | 每轮提交同步 |
| 上游框架契约（ng-mfe / GISSDK 联调口径） | docs/notes/framework-calibration.md | M5 集成轮 |
| 阶段 4 评估存档（store interop / CDK Overlay 两项「结论不迁移」报告） | docs/notes/R-55-final-report.md、docs/analysis/store-interop-assessment.md、docs/analysis/cdk-overlay-evaluation.md | R-53 裁决 |
| 测试台账（e2e 分册合并档 + vitest 覆盖分册 + 静态门禁成篇） | docs/testing/（README + guards + e2e + integration） | 各轮提交同步 |
| 像素复刻分析档案（189 帧实测的唯一存续记录） | docs/analysis/（README 为索引，SUMMARY 为结论层，frames.md 为逐帧 DB） | 档案封闭，只读 |
| 像素审计 / 裁决链（接力轮真源） | docs/analysis/audit7-adjudication.md（audit6 / audit7-reanalysis 并档节在内） | 接力轮消费 |
| e2e 审计（独立辅助套件：任务口径、15 域用例矩阵、问题与修复台账） | e2e-audit/README.md + findings.md + fixes.md | 手动运行口径，不进任何自动门禁 |
服务与资产
| 主题 | 权威出处 | 锚定者 |
|---|---|---|
| server 权威（部署形态 / 边界） | server/README.md | — |
| server API 清单（前端所需全部后端接口逐一对照） | server/API.md | 前后端联调 |
| mock 端点权威（dev 期七类端点语义） | editor/mock/README.md | vite 插件 + verify-m78 |
| 视觉基线（自拍门禁真源） | tools/baseline/zh-cn/（11 态 PNG） | tools/visual-baseline.mjs pixelmatch |
| 图标数据真源 | docs/reference/mapbox-icons/（SVG + index.json） | editor/src/app/shared/mapbox-icons.ts |
| 界面参数规范（应用内模态） | editor/src/app/core/spec-doc/spec-doc-content.ts（内容单源自含） | 应用内弹窗 |
收档快照（只读，不再更新）
| 文档 | 性质 |
|---|---|
MapboxStudio/（189 基准帧）、mapbox_css/、根 index.html | 已删除（2026-10-11 参考材料下线：约 830MB 截图 / 样式包 / 官方规格页；实测档案存续于 docs/analysis/，图标提取产物存续于 docs/reference/mapbox-icons/；历史在 git） |
MapboxStudio2/、MapStudio3/、MapStudio4/（接力轮进度链） | 已删除（2026-10-11 随源材料下线；轮次记录存续于 roadmap 与 git 历史） |
tools/{measure,compare,frame-zoom,calibrate_tokens,extract-icons}.py 等像素管道 | 已删除（2026-10-11：读上游已删数据；活门禁 tools/e2e.mjs、tools/visual-baseline.mjs、verify-*.mjs 保留） |
MapStyleIDE_Design.md（v2 宪法） | 已删除（2026-10-07：十条不变式多数由铁律 / docs-site / ADR 覆盖，存续条款见 ARCHITECTURE-RULES §11；历史在 git） |
editor/docs/archive/、TARGET-ARCHITECTURE.md、DESIGN.md、第三方评估报告等 | 已删除（2026-09/10 文档清理各批；结论由 roadmap、铁律与 DEVELOPMENT-GUIDE 消化；历史在 git） |
README 指针纪律
- 根
README.md：入口指针（简介 + 目录表 + 进度台账指针），不复述内容。 editor/README.md：简介 + 运行命令 + 功能域速览 + 指针，不复述轮次与数字。editor/mock/README.md、server/README.md：各自领域权威，维持现状。