TorbatYar multi-tenant SaaS platform

Go to file

Mortezakoohjani 31a0a34945 feat(loyalty): add complete Loyalty Platform Frontend module Scaffold frontend/modules/loyalty with types, API client, design system, feature pages, and thin App Router routes. Wire all screens to backend Loyalty service via BFF proxy. Add loyalty docs and update progress. Co-authored-by: Cursor <cursoragent@cursor.com>		2026-07-27 10:46:45 +03:30
backend	feat(loyalty): add complete Loyalty Platform Frontend module	2026-07-27 10:46:45 +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	feat(loyalty): add complete Loyalty Platform Frontend module	2026-07-27 10:46:45 +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	feat(loyalty): add complete Loyalty Platform Frontend module	2026-07-27 10:46:45 +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	Fix Loyalty production migrate: stamp head after create_all and relax DB host guard.	2026-07-26 22:38:08 +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.