Documentation Technique Wiflyx

Présentation de Wiflyx

Vue d'ensemble de la plateforme

Wiflyx est une plateforme complète de gestion de réseaux Wi-Fi captifs, conçue pour les fournisseurs d'accès Internet (ISP/TELCO), les hôtels, les entreprises, les établissements d'enseignement, les aéroports, les centres de santé, les cafés et les centres commerciaux. Elle permet de gérer l'ensemble du cycle de vie d'un réseau Wi-Fi public ou privé, depuis la configuration des équipements réseau jusqu'à la monétisation de l'accès Internet.

La plateforme se compose de plusieurs modules principaux accessibles depuis un menu latéral permanent :

Tableau de Bord

Supervision en temps réel des appareils, clients et analyses

Wiflyx Manager

Gestion des forfaits, vouchers et comptes utilisateurs

Captive Portal

Portails captifs personnalisables avec thèmes par secteur

Wiflyx Flash Ad

Bannières publicitaires et rubans promotionnels

Wiflyx Pay

Moyens de paiement et suivi des transactions

Administration

Groupes, utilisateurs et paramètres système

Architecture de la solution

Wiflyx repose sur une architecture cloud multi-tenant. Chaque organisation dispose de son propre espace identifié par un identifiant unique (ID de site). L'interface est accessible via un navigateur web moderne à l'adresse app.wiflyx.cloud.

L'application communique avec les équipements réseau (routeurs, points d'accès) via des protocoles standards. Les appareils compatibles incluent notamment les équipements Ruijie/Reyee avec le firmware ReyeeOS. Le tableau de bord affiche en temps réel l'état de chaque appareil, son adresse IP, son adresse MAC et la version de son logiciel.

L'application supporte le multilingue (Français, Anglais) et dispose d'un mode sombre/clair configurable depuis la barre d'en-tête. Le sélecteur de langue et le bouton de thème sont situés en haut à droite de l'interface.

Connexion à l'application

L'accès à l'application se fait via la page de connexion à l'adresse https://app.wiflyx.cloud/login. L'utilisateur doit saisir son adresse email et son mot de passe pour accéder au tableau de bord.

ChampTypeRequisDescription
EmailEmailOuiAdresse email associée au compte utilisateur
Mot de passePasswordOuiMot de passe du compte (sensible à la casse)
Après la connexion, l'utilisateur est redirigé vers le tableau de bord de son site. La barre d'en-tête affiche le sélecteur de groupe/bâtiment, le sélecteur de langue, le bouton de thème et le menu utilisateur avec les options Profil, Paramètres et Déconnexion.

Tableau de Bord - Appareils

Supervision des équipements réseau

L'onglet Appareils est l'écran principal du tableau de bord. Il affiche une vue d'ensemble de tous les équipements réseau enregistrés dans l'infrastructure. Quatre cartes de statistiques sont affichées en haut de la page :

Total des appareils

Appareils en ligne

Appareils hors ligne

Types d'appareils

Le tableau principal liste chaque appareil avec les colonnes : Appareil (nom et modèle), Type (GATEWAY, AP), Statut (En ligne / Hors ligne avec indicateur coloré), Adresse IP (IP locale et WAN), Adresse MAC et Version du logiciel (ReyeeOS). Des boutons Télécharger et Actualiser sont disponibles en haut à droite.

Tableau de bord - Onglet Appareils
Cliquer pour agrandir
Figure 1 : Tableau de bord - Onglet Appareils affichant la liste des équipements réseau, leurs statuts et informations techniques

Onglet Clients

L'onglet Clients affiche la liste de tous les utilisateurs connectés au réseau Wi-Fi. Il permet de visualiser les clients actifs, leur consommation de données, la durée de connexion et les informations de session. Le tableau inclut les colonnes : nom d'utilisateur, adresse MAC, adresse IP, forfait utilisé, données consommées, temps restant et statut de connexion.

Tableau de bord - Onglet Clients
Cliquer pour agrandir
Figure 2 : Tableau de bord - Onglet Clients affichant les utilisateurs connectés au réseau avec leurs informations de session

