Fabri·Ka

Tous les produits québécois. Un seul endroit.
www.fabri-ka.com

Les pastilles « produits / boutiques live / registre QC / régions » sont dynamiques : elles interrogent https://www.fabri-ka.com/api/stats en direct.

# Description

Fabri-Ka est le répertoire des produits québécois : un agrégateur de découverte qui recense 384 535 produits (au 2026-08-28, /api/stats live) provenant de 1 580 boutiques en ligne du Québec, couvrant les 17 régions administratives de la province. Chaque produit renvoie vers la boutique d'origine — aucune vente sur Fabri-Ka : les prix, photos et stocks appartiennent aux marchands sources.

Acheter québécois demande de connaître des centaines de boutiques dispersées — érablières, microbrasseries, savonneries, ébénistes, torréfacteurs, fermes… Fabri-Ka retourne le problème : un pipeline de découverte recense les boutiques en ligne du Québec (4 082 boutiques vérifiées au registre), des connecteurs par plateforme aspirent leurs catalogues publics complets, et un moteur de recherche unique les rend trouvables — filtrés par catégorie, région et origine de fabrication (classes A–E).

Contrairement à un agrégateur classique (1 connecteur / site), Fabri-Ka utilise 1 connecteur / plateforme ecommerce : le même code Shopify sert des centaines de boutiques, piloté par le registre data/stores.json produit par la recherche.

# Fonctionnalités

• Recherche de produits — plein-texte FTS5 accent-insensible sur 384 535 produits, filtres catégorie / région / origine / prix, tri, pagination, fiches riches (galerie, boutique, produits liés).
• Répertoire de boutiques — 1 580 boutiques avec produits (sur 4 082 vérifiées), fiches enrichies : logo, région, plateforme, stats de prix, politique de livraison (colonne shipping_info, extraite des pages politiques), catégories, boutiques similaires.
• Statistiques — tableau de bord analytique /stats (module commun ka-stats) : totaux, médianes, histogrammes, ventilation régionale, croissance — et rapports de marché PDF générés à la volée (/api/report.pdf, moteur kapdf, 5 modes + rapports personnalisés).
• Catégories — taxonomie de 20 catégories (épicerie fine 44 k · mode 43 k · bijoux 39 k · …) avec ~350 pages programmatiques SEO (/categorie/erable, /region/monteregie, combinaisons non vides).
• Classification d'origine A–E — chaque boutique justifiée par une évidence conservée (certifications Aliments du Québec / Les Produits du Québec, associations, wording du site).
• SEO / SSR — 385 000+ pages indexables : HTML complet dès la 1ʳᵉ requête, JSON-LD schema.org, sitemaps exhaustifs, 301/404/410 propres (détails plus bas).
• « Inscrire mon atelier » — canal d'auto-inscription des artisans (/inscrire → POST /api/inscriptions) : dépôt public en quarantaine (rien n'est publié sans validation), anti-abus honeypot + 5 dépôts/24 h/IP, décision admin approve|reject avec vérification du site par le pipeline verify avant ajout au registre.
• KA ID (SSO) + favoris « Mon univers Ka » synchronisés au hub groupe-ka.com.
• Widget KA Agent — bulle de chat Groupe KA (ka-agent.js).
• Mobile-first — barre d'onglets, filtres en bottom sheet, galeries swipe, CTA collant, PWA-lite, fr-CA d'abord.
• Supervision — connecteurs surveillés par les gardiens autonomes du Groupe KA (agents ka6, supervision api-ka) ; /api/stats expose le sync_log et les boutiques désactivées.

# Visite guidée

10 captures du site en production (2026-08-28, desktop) — chaque image pointe la page réelle de www.fabri-ka.com.

# 1 · Accueil — /

La porte d'entrée : masthead vert profond à liseré terracotta, recherche plein-texte immédiate, compteurs live (produits · boutiques · régions), entrées rapides vers les 20 catégories et les 17 régions administratives. Display serif Fraunces, DA v3 « catalogue éditorial ».

# 2 · Catalogue de produits — /produits

