CloudAlt Backend Documentation
CloudAlt’s backend consists of three Django REST API services serving our multi-brand hospitality and services platform.
Architecture Overview
Section titled “Architecture Overview”The backend is organized into 3 Business Units (BUs), each with its own Django project:
🛁 BU #1: Hospitality (stays/)
Section titled “🛁 BU #1: Hospitality (stays/)”Port: 8000
Divisions:
- Stay Overnight - Short-term hospitality marketplace (Pink Guest, Orange Guest, Green Host, Purple Guest)
- Roommate Works - Long-term roommate matching
- Stay Match - Travel companion matching
🔍 BU #2: Discovery (discovery/)
Section titled “🔍 BU #2: Discovery (discovery/)”Port: 8001
Divisions:
- AltFinder - Alternative item/service discovery and barter (AltFinder, Pink Finder, Orange Finder)
🌆 BU #3: Services (services/)
Section titled “🌆 BU #3: Services (services/)”Port: 8002
Divisions:
- Pride City - LGBTQ+ community platform
- Bonjour Locker - Service marketplace and provider network
Technology Stack
Section titled “Technology Stack”- Framework: Django 5.x + Django REST Framework
- Database: PostgreSQL via Supabase (separate schemas per division)
- Real-time: GCP Firestore (chat, notifications)
- Storage: GCP Cloud Storage (media files)
- Deployment: GCP Cloud Run (containerized, auto-scaling)
- API Docs: drf-spectacular (OpenAPI/Swagger)
Quick Links
Section titled “Quick Links”- Getting Started - Setup and configuration
- Architecture - System design and decisions
- API Reference - Endpoint documentation
- Deployment - Running in production
Repository
Section titled “Repository”Source code: github.com/xavierdurant/cloudalt-backend