theo/dofus-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

initial commit

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files

66
docs/architecture/2-high-level-architecture.md Normal file
View File

@@ -0,0 +1,66 @@
# 2. High-Level Architecture
## System Architecture Diagram
```
┌─────────────────────────────────────────────────────────────────────────────┐
│ DOFUS MANAGER │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ CLIENT (Browser) │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ │ │
│ │ │ React │ │ TanStack │ │ TanStack │ │ Zustand │ │ │
│ │ │ Components│ │ Router │ │ Query │ │ (UI State)│ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ └────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ │ Server Functions (RPC) │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ SERVER (TanStack Start) │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ │ │
│ │ │ Server │ │ Zod │ │ Prisma │ │ node-cache│ │ │
│ │ │ Functions │ │ Validation │ │ ORM │ │ (Cache) │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ └────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ DATABASE (PostgreSQL) │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ │ │
│ │ │ Characters │ │ Accounts │ │ Teams │ │Progressions│ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ └────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ EXTERNAL SERVICES │ │
│ │ ┌─────────────────────────────────────────────────────────────┐ │ │
│ │ │ DofusDB API │ │ │
│ │ │ (Classes, Quêtes, Donjons, Succès) │ │ │
│ │ └─────────────────────────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
```
## Data Flow
```
User Action → React Component → TanStack Query → Server Function → Prisma → PostgreSQL
↑ │
└───────────────────────── Response ────────────────────────────────────────┘
```
## Key Architectural Decisions
| Decision | Choice | Rationale |
|----------|--------|-----------|
| Full-stack Framework | TanStack Start | Type-safe, modern React, server functions |
| Database | PostgreSQL | Robust, JSON support, full-text search |
| ORM | Prisma | Type-safe queries, excellent DX |
| State Management | TanStack Query + Zustand | Server state vs UI state separation |
| Styling | Tailwind + shadcn/ui | Rapid development, consistent design |
| Deployment | Docker + Traefik | Easy SSL, reverse proxy, scalable |
---