Onglet Vouchers

L'onglet Vouchers du tableau de bord offre une vue rapide de l'état des bons d'accès. Il affiche les vouchers actifs, utilisés et expirés avec des statistiques globales et un tableau détaillé de chaque voucher.

Tableau de bord - Onglet Vouchers
Cliquer pour agrandir
Figure 3 : Tableau de bord - Onglet Vouchers avec les statistiques et la liste des bons d'accès

Onglet Analyses

L'onglet Analyses fournit des graphiques et statistiques détaillés sur l'utilisation du réseau : nombre de connexions, consommation de bande passante, répartition par forfait, tendances temporelles. Les données sont présentées sous forme de graphiques interactifs avec des filtres de période.

Tableau de bord - Onglet Analyses
Cliquer pour agrandir
Figure 4 : Tableau de bord - Onglet Analyses avec les graphiques de statistiques d'utilisation du réseau

Onglet Notifications

L'onglet Notifications centralise toutes les alertes et événements du système : déconnexion d'appareils, expiration de vouchers, tentatives de connexion échouées, mises à jour disponibles. Chaque notification est horodatée et classée par niveau de priorité.

Les notifications peuvent être filtrées par type (information, avertissement, erreur) et par période. Un badge sur l'onglet indique le nombre de notifications non lues.

Gestion des Forfaits

Wiflyx Manager > Forfaits

Le module Forfaits (Packages) permet de créer et gérer les différentes offres d'accès Internet. Chaque forfait définit les paramètres de connexion : durée, quota de données, limites de débit, nombre d'appareils autorisés et prix. La page principale affiche la liste de tous les forfaits sous forme de tableau avec des filtres de recherche, de statut, de type de vente et de groupe d'utilisateurs.

Le tableau des forfaits comporte les colonnes : Forfait (nom), Prix, Durée, Quota, Débit (upload/download), Appareils, Type et Actions (modifier, supprimer). Le bouton Add Package en haut à droite permet de créer un nouveau forfait.

Liste des forfaits
Cliquer pour agrandir
Figure 5 : Module Forfaits - Liste de tous les forfaits avec filtres de recherche, colonnes détaillées et options de gestion

Formulaire de Création de Forfait

Le formulaire de création d'un forfait permet de configurer tous les paramètres de l'offre d'accès Internet. Voici le détail complet de chaque champ du formulaire :

ChampTypeRequisDescription
Package NameTexteOuiNom technique du forfait (identifiant interne unique)
ForfaitTexteOuiNom commercial du forfait affiché aux utilisateurs sur le portail captif
PriceNombreOuiPrix du forfait en monnaie locale (ex: FCFA, EUR)
Number of DevicesNombreOuiNombre maximum d'appareils pouvant se connecter simultanément (défaut: 1)
Time Period (minutes)NombreOuiDurée de validité du forfait en minutes (ex: 30, 60, 1440 pour 24h)
Data Quota (MB)NombreOuiVolume de données autorisé en mégaoctets (ex: 1024 = 1 Go)
Upload Rate Limit (Kbps)NombreOuiLimite de débit montant en kilobits par seconde
Download Rate Limit (Kbps)NombreOuiLimite de débit descendant en kilobits par seconde
TypeSélectionOuiCatégorie du forfait : Common, Premium, VIP, etc.
Kick Off PolicySélectionOuiPolitique de déconnexion : No Kick Off, Kick Off on Quota, Kick Off on Time
Bind MAC AddressCase à cocherNonLier le forfait à l'adresse MAC de l'appareil pour empêcher le partage
Bind SSIDCase à cocherNonLier le forfait à un SSID Wi-Fi spécifique
Formulaire de création de forfait
Cliquer pour agrandir
Figure 6 : Formulaire complet de création d'un nouveau forfait avec tous les champs de configuration réseau et tarifaire
Après la création, le forfait apparaît dans la liste et peut être associé à des vouchers ou des comptes utilisateurs. Les forfaits peuvent être modifiés ou supprimés à tout moment.

Gestion des Vouchers

