第10章：正规开发流程 - Claude Code 教程

从需求到上线的完整开发流程：规划、开发、部署

📌 章节说明

本章价值：从需求到上线的完整开发流程，用 Plan 模式梳理需求、写文档、处理第三方对接、部署上线。

10.1 用 Plan 模式梳理需求

bash

claude
/plan

然后详细描述你的想法，Claude 会帮你：

分析需求的完整性
指出潜在的问题
建议实现方案
给出开发计划

10.2 写项目需求文档

💡 MVP 思维：不要贪多

先做最小可行产品，核心功能优先，多次迭代完善。

需求文档结构示例

项目需求文档

1. 项目概述

2. 目标用户

3. 核心功能（MVP）

4. 功能优先级

5. 技术栈选择

6. 时间计划

7. 风险评估

10.3 处理第三方对接

常见第三方对接

类型	需要准备
微信支付	商户号、API密钥、证书文件
企业微信	企业ID、应用Secret、回调地址
短信服务	AccessKey、签名、模板ID
地图服务	API Key、服务密钥

📁 文档管理

将第三方文档放入 /doc 文件夹，让 Claude Code 学习和理解：

请阅读 /doc/wechat-pay.md，帮我理解微信支付的对接流程

10.4 写技术设计文档

文档内容

前端架构设计：页面结构、路由、状态管理
后端架构设计：API设计、数据库设计、认证方式
数据库设计：表结构、索引、关系
接口设计：请求格式、响应格式、错误码

10.5 定下开发规矩

类型	内容
代码规范	命名规则、缩进、注释风格
命名规范	文件命名、变量命名、函数命名
目录结构	统一的文件夹组织方式
Git 提交	提交信息格式、分支策略

10.6 在 CLAUDE.md 中写项目规则

markdown

# 项目概述
[简述项目是做什么的]

# 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL

# 开发规范
1. 使用驼峰命名法
2. 函数名要用动词开头
3. 每个函数要有注释说明

# 注意事项
- 不要修改 config 目录下的文件
- 所有 API 调用都要加错误处理
- 提交前先运行测试

10.7 部署上线

虚拟环境配置

bash

# 用 Claude Code 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows

IP 上线查看

🔥 防火墙配置

确保开放了必要的端口：

HTTP: 80
HTTPS: 443
SSH: 22
应用端口（如 3000）

域名部署

购买域名
域名解析（A记录指向服务器IP）
配置 SSL 证书（Let's Encrypt 免费证书）
Nginx 反向代理配置

本章自检（3分钟）

点开问题查看答案，能讲清楚就算掌握。

正规开发流程里，“先写计划”为什么重要？

能把需求拆解、识别风险与依赖，避免边做边改导致返工；也更容易让团队协作。

一个好的 Plan 至少应包含哪些内容？

目标、范围、步骤、验收标准、风险与回滚方案（尤其是会改文件/部署上线时）。

第三方对接最常见的坑是什么？

接口文档不一致/鉴权问题/环境差异；要先做最小可验证请求，并记录可复现步骤。

上线前你至少要做的两件事是什么？