Compute Hub 信息架构 · Golang 技术拆分
← 返回交互原型

信息架构 & 技术拆分

一期聚焦 Seedance。产品侧把年框变成可申请、可计量、可分账的资产；工程侧用 Go 拆成 gateway / admin-api / worker 三进程，官方密钥不出域。

Phase 1 · Seedance Go 1.22+ PostgreSQL Redis NATS/Kafka
原则：业务系统只拿平台 API Key；计量归属「申请单」；账单按「成本归属」聚合（Key 可轮换不影响出账）。

1. 信息架构（站点地图）

工作台总览 / 待办
→
算力资产合约·SKU·池
→
申请团队·业务
→
审批锁定额度
→
凭证平台 Key
用量统计多维计量
→
成本核算独立账单
｜
渠道接入飞书 / OpenAPI
｜
告警风控阈值 / 熔断

2. 核心对象链

Contract500 万年框
→
QuotaPool内 / 伙伴 / 预留
→
Application申请单
→
APIKey平台凭证
→
UsageEvent任务计量
→
Invoice月账单

3. 运行时拓扑（Golang）

接入层
业务系统 / SDK
Web 控制台
飞书审批
伙伴后台
Go 进程
gateway :8081
admin-api :8080
worker
基础设施
PostgreSQL
Redis 限流
NATS/Kafka
火山方舟 Seedance

gateway · 热路径

鉴权平台 Key → 配额预扣 → 代理方舟异步任务 → 写用量事件。官方密钥仅此进程可见。

cmd/gateway

admin-api · 管理面

资产、申请审批、凭证、账单预览、渠道与风控规则配置。

cmd/admin-api

worker · 异步

任务终态回补、日聚合、月账单、官方对账、告警派发。

cmd/worker

4. Go 包拆分

包职责优先级
internal/asset年框、SKU、额度池锁定P0
internal/application申请单状态机、审批发卡P0
internal/accessAPI Key 签发 / 哈希 / 吊销P0
internal/gateway代理、限流、预扣回滚P0
internal/meteringUsageEvent 与聚合P0
internal/billing内部价、Invoice、官方差异P1
internal/channel飞书 / OpenAPI 渠道P1
internal/volcano方舟 SDK 封装P0
internal/risk阈值告警与熔断P1
pkg/money分精度金额，避免浮点—

5. 一次调用时序

业务系统Bearer 平台 Key
→
gateway鉴权+预扣
→
火山方舟create task
→
MQusage.pending
→
worker终态确认
→
Invoice按 cost_center

6. 落地顺序

迭代交付验收
M1申请/审批 + 发卡 + 池锁定审批通过即有 Key，额度从池扣减
M2gateway 代理 Seedance + 计量事件调用 100% 过网关，可按申请方查用量
M3worker 聚合 + 月账单导出财务可按成本归属下载明细
M4飞书渠道 + 告警熔断额度用尽硬拒绝，阈值可触达

7. 仓库位置