Back to Details

phase-execution

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Phase Execution

阶段执行

Guides execution of a project phase (e.g. Phase 1) in a controlled, traceable way. Execute only the requested phase; do not advance to later phases.
以可控、可追溯的方式指导项目阶段（如第一阶段）的执行。仅执行请求的阶段，不要推进到后续阶段。

Workflow

工作流程

Track progress with this checklist:
- [ ] Phase 1: Analysis
- [ ] Phase 2: Planning
- [ ] Phase 3: Implementation
- [ ] Phase 4: Validation
- [ ] Phase 5: Delivery
使用以下检查清单跟踪进度：
- [ ] Phase 1: Analysis
- [ ] Phase 2: Planning
- [ ] Phase 3: Implementation
- [ ] Phase 4: Validation
- [ ] Phase 5: Delivery

1. Phase 1 — Analysis (required first)

1. 第一阶段 — 分析（需首先执行）

  • Context: Analyze scope, objectives, and technical/functional requirements.
  • Dependencies: Identify links with future phases.
  • Impact: Assess architectural decisions that affect later tasks.
  • Validation: Confirm technical and functional understanding before starting.
  • 背景：分析项目范围、目标以及技术/功能需求。
  • 依赖关系：识别与后续阶段的关联。
  • 影响：评估会影响后续任务的架构决策。
  • 验证：在开始前确认对技术和功能的理解。

2. Phase 2 — Planning

2. 第二阶段 — 规划

  • Strategy: Define the most suitable technical approach.
  • Structure: Plan code and resource organization.
  • Risks: Identify possible failures and preventive measures.
  • 策略：定义最合适的技术方案。
  • 结构：规划代码和资源的组织方式。
  • 风险：识别可能出现的故障及预防措施。

3. Phase 3 — Implementation

3. 第三阶段 — 实施

  • Implement all components required for the phase.
  • Apply project standards (validations, error handling, null safety).
  • Optimize PostgreSQL (indexes, constraints, transactions).
  • Configure FastAPI, logging, monitoring.
  • Include unit tests (minimum 80% coverage).
  • Update README, diagrams, and technical docs.
  • 实现该阶段所需的所有组件。
  • 遵循项目标准（验证、错误处理、空值安全）。
  • 优化PostgreSQL（索引、约束、事务）。
  • 配置FastAPI、日志记录、监控。
  • 包含单元测试（覆盖率至少80%）。
  • 更新README、图表和技术文档。

4. Phase 4 — Validation

4. 第四阶段 — 验证

  • Functional tests: Verify all phase requirements are met.
  • Integration tests: Validate PostgreSQL and external services.
  • Code review: Run quality checklist before delivery.
  • 功能测试：验证该阶段的所有需求是否已满足。
  • 集成测试：验证PostgreSQL与外部服务的集成。
  • 代码评审：交付前运行质量检查清单。

5. Phase 5 — Delivery

5. 第五阶段 — 交付

  • Produce a detailed checklist of implemented items.
  • Update status in the format below.
  • Produce the final report (template below).
  • 生成已实现项的详细检查清单。
  • 按照以下格式更新状态。
  • 生成最终报告（模板如下）。

Status update format

状态更新格式

Use this template for before/after status:
markdown
undefined
使用以下模板记录执行前后的状态：
markdown
undefined

Before execution

Before execution

  • Item 1
  • Item 2
  • Item 1
  • Item 2

After execution

After execution

  • Item 1
  • Item 2
undefined
  • Item 1
  • Item 2
undefined

Constraints

约束条件

  • Focus: Execute ONLY the requested phase; do not start the next one.
  • Awareness: Keep in mind impact on future phases.
  • Quality: Do not sacrifice quality for speed.
  • Completion: Finish 100% of the phase before reporting.
  • 聚焦：仅执行请求的阶段，不要启动下一阶段。
  • 前瞻性：考虑对后续阶段的影响。
  • 质量：不要为了速度牺牲质量。
  • 完整性：完成该阶段的100%任务后再进行汇报。

Quality standards (during implementation)

实施阶段质量标准

  • Python: PEP 8, type hints, docstrings.
  • PostgreSQL: Optimize queries, indexes, constraints.
  • FastAPI: Pydantic validation, response models, documentation.
  • Architecture: Separate concerns, dependency injection, logging.
  • Python：遵循PEP 8规范、类型提示、文档字符串。
  • PostgreSQL：优化查询、索引、约束。
  • FastAPI：使用Pydantic验证、响应模型、文档。
  • 架构：关注点分离、依赖注入、日志记录。

Final report template

最终报告模板

Deliver a report with:
  1. Executive summary: What was implemented and how.
  2. Completion checklist: Detailed list of finished items.
  3. Updated files: Confirmation of status updates.
  4. Technical notes: Architectural decisions relevant for future phases.
  5. Next steps: Recommendations for the next phase (do not execute them).
交付包含以下内容的报告：
  1. 执行摘要：已实现内容及实现方式。
  2. 完成检查清单：已完成项的详细列表。
  3. 文件更新确认：确认状态更新情况。
  4. 技术说明：与后续阶段相关的架构决策。
  5. 下一步建议：对下一阶段的建议（不要执行）。