# 全栈开发

## 规则（Rules）

# 全栈开发规范

## 适用对象和范围

本规范适用于所有统筹协调前后端开发的全栈开发场景。

---

## 1. 职责分离规范

**规则**：全栈开发必须遵循职责分离原则，调用专业技能完成具体开发工作，禁止直接编写后端或前端代码。

- ✅ 正确：使用 `call_agent` 调用 `nodejs_backend_developer`、`web_frontend_developer` 等专业智能体
- ❌ 错误：在 `fullstack_development` 中直接编写后端API代码或前端页面

**违反后果**：直接编写代码导致职责混乱，无法利用专业技能的最佳实践。

---

## 2. 开发顺序规范

**规则**：全栈开发必须按"后端先于前端"的顺序推进。

- ✅ 正确：先搭建后端服务 → 实现API → 开发前端 → API联调
- ❌ 错误：前端完成后才发现后端接口不匹配

**违反后果**：开发顺序颠倒导致前端反复修改，增加联调成本。

---

## 3. 联调前置规范

**规则**：禁止在未完成API联调的情况下交付功能模块。

- ✅ 正确：联调通过后再标记为"已完成"
- ❌ 错误：前端写完后不联调就交付

**违反后果**：未联调的模块存在接口不匹配风险，上线后可能出现功能异常。

---

## 4. 文档规范

**规则**：每个全栈功能模块必须生成部署指南文档。

**违反后果**：缺少部署文档导致运维人员无法正确部署和配置。

## 方法（Methods）

# 全栈开发方法

## 前置条件

- [ ] 已获取需求文档
- [ ] 已获取API接口设计文档
- [ ] 已确定前端技术栈（原生/Vue/其他）

## 流程概览

分析需求 → 搭建后端服务 → 实现后端API → 开发前端页面 → API联调对接 → 生成项目文档

## 详细步骤

### 步骤1：分析需求与接口规范
分析需求文档和API设计文档。

### 步骤2：搭建后端服务
调用后端开发能力搭建Node.js服务端。

## 技巧（Tips）

# 全栈开发技巧

## 1. 先定义接口再开发

**适用场景**：前后端并行开发时。

**具体做法**：先由架构师定义API接口规范，前后端按同一份文档开发。

**对比说明**：

| 维度 | 前后端各自定义 | 先统一接口文档 |
|------|--------------|--------------|
| 联调效率 | 反复修改 | 一次通过 |
| 一致性 | 容易不一致 | 保证一致 |

**注意事项**：接口文档应包含请求示例和响应示例，减少理解偏差。

---

## 2. 常见问题速查

| 问题 | 原因 | 解决方案 |
|------|------|---------|
| 联调时接口不匹配 | 未按接口文档开发 | 重新读取接口文档，修正代码 |
| 前端等待后端 | 后端开发滞后 | 使用mock数据先行开发 |
| 后端接口变更 | 需求变更未同步 | 更新接口文档后通知前端 |