---
description: 
globs: 
alwaysApply: true
---
# 前后端多智能体协调机制
RULE 1: 每个NestJS文件必须有对应的PHP文件
RULE 2: 每个服务必须严格按admin/api/core分层
RULE 3: 每个模块职责必须与PHP项目完全一致
RULE 4: 每行代码必须基于PHP项目真实实现
RULE 5: 每个方法必须与PHP项目方法一一对应
## 协调原则

### 1. 同步开发原则
- **并行开发**: 前后端智能体并行工作，通过契约接口协调
- **契约优先**: 优先定义 API 契约，确保前后端接口一致
- **质量对等**: 前后端质量要求保持一致，测试覆盖率对等

### 2. 规范对齐原则
- **命名对齐**: 前后端命名规范保持一致，优先使用业务术语
- **结构对齐**: 前后端数据结构保持一致，DTO 与前端类型对应
- **错误对齐**: 前后端错误处理机制保持一致，错误码统一

### 3. 工具协调原则
- **版本控制**: 使用 Git 进行版本控制，前后端代码分离管理
- **CI/CD 协调**: 前后端构建流程协调，确保部署一致性
- **文档同步**: API 文档与前端类型定义同步更新

## 智能体映射关系

| 前端智能体 | 后端智能体 | 协调阶段 | 主要职责 |
|-----------|-----------|----------|----------|
| F1 FrontendAnalyzer | S1 Analyzer | 需求分析 | 页面设计与接口设计协调 |
| F2 FrontendArchitect | S2 Architect | 架构设计 | 整体架构与目录结构协调 |
| F3 FrontendInfraOperator | S3 InfraOperator | 基建接入 | 开发环境与工具链协调 |
| F4 FrontendDeveloper | S4 Developer | 功能开发 | 接口实现与页面开发协调 |
| F5 FrontendSecurityGuard | S5 SecurityGuard | 安全检查 | 前后端安全策略协调 |
| F6 FrontendQualityGate | S6 QualityGate | 质量门禁 | 代码质量与测试协调 |
| F7 FrontendAuditor | S7 Auditor | 规范审计 | 代码规范与标准协调 |
| F8 FrontendRelease | S8 Release | 发布部署 | 构建部署与版本协调 |
| F9 FrontendPerfTuner | S9 PerfTuner | 性能优化 | 性能指标与优化协调 |

## 协调检查点

### 1. 项目启动阶段
**参与智能体**: F1 + S1
**协调内容**:
- 业务需求分析与技术方案设计
- 页面功能划分与 API 接口设计
- 开发计划制定与里程碑设定

**输出产物**:
- 需求分析文档
- API 接口设计文档
- 开发计划与时间安排

### 2. 架构设计阶段
**参与智能体**: F2 + S2
**协调内容**:
- 整体架构设计与技术选型
- 目录结构设计与模块划分
- 数据流设计与状态管理方案

**输出产物**:
- 架构设计文档
- 目录结构规范
- 数据流设计文档

### 3. 基建接入阶段
**参与智能体**: F3 + S3
**协调内容**:
- 开发环境配置与工具链搭建
- 依赖管理策略与版本控制
- 构建流程设计与自动化配置

**输出产物**:
- 开发环境配置文档
- 工具链使用指南
- 构建流程文档

### 4. 功能开发阶段
**参与智能体**: F4 + S4
**协调内容**:
- API 接口实现与前端页面开发
- 数据交互逻辑与状态管理
- 业务逻辑实现与用户体验

**输出产物**:
- 功能模块代码
- API 接口文档
- 测试用例与测试报告

### 5. 质量保证阶段
**参与智能体**: F5 + S5, F6 + S6
**协调内容**:
- 安全策略实施与漏洞修复
- 代码质量检查与测试覆盖
- 性能指标监控与优化

**输出产物**:
- 安全评估报告
- 质量检查报告
- 性能测试报告

### 6. 规范审计阶段
**参与智能体**: F7 + S7
**协调内容**:
- 代码规范检查与标准对齐
- 最佳实践实施与文档完善
- 技术债务识别与重构计划

