Fiche société

Aide du Hub TheSocle · iam.fiche.ecran

L'identité du client, saisie une fois au Hub : les applications la lisent au lieu de la redemander.

Voir l'élément dans l'écran : iam/tenant-fiche

Explication

Chaque application a besoin, un jour ou l'autre, de savoir qui est le client : sa raison sociale pour un pied de page, son SIREN pour une facture, ses couleurs pour un document, son adresse pour un courrier. Plutôt que chaque application la redemande — et que les versions divergent —, le Hub la garde ici, une seule fois.

Quatre blocs :

Identité : raison sociale, nom commercial, signature, métier, année, effectif ;
Identité légale : forme juridique, capital, SIREN, SIRET, TVA, NAF, RCS, représentant ;
Coordonnées : adresse, téléphone, courriel, site, domaine ;
Marque : couleurs et typographies.

Le Hub en déduit la mention légale déjà formée, prête pour un pied de page.

Fiche complète

Lire la fiche depuis une application

iam_worker.get_tenant_fiche (slug) — c'est l'action prévue pour cela.

Le retour contient tous les champs, plus :

Champ calculé	Sens
`mention_legale`	la ligne de pied de page, déjà formée
`est_enseigne`	vrai si ce tenant est une marque d'une autre société
`societe_porteuse`	pour une enseigne : la société qui la porte
`enseignes`	pour une société : les marques qu'elle porte

Écrire

POST /hub/iam/tenants/{slug}/fiche → iam_worker.upsert_tenant_fiche (slug, fiche en JSON). Le contrôleur ne transmet que les colonnes connues : un champ ajouté par le navigateur, ou le jeton CSRF, n'arrive pas en base.

Pièges de l'écran

Un champ vidé est effacé. L'écran envoie tous les champs ; un champ vide part comme null. (Par l'action, au contraire, un champ absent garde sa valeur.)
Pas de contrôle de version à l'écran. L'action sait refuser une écriture concurrente (version_attendue), mais l'écran ne l'envoie pas : si deux personnes enregistrent la même fiche, la dernière l'emporte.

Sommaire du démonstrateur