Le cœur du site : 384 535 produits québécois interrogés en plein-texte FTS5 accent-insensible, filtrés par catégorie / région / origine (A–E) / fourchette de prix, triés et paginés. Cartes sans cadre, photos 10 px radius, prix en serif ; chaque carte renvoie vers la boutique d'origine (aucune vente sur Fabri-Ka).

# 3 · Répertoire des boutiques — /boutiques

1 580 boutiques avec produits en ligne (sur 4 082 vérifiées au registre) : index à filets, logo, région, plateforme ecommerce, nombre de produits. Chaque fiche boutique s'enrichit de stats de prix, de la politique de livraison extraite et de boutiques similaires.

# 4 · Statistiques — /stats

Le tableau de bord analytique (module commun ka-stats) : totaux, médianes de prix, histogrammes, ventilation régionale et par catégorie, croissance du catalogue — plus les rapports de marché PDF générés à la volée (/api/report.pdf, moteur kapdf, 5 modes + rapports personnalisés).

# 5 · À propos — /a-propos

La mission expliquée aux visiteurs : pourquoi un agrégateur de produits québécois, comment fonctionne le pipeline de découverte (registre → connecteurs par plateforme → moteur de recherche), et ce que signifient les classes d'origine A–E justifiées par évidence conservée.

# 6 · Contact — /contact

Le canal de contact du site : questions générales, signalements, et demandes de retrait — tout ayant droit peut demander le retrait de ses données (voir la section conformité).

# 7 · Inscrire mon atelier — /inscrire

L'auto-inscription des artisans et fabricants : un formulaire public dépose la candidature en quarantaine (POST /api/inscriptions, statut pending — rien n'est publié sans validation). Anti-abus honeypot + limite 5 dépôts/24 h/IP ; à l'approbation, le site est vérifié par le pipeline verify puis ajouté au registre (source auto_inscription) — connecté si un catalogue public répond, sinon fiche annuaire.

# 8 · Page catégorie — /categorie/alcool

Exemple des pages programmatiques SEO par catégorie : microbrasseries, distilleries, vignobles et cidreries du Québec réunis sous /categorie/alcool, avec compteurs réels, filtres et maillage interne. La taxonomie compte 20 catégories et ~350 pages programmatiques non vides (catégorie × région).

# 9 · Page région — /region/abitibi-temiscamingue

Le pendant régional : chacune des 17 régions administratives a sa vitrine — ici l'Abitibi-Témiscamingue — listant ses boutiques et produits locaux. Acheter local, au sens propre : le filtre région s'appuie sur la localisation vérifiée des boutiques au registre.

# 10 · Documentation — /doc/

La page /doc illustrée (standard Groupe Ka) : guide complet de la plateforme avec captures, architecture et FAQ, déclinée en PDF téléchargeable — liée depuis le pied de page de chaque page du site.

# Galerie

Captures du 2026-08-25 — DA v3 « catalogue éditorial » (mobile 390×844 · desktop 1440×900).

Mobile

Accueil — masthead vert profond, KA Tabbar	Catalogue — cartes sans cadre	Catégorie — érable
Index des boutiques à filets	KPI stats en colonnes de chiffres

Desktop

Accueil — display serif Fraunces, sections à règles d'encre	Catalogue — photos 10px radius + filets
Page catégorie (SEO programmatique)	Boutiques — 1 500+ artisans et fabricants
Statistiques du registre

Nouveautés front-end (2026-08-25) : DA v3 « catalogue éditorial » — display serif Fraunces (titres + prix), masthead et tab bar vert profond à liseré terracotta, cartes produits sans cadre, boutiques en index à filets, KPI stats en colonnes ; KA Tabbar v1 (nav mobile commune Groupe KA).

🗄️ Les captures d'époque sont conservées dans docs/archive/.

# Chiffres (au 2026-08-28, /api/stats live + registre)

Détails et méthodologie : deliverables/research_report.md · stratégie de découverte continue : deliverables/discovery_strategy.md · conformité par source : docs/CONFORMITE.md.

# Stack technique

# Architecture en 30 secondes

