julian
17c08e6392
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
160 lines
3.4 KiB
Markdown
160 lines
3.4 KiB
Markdown
# {scenario-number}-{scenario-name}
|
|
|
|
**Project:** {project-name}
|
|
**Created:** {date}
|
|
**Method:** Whiteport Design Studio (WDS)
|
|
|
|
---
|
|
|
|
## Scenario Overview
|
|
|
|
**User Journey:** {High-level description of what users accomplish in this scenario}
|
|
|
|
**Entry Point:** {Where users begin this scenario}
|
|
**Success Exit:** {Where users end after successful completion}
|
|
**Alternative Exits:** {Other possible endpoints - errors, cancellations, etc.}
|
|
|
|
**Target Personas:** {Which personas from Trigger Map use this scenario}
|
|
|
|
---
|
|
|
|
## Pages in This Scenario
|
|
|
|
| Page # | Page Name | Status | Purpose |
|
|
| ------ | ----------- | ---------------- | --------------- |
|
|
| {n}.1 | {page-name} | {draft/complete} | {Brief purpose} |
|
|
| {n}.2 | {page-name} | {draft/complete} | {Brief purpose} |
|
|
| {n}.3 | {page-name} | {draft/complete} | {Brief purpose} |
|
|
|
|
---
|
|
|
|
## User Flow
|
|
|
|
```mermaid
|
|
flowchart TD
|
|
A[{Entry Point}] --> B[{Page n.1}]
|
|
B --> C[{Page n.2}]
|
|
C --> D{{Decision Point?}}
|
|
D -->|Yes| E[{Page n.3}]
|
|
D -->|No| F[{Alternative Path}]
|
|
E --> G[{Success Exit}]
|
|
F --> G
|
|
```
|
|
|
|
---
|
|
|
|
## Scenario Steps
|
|
|
|
### Step 1: {Step Name}
|
|
|
|
**Page:** {n.1-Page-Name}
|
|
**User Action:** {What the user does}
|
|
**System Response:** {How the system responds}
|
|
**Success Criteria:** {What defines success for this step}
|
|
|
|
### Step 2: {Step Name}
|
|
|
|
**Page:** {n.2-Page-Name}
|
|
**User Action:** {What the user does}
|
|
**System Response:** {How the system responds}
|
|
**Success Criteria:** {What defines success for this step}
|
|
|
|
{Repeat for all steps}
|
|
|
|
---
|
|
|
|
## Trigger Map Connections
|
|
|
|
### Positive Drivers Addressed
|
|
|
|
From Trigger Map analysis, this scenario serves these user goals:
|
|
|
|
- ✅ {Positive goal from Trigger Map}
|
|
- ✅ {Positive goal from Trigger Map}
|
|
|
|
### Negative Drivers Avoided
|
|
|
|
This scenario helps users avoid:
|
|
|
|
- ❌ {Negative outcome from Trigger Map}
|
|
- ❌ {Negative outcome from Trigger Map}
|
|
|
|
---
|
|
|
|
## Success Metrics
|
|
|
|
**Primary Metric:** {Main measure of scenario success}
|
|
|
|
**Secondary Metrics:**
|
|
|
|
- {Metric 1}
|
|
- {Metric 2}
|
|
|
|
**User Satisfaction Indicators:**
|
|
|
|
- {What indicates good user experience}
|
|
|
|
---
|
|
|
|
## Edge Cases & Error Handling
|
|
|
|
| Edge Case | How Handled | Page(s) Affected |
|
|
| ----------------------- | ------------------- | ----------------- |
|
|
| {edge-case-description} | {handling-approach} | {page-references} |
|
|
|
|
---
|
|
|
|
## Technical Requirements
|
|
|
|
### Data Flow
|
|
|
|
```
|
|
{Entry} → [Fetch Data] → {Display} → [User Action] → [Validate] → [API Call] → {Success}
|
|
```
|
|
|
|
### API Endpoints Used
|
|
|
|
| Endpoint | Page(s) | Purpose |
|
|
| --------------- | ----------- | -------------- |
|
|
| {endpoint-path} | {page-refs} | {what-it-does} |
|
|
|
|
### State Management
|
|
|
|
{How state is managed across pages in this scenario}
|
|
|
|
---
|
|
|
|
## Design Assets
|
|
|
|
**Scenario Folder:** `C-UX-Scenarios/{scenario-number}-{scenario-name}/`
|
|
|
|
**Page Specifications:**
|
|
|
|
- {n}.1-{page-name}/{page-name}.md
|
|
- {n}.2-{page-name}/{page-name}.md
|
|
- {n}.3-{page-name}/{page-name}.md
|
|
|
|
**Prototypes:**
|
|
|
|
- {n}.1-{page-name}/Prototype/
|
|
- {n}.2-{page-name}/Prototype/
|
|
- {n}.3-{page-name}/Prototype/
|
|
|
|
---
|
|
|
|
## Development Notes
|
|
|
|
{Any scenario-level technical considerations, performance requirements, security notes, etc.}
|
|
|
|
---
|
|
|
|
## Revision History
|
|
|
|
| Date | Changes | Author |
|
|
| ------ | ------------------------ | -------- |
|
|
| {date} | Initial scenario created | {author} |
|
|
|
|
---
|
|
|
|
_Created using Whiteport Design Studio (WDS) methodology_
|