2.7 KiB
2.7 KiB
术语映射表（Core ↔ dogfood 实例）
本表是 Core 改写与 dogfood 实例对照的唯一事实源（v3 §E）：Core 侧 工件使用下表左列的中立术语，右列是本组织 dogfood 实例（Gitea 后端）的 实际表述。任何 Core 工件需要落到本实例时，按本表做机械替换；反向 改写（实例 → Core）同样以本表为准。新增映射必须先改本表，再改工件。
| Core 中立术语 | dogfood/Gitea 实例表述 |
|---|---|
| 工单后端（ticket backend） | Gitea |
| Tier-2 工件库 | Gitea wiki |
| 工单评论 API（ticket backend 评论接口） | Gitea REST 评论端点族：GET/POST /repos/{owner}/{repo}/issues/{index}/comments、PATCH /repos/{owner}/{repo}/issues/comments/{id} |
| wiki 读写 API（Tier-2 工件库读写接口） | Gitea REST wiki 端点族：wiki/pages GET、wiki/page/{pageName} GET/PATCH、wiki/new POST（路径前缀 /api/v1/repos/{owner}/{repo}/） |
| 看板移动 API（工单看板列迁移接口） | Gitea REST projects 相关端点（经 swagger.v1.json 查询后调用，勿臆造路径） |
| 项目看板 API（工单面板管理接口） | Gitea REST projects/columns 端点族：GET /repos/{owner}/{repo}/projects、GET /repos/{owner}/{repo}/projects/{project_id}/columns |
| 路由解析工具（Step 0 路由门依赖） | route_resolver |
| 会话工作树路径（并发分支工作区根） | <worktrees-root> |
| 测试命令·变更集（本地前置检查） | bun run test:changed |
| 测试命令·全量分片（交付前置 / nightly） | bun run test:parallel |
| 类型检查命令 | bun typecheck |
| 产品代码路径（harness 实现所在包） | packages/octopus/src/... |
| 私化工单引用（组织内部工单号） | #NNNN 活链接（Core 侧用 [org-internal #NNNN] 注记） |
| 实例规则目录（dogfood 消费副本所在） | .octopus/（如 .octopus/rules/） |
| 运行工作区（Tier-1 本地工件） | .octopus/runs/{slug}/ |
| 实例配置文件（会话/管线配置） | octopus.jsonc |
备注
- 私化工单引用：Core 侧不得产出指向具体实例的活链接
#NNNN（会被 实例渲染为真实工单）；一律写[org-internal #NNNN]注记格式，落地 实例时按本表还原为#NNNN。 - 命令占位：Core 规则正文中的
<test-cmd:changed>、<test-cmd:parallel>等占位符按本表「测试命令」两行绑定到实例命令。 - 裸词 Gitea：仅当作为 adapter 名称出现时允许（如「Gitea adapter」）；
- 表内反引号包裹的实例表述仅供对照，不构成 Core 对实例的引用 （C-1 扫描剥离行内代码后本表零命中）。