# 前后端智能体协调示例

## 示例：用户管理模块开发

### 阶段一：需求分析与架构设计（F1+S1, F2+S2）

#### F1 FrontendAnalyzer + S1 Analyzer 协调
```yaml
需求分析会议:
  参与者: F1, S1
  时间: 项目启动第1天
  输出:
    - 用户管理功能需求
    - 用户列表、新增、编辑、删除功能
    - 用户角色分配功能
    - 用户状态管理功能

API 接口设计:
  后端 S1 输出:
    - GET /adminapi/user/list - 用户列表
    - POST /adminapi/user/create - 创建用户
    - PUT /adminapi/user/update - 更新用户
    - DELETE /adminapi/user/delete - 删除用户
    - POST /adminapi/user/assign-role - 分配角色
    - PUT /adminapi/user/update-status - 更新状态

  前端 F1 输出:
    - 用户列表页面组件结构
    - 用户表单组件结构
    - 角色分配弹窗组件
    - 状态切换组件
```

#### F2 FrontendArchitect + S2 Architect 协调
```yaml
架构设计评审:
  参与者: F2, S2
  时间: 项目启动第2天
  输出:
    - 数据模型设计
    - 组件接口定义
    - 状态管理方案
    - 权限控制方案

数据模型对齐:
  后端 S2 输出:
    ```typescript
    interface User {
      id: number;
      username: string;
      email: string;
      status: UserStatus;
      roles: Role[];
      createTime: Date;
      updateTime: Date;
    }
    ```

  前端 F2 输出:
    ```typescript
    interface UserFormData {
      username: string;
      email: string;
      password?: string;
      roleIds: number[];
    }
    ```
```

### 阶段二：基建接入与开发（F3+S3, F4+S4）

#### F3 FrontendInfraOperator + S3 InfraOperator 协调
```yaml
基建接入:
  后端 S3 输出:
    - 用户模块数据库表结构
    - 用户认证中间件
    - 用户权限守卫
    - 用户相关配置

  前端 F3 输出:
    - 用户管理路由配置
    - 用户状态管理 Store
    - 用户相关 API 封装
    - 用户权限指令
```

#### F4 FrontendDeveloper + S4 Developer 协调
```yaml
并行开发:
  后端 S4 开发:
    - UserController 实现
    - UserService 业务逻辑
    - UserRepository 数据访问
    - 用户相关 DTO 定义

  前端 F4 开发:
    - UserList.vue 用户列表页面
    - UserForm.vue 用户表单组件
    - UserStore.ts 用户状态管理
    - UserApi.ts 用户 API 调用

接口联调:
  时间: 开发第3天
  内容:
    - API 接口联调测试
    - 数据格式验证
    - 错误处理测试
    - 权限控制测试
```

### 阶段三：质量保障与部署（F5-S9 + S5-S9）

#### F5 FrontendSecurityGuard + S5 SecurityGuard 协调
```yaml
安全检查:
  后端 S5 检查:
    - 用户输入验证
    - SQL 注入防护
    - 权限越权检查
    - 敏感信息保护

  前端 F5 检查:
    - 表单数据验证
    - XSS 防护
    - 权限控制实现
    - 敏感信息处理
```

#### F6 FrontendQualityGate + S6 QualityGate 协调
```yaml
质量检查:
  后端 S6 检查:
    - 单元测试覆盖率 ≥ 80%
    - 集成测试通过
    - 代码规范检查通过
    - 性能测试通过

  前端 F6 检查:
    - 组件测试覆盖率 ≥ 80%
    - E2E 测试通过
    - ESLint 检查通过
    - TypeScript 类型检查通过
```

#### F7 FrontendAuditor + S7 Auditor 协调
```yaml
规范审计:
  后端 S7 审计:
    - 代码规范检查
    - 架构合规性检查
    - 文档完整性检查
    - 安全规范检查

  前端 F7 审计:
    - 组件规范检查
    - 代码风格检查
    - 性能规范检查
    - 用户体验检查
```

