From 3fc2c967767329dbd5c0ce1042c69ca8dbb2f569 Mon Sep 17 00:00:00 2001
From: bingshuo <565183519@qq.com>
Date: Fri, 22 May 2026 23:04:34 +0800
Subject: [PATCH] feat: add notion-repo bridge README

---
 notion/README.md | 74 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 notion/README.md

diff --git a/notion/README.md b/notion/README.md
new file mode 100644
index 0000000..0b982c3
--- /dev/null
+++ b/notion/README.md
@@ -0,0 +1,74 @@
+# 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*
\ No newline at end of file