How bloom-housing/bloom works
Main Components
a) Frontend Applications:
• Public Site (Next.js application for general public)
• Partners Site (Next.js application for housing developers/managers)
• UI Component Libraries:
• UI Seeds (design system components)
• UI Components (legacy component library)
b) Backend Services:
• NestJS API Server
• Prisma ORM Layer
• PostgreSQL Database
c) Shared Components:
• Shared Helpers Package
• Authentication Services
• File Storage (for assets/images)
┌─ Client Layer ─────────────────────────────────────┐
• ┌─ Public Site ─┐ ┌─ Partners Site ┐ │
• (Next.js) │ │ (Next.js) │ │
• ┘ └────────────────┘ │
• ┌─ UI Libraries ────────────────────┐ │
• Seeds │ UI Components Library │ │
• ┘ │
• Shared Layer ──────────────────────────────────┐ │
• Shared Helpers (Types/Components/Utils) │ │
• ┘ │
┌─ API Layer ────────────────────────────────────────┐
• ┌─ NestJS API Server ────────────────────────┐ │
• Controllers │ Services │ Guards │ DTOs │ │
• ┘ │
• ┌─ Prisma ORM Layer ─────────────────────────┐ │
• Schema │ Migrations │ Seed Scripts │ │
• ┘ │
• ┘
┌─ Data Layer ───────────────────────────────────────┐
• PostgreSQL Database │
• ┘
Key Relationships
• One-way dependency from frontends to shared helpers
• Data flow from API through Prisma to PostgreSQL
• Authentication flow across components
Additional Elements
• External integrations (email service, SMS service)
• Development tools (Jest, Cypress)
• Deployment paths
• Security boundaries
Important Details to Note
• Version control workflow
• API endpoints groups (listings, applications, users)
• Environment configuration flow
• Testing boundaries