docs: 同步开发文档至代码最新状态
This commit is contained in:
@@ -42,6 +42,7 @@ AI 工具必须严格遵守以下全部约束。
|
||||
| `src/server/` | 后端,禁止 import src/web/ |
|
||||
| `src/server/db/` | 数据库层:schema、connection、migration、DAO |
|
||||
| `src/server/ai/` | AI Provider Registry + Agent + 工具 |
|
||||
| `src/server/config/` | 配置子系统:types、variables、issues、schema |
|
||||
| `src/server/helpers/` | 跨路由工具:响应格式化、URL 拼接 |
|
||||
| `src/server/middleware/` | 参数校验 + 错误处理中间件 |
|
||||
| `src/web/` | 前端,禁止 import src/server/ 运行时实现 |
|
||||
@@ -54,7 +55,8 @@ AI 工具必须严格遵守以下全部约束。
|
||||
### 类型与配置
|
||||
|
||||
- 共享类型唯一源头:`src/shared/api.ts`;应用常量唯一源头:`src/shared/app.ts`;版本号唯一源头:`package.json`。
|
||||
- 配置加载流程:unknown → AuthoringConfig → NormalizedConfig → ValidatedConfig → ServerConfig。
|
||||
- 配置加载流程:unknown → AuthoringConfig → NormalizedConfig → ValidatedConfig → ResolvedConfig。
|
||||
- 配置系统入口:`src/server/config.ts`(统一配置加载、运行时校验、默认值解析)。
|
||||
- Ajv 严格拒绝模式:不类型转换、不注入默认值、不删除未知字段。
|
||||
- 新增/修改配置字段必须同步更新 TypeBox schema、`config.schema.json`、测试和用户文档。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user