**输出产物**:
- 规范检查报告
- 最佳实践文档
- 重构计划与建议

### 7. 发布部署阶段
**参与智能体**: F8 + S8
**协调内容**:
- 构建流程协调与版本管理
- 部署策略制定与环境配置
- 发布计划执行与回滚预案

**输出产物**:
- 构建产物与部署包
- 部署配置文档
- 发布计划与回滚预案

## 协调工具

### 1. API 契约管理
- **OpenAPI/Swagger**: API 接口文档与类型定义
- **TypeScript 类型生成**: 前端类型定义自动生成
- **API 测试工具**: 接口测试与验证

### 2. 版本控制
- **Git**: 代码版本控制与分支管理
- **GitHub/GitLab**: 代码托管与协作平台
- **Git Flow**: 分支策略与发布流程

### 3. CI/CD 协调
- **GitHub Actions/GitLab CI**: 自动化构建与测试
- **Docker**: 容器化部署与环境一致性
- **Kubernetes**: 容器编排与服务管理

### 4. 项目管理
- **Jira/ZenTao**: 需求管理与任务跟踪
- **Confluence/Notion**: 文档管理与知识共享
- **Slack/钉钉**: 即时沟通与通知

### 5. 监控与反馈
- **Sentry**: 错误监控与性能追踪
- **Prometheus**: 指标监控与告警
- **Grafana**: 数据可视化与报表

## 协调流程

### 1. 日常开发协调
```
每日站会 → 任务分配 → 并行开发 → 代码审查 → 集成测试 → 部署验证
```

### 2. 版本发布协调
```
需求冻结 → 功能开发 → 集成测试 → 预发布验证 → 正式发布 → 监控反馈
```

### 3. 问题处理协调
```
问题发现 → 影响评估 → 方案制定 → 并行修复 → 验证测试 → 部署上线
```

## 协调规范

### 1. 沟通规范
- **定期同步**: 每日站会、周例会、里程碑评审
- **异步沟通**: 使用文档、评论、邮件进行异步沟通
- **紧急沟通**: 使用即时通讯工具进行紧急问题处理

### 2. 文档规范
- **API 文档**: 使用 OpenAPI 规范，及时更新
- **技术文档**: 使用 Markdown 格式，结构清晰
- **变更日志**: 记录所有重要变更，便于追溯

### 3. 代码规范
- **命名规范**: 前后端命名保持一致，使用业务术语
- **注释规范**: 关键逻辑必须有注释，便于理解
- **提交规范**: 使用规范的提交信息，便于版本管理

### 4. 测试规范
- **单元测试**: 前后端都要有充分的单元测试
- **集成测试**: 前后端集成测试，确保接口正确
- **端到端测试**: 完整的用户流程测试

## 效果评估

### 1. 开发效率指标
- **开发周期**: 从需求到上线的完整周期
- **代码质量**: 缺陷密度、技术债务比例
- **团队协作**: 沟通效率、冲突解决时间

### 2. 产品质量指标
- **功能完整性**: 需求实现程度、功能覆盖率
- **性能指标**: 响应时间、吞吐量、资源使用
- **用户体验**: 用户满意度、易用性评分

### 3. 运维指标
- **部署频率**: 发布频率、部署成功率
- **系统稳定性**: 可用性、故障恢复时间
- **监控覆盖**: 监控覆盖率、告警准确性

## 持续改进

### 1. 定期回顾
- **周回顾**: 每周进行开发回顾，识别改进点
- **月回顾**: 每月进行项目回顾，评估整体效果
- **季度回顾**: 每季度进行战略回顾，调整方向

### 2. 改进措施
- **流程优化**: 根据回顾结果优化协调流程
- **工具升级**: 引入新的工具提升协作效率
- **技能提升**: 团队技能培训与知识分享

### 3. 最佳实践
- **经验总结**: 总结成功经验，形成最佳实践
- **案例分享**: 分享典型案例，促进团队学习

- **标准制定**: 制定团队标准，确保一致性