构建检查清单

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

---

# 构建检查清单 (BUILD CHECKLIST)

> 使用此清单确保每次构建都符合标准规范。

## &#128203; 构建前检查

在执行 `pnpm build` 之前，请确认以下项目：

### 代码检查
- [ ] 所有代码已提交到 Git
- [ ] 无未解决的编译错误
- [ ] 所有组件导出正确
- [ ] 无控制台错误或警告

### 组件导出检查
- [ ] `src/components/changelog/index.ts` 导出 `ChangelogWidget`
- [ ] 所有自定义组件都有正确的导出
- [ ] 没有循环依赖

### 页面文件检查
- [ ] `src/app/admin/dashboard/page.tsx` 存在
- [ ] `src/app/admin/changelog/page.tsx` 存在
- [ ] `src/app/login/page.tsx` 存在
- [ ] 所有关键页面都正常渲染

### 配置文件检查
- [ ] `package.json` 无语法错误
- [ ] `next.config.ts` 配置正确
- [ ] `tsconfig.json` 配置正确
- [ ] `.FutureBirdAadminAi` 文件配置正确

### 依赖检查
- [ ] `pnpm install` 已执行
- [ ] 无依赖冲突
- [ ] 无安全漏洞

## &#128296; 构建过程检查

在执行 `pnpm build` 时，请确认以下项目：

### 构建日志
- [ ] 无 ERROR 级别错误
- [ ] 无 Fatal 错误
- [ ] 构建时间合理（不超过 5 分钟）
- [ ] 所有页面生成成功

### 构建输出
- [ ] `.next/BUILD_ID` 文件已生成
- [ ] `.next/server/app/` 目录存在
- [ ] `.next/static/css/` 目录存在
- [ ] `.next/static/js/` 目录存在

## ✅ 构建后验证

构建完成后，请验证以下项目：

### 页面生成验证
- [ ] `admin/dashboard` 页面已生成
- [ ] `admin/changelog` 页面已生成
- [ ] `login` 页面已生成
- [ ] 所有 API 路由已生成

### 静态资源验证
- [ ] CSS 文件存在
- [ ] JS 文件存在
- [ ] 字体文件存在
- [ ] 图片资源存在

### 文件大小验证
- [ ] 单个 CSS 文件不超过 500KB
- [ ] 单个 JS 文件不超过 2MB
- [ ] 构建总大小不超过 100MB

### 功能验证
```bash
# 1. 启动服务
pnpm start

# 2. 验证首页响应
curl -I http://localhost:5000

# 3. 验证关键页面
curl http://localhost:5000/admin/dashboard
curl http://localhost:5000/admin/changelog
```

- [ ] 首页响应正常（HTTP 200）
- [ ] Dashboard 页面可访问
- [ ] Changelog 页面可访问
- [ ] 样式正常加载
- [ ] 无控制台错误

## &#128640; 部署前检查

在部署到生产环境前，请确认：

### 环境配置
- [ ] 生产环境变量已配置
- [ ] 数据库连接正常
- [ ] 对象存储配置正确
- [ ] 短信服务配置正确

### 安全检查
- [ ] 无敏感信息泄露
- [ ] 认证机制正常
- [ ] HTTPS 已启用
- [ ] CORS 配置正确

### 性能检查
- [ ] 页面加载速度正常
- [ ] 资源优化已启用
- [ ] 缓存策略正确
- [ ] CDN 配置正确

## &#128221; 构建记录

每次构建请记录以下信息：

```
构建日期：YYYY-MM-DD HH:MM:SS
构建者：[开发者姓名]
构建命令：pnpm build
构建ID：[BUILD_ID]
构建时长：[X 分钟]
构建结果：✅ 成功 / ❌ 失败
备注：[特殊情况说明]
```

## ⚠️ 常见问题

### Q1: 构建失败，提示组件导出错误
**A**: 检查组件导出文件（如 `src/components/changelog/index.ts`），确认导出语句正确。

### Q2: 构建成功但页面无法访问
**A**: 检查页面文件路径是否正确，确认没有大小写错误。

### Q3: CSS 文件过大
**A**: 检查是否导入了不必要的样式，考虑使用 CSS 模块或组件化样式。

### Q4: 构建时间过长
**A**: 清理缓存（`rm -rf .next`），检查是否有大量第三方库。

## &#128222; 联系支持

如果遇到无法解决的问题：
1. 查看 [构建标准规范](./构建标准.md)
2. 查看构建日志（`.next/build-manifest.json`）
3. 联系技术支持团队

---

**重要提示**：此清单为强制执行标准，任何未完成的项目都必须修复后才能构建。