Deploiement avec Docker Compose

Cette methode deploie l'ensemble des services HCW@Home dans des conteneurs Docker. C'est l'approche recommandee pour le developpement, les tests et les environnements cloud.

Prerequis

• Docker Engine 20+ et Docker Compose v2
• 2 Go de RAM minimum
• Un nom de domaine (production) ou localhost (developpement)

Architecture des services

graph TD
    subgraph Services externes
        LK[LiveKit - WebRTC SFU]
        SMTP[Serveur SMTP]
        SMS[Passerelle SMS - optionnel]
    end

    subgraph Reverse Proxy
        NGINX[Nginx / Traefik / Caddy]
    end

    subgraph Frontends
        PRACT[Practitioner :8080]
        PAT[Patient :8081]
        ADM[Admin :8082]
    end

    subgraph Backend
        API[API :8000 - Django]
        CEL[Celery Worker]
        SCHED[Celery Beat]
        MIG[Migrate]
    end

    subgraph Donnees
        PG[(PostgreSQL :5432)]
        RD[(Redis :6379)]
    end

    NGINX --> PRACT
    NGINX --> PAT
    NGINX --> ADM
    PRACT --> API
    PAT --> API
    ADM --> API
    API --> PG
    API --> RD
    API --> LK
    CEL --> PG
    CEL --> RD
    CEL --> SMTP
    CEL --> SMS
    SCHED --> RD
    MIG --> PG

Mise en place rapide

1. Recuperer le fichier docker-compose

wget https://raw.githubusercontent.com/HCW-home/hcw/refs/heads/master/docker-compose.yml

2. Configurer l'environnement

Recuperer les images :

TAG=0.10.0 docker compose pull

3. Lancer les services

docker compose up -d

Au premier lancement, le service migrate applique automatiquement les migrations de base de donnees.

4. Creer un tenant

HCW@Home utilise le multi-tenancy avec isolation par schema PostgreSQL. Chaque tenant possede ses propres donnees, utilisateurs et configuration. Les tenants sont crees via le shell Django.

docker compose exec api python3 manage.py create_tenant

• schema name : localhost
• name : localhost
• domain : 127.0.0.1

docker compose exec api python3 manage.py tenant_command createsuperuser -s localhost

5. Charger les donnees de test (optionnel)

docker compose exec api python manage.py loaddata initial/TestData.json

Cela cree des utilisateurs de test (mot de passe : Test1234). Voir le README pour la liste complete.

Services et ports

Volumes persistants

Les donnees sont stockees dans le dossier ./data/ :