# 开发文档

本目录承载 DiAL 的开发和维护专题。日常开发入口见 [`../../DEVELOPMENT.md`](../../DEVELOPMENT.md)，新增或修改 checker 前先阅读 [`../../CONTRIBUTING.md`](../../CONTRIBUTING.md)。

## 专题索引

| 文档                                             | 内容                                                                                              |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| [architecture.md](architecture.md)               | 项目结构、启动流程、运行时流程、HTTP 请求流程、前后端边界                                         |
| [backend.md](backend.md)                         | 后端库优先级、API 路由、共享 helpers、类型规范、配置契约、store、engine、logger、expect、错误模型 |
| [frontend.md](frontend.md)                       | React、TDesign、TanStack Query、组件、样式和前端测试规范                                          |
| [checker-development.md](checker-development.md) | 新增或修改 checker 的实现机制和完整 checklist                                                     |
| [build-release.md](build-release.md)             | 开发服务、前后端集成、构建、Docker、release、脚本、环境变量                                       |
| [testing-quality.md](testing-quality.md)         | lint、format、typecheck、test、hooks 和测试编写规范                                               |
| [../../DEVELOPMENT.md](../../DEVELOPMENT.md)     | 包管理、依赖、目录、提交、OpenSpec 和项目级约定                                                   |
| [../README.md](../README.md)                     | 文档影响分析、文档归属矩阵和按任务阅读路径                                                        |

## 事实来源

| 主题             | 事实来源                                                   |
| ---------------- | ---------------------------------------------------------- |
| 代码结构和实现   | `src/`、`scripts/`、`tests/`                               |
| 配置 schema      | TypeBox fragments、`probe-config.schema.json`、schema 测试 |
| 项目全局规则     | `openspec/config.yaml`、`DEVELOPMENT.md`、本目录专题文档   |
| checker 贡献流程 | `CONTRIBUTING.md`、`checker-development.md`                |