MANUEL D’UTILISATION – AGI GESTION STARLINK

Andonick Group

Guide des administrateurs et utilisateurs
Édition du 21 septembre 2026 • Version 12

Utiliser AGI au quotidien

AGI centralise les clients, leurs échéances, leurs comptes Starlink, les kits associés et les paiements saisis par l’équipe. Ce manuel explique les opérations disponibles, les droits d’accès et les précautions à prendre pour conserver un historique cohérent.

Le suivi est manuel. AGI ne pilote pas les antennes, ne suspend pas les abonnements chez Starlink et ne réalise aucun encaissement bancaire ou Mobile Money. Les montants et statuts enregistrés décrivent les opérations suivies par votre équipe.

Sommaire

1 Accès et connexion

2 Navigation et indicateurs

3 Créer et consulter un client

4 Modifier et supprimer un client

5 Gérer les comptes Starlink

6 Gérer les kits

7 Enregistrer et consulter les paiements

8 Archiver et restaurer

9 Créer et gérer les utilisateurs

10 Mots de passe et sécurité

11 Résoudre les difficultés courantes

12 Administration technique et périmètre de version

Les intitulés entre guillemets correspondent aux commandes de l’application. Les recommandations de sécurité complètent les protections existantes sans constituer des fonctions supplémentaires.

1 Accès et connexion

Préparer votre accès

Utilisez l’adresse communiquée par Andonick Group. L’adresse de la version publiée est https://orbite-clients-starlink.nicoandonick.chatgpt.site/. Conservez la même adresse dans vos favoris : les sessions sont propres à chaque domaine.

Pour vous connecter, vous devez disposer d’un accès AGI actif, d’une adresse e-mail et d’un mot de passe AGI initialisé. La connaissance d’une adresse e-mail ne suffit pas. L’application ne propose ni inscription publique ni connexion avec ChatGPT.

Se connecter

1. Ouvrez le site dans votre navigateur. Le formulaire conserve le logo AGI.

2. Dans « E-mail », saisissez l’adresse de votre accès AGI.

3. Dans « Mot de passe », saisissez le mot de passe remis ou défini pour cet accès. Respectez les majuscules, minuscules et espaces.

4. Cliquez sur « Connexion ». Après validation, vous accédez à la gestion des clients.

Les espaces autour de l’adresse e-mail sont ignorés et l’adresse est normalisée en minuscules. Le mot de passe est vérifié tel qu’il est saisi. Un mot de passe ChatGPT ne devient pas automatiquement un mot de passe AGI.

Comprendre vos droits

Les utilisateurs ordinaires ont accès aux données métier communes. Il n’existe pas de rôle limité à la consultation ni de restriction par client dans cette version.

Terminer une session

Cliquez sur « Déconnexion » dans l’en-tête, particulièrement sur un appareil partagé. Une session expire 12 heures après la connexion. Cette durée n’est pas un délai de 12 heures d’inactivité. Après expiration, reconnectez-vous pour poursuivre les opérations.

2 Navigation et indicateurs

L’en-tête affiche le logo AGI à gauche et le titre « Gestion Starlink » au centre. À droite figurent l’identité de la personne connectée et « Déconnexion ». Pour le propriétaire, l’affichage indique « Andonick » et « Administrateur principal ».

Accéder aux sections

Lire les compteurs

La mention du nombre de clients « au total » inclut les clients archivés. Elle peut donc être supérieure au compteur « Clients actifs ». Une échéance prévue aujourd’hui n’est pas encore dépassée.

Retrouver les clients à suivre

Cliquez sur « Voir les clients concernés » sous les échéances dépassées pour ouvrir la liste Clients avec ce filtre. Dans « Clients actifs », le sélecteur permet de revenir à « Tous les clients actifs » ou de choisir « Échéance dépassée ».

Utiliser AGI sur mobile

Les mêmes opérations sont disponibles depuis le navigateur mobile. Faites défiler la page pour atteindre les formulaires et les actions. Si un tableau dépasse la largeur de l’écran, faites-le défiler horizontalement pour consulter les colonnes et les boutons à droite. Vérifiez le client sélectionné avant de valider une saisie.

