37 lines
2.7 KiB
Markdown
37 lines
2.7 KiB
Markdown
# 术语映射表（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 扫描剥离行内代码后本表零命中）。
|