# S2F 发布检查清单

## 一、代码质量

- [ ] 所有 lint 错误已修复
- [ ] TypeScript 类型检查通过 (`npm run type-check`)
- [ ] Python 类型检查通过 (`mypy app/`)
- [ ] 无 `console.log` / `print` 残留（调试代码）
- [ ] 无硬编码密钥/密码
- [ ] 中文 DocString 已添加

## 二、功能验证

- [ ] 用户注册/登录流程正常
- [ ] 文件上传（工资表/社保表/个税表）正常
- [ ] AI 字段识别返回结果
- [ ] 字段映射确认后可执行对账
- [ ] 对账结果展示正确
- [ ] 异常列表筛选/处理正常
- [ ] 成本分析页面数据加载正常
- [ ] 成本分析 Excel 导出正常
- [ ] AI 问答功能正常
- [ ] 凭证生成正常
- [ ] 凭证确认后可导出
- [ ] 金蝶 CSV 导出格式正确
- [ ] 科目映射 CRUD 正常

## 三、安全检查

- [ ] JWT Token 过期时间合理（≤2h）
- [ ] 密码使用 bcrypt 哈希
- [ ] API 接口有权限校验
- [ ] 租户隔离生效（X-Company-ID）
- [ ] SQL 注入防护（参数化查询）
- [ ] XSS 防护（前端转义）
- [ ] CORS 配置正确
- [ ] 敏感信息不在日志中输出
- [ ] .env 不在 Git 中

## 四、数据库

- [ ] 数据库迁移脚本已准备
- [ ] 所有模型字段有注释
- [ ] 审计字段完整（created_by/updated_by）
- [ ] 索引已创建（常用查询字段）

## 五、前端

- [ ] 所有页面有 Loading 状态
- [ ] 所有页面有 Empty 状态
- [ ] 错误处理有用户提示
- [ ] 响应式布局（sm/md/lg/xl）
- [ ] 暗色模式兼容
- [ ] 无 `alert()/confirm()`
- [ ] 无硬编码主色 hex

## 六、部署

- [ ] Docker 镜像构建成功
- [ ] docker-compose up 正常启动
- [ ] Nginx 反向代理配置正确
- [ ] 环境变量已通过 .env 配置
- [ ] 数据库初始化脚本可执行
- [ ] 健康检查端点 `/api/health` 正常

## 七、文档

- [ ] README 已更新
- [ ] API 文档（OpenAPI）可访问
- [ ] .env.example 完整
- [ ] 部署步骤清晰可复制

## 八、性能

- [ ] API 响应时间 < 500ms（常规接口）
- [ ] 文件上传超时设置合理
- [ ] 大数据集分页正常
- [ ] 前端首屏加载 < 3s