相关文档
| 内容 | 位置 | 说明 |
|---|---|---|
| 仓库总览 | README.md | 技术栈、模块、规范、启动与部署的速查版；细节以本站为准 |
| 开发者文档站（本站） | docs/developer-docs | VuePress，架构 / 技术栈 / 目录 / 开发指南 / 部署 |
| 图表语法与样例 | 图表语法 | Mermaid 围栏（流程图 / 泳道图 / 时序图 / 状态图 / ER 图 / 思维导图 / 饼图 / 象限图 / 甘特图）与金字塔围栏 |
| 平台文档站 | docs/docs | VuePress，面向使用者：平台简介、第三方账号登录配置、开放 API |
| 接口文档工程 | docs/api | Vite + Scalar，在线渲染 OpenAPI |
| 全量数据库 DDL | docs/developer-docs/docs/public/1-ddl.sql | 表结构唯一来源，人工执行 |
| 渠道接口对接文档 | asone-server/asone-module-channel-report/docs/ | 9 份渠道 API 说明（Adsentri、alldata、caige、Deer、IDG、yangyangdeyi、zeyao、ZS-paak4、ZY-KE11） |
| 编码与流程规则 | .trae/rules/ | 注释、提交信息、禁用 record、禁止过期 API、数据库只读、xxl-job 边界、文档同步 |
| 部署入口与凭据 | .trae/rules/deployment.md | 服务器、账号、容器拓扑与验证命令；该文件不入库、内容不进任何文档 |
| 流水线定义 | flow.yaml | 云效 Flow 变更检测、镜像构建、部署、健康检查、清理 |
| 后端接口文档（运行期） | http://localhost:8001/swagger-ui.html、/v3/api-docs/asone-server | springdoc-openapi，前端 pnpm openapi 的数据源 |
| XXL-JOB 调度中心 | https://xxl-job-admin.asone.club/ | 任务登记、执行器分组与注册 Token 配置入口 |
冲突时以谁为准
文档描述与实际代码不一致时，以代码与 .trae/rules/ 为准，并按文档同步规则修正文档。