Guide Déploiement Pas à Pas

🏢

Déploiement VPS Enterprise — On-Premise

Ce guide est destiné aux grandes entreprises souhaitant héberger WWXIA sur leur propre infrastructure VPS ou serveur dédié — pour un contrôle total des données, un SLA personnalisé et une intégration réseau interne.

Stack : Docker + Nginx + PostgreSQL + Redis OS : Ubuntu 22.04 LTS recommandé RAM min : 4 Go — Recommandé : 8+ Go

Préparer le VPS Ubuntu

Depuis votre VPS Ubuntu 22.04 fraîchement provisionné, mettez à jour le système et installez Docker + Docker Compose.

# Mise à jour système apt update && apt upgrade -y # Installer Docker curl -fsSL https://get.docker.com | sh ✓ Docker version 26.x installé # Installer Docker Compose v2 apt install docker-compose-plugin -y docker compose version ✓ Docker Compose version v2.x # Installer Certbot (SSL Let's Encrypt) apt install certbot python3-certbot-nginx -y # Ouvrir les ports firewall ufw allow 22 && ufw allow 80 && ufw allow 443 && ufw enable

✅ Configuration minimale

VPS 2 vCPU, 4 Go RAM
40 Go SSD NVMe
Ubuntu 22.04 LTS
Bande passante 100 Mbps

🔧 Configuration recommandée

VPS 4 vCPU, 8+ Go RAM
100 Go SSD NVMe
Ubuntu 22.04 LTS
IP fixe dédiée

Cloner et configurer le projet

Récupérez le projet WWXIA et configurez les variables d'environnement pour votre infrastructure.

# Cloner le dépôt WWXIA sur le serveur git clone https://github.com/wwxia/kimosiris-api.git /opt/wwxia cd /opt/wwxia # Copier et éditer le fichier d'environnement cp .env.example .env nano .env

# .env — Variables d'environnement WWXIA VPS

# Base de données PostgreSQL
POSTGRES_DB=wwxia_db
POSTGRES_USER=wwxia
POSTGRES_PASSWORD=CHANGEZ_CE_MOT_DE_PASSE
POSTGRES_HOST=postgres

# Application
SECRET_KEY=GENEREZ_UNE_CLE_ALEATOIRE_64_CHARS
APP_DOMAIN=app.votre-domaine.com
ENVIRONMENT=production

# Email (notifications)
SMTP_HOST=smtp.votre-domaine.com
SMTP_USER=noreply@votre-domaine.com
SMTP_PASSWORD=VOTRE_MOT_DE_PASSE_SMTP

# IA (optionnel)
OPENAI_API_KEY=sk-...
# Ou DeepSeek, Gemini, Mistral...
LLM_PROVIDER=openai
          

Lancer la stack Docker Compose

WWXIA est entièrement conteneurisé. Un seul fichier docker-compose.yml orchestre tous les services : API, Nginx, PostgreSQL, Redis.

# Construire et démarrer tous les services docker compose up -d --build ✓ [+] Building kimosiris-api ✓ [+] Running postgres ✓ [+] Running redis ✓ [+] Running kimosiris-nginx ✓ [+] Running kimosiris-api # Vérifier que tous les containers sont up docker compose ps NAME STATUS PORTS kimosiris-api Up 8000/tcp kimosiris-nginx Up 0.0.0.0:80->80, 0.0.0.0:443->443 postgres Up 5432/tcp redis Up 6379/tcp # Initialiser la base de données docker exec kimosiris-api python -m alembic upgrade head ✓ Migrations appliquées

📦 Services inclus dans docker-compose.yml

✓kimosiris-api — FastAPI + Gunicorn (4 workers)

✓kimosiris-nginx — Reverse proxy + SSL + vitrine

✓postgres — Base applicative persistante

✓redis — Cache + WebSocket Pub/Sub

○pgbackup — Sauvegarde auto PostgreSQL

Configurer le domaine et le certificat SSL

Pointez votre domaine vers l'IP du VPS et obtenez un certificat SSL gratuit via Let's Encrypt. La configuration Nginx est déjà incluse dans le projet.

