ZY-Agent

xuan/ZY-Agent

Fork 0

Commit Graph

Author	SHA1	Message	Date
1445043649	89fe54cc07	docs(multi-tenant): 加入汇总索引、跨文档一致性修订、Postgres 切换前移到 Stage 0 * 新增 README.zh-CN.md 汇总索引：ADR 状态表 + Stage 0-4 业务目标 / 技术路径 / 验证方式 + Stage↔ADR 对照矩阵 + 不可逆决策一览 + 用语映射 + FAQ + 阅读路径 * 新增 workspace-schema-design.zh-CN.md（Stage 0 schema 锁定版）一并入库 * 7 份 ADR 顶部加"代码命名"映射行（tenant_id ↔ workspace_id） * ADR-002 §1 加分期落地提示，明确 K8s 推迟到 Stage 3 * ADR-005 §5"第 1/2 阶段"补出与 rollout Stage 2/3 的映射 * ADR-007 §4 加 /api/v1/ 反向链接；§8 加 tid → wid 字段名映射 * headless-api §0/§7 把"SaaS + on-prem 双主线"改为"SaaS 主线、schema 兼容 on-prem" * phased-rollout 去除重复的"Go/No-Go 进入 Stage 2"段 Postgres 切换从 Stage 1 提前到 Stage 0：Stage 0 已要 ALTER 4 张表加 workspace_id，先 SQLite 再 PG 是纯返工；Stage 0 没有生产数据，迁移阻力最小。同步调整 phased-rollout / headless-api / phase-0-plan / workspace-schema-design / README 中的时间盒（Stage 0: 3-4→4-5 周；Stage 1: 10-15→8-13 周）、不可逆决策清单、PR 顺序、轨道前置依赖。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-10 21:39:58 +08:00
1445043649	ecc9339ede	docs(multi-tenant): 加入 Headless API 改造轨道（Pattern A/B）+ Stage 1 双轨修订新增 headless-api-track 文档，把 DeerFlow 作为后端服务的两种集成 pattern 全部纳入设计： - Pattern A（业务 backend 代理）：业务系统 backend 用 API key 调，浏览器走他们的 backend。覆盖 IM channels + server-to-server 集成。 - Pattern B（自研 web 浏览器直连）：业务 backend 调 /api/v1/auth/exchange-token 换 5-15 min 短期 JWT → 浏览器拿 JWT 直连含 SSE。核心 4 件事：exchange-token endpoint、ServiceTokenAuthBackend （AuthMiddleware 第三条路径）、workspaces.allowed_origins + CORS 中间件、SSE 跨域验证。 - 不做 widget / iframe（纯 API）。数据模型：service_accounts / api_keys / external_users 表（schema 在 Stage 0 末加上不阻塞）；身份模式三态（collapsed / external_passthrough / both）按 endpoint 分支。 Stage 1 改为三轨并行：付费 SaaS / Pattern A / Pattern B；时间盒从 6-10 周延到 10-15 周。Pattern B 依赖 Pattern A 完成，建议 Stage 1 末 1-2 周做。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-09 23:29:46 +08:00

Author

SHA1

Message

Date

1445043649

89fe54cc07

docs(multi-tenant): 加入汇总索引、跨文档一致性修订、Postgres 切换前移到 Stage 0

* 新增 README.zh-CN.md 汇总索引：ADR 状态表 + Stage 0-4 业务目标 / 技术路径 /
  验证方式 + Stage↔ADR 对照矩阵 + 不可逆决策一览 + 用语映射 + FAQ + 阅读路径
* 新增 workspace-schema-design.zh-CN.md（Stage 0 schema 锁定版）一并入库
* 7 份 ADR 顶部加"代码命名"映射行（tenant_id ↔ workspace_id）
* ADR-002 §1 加分期落地提示，明确 K8s 推迟到 Stage 3
* ADR-005 §5"第 1/2 阶段"补出与 rollout Stage 2/3 的映射
* ADR-007 §4 加 /api/v1/ 反向链接；§8 加 tid → wid 字段名映射
* headless-api §0/§7 把"SaaS + on-prem 双主线"改为"SaaS 主线、schema 兼容 on-prem"
* phased-rollout 去除重复的"Go/No-Go 进入 Stage 2"段

Postgres 切换从 Stage 1 提前到 Stage 0：Stage 0 已要 ALTER 4 张表加
workspace_id，先 SQLite 再 PG 是纯返工；Stage 0 没有生产数据，迁移阻力最小。
同步调整 phased-rollout / headless-api / phase-0-plan / workspace-schema-design /
README 中的时间盒（Stage 0: 3-4→4-5 周；Stage 1: 10-15→8-13 周）、不可逆决策
清单、PR 顺序、轨道前置依赖。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-10 21:39:58 +08:00

1445043649

ecc9339ede

docs(multi-tenant): 加入 Headless API 改造轨道（Pattern A/B）+ Stage 1 双轨修订

新增 headless-api-track 文档，把 DeerFlow 作为后端服务的两种集成
pattern 全部纳入设计：

- Pattern A（业务 backend 代理）：业务系统 backend 用 API key 调，
  浏览器走他们的 backend。覆盖 IM channels + server-to-server 集成。
- Pattern B（自研 web 浏览器直连）：业务 backend 调
  /api/v1/auth/exchange-token 换 5-15 min 短期 JWT → 浏览器拿 JWT 直连
  含 SSE。核心 4 件事：exchange-token endpoint、ServiceTokenAuthBackend
  （AuthMiddleware 第三条路径）、workspaces.allowed_origins + CORS
  中间件、SSE 跨域验证。
- 不做 widget / iframe（纯 API）。

数据模型：service_accounts / api_keys / external_users 表（schema 在
Stage 0 末加上不阻塞）；身份模式三态（collapsed / external_passthrough
/ both）按 endpoint 分支。

Stage 1 改为三轨并行：付费 SaaS / Pattern A / Pattern B；时间盒从
6-10 周延到 10-15 周。Pattern B 依赖 Pattern A 完成，建议 Stage 1
末 1-2 周做。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-09 23:29:46 +08:00

2 Commits