Vue d'ensemble OvApp¶

2026-05-13

Introduction¶

OvApp est l'application mobile d'Omnivoltaic conçue pour soutenir les opérations quotidiennes dans les domaines de la mobilité électrique, de l'énergie et des flux de vente. L'application fournit des outils et interfaces adaptés via des applets — chaque applet est un flux de travail ciblé assigné au Compte de Service (CS) actif de l'utilisateur, assurant l'efficacité, la sécurité et la clarté pour chaque partie prenante de l'écosystème.

Au lancement, les utilisateurs se connectent et sélectionnent leur CS, ce qui détermine quels applets — et donc quelles fonctionnalités et flux de travail — sont disponibles pour eux.

OvApp est une application Android BLE (Bluetooth Low Energy) et de localisation utilisée dans l'écosystème d'échange de batteries.

OvApp fonctionne aussi bien en ligne qu'hors ligne et constitue le principal point d'entrée mobile dans l'écosystème OVES plus large (ERM, PAYG, stations d'échange et batteries connectées).

Objectif¶

OvApp est conçu pour :

Simplifier les échanges de batteries pour les Utilisateurs grâce à :
Une navigation par carte vers les stations d'échange à proximité.
Des fiches de station indiquant les batteries disponibles.
L'historique des échanges et le suivi des dépenses.
Fournir un accès clavier sécurisé pour les Clients Passifs en utilisant des codes/jetons à durée limitée.
Permettre aux Distributeurs de :
Surveiller l'inventaire des appareils dans les stations d'échange et les entrepôts.
Générer des jetons pour les Utilisateurs et les Clients Passifs.
Visualiser les données des appareils et les métriques liées aux échanges.
Équiper les Agents avec :
Des outils de scan et de connexion BLE.
Le suivi des itinéraires.
Des vues de données d'appareils (att/cmd/sts/dta/dia).
Des capacités de diagnostic et de dépannage.

Sélection des Applets¶

La grille de sélection des applets est le principal point d'entrée dans OvApp après la connexion et la sélection du CS. Les applets sont affichés sous forme de tuiles et sont assignés par Compte de Service (CS) — seules les tuiles accordées au CS actif sont affichées. Si un CS n'est assigné qu'à un seul applet, l'application navigue directement vers celui-ci sans afficher la grille.

Si aucun applet n'est assigné à un CS, un écran « Aucune application disponible » est affiché avec une option pour changer de compte.

Info

L'accès aux applets est contrôlé par le Compte de Service, et non par le compte utilisateur. Le même employé peut voir différents applets selon le CS sélectionné à la connexion.

Applets Disponibles¶

Applet	Slug d'applet	Description
Clients	`customer-management`	Visualiser et gérer les fiches clients
Produits	`products`	Parcourir et gérer le catalogue de produits
Commandes	`orders`	Visualiser et suivre les commandes
Utilisateur	`rider`	Application pour l'utilisateur final des motos/scooters électriques — cartes, stations, abonnements
Activateur	`activator`	Activation sur le terrain des appareils
Représentant Commercial	`customers`	Intégration des clients, sélection de forfaits, paiement, attribution de véhicule/batterie
Technicien	`attendant`	Échange de batterie assisté — flux en 6 étapes avec BLE, MQTT et paiement M-Pesa
Échange Manuel	`externalswap`	Variante de l'échange technicien utilisant une saisie manuelle du paiement au lieu de la confirmation QR/M-Pesa
Clavier	`keypad`	Saisie de jetons pour clients passifs via clavier numérique à l'écran et BLE
Gestionnaire d'Appareils BLE	`assets`	Outil complet de diagnostic et d'inspection BLE (onglets ATT/CMD/STS/DTA/DIA/HB)
Localisation	`location`	Suivi des itinéraires et de la localisation
Mes Appareils	`mydevices`	Outil d'activation d'appareils simplifié
OTA	`ota`	Mise à jour firmware over-the-air
Tickets	`ticketing`	Gestion des tickets de support

Descriptions des Applets¶