3 Créer et consulter un client

Créer la fiche

1. Cliquez sur « Nouveau client », ou sur « Ajouter un client » si la liste est vide.

2. Renseignez les informations du client et sélectionnez explicitement sa devise.

3. Si nécessaire, ajoutez les comptes Starlink et les kits dans la partie « Comptes Starlink et kits » du formulaire.

4. Relisez les montants, la devise et l’échéance, puis cliquez sur « Enregistrer le client ». Attendez le message de confirmation.

Les devises proposées sont FCFA (XAF), FCFA (XOF), Dollar (USD), Euro (EUR) et Franc congolais (CDF). Vérifiez le code : XAF et XOF sont deux choix distincts. Aucun taux de change ni conversion automatique n’est fourni.

Ajouter des éléments lors de la création

Un client peut être enregistré sans compte Starlink. Vous pourrez ajouter ses comptes et kits plus tard. Les commandes « Retirer ce kit non enregistré » et « Retirer ce compte non enregistré » retirent uniquement les éléments du formulaire en cours. « Annuler » ferme le formulaire sans enregistrer.

Rechercher et ouvrir une fiche

La recherche « Rechercher un nom, téléphone, kit… » porte sur le nom, le téléphone et le champ « Identifiant du kit » de la fiche. Pour rechercher un e-mail de compte ou un numéro de série de kit détaillé, utilisez « Comptes Starlink ». Cliquez sur le nom du client pour ouvrir sa fiche et retrouver ses comptes et kits associés.

4 Modifier et supprimer un client

Modifier les informations

1. Dans « Clients », retrouvez la personne concernée.

2. Cliquez sur l’icône de modification, identifiée par « Modifier » suivi du nom du client.

3. Dans « Modifier le client », corrigez les informations nécessaires.

4. Enregistrez, puis contrôlez les valeurs dans la liste ou la fiche.

Le lien « Voir les comptes Starlink et kits » permet d’accéder aux éléments associés. Une modification du nom du client se répercute sur son nom affiché dans l’historique des paiements. Les paiements ne constituent pas une copie figée de l’ancienne fiche.

Interpréter les états

Un client non archivé apparaît « À jour » ou « À renouveler » selon son échéance. Un client archivé porte l’état « Archivé ». Ces états servent au suivi interne ; ils ne confirment pas la disponibilité d’une antenne ni le paiement d’un abonnement auprès de Starlink.

Supprimer une fiche créée par erreur

La suppression définitive est possible seulement si le client ne possède aucun paiement et aucun compte Starlink lié. Un compte Starlink sans kit suffit à empêcher la suppression. Cette règle protège les liens avec les données existantes et s’applique aussi aux clients archivés.

1. Cliquez sur « Supprimer » pour le client concerné.

2. Lisez le nom et les informations de la fenêtre de confirmation. Si la suppression est bloquée, conservez le client et utilisez l’archivage.

3. Si la suppression est autorisée, saisissez exactement « SUPPRIMER ».

4. Cliquez sur « Supprimer définitivement ». Pour abandonner, cliquez sur « Annuler ».

La vérification des dépendances est faite avant la confirmation et lors de la suppression. L’application ne propose pas de corbeille ni d’action de restauration pour une fiche supprimée définitivement.

Choisir entre suppression et archivage

Utilisez la suppression pour une fiche inutile sans dépendance. Pour un client ayant déjà une activité ou des équipements liés, utilisez l’archivage. Celui-ci conserve la fiche et permet une restauration ultérieure. Ne supprimez pas des accès utilisateurs en pensant archiver leurs clients : il s’agit de deux opérations distinctes.

5 Gérer les comptes Starlink

Comprendre les liens

Une fiche client peut regrouper plusieurs comptes Starlink. Chaque compte peut contenir plusieurs kits. L’adresse e-mail du compte Starlink sert de référence métier ; elle ne crée pas d’utilisateur AGI et ne donne pas accès au fournisseur Starlink. AGI ne demande pas le mot de passe du compte Starlink.

