How yahyanaim/architecture works
This is a multi-tenant SaaS starter: a React client calls an Express API, middleware establishes identity and tenant scope, controllers validate requests, domain services apply authentication, billing, user, OAuth, and webhook rules, and repositories persist state. Registration creates an organization, subscription, user, and session; later requests return tenant-scoped results. The tree and README document additional routes and adapters whose implementations were not sampled, so those links are kept at their documented entry points rather than inferred in detail.
Main entry points: billingRoutes.ts Billing Routes · app.ts Express API · SharedUserRepository.ts Repository Composition · router.tsx App Router
Components 24
React Client
- React Shell
src/App.tsx - App Router
src/router.tsx - Auth Features
src/features/auth - Workspace Features
src/features/workspaces - Billing Features
src/features/billing
API Boundary
- Express API
server/app.ts - Auth Routes
server/api/routes/authRoutes.ts - Billing Routes
server/api/routes/billingRoutes.ts - Webhook Controller
server/api/controllers/WebhookController.ts - Access Middleware
server/api/middleware/authenticate.ts - Tenant Resolution
server/api/middleware/resolveTenant.ts
Domain Services
- Auth Service
server/domain/services/AuthService.ts - OAuth Service
server/domain/services/OAuthService.ts - Billing Service
server/domain/services/BillingService.ts
Persistence Layer
- Repository Composition
server/infrastructure/repositories/SharedUserRepository.ts - SQLite Repositories
server/infrastructure/repositories/SqliteUserRepository.ts - Application Database
server/infrastructure/database.ts
External Integrations
- JWT Token Service
server/infrastructure/security/JwtTokenService.ts - Durable Job Queue
server/infrastructure/queue.ts - Webhook Dispatcher
server/infrastructure/webhooks/WebhookDispatcher.ts
Other components
- User
- OAuth Providers
- Webhook Targets
- Stripe Billing
Connections 30
- User → React Shell: uses
- React Shell → App Router: starts
- App Router → Auth Features: dispatches
- App Router → Workspace Features: dispatches
- App Router → Billing Features: dispatches
- Auth Features → Express API: requests
- Workspace Features → Express API: requests
- Billing Features → Express API: requests
- Express API → Auth Routes: mounts
- Express API → Billing Routes: mounts
- Billing Routes → Access Middleware: authenticates
- Billing Routes → Tenant Resolution: resolves tenant
- Auth Routes → Auth Service: invokes
- Auth Routes → OAuth Service: invokes
- Auth Service → Repository Composition: persists state
- Auth Service → JWT Token Service: mints tokens
- Auth Service → Durable Job Queue: queues emails
- OAuth Service → OAuth Providers: exchanges codes
- OAuth Service → Repository Composition: links accounts
- Billing Routes → Billing Service: updates billing
- Billing Service → Repository Composition: stores subscription
- Billing Routes → Stripe Billing: reads invoices
- Webhook Controller → Repository Composition: stores endpoints
- Webhook Controller → Webhook Dispatcher: dispatches delivery
- Webhook Controller → Durable Job Queue: queues retry
- Webhook Dispatcher → Webhook Targets: delivers events
- Repository Composition → SQLite Repositories: selects adapters
- SQLite Repositories → Application Database: reads writes
- Durable Job Queue → Application Database: persists jobs
- Access Middleware → JWT Token Service: verifies tokens