flowchart LR
    subgraph Discovery["Pipeline de découverte (scripts/)"]
        A["35+ annuaires sources<br/>certifications · associations ·<br/>marques régionales · balayages"] --> B["harvest → aggregate →<br/>verify → classify A–E"]
        B --> R[("stores.json<br/>4 082 boutiques QC")]
    end
    subgraph FabriKa["Plateforme (fabrika/)"]
        R --> C["Connecteurs plateforme<br/>Shopify · Woo · Wix · Squarespace · Square ·<br/>Votresite.ca · générique (JSON-LD) · Scrapfly"]
        C --> D[("SQLite + FTS5<br/>hash + diff")]
        D --> E["API FastAPI<br/>/api/products · /api/facets"]
        D --> S["Rendu serveur SEO<br/>HTML complet · JSON-LD ·<br/>sitemaps · 301/404/410"]
        E --> F["React 18 + Vite<br/>recherche · filtres · fiches"]
        S --> G["🕷 Googlebot & co."]
    end
    H["KA ID (SSO) + favoris<br/>hub groupe-ka.com"] <--> E
    W["⏱ Watcher 6 h (PM2)"] -.-> C
    F --> U["🍁 Acheteur local"]

# SEO & rendu serveur — 385 000+ pages indexables

Le site est une SPA React, mais aucun moteur de recherche ne voit une page vide : le catch-all FastAPI (fabrika/seo.py) injecte dans le HTML du build Vite, pour chaque route, un <head> complet et le contenu essentiel de la page dans #root — React remplace ce contenu au montage (hydratation).

URLs & statuts propres : slug lisible + uid (/produits/sirop-d-erable-…-b63130ffc8b18c8cc650), 301 de l'uid nu vers l'URL slugée, 410 Gone pour les produits retirés, 404 pour les uid inconnus — fini le soft-404.

Sitemaps & robots : /robots.txt → /sitemap.xml (index) → sitemap-pages.xml + sitemap-boutiques.xml + sitemap-produits-{n}.xml (40 000 URLs/chunk, lastmod réel, régénérés automatiquement, cache 1 h).

Performance : GZip (‑80 % sur le HTML), Cache-Control: immutable sur les assets hashés, images loading="lazy" avec dimensions explicites, polices en swap.

# API

# Connecteurs & cadences

10 connecteurs plateforme (fabrika/connectors/) pilotés par le registre data/stores.json :

