vibe-coding-production

# 上线准备：从 demo 到正式系统

这是 **vibe-coding-kit** 里负责"上线"的 Skill。只想验证想法的人用不到它——决定把项目做成能长期运行、给别人用的正式系统时，再来。

> 前置：先用 `vibe-coding-requirements` 说清需求、`vibe-coding-architecture` 选好技术。开发全程配合 `vibe-coding-survival` 避坑。

每个环节都配了**直接发给 AI 的话术**和**你用来验收的标准**——你不需要会写代码，只需会问、会检查。

---

## 一、开发规范

把下面四段整理成一份"规范说明"，每次让 AI 写代码时贴上，确保风格一致、日后好维护。

### 1.1 Git 分支策略（最简版）
```
main 分支          ← 永远是能稳定部署的版本
  └── dev 分支     ← 日常开发，AI 写的代码先合到这
        └── feat/xxx 分支  ← 每个新功能开一个，做完合回 dev
```
> "每次写新功能时，顺便告诉我：① 该建什么分支名 ② commit message 写什么。"

（完全不用 git 也没关系，但至少要做 `vibe-coding-survival` 里的"保住能用的版本"——那是 git 的朴素替代。）

### 1.2 日志规范
> "所有关键操作必须打日志，格式统一为 `[时间] [级别] [模块] 内容`。级别分三级：INFO（正常流程）、WARN（异常但能自动恢复）、ERROR（需我人工处理）。至少记录：请求进入、鉴权结果、数据库操作、外部调用、返回结果。卡密、密码等敏感信息脱敏，只显示前 4 位和后 4 位，中间用 *** 代替。"

### 1.3 错误处理规范
> "所有可能出错的地方都要显式处理。错误信息必须含三要素：① 哪里出错（模块/函数名）② 为什么出错（具体原因）③ 建议怎么解决。绝不要把错误悄悄吞掉（catch 了却什么都不做）。"

### 1.4 代码风格
> "代码注释用中文。每个函数上方注释说明：这函数做什么、输入什么、输出什么。变量名和函数名用英文，但要见名知意。"

---

## 二、安全基线

逐条把要求提给 AI，再逐条确认它做没做到。

| # | 安全要求 | 对 AI 说的话 |
|:-:|---------|-------------|
| 1 | 鉴权 | "所有接口都要验证身份，没通过的直接拒绝，返回 401。" |
| 2 | 防暴力破解 | "同一 IP 连续失败 N 次后，锁定 M 分钟。" |
| 3 | 输入校验 | "所有用户输入都要校验和清理，防止注入攻击。" |
| 4 | HTTPS | "生产环境必须用 HTTPS。" |
| 5 | 敏感信息保护 | "密钥、密码用环境变量或配置文件读取，绝不写死在代码里。" |
| 6 | 日志脱敏 | "敏感数据在日志里脱敏。" |
| 7 | 最小权限 | "数据库连接用最小必要权限，不要用 root。" |
| 8 | 错误信息 | "对外返回的错误信息不要暴露内部实现细节。" |

> **开源专属提醒：** 把代码公开（push 到 GitHub 等）之前，务必再确认一遍：代码里、配置里、提交历史里，**没有任何密钥、密码、token**。一旦推到公开仓库，就当全世界都看到了——即使事后删除也来不及，必须立刻作废并更换那个密钥。最稳妥的做法是把密钥放进一个单独的配置文件，并让 AI 帮你把它加进 `.gitignore`（让 git 永远忽略它）。

**注意红线：** 涉及真实收付款、存别人的个人信息等，别独自硬上——见 `vibe-coding-survival` 的「红线」。

---

## 三、部署策略

> "告诉我完整的部署步骤，每步用一句话说明为什么需要它。包括：① 服务器要装哪些依赖（运行环境、数据库等）② 文件放哪个目录 ③ 配置文件放哪 ④ 怎么启动服务 ⑤ 怎么设置开机自启 ⑥ 怎么看日志 ⑦ 怎么更新版本（停旧启新的流程）。"

**输出物：** 部署步骤清单。

---

## 四、测试验收

你不用写测试代码，但要有一份能逐条手动验证的清单。

> "给我一份功能验收清单，列出所有场景，我逐条手动验证。包括：① 正常流程的每个步骤 ② 异常情况（无效输入、超时、资源不足）③ 边界情况（空值、极限值）。"

每一条都要你**亲手跑通**才算过，不是 AI 说过就过（参见 `vibe-coding-survival` 的"让 AI 证明给你看"）。

**输出物：** 功能验收清单（可逐条打勾的 Checklist）。

---

## 五、文档要求

让 AI 每次写完代码都配套产出说明，免得过几天就忘了哪是哪。

> "每次代码修改完成后，给我一份简短说明：① 新增/修改了哪些文件 ② 每个文件做了什么（一句话）③ 怎么验证功能正常 ④ 有什么要注意的（配置改动、新增依赖等）。"

把这些汇总进你的「项目说明书」（模板见仓库 `examples/项目说明书-模板.md`）。

---

## 上线前最终检查清单

- [ ] 需求基准描述、技术栈、目录结构都记在项目说明书里
- [ ] 安全基线 8 条逐条确认
- [ ] 代码/历史里没有任何密钥、密码（尤其要开源时）
- [ ] 部署步骤亲手走通一遍
- [ ] 功能验收清单逐条打勾
- [ ] 留了一个"能用版"备份
- [ ] 涉及钱/别人隐私的部分，已找人把关或已确认不涉及