前端对接接口

API 以 Gateway 为统一入口，领域服务保留自己的 Controller 路径。请求通常携带认证 Token、租户/用户上下文和幂等键；响应使用统一包装，流式接口使用 SSE 事件而不是普通 JSON。

已有 AI 接口清单见 AI 接口清单，本目录补充跨服务契约、认证、错误和发布规则。