• Journal sync_log par boutique (found/added/updated/removed + raison d'échec), exposé par /api/stats.
• Une boutique qui casse n'affecte jamais les autres ; les faux positifs de découverte sont désactivés (enabled=0) avec garde anti-réintroduction (reprobe_stores.py).

# Classification d'origine

Chaque classe est justifiée par une évidence conservée — jamais déduite du seul fait qu'une entreprise « semble » québécoise. Répartition au registre (2026-08-28) : A 3 863 · E 180 · C 39.

# Structure du projet

fabri-ka/
├── fabrika/                  # plateforme
│   ├── web.py                #   API FastAPI + service du frontend + routes SEO
│   ├── seo.py                #   rendu serveur : meta, JSON-LD, sitemaps, 301/404/410
│   ├── db.py                 #   SQLite + FTS5, diff par hash, délai de grâce
│   ├── ingest.py             #   orchestration des syncs par boutique
│   ├── schema.py             #   modèles Product/Store, taxonomie 20 catégories, 17 régions
│   ├── report.py             #   rapport de marché PDF généré à la volée
│   ├── auth.py               #   SSO « KA ID » (JWT HS256, zéro dépendance)
│   ├── hubfav.py             #   favoris poussés au hub Groupe KA (HMAC)
│   ├── hubprofile.py         #   profil membre lu du hub
│   ├── inscriptions.py       #   auto-inscription des artisans (« Inscrire mon atelier », quarantaine)
│   └── connectors/           #   shopify · woocommerce · wix · squarespace · square · votresite · immunotec · generic · scrapfly
├── frontend/                 # React 18 + Vite + TS — 9 pages, PWA-lite, fr-CA
├── scripts/                  # pipeline de découverte (harvest → aggregate → verify → registry),
│                             #   enrichissements (contacts, livraison, collections), reprobe, docs connecteurs
├── data/                     #   stores.json (registre 4 082) · fabrika.db (3,2 Go) · caches (non versionnés)
├── deliverables/             # rapport de recherche, CSV des boutiques, sources
├── docs/                     # captures d'écran, CONFORMITE.md, fiches des connecteurs
└── run.py                    # CLI : sync · serve · watch

# Démarrage rapide

git clone https://git.spboucher.ai/fabri-ka.git && cd fabri-ka   # (prod : ssh M4M64a && cd ~/fabri-ka)

# Backend
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt

# Frontend (dev : npm run dev ; prod : build servi par FastAPI)
cd frontend && npm install && npm run build && cd ..

# Ingestion puis service
.venv/bin/python run.py sync            # toutes les boutiques connectables
.venv/bin/python run.py serve 8097      # → http://localhost:8097
.venv/bin/python run.py watch 360       # resynchronisation en boucle (minutes)

# Après un changement en prod
pm2 restart fabri-ka-web                # (ou fabri-ka-sync selon le changement)

# Variables d'environnement

Noms seulement — les valeurs vivent dans le .env du nœud (jamais dans le repo) :

# Données & conformité

• Provenance : le catalogue provient des endpoints publics des boutiques elles-mêmes (Shopify products.json, WooCommerce Store API, GraphQL Wix, etc.) — pas d'annuaire tiers, aucune donnée derrière authentification.
• Revue de conformité par source : chaque source est évaluée AVANT connexion (robots.txt/CGU lus et datés, décision consignée) — voir docs/CONFORMITE.md (dernière revue complète : 2026-08-19).
• Politesse réseau : throttle global par plateforme (Shopify : 0,7 s/req toutes boutiques confondues), backoff 429, caches disque, User-Agent identifié.
• Traçabilité : chaque produit renvoie vers la boutique d'origine ; chaque boutique conserve sa provenance de découverte (discovery_sources) et son évidence d'origine (origin_evidence).
• Cadence : resynchronisation complète aux 6 heures (run.py watch 360) ; retraits avec délai de grâce (2 syncs).
• Retrait sur demande : tout ayant droit peut demander le retrait de ses données (contact ci-dessous).

# Déploiement

En production sur le nœud M4M64a du cluster MacLustr (répertoire ~/fabri-ka), servi sur le port 8097 et exposé via ngrok sur www.fabri-ka.com.

3 processus PM2 (vérifiés live) :

fabri-ka-web    .venv/bin/python run.py serve 8097      # API + frontend + SSR SEO
fabri-ka-sync   .venv/bin/python run.py watch 360       # resync aux 6 h
fabri-ka-ngrok  ngrok http --url=www.fabri-ka.com 8097  # tunnel

Redéploiement : build + pm2 restart fabri-ka-web (la prod garde sa base data/ — resynchronisée en continu, jamais écrasée).

# Développement remote-first (IMPORTANT)

La source de vérité est le repo git sur le nœud M4M64a (~/fabri-ka) — pas une copie locale sur le laptop. Toute modification se fait sur le nœud via SSH : édition, build, pm2 restart, puis commit/push depuis le nœud (agent forwarding actif).

• Remote origin = spbgit (git perso git.spboucher.ai), via l'alias SSH gitsrv : gitsrv:srv/git/fabri-ka.git — bare repo hébergé sur M3U96a.
• Ne pas éditer de copies laptop ; référence complète : ~/Desktop/cluster-skill/KA-REMOTE-DEV.md.

# Historique

Jalons réels du repo (git log, 95 commits) :

# Principes

1. Politesse — throttle global par plateforme (Shopify : 0,7 s/req toutes boutiques confondues), délais entre requêtes, User-Agent identifié.
2. Fidélité — aucun prix inventé ; entités HTML décodées ; si la source ne publie pas une donnée, elle est null.
3. Traçabilité — chaque produit renvoie vers la boutique d'origine ; chaque boutique conserve sa provenance de découverte et son évidence d'origine.
4. Robustesse — une boutique qui casse n'affecte jamais les autres ; journal sync_log avec raison d'échec par boutique.
5. Trouvabilité — tout ce qui existe dans la base existe pour Google : HTML complet, données structurées, sitemaps exhaustifs, jamais de soft-404.

# Écosystème Groupe KA