--- title: "Les concepts Surface" url: https://developers.dagio.ai/fr/concepts/ --- # Les concepts Surface ## Organiser sans tout mélanger Surface distingue le contexte d’une activité, son organisation et ses contenus. Cette séparation permet de réutiliser une app, de partager une fiche précise et de relier des Workspaces sans déplacer leurs données. | Concept | Contenu attendu | Exemple Clients/Soumissions | | --------- | ------------------------------------------------------------ | -------------------------------------- | | Portfolio | Ensemble de Workspaces et contexte partagé | L’entreprise Atelier Boréal | | Workspace | App ou domaine de travail défini par un Model | Clients ou Soumissions | | Space | Organisation des contenus selon leur responsabilité | Répertoire Clients, procédures, suivis | | Surface | Contenu ou fiche identifié, éditable et relié | La fiche Atelier Nord | | Objet | Élément stable et adressable d’une Surface | Objet Rich text « Contraintes » | | Model | Définition réutilisable de la structure et des comportements | App Clients publiée au catalogue | ## Choisir le rôle d’un Space **Knowledge** contient les références utilisables pour comprendre et exécuter un travail. **Data** contient les objets métier structurés. **Work** porte le travail en cours, ses dépendances et ses décisions. **Product** organise les résultats et livrables destinés à être utilisés. Une soumission finale appartient au résultat métier; le travail nécessaire pour la préparer possède ses propres étapes. Une procédure commerciale est une connaissance; elle ne devient pas une tâche parce que l’AI la consulte. ## Définition et instance Le Model définit ce qu’est un Client : ses Fields, ses Actions et ses vues. Le Workspace Clients applique cette définition. La fiche Atelier Nord est une instance qui possède ses valeurs et ses liens. Modifier une instance ne modifie pas le Model; faire évoluer le Model passe par la composition, la validation et la publication. ## Une interface ne déplace pas la responsabilité Un tableau, un graphe et un panneau de liens peuvent présenter la même fiche. Ils lisent les mêmes identités et invoquent les mêmes opérations autorisées. Le tableau ne possède pas sa propre copie du client; un lien sélectionne une fiche existante plutôt que recopier ses coordonnées. ## Naviguer entre applications et Spaces personnels Le menu Surface ouvre Dashboard, Portfolio, Data, Knowledges, Contents et Workers. Portfolio contient vos applications. Les autres collections permettent de créer des Spaces personnels sans créer d'application. La recherche filtre automatiquement pendant la saisie, avec un indicateur de chargement. Les vues Data utilisent la largeur disponible sans sidebar gauche. Épinglez une application dans Portfolio pour la retrouver dans la section Applications du menu Surface, avec son ic�ne configur�e. Marketplace reste accessible depuis Portfolio. Dans une application, la barre latérale présente ses Spaces. Knowledge et Content affichent leur arborescence de Surfaces, avec catégories ou dossiers et Surfaces à la racine. Le fil d'Ariane permet de revenir à la collection ou à l'application, ou de changer de Space dans la même application. Les modifications de l'éditeur sont préparées avant la navigation; un échec de sauvegarde conserve le contexte courant. Dans Knowledge et Content, le menu général appartient à Overview. Le séparateur replie la sidebar par sa commande centrale, un double-clic ou un glissement au bord gauche. Le rail replié reste cliquable avec un survol visible; son handle de redimensionnement est masqué. ## Menu du compte Le menu de votre avatar donne accès au profil, à la Corbeille, aux Archives et à la déconnexion. Explorer regroupe Marketplace, l'invitation dans le Workspace actif, Aide, Developers et le choix clair/sombre. Subscribe ouvre le portail du compte pour l'offre Free. Corbeille, Archives et Aide proposent pour le moment leur fenêtre; leur gestion de contenu sera ajoutée séparément. La documentation est disponible sur https://developers.dagio.ai/. ## Exemples appliqués : Du Workspace à la fiche La destination Clients ouvre les données; le profil détermine leur fiche éditable. ### Configuration Fragment à placer dans `composition.navigation[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/). ```json { "key": "clients", "label": "Clients", "icon": "users", "kind": "collection", "spaceKey": "clients", "definitionPaths": [ "workspace/clients/surface/client" ], "queryKey": "clients", "formKey": null } ``` ### Variante et raccordement Fragment à placer dans `presentation.recordProfiles[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-record-profile/). ```json { "key": "client", "definitionPaths": [ "workspace/clients/surface/client" ], "editActionKey": "edit-client", "identity": { "title": { "kind": "field", "fieldPath": "fields/company" }, "avatar": { "kind": "initials", "maximumLetters": 2 }, "subtitle": { "kind": "field", "fieldPath": "fields/status" } }, "valueLabels": [ { "fieldPath": "fields/status", "values": [ { "value": "prospect", "label": "Prospect" }, { "value": "active", "label": "Actif" } ] } ], "card": { "summary": { "kind": "field", "fieldPath": "fields/notes" }, "tags": { "namespace": "user", "maximumVisible": 3 }, "metricKeys": [], "openLabel": "Ouvrir le client" }, "queryBindings": [], "metrics": [], "detail": { "primaryActionKey": null, "creationActionKeys": [], "actionKeys": [], "sections": [ { "kind": "fields", "key": "follow-up", "label": "Suivi du client", "fieldPaths": [ "fields/notes", "fields/status" ] } ], "settings": { "fieldPaths": [ "fields/email" ] }, "tags": { "namespace": "user", "maximumVisible": 3 }, "relatedGroups": [], "primaryActionLabel": null } } ``` ### Exemple de disposition UI La disposition illustrative ci-dessous situe cette configuration dans l’app Clients/Soumissions. Chaque fragment s’insère à l’emplacement indiqué; ses références aux Fields, Queries et Actions correspondent aux déclarations du Model. 1. Clients · Data 2. Références · Knowledge 3. Préparation · Work 4. Soumissions · Product