项目启动检查单

文件命名: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	首次创建	项目启动