Ajouter un compte

1. Ouvrez « Comptes Starlink » ou ouvrez la fiche du client.

2. Cliquez sur « + Ajouter un compte ».

3. Dans la vue globale, choisissez le client actif concerné. Depuis une fiche client, le rattachement est déjà fixé.

4. Renseignez l’adresse e-mail du compte, puis enregistrez.

5. Vérifiez le rattachement et ajoutez les kits si nécessaire.

L’adresse doit être valide et unique parmi tous les comptes Starlink enregistrés, y compris ceux des clients archivés. Elle est normalisée en minuscules et les espaces extérieurs sont retirés. Si une adresse existe déjà, retrouvez le compte correspondant au lieu de créer un doublon.

Modifier un compte

Utilisez « Modifier le compte » pour corriger son e-mail. Un compte enregistré ne peut pas être déplacé vers un autre client depuis l’interface. Aucun bouton ne permet de supprimer un compte Starlink enregistré.

Rechercher les comptes et leurs kits

La recherche « Client, e-mail, série, localisation, responsable… » retrouve les clients, e-mails de comptes et informations de kits. Elle peut aussi retrouver le statut, les remarques et la date d’installation des kits. Elle ignore les différences de casse et d’accents.

Le filtre « Tous les statuts » peut être remplacé par un statut de kit. Combinez texte et statut pour affiner les résultats. Les totaux présentés dans la section décrivent les comptes et kits de son périmètre ; ne les interprétez pas comme un total financier.

Consulter les comptes archivés

La vue globale affiche les comptes des clients actifs. Pour retrouver ceux d’un client archivé, ouvrez « Clients » puis « Clients archivés » et cliquez sur son nom. Ses comptes portent la mention « Archivé — Client archivé ». Les informations restent consultables et modifiables depuis cette fiche. Un compte ajouté à un client archivé reste dans le périmètre archivé.

6 Gérer les kits

Ajouter et modifier un kit

1. Ouvrez le compte concerné dans « Comptes Starlink » ou dans la fiche client.

2. Cliquez sur « + Ajouter un kit ».

3. Saisissez le numéro de série et complétez les informations disponibles.

4. Choisissez le statut, puis cliquez sur « Enregistrer le kit ».

5. Pour une correction ultérieure, utilisez « Modifier le kit » et enregistrez les nouvelles valeurs.

Choisir un statut

Ces statuts sont des indications saisies par l’équipe. Les modifier ne commande ni mise en service, ni suspension, ni dépannage chez Starlink. Le statut « retiré » ne supprime pas la fiche.

Un kit enregistré ne peut pas être déplacé vers un autre compte via l’interface. Il n’existe pas d’action de suppression d’un kit enregistré. L’archivage d’un client masque ses kits de la vue globale, mais conserve leur statut technique pour une consultation ou une restauration ultérieure.

7 Enregistrer et consulter les paiements

Saisir un paiement reçu

1. Dans « Clients actifs », cliquez sur « Encaisser » pour le client concerné.

2. Dans « Enregistrer un paiement », vérifiez le nom du client et la devise.

3. Saisissez le montant reçu. Le tarif mensuel est proposé par défaut, mais le montant peut être différent.

4. Vérifiez la date du paiement, initialement positionnée sur la date du jour.

5. Choisissez la « Nouvelle échéance ». Elle est initialement celle du client : AGI n’ajoute pas automatiquement un mois.

6. Sélectionnez le moyen de paiement et cliquez sur « Confirmer le paiement ».

Le montant doit être strictement positif. La devise est celle du client et n’est pas librement choisie dans cette fenêtre. La nouvelle échéance doit être une date valide, égale ou postérieure à l’échéance actuelle. La confirmation enregistre le paiement et met à jour l’échéance du client.

Lire l’historique

Ouvrez « Paiements ». « Historique des paiements » affiche la date, le client, le montant, le moyen de paiement et la nouvelle échéance. Les paiements sont classés par date décroissante, puis par enregistrement récent à date identique. Le compteur indique leur nombre.

