Options de deploiement

QuoteNode prend en charge plusieurs modeles de deploiement, tous bases sur des conteneurs Docker. Choisissez la topologie selon les personnes qui doivent ouvrir l’application et les liens publics d’offre.

Chemins recommandes

Scenario	Guide recommande
Evaluation sur un seul ordinateur	Laptop local
Essai limite au bureau sur Windows	Serveur LAN Windows
Serveur Linux interne au bureau	Serveur LAN Linux
Beta publique sur votre VPS	Serveur public Ubuntu
Beta publique avec proxy et UI de deploiement geres	Coolify
Plateforme Docker UI/NAS existante	Portainer, QNAP ou NAS

La page courte de choix est le Guide d’installation. Utilisez la Resolution des problemes d’installation pour les problemes d’URL, CORS, DNS, SMTP et perte de secrets.

Topologie de production

Un deploiement public ressemble generalement a ceci :

Internet
  │
  ▼
Reverse proxy HTTPS public
  └── service frontend
        ├── application Vue statique
        └── routes /api et /offer vers le backend

Backend -> PostgreSQL
Backend -> Gotenberg pour la generation PDF
Backup worker -> PostgreSQL et fichiers persistants

Coolify fournit lui-meme le reverse proxy HTTPS public. Le stack Docker Compose de production standard peut aussi executer son propre proxy Caddy interne.

Services

Conteneur	Raison d’etre
frontend	Sert l’application Vue et route le trafic navigateur.
backend	API Java / Spring Boot, logique metier, liens publics, orchestration PDF.
postgres	Base de donnees PostgreSQL.
gotenberg	Service de conversion HTML vers PDF.
backup-worker	Sauvegardes planifiees de la base et des fichiers.

Donnees persistantes

Donnee	Pourquoi elle compte
Volume PostgreSQL	Base de donnees principale.
Volume uploads	Images produit, logos, pieces jointes CRM.
Volume PDF	Documents PDF generes.
Volume backup	Archives locales avant copie hors site.
Volume GeoIP	Base MaxMind optionnelle.

Sauvegardez .env separement des volumes Docker. La valeur DB_ENCRYPTION_KEY dans .env est requise pour dechiffrer les champs sensibles.

Metadonnees de release et verifications de mise a jour

QuoteNode peut afficher aux administrateurs une notification lorsqu’une version amont plus recente est disponible.

• Manifeste public : https://quotenode.dev/releases/latest.json
• Flag frontend : VITE_RELEASE_CHECK_ENABLED
• URL override frontend : VITE_RELEASE_MANIFEST_URL

Cette verification est distincte du controle de rechargement frontend propre a chaque installation :

• /app-version.json repond : “cette installation a deployee un bundle frontend plus recent”.
• releases/latest.json repond : “une version QuoteNode amont plus recente existe”.

Les deploiements offline ou prives peuvent desactiver cette verification amont ou la pointer vers un miroir interne.

Variables d’environnement

Pour les variables orientees installation, voir Variables d’environnement de deploiement. Pour le catalogue complet, voir la Reference des variables d’environnement.

Notes de securite

• Les deploiements publics exigent HTTPS.
• CORS_ALLOWED_ORIGINS doit correspondre exactement a l’origine du navigateur.
• LICENSE_SKIP_SIGNATURE_CHECK doit etre absent ou defini a false dans les vrais deploiements.
• N’exposez pas PostgreSQL, Gotenberg ou backup-worker publiquement.
• Les reverse proxies doivent conserver les headers IP client pour les logs de securite et les protections des liens publics.