# Phase 2: Foundation Playbook

> 基础阶段 - 搭建项目骨架和核心基础设施

---

## 阶段目标

建立项目的核心技术基础，包括开发环境、CI/CD、数据库和核心 API。

## 输入文档

从 Phase 1 接收：
1. System Architecture Document
2. Sprint Plan
3. Design System Spec
4. Security Review Report
5. Risk Register

## 激活 Agents

| Agent | 角色 | 优先级 |
|-------|------|--------|
| **DevOps Automator** | CI/CD 和基础设施 | 立即 |
| **Backend Architect** | 核心 API 实现 | 立即 |
| **Senior Developer** | 项目骨架搭建 | 立即 |
| **Frontend Developer** | UI 框架搭建 | Day 2 |

## 关键活动

### 1. 项目初始化 (Day 1)

**Senior Developer 执行**:
```bash
# 创建项目结构
mkdir -p {src,tests,docs,config}
# 初始化版本控制
git init
# 设置代码规范
# 配置 TypeScript/ESLint/Prettier
```

**交付物**:
- 完整的项目骨架
- 配置文件（ESLint, Prettier, TypeScript）
- README 和 CONTRIBUTING 文档

### 2. CI/CD 设置 (Day 1-2)

**DevOps Automator 执行**:
- GitHub Actions / GitLab CI 配置
- 测试自动化
- 部署流程
- 环境变量管理

**交付物**:
```yaml
# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run tests
        run: |
          npm ci
          npm test

  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Lint
        run: npm run lint
```

### 3. 数据库和 API (Day 2-4)

**Backend Architect 执行**:
- 数据库迁移系统
- 核心 API 端点
- 认证中间件
- 错误处理框架

**交付物**:
- 数据库 schema 迁移
- API 路由结构
- 认证系统
- API 文档 (OpenAPI)

### 4. UI 框架 (Day 2-4)

**Frontend Developer 执行**:
- 组件库集成
- 路由设置
- 状态管理配置
- 设计系统实现

**交付物**:
- 基础组件库
- 路由配置
- 状态管理 store
- 主题系统

## 阶段门禁

进入 Phase 3 前必须满足：

| # | 标准 | 阈值 | 验证方法 |
|---|------|------|----------|
| 1 | CI/CD 运行 | 绿色 | Pipeline 检查 |
| 2 | 测试框架就绪 | 100% | 框架验证 |
| 3 | 核心 API 可用 | ≥ 80% 端点 | API 测试 |
| 4 | UI 框架就绪 | 核心组件 100% | 组件审查 |
| 5 | 认证系统工作 | 100% | 登录测试 |
| 6 | 文档完整 | README + API docs | 内容审查 |

## 验收标准

### CI/CD
- [ ] Push 到 main 触发 CI
- [ ] 所有测试自动运行
- [ ] Lint 检查通过
- [ ] 可部署到 staging

### 数据库
- [ ] 迁移系统工作
- [ ] Schema 符合设计
- [ ] 索引已创建
- [ ] 备份策略定义

### API
- [ ] 健康检查端点工作
- [ ] 认证端点工作
- [ ] CORS 配置正确
- [ ] 错误处理一致

### UI
- [ ] 应用可启动
- [ ] 路由工作
- [ ] 主题切换工作
- [ ] 响应式基础

## 交接文档

阶段结束时交接给 Phase 3：
1. 项目代码仓库
2. CI/CD 配置
3. API 文档
4. 组件库文档
5. 部署指南

---

**预计时间**: 3-5 天
**下一阶段**: Phase 3 - Build