How mac83s/saas-core works
SaaS Core is a modular Django and Next.js monolith for multiple product profiles, including a generic business product. The documented user-facing surface includes a panel, marketing pages, pricing, and public company sites; the tree also shows booking, commerce, billing, identity, and assistant capabilities. A representative public-content workflow is crawler or feed client → frontend projection route → backend public-site API. The graph retains major product modules, but several backend paths are unsampled; their connections are omitted unless visible in the excerpts, source index, or README.
Main entry points: organizations/models.py Organizations and tenancy · command_registry.py Assistant commands · booking Booking · commerce/models.py Orders and payments
Components 20
User experience
- SaaS panel
apps/frontend/src/app/[locale]/panel/page.tsx - Marketing and pricing
apps/frontend/src/app/[locale]/(marketing)/pricing/page.tsx
Tenancy and identity
- Identity and sessions
apps/backend/src/saas_core/modules/core/identity/models.py - Organizations and tenancy
apps/backend/src/saas_core/modules/core/organizations/models.py - Organization settings
apps/backend/src/saas_core/modules/core/organizations/settings_registry.py - Assistant commands
apps/backend/src/saas_core/modules/core/organizations/command_registry.py
Business modules
- Booking
apps/backend/src/saas_core/modules/shared/booking - Customer records
apps/backend/src/saas_core/modules/shared/customers - Orders and payments
apps/backend/src/saas_core/modules/shared/commerce/models.py - Plans and entitlements
apps/backend/src/saas_core/modules/shared/billing - Assistant
apps/backend/src/saas_core/modules/shared/assistant
Public content
- Site management
apps/backend/src/saas_core/modules/shared/sites - Site block rendering
packages/site-blocks/src/core-manifest.ts - Public site routes
apps/frontend/src/app/site-renderer/[[...path]]/page.tsx - Feed and media projection
apps/frontend/src/modules/shared/sites/public-projection.ts - Public Sites API
apps/backend/src/saas_core/modules/shared/sites
Platform services
- Application database
Other components
- Company operator
- Site visitor
- Crawler or feed client
Connections 18
- Company operator → SaaS panel: uses
README.md - Company operator → Marketing and pricing: views
README.md - Crawler or feed client → Feed and media projection: requests feed
apps/frontend/src/modules/shared/sites/public-projection.ts - Feed and media projection → Public Sites API: fetches public data
apps/frontend/src/modules/shared/sites/public-projection.ts - Site visitor → Public site routes: requests site
- Public site routes → Site block rendering: renders blocks
- SaaS panel → Identity and sessions: authenticates
- Identity and sessions → Organizations and tenancy: joins tenant
- Organizations and tenancy → Application database: persists tenant data
- Organization settings → Organizations and tenancy: resolves settings
apps/backend/src/saas_core/modules/core/organizations/settings_registry.py - Assistant commands → Organization settings: builds settings commands
apps/backend/src/saas_core/modules/core/organizations/settings_commands.py - Booking → Customer records: registers customer hooks
apps/backend/src/saas_core/modules/shared/booking/apps.py - Orders and payments → Customer records: registers customer hooks
apps/backend/src/saas_core/modules/shared/commerce/apps.py - Plans and entitlements → Organizations and tenancy: registers plan limits
apps/backend/src/saas_core/modules/shared/billing/apps.py - Booking → Assistant commands: registers commands
- Orders and payments → Assistant commands: registers commands
- Assistant → Assistant commands: uses commands
- Site management → Public Sites API: serves public content