> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/les-concepts-de-base.md). # Les concepts de base Dans Ksaar, on distingue deux types d'acteurs : le **maker** (vous, qui créez l'application) et l'**utilisateur final** (aussi appelé end-user, qui utilisera l'application une fois en production, mais n'est pas supposé la modifier). Mais pour une application, il y a bien souvent plusieurs types d'utilisateurs (par exemple un administrateur, un client, un commercial), et tous n'auront pas le même usage. Une application se construit donc autour de [personas](/ksaar-documentation/utilisateurs/quest-ce-quun-persona.md), comprendre "catégorie d'utilisateurs", chaque persona ayant son interface dédiée. En tant que maker, vous allez être amené à construire des interfaces, mais aussi à manipuler des données. Toutes vos données sont stockées dans des tables, que vous retrouverez dans l'onglet "Data", dans la barre à gauche de votre écran.

Vue data

Vos données sont présentées sous forme de tableaux. Dans ces tableaux, on distingue les [champs](/ksaar-documentation/les-elements/les-champs.md), qui correspondent aux colonnes et ont un type bien défini et non modifiable, des **enregistrements**, qui correspondent aux lignes et sont donc vos données en elles-mêmes. Maintenant que nous avons ces premières briques, voyons comment se construit une application. ## Construction d'une application Ksaar * Une application complète se compose d'un [espace personnel](/ksaar-documentation/les-concepts-de-base/lespace-personnel.md) spécifiquement défini pour chaque persona. Celui-ci est composé de pages et de sous-pages qui permettent d'accéder à toute l'application, l'idée étant que chaque utilisateur ait un accès adapté à son rôle.
* Ainsi, par exemple, vous aurez défini un persona "Client" et un persona "Support" : * Dans son espace personnel, le "Client" pourra voir les informations qui le concernent (par exemple ses contrats, ses demandes de service et leur progression). * L'espace personnel du "Support", quant à lui, lui permettra de traiter les demandes de service qui lui ont été adressées.
* Chaque [page](/ksaar-documentation/les-workflows/les-pages.md) d'un espace personnel est composée de lignes et de colonnes qui peuvent être peuplées par des [éléments](/ksaar-documentation/les-elements/les-elements.md) de l'application.
* Pour créer des enregistrements, un utilisateur passe par un [workflow](/ksaar-documentation/les-workflows/quest-ce-quun-parcours.md) : il s'agit d'un formulaire que vous pouvez configurer pour collecter des informations. Par exemple, si votre "Client" veut créer une nouvelle demande de service, il passera par le workflow de création de demande, sur lequel il remplira toutes les informations nécessaires à son traitement. Vous pouvez alors placer un [bouton](/ksaar-documentation/les-elements/elements-contenus-basiques.md#element-bouton) sera une des pages de son espace personnel pour rediriger vers le workflow souhaité. À la validation, cela créera un enregistrement dans la table associée, que vous pourrez ensuite traiter à votre convenance. * Par exemple, vous pouvez permettre au "Support" de voir la nouvelle demande dans un [tableau](/ksaar-documentation/laffichage-des-donnees/tableaux.md) sur son espace personnel. Un bouton dans le tableau lui permettra d'ouvrir une [fiche](/ksaar-documentation/les-workflows/modifier-afficher-vos-donnees.md) qui contient les informations. Vous pouvez également ajouter un bouton redirigeant vers un suivi, c'est-à-dire une suite de pages et d'[actions](/ksaar-documentation/les-workflows/creer-des-pages.md) liées à la table, permettant de prendre en charge la demande puis envoyant automatiquement un e-mail pour prévenir le client de l'évolution de sa demande. Ceci est un tout petit aperçu de ce que Ksaar permet de réaliser et vous en introduit les différents concepts. Maintenant que vous connaissez ces différentes notions, à vous de construire l'application qu'il vous faut ! --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ksaar.gitbook.io/ksaar-documentation/les-concepts-de-base.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.