# 开发全栈

## 规则（Rules）

# 全栈开发规范

## 1. 后端先于前端

开发顺序：先搭建后端服务 → 实现API → 开发前端 → API联调。

✅ 后端API完成后才开发前端页面
❌ 前端写完后发现后端接口不匹配，全部重改

## 2. 联调前置

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

✅ 联调通过后再标记"已完成"
❌ 前端写完后不联调就交付，上线后接口报错

## 3. 职责分离

全栈开发应调用专业技能完成具体工作，禁止直接编写后端或前端代码。

✅ 使用 `call_agent` 调用专业智能体
❌ 在fullstack_development中直接写API代码

## 方法（Methods）

# 全栈开发方法

## 步骤

### 1. 分析需求
分析需求文档和API设计文档。

### 2. 搭建后端
调用后端开发能力，根据API设计文档搭建服务端。

### 3. 实现API
调用后端开发能力实现API接口。

### 4. 开发前端
根据技术栈选择对应开发方式。

### 5. API联调
完成前后端联调对接。

### 6. 生成部署文档
生成部署指南文档。

## 技巧（Tips）

# 全栈开发技巧

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

前后端按同一份接口文档并行开发，减少联调时的返工。

| 维度 | 各自为政 | 统一接口文档 |
|------|---------|------------|
| 联调效率 | 反复修改 | 一次通过 |
| 一致性 | 容易不一致 | 保证一致 |

## 2. 常见问题

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