# Le modèle de données

Les objets du métier, ce que chacun porte, et ce qui se déduit.


Le modèle d'Ironlane suit le travail d'une entreprise industrielle : un client commande, l'entreprise ouvre une affaire, l'exécute par des opérations, facture, et suit ce que cela lui coûte.

<figure class="schema"><svg viewBox="0 0 520 474" role="img" aria-label="Le modèle : société, clients, affaires, opérations et ce qui s&#x27;y rattache" xmlns="http://www.w3.org/2000/svg"><defs><marker id="f" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse"><path d="M1 1.5L8.5 5L1 8.5z" class="mk"/></marker><filter id="o" x="-5%" y="-5%" width="110%" height="120%"><feDropShadow dx="0" dy="1.5" stdDeviation="2" flood-opacity=".14"/></filter></defs><g class="cc c-violet plein"><rect x="180" y="8" width="160" height="54" rx="12" class="card" filter="url(#o)"/><text x="260.0" y="32.0" class="tt" text-anchor="middle">Société</text><text x="260.0" y="51.0" class="ts" text-anchor="middle">tout lui appartient</text></g><path d="M200 64 L100 96" class="ln" fill="none" marker-end="url(#f)"/><path d="M260 64 V96" class="ln" fill="none" marker-end="url(#f)"/><path d="M320 64 L420 96" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-vert"><rect x="10" y="98" width="156" height="54" rx="12" class="card" filter="url(#o)"/><text x="88.0" y="122.0" class="tt" text-anchor="middle">Comptes</text><text x="88.0" y="141.0" class="ts" text-anchor="middle">et leurs droits</text></g><g class="cc c-vert"><rect x="184" y="98" width="156" height="54" rx="12" class="card" filter="url(#o)"/><text x="262.0" y="122.0" class="tt" text-anchor="middle">Employés</text><text x="262.0" y="141.0" class="ts" text-anchor="middle">absences, congés</text></g><g class="cc c-vert"><rect x="358" y="98" width="156" height="54" rx="12" class="card" filter="url(#o)"/><text x="436.0" y="122.0" class="tt" text-anchor="middle">Clients</text><text x="436.0" y="141.0" class="ts" text-anchor="middle">et leurs sites</text></g><path d="M428 154 V190" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-bleu"><rect x="340" y="192" width="170" height="54" rx="12" class="card" filter="url(#o)"/><text x="425.0" y="216.0" class="tt" text-anchor="middle">Affaire</text><text x="425.0" y="235.0" class="ts" text-anchor="middle">la commande d&#x27;un client</text></g><path d="M425 248 V282" class="ln" fill="none" marker-end="url(#f)"/><g class="cc c-bleu plein"><rect x="340" y="284" width="170" height="54" rx="12" class="card" filter="url(#o)"/><text x="425.0" y="308.0" class="tt" text-anchor="middle">Opération</text><text x="425.0" y="327.0" class="ts" text-anchor="middle">ce qu&#x27;on fait et suit</text></g><g class="cc c-ambre"><rect x="10" y="192" width="190" height="50" rx="12" class="card" filter="url(#o)"/><text x="105.0" y="214.0" class="tt" text-anchor="middle">Pièces</text><text x="105.0" y="233.0" class="ts" text-anchor="middle">devis, bons, factures</text></g><g class="cc c-ambre"><rect x="10" y="252" width="190" height="50" rx="12" class="card" filter="url(#o)"/><text x="105.0" y="274.0" class="tt" text-anchor="middle">Heures</text><text x="105.0" y="293.0" class="ts" text-anchor="middle">pointage, feuilles</text></g><g class="cc c-ambre"><rect x="10" y="312" width="190" height="50" rx="12" class="card" filter="url(#o)"/><text x="105.0" y="334.0" class="tt" text-anchor="middle">Planning</text><text x="105.0" y="353.0" class="ts" text-anchor="middle">qui, où, quand</text></g><g class="cc c-ambre"><rect x="10" y="372" width="190" height="50" rx="12" class="card" filter="url(#o)"/><text x="105.0" y="394.0" class="tt" text-anchor="middle">Achats</text><text x="105.0" y="413.0" class="ts" text-anchor="middle">matière, fournisseurs</text></g><path d="M200 217 H270 V311 H338" class="ln" fill="none"/><path d="M200 277 H270 V311 H338" class="ln" fill="none"/><path d="M200 337 H270 V311 H338" class="ln" fill="none"/><path d="M200 397 H270 V311 H338" class="ln" fill="none"/><g class="cc c-gris"><rect x="300" y="372" width="210" height="54" rx="12" class="card" filter="url(#o)"/><text x="405.0" y="396.0" class="tt" text-anchor="middle">Synthèse</text><text x="405.0" y="415.0" class="ts" text-anchor="middle">tout ce qui se déduit, gardé</text></g><path d="M425 340 V370" class="ln" fill="none" marker-end="url(#f)"/><text x="260" y="452" class="ts" text-anchor="middle">Ce qui se déduit se calcule à l&#x27;écriture et se garde.</text></svg></figure>

## Les objets

| Objet | Ce qu'il est |
| --- | --- |
| Société | Le propriétaire de toutes les données de sa base : une base, une société. |
| Compte | Une personne qui se connecte. Un compte peut appartenir à plusieurs sociétés, avec un rôle différent dans chacune. |
| Employé | Une personne de l'entreprise, avec ses absences, ses congés et ses présences. |
| Client | Un client de l'entreprise, avec ses sites. |
| Affaire | La commande d'un client. **L'affaire est une boîte vide** : ni heures, ni frais, ni factures n'y vivent. |
| Opération | Ce que l'entreprise fait et suit : une désignation, un montant, un mois, un mode d'exécution. **Tout le travail vit à l'opération.** |
| Pièce | Un devis, un bon de commande, une facture. Une pièce peut être citée par plusieurs opérations, et une opération cite plusieurs pièces. |
| Heures | Le pointage de chaque personne, par jour et par opération, et les feuilles signées chaque semaine. |
| Planning | Qui travaille où, quel jour, sur quelle opération. |
| Achat | Matière, matériel, sous-traitance, fournisseurs. |

## Quelques règles du modèle

- **Un numéro donné ne se réutilise jamais.** Une opération reçoit son rang à son entrée dans l'affaire. S'il y a une seule opération vivante, le numéro est celui de l'affaire ; sinon il porte un suffixe.
- **Un même travail sur plusieurs jours reste une opération.** Le découpage se fait au planning, par des journées sur la même opération. Plusieurs choses à livrer font plusieurs opérations.
- **On ne découpe jamais une opération facturée.**
- **Une facture citée vaut facturé**, sans condition. Une facture annulée ne facture rien.
- **Aucun état de pièce n'est posé par la production, et aucune facture ne verrouille la production.** Le cycle d'une pièce appartient au secrétariat et au logiciel comptable.
- **Une définition, un endroit.** « Facturé », « en retard », « en cours » ont chacun une seule fonction côté serveur, que tout lit.

## Ce qui se déduit

Ce qui se déduit se calcule à l'écriture et se garde, par un déclencheur. Les heures pointées, le dernier pointage, la pièce principale, le métier : tout cela vit sur la table de l'objet.

Ce qu'une ligne du suivi déduit d'ailleurs (cases du planning, pièces citées, état de facturation, alertes) vit dans une table de **synthèse**, pour ne pas le recalculer à chaque lecture. Un contrôle compare la synthèse à un calcul à neuf : l'écart doit être nul. Une écriture qui change la synthèse la fait reposer à la fin de la transaction, et un passage de nuit la repose entièrement au changement de jour.

## Les rôles

Chaque société définit ses propres rôles. Cinq rôles de départ existent, qu'on renomme mais qu'on ne retire pas.

| Rôle | Ce qu'il peut |
| --- | --- |
| Gérant | Tout. |
| Direction | Les statistiques, toutes les affaires, l'exercice. |
| Bureau | Tout ce que fait le gérant, sauf gérer les droits : le secrétariat et la comptabilité. |
| Chargé d'affaires | Son portefeuille, le planning, l'exercice. |
| Employé | L'atelier : sa saisie, sa semaine, ses feuilles, le planning. |

Un rôle neuf n'a aucun droit. Un accès s'ouvre depuis la fiche de la personne.

## Ce que l'application est

**L'application transforme ce que l'entreprise sait déjà, elle n'invente rien.** Un indicateur qui n'existe dans aucun document de l'entreprise ne se crée pas. Ce qui manque se signale, ça ne se comble pas.

**La valeur de l'application, ce sont les erreurs qu'elle empêche**, pas ce qu'elle fait taper en moins. Une valeur par défaut est un mensonge silencieux : quand l'application ne sait pas, elle le dit.
