forked from EduCraft/curriculum-project-hub
hongjr03
b673dd1fe9
Co-authored-by: Hong Jiarong <me@jrhim.com> Co-committed-by: Hong Jiarong <me@jrhim.com>
58 lines
3.3 KiB
Lean4
58 lines
3.3 KiB
Lean4
import Spec.System.Hierarchy
|
||
import Spec.System.ProjectGroup
|
||
import Spec.System.Organization
|
||
import Spec.System.User
|
||
import Spec.System.Connections
|
||
import Spec.System.ProjectWorkspace
|
||
import Spec.System.Capacity
|
||
import Spec.System.PlatformAdministration
|
||
import Spec.System.Agent.Run
|
||
import Spec.System.Agent.AgentRole
|
||
import Spec.System.Agent.Memory
|
||
import Spec.System.Agent.AgentSurface
|
||
import Spec.System.Agent.Usage
|
||
import Spec.System.Agent.Capability
|
||
import Spec.System.Lock
|
||
import Spec.System.Permission
|
||
import Spec.System.PermissionGrant
|
||
import Spec.System.Audit
|
||
/-!
|
||
# System —— Hub 平台层契约
|
||
|
||
协作与执行的平台:项目、飞书群、AgentRun、锁、权限、审计、按需上下文。
|
||
likec4 已画出结构;这里补语义:
|
||
|
||
- `Hierarchy` —— 三层主体:平台 → 组织 → 用户。
|
||
- `User` —— 用户创建路径(管理员直接创建;飞书注册 `OPEN`)。
|
||
- `Connections` —— 外部连接:提供商枚举(当前仅飞书) + 绑定/信息类型。
|
||
- `ProjectGroup` —— project↔飞书群 1:1 长生命周期绑定(ADR-0001);群是协作空间,不持锁。
|
||
- `Organization` —— SaaS 租户(ADR-0020);project/team 单归属,TEAM grant 不跨 org;
|
||
connection secret 信封与 fail-closed resolver(ADR-0024);
|
||
owner/admin/member(`OrganizationRole`)及其管理规则(最后所有者保护)。
|
||
- `ProjectWorkspace` —— org 后台 project explorer:folder 是透明组织节点,project 仍是权限边界
|
||
(ADR-0021)。
|
||
- `Capacity` —— platform ceiling 与 org policy 的分层限制、持久 admission request 状态和
|
||
平台紧急工作负载制动(ADR-0022)。
|
||
- `PlatformAdministration` —— 独立平台身份/会话、单一管理员角色、绑定邀请、最后管理员
|
||
保护、fail-closed 平台审计与离线 emergency grant(ADR-0023)。
|
||
- `AgentRole` —— org-scoped agent 角色配置 + 技能(ADR-0017/0018)。
|
||
- `Run` —— AgentRun 状态与终止判定(状态集合完整性 OPEN)。
|
||
- `Lock` —— 锁 owner=run(ADR-0002),及"持锁者必为非终止 run"的核心不变式。
|
||
- `Memory` —— 按需上下文:锚点类别(ADR-0003)+ MCP 工具按 run/project 上下文授权。
|
||
- `AgentSurface` —— agent 执行面被 run 的工作区所界定(ADR-0018);与 Lock 正交——
|
||
Lock 限定并发,Surface 限定波及面。机制 OPEN。
|
||
- `Usage` —— Run 内 append-only 用量计量事实账本(ADR-0026);主模型 completion、
|
||
外部能力调用、代理网关旁路共用同一账本。fact 不持锁、不跨 run;`costUsd = none`
|
||
表示未知而非零(ADR-0022)。Run 上的 cost/token 标量是其 rollup cache。
|
||
- `Capability` —— 外部能力(PDF→MD、音视频→文本等)注册与调用(ADR-0027);
|
||
org-scoped 凭证连接复用 ADR-0024 信封但独立于 model-provider;调用是 Run 内副作用,
|
||
产物落 workspace,消耗记 UsageFact。capability credential 不进 Agent 进程。
|
||
- `Permission` —— read⊂edit⊂manage 角色体系、能力推导、单调性;force-release 在格外。
|
||
- `PermissionGrant` —— grant(resource×principal×role)与 settings(六 policy 旋钮)
|
||
(ADR-0004);组合规则 OPEN。
|
||
- `Audit` —— customer Project/Run 审计从简(内容 OPEN);Platform Audit 由
|
||
`PlatformAdministration` 独立承载。
|
||
|
||
标识符见 `Spec.Prelude`。决策出处:ADR-0001..0004, 0018, 0020..0027。
|
||
-/
|