diff --git a/README.md b/README.md index 99730d1..f4da9bc 100644 --- a/README.md +++ b/README.md @@ -97,6 +97,18 @@ FORGE AI is built on a **Microservices Architecture** using **Docker Compose**. --- +## ⚡️ Scalability & Performance + +FORGE AI is architected to handle high user concurrency (e.g., 200+ simultaneous users) without degrading API performance. + +* **Asynchronous Job Queue**: All heavy compute tasks (Video Generation, Upscaling) are offloaded to **Celery** workers via **Redis**. The API responds immediately with a `Queued` status, ensuring the interface remains snappy. +* **Horizontal Scaling**: + * The `forge-worker` service can be scaled horizontally to process more jobs in parallel. + * Command: `docker-compose up -d --scale worker=3` (Starts 3 worker containers). +* **Fault Tolerance**: If a worker crashes or an API fails, the job status is tracked in Postgres, and broken jobs can be automatically retried or flagged. + +--- + ## 💾 Database Schema Overview | Table | Description | Key Fields |