# 1. Pointer DNS : app.votre-domaine.com -> IP_VPS # (Depuis votre registrar DNS) # 2. Obtenir le certificat SSL certbot --nginx -d app.votre-domaine.com ✓ Certificate obtained: /etc/letsencrypt/live/app.votre-domaine.com/ ✓ Nginx mis à jour automatiquement # 3. Renouvellement automatique (cron) echo "0 3 * * * certbot renew --quiet" | crontab - ✓ Renouvellement automatique configuré # 4. Mettre à jour la config Nginx avec votre domaine sed -i 's/app.kimosiris.com/app.votre-domaine.com/g' \ /opt/wwxia/deployment/nginx/kimosiris-https.conf docker exec kimosiris-nginx nginx -s reload ✓ RELOAD_OK

💡 La configuration Nginx est persistante : elle est stockée dans /opt/wwxia/deployment/nginx/kimosiris-https.conf et montée dans le container. Un rebuild de l'image ne l'écrase jamais.

Connecter le Bridge ERP sur site

Si votre ERP SQL Server est sur un réseau interne, installez le Bridge Windows sur une machine du réseau et pointez-le vers votre VPS privé.

# config.ini — Bridge pointant vers votre VPS privé
[server]
vps_url = wss://app.votre-domaine.com
company_id = VOTRE_COMPANY_ID
api_key = VOTRE_API_KEY

[database]
server = 192.168.1.10\SAGEINSTANCE
database = NOM_BASE_SAGE
trusted_connection = yes
          

🔐 Sécurité réseau

✓ VPN site-à-site recommandé
✓ Whitelist IP du VPS dans le firewall SQL
✓ Chiffrement TLS bout en bout
✓ Rotation API key périodique

📊 Monitoring

✓ Logs centralisés Docker
✓ Health check endpoint /health
✓ Alertes email sur crash
✓ Sauvegarde PostgreSQL auto

Mise en production & checklist Enterprise

Vérifications finales avant de basculer en production et de déployer l'application mobile auprès de vos équipes.

✅ Checklist VPS Enterprise

Tous les containers Docker démarrés (docker compose ps) Certificat SSL valide — HTTPS actif sur app.votre-domaine.com Base PostgreSQL initialisée — migrations Alembic appliquées Bridge Windows connecté — statut vert dans l'app Variables .env sécurisées — SECRET_KEY & mots de passe changés Sauvegarde automatique PostgreSQL configurée App Mobile configurée avec l'URL de votre VPS privé Renouvellement SSL automatique (cron certbot renew)

# Commandes de maintenance courantes docker compose logs -f --tail=100 # Suivi logs en temps réel docker compose restart kimosiris-api ✓ API redémarrée docker exec postgres pg_dump wwxia_db > backup_$(date +%F).sql ✓ Sauvegarde base créée docker compose pull && docker compose up -d ✓ Mise à jour vers la dernière version

🎉 Votre instance WWXIA Enterprise est opérationnelle sur votre VPS ! Contactez notre équipe pour un accompagnement dédié et une SLA personnalisée.

📞 Contacter un expert Enterprise

Créer votre compte et votre société

Rendez-vous sur app.kimosiris.com/register pour créer votre espace entreprise. Ce compte sera l'administrateur principal.

Informations requises

Nom de la société
Numéro de contribuable (NCC/IFU)
Email administrateur
Mot de passe sécurisé

Résultat

✅ Identifiant société unique (company_id)
✅ Clé API (api_key) pour le Bridge
✅ Accès immédiat à l'app web

💡 Gardez précieusement votre company_id et votre api_key — ils seront nécessaires lors de la configuration du Bridge.

🚀 Créer mon espace entreprise

Télécharger et installer WWXIA Windows

Téléchargez l'installeur Windows depuis notre centre de téléchargement. L'installation est guidée et prend moins de 5 minutes.