Les paiements d’un client archivé restent visibles avec la mention « Client archivé ». Après restauration, cette mention disparaît : elle traduit l’état actuel du client, et non une annotation définitive du paiement.

Éviter et traiter les erreurs

Vérifiez les données avant de confirmer. Si la réponse tarde ou si une erreur réseau apparaît, consultez l’historique avant de saisir de nouveau le paiement. L’interface ne propose ni modification ni suppression de paiement, ni remboursement. En cas d’erreur, signalez les informations au responsable AGI ; ne créez pas un paiement négatif ou un doublon pour tenter de corriger le premier.

« Encaisser » est indisponible pour les clients archivés. Restaurez d’abord le client si une reprise d’activité justifie une nouvelle saisie.

8 Archiver et restaurer

Archiver un client

1. Dans « Clients actifs », recherchez le client et ouvrez « Modifier le client ».

2. Cochez « Archiver ce client (conserver son historique) ».

3. Enregistrez la fiche.

4. Ouvrez « Clients archivés » pour vérifier sa présence.

Consulter les archives

Dans « Clients », choisissez « Clients archivés ». La recherche reste disponible. Cliquez sur le nom du client pour consulter sa fiche et ses comptes. Les comptes et kits restent modifiables depuis cette fiche ; l’archivage ne transforme donc pas l’ensemble de la fiche en lecture seule. Les paiements se consultent dans la section « Paiements ».

Restaurer un client

1. Dans « Clients archivés », recherchez le client.

2. Cliquez sur « Restaurer » dans sa ligne.

3. Attendez le message « Client et comptes Starlink restaurés. ».

4. Vérifiez sa présence dans « Clients actifs » et celle de ses comptes dans « Comptes Starlink ».

Il est également possible d’ouvrir la modification de la fiche, de décocher l’archivage et d’enregistrer. La restauration remet le client et ses comptes dans les listes actives. Elle conserve les paiements, l’échéance et les statuts des kits. Si l’échéance est dépassée, le client restauré réapparaît aussitôt parmi les clients à renouveler.

L’archivage et la restauration portent sur le suivi dans AGI. Ils ne suspendent ni ne réactivent un abonnement chez Starlink. Un kit qui était « en panne » avant l’archivage reste « en panne » après restauration.

9 Créer et gérer les utilisateurs

Cette section est réservée à l’administrateur. Ouvrez « Utilisateurs » pour afficher « Utilisateurs et accès ». Un accès utilisateur AGI sert à se connecter à l’application ; il est distinct d’une fiche client et d’un compte Starlink.

Créer un accès

1. Renseignez « Nom », « Adresse e-mail de l’utilisateur » et « Mot de passe ».

2. Vérifiez l’adresse : elle doit être unique. Le nom accepte jusqu’à 120 caractères et l’e-mail jusqu’à 254.

3. Choisissez un mot de passe de 15 à 128 caractères, puis cliquez sur « Créer un accès ».

4. Après confirmation, transmettez l’e-mail et le mot de passe à la personne concernée par un canal privé.

5. Demandez-lui de vérifier sa connexion sur l’adresse utilisée par l’équipe.

Les nouveaux accès créés par ce formulaire sont des utilisateurs ordinaires. Aucun message de bienvenue ni envoi automatique du mot de passe n’est effectué. L’interface ne propose pas de modification ultérieure du nom ou de l’e-mail, ni de promotion au rôle administrateur.

Désactiver puis réactiver

Cliquez sur « Désactiver » pour retirer temporairement un accès. Ses sessions sont invalidées. Les données métier restent conservées. Cliquez ensuite sur « Réactiver » pour autoriser une nouvelle connexion. Le mot de passe existant est conservé ; les anciennes sessions ne sont pas rétablies.

Supprimer un accès

1. Dans la ligne du bon utilisateur, cliquez sur « Supprimer ».

2. Lisez la confirmation et saisissez exactement « SUPPRIMER ».

3. Cliquez sur « Supprimer définitivement », ou sur « Annuler » pour abandonner.