Le module Vouchers permet de générer des bons d'accès (codes) que les utilisateurs saisissent pour se connecter au réseau Wi-Fi. Les vouchers sont liés à un forfait et peuvent être imprimés ou distribués numériquement. La page affiche tous les vouchers avec leur code, forfait associé, statut (actif, utilisé, expiré), date de création et date d'expiration.

Gestion des vouchers
Cliquer pour agrandir
Figure 7 : Module Vouchers - Liste de tous les bons d'accès avec codes, statuts, forfaits associés et filtres de recherche

Formulaire de Création de Vouchers

Le formulaire de création de vouchers permet de générer un ou plusieurs bons d'accès en une seule opération. Il comporte une section principale et des paramètres avancés dépliables.

ChampTypeRequisDescription
QuantityNombreOuiNombre de vouchers à générer en lot (défaut: 1, max: 1000)
ForfaitSélectionOuiForfait à associer aux vouchers (liste déroulante des forfaits créés)
User information settingSection dépliableNonParamètres optionnels : nom, email, téléphone de l'utilisateur
Advance settingSection dépliableNonParamètres avancés : préfixe de code, longueur, date d'expiration
Formulaire de création de vouchers
Cliquer pour agrandir
Figure 8 : Formulaire de création de vouchers avec sélection du forfait, quantité et sections de paramètres avancés
Les sections User information setting et Advance setting sont des accordéons dépliables. Cliquez sur le titre pour afficher les options supplémentaires de personnalisation.

Gestion des Comptes

Le module Comptes permet de créer des comptes utilisateurs nominatifs avec identifiant et mot de passe. Contrairement aux vouchers (codes anonymes), les comptes sont associés à un utilisateur spécifique et peuvent être réutilisés. La page liste tous les comptes avec des filtres de recherche par nom, statut et forfait.

Gestion des comptes
Cliquer pour agrandir
Figure 9 : Module Comptes - Liste de tous les comptes utilisateurs avec filtres de recherche et informations détaillées

Formulaire de Création de Compte

Le formulaire de création de compte permet de définir les identifiants de connexion et les paramètres associés. Des boutons de génération automatique facilitent la création rapide.

ChampTypeRequisDescription
Nom d'utilisateurTexteOuiIdentifiant de connexion unique (avec bouton de génération automatique)
Mot de passePasswordOuiMot de passe de connexion (avec bouton de génération automatique)
ForfaitSélectionOuiForfait à associer au compte (liste déroulante)
ID de profilTexte autoNonIdentifiant de profil rempli automatiquement lors de la sélection du forfait
Activer l'accès VPNCase à cocherNonActiver l'accès VPN pour ce compte utilisateur
CommentaireZone de texteNonNote ou description libre pour identifier le compte
Formulaire de création de compte
Cliquer pour agrandir
Figure 10 : Formulaire complet de création d'un compte utilisateur avec génération automatique et options VPN

Portails Captifs - ISP / TELCO

Captive Portal > ISP / TELCO

Le module Captive Portal permet de personnaliser la page d'accueil que voient les utilisateurs lorsqu'ils se connectent au réseau Wi-Fi. Wiflyx propose des thèmes prédéfinis organisés par secteur d'activité. L'onglet ISP / TELCO propose 10 thèmes conçus pour les fournisseurs d'accès Internet et les opérateurs télécom :

5GUltra
BoxComplete
BusinessConnect
CampusNet
EcoNet
FamilleNet
FiberPro
GamingFiber
MobilePlus
RuralConnect

Chaque thème dispose d'un aperçu en temps réel (Mobile / Desktop) et d'un bouton Créer un Portail. L'aperçu montre la page de connexion avec les options de connexion rapide, de saisie de voucher et la liste des forfaits disponibles.

Thèmes de portails ISP/TELCO
Cliquer pour agrandir
Figure 11 : Captive Portal - Thèmes ISP/TELCO avec aperçu du thème 5GUltra en mode mobile et liste des thèmes disponibles

Thèmes Hotels