#### F8 FrontendRelease + S8 Release 协调
```yaml
部署协调:
  后端 S8 部署:
    - 构建 Docker 镜像
    - 部署到测试环境
    - 数据库迁移
    - 配置更新

  前端 F8 部署:
    - 构建生产版本
    - 部署到 CDN
    - 更新路由配置
    - 版本标签管理
```

#### F9 FrontendPerfTuner + S9 PerfTuner 协调
```yaml
性能优化:
  后端 S9 优化:
    - 数据库查询优化
    - 缓存策略优化
    - 并发处理优化
    - 监控指标优化

  前端 F9 优化:
    - 组件懒加载
    - 图片资源优化
    - 包体积优化
    - 渲染性能优化
```

## 协调工具使用示例

### 1. API 契约管理
```yaml
OpenAPI 文档:
  ```yaml
  /adminapi/user/list:
    get:
      summary: 获取用户列表
      parameters:
        - name: page
          in: query
          type: integer
        - name: pageSize
          in: query
          type: integer
      responses:
        200:
          description: 成功
          schema:
            type: object
            properties:
              items:
                type: array
                items:
                  $ref: '#/definitions/User'
              total:
                type: integer
  ```
```

### 2. 代码仓库管理
```yaml
分支策略:
  - main: 主分支，生产环境代码
  - develop: 开发分支，集成测试
  - feature/user-management: 功能分支，用户管理功能
  - hotfix/*: 热修复分支

合并策略:
  - 功能分支 → develop: 代码审查后合并
  - develop → main: 测试通过后合并
  - 热修复 → main: 紧急修复直接合并
```

### 3. 持续集成/部署
```yaml
CI/CD Pipeline:
  后端流程:
    - 代码检查 (ESLint, TypeScript)
    - 单元测试
    - 集成测试
    - 构建 Docker 镜像
    - 部署到测试环境

  前端流程:
    - 代码检查 (ESLint, TypeScript)
    - 单元测试
    - E2E 测试
    - 构建生产版本
    - 部署到 CDN
```

## 协调效果评估

### 开发效率指标
```yaml
开发周期:
  - 需求分析: 2天
  - 架构设计: 1天
  - 功能开发: 5天
  - 测试联调: 2天
  - 部署上线: 1天
  总计: 11天

代码质量:
  - 后端测试覆盖率: 85%
  - 前端测试覆盖率: 80%
  - 代码规范通过率: 100%
  - 安全扫描通过率: 100%
```

### 协作效果指标
```yaml
沟通效率:
  - 协调会议: 每周2次
  - 问题解决时间: 平均2小时
  - 冲突解决时间: 平均4小时
  - 团队满意度: 90%

协调成本:
  - 协调会议时间: 每周4小时
  - 文档维护时间: 每周2小时
  - 工具使用时间: 每周1小时
  总计: 每周7小时
```

### 项目质量指标
```yaml
功能完整性:
  - 需求实现率: 100%
  - 功能测试通过率: 100%
  - 用户验收通过率: 95%

性能指标:
  - 页面加载时间: < 2秒
  - API 响应时间: < 500ms
  - 并发用户数: 1000+

稳定性指标:
  - 系统可用性: 99.9%
  - 错误率: < 0.1%
  - 平均故障恢复时间: < 30分钟
```

## 最佳实践总结

### 1. 协调原则
- **契约优先**: 先定义 API 契约，再并行开发
- **同步开发**: 前后端同时启动，定期同步
- **质量对等**: 前后端质量要求一致

### 2. 沟通机制
- **定期会议**: 每周协调会议
- **即时沟通**: 重要问题即时沟通
- **文档记录**: 重要决策文档记录

### 3. 工具使用
- **API 契约**: OpenAPI/Swagger
- **代码管理**: Git + 分支策略
- **持续集成**: CI/CD Pipeline
- **项目管理**: Jira/禅道

### 4. 质量保障
- **测试覆盖**: 前后端测试覆盖率 ≥ 80%
- **代码规范**: 统一的代码规范
- **安全扫描**: 定期安全扫描
- **性能监控**: 持续性能监控 