dofus-manager/docs/architecture/8-core-workflows.md

8. Core Workflows

Character Creation Flow

┌─────────────────────────────────────────────────────────────────┐
│                    CHARACTER CREATION FLOW                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐  │
│  │  Click   │───▶│  Open    │───▶│  Fill    │───▶│ Validate │  │
│  │  "Add"   │    │  Modal   │    │   Form   │    │   (Zod)  │  │
│  └──────────┘    └──────────┘    └──────────┘    └────┬─────┘  │
│                                                       │         │
│                                        ┌──────────────┴───┐     │
│                                        ▼                  ▼     │
│                                  ┌──────────┐      ┌──────────┐ │
│                                  │  Valid   │      │ Invalid  │ │
│                                  └────┬─────┘      └────┬─────┘ │
│                                       │                 │       │
│                                       ▼                 ▼       │
│                                ┌────────────┐    ┌────────────┐ │
│                                │   Server   │    │   Show     │ │
│                                │  Function  │    │   Errors   │ │
│                                └─────┬──────┘    └────────────┘ │
│                                      │                          │
│                                      ▼                          │
│                               ┌────────────┐                    │
│                               │   Prisma   │                    │
│                               │   Create   │                    │
│                               └─────┬──────┘                    │
│                                     │                           │
│                                     ▼                           │
│                              ┌────────────┐                     │
│                              │ Invalidate │                     │
│                              │   Query    │                     │
│                              └─────┬──────┘                     │
│                                    │                            │
│                                    ▼                            │
│                             ┌────────────┐                      │
│                             │   Toast    │                      │
│                             │  Success   │                      │
│                             └────────────┘                      │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Progression Update Flow

┌─────────────────────────────────────────────────────────────────┐
│                   PROGRESSION UPDATE FLOW                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────────┐                                               │
│  │ Toggle Check │                                               │
│  └──────┬───────┘                                               │
│         │                                                        │
│         ▼                                                        │
│  ┌──────────────┐     ┌──────────────┐     ┌──────────────┐    │
│  │  Optimistic  │────▶│   Server     │────▶│   Database   │    │
│  │   Update     │     │   Function   │     │    Update    │    │
│  └──────────────┘     └──────────────┘     └──────┬───────┘    │
│         │                                         │             │
│         │                              ┌──────────┴─────┐       │
│         │                              ▼                ▼       │
│         │                       ┌──────────┐     ┌──────────┐  │
│         │                       │ Success  │     │  Error   │  │
│         │                       └────┬─────┘     └────┬─────┘  │
│         │                            │                │        │
│         │                            ▼                ▼        │
│         │                     ┌──────────┐     ┌──────────┐   │
│         └────────────────────▶│  Confirm │     │ Rollback │   │
│                               │   State  │     │  + Toast │   │
│                               └──────────┘     └──────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Bulk Operations Flow

┌─────────────────────────────────────────────────────────────────┐
│                    BULK OPERATIONS FLOW                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐  │
│  │  Select  │───▶│  Choose  │───▶│  Confirm │───▶│ Process  │  │
│  │  Items   │    │  Action  │    │  Modal   │    │  Batch   │  │
│  └──────────┘    └──────────┘    └──────────┘    └────┬─────┘  │
│                                                       │         │
│                                                       ▼         │
│                                                ┌────────────┐   │
│                                                │  Loading   │   │
│                                                │   State    │   │
│                                                └─────┬──────┘   │
│                                                      │          │
│                                        ┌─────────────┴────────┐ │
│                                        ▼                      ▼ │
│                                 ┌────────────┐        ┌────────┐│
│                                 │  Success   │        │ Partial││
│                                 │   Toast    │        │ Failure││
│                                 └─────┬──────┘        └───┬────┘│
│                                       │                   │     │
│                                       ▼                   ▼     │
│                                ┌────────────┐      ┌──────────┐ │
│                                │ Invalidate │      │  Show    │ │
│                                │  Queries   │      │  Errors  │ │
│                                └────────────┘      └──────────┘ │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

---