> ## Documentation Index > Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt > Use this file to discover all available pages before exploring further. # Modèle de données Qwoty > Comprenez comment les entités de Qwoty s'articulent — de la configuration de l'espace de travail jusqu'à la signature du contrat. Avant de configurer votre espace de travail, il est utile de comprendre comment Qwoty est structuré. Cette page vous présente les cinq domaines qui composent la plateforme et la façon dont ils s'interconnectent tout au long du processus allant du devis au chiffre d'affaires. Vous n'avez pas besoin de connaître chaque entité pour commencer à utiliser Qwoty. Cette page s'adresse aux administrateurs et aux responsables techniques qui souhaitent modéliser leur activité correctement dès le premier jour. ## Les cinq domaines Le modèle de données de Qwoty est organisé autour de cinq domaines fonctionnels. Chaque domaine regroupe un ensemble d'entités qui, ensemble, forment la colonne vertébrale de chaque opportunité que vous gérez. Votre organisation, vos équipes, vos utilisateurs et les paramètres qui s'appliquent partout : devises, taxes, langues. Ce que vous vendez et comment vous le tarifez : produits, catalogues, bundles, grilles tarifaires, remises. Les entreprises auxquelles vous vendez et les personnes qui y travaillent : comptes, contacts, adresses. La façon dont un devis est préconfiguré : modèles, conditions de paiement, contrats, workflows d'approbation. L'opportunité elle-même : devis, lignes de devis, dealrooms. ## Comment les domaines s'interconnectent Voici une vue simplifiée de la façon dont les données circulent depuis la configuration de votre espace de travail jusqu'à la signature d'un contrat. ```mermaid theme={null} flowchart TB subgraph WS["Workspace & users"] Workspace[Workspace] Users[Users] Teams[Teams] end subgraph CP["Catalog & pricing"] Catalog[Catalog] Products[Products] Bundle[Bundle] Pricebook[Pricebook] Price[Price] end subgraph C["Customers"] Customer[Customer] Contact[Contact] end subgraph TC["Template"] Template[Template] PaymentTerm[Payment term] Contract[Contract] end subgraph SC["Sales cycle"] Quote[Quote] LineItem[Line item] Dealroom[Dealroom] end Workspace --> Users Workspace --> Catalog Catalog --> Products Catalog --> Bundle Catalog --> Pricebook Products --> Price Bundle --> Products Pricebook --> Price Template --> Catalog Template --> PaymentTerm Template --> Contract Customer --> Contact Customer --> Quote Users --> Quote Template --> Quote Quote --> LineItem LineItem --> Products LineItem --> Price Quote --> Dealroom ``` ## Les relations clés à retenir Quatre relations pilotent presque tout dans Qwoty : **Un modèle regroupe votre configuration commerciale.** Lorsqu'un commercial crée un nouveau devis, le modèle qu'il sélectionne préconfigure automatiquement le catalogue, la grille tarifaire, les conditions de paiement, le contrat, le workflow d'approbation et les règles de remise. Un seul clic remplace des dizaines de sélections manuelles. **Un client peut disposer de ses propres catalogues, grilles tarifaires et modèles.** Si vous définissez ces éléments directement sur un client (ou un segment de clients), Qwoty les utilisera en priorité et ne se repliera sur les valeurs par défaut du modèle que si rien n'est défini. Cela vous permet d'appliquer une tarification et une identité visuelle par client sans dupliquer quoi que ce soit. **Un devis est composé de lignes de devis.** Chaque ligne de devis est liée à un produit et à un prix. Le prix provient de la grille tarifaire sélectionnée à la création du devis — si le produit ne figure pas dans cette grille, Qwoty se replie sur la grille tarifaire par défaut. **Une dealroom est la vue client d'un devis.** Publier un devis dans une dealroom le rend visible, commentable et signable par l'acheteur. Un devis correspond à une seule dealroom. Le mécanisme de substitution au niveau du client (Client > Segment > Valeur par défaut du modèle) est utilisé partout dans Qwoty. Consultez la référence sur la logique de création de devis pour une description complète. ## Explorer chaque domaine ### Espace de travail & utilisateurs L'espace de travail est le conteneur de premier niveau pour tout ce qui se trouve dans Qwoty. Il définit les devises dans lesquelles vous opérez, les taxes que vous appliquez et les langues dans lesquelles vos données peuvent être traduites. Les utilisateurs sont regroupés en équipes et, si nécessaire, répartis en unités métier lorsque votre entreprise compte plusieurs entités. ```mermaid theme={null} erDiagram Workspace ||--|{ Language : "supports" Workspace ||--|{ Taxes : "defines" Workspace ||--|{ Currency : "defines" Workspace ||--|{ Teams : "contains" Workspace ||--|{ BusinessUnit : "contains" Users }|--|{ Teams : "belong to" ``` | Entité | Description | | ---------------- | ----------------------------------------------------------- | | **Workspace** | Votre instance Qwoty — toutes les données y sont hébergées | | **BusinessUnit** | Entité distincte au sein de votre organisation (facultatif) | | **Users** | Personnes qui se connectent et travaillent dans Qwoty | | **Teams** | Groupes d'utilisateurs (Commercial, Opérations, Finance...) | | **Language** | Paramètres régionaux disponibles pour les traductions | | **Currency** | Devises acceptées sur les devis et commandes | | **Taxes** | Taux de taxe appliqués (TVA, taxe de vente...) | ### Catalogue & tarification Ce domaine décrit ce que vous vendez et à quel prix. Un catalogue regroupe vos produits et bundles. Chaque produit possède un ou plusieurs prix, organisés en grilles tarifaires — une grille par segment de clients ou zone géographique. Un bundle est un package prêt à l'emploi composé de plusieurs produits vendus comme une seule unité. Des remises peuvent être appliquées en complément de n'importe quel prix. ```mermaid theme={null} erDiagram Catalog }|--|{ Products : "contains" Catalog }|--|{ Bundle : "contains" Bundle }|--|{ Products : "groups" Products }|--|{ Price : "has" Price }|--|{ Pricebook : "belongs to" Catalog }|--|{ Pricebook : "linked to" Currency }|--|{ Pricebook : "denominated in" Taxes }|--|{ Pricebook : "apply to" Discount }|--|{ Products : "applies to" ``` | Entité | Description | | ------------- | -------------------------------------------------------------------- | | **Catalog** | Groupe de produits et de bundles disponibles à la vente | | **Products** | Ce que vous vendez (biens, services, abonnements) | | **Bundle** | Package de plusieurs produits vendus ensemble comme une seule unité | | **Pricebook** | Grille tarifaire pour un segment, une zone géographique ou un client | | **Price** | Prix d'un produit dans une grille tarifaire spécifique | | **Discount** | Règle de réduction de prix appliquée à un ou plusieurs produits | Les variantes de produits existent en tant que fonctionnalité dans Qwoty, mais ne sont pas encore représentées comme une entité distincte dans ce modèle. Une variante est stockée comme un produit avec des métadonnées parentes partagées. ### Clients Les clients sont les entreprises auxquelles vous vendez. Chaque client possède un ou plusieurs contacts (les personnes que vous contactez par e-mail et invitez dans les dealrooms), ainsi que des adresses de facturation et de livraison utilisées sur les devis et les commandes. ```mermaid theme={null} erDiagram Customer ||--|{ Contact : "has" Customer ||--|{ BillingAddress : "has" Customer ||--|{ ShippingAddress : "has" ``` | Entité | Description | | -------------------- | ----------------------------------------------- | | **Customer** | L'entreprise à laquelle vous vendez | | **Contact** | Un individu chez le client | | **Billing address** | L'adresse à laquelle les factures sont envoyées | | **Shipping address** | L'adresse à laquelle les produits sont livrés | ### Modèle & configuration commerciale Un modèle est l'objet le plus important pour les administrateurs. Il regroupe tout ce dont un devis a besoin : quel catalogue utiliser, quelle grille tarifaire appliquer, quelles conditions de paiement, quel texte de contrat, quel workflow d'approbation, quelle mise en page PDF. Les commerciaux sélectionnent un modèle à la création du devis et tout le reste est préconfiguré. ```mermaid theme={null} erDiagram Template }|--|{ Catalog : "uses" Template }|--|{ PaymentTerm : "applies" Template }|--|{ Contract : "applies" Template }|--|{ ApprovalWorkflow : "triggers" Template }|--|{ Discount : "applies" Template }|--|{ ContentLibrary : "uses" Template }|--|{ PDFTemplate : "renders with" Template }|--|{ CheckoutForm : "uses" Template }|--|{ BusinessUnit : "scoped to" ``` | Entité | Description | | --------------------- | --------------------------------------------------------------------------------- | | **Template** | Configuration du tunnel de vente (regroupe catalogue + grille tarifaire + règles) | | **Payment term** | Fréquence de facturation et échéances (Net 30, mensuel...) | | **Contract** | Modèle de document juridique avec variables dynamiques | | **Approval workflow** | Règles définissant quand un devis nécessite une validation | | **Content library** | Blocs de texte et de médias réutilisables | | **PDF template** | Mise en page et identité visuelle des devis exportés en PDF | | **Checkout form** | Formulaire personnalisé présenté à l'acheteur dans la dealroom | ### Cycle de vente Le cycle de vente est l'endroit où les affaires se concrétisent réellement. Un devis est créé pour un client à partir d'un modèle. Il contient une ou plusieurs lignes de devis — chacune liée à un produit et à un prix. Une fois publié, le devis devient visible pour l'acheteur via une dealroom, où il peut consulter, commenter et signer. ```mermaid theme={null} erDiagram Users ||--|{ Quote : "creates" Customer ||--|{ Quote : "receives" Template }|--|{ Quote : "pre-configures" Quote ||--|{ LineItem : "composed of" LineItem }|--|{ Products : "references" LineItem }|--|{ Price : "references" Quote ||--|| Dealroom : "publishes to" ``` | Entité | Description | | ------------- | ---------------------------------------------------------------------- | | **Quote** | Proposition tarifaire envoyée à un client | | **Line item** | Une entrée produit dans un devis, avec quantité et prix | | **Dealroom** | Espace dédié à l'acheteur pour consulter, commenter et signer le devis | ## Ce qui n'est pas encore dans ce modèle Le modèle de données actuel (v1) n'inclut pas : * **Order** — Les commandes sont générées automatiquement à partir des devis acceptés. Elles partagent la majeure partie de leur structure avec le devis et les lignes de devis, et seront modélisées explicitement dans la prochaine itération. * **Sales Agreement** — Un contrat-cadre avec des engagements de volume et une tarification négociée. Les accords commerciaux s'appliquent à plusieurs commandes et seront ajoutés au modèle dans une version future. Les commandes et les accords commerciaux sont disponibles dans le produit — vous pouvez les créer et les gérer dès aujourd'hui. Leur absence ici concerne uniquement le diagramme, qui sera mis à jour au fur et à mesure de l'évolution du modèle. ## Prochaines étapes Configurez les devises, les taxes, les langues et les unités métier avant d'importer vos données. Commencez à modéliser ce que vous vendez avec des produits et des catégories. Découvrez comment les modèles regroupent la configuration du catalogue, de la grille tarifaire et du contrat. Suivez un devis depuis le brouillon jusqu'à la signature.