RunLogosRunLogos
中文EN

Phase 03 · 场景建模

场景 Skill 会读取产品原型和功能规格,为每个场景 ID 生成时序图。时序图描述哪个角色在什么顺序下调用哪个系统能力,以及有哪些边界情况。

产物内容

logos/resources/prd/3-technical-plan/2-scenario-implementation/ 中会生成场景实现文档,例如:

S01-user-registration.md
S02-login.md
S03-password-reset.md

示例

sequenceDiagram
  actor User
  participant App
  participant API
  participant DB

  User->>App: 填写注册表单
  App->>API: POST /auth/register
  API->>DB: INSERT users
  DB-->>API: user_id
  API-->>App: 201 Created + JWT
  App-->>User: 跳转控制台

为什么先有场景再设计 API

场景图迫使团队先看完整交互,而不是孤立设计接口。时序图里的每个边界情况会进入测试设计,每个 API 调用会进入 OpenAPI 规格。

跳过这一步,API 很容易偏离真实用户流程。

下一步

Phase 04 · API 设计