Comprendre le projet¶

Domaine metier¶

Boaz Housing gere la mise en relation logement / souscripteur :

Logements : biens proposes (avec localisation GPS, cartographie Google Maps).
Clients : souscripteurs.
Souscriptions : demande d'un client sur un logement, avec statut et suivi.
Paiements : reglement via Stripe (preuves de paiement stockees).
Documents livrables : attestations d'hebergement generees automatiquement.
OTP : verification par code a usage unique.

Architecture technique¶

flowchart TB
    subgraph Frontend
      R[React + Google Maps]
    end
    subgraph Backend
      API[FastAPI]
      WS[WebSocket temps reel]
      GEN[Generation PDF attestations]
    end
    DB[(PostgreSQL)]
    ST[Stripe]
    R --> API
    API --> DB
    API --> ST
    API --> GEN
    WS --- R

Structure du code¶

backend/ : application FastAPI (app/), migrations Alembic (alembic/), entrypoint.
frontend/ : application React (src/).
docker-compose.{local,test,prod}.yml : un environnement isole par fichier.
scripts/deploy/ : scripts de deploiement (test, prod).
scripts/backup/ : sauvegarde S3 avant deploiement prod.
Doc_tech_important/ : cette documentation.

Tables principales (base de donnees)¶

logements, clients, souscriptions, users, legacy_documents, otps (migrations Alembic 001 -> 016, appliquees automatiquement au demarrage du backend).