velocitatem/cvfs
1
0
Fork 0
mirror of https://github.com/velocitatem/cvfs.git synced 2026-05-31 08:43:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: improve system architecture diagram

Browse Source
This commit is contained in:
Daniel Rosel
2026-04-04 14:55:56 +02:00
parent 747c129f0b
commit 3f0ac81357
1 changed files with 21 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
README.md
View File

@@ -47,16 +47,27 @@ Need Redis/Postgres locally? `make lift.database` (Postgres) and `make up` (Redi
| Shared lib (`dlib`) | Python package | DOCX parser, block schema, patch application/validation, AI prompt helpers, storage adapters | | Shared lib (`dlib`) | Python package | DOCX parser, block schema, patch application/validation, AI prompt helpers, storage adapters |
| Data plane | Postgres + MinIO + Redis | Metadata (documents/versions/patches/submissions), artifact storage (DOCX/PDF/HTML), queues + locks | | Data plane | Postgres + MinIO + Redis | Metadata (documents/versions/patches/submissions), artifact storage (DOCX/PDF/HTML), queues + locks |
``` ```mermaid
┌────────┐ GraphQL-like REST ┌────────────┐ Object storage flowchart LR
│ Webapp │ ─────────────────────────▶ │ FastAPI API│ ───▶ (MinIO/S3) U[User Browser]
└────────┘ Auth cookie / JWT └──────┬─────┘ ┌────────┐ W[Webapp\nNext.js]
▲ │ │ Worker │ API[FastAPI API]
│ Webhooks / SSE └────┬─────▶ └────────┘ WK[Worker\nCelery]
│ │ PG[(Postgres)]
│ Redis queue / locks RD[(Redis)]
│ │ MN[(MinIO / S3)]
│ Postgres metadata
U -->|HTTPS| W
W -->|REST + JWT/Cookie| API
API -->|CRUD metadata| PG
API -->|enqueue jobs| RD
API -->|store/fetch artifacts| MN
WK -->|consume jobs| RD
WK -->|read/write metadata| PG
WK -->|render + publish assets| MN
API -.->|status/events| W
``` ```
## Data model snapshot ## Data model snapshot