TorbatYar multi-tenant SaaS platform
047cd17afd
Wire CRM, loyalty, communication, and delivery service URLs into docker-compose so Next.js API proxies reach Docker network hosts instead of localhost fallbacks. Co-authored-by: Cursor <cursoragent@cursor.com> |
||
|---|---|---|
| backend | ||
| docs | ||
| docs-runtime | ||
| frontend | ||
| infrastructure | ||
| scripts | ||
| .env.example | ||
| .gitignore | ||
| docker-compose.yml | ||
| README.md | ||
| TorbatYar.code-workspace | ||
TorbatYar SuperApp SaaS Platform
پلتفرم SaaS چندمستأجری (Multi-tenant)، ماژولار، API-first و microservice-ready.
برند، رنگها و تنظیمات هیچکدام در کد hardcode نشدهاند و همگی از
.env/config/ دیتابیس خوانده میشوند.
Documentation (source of truth)
شروع از docs/README.md.
| Document | Responsibility |
|---|---|
docs/architecture/architecture.md |
Architecture overview |
docs/reference/database-schema.md |
Database schema reference |
docs/reference/services-contracts.md |
Service contracts |
docs/development/developer-guide.md |
Developer guide |
docs/module-registry.md |
Module registry |
docs/ai-framework/ |
Enterprise / AI Development Framework (implementation lifecycle; production-ready by default) |
docs/provider-registry.md |
Provider registry |
docs/glossary.md |
Glossary |
docs/progress.md |
Completed work |
docs/next-steps.md |
Immediate next milestone |
docs/roadmap.md |
Future roadmap |
docs/deployment/ |
Deployment runbooks |
Architecture at a glance
- Mandatory Frontend/Backend separation —
backend/andfrontend/are independent apps. - Database-per-service — no cross-DB queries (ADR-001).
- Inter-service communication — REST, Webhook, Async Event, Outbox/Inbox only.
- Multi-tenancy — business tables carry
tenant_id.
Project structure
TorbatYar/
├── backend/
│ ├── core-service/ # FastAPI Core Platform
│ ├── shared-lib/ # Shared backend library
│ └── services/ # Identity, Accounting, CRM, Loyalty, Communication, Sports Center (+ future)
├── frontend/ # Next.js
├── docs/ # Documentation architecture (canonical)
├── infrastructure/ # Nginx, Keycloak, deploy env samples
├── scripts/ # Ops / verification scripts
├── docker-compose.yml
├── .env.example
└── README.md
Quick start (Docker)
cp .env.example .env
docker compose up -d --build
- Frontend: http://localhost:3000
- Core API: http://localhost:8000/docs
- Identity API: http://localhost:8001/docs
- Accounting API: http://localhost:8002/docs
- CRM API: http://localhost:8003/docs
- Loyalty API: http://localhost:8004/docs
- Communication API: http://localhost:8005/docs
- Sports Center API: http://localhost:8006/docs
- Hospitality API: http://localhost:8009/docs
- Keycloak: http://localhost:8080
Details: docs/development/developer-guide.md.
Tests (Backend)
cd backend/core-service
pytest -q
Current status
See docs/progress.md. Next milestone: docs/next-steps.md.