initial commit

This commit is contained in:
BeauTroll
2026-01-19 08:52:38 +01:00
commit 46907ca153
193 changed files with 35051 additions and 0 deletions

View 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 │ │
│ └────────────┘ └──────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
```
---