51 lines
2.9 KiB
Markdown
51 lines
2.9 KiB
Markdown
# 🏛️ Luxe Platform - Backend Architecture Blueprint
|
|
|
|
## System Overview
|
|
**Luxe Platform** is an enterprise classified marketplace designed for high availability, zero-downtime deployment, horizontal scale, and millions of concurrent users & listings.
|
|
|
|
The backend is built following **Clean Architecture** as a **Microservice-Ready Monorepo**.
|
|
|
|
```
|
|
+------------------------+
|
|
| Cloudflare WAF / CDN |
|
|
+-----------+------------+
|
|
|
|
|
v
|
|
+------------------------+
|
|
| Fastify API Gateway |
|
|
+-----------+------------+
|
|
|
|
|
+-------------------------------+-------------------------------+
|
|
| | |
|
|
v v v
|
|
+--------------+ +---------------+ +---------------+
|
|
| Identity & | | Listing & | | Wallet & |
|
|
| Auth Service | | Search Service| | Ledger Service|
|
|
+--------------+ +---------------+ +---------------+
|
|
| | |
|
|
+-------------------------------+-------------------------------+
|
|
|
|
|
v
|
|
+----------------------------+
|
|
| PostgreSQL 16 (Primary) |
|
|
| Redis 7 (Cache & BullMQ) |
|
|
| MinIO / Cloudflare R2 |
|
|
+----------------------------+
|
|
```
|
|
|
|
---
|
|
|
|
## Workspace Structure
|
|
- **`packages/database`**: Central Prisma ORM data layer with PostgreSQL schemas, soft deletes, GIN/B-tree indexing, and seeder scripts.
|
|
- **`packages/shared`**: Enterprise core utilities, standard HTTP response wrappers, Argon2 password hashing, JWT token rotation, Zod request schemas, and dynamic RBAC policies.
|
|
- **`services/gateway`**: High-performance Fastify API Gateway handling TLS termination, rate limiting, request validation, authentication hooks, Swagger UI docs, and Socket.IO real-time websockets.
|
|
- **`services/notification-service`**: Async background worker powered by BullMQ processing multi-channel notifications (Email, SMS, WhatsApp, Telegram).
|
|
|
|
---
|
|
|
|
## Clean Architecture Layers
|
|
1. **Domain Layer**: Entity models defined in Prisma & TypeScript schemas.
|
|
2. **Use-Case / Service Layer**: Business logic for verification queues, immutable wallet ledgers, coupon processing, and search filters.
|
|
3. **Interface Adapters**: Fastify routes, controllers, and socket handlers.
|
|
4. **Infrastructure Layer**: PostgreSQL, Redis, MinIO S3, Prometheus, Grafana, and Docker/Kubernetes orchestrators.
|