La suppression retire l’accès, ses informations d’authentification et ses sessions. Elle ne supprime pas les clients ni les paiements. Pour une absence temporaire, privilégiez la désactivation afin de pouvoir réactiver le même accès.

Protection du compte principal

Le compte de l’administrateur principal apparaît « Compte protégé ». Il ne peut pas être désactivé, supprimé ou réinitialisé par les commandes ordinaires de cette section. Sa récupération suit la procédure technique décrite au chapitre 12.

10 Mots de passe et sécurité

Définir ou renouveler le mot de passe d’un utilisateur

1. En tant qu’administrateur, ouvrez « Utilisateurs ».

2. Cliquez sur « Mot de passe » dans la ligne concernée.

3. Dans « Définir le mot de passe », vérifiez l’adresse affichée.

4. Saisissez le « Nouveau mot de passe », de 15 à 128 caractères, puis cliquez sur « Enregistrer ».

5. Communiquez le nouveau mot de passe par un canal privé. La personne doit se reconnecter : ses sessions existantes ont été fermées.

Cette opération initialise aussi le mot de passe d’un accès historique qui n’en possède pas encore. Un utilisateur ordinaire n’a pas de commande personnelle de changement de mot de passe et doit s’adresser à l’administrateur. Il n’existe pas de lien public « Mot de passe oublié » ni de réinitialisation envoyée automatiquement par e-mail.

Protections présentes

Les mots de passe sont conservés sous forme d’empreintes salées calculées avec scrypt. Les sessions reposent sur des jetons aléatoires dont seule l’empreinte est enregistrée en base. Le cookie de session utilise les protections HttpOnly, Secure et SameSite=Lax. Les opérations métier nécessitent une session autorisée côté serveur.

La connexion est limitée à 10 tentatives par e-mail et 50 par adresse IP sur une fenêtre de 15 minutes. Les tentatives sont comptées, y compris les connexions réussies. Une équipe utilisant la même connexion Internet peut atteindre une limite commune. Un message de refus ne révèle pas si le compte est inconnu, désactivé ou sans mot de passe initialisé.

Pratiques recommandées à l’équipe

• Choisissez un mot de passe long, unique et difficile à deviner ; un gestionnaire de mots de passe peut faciliter son utilisation.

• Ne partagez pas le compte administrateur. Créez un accès nominatif pour chaque personne autorisée.

• Ne placez aucun mot de passe dans les notes des clients ou des kits, dans une capture d’écran ou dans une conversation publique.

• Déconnectez-vous sur les appareils partagés et verrouillez votre appareil lorsque vous vous absentez.

• Désactivez rapidement les accès devenus inutiles. En cas de doute sur un mot de passe utilisateur, remplacez-le pour fermer ses sessions.

• Limitez les informations personnelles saisies à celles utiles au suivi et contrôlez les destinataires avant tout partage.

La version actuelle ne propose pas d’authentification à deux facteurs. Ces recommandations ne doivent pas être confondues avec une fonction intégrée ou une garantie de sauvegarde.

11 Résoudre les difficultés courantes

La connexion est refusée

Si « E-mail ou mot de passe incorrect. » apparaît, vérifiez l’adresse, les majuscules du mot de passe et les espaces copiés. Demandez ensuite à l’administrateur de vérifier l’état de l’accès et l’initialisation du mot de passe. Ce message peut aussi correspondre à un compte désactivé ; il ne permet pas de déterminer la cause à lui seul.

Si « Trop de tentatives. Réessayez dans 15 minutes. » apparaît, respectez le délai indiqué et évitez les essais répétés. Si « Connexion indisponible. Réessayez dans un instant. » apparaît, réessayez plus tard et signalez la difficulté si elle persiste.

Une section ou une donnée semble absente

Si « Utilisateurs » n’apparaît pas, vérifiez que vous êtes connecté avec le compte administrateur. Si un client manque, examinez « Clients archivés », effacez la recherche et vérifiez le filtre d’échéance. Si un compte Starlink manque dans la vue globale, ouvrez la fiche de son client archivé. Les paiements archivés restent dans « Paiements ».