Clients
- Visualiser, rechercher et gérer les fiches clients sur la plateforme.
Produits
- Parcourir le catalogue de produits ; gérer les listes de produits.
Commandes
- Visualiser et suivre les commandes clients ; gestion des commandes style portail.
Utilisateur
- Optimisé pour les utilisateurs finaux opérant des motos ou scooters électriques.
- État du véhicule et utilisation, informations sur la batterie et le trajet, découverte de stations par carte.
Activateur
- Outil de terrain pour activer les appareils nouvellement déployés.
Représentant Commercial
- Conçu pour les équipes de vente terrain et en interne.
- Intégration des clients, gestion des produits et services, suivi des ventes.
Technicien
- Conçu pour le personnel de terrain gérant les échanges de batteries.
- Opération et surveillance des appareils, gestion des transactions, diagnostics de base.
Échange Manuel
- Identique au Technicien mais utilise une saisie manuelle du paiement — l'étape de confirmation de paiement Odoo est ignorée et le paiement est saisi manuellement.
- La visibilité est contrôlée par le slug d'applet externalswap.
Clavier
- Destiné aux clients passifs qui n'ont besoin que de saisir des jetons.
- Saisie numérique sécurisée, connexion BLE, opérations hors ligne ou en faible connectivité.
Gestionnaire d'Appareils BLE
- Axé sur les équipes techniques et de support gérant les appareils Bluetooth.
- Découverte, appairage, configuration, diagnostics et surveillance à distance d'appareils BLE.
Localisation
- Suivi des itinéraires et de la localisation pour les opérations terrain.
Mes Appareils
- Activation d'appareils simplifiée — générer ou récupérer des codes d'activation sans naviguer dans les données de service brutes.
OTA
- Télécharger et appliquer des mises à jour firmware over-the-air aux appareils.
Tickets
- Créer et gérer des tickets de support.

Principes de Conception Clés¶

Contrôle d'Accès Basé sur le CS : Les applets sont accordés par Compte de Service — les utilisateurs ne voient et n'accèdent qu'aux flux de travail pertinents pour le CS sous lequel ils opèrent
Efficacité Opérationnelle : La complexité est réduite en présentant des applets ciblés à usage unique plutôt qu'une interface monolithique unique
Évolutivité : Prend en charge l'expansion vers de nouveaux applets, appareils et services sans perturber les flux de travail existants
Conception Centrée sur l'Utilisateur : Visuels clairs et navigation intuitive pour des groupes d'utilisateurs divers dans différentes langues et conditions de connectivité

L'utilisateur lance OvApp
L'écran de connexion est affiché :
- Email/Mot de passe ou Numéro de Téléphone — pour les clients externes (distributeurs, utilisateurs)
- Se connecter avec Microsoft — réservé aux employés internes OVES uniquement
- Clavier — Connexion non requise — pour les clients passifs (aucun compte nécessaire)
Compte de Service (CS) :
- Si le compte appartient à plusieurs CS → un sélecteur Choisir un Compte est affiché ; l'utilisateur appuie sur le CS dans lequel il souhaite travailler
- Si le compte appartient à un seul CS → l'application passe le sélecteur et va directement à la grille des applets pour ce CS
La grille de sélection des applets est affichée — seuls les applets accordés au CS actif sont visibles
L'utilisateur appuie sur une tuile d'applet — l'application charge ce flux de travail

Note

Si le CS actif n'a qu'un seul applet assigné, l'application passe également la grille des applets et navigue directement dans ce flux de travail.

Groupes de Fonctionnalités Principales¶

OvApp expose des fonctionnalités regroupées en quelques domaines principaux :

Fonction Clavier
- Saisir des codes/jetons pour déverrouiller ou réactiver des appareils.
- Utilisé par les Utilisateurs, les Clients Passifs, les Distributeurs et les Agents.
Carte et Routage (Utilisateurs)
- Afficher les stations d'échange à proximité.
- Afficher le nombre de batteries disponibles par station.
- Proposer un guidage/menu d'itinéraire pour atteindre une station d'échange sur le trajet de l'Utilisateur.
Historique des Échanges (Utilisateurs)
- Liste des échanges passés.
- Total des dépenses en échanges de batteries dans le temps.
Inventaire et Gestion des Jetons (Agents/Distributeurs)
- Listes d'appareils pour les stations d'échange et les entrepôts.
- Outils de génération de jetons pour les Utilisateurs et les Clients Passifs.
Données et Diagnostics des Appareils (Agents/Distributeurs)
- Données structurées regroupées dans :
  - att – Attributs (IDs, SIM, firmware).
  - cmd – Commandes/configuration.
  - sts – État & état PAYG.
  - dta – Données (puissance, batterie, GPS, cycles).
  - dia – Diagnostics (tensions de cellules, températures).
Accès Hors Ligne
- Utilisateurs et Clients Passifs :
  - Peuvent utiliser le Clavier et voir les dernières données synchronisées hors ligne.
  - Agents et Distributeurs :
  - Peuvent utiliser BLE pour lire les appareils hors ligne.
  - Ont besoin d'Internet pour synchroniser les changements et télécharger les lectures.

Résumé¶

OvApp est une plateforme mobile multi-applets qui connecte les Utilisateurs, les Clients, les Agents et les Distributeurs dans un écosystème intelligent. Elle combine :

Accès aux appareils BLE
Activation par jeton/clavier
Découverte de stations d'échange par carte
Vues d'inventaire et de diagnostics

Le tout avec la prise en charge des opérations en ligne + hors ligne sur le terrain.