服务边界与数据

约 485 字大约 2 分钟

服务按业务域拆分，由 Gateway 负责对外路由。各业务服务只处理自己的领域逻辑，并通过内部鉴权调用 user-service 完成用户/权限验证。

服务职责

服务	职责
user-service	用户、登录、身份与内部授权验证。
generation-service	生成异步任务、上游调用编排、轮询与结果回调。
ai-control-service	提供商、模型、渠道、分组、价格与成本配置。
media-service	上传资产、媒体引用、对象存储及可选媒体分析。
workspace-service	工作区、项目、画布、节点、资产目录与画布操作。
workflow-service	工作流项目与编排相关业务。
billing-service	商品、套餐、积分、订单、支付与权益履约。
platform-config-service	平台级配置聚合。
story-service	故事、结构、场景、镜头和脚本生产数据。
agent-service	Agent 任务执行、项目上下文和可选 RAG 能力。
gateway	统一入口、路由与服务间边界。

数据库规则

MySQL 迁移目录 database/migrations/mysql 是当前支持的 schema 来源。
db-migrate 是唯一允许在生产执行 DDL 的进程。
业务时间字段使用 DATETIME(3)；不要改用 TIMESTAMP 或字符串。
新迁移使用 UTC 时间戳，提供 .up.sql 与 .down.sql 成对文件。
已合并或已部署的迁移不可修改。需要修复时新增前向迁移。

测试与变更原则

对 API 合同变化添加服务级测试。
对画布、任务、计费等跨服务行为，验证请求进入 Gateway 后的完整链路。
对数据库变更执行 database 目录下的测试与 vet。
接口错误对用户返回稳定、可理解的信息；SQL、驱动、密钥和内部堆栈仅写入服务日志。