La recherche de la liste Clients ne parcourt pas les numéros de série des kits détaillés ni les e-mails des comptes Starlink. Recommencez dans « Comptes Starlink » avec le champ approprié.

Une saisie est refusée

Pour un compte Starlink ou un kit, vérifiez l’unicité de l’e-mail ou du numéro de série, y compris dans les archives. Pour un paiement, vérifiez que le montant est positif et que la nouvelle échéance ne précède pas l’échéance actuelle. Pour un client, contrôlez le nom, la devise, le tarif et la date obligatoires.

Si une suppression de client est bloquée, il existe un paiement ou un compte lié. Archivez le client pour le retirer de l’activité courante tout en conservant les données. L’application ne permet pas de contourner cette protection dans l’interface.

L’enregistrement semble interrompu

Vérifiez votre connexion réseau. Si la session a expiré, reconnectez-vous. Consultez la liste ou l’historique pour déterminer si l’opération a déjà été enregistrée avant de recommencer. Les formulaires nécessitent une validation explicite ; ne supposez pas qu’une saisie non confirmée est sauvegardée.

Signaler un incident utilement

Transmettez au responsable AGI la section concernée, l’heure approximative, l’opération effectuée et le texte exact du message. Pour une erreur de paiement, ajoutez le client, la date, le montant et le moyen de paiement. Masquez les informations personnelles non nécessaires et ne transmettez jamais de mot de passe ou de cookie de session.

12 Administration technique et périmètre de version

Récupérer le compte administrateur principal

Cette procédure s’adresse au propriétaire ou à un intervenant technique autorisé disposant du projet et de la gestion des secrets de l’hébergement. Elle ne se réalise pas depuis le formulaire de connexion. L’adresse de l’administrateur principal configurée dans AGI est nicoandonick@gmail.com.

1. Dans un terminal privé, depuis le projet AGI, exécutez : node scripts/create-owner-password.mjs

2. Saisissez et confirmez le nouveau mot de passe dans la saisie masquée. Ne le passez pas en argument de commande.

3. Configurez uniquement l’empreinte produite dans le secret d’hébergement AGI_OWNER_PASSWORD_HASH. Ne placez ni le mot de passe ni ce secret dans le code ou une conversation.

4. Appliquez cette configuration par la procédure de déploiement autorisée, puis vérifiez la connexion et la déconnexion sur le domaine utilisé.

5. La modification du secret invalide les anciennes sessions de l’administrateur. Sans secret correctement configuré, aucun mot de passe par défaut ne permet l’accès.

Ce que couvre la version actuelle

L’édition 12 réunit l’identité AGI et le thème Andonick, l’en-tête centré, la connexion par e-mail et mot de passe, l’administration des accès, les clients, les comptes Starlink multiples, les kits, les paiements et l’archivage avec restauration des liens. Le suivi reste manuel.

Aucune interface n’est prévue pour importer ou exporter les données, produire des factures ou reçus, modifier ou supprimer un paiement, envoyer des rappels automatiques, consulter un journal d’audit complet ou gérer des sauvegardes. Les sauvegardes et interventions de maintenance doivent être organisées séparément par le responsable technique ; ce manuel n’établit aucune garantie de rétention.

Repères pour la maintenance

Référence de code de cette édition : f934a6649d43ded40a9ae0f4a7659209271124ae. L’authentification par mot de passe est issue de a3a3d48 ; l’en-tête centré de 3ae8653. Ces références servent à comparer le manuel à une évolution future.

Les procédures correspondent notamment aux interfaces app/page.tsx, app/users-panel.tsx, app/starlink-panel.tsx, app/starlink-fields.tsx et app/login-form.tsx, à leurs routes serveur et à docs/email-password-auth.md. Après une évolution fonctionnelle, faites réviser les chapitres concernés avant de distribuer une nouvelle édition.

Pour les utilisateurs, le point de contact est l’administrateur AGI. Pour le compte principal, les incidents d’hébergement ou une correction sans commande dans l’interface, faites intervenir le responsable technique autorisé.