Contexte du document
Socle transverse mature partout (pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-12) ;
un CRM open-core récent à architecture métadonnées-driven étudié lors de l’analyse est en retrait
faute de référentiels ERP (devises/taxes/séquences). Elena fournit ce socle de données de référence
dès le départ. Aucune reprise de code des ERP étudiés.
Exigence détaillée
- Priorité : Must
- Domaine : DOM-12
- Énoncé : « Elena doit attribuer et gérer des séquences de numérotation configurables par type de document dans une instance dédiée à une société, avec un numéro unique, définitif et auditable pour chaque tentative de validation. »
- Justification : convergence (
pirates:analyses/transversales/matrice-fonctionnelle-globale.md §2, DOM-12). La numérotation constitue un socle transverse : elle doit rester explicable pour les documents commerciaux, légaux et comptables. - Critères d’acceptation :
- CA-01 — Une séquence indépendante existe pour chaque type de document : offre, commande client, expédition, bon de livraison, facture, avoir, demande fournisseur, commande fournisseur, réception fournisseur, ordre de fabrication, intervention/bon de maintenance, retour client et retour fournisseur.
- CA-02 — Chaque séquence est paramétrable au niveau de l’instance : préfixe obligatoire, format contrôlé, valeur de départ, longueur minimale avec zéros de tête et périodicité
jamais,annéeoumois. - CA-03 — Le format utilise uniquement les composants contrôlés
PREFIX,YYYY,YY,MM,NN…Net les séparateurs-,/ou_;YYYYest obligatoire en périodicité annuelle etYYYY+MMen périodicité mensuelle. - CA-04 — Le numéro définitif est attribué au passage en validation, jamais au brouillon, et sa période dépend de la date et de l’heure de validation dans le fuseau de l’instance.
- CA-05 — L’attribution est atomique et garantit l’unicité du numéro complet dans toute l’instance, y compris lors de validations simultanées.
- CA-06 — Un numéro consommé n’est jamais réutilisé : une validation échouée ou un document annulé conserve son numéro et son statut explicatif ; une nouvelle tentative reçoit un nouveau numéro.
- CA-07 — Un document validé ne peut pas être supprimé ni voir son numéro modifié. Ses autres champs restent modifiables avec audit obligatoire, sauf une facture ou un avoir après injection comptable, qui ne peut plus être modifié.
- CA-08 — Toute correction après injection comptable passe par un nouveau document : un avoir pour corriger une facture, ou un avoir d’annulation pour corriger un avoir. Le document initial reste conservé et lié.
- CA-09 — Les modifications, changements de configuration, avances manuelles, imports, échecs et numéros abandonnés sont tracés de manière inaltérable avec auteur, date/heure, motif et valeurs avant/après lorsque pertinent.
- CA-10 — Le paramétrage est réservé aux administrateurs habilités, avec date d’effet non rétroactive, aperçu sans consommation de numéro, contrôle des préfixes uniques et impossibilité de supprimer une séquence utilisée.
- CA-11 — Une séquence est créée avec des valeurs par défaut à la création de l’instance ; si aucune séquence active n’est disponible, la validation est bloquée.
- CA-12 — Les imports de documents existants sont réservés aux administrateurs et contrôlent l’unicité et le format ; tout conflit bloque l’import jusqu’au réglage explicite et audité de la prochaine valeur.
- CA-13 — L’historique complet des séquences, numéros attribués, abandonnés et changements est conservé sans limite de durée et exportable en CSV avec filtres.
- Dépendances : EXG-12-001, EXG-05-006 et EXG-13-006 ; l’inaltérabilité comptable s’applique dès l’injection comptable, sans autoriser la modification de la facture ou de l’avoir injecté.