# Télécharger depuis : https://app.kimosiris.com/downloads/WWX-setup-2.5.0.exe # Vérification intégrité (PowerShell) : Get-FileHash WWX-setup-2.5.0.exe -Algorithm SHA256 Hash: A3F2B... (vérifiez sur notre site) # Installation silencieuse (entreprise) : WWX-setup-2.5.0.exe /silent /dir="C:\Program Files\WWX"

✅ Configuration minimale

Windows 10/11 64-bit
4 Go RAM, 500 Mo disque
Python 3.11+, .NET 6.0
SQL Server Client (si ERP local)

🔧 Configuration recommandée

Windows 11 64-bit
8 Go RAM, 2 Go SSD
Python 3.12, .NET 8.0
Accès réseau SQL Server

Installer et configurer le Bridge Windows

Le Bridge est le connecteur entre votre base SQL Server locale et le cloud WWXIA. Il s'installe comme service Windows et fonctionne en arrière-plan.

# 1. Télécharger et installer le Bridge WWX-bridge-1.8.2.exe /install ✓ Service WWXBridge installé # 2. Configurer (éditer le fichier de config) notepad "C:\Program Files\WWXBridge\config.ini"

# config.ini — Configuration du Bridge WWXIA
[server]
vps_url = wss://app.kimosiris.com
company_id = VOTRE_COMPANY_ID
api_key = VOTRE_API_KEY

[database]
server = SRVVOTRESERVEUR\SAGEINSTANCE
database = NOM_BASE_SAGE
trusted_connection = yes
# Ou authentification SQL :
# username = sa
# password = VotreMotDePasse
          

# 3. Démarrer le service net start WWXBridge ✓ Le service WWXBridge a démarré. # 4. Vérifier la connexion WWX-bridge-1.8.2.exe --status ✓ Connecté au VPS : app.kimosiris.com ✓ Base SQL Server : SRVKIM\SAGE — OK ✓ Company ID : QMAK — Authentifié

⚠️ Assurez-vous que le port 443 (HTTPS/WSS sortant) est ouvert sur votre firewall Windows et réseau d'entreprise.

Connexion et mappage de votre ERP

Une fois le Bridge connecté, configurez le mappage entre votre ERP et les modules WWXIA depuis l'interface d'administration.

ERP supportés nativement

✓Sage 100 — Configuration automatique

✓Cegid — Templates prédéfinis

✓SAP B1 — Via ODBC

✓MS Dynamics — Connecteur dédié

~Autre ERP — Mapping SQL manuel

~Personnalisé — Sur demande

# Tester la connexion Sage depuis WWXIA GET https://app.kimosiris.com/api/v1/bridge/test { "status": "connected", "bridge_version": "1.8.2", "database": "QMAK", "erp_detected": "Sage 100 v9.0", "tables_found": 247, "latency_ms": 12 }

Configuration modules métier

Activez et configurez les modules selon vos besoins. Chaque module a son assistant de configuration guidé.

🏛️

Module FNE / DGI

Entrez votre clé API FNE obtenue sur le portail DGI Côte d'Ivoire

✓ Paramètres → FNE → Clé API

🚢

Module Transit

Configurez vos transitaires, régimes douaniers et tarifs de manutention

✓ Transit → Paramètres → Config

🚛

Module Camions

Enregistrez votre flotte, configurez les trackers GPS et zones de géofencing

✓ Camions → Config → GPS Trackers

🤖

Module IA Sage

Configurez le modèle LLM (GPT-4, DeepSeek, Gemini...) et indexez vos exemples RAG

✓ IA & Prédictions → Config IA

Test final et mise en production

Validez chaque module avec la checklist de mise en production. WWXIA propose un mode démo pour tester sans impacter votre base réelle.

✅ Checklist de mise en production

Bridge connecté — indicateur vert dans la barre système Test lecture données ERP — récupération de 10 factures Sage Génération d'un PDF test — impression et vérification QR Code App Mobile installée — connexion et synchronisation vérifiée Utilisateurs créés avec rôles et permissions définis Sauvegarde automatique configurée

🎉 WWXIA est maintenant opérationnel ! Votre équipe peut commencer à l'utiliser. Consultez la documentation complète pour aller plus loin.

Guide de Déploiement