# AI 智能体开发指南

## 目标
- **统一规范**: 用 NestJS 的方式实现，与 PHP 业务/数据100%对齐。
- **智能体协作**: 多个智能体基于同一规则、流程与工具偏好执行任务。
- **前后端协调**: 前后端智能体协调开发，确保一致性。

## 文档导航

### 后端开发
- 工作流程: ./workflow.md
- 工具偏好: ./tooling.md
- 规则规范: ./rules.md
- 执行清单: ./checklists.md
- 基础能力集成: ./integration.md
- 架构映射: ./mapping.md
- 开发规划: ./planner.md

### 前端开发
- 前端工作流: ./frontend-workflow.md
- 前后端协调: ./coordination.md
- 协调示例: ./coordination-example.md

### 适用范围
- 仓库: `wwjcloud/` 主后端及 `admin/apps/*` 示例
- 模块: `common/*`, `core/*`, `config/*`, `vendor/*`
- 前端: `admin/apps/web-antd/` Ant Design Vue 项目

### 约定
- 管理端路由: `/adminapi/{module}/...`
- 前台端路由: `/api/{module}/...`
- 配置表: `sys_config.value(JSON)`，禁止使用不存在字段（如 `config_value`, `app_type`）
- 前端路由: 按模块组织，支持懒加载
- 组件命名: PascalCase，语义化命名
- 页面结构: 主页面使用 Page 组件，子组件放在 modules 目录
- 测试规范: 单元测试放在 `__tests__/unit/` 目录，覆盖率 ≥ 80% 