OPC/cmautobuy
2
0
Fork 0
Code Issues 114 Pull Requests Actions Packages Projects Releases Wiki Activity

建立项目档案与核心导航 Wiki #313

New Issue
Open
opened 2026-08-26 16:26:21 +08:00 by ila · 1 comment
ila commented 2026-08-26 16:26:21 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：需求
  • 父级大工单：#310
  • 所属 MVP / 版本：#311
  • 阶段：阶段 2：核心 Wiki 初始化
  • 原始需求来源：用户在 2026-08-26 要求参考更新后的 D:\OPC\dev_harness 更新本项目文档和工作流
  • 前置工单：#312
  • 是否允许并行：否。依赖 #312 的映射和在线校验能力。
  • 状态：待验收

要解决什么

项目没有 Project-Profile、Product-Requirements-Overview 等核心 Wiki 页面，也未记录 DevHarness 来源基线、Admin/Client 交付单元和现有/目标差异。

做什么 / 不做什么

  • 做：创建并在线回读 Home、Project-Profile、Product-Requirements-Overview、Architecture-and-Code-Map、Business-Rules-and-Glossary、Local-Development-and-Verification、Common-Changes、Troubleshooting、Development-Workflow、Delivery-Documentation-Guide、Audience-Document-Template、Task-Archive-Template；记录 revision 后导出镜像。
  • 不做：不迁移 20 份详细 Admin/Client 文档；不切换根规则；不删除现有 docs。

怎么做

内容根据本项目代码、现有文档和已确认方案编写；每页通过 Gitea MCP 创建/更新并回读 revision，再使用 Harness 导出。项目档案记录来源 D:/OPC/dev_harness、目标完整提交和升级日期。

预计修改：核心 Wiki 页面及 docs/00~09、docs/delivery/、docs/templates/task-archive.md 镜像

设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。
长期文档影响：有，具体页面和镜像见预计修改。

验收标准

  • 12 个核心页面在线存在并可回读 revision
  • 项目档案准确记录两个交付单元、共享契约和 DevHarness 基线
  • 需求总览链接现有 Epic/MVP 和历史入口但不复制任务全文
  • 镜像头页面名、URL、revision、同步时间完整
  • 核心同步检查通过

怎么验证

Gitea MCP 逐页回读；python dev_scripts/harness.py sync --check；python tests/test_harness_docs.py CoreDocumentTests -v。全仓 sync --verify / check --strict 会在 #314～#316 完成详细页、规则和部署页后由 #317 执行；本阶段不得用尚未完成的后续范围冒充核心页失败。

风险和回退

Wiki 首次写入是外部状态变化；失败时从首个失败页继续，不删除已成功页面，不宣称切换完成。

## 基本信息 - 类型：需求 - 父级大工单：#310 - 所属 MVP / 版本：#311 - 阶段：阶段 2：核心 Wiki 初始化 - 原始需求来源：用户在 2026-08-26 要求参考更新后的 `D:\OPC\dev_harness` 更新本项目文档和工作流 - 前置工单：#312 - 是否允许并行：否。依赖 #312 的映射和在线校验能力。 - 状态：待验收 ## 要解决什么 项目没有 Project-Profile、Product-Requirements-Overview 等核心 Wiki 页面，也未记录 DevHarness 来源基线、Admin/Client 交付单元和现有/目标差异。 ## 做什么 / 不做什么 - 做：创建并在线回读 Home、Project-Profile、Product-Requirements-Overview、Architecture-and-Code-Map、Business-Rules-and-Glossary、Local-Development-and-Verification、Common-Changes、Troubleshooting、Development-Workflow、Delivery-Documentation-Guide、Audience-Document-Template、Task-Archive-Template；记录 revision 后导出镜像。 - 不做：不迁移 20 份详细 Admin/Client 文档；不切换根规则；不删除现有 docs。 ## 怎么做 内容根据本项目代码、现有文档和已确认方案编写；每页通过 Gitea MCP 创建/更新并回读 revision，再使用 Harness 导出。项目档案记录来源 `D:/OPC/dev_harness`、目标完整提交和升级日期。 预计修改：核心 Wiki 页面及 `docs/00~09`、`docs/delivery/`、`docs/templates/task-archive.md` 镜像 设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。 长期文档影响：有，具体页面和镜像见预计修改。 ## 验收标准 - [ ] 12 个核心页面在线存在并可回读 revision - [ ] 项目档案准确记录两个交付单元、共享契约和 DevHarness 基线 - [ ] 需求总览链接现有 Epic/MVP 和历史入口但不复制任务全文 - [ ] 镜像头页面名、URL、revision、同步时间完整 - [ ] 核心同步检查通过 ## 怎么验证 Gitea MCP 逐页回读；`python dev_scripts/harness.py sync --check`；`python tests/test_harness_docs.py CoreDocumentTests -v`。全仓 `sync --verify` / `check --strict` 会在 #314～#316 完成详细页、规则和部署页后由 #317 执行；本阶段不得用尚未完成的后续范围冒充核心页失败。 ## 风险和回退 Wiki 首次写入是外部状态变化；失败时从首个失败页继续，不删除已成功页面，不宣称切换完成。
ila referenced this issue from a commit 2026-08-26 16:46:40 +08:00
docs: 归档任务 #313
ila commented 2026-08-26 16:46:52 +08:00
Author
Owner
Copy Link
Copy Source

实施结果

  • 在线页面：12 个核心页面均已创建并逐页回读 revision。
  • 镜像提交：d130e26
  • 本地归档提交：9159d54
  • 归档：docs/task/313-建立项目档案与核心导航Wiki.md
  • 验证：sync --check 通过；核心文档测试 12 项通过。
  • 未验证：Admin/Client 详细页、Agent 规则、部署运维页由 #314～#316 继续。

状态：待验收。

## 实施结果 - 在线页面：12 个核心页面均已创建并逐页回读 revision。 - 镜像提交：`d130e26` - 本地归档提交：`9159d54` - 归档：`docs/task/313-建立项目档案与核心导航Wiki.md` - 验证：`sync --check` 通过；核心文档测试 12 项通过。 - 未验证：Admin/Client 详细页、Agent 规则、部署运维页由 #314～#316 继续。 状态：待验收。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/cmautobuy#313