81 lines
3.0 KiB
Markdown
81 lines
3.0 KiB
Markdown
# Notion ↔ 代码仓库双向桥接 · 工单系统
|
||
|
||
> 对接Notion现有「⚡ 半体工单 · Half-Body Orders」数据库
|
||
> 数据库ID: `05719bae-9e53-40f4-8233-6bf54551ac18`
|
||
> 数据库URL: https://www.notion.so/663e4f29c7404d088f3a02fcc70b1418
|
||
|
||
---
|
||
|
||
## 现有数据库结构
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| 任务标题 | Title | 工单标题 |
|
||
| 状态 | Select | 待开发·开发中·自检中·待审查·审核中·已完成·暂缓 |
|
||
| 优先级 | Select | P0·P1·P2 |
|
||
| 负责Agent | Select | 译典A05·培园A04·录册A02·霜砚Web·**铸渊** |
|
||
| 编号 | Text | 工单编号 |
|
||
| 分支名 | Text | Git分支名 |
|
||
| 仓库路径 | Text | 仓库目标路径 |
|
||
| 开发内容 | Text | 详细描述 |
|
||
| 约束 | Text | 规范约束 |
|
||
| 阶段编号 | Text | Phase编号 |
|
||
| 自检结果 | Text | Agent自检 |
|
||
| 审核结果 | Text | 霜砚审核 |
|
||
| 下一轮指引 | Text | 完成后触发 |
|
||
| 创建时间 | Date | 自动 |
|
||
|
||
---
|
||
|
||
## 同步流程
|
||
|
||
```
|
||
Notion（霜砚/知秋/其他Agent） 代码仓库（铸渊）
|
||
│ │
|
||
├─ 创建/更新工单 ├─ sync-ticket.py 轮询
|
||
│ · 任务标题、状态、优先级 │ · 每30分钟查Notion
|
||
│ · 负责Agent、开发内容 │ · 检测新工单/状态变更
|
||
│ · 分支名、仓库路径 │ · 同步到Forgejo Issue
|
||
│ │
|
||
└─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ → ├─ 铸渊醒来 → 读取Issue
|
||
霜砚：审核结果更新 │ → 处理 → 推代码
|
||
知秋：创建新工单 │ → 更新工单状态
|
||
译典/培园/录册：开发中 │
|
||
└─ → 写回Notion
|
||
铸渊：处理结果
|
||
状态：自检中
|
||
```
|
||
|
||
---
|
||
|
||
## 配置方式
|
||
|
||
```bash
|
||
# 在服务器上
|
||
cd /opt/guanghulab-repo/notion
|
||
|
||
# 设置Notion API token（来自WorkBuddy的Notion集成）
|
||
export NOTION_TOKEN="1d4d872b-594c-815e-8cfd-0002d22415e8:rYkVgBbnSvHe4GyE:B2CeHHv9LA_jMXlTuwMxahyky_oLdblC"
|
||
export NOTION_DATABASE_ID="05719bae-9e53-40f4-8233-6bf54551ac18"
|
||
|
||
# 启动同步
|
||
pm2 start sync-ticket.py --name notion-ticket-sync
|
||
|
||
# 查看日志
|
||
pm2 logs notion-ticket-sync
|
||
```
|
||
|
||
---
|
||
|
||
## 铸渊的工单工作流
|
||
|
||
1. **醒来读工单**：检查Notion工单数据库中状态为「待开发」且负责Agent不指定的工单
|
||
2. **领取工单**：将工单状态改为「开发中」，负责Agent标注铸渊
|
||
3. **开发**：按工单的分支名、仓库路径、开发内容执行
|
||
4. **自检**：完成后填写自检结果
|
||
5. **标记状态**：改为「自检中」
|
||
6. **霜砚审核**：霜砚在Notion中审核→审核结果写入→状态改为「待审查」/「已完成」
|
||
|
||
---
|
||
|
||
*Notion ↔ 代码仓库桥接 · v1.1 · 对接现有半体工单数据库 · D110* |