How pathangufran/multi-tenant-saas-platform works
This repository is a multi-service backend for a tenant-based collaboration and project-management product. Its principal workflow is authenticated users operating within a tenant to manage projects and tasks, with related tags, comments, and attachments; supporting services handle tenant membership and RBAC, notifications and email, exports, and reports. The graph preserves the distinct service and domain stages. Source excerpts show selected service calls and persistence; the README is empty and many views and integration paths were not sampled, so those links are omitted or marked unverified.
Main entry points: domain_rules.py Tenant integrity rules · models.py Task records · tags/services.py Tags · comments/services.py Comments
Components 33
Identity and tenancy
- Authentication API
services/auth-service/apps/authentication/views.py - Authentication service
services/auth-service/apps/authentication/services.py - Authentication audit
services/auth-service/apps/authentication/audit_service.py - User records
services/auth-service/apps/users/models.py - Tenant API
services/tenant-service/apps/tenants/views.py - Tenant context resolution
services/tenant-service/apps/tenants/context_service.py - Membership service
services/tenant-service/apps/tenants/membership_service.py - Tenant RBAC
services/tenant-service/apps/tenants/rbac_service.py - Tenant records
services/tenant-service/apps/tenants/models.py
Workspace management
- Workspace API
services/core-service/apps/tasks/views.py - Projects
services/core-service/apps/projects/services.py - Project records
services/core-service/apps/projects/models.py - Tasks
services/core-service/apps/tasks/services.py - Task records
services/core-service/apps/tasks/models.py - Tenant integrity rules
services/core-service/apps/common/domain_rules.py - Tags
services/core-service/apps/tags/services.py - Tag records
services/core-service/apps/tags/models.py - Comments
services/core-service/apps/comments/services.py - Comment records
services/core-service/apps/comments/models.py - Attachments
services/core-service/apps/attachments/services.py - Attachment records
services/core-service/apps/attachments/models.py
Notifications and email
- In-app notifications
services/notification-service/apps/notifications/services.py - Notification records
services/notification-service/apps/notifications/models.py - Notification tasks
services/notification-service/apps/notifications/tasks.py - Email tasks
services/notification-service/apps/email_service/tasks.py - Email delivery
services/notification-service/apps/email_service/services.py - Email providers
services/notification-service/apps/email_service/providers.py
Exports and reporting
- Export generation
services/notification-service/apps/exports/services.py - Export records
services/notification-service/apps/exports/models.py - Export file storage
services/notification-service/apps/exports/storage.py - Report generation
services/notification-service/apps/reports/services.py - Report tasks
services/notification-service/apps/reports/tasks.py
Other components
- User / client
Connections 35
- User / client → Authentication API: sends requests
- Authentication API → Authentication service: dispatches to
- Authentication service → User records: checks credentials
services/auth-service/apps/authentication/services.py - Authentication service → Authentication audit: records events
services/auth-service/apps/authentication/services.py - User / client → Tenant API: sends requests
- Tenant API → Tenant context resolution: dispatches to
- Tenant context resolution → Tenant records: loads tenant
services/tenant-service/apps/tenants/context_service.py - Tenant context resolution → Membership service: checks membership
services/tenant-service/apps/tenants/context_service.py - Membership service → Tenant records: uses tenant models
services/tenant-service/apps/tenants/membership_service.py - Tenant RBAC → Tenant records: uses tenant models
services/tenant-service/apps/tenants/rbac_service.py - User / client → Workspace API: sends requests
- Workspace API → Projects: dispatches to
- Workspace API → Tasks: dispatches to
- Projects → Project records: reads and writes
services/core-service/apps/projects/services.py - Tasks → Tenant integrity rules: validates tenant
services/core-service/apps/tasks/services.py - Tasks → Task records: reads and writes
services/core-service/apps/tasks/services.py - Tenant integrity rules → Project records: checks project
services/core-service/apps/common/domain_rules.py - Tenant integrity rules → Task records: checks task
services/core-service/apps/common/domain_rules.py - Tenant integrity rules → Tag records: checks tag
services/core-service/apps/common/domain_rules.py - Tags → Tenant integrity rules: validates tenant
services/core-service/apps/tags/services.py - Tags → Tag records: reads and writes
services/core-service/apps/tags/services.py - Tags → Task records: checks task
services/core-service/apps/tags/services.py - Comments → Tenant integrity rules: validates task
services/core-service/apps/comments/services.py - Comments → Task records: checks task
services/core-service/apps/comments/services.py - Comments → Comment records: reads and writes
services/core-service/apps/comments/services.py - Attachments → Tenant integrity rules: validates task
services/core-service/apps/attachments/services.py - Attachments → Task records: checks task
services/core-service/apps/attachments/services.py - Attachments → Attachment records: uses attachment records
services/core-service/apps/attachments/services.py - In-app notifications → Notification records: reads and writes
services/notification-service/apps/notifications/services.py - Notification tasks → In-app notifications: invokes service
services/notification-service/apps/notifications/tasks.py - Email tasks → Email delivery: invokes service
services/notification-service/apps/email_service/tasks.py - Email delivery → Email providers: sends through
services/notification-service/apps/email_service/services.py - Export generation → Export records: reads and writes
services/notification-service/apps/exports/services.py - Export generation → Export file storage: stores files
services/notification-service/apps/exports/services.py - Report tasks → Report generation: invokes service
services/notification-service/apps/reports/tasks.py