Claude 358cf0643f Fournisseur : repli sur l'API FF pour les articles absents de la base miroir
Les articles récents (503996, 504022, 504025, 505349…) n'ont aucune ligne
artfou1 dans la recopie FF : ni référence, ni fournisseur. Le Hit Parade
et les pages Stock les affichaient en « Sans fournisseur ».

Les lignes restées « Sans fournisseur » après la requête SQL sont
complétées par l'API FF en direct, avec la règle du tableau de bord :
fournisseur de la dernière entrée en stock, sinon celui du référentiel.
Au plus 200 articles par chargement (12 en parallèle), réponses gardées
en mémoire le temps du cache FF pour ne pas réinterroger l'API à chaque
onglet.

Le test d'intégration sert une fausse API FF et vérifie que l'article
absent de la base est complété ; il échoue sans le repli.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DhSZx8CCuqoKrDw7unFqGq
2026-10-19 20:12:18 +00:00

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).
S
Description
No description provided
Readme
5.3 MiB
0 Stars 1 Watchers 0 Forks
Languages
Rust 49%
TypeScript 41%
JavaScript 7.9%
HTML 1.2%
CSS 0.8%
Other 0.1%