Déployer l'agence

Trois façons de déployer

Quelle que soit la méthode choisie, le site et le tableau de bord compilent l'adresse de l'API dans leur JavaScript quand ils sont construits : construisez-les donc avec les adresses publiques, jamais les adresses locales.

Docker Compose sur un seul serveur

Copiez le dossier du pack sur le serveur et placez un .env à côté de docker-compose.yml avec les trois adresses publiques. Les origines autorisées de l'API, l'adresse du tableau de bord, les adresses des photos et l'adresse de l'API côté frontends en sont tous déduits.

SITE_URL=https://www.your-agency.com
ADMIN_URL=https://admin.your-agency.com
API_URL=https://api.your-agency.com
MEDIA_HOSTNAME=api.your-agency.com

MEDIA_HOSTNAME est optionnel, un hôte ou plusieurs séparés par des virgules (ajoutez l'hôte de votre bucket quand les fichiers sont téléversés vers un bucket) : les photos de ces hôtes https sont redimensionnées par Next.js, et toute autre photo se charge telle quelle. Puis construisez et démarrez en arrière-plan :

docker compose up --build -d

• Faites pointer chaque domaine vers le serveur via un reverse proxy qui sert le HTTPS (Caddy, Nginx ou Traefik), en redirigeant vers les ports 3030, 3031 et 8000.
• Derrière ce proxy, définissez TRUST_PROXY=1 dans back-end/.env, pour que les limites de connexion, de formulaire de contact et de demande de visite comptent chaque visiteur plutôt que le proxy. Le conteneur de l'API lit back-end/.env s'il existe, c'est aussi là que vont les clés optionnelles.
• Sans JWT_SECRET à vous, l'API en génère un à son premier démarrage et le garde dans le volume velra-data. La base et les fichiers téléversés vivent aussi dans ce volume : sauvegardez-le.
• Le premier démarrage alimente l'agence de démonstration, sauf si SEED_DEMO_DATA=false est dans le .env. Gardez-le pour le premier démarrage : c'est le seed qui crée les comptes.

L'API à partir de son Dockerfile

Faites pointer l'hébergeur vers le dossier de l'API (back-end/ dans le Full Stack). L'image écoute sur PORT (8000 sauf si l'hébergeur en impose un autre), répond à GET /api/health dès que sa base répond, et garde SQLite et les fichiers téléversés dans /data.

• Montez un volume persistant sur /data. Sans volume, chaque déploiement repart d'une base vide.
• Définissez CORS_ORIGIN avec les adresses du site et du tableau de bord (séparées par des virgules), FRONTEND_URL avec celle du tableau de bord, et PUBLIC_MEDIA_URL avec l'adresse publique de l'API suivie de /media.
• Définissez SEED_DEMO_DATA=true pour le premier démarrage sur un nouveau volume : la valeur par défaut de l'image est false, qui crée les tables sans compte. Une base existante n'est jamais réalimentée.
• Définissez votre propre JWT_SECRET, ou laissez le conteneur en générer un et le garder dans /data/.jwt-secret.
• Définissez TRUST_PROXY=1 : une plateforme d'hébergement place un proxy devant le conteneur.
• Avec MySQL (DB_TYPE=mysql et les cinq variables DB_*), le conteneur ne crée pas les tables. Lancez une fois node dist/database/seeder.js (agence de démonstration) ou node dist/database/sync-schema.js (tables vides) avec le même environnement.
• Les fichiers téléversés sur le volume survivent à un redéploiement ; pour ne pas les garder sur le serveur, définissez les cinq variables R2_* pour un bucket.

Le site et le tableau de bord à partir de leurs Dockerfiles

Faites pointer l'hébergeur vers le dossier de l'application et donnez-lui les valeurs NEXT_PUBLIC_* comme arguments de build, non comme variables d'exécution : elles sont compilées. Chaque image sert le serveur autonome de Next.js sur PORT (3030 pour le site, 3031 pour le tableau de bord, sauf si l'hébergeur en impose un autre).

Le serveur du site interroge aussi l'API pendant le rendu des pages de bien et du sitemap. Avec une adresse publique d'API qui fonctionne aussi depuis le serveur, rien de plus n'est nécessaire ; API_INTERNAL_URL à l'exécution la remplace quand le serveur doit utiliser une autre adresse.

Node.js seul

Construisez chaque application une fois sur l'hôte, puis démarrez-la. Réglez le .env des frontends sur les adresses publiques avant yarn build.

L'API écoute sur 0.0.0.0 et lit PORT. Gardez le fichier SQLite et MEDIA_UPLOAD_DIR sur un stockage qui survit à un déploiement, ou utilisez MySQL et un bucket.

Vos premiers comptes

Il n'y a pas de page d'inscription : les deux comptes du tableau de bord viennent du seed. Pour le premier démarrage, utilisez l'agence de démonstration, connectez-vous, puis faites-la vôtre :

1. Changez les deux mots de passe dans Paramètres, Sécurité, ou créez votre propre Super Admin dans Gestion des admins et supprimez les comptes du seed.
2. Archivez ou supprimez les biens d'exemple, et supprimez les quartiers d'exemple dont vous n'avez pas besoin.
3. Clôturez les demandes d'exemple et annulez les visites d'exemple : elles n'ont pas de suppression.
4. Renseignez le nom, le slogan, la description et l'e-mail de contact de l'agence dans Paramètres, Agence, et les biens à la une de la page d'accueil dans Paramètres, Page d'accueil.

Mise en ligne

Avant que l'agence soit accessible depuis Internet :

1. Dans l'environnement de l'API, NODE_ENV=production et un JWT_SECRET long et aléatoire à vous (Docker en génère un quand aucun n'est défini). En production, l'API refuse de démarrer sans CORS_ORIGIN et indique quelle valeur manque.
2. CORS_ORIGIN sur le site et le tableau de bord, FRONTEND_URL sur le tableau de bord, PUBLIC_MEDIA_URL sur l'API suivie de /media.
3. La base et les fichiers téléversés sur un stockage persistant, avec une sauvegarde.
4. La vérification de santé de l'hébergeur sur /api/health, et TRUST_PROXY=1 derrière un proxy.
5. Les deux frontends construits avec les valeurs publiques NEXT_PUBLIC_*.
6. Sur le site, votre marque dans src/config/brand.config.ts, et la politique de confidentialité dans messages/privacy réécrite pour votre agence et votre pays.
7. Les mots de passe du seed changés, ou les comptes du seed supprimés.
8. DEMO_MODE=false sur l'API et NEXT_PUBLIC_DEMO_MODE=false dans les deux frontends, comme livré.

• Variables d'environnement
• Image de marque