TorbatYar multi-tenant SaaS platform

Go to file

Mortezakoohjani 6f4a484051 Migrate Beauty, Healthcare, and Accounting frontend to modular src/modules architecture. Move business logic out of App Router into module packages, add boundary validation scripts, and keep all routes as thin re-exports without changing URLs or API behavior. Co-authored-by: Cursor <cursoragent@cursor.com>		2026-07-26 22:28:27 +03:30
backend	Ship Loyalty phases 7.2-7.6 (points through wallet) with production deploy.	2026-07-26 21:27:22 +03:30
docs	Ship Loyalty phases 7.2-7.6 (points through wallet) with production deploy.	2026-07-26 21:27:22 +03:30
frontend	Migrate Beauty, Healthcare, and Accounting frontend to modular src/modules architecture.	2026-07-26 22:28:27 +03:30
infrastructure	Ship Loyalty phases 7.2-7.6 (points through wallet) with production deploy.	2026-07-26 21:27:22 +03:30
scripts	Ship Loyalty phases 7.2-7.6 (points through wallet) with production deploy.	2026-07-26 21:27:22 +03:30
.env.example	Ship Loyalty phases 7.2-7.6 (points through wallet) with production deploy.	2026-07-26 21:27:22 +03:30
.gitignore	Ship enterprise Accounting FE/API with CRUD parity and production wiring.	2026-07-24 15:26:43 +03:30
docker-compose.yml	Ship Loyalty phases 7.2-7.6 (points through wallet) with production deploy.	2026-07-26 21:27:22 +03:30
README.md	Sync platform docs, infra, and module services with Accounting integration.	2026-07-25 22:35:23 +03:30
TorbatYar.code-workspace	Deploy TorbatYar for torbatyar.ir with nginx multi-tenant routing.	2026-07-21 21:43:33 +03:30

README.md

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/`	AI Development Framework (implementation lifecycle)
`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/ and frontend/ 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
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.