L'onglet Hotels propose 13 thèmes conçus pour l'industrie hôtelière, allant du style Art Déco au Zen Wellness. Chaque thème est adapté à un type d'établissement spécifique :

ArtDecoSuites
BoutiqueHotel
BusinessExecutive
EcoSanctuary
FamilyResort
GrandHotel
HistoricManor
MountainLodge
ResortHotel
SeasideRetreat
TechPodHotel
UrbanLoft
ZenWellness
Thèmes de portails Hotels
Cliquer pour agrandir
Figure 12 : Captive Portal - Thèmes Hotels avec aperçu du thème ArtDecoSuites et la galerie des 13 thèmes disponibles

Autres catégories de portails

En plus des catégories ISP/TELCO et Hotels, Wiflyx propose des thèmes pour 6 autres secteurs d'activité accessibles depuis le menu latéral :

CatégorieDescriptionCas d'usage
EntreprisePortails pour les environnements professionnelsBureaux, coworking, salles de réunion
EducationPortails pour les institutions éducativesUniversités, écoles, bibliothèques
AirportsPortails pour les zones de transitAéroports, gares, terminaux
Health CarePortails pour les établissements de santéHôpitaux, cliniques, cabinets
Coffee ShopPortails pour la restaurationCafés, restaurants, bars
Shopping MallsPortails pour le commerceCentres commerciaux, galeries

Bannières Publicitaires

Wiflyx Flash Ad > Advertising Banners

Le module Advertising Banners permet de créer et gérer des bannières publicitaires qui s'affichent sur le portail captif. Les bannières peuvent être des images, des vidéos ou des contenus HTML personnalisés. Elles sont affichées aux utilisateurs avant ou pendant leur session de navigation.

Les bannières publicitaires sont un moyen de monétiser le réseau Wi-Fi en affichant des publicités aux utilisateurs. Elles peuvent être configurées par groupe et par période.

Ruban Module

Le Ruban Module permet d'afficher un bandeau défilant (ticker) sur le portail captif avec des messages promotionnels, des annonces ou des informations importantes. Le ruban est configurable en termes de contenu, couleur, vitesse de défilement et position.

Moyens de Paiement

Wiflyx Pay > Payment Methods

Le module Moyens de paiement permet de configurer les passerelles de paiement pour la monétisation de l'accès Wi-Fi. La page affiche des cartes de statistiques en haut : total des méthodes configurées, méthodes actives et cartes de crédit. La passerelle CinetPay est disponible pour accepter les paiements par mobile money et carte bancaire en Afrique.

Moyens de paiement
Cliquer pour agrandir
Figure 13 : Wiflyx Pay - Page de gestion des moyens de paiement avec statistiques et passerelle CinetPay

Configuration CinetPay

Le formulaire de configuration CinetPay permet de connecter votre compte marchand CinetPay à Wiflyx pour accepter les paiements en ligne. Tous les champs sont obligatoires pour activer la passerelle.

ChampTypeRequisDescription
Clé APIPasswordOuiClé API fournie par CinetPay dans votre espace marchand
Site IDTexteOuiIdentifiant unique de votre site CinetPay
Secret KeyPasswordOuiClé secrète pour la vérification et la sécurisation des transactions
Point de terminaison APIURLOuiURL de l'API CinetPay (défaut: https://api-checkout.cinetpay.com/v2/payment)
Configuration CinetPay
Cliquer pour agrandir
Figure 14 : Formulaire de configuration de la passerelle CinetPay avec les champs API, Site ID et Secret Key
Les clés API et Secret Key sont des informations sensibles. Obtenez-les depuis votre espace marchand CinetPay et ne les partagez jamais. Le bouton Enregistrer sauvegarde la configuration et active la passerelle.

Historique des Transactions

La page Transactions affiche l'historique complet de toutes les transactions de paiement. Elle comporte des cartes de statistiques en haut (Total, Terminé, En attente, Échoué, Remboursé) et un tableau détaillé avec filtres de recherche et options d'export.

ChampTypeRequisDescription
ID de transactionTexteNonIdentifiant unique généré automatiquement pour chaque transaction
ClientTexteNonNom ou identifiant du client ayant effectué le paiement
AmountNombreNonMontant de la transaction dans la devise configurée
MethodTexteNonMéthode de paiement utilisée (CinetPay, Mobile Money, etc.)
StatutBadge coloréNonÉtat : Terminé (vert), En attente (jaune), Échoué (rouge), Remboursé (bleu)
DateDate/HeureNonDate et heure exactes de la transaction
ActionsBoutonsNonVoir détails, rembourser, exporter le reçu
Historique des transactions
Cliquer pour agrandir
Figure 15 : Wiflyx Pay - Historique des transactions avec cartes de statistiques, filtres et tableau détaillé

Gestion des Groupes

Administration > Groupes

Le module Groupes permet d'organiser les ressources (appareils, forfaits, vouchers, comptes) en groupes logiques. Chaque groupe peut avoir ses propres paramètres de configuration, ses propres forfaits et ses propres portails captifs. Cela permet de gérer plusieurs sites ou bâtiments depuis une seule interface.

Le sélecteur de groupe est accessible depuis la barre d'en-tête en haut de l'application. Il affiche le groupe actuellement sélectionné et permet de basculer entre les différents groupes.

Gestion des Utilisateurs

Le module Gestion des utilisateurs permet d'administrer les comptes des opérateurs et administrateurs de la plateforme Wiflyx. Il permet de créer des utilisateurs avec différents niveaux d'accès (administrateur, opérateur, lecteur) et de leur attribuer des groupes spécifiques.

Paramètres Généraux

Paramètres > Général

Les paramètres généraux permettent de configurer l'apparence et le comportement global de l'application. L'onglet Général comprend les options de personnalisation visuelle et les limites système.

ChampTypeRequisDescription
Max File Upload Size (MB)NombreNonTaille maximale des fichiers uploadés en mégaoctets (défaut: 10 MB)
Primary ColorSélecteur couleurNonCouleur primaire du dégradé de l'interface (avec aperçu en temps réel)
Secondary ColorSélecteur couleurNonCouleur secondaire du dégradé de l'interface
Title Background ColorSélecteur couleurNonCouleur de fond des titres de sections du menu latéral
Gradient DirectionSélectionNonDirection du dégradé : Left to Right, Top to Bottom, Diagonal, etc.
Gradient BlendCurseur (0-100%)NonContrôle du mélange des couleurs (0% = transition nette, 100% = transition douce)
Paramètres généraux
Cliquer pour agrandir
Figure 16 : Paramètres du système - Onglet Général avec les sélecteurs de couleurs, direction du dégradé et aperçu en temps réel

Paramètres Email

L'onglet Email permet de configurer les paramètres d'envoi d'emails (SMTP) pour chaque groupe. Il est nécessaire de sélectionner un groupe avant de pouvoir configurer les paramètres. Les emails sont utilisés pour envoyer des notifications, des confirmations de compte et des rapports.

Paramètres Email
Cliquer pour agrandir
Figure 17 : Paramètres du système - Onglet Email avec sélection du groupe, configuration SMTP et bouton Test Email
Le bouton Test Email permet d'envoyer un email de test pour vérifier la configuration SMTP avant de l'enregistrer.

Paramètres d'Impression

L'onglet Paramètres d'Impression permet de configurer le format, le contenu et la mise en page des impressions de vouchers. Comme pour les paramètres email, il faut d'abord sélectionner un groupe. Les paramètres incluent le format du papier, les marges, le logo, les informations à afficher et le nombre de vouchers par page.

Paramètres d'Impression
Cliquer pour agrandir
Figure 18 : Paramètres du système - Onglet Paramètres d'Impression avec configuration du format et bouton Test d'Impression
Le bouton Test d'Impression génère un aperçu de l'impression pour vérifier la mise en page avant d'imprimer les vouchers réels.

Documentation Technique Wiflyx

Version 1.0 - Mars 2026 - Wiflyx Technologies

Cette documentation couvre l'ensemble des modules et fonctionnalités de la plateforme Wiflyx.