Documentation Technique

☰ Table des matières

Introduction à WWXIA

WWXIA est une plateforme ERP moderne multi-plateformes qui se connecte à votre ERP SQL Server existant via un pont WebSocket sécurisé. Elle offre des interfaces Web, Windows et Mobile pour gérer l'ensemble de votre activité — sans migration de données.

Composants de la plateforme

• App Web — SPA React/TypeScript hébergée sur app.kimosiris.com
• App Windows — Application desktop Python/CTk avec accès SQL Server direct
• App Mobile — iOS & Android avec notifications push et GPS
• API Backend — FastAPI Python, Gunicorn, Redis, PostgreSQL
• Bridge Windows — Service WebSocket reliant SQL Server au Cloud

Installation Windows

L'installeur WWXIA Windows configure automatiquement Python, les dépendances et crée les raccourcis bureau.

# Télécharger l'installeur
Invoke-WebRequest -Uri "https://app.kimosiris.com/downloads/WWX-setup-2.5.0.exe" -OutFile WWX-setup.exe

# Vérifier l'intégrité
Get-FileHash WWX-setup.exe -Algorithm SHA256

# Lancer l'installation
.\WWX-setup.exe /silent

Bridge WebSocket

Le Bridge est le composant critique qui permet à l'application Web et Mobile d'accéder à votre base SQL Server locale en temps réel. Il s'installe comme service Windows.

Installation du Bridge

# Installer en tant que service Windows
WWX-bridge.exe /install /autostart

# Configurer (fichier INI)
[server]
vps_url = wss://app.kimosiris.com
company_id = VOTRE_COMPANY_ID
api_key = VOTRE_API_KEY

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

# Démarrer le service
net start WWXBridge

# Vérifier le statut
WWX-bridge.exe --status
✓ Connecté — Latence: 12ms — Company: QMAK

Architecture interne du Bridge

Le Bridge utilise une connexion WebSocket persistante vers le VPS. En environnement multi-workers (Gunicorn), le Bridge publie/souscrit via Redis Pub/Sub pour garantir la cohérence entre les workers.

Architecture Technique

WWXIA repose sur une architecture microservices conteneurisée avec Docker Compose :

services:
  nginx:     # Reverse proxy — ports 80/443
  api:       # FastAPI + Gunicorn — 4 workers
  redis:     # Cache + Pub/Sub Bridge
  postgres:  # Base applicative
  celery:    # Tâches asynchrones
  flower:    # Monitoring Celery

API Reference

L'API REST est disponible sur https://api.WWX.com/api/v1/. Documentation Swagger interactive sur /docs.

Authentification

# Obtenir un token JWT
POST /api/v1/auth/login
{
  "email": "admin@societe.com",
  "password": "motdepasse",
  "company_id": "QMAK"
}

# Réponse
{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI...",
  "token_type": "bearer",
  "expires_in": 3600,
  "company_id": "QMAK",
  "user_role": "admin"
}

Endpoints principaux

# Données ERP via Bridge
GET  /api/v1/bridge/status           # Statut connexion Bridge
GET  /api/v1/erp/documents           # Factures ERP
GET  /api/v1/erp/clients             # Clients ERP
GET  /api/v1/erp/articles            # Catalogue articles

# FNE / Certification DGI
POST /api/v1/fne/certify             # Certifier une facture
GET  /api/v1/fne/certifications      # Liste certifications
GET  /api/v1/fne/pdf/{id}            # Générer PDF DGI

# GPS & Camions
GET  /api/v1/gps/positions/current   # Positions GPS live
GET  /api/v1/camions/missions        # Missions en cours

# IA Sage
POST /api/v1/ai/query                # Requête IA en langage naturel
GET  /api/v1/ai/artifact/{id}        # Récupérer un artifact HTML

Module FNE / e-Facture

Le module FNE certifie vos factures auprès de la Direction Générale des Impôts (DGI) de Côte d'Ivoire, conformément au décret sur la facturation normalisée électronique.

Flux de certification

• Extraction de la facture depuis votre ERP via le Bridge SQL Server
• Enrichissement avec les données client (NCC, adresse, régime fiscal)
• Envoi à l'API DGI CI pour validation et attribution du numéro FNE
• Apposition du QR Code normalisé sur le PDF généré
• Stockage de la certification dans la base locale SQLite pour réconciliation

Configuration clé API FNE

# Dans l'application Windows :
Paramètres → FNE → Clé API

# Ou via API :
PUT /api/v1/fne/config
{
  "api_key": "VotreCléDGI",
  "ncc": "1234567A",
  "regime": "RNI"
}

Module IA Sage

L'IA Sage utilise un architecture RAG (Retrieval-Augmented Generation) pour répondre à des questions en langage naturel sur vos données ERP.

Exemple d'utilisation

# Requête utilisateur
POST /api/v1/ai/query
{
  "query": "Quel est le chiffre d'affaires par client ce mois-ci ?",
  "format": "html"
}

# Réponse avec artifact HTML
{
  "answer": "Voici le CA par client pour Mai 2026...",
  "artifact": {
    "html": "<table>...</table>",
    "type": "table",
    "title": "CA par client — Mai 2026"
  },
  "sql_generated": "SELECT CT_Num, SUM(DO_TotalHT) FROM F_DOCENTETE...",
  "execution_time_ms": 245
}

Déploiement VPS

Le backend WWXIA se déploie sur n'importe quel VPS Linux avec Docker. Configuration minimale : 2 vCPU, 4 Go RAM, 40 Go SSD.

Déploiement rapide

# Cloner le repo
git clone https://github.com/WWX/WWX-api /opt/WWX-api
cd /opt/WWX-api

# Configurer l'environnement
cp .env.example .env
nano .env  # Editer les variables

# Lancer les containers
docker compose up -d

# Vérifier le statut
docker compose ps
WWX-nginx    running  0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp
WWX-api      running  healthy  0.0.0.0:8000->8000/tcp
WWX-redis    running  healthy
WWX-postgres running  healthy

SSL & Nginx

Le certificat SSL Let's Encrypt est géré automatiquement par Certbot dans le container Nginx.

# Obtenir un certificat SSL
docker exec WWX-nginx certbot --nginx \
  -d app.kimosiris.com \
  -d api.WWX.com \
  -d www.WWX.com \
  --email admin@WWX.com \
  --agree-tos --non-interactive

# Renouvellement automatique (cron)
0 2 * * * docker exec WWX-nginx certbot renew --quiet