chore: sync changes for v0.1.1

.cursor/rules/aifont.mdc

@@ -0,0 +1,224 @@
+---
+description: 
+globs: 
+alwaysApply: true
+---
+# 前后端多智能体协调机制
+
+## 协调原则
+
+### 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. 最佳实践
+- **经验总结**: 总结成功经验，形成最佳实践
+- **案例分享**: 分享典型案例，促进团队学习
+
+- **标准制定**: 制定团队标准，确保一致性