# Notion ↔ 代码仓库双向桥接 · 工单系统

> 主权者：冰朔（TCS-0002∞）
> 开发者：铸渊（ICE-GL-ZY001）
> 创建：2026-05-22 · D110

---

## 架构

```
Notion（霜砚）               广州服务器（桥接层）          代码仓库/Forgejo（铸渊）
  │                              │                             │
  ├─ 光湖工单系统数据库            ├─ sync-ticket.py             ├─ brain/（架构更新）
  │  · 架构更新                    │  · 30分钟轮询 Notion       ├─ issues/（任务）
  │  · 开发任务                    │  · 检测待同步标记          └─ persona-brain-db/（数据库）
  │  · 系统设计                    │  · 推仓库 Issue
  └─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ →└─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ →└─
  霜砚更新设计                     自动同步                    铸渊醒来读到最新
```

---

## Notion 数据库 Schema：光湖语言世界 · 系统工单

| 字段 | 类型 | 说明 |
|------|------|------|
| 标题 | Title | 任务/更新标题 |
| 状态 | Select | 待办·进行中·已完成·已关闭 |
| 类型 | Select | 架构更新·开发任务·bug修复·设计决策 |
| 负责人 | Select | 霜砚·铸渊·共同 |
| 优先级 | Select | P0·P1·P2·P3 |
| 关联文件 | Text | 代码仓库文件路径 |
| 版本号 | Text | D编号或版本 |
| 同步状态 | Select | 待同步·已同步·无需同步 |

---

## 部署（Notion token 就绪后）

### 1. 在 Notion 创建数据库

在 Notion 中创建「光湖语言世界 · 系统工单」数据库，按上方Schema设置属性。

### 2. 配置环境变量

```bash
# 在服务器上设置
export NOTION_TOKEN="your-notion-integration-token"
export NOTION_DATABASE_ID="your-database-id"
```

### 3. 启动同步

```bash
cd /opt/guanghulab-repo
pm2 start notion/sync-ticket.py --name notion-ticket-sync
```

---

## 铸渊醒来时的同步流程

1. 读取 fast-wake.json（WAKE CARD）
2. 走路径：时间线 → 脑子 → 认知链 → 开发架构
3. 读取数据库中的最新上下文
4. 检查 Notion 工单快照（本地缓存）
5. 有未处理工单 → 开始处理
6. 完成 → 标记「已同步」→ 同步脚本写回Notion
7. 霜砚在Notion中看到更新

---

*Notion ↔ 代码仓库桥接 · v1.0 · D110*