历史 · 文档、设计与基础设施

历史档案 · 2026-09-11 重构前快照。 本文中的“当前”“已冻结”和实施顺序属于旧基线。新版本以现行总览和实施计划为准。

这三个仓库共同支持各产品的建设：Design 维护设计规范和可复用设计基础，Docs 解释架构、接口与实施过程，Infrastructure 负责环境、身份、网络、治理、发布和组合验证。它们不拥有产品业务事实。

所有项目的业务负责人和最终验收人都是用户本人。表中的模块责任表示工作边界，不表示需要另外组建团队。本项目会话优先在本机分配和汇总工作，按本地协调记录工作包、Owned Paths、依赖和验收；GitHub 可承载后续审查、CI 与发布记录，不是本轮开工前提。

仓库	需求与设计对象	首轮原型	后续实现边界
Docs	文档读者、内容层次、API 文档分类、版本与搜索体验	文档首页、目录、接口详情、错误示例、版本提示和搜索结果	文档内容、固定契约生成、已有站点与搜索能力；不另建业务后台
Design	品牌、token、共享组件、各平台布局和状态规范	独立实验室、组件状态、每个平台的关键页面样板	既有 `Oceanway-design/design-system/`；共享包资格另行验证
Infrastructure	环境拓扑、身份、网络、部署配置、观测和恢复需求	拓扑图、时序图、配置 fixture、发布/回滚与故障场景演练稿	IaC、受控配置、脚本、检查器与跨仓联调；不建设重复的运维产品后台

第一轮交付

遵循统一实施流程，本轮先统一各平台的需求、设计与原型。每个仓库交付需求范围、设计方案、可审查原型、待确认决策和验收清单。已有代码、历史设计或测试报告只作为盘点输入，不自动算作本轮验收。

Docs 的接口文档样板、Design 的纯展示组件样板、Infrastructure 的配置 fixture 都使用显式演示数据。无 UI 的服务以接口/事件时序和配置示例表达原型，不为了填齐阶段创建页面、数据库或 HTTP 服务。

三类原型经用户逐项确认后，再安排接口细化、实现与联调。应用仓产生自身制品和测试；Infrastructure 验证固定制品在目标环境的组合行为；Docs 记录最终证据和限制。设计确认、代码完成、测试通过、制品发布和生产上线分别记账。