架构设计与隐私流水线
Yearning v4 在底层放弃了多进程 RPC 耦合与本地状态假设,采用 无状态 Go 模块化单体 + PostgreSQL 共享协调 架构,保证在高并发审批、批量预审与 Kubernetes 多副本部署下的一致性与零泄漏边界。
核心技术栈
端到端数据流与隐私边界
关键架构不变量
1. 角色分离与不可越权(admin_is_not_business_override)
- 平台严格隔离 管理面(
/admin/*,由内置admin及role='admin'管理员管理)与 业务面(工单提交、审批、执行、SQL 原文查看与在线查询,由权限组与冻结流程决定)。 - 任何管理员均不可修改已提交工单的冻结审批链,不能代审、代执行、转交、加签或越权查看未授权工单的 SQL 明文。
2. 六用途分域 AEAD 密钥环与 AAD 防替换
Yearning v4 的 keyring.json 强制分离 6 个密码学用途域,避免单密钥复用风险:
所有落盘密文均将 deployment_id + 表名 + 主键 + 列名 + purpose 绑定至 AES-256-GCM 的 AAD(附加认证数据),从密码学层面阻断跨表、跨记录密文替换攻击。
3. 双轨 AI 隐私隔离与跨轨道防回退
default轨道与san轨道分别绑定PrivacyContractHashDefault与PrivacyContractHashSAN,并参与PlanHash计算。- 在混合主备 Provider 链中,系统在每次发送前针对具体目标端点独立构造 System Prompt 与载荷:为
san本地模型准备的原始 SQL 载荷绝不会在故障转移时泄漏给default公有云模型。
4. 事务 Outbox 与实时 SSE 广播总线
- 所有工单状态变更、审批决策、执行进度与查询授权撤销均与业务表在同一 PostgreSQL 事务内写入 Outbox 事件,确保通知投递与审计记录不丢不重。
- 已认证前端与外部客户端可通过单条长连接
GET /api/v4/events/stream(Accept: text/event-stream,25 秒: keepalive心跳)接收参与者隔离的io.yearning.v4.*实时元数据事件,帧内绝不包含原始 SQL 或审批自由文本。