KEPLIN Docs

Créer et gérer des apps

Où vivent les apps, comment en créer une dans la fenêtre Nouvelle app, comment changer le nom et l'icône, et comment supprimer une app sans surprises.

Dans Keplin, l'App est l'unité de tout : chaque application que vous construisez — avec son modèle de données, ses écrans, ses APIs, ses scripts, ses utilisateurs et ses paramètres — est une app, autonome et indépendante des autres. Cette page montre où les apps apparaissent, comment on en crée une, comment on change son identification, et ce qui se passe (exactement) quand on la supprime.

Où vivent les apps

Les apps se trouvent à deux endroits :

  • Le Dashboard, la première page après la connexion, a une ligne par app que votre compte peut ouvrir, avec l'activité des dernières 24 heures. Cliquez sur le nom d'une app pour l'ouvrir. Voir L'espace de travail.
  • La barre latérale gauche affiche, au centre, les apps que vous avez épinglées dans le Dashboard avec l'épingle Épingler au menu latéral. La barre se divise en trois zones : en haut le Dashboard, en bas l'administration (Observabilité, Utilisateurs, Clés API, Paramètres), et au centre les apps épinglées, chacune avec son icône et son nom. C'est la seule zone de la barre qui prend un défilement quand les apps sont nombreuses.

La barre latérale avec les apps épinglées dans la zone du milieu, l'app Gestion de Clients parmi elles
La barre latérale avec les apps épinglées dans la zone du milieu, l'app Gestion de Clients parmi elles

  • Avec la barre repliée, vous ne voyez que les icônes ; passez la souris dessus pour la déployer, ou utilisez Épingler la sidebar (l'épingle en haut) pour la garder ouverte.
  • Cliquez sur une app pour l'ouvrir : vous entrez dans son espace de travail, sur l'onglet Vue d'ensemble, avec les arborescences de contenu (UI, Code, Données, Tests, Radar) dans la barre propre à l'app.

Note

Tout le monde ne voit pas les mêmes apps. Un administrateur les voit toutes ; un developer ne voit que les apps qui lui ont été attribuées dans sa fiche, dans Utilisateurs. Si une app « n'apparaît pas », c'est presque toujours cela.

Créer une app

Créer une app, c'est ouvrir une fenêtre, lui donner un nom et une icône. Seuls les administrateurs ont le bouton.

  1. Dans l'en-tête du Dashboard, ou dans la zone des apps de la barre latérale (le bouton avec le signe plus, en fin de liste), cliquez sur Nouvelle app.
  2. La fenêtre Nouvelle app s'ouvre — « Choisissez comment l'app naît : vide, avec datasource, à partir d'un modèle ou importée. » — avec quatre cartes : Application vide, Application avec datasource, À partir d'un modèle et Importer un paquet. Pour une app de zéro, choisissez Application vide. (La carte Application avec datasource fait pareil et crée déjà le premier datasource SQLite de l'app ; les modèles et l'import ont leur propre page dans ce chapitre.)
  3. Remplissez le Nom. C'est le nom qui apparaît dans la barre latérale et dans les en-têtes — par exemple, Gestão de Clientes.
  4. Si vous le voulez, écrivez une Description — une phrase qui dit au reste de l'équipe à quoi sert l'app.
  5. Choisissez l'Icône (voir la section suivante).
  6. Cliquez sur Créer l'app. L'app naît vide, apparaît dans le Dashboard et son espace de travail s'ouvre aussitôt. Pour l'avoir aussi dans la barre latérale, épinglez-la dans le Dashboard avec Épingler au menu latéral.

La fenêtre Nouvelle app avec l'onglet Créer de zéro rempli pour l'app Gestion de Clients
La fenêtre Nouvelle app avec l'onglet Créer de zéro rempli pour l'app Gestion de Clients

Champ Obligatoire Limites À quoi il sert
Nom Oui 2 à 120 caractères Le nom visible de l'app, partout.
Description Non Jusqu'à 500 caractères Du contexte pour l'équipe ; il apparaît dans l'en-tête de l'app.
Icône Non — Le visage de l'app dans la barre latérale. Sans choix, c'est la fusée.

Le slug — l'identifiant qui naît avec l'app

À côté du champ Nom se trouve la note : « Le slug est dérivé automatiquement du nom. » Le slug est la version courte et technique du nom — minuscules, sans espaces ni accents : Gestão de Clientes donne gestao-clientes. C'est lui qui identifie l'app dans les adresses (la version de travail répond sur /app/gestao-clientes), à l'exportation et dans la confirmation de suppression.

Attention

Le slug doit être unique dans l'installation et ne se change plus une fois l'app créée. S'il existe déjà une app avec le même slug, la création s'arrête sur l'erreur « Il existe déjà un projet avec le slug… » — changez le nom (ou supprimez l'ancienne app) et réessayez.

L'icône de l'app

Le champ Icône ouvre le sélecteur Choisir une icône de la plateforme : une grille avec des centaines d'icônes et une boîte « Rechercher des icônes… » pour filtrer par nom. Cliquez sur une icône pour la choisir ; Par défaut revient à la fusée d'origine.

L'icône choisie accompagne l'app partout : dans la barre latérale, dans l'en-tête de l'espace de travail, et elle voyage avec elle quand vous l'exportez dans un package. Dans une installation avec beaucoup d'apps, une icône distincte vaut de l'or — c'est par elle que l'on retrouve l'app quand la barre est repliée.

Changer le nom, la description ou l'icône

L'identification de l'app se change dans ses paramètres, à tout moment :

  1. Ouvrez l'app, depuis le Dashboard ou la barre latérale.
  2. En haut de la barre de l'app, cliquez sur le bouton d'engrenage Paramètres de l'app et choisissez Général.
  3. Dans le panneau Identification, modifiez le Nom, la Description ou l'icône. L'icône est juste à côté du nom, parce que c'est ainsi que les deux apparaissent dans le Dashboard et dans la barre latérale.
  4. Cliquez sur Enregistrer. La confirmation « Paramètres enregistrés. » apparaît, et le Dashboard et la barre latérale se mettent à jour aussitôt.

Le panneau Identification dans la section Général des paramètres de l'app Gestion de Clients
Le panneau Identification dans la section Général des paramètres de l'app Gestion de Clients

Note

Changer le nom ne change pas le slug ni aucune adresse publiée — ceux qui utilisent l'app ne remarquent rien. Le nom est cosmétique ; le slug est structurel.

L'icône sur le téléphone

KeplinGo place un raccourci vers chaque app sur l'écran d'accueil du téléphone (voir Connecter le téléphone à une app). L'icône de ce raccourci se choisit dans le panneau Icône sur le téléphone de la section Général.

Pour choisir l'icône sur le téléphone, procédez comme suit :

  1. Dans les Paramètres de l'app, ouvrez Général.
  2. Dans le panneau Icône sur le téléphone, cliquez sur Importer une image et choisissez l'image. Pour utiliser une image qui se trouve déjà dans les assets de l'app, cliquez sur le bouton de l'image, à gauche de Importer une image.
  3. Facultatif : dans Couleur de fond, choisissez la couleur placée derrière les parties transparentes de l'image. Vide correspond au blanc.
  4. Dans Rendu sur Android, vérifiez que l'essentiel du dessin est à l'intérieur du cercle en pointillés.
  5. Cliquez sur Enregistrer.

L'image doit être en PNG, JPG ou WebP, carrée, d'au moins 432 × 432 px. Android rogne les coins avec la forme choisie par le fabricant du téléphone (cercle, superellipse ou carré arrondi), et seul le cercle central, environ 61 % du côté, apparaît toujours. L'aperçu montre l'image entière avec cette zone sûre, et l'image découpée par chacune des trois formes.

Sans image, KeplinGo dessine l'Icône de l'app sur la couleur principale du thème. Les téléphones mettent à jour le raccourci à la prochaine ouverture de l'app.

Note

Importer une image enregistre aussitôt l'image dans les assets de l'app, dans le dossier mobile/. L'icône du raccourci ne change qu'après Enregistrer.

Supprimer une app

Supprimer une app est définitif, et c'est pour cela que la plateforme demande plus qu'un clic.

  1. Ouvrez Paramètres de l'app → Général et descendez jusqu'au panneau Supprimer — « L'app, ses données et ses fichiers. Aucun retour en arrière. »
  2. Cliquez sur Supprimer l'app.
  3. La boîte de dialogue de confirmation « Supprimer "Gestão de Clientes" ? » s'ouvre, et prévient : « Supprime l'app "Gestão de Clientes" avec toutes ses APIs, datasources, clés API et packages. Il n'y a pas de retour en arrière — les apps consommatrices perdent l'accès immédiatement. »
  4. Écrivez le slug de l'app (gestao-clientes) dans le champ de confirmation — le bouton ne se débloque que lorsque le texte coïncide exactement.
  5. Cliquez sur Supprimer définitivement. Vous revenez au Dashboard, sans l'app.

La boîte de dialogue de confirmation pour supprimer l'app, avec le slug écrit pour débloquer le bouton
La boîte de dialogue de confirmation pour supprimer l'app, avec le slug écrit pour débloquer le bouton

Ce qui se passe, avec précision :

Est supprimé L'app entière dans cette installation : modèle, écrans, APIs, scripts, rapports, workflows, toutes les versions, les comptes des utilisateurs de l'app, les fichiers conservés sur le disque de l'app et son historique.
Cesse de fonctionner immédiatement Les adresses publiées et les clés API de l'app — tout système qui la consommait perd l'accès sur le moment.
Reste intact L'audit (qui a fait quoi reste consultable dans l'Observabilité) et tout ce qui est infrastructure externe : bases de données d'autres systèmes auxquelles l'app se connectait, fichiers sur S3, SFTP ou partages réseau. Supprimer l'app ne supprime jamais de données hors d'elle.

Attention

Il n'y a ni corbeille ni « annuler ». Avant de supprimer une app qui contient du travail, exportez-la en package — la page « Importer et exporter des apps » explique comment, et un package conservé est la seule façon de la récupérer ensuite.

Pourquoi je ne vois pas… ?

  • …le bouton Nouvelle app ? Créer et importer des apps est réservé aux administrateurs. Avec un profil de developer, le bouton n'apparaît pas — demandez à un administrateur de créer l'app et de vous l'attribuer.
  • …une app qui existe ? Votre compte n'a pas cette app attribuée. Un administrateur règle cela dans la fiche de votre compte, dans Utilisateurs.
  • …le panneau Supprimer ? Seuls les administrateurs entrent dans la section Général des paramètres avec le pouvoir de supprimer. Si la section s'ouvre mais que quelque chose échoue à l'enregistrement, vérifiez votre profil auprès d'un administrateur.