Les concepts Surface
Portfolio, Workspace, Space, Surface et Model : les responsabilités de chaque niveau.
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.
{
"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.
{
"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.
- Clients · Data
- Références · Knowledge
- Préparation · Work
- Soumissions · Product
Fiches et informations de référence
Tarifs, procédure et sources
Étapes, décisions et résultats
Livrable durable et ses révisions