1. Le modèle en deux niveaux

Pitflow sépare l’administration du service et l’exploitation métier.

  • Le panel (pitflow.fr) gère le cycle de vie : environnements, licences, utilisateurs, versions, sauvegardes, téléchargements d’apps.
  • Un environnement est l’instance métier d’une organisation (commune, société, service). C’est là que vivent la carte, les missions, l’annuaire, les équipages et la messagerie.

Chaque environnement a un slug (exemple : ma-commune). L’accès métier se fait de deux façons :

Accès Console PWA
URL Pitflow (toujours valable) https://pitflow.fr/ma-commune/app/ https://pitflow.fr/ma-commune/pwa/
Domaine personnalisé (option) https://mairie.fr/app/ https://mairie.fr/pwa/

Le panel reste sur pitflow.fr. Seule l’instance métier (console + PWA) peut s’afficher sur votre nom de domaine : le slug n’apparaît plus dans l’adresse. Guide : Domaine personnalisé.

Un compte panel n’est pas un compte agent. Le panel sert aux responsables qui commandent et administrent. Les agents se connectent à la console ou à la PWA de leur environnement.

2. Les applications, une par une

Application Public Rôle
Panel (ce site) Responsable / admin Créer et piloter l’environnement
Console web (Pitflow-App) Chef de poste, planning, admin métier Commandement, carte, rapports, équipages
PWA Agents terrain Missions, carte, rapports, planning, véhicules
Android Agents terrain Coque native : APK aujourd’hui, Play Store à venir
iOS Agents terrain Coque native : IPA aujourd’hui, App Store à venir
Desktop Poste fixe / PC Coque native Windows, macOS ou Linux, puis la console

La PWA, Android et iOS partagent le même métier terrain. Android et iOS n’ajoutent pas une autre base de données : ce sont des enveloppes (WebView) autour de la PWA, avec scan QR, notifications et mises à jour d’app.

Desktop enveloppe la console web, pas la PWA.

L’exploitation des serveurs (cluster, nœuds) se fait sur un panneau interne distinct. Ce n’est ni le panel client, ni la console métier, et ce n’est pas documenté ici.

3. Comment un agent arrive sur le terrain

1

Compte créé dans l’environnement

Dans le panel : Environnement → Utilisateurs. Le compte a un identifiant, un mot de passe, éventuellement un PIN, et une licence si la capacité l’exige.

2

Application installée

PWA dans le navigateur, ou fichier APK / IPA depuis l’onglet Téléchargement. Les apps natives arriveront ensuite sur le Play Store et l’App Store.

3

Appariement (apps natives seulement)

Le QR ou le lien de l’onglet Téléchargement relie l’appareil à cet environnement. Sans ça, l’app native ne sait pas quelle commune / société ouvrir.

4

Connexion métier

Identifiant et mot de passe de l’agent. Un PIN peut ensuite verrouiller l’écran (réglage Sécurité de l’environnement).

4. Ce que ce site documente

Les guides suivants détaillent chaque application, le domaine personnalisé, puis les sujets transverses (messagerie, licences, sauvegardes, pairing). Ils décrivent le produit tel qu’il est aujourd’hui, pas un catalogue marketing.