Programmes par application

Convention. Chaque application = une solution .NET indépendante sous D:\Dev2026\. Toutes exposent leur front via la passerelle (sous-domaine) et lisent l'identité via Identité/Keycloak.

IIQARION Factures (THEIA) — D:\Dev2026\Theia

Rôle : facturation électronique Factur-X, gestion commerciale ventes/achats, stock, PDP. Stack : .NET 10, Razor Pages + API Controllers, EF Core / PostgreSQL.

Structure de la solution

Projet	Rôle
Theia.Core	Domaine (entités, enums), Factur-X pur (FacturX/ : GenerateurCii, LecteurCii, AssembleurFacturX PDF/A-3, GenerateurPdf QuestPDF, ValidateurFacturX, MetadataXmp) et moteur de taxes (Taxes/MoteurTaxes). Sans IO.
Theia.Storage	Persistance EF (TheiaDbContext) + services métier : ServiceFacturation, ServiceStock, ServiceBonsCommande/Livraison, ServiceRapprochement, ServiceEmail, ServiceSuppression, ServiceEReporting (brouillard de caisse), MigrateurLeger, DonneesInitiales.
Theia.WebUI	Hôte web (point d'entrée) : Razor Pages + Controllers API /api/* + middlewares tenant.
Theia.Tenancy / .ControlPlane	Routing multi-base : Shard, Tenant, TenantContext, ControlDbContext, TenantAllocator.
Theia.Stockage	Stockage objet S3/MinIO (lib partagée GED/documents).
Theia.PdpWorker	Worker de synchro PDP dédié (multi-dossier, élection de leader).

Point d'entrée (Theia.WebUI\Program.cs)

• DI : DbContexts (Control + Theia résolu par requête depuis TenantContext), services Storage (scoped), modules partagés (IArticleCatalog→AdaptateurCatalogueTheia, IStockService, clients HTTP Catalogue/Tiers avec jeton société signé), PDP (ServicePdpEffinum, ServicePdpAchats, ValidateurSchematron, ServicePollingPdp optionnel), stockage objet (S3/fichier), ServiceRne, ServiceKpi, ContexteSession, IdentiteClient.
• Auth : cookie (session) + OIDC Keycloak (challenge par défaut) ; OnTokenValidated→ProvisioningOidc (JIT, réécrit le principal avec l'Id interne). Politiques : Admin + fines Vente/Achat/Reglement.Lire/Ecrire.
• Pipeline : ForwardedHeaders → StaticFiles → Routing → Authentication → TenantRoutingMiddleware (choisit la base) → TenantMiddleware (fixe SocieteCouranteId) → Authorization → handler d'erreurs JSON /api → RazorPages → Controllers → endpoints minimal-API.
• Bootstrap : DonneesInitiales, ControlDbContext.AssurerSchema, seed shards, mapping sociétés→tenants, MigrateurLeger.Synchroniser sur chaque base physique, backfill des Cle.

Controllers (Theia.WebUI\Controllers\*)

Controller	Base	Responsabilité · endpoints clés
AuthController	api/auth	Session : deconnexion, societe/{id}, societe-dossier (handshake portail, anti-open-redirect)
FacturationController	api/factures	Ventes/devis/avoirs/règlements/PDP : create, {id}/comptabiliser, calculer, valider-devis, convertir, acompte, solde, avoir, reglement(s-masse), envoyer, relancer, pdp/deposer, pdp/statut, {id}/facturx|apercu|xml
AchatsController	api/achats	Factures fournisseur (PDP entrant), catalogue achat, cycle de vie, webhook : synchroniser, {id}/statut/{transition}, {id}/lignes/extraire, catalogue/*, webhook
BonsCommandeController	api/bons-commande	Bons de commande fournisseur (CRUD, valider, PDF)
BonsLivraisonController	api/bons-livraison	Bons de livraison (client/fournisseur), facturer, pièce jointe
StockController	api/stock	Mouvements & valorisation : entree/sortie/ajustement/inventaire/famille-methode
ReferentielController	api	Référentiels : catalogue, clients, articles, unites, vatex
AdministrationController	api/admin	Config société : taxes, comptes, journaux, conditions, personnalisation (logo, couleurs, fond de page, filigrane), numérotation, relances, SMTP, PDP, sociétés, users
ModelesController Nouveau	api/modeles	Modèles de facture (profils de règles) : liste, upsert, défaut, suppression ; exposés à l'éditeur de facture
ImportController Nouveau	api/import	Reprise de données : analyser (aperçu, doublons, codes TVA) & executer (CSV/XLSX SAGE/EFAC/CEGID)
ShardsAdminController Nouveau	api/shards	Admin des shards : liste/charge, création semi-auto, activation (garde plateforme ou clé partagée)
WidgetsController	api/widgets	KPI pour le portail : kpi (session), kpi-dossier (machine, clé partagée, résolu cross-shard)
TenantDiagController	api/tenant	Diagnostic routing multi-tenant (dev)

Module E-reporting (brouillard de caisse) : pages Pages/EReporting/* (Livre de caisse, E-reporting manuel, Caisses) + ServiceEReporting (journées, ventilations TVA/paiement, soldes, validation/snapshot, export comptable, dépôt PDP).

Services applicatifs (Theia.WebUI\Services\*)

Service	Responsabilité
TenantRoutingMiddleware	Choisit la connexion base du tenant (cookie dossier) → TenantContext, avant tout accès données
TenantMiddleware	Résout user + société courante, fixe SocieteCouranteId (filtre global)
ContexteSession	Contexte requête : user, société, rôle, droits par module
ProvisioningOidc	Provisioning JIT à la connexion Keycloak (sub→Utilisateur, réécrit le cookie)
IdentiteClient	Client HTTP du service Identité (droits fins, cache 5 min)
ServicePdpEffinum	Dialogue PDP Effinum/Serensia : OAuth2, dépôt Factur-X, suivi de statut (AFNOR + propriétaire)
ServicePdpAchats	Récupère/gère les factures fournisseur entrantes, extrait les lignes, propage le cycle de vie
ServicePollingPdp / ServiceSyncMultiTenant	Synchro périodique PDP (repli du webhook) / orchestration multi-dossier & élection de leader
ValidateurSchematron	Validation EN 16931 (Schematron/Saxon) du XML Factur-X avant envoi
ServiceRne	Enrichissement fournisseurs depuis la base RNE (INPI) locale
ServiceImportReferentiel Nouveau	Import clients/articles : lecture CSV (UTF-8/Latin1, séparateur auto) & XLSX (ClosedXML, gère le « CSV encapsulé » SAGE), mapping par nom de colonne, dédoublonnage, purge optionnelle
ServiceKpi / RasteriseurPdf / MessagesErreur	KPI tableau de bord / rendu PDF→PNG pour le viewer / traduction des erreurs techniques en messages FR (ErreurUtilisateur déplacé en Theia.Core pour être partagé)

Portail Client — D:\Dev2026\PortailClient

Rôle : point d'entrée unique, GED, control-plane multi-tenant, embarque Factures/POS. Stack : .NET 10, Blazor Server + Fluent UI.

Projet	Rôle
PortailClient.Web	Portail Blazor + control-plane (PortailDbContext + ControlDbContext) + GED
PortailClient.Ocr	Runner OCR hors-process (console PortailClient.Ocr <fichier> <tessData>, Tesseract/Paddle)

Point d'entrée (Program.cs)

• DI : PortailDbContext + ControlDbContext (conn Portail), stockage Theia.Stockage S3/MinIO, clients HTTP (IdentiteClient, TheiaKpiClient:5087, PosKpiClient:5210, CatalogueHttpClient:5130, sonde sante), ContexteSession, ServiceDocuments, ExtracteurContenu, OCR (OcrRunner+OcrQueue+OcrArrierePlan hosted), ProvisioningOidc, TenantAllocator.
• Auth : cookie PortailClient.Auth (8h) + OIDC "kc" (PKCE, code flow, ResponseMode=query) ; OnTokenValidated→JIT (sub→Utilisateur, aligne Clients↔dossiers, assigne tenant au shard).
• Pipeline : ForwardedHeaders → (prod) exception/HSTS → StatusCodePages → HttpsRedirect → Authentication → Authorization → ContexteSession.Initialiser → Antiforgery → StaticAssets → RazorComponents (InteractiveServer).

Endpoints minimal-API

Route	But
GET /auth/login	Challenge Keycloak
POST /auth/entreprise	Bascule d'entreprise (réécrit le cookie, validé contre les accès)
POST /auth/logout	Déconnexion cookie + session Keycloak
GET /documents/{id}/telecharger|apercu	Téléchargement / aperçu (cloisonné)
GET /documents/telecharger-selection?ids=	ZIP d'une sélection (≤200)
POST /api/ingest/document	Ingestion externe (X-Api-Key, multipart) → résout/crée le Client
GET /api/control/shards|tenants, POST /api/control/tenants/{code}/assign	Control-plane : annuaire & affectation au shard

Pages Blazor (Components/Pages/*)

Page	Rôle
Home /	Accueil : KPI THEIA/POS + tuiles (gated par ADroitApp)
Theia /theia · Pos /pos	Embarque Factures / POS en iframe après handshake SSO top-level
Documents /documents	Base documentaire : recherche plein-texte à facettes
Depot / MesDepots / DepotsRecus / Publier	Dépôt (ascendant), mes envois, dépôts reçus (agent), publication (descendant)
Administration /administration	Distributeurs / dossiers / membres (via Identité)
Outils (Emprunt, FraisKilometriques)	Calculatrices

Services (Services/*)

Service	Responsabilité
ContexteSession	Identité courante (scoped) ; pilote le filtre global (ClientCourantId, AccesTransversal, ADroitApp)
ServiceDocuments	Orchestration GED : création (stockage+extraction), recherche à facettes, marquage lu, transmission
ServiceStockage	Objets S3 content-addressed ged/{clientId}/{sha}
ExtracteurContenu / OcrRunner / OcrArrierePlan	Extraction texte native ; OCR hors-process ; file d'attente OCR en tâche de fond
TheiaKpiClient / PosKpiClient	KPI serveur→serveur (X-Widget-Key), cloisonnés par dossier
IdentiteClient / ProvisioningOidc	Source de vérité droits ; provisioning JIT + cookie applicatif

IIQARION POS — D:\Dev2026\THEIAPOS

Rôle : point de vente/caisse (offline-first), supervision, tickets NF525. Stack : .NET 8 (API) / .NET 10 (MAUI), Minimal API, EF Core / PostgreSQL, SQLite local (caisse).

Projet	Rôle
Theia.Pos.Api	API + console de supervision (point d'entrée web)
Theia.Pos.Domain	Entités, enums, DTOs, Nf525Chain (chaînage inaltérable)
Theia.Pos.Caisse / .Caisse.Maui	App caisse (Blazor Server hôte / coque MAUI Windows-Android-iOS)
Theia.Pos.Client / .Ui	Moteur caisse offline-first (SQLite local, PosService, SyncWorker, impression ESC/POS) / UI partagée

Point d'entrée (Theia.Pos.Api\Program.cs)

• DI : PostgreSQL obligatoire, routing multi-tenant (PosControlDbContext, PosTenantResolver), PosDbContext résolu par requête ; module Catalogue (Embedded ou Hosted via CatalogueHttpClient + jeton), module Tiers (TiersHttpClient, ServicePosSyncTiers) ; EmailWorker (outbox), QuestPDF (tickets/Z).
• Auth (multi-canal) :

Consommateur	Schéma
Navigateur (console)	OIDC Keycloak "kc" + cookie TheiaPos.Auth (client theiapos, ResponseMode=query)
Caisses	X-Api-Key = Register.ApiKey
Widgets portail	X-Widget-Key (serveur→serveur, match dossier)
Sync Tiers	X-Sync-Secret

• Gating middleware : pages HTML protégées → challenge Keycloak ; /api/portal/* = cookie SSO obligatoire (jamais une clé de caisse) ; autres /api/* = cookie SSO OU clé caisse. Tenant middleware : lit cookie pos_dossier → résout le shard.

Groupes d'endpoints

Groupe	Endpoints
Handshake auth	/auth/login|logout, GET /api/auth/portail?dossier=&retour= (pose pos_dossier, anti-open-redirect vers Portal:BaseUrl)
Admin portail (SSO)	/api/portal/caisses|stores|sellers|customers|products|categories|articles (CRUD, deep-link module Catalogue)
Sync portail→caisse	GET /api/catalog (articles actifs filtrés par assortiment, TTC recomposé), /api/registers/{id}, /api/sellers
Remontée caisse	POST /api/sync/tickets (vérif NF525 + ré-ancrage, décrément stock, fidélité, outbox), heartbeat, sessions/close, z.pdf
Clients / e-reporting	/api/customers (incrémental + tombstones), /api/ereporting/{date}, POST /api/tickets/{id}/facturer (Factur-X via THEIA)

Identité — D:\Dev2026\Identite

Rôle : autorisation fine + provisioning Keycloak. Stack : .NET 10 Minimal API, Dapper + Npgsql. Keycloak porte l'authentification & les rôles grossiers ; la base identite porte les droits fins.

Point d'entrée (Program.cs)

• Bootstrap : EnsureDatabaseAsync → services (SecretProtector, KeycloakAdmin, ResolveurPdp, RafraichisseurPdp hosted) → JWT bearer (realm eportail, NameClaimType=sub) → InitialiserAsync (schéma+seed).
• Politiques : ImportApi (client import-api), AdminPlateforme (rôle realm). Helpers de portée : AutoriserAdminDistrib/Dossier, NiveauxActeur.

Endpoints (préfixe /api/identite)

Route	Auth	But
GET /moi/habilitations	authentifié	Dossiers + droits par module + apps actives (via vue v_habilitations)
POST /distributeurs/{code}/dossiers	ImportApi	Import push d'un dossier + chef (provisionne le chef dans Keycloak)
POST /dossiers/{code}/utilisateurs, PUT …/habilitations, DELETE …	chef/admin	Gestion des membres & droits
GET/PUT /dossiers/{code}/apps, POST /provisioning	admin-distrib	Entitlements applicatifs (THEIA/POS)
POST /admin/distributeurs/*, .../cles-pdp	admin-plateforme / distrib	Distributeurs, dossiers, clés PDP (secret jamais renvoyé)
POST /pdp/token	theia/import/admin	Courtier de jeton PDP : forge un token OAuth depuis la clé distributeur (secret ne sort jamais)

Services

Service	Responsabilité
KeycloakAdmin	Provisionne les users dans le realm eportail (service account import-api) : dédup email, création, rôle, invitation → renvoie le sub
RealmRoles	Lit les rôles realm depuis le JWT (realm_access.roles)
SecretProtector	Chiffre/déchiffre AES-256-GCM les secrets PDP au repos
ResolveurPdp / RafraichisseurPdp	Résout l'identité PDP (organization_id/eas) depuis le SIREN via Serensia, cache-first / rattrapage en tâche de fond

Modules partagés : Catalogue & Tiers

Même patron : module EF autonome (SQLite/PostgreSQL), cloisonné par SocieteCode, jeton société signé HMAC-SHA256 (JetonSociete) requis sur tout /api/*, notification write-through vers les consommateurs.

Passerelle, Site vitrine, Ingress PDP

Application	Projet	Programme
Passerelle	Iiqarion.Gateway	YARP (LoadFromConfig), routage par hôte (appsettings), HTTPS auto prod (LettuceEncrypt, Tls:Enabled), UseWindowsService, sonde /healthz
Site vitrine	IIQARION.Site.Web	Blazor SSR marketing ; NavMenu.razor « Se connecter » → PortailUrl (config)
Ingress PDP	Iiqarion.WebhookIngress	Service autonome (.NET + PostgreSQL + LettuceEncrypt) : reçoit les webhooks PDP, qu'un worker draine (pull)
Documentation	Iiqarion.Docs	Ce site (hôte statique .NET, wwwroot, :5310)