项目工作区模板

# 项目工作区索引

> 用于客户项目、主站批次、小程序、后端、在线工具、LiteMall 和服务器部署的统一交接入口。
> 这份索引只记录路径、状态和证据，不记录密钥、密码、Token、生产数据或高权限后台账号。

## 1. 项目身份

- 项目名称：
- 产品类型：小程序 / Java 后端 / 独立站 / 在线工具 / LiteMall / 服务器部署 / 其他
- 客户或内部负责人：
- 当前阶段：需求确认 / 开发中 / 测试中 / 待部署 / 已上线 / 维护中
- 目标上线窗口：

## 2. 资料入口

- 代码仓库和分支：
- 需求文档：
- 实施任务单：
- 验收清单：
- 部署 Runbook 或环境文档：

## 3. 范围边界

- 本期目标：
- 本期包含：
- 本期不包含：
- 后续可扩展：
- 不能触碰的业务、数据或权限边界：

## 4. 环境和访问

- 本地启动命令：
- 测试环境或预览地址：
- 生产域名或接口：
- 环境变量名称，不写值：
- 外部平台动作：Vercel / 微信平台 / DNS / 服务器 / 客户控制台

## 5. 当前执行状态

- 正在处理的任务：
- 最新提交或工作分支：
- 受影响页面、接口、数据库或部署脚本：
- 已完成：
- 阻塞项：

## 6. 验证和验收

- 本地验证命令：
- 功能验收结果：
- 边界和异常检查：
- 移动端、真机或浏览器检查：
- 未覆盖风险：

## 7. 部署和回滚

- 部署环境：
- 部署命令或控制台动作：
- 线上复查地址：
- 回滚入口：
- 需要用户手动完成的事项：

## 8. 问题和变更

- 已知问题：
- 关联问题单：
- 客户反馈：
- 最近范围变更：
- 预防动作：

## 9. 交接结论

- 下一位 AI 先读：
- 下一步动作：
- 停止规则：
- 残留风险：
- 最后更新时间和执行者：

## 10. 文档目录

- 00-project-index.md：项目索引，项目唯一入口，记录目标、状态、仓库、环境、负责人、边界和下一步。
- 01-requirement-brief.md：需求文档，保存客户原始需求、AI 需求包、开工自检结果和已确认范围。
- 02-implementation-ticket.md：实施任务单，保存任务拆分、影响面、具体文件、验收标准、回滚和交接要求。
- 03-acceptance-record.md：验收记录，保存功能、边界、移动端、数据安全、部署和人工复核结果。
- 04-deployment-record.md：部署记录，保存 Runbook、部署命令、环境变量名称、域名、回滚方式和线上验证。
- 05-release-record.md：发布记录，保存提交范围、本地验证、部署状态、线上复查、残留风险和下一步。
- 06-issue-log.md：问题记录，保存客户反馈、Bug、生产事故、小程序审核失败和回归结果。
- 07-handoff.md：交接日志，保存当前状态、最近提交、未完成事项、阻塞原因和下一位 AI 阅读顺序。

## 11. 质量检查

- 工作区索引必须能指向需求、任务、验收、部署、发布和交接资料。
- 当前阶段、最新提交、阻塞项和下一步动作必须明确，不能只写“继续优化”。
- 环境变量只写名称，不写 token、密码、数据库连接串或客户私密资料。
- 部署状态、本地验证和线上复查要分开记录。
- 换 AI 或暂停任务前，必须更新交接结论和下一位 AI 的阅读顺序。

## 12. 停止规则

- 没有需求来源或范围边界时，不能直接进入开发。
- 没有实施任务单时，不能把大需求拆成随意改代码。
- 没有验收证据时，不能说交付完成。
- 没有部署记录或线上复查时，不能说生产已更新。
- 不能把密钥、Token、后台账号、支付配置、真实订单、手机号或客户数据写进公开仓库。