跳到主要内容

架构与状态

设计方向

项目将控制台、身份与 API Token、模型网关、支付接入和额度账本划分为不同职责。 认证、支付、链上观察和重试必须保留权限边界、精确金额、幂等及审计证据。

区域当前文档能说明什么
控制台可运行的 UI 演示、共享组件与状态
身份与权限有架构提案;不能把演示登录当作已实现认证
支付与账本接入准备中;不能混用旧充值设计与新的支付契约
模型网关尚无已核验的生产服务或模型清单
应用部署生产入口尚未核实;不提供可执行的生产发布承诺

契约依据

持久化、账本串行化、计价与幂等、链上观察、Secrets、部署和身份分别由仓库 docs/adr/ 中的 ADR-001 至 ADR-007 记录。 它们的状态与后续已接受修订共同决定实现边界,不因本文发布而改变。

支付接入准备以 DolphinPay 当前版本为背景;具体参数与启用条件需在接入验收后发布。 这里不列举未确认的币种地址、套餐换算或账户标识。

维护本文档

公开页面位于 docs/site/content/。在 docs/site/ 运行:

npm ci
npm run build

这只生成静态文档到 build/。Cloudflare Pages 文档项目与应用隔离, 不包含 API、D1、Secrets 或链上部署。文档站发布与回滚说明见同目录 README.md