# 项目启动检查单

> 文件命名:`docs/00-tracking/project-kickoff-checklist.md` 或按日期 `docs/00-tracking/kickoff-YYYYMMDD.md`。进入编码前必须完成本检查单;用户未明确给出时,AI 须以「默认方案 + 请纠正」形式披露并留痕。

## 项目基本信息

| 字段 | 值 |
|---|---|
| 项目名称 | |
| 应用类型与规模 | 后台管理面板 / 门户 / 小程序 / 其他;约 N 页面 / N 接口 |
| 目标阶段 | ①需求挖掘 / ②设计建模 / ③制作编码 / ④交付验收 |
| 启动日期 | YYYY-MM-DD |
| 预计交付日期 | YYYY-MM-DD |

## 一、资源与凭据

### 1.1 部署与运行环境

| 检查项 | 用户输入 | AI 默认方案 | 留痕/备注 |
|---|---|---|---|
| 部署模式 | □ 平台托管(Fmode) / □ 自建 server.ts / □ 本地 demo / □ 其他:____ | | |
| 是否需要 Docker | □ 是 / □ 否 | | |
| 目标浏览器/设备 | 桌面 / 移动端 /  both | | |

### 1.2 数据库

| 检查项 | 用户输入 | AI 默认方案 | 留痕/备注 |
|---|---|---|---|
| 数据库类型 | □ PostgreSQL / □ MySQL / □ SQLite / □ MongoDB / □ 平台托管 / □ 其他:____ | | |
| 实例位置 | □ 本地 Docker / □ 远程 RDS / □ 平台托管 / □ 其他:____ | | |
| 连接串 | | `postgres://user:pass@localhost:5432/db` | |
| 账号/密码 | | 本地默认 `user/pass` | |
| 是否允许 AI 生成本地 Docker Compose | □ 是 / □ 否 | | |

### 1.3 外部 API 与密钥

| 检查项 | 用户输入 | AI 默认方案 | 留痕/备注 |
|---|---|---|---|
| AI 大模型 API | □ DeepSeek / □ OpenAI / □ 阿里云 / □ 其他:____ / □ 暂无 | 未配置时走本地模拟流 | |
| API Key | | 从环境变量读取,不硬编码 | |
| 是否允许模拟降级 | □ 是 / □ 否 | | |
| 短信服务 | □ 有 / □ 无 | | |
| 文件存储服务 | □ NovaStorage / □ 七牛 / □ OSS / □ 无 | | |

### 1.4 用户认证

| 检查项 | 用户输入 | AI 默认方案 | 留痕/备注 |
|---|---|---|---|
| 认证方式 | □ 邮箱密码 / □ 手机号 / □ SSO / □ 其他:____ | 邮箱密码 + JWT | |
| 是否需要注册 | □ 是 / □ 否(仅后台创建账号) | | |
| 默认体验账号 | □ 需要 / □ 不需要 | 开发环境提供 demo 账号 | |

### 1.5 Mock 数据策略

| 检查项 | 用户输入 | AI 默认方案 | 留痕/备注 |
|---|---|---|---|
| 开发期是否先 Mock | □ 是 / □ 否 | 按 06-前端规范.md 默认 Mock 先行 | |
| 切换真实接口时机 | | 联调期逐接口切换 | |

### 1.6 品牌与视觉

| 检查项 | 用户输入 | AI 默认方案 | 留痕/备注 |
|---|---|---|---|
| 是否提供 logo | □ 是 / □ 否 | 使用 ui-kit 默认 | |
| 主题色 | | ui-kit 默认蓝色 | |
| 字体要求 | | ui-kit 默认 | |
| 是否有设计稿/原型 | □ 是 / □ 否 | | |

### 1.7 合规与安全

| 检查项 | 用户输入 | AI 默认方案 | 留痕/备注 |
|---|---|---|---|
| 数据是否需要加密存储 | □ 是 / □ 否 | 密码 bcrypt;敏感字段不返回前端 | |
| 数据是否允许出境 | □ 是 / □ 否 | | |
| 是否需要操作审计日志 | □ 是 / □ 否 | v1.x 后续迭代 | |
| 等保/合规要求 | | 无 | |

## 二、规范覆盖确认

| 规范默认项 | 用户是否覆盖 | 覆盖说明/ADR 编号 |
|---|---|---|
| fmode-ng 平台数据访问 | □ 接受默认 / □ 覆盖为自建后端 | |
| Mock 先行 | □ 接受默认 / □ 覆盖为直接真实接口 | |
| 先问后做(澄清) | □ 接受默认 / □ 用户要求不提问 | |
| 其他:____ | | |

## 三、AI 确认与下一步

- [ ] 最小资源/凭据集合已确认或已给出默认方案
- [ ] 用户覆盖规范默认的项已记录并留痕
- [ ] 项目阶段已切换/保持为:____
- [ ] 下一步动作:____

## 四、变更历史

| 版本 | 日期 | 变更内容 | 变更原因 |
|---|---|---|---|
| v1.0 | YYYY-MM-DD | 首次创建 | 项目启动 |