initial commit
This commit is contained in:
114
docs/architecture/8-core-workflows.md
Normal file
114
docs/architecture/8-core-workflows.md
Normal file
@@ -0,0 +1,114 @@
|
||||
# 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 │ │
|
||||
│ └────────────┘ └──────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
Reference in New Issue
Block a user