数据库结构
PostgreSQL 数据表
users
平台核心用户身份资料表。
建议的 JSONB 扩展字段:
tagspreferences
teams
组织架构兼容数据表(含可选 JSONB 元数据)。新部署应将其视为公司与部门层级的组织架构表;历史遗留的 team 主体标识与绑定表名作为兼容别名保留。
建议的关系型字段:
parent_idorg_pathsourceexternal_id
projects
绑定到组织单元与交付环境的项目作用域表。
roles
系统内置角色与自定义角色表,使用 JSONB 存储权限与能力描述符。
user_role_bindings
用户与角色的绑定关系表。管理员在本地手工分配的绑定保持 source = local;登录阶段自动补充的外部角色绑定会将 source 设为登录源类型,并将 provider_id 设为对应登录源 ID。replace_external 登录同步模式仅允许替换相同 user_id + source + provider_id 组合下的记录。
user_team_bindings
用户与组织的成员绑定关系表。表名保留 team 以兼容存量模型,实际运行时语义为组织成员关系。本地手工分配保持 source = local;OIDC、OAuth2、飞书、钉钉与企业微信登录映射写入带 source 和 provider_id 的外部托管记录,以便仅针对外部来源执行替换更新。
policies
基于属性的访问控制(ABAC)策略定义表。JSONB 字段承载:
- 主体匹配规则(
subject matcher) - 目标资源匹配规则(
target matcher) - 附加条件表达式(
conditions) - 允许或拒绝的动作列表(
action list)
clusters
集群注册表元数据与健康状态快照表。
JSONB 字段承载:
labelscapabilitieshealth_snapshot
cluster_credentials_meta
集群连接凭据元数据表(首阶段基线不直接裸存敏感明文凭据)。
JSONB 字段承载:
- 提供商连接元数据
- 认证插件配置项
announcements
系统公告目录表,包含发布生命周期状态、目标受众元数据与生效时间窗口字段。
announcement_receipts
面向已发布公告的用户级已读回执表。
audit_logs
只追加(append-only)的持久化安全审计日志表。
JSONB 字段承载:
request_metatarget_metadecision_meta
operation_logs
面向变更类业务流程的操作任务记录表。
核心字段包含操作者上下文、请求上下文,以及由后端统一生成供前端格式化展示的 target_scope JSON 结构。
AI Gateway 凭据与策略表
面向 AI 原生外部接入的凭据、策略与审计数据持久化在以下表中:
personal_access_tokensservice_accountsservice_account_tokensai_clientsai_access_policiesmcp_tool_grantsai_gateway_skill_bindingsai_gateway_audit_logs
令牌表仅存储哈希值与显示前缀;明文令牌仅在创建或轮换时一次性返回,严禁写入日志或在调用方自有凭据存储之外落盘。
mcp_tool_grants 支持 user、service_account、role、team(组织)与 ai_client 五类主体。运行时评估会合并命中的个人/服务账号、组织、角色与客户端授权记录,并在 permissionKeys 基础上执行“拒绝优先 + 允许白名单”语义。
ai_access_policies 与 ai_gateway_skill_bindings 复用相同的主体模型:访问策略按工具名称模式、技能 ID、风险等级与裁决动作收敛可用工具和技能;技能绑定进一步收敛暴露的技能与能力引用。这两张表都只能收窄访问范围,不能放大既有的 RBAC 或资源范围授权。
event_stream
统一事件信封持久化表。
JSONB 字段承载:
resource_refpayload- 关联追踪上下文(
correlation data)
build_records
构建历史记录与构建工作节点回传的产物元数据表。
核心元数据字段包括:
applicationEnvironmentIdbuildSourceIdartifactimagevariablestriggeredByWorkflowRunId
deploy_records
部署与发布历史记录表。
核心元数据字段包括:
applicationEnvironmentIdactionKindpreviousImageimageimageTag
application_build_sources
应用维度的多构建来源注册表。
build_templates
平台统一托管的 Dockerfile 与构建命令模板表。
release_bundles
面向跨环境晋级与合规审计的不可变交付制品包表。
execution_tasks
执行平面任务记录表,统一跟踪构建、部署、健康核验与异步回调驱动的运行器任务。
execution_logs
按执行任务隔离持久化的详细运行日志表,与构建/发布摘要表解耦存储。
execution_callbacks
运行器回调记录表,用于审计并推进 execution_tasks 状态流转。
virtualization_connections
虚拟化工作台的 KubeVirt 与 PVE 连接注册表。PVE 敏感凭据仅加密存储在 encrypted_credential 列中;API 响应只暴露 credentialConfigured 标识,绝不返回明文。
virtualization_vms
按提供商、连接实例与外部唯一标识建立索引的虚拟机同步资产表。
virtualization_images
从 KubeVirt CDI/PVC 来源或 PVE 模板、ISO 与存储卷同步发现的镜像与模板资产表。
virtualization_flavors
由 soha 托管或从底层虚拟化提供商同步发现的标准虚拟机实例规格目录表。
virtualization_tasks
承载 vm_create、vm_action 与 asset_sync 操作的虚拟化专用任务队列表,不与应用交付领域的 execution_tasks 混用。
virtualization_task_logs
虚拟化生命周期操作与资产同步任务的专属日志表。
workflow_approvals
挂起工作流运行的人工审批裁决记录表,其扩展元数据支持将应用交付工作流审批关联回 AI Gateway 审批请求。
notification_channels
面向邮件、Webhook、即时通讯群组或事件响应平台的通知渠道配置表。
PostgreSQL 存储边界
当数据满足以下任一特征时应持久化到 PostgreSQL:
- 需要跨进程重启的数据持久性
- 需要多维关系型条件检索
- 需要明确的合规留存周期管理
- 需要可追溯的安全与业务审计证据
瞬态界面交互状态、单次请求级缓存与实时流式扇出缓冲应保留在进程内存中,或收敛到明确的持久化任务表与事件表中,不在缺少明确业务诉求时引入额外的外部状态依赖。