CollectFlow
CollectFlow est une application de révision d'assortiment et d'analyse de performances des produits en point de vente, conçue pour consolider les données issues de plusieurs fournisseurs et magasins.
Architecture
| Partie | Technologie | Dossier |
|---|---|---|
| Serveur (API, base, FF Nancy, Qlik, synchro nocturne) | Rust — Axum, sqlx, chromiumoxide | server/ |
| Interface | React 19 + Tailwind 4, compilée en fichiers statiques par Vite | src/ |
Un seul binaire Rust sert l'API JSON (/api/..., dont l'API publique /api/v1) et l'interface compilée. Plus de Node.js à l'exécution.
Prérequis
- Docker et Docker Compose (déploiement)
- PostgreSQL 16+ (base séparée, non fournie par le conteneur)
- Pour développer : Rust stable (
rustup) et Node.js 22+
Lancer avec Docker
L'image est construite par GitHub Actions à chaque mise à jour de main et publiée sur ghcr.io/r0m1k3/collectflow:latest. Le docker-compose.yml la récupère à chaque démarrage (pull_policy: always) : une nouvelle version s'installe au prochain docker compose up -d, sans rien compiler sur le serveur.
# Une seule fois, si le paquet GHCR est privé (jeton GitHub avec le droit read:packages) :
echo <JETON> | docker login ghcr.io -u <utilisateur-github> --password-stdin
# Démarrer / mettre à jour :
docker compose up -d
L'application est accessible sur http://localhost:5643. Elle est attachée au réseau Docker externe nginx_default pour être exposée derrière le reverse proxy Nginx (docker network create nginx_default s'il n'existe pas).
Construire l'image localement plutôt que la télécharger : docker compose build.
Données et réglages
Le volume collectflow-data (/app/data) conserve les réglages saisis dans Paramètres (.db-config.json : base, Qlik, API FF, synchro nocturne), les comptes de secours (users.json) et le secret de session (.auth-secret, si AUTH_SECRET n'est pas défini). Il est repris tel quel depuis l'ancienne version Node : comptes et mots de passe restent valables (seules les sessions ouvertes sont à refaire).
Variables d'environnement utiles : DATABASE_URL, AUTH_SECRET, FF_API_BASE_URL, QLIK_HOST / QLIK_USER / QLIK_PWD (et les réglages fins QLIK_*), PG_STATEMENT_TIMEOUT_MS, FF_CACHE_TTL_S, RUST_LOG (niveau de journalisation ; par défaut info, avec sqlx et Chromium limités aux avertissements).
Développement local
# Serveur (port 5643) — tables créées et compte admin/admin initialisé au premier démarrage
cd server
DATABASE_URL=postgres://postgres:postgres@localhost/collectflow cargo run
# Interface (port 5173, /api relayé vers le serveur)
npm install
npm run dev
Vérifications : cargo test (dans server/), npm run lint, npm run build.
Structure
server/src/— serveur Rust, un module par domaine :auth(sessions, clés d'API),ff(base miroir et API FF Nancy),qlik(données réseau),grid(révision d'assortiment, API/api/v1),produits,admin(comptes, paramètres, synchronisation nocturne).server/sql/init.sql— schéma joué (idempotent) à chaque démarrage.src/— interface React :app/(écrans, mêmes dossiers que les URL),features/*par domaine,components/partagés,router.tsx(table des routes),lib/rpc.ts(appels au serveur).server/PORTING.md— contrat entre l'interface et le serveur (actions, données de pages, routes).