Manuel AvoloPay

Qu'est-ce qu'AvoloPay ?

AvoloPay est une plateforme de gestion d'abonnements numériques (Netflix, Spotify, Amazon Prime, etc.) conçue pour les revendeurs. Elle centralise la gestion des clients, des paiements, des notifications et génère des rapports financiers détaillés.

Installation & Déploiement

AvoloPay fonctionne sur tout hébergement PHP 8+ avec MySQL. Les migrations de base de données sont automatiques au premier lancement.

Configuration de l'application

Fichier basedata.php

$host = "localhost";
$dbname = "votre_base";
$user = "votre_user";
$password = "votre_mdp";

Paramètres des plateformes

Les paramètres de chaque plateforme (nombre de profils, tarifs) sont gérés depuis Gestion → Plateformes → Paramètres. Aucune modification de code n'est nécessaire.

Gestion des Clients

L'annuaire client centralisé permet de retrouver tout client existant lors de l'inscription d'un nouveau, même s'il est sur une autre plateforme ou archivé.

Ajouter un client

Actions disponibles sur un client

Gestion des Abonnements

Statuts d'abonnement

Renouvellement

Pour renouveler un abonnement, cliquez sur le bouton d'un client. Deux options :

• À partir d'aujourd'hui — nouvelle date de début = aujourd'hui
• À partir de la date de fin — prolongement sans chevauchement

Migration entre Plateformes

La migration permet de transférer un client d'une plateforme (ex: Netflix) vers une autre (ex: Spotify) en conservant son historique.

Gestion des Plateformes

Depuis Gestion → Plateformes, vous pouvez ajouter, modifier ou désactiver des plateformes. Chaque plateforme possède ses propres tables de comptes, profils et abonnements.

Ajouter une nouvelle plateforme

1. Aller dans Gestion → Plateformes → Ajouter
2. Saisir le nom (ex: disney)
3. Le système crée automatiquement les tables (disney_account, disney_profil, disney_sub)
4. Configurer les tarifs et le nombre de profils par compte

Abonnements MIX

Un abonnement MIX est automatiquement détecté quand un client est inscrit sur 2 plateformes ou plus simultanément. Un tarif MIX spécial peut être configuré.

Identifier les clients MIX

Depuis le Dashboard → Finances → onglet MIX, vous voyez la liste de tous les clients multi-plateformes avec leurs abonnements actifs.

Comptes & Profils

Chaque plateforme possède des comptes maîtres (email + mot de passe de connexion) et des profils (sous-comptes pour chaque client).

Structure

Compte maître (id: 1)
  └─ Profil A (abn_id: 1_1) → Client Alice
  └─ Profil B (abn_id: 1_2) → Client Bob
  └─ Profil C (abn_id: 1_3) → [libre]
  └─ Profil D (abn_id: 1_4) → Client Carol
  └─ Profil E (abn_id: 1_5) → [libre]

Statuts des comptes

Tableau de Bord

Le dashboard affiche les KPIs en temps réel, les alertes importantes et les graphiques de performance.

Notifications Dashboard

Les alertes se rafraîchissent automatiquement toutes les 60 secondes et affichent :

• 🔴 Critique — abonnements expirés depuis plus de 7 jours
• 🟡 Avertissement — abonnements expirant dans 5 jours
• 🔵 Info — demandes clients, invitations en attente

Dashboard Financier

Accessible depuis Gestion → Finances, ce module affiche une analyse complète de vos revenus.

Outil de Simulation

Ajustez deux paramètres pour voir l'impact sur vos revenus :

• Multiplicateur de comptes — Si vous aviez 2x plus de comptes
• Taux de remplissage — Pourcentage de profils occupés

Système de Notifications

AvoloPay dispose de deux types de notifications :

1. Notifications Dashboard (temps réel)

Visibles directement dans l'interface, générées par l'API dashboard_alerts.php. Elles sont marquées lues automatiquement au clic.

2. Notifications WhatsApp (automatiques)

Envoyées via les cron jobs configurés sur cPanel :

Gestion des Utilisateurs

Les utilisateurs sont les membres de votre équipe qui ont accès à la gestion. Chaque compte a des permissions granulaires.

Niveaux d'accès

Permissions supplémentaires

• whatsapp_access — Reçoit les notifications WhatsApp automatiques
• can_delete — Peut supprimer des clients
• can_manage_accounts — Peut modifier les comptes plateforme

Système d'Invitations

Pour ajouter un nouveau manager, envoyez-lui une clé d'invitation par WhatsApp. Cette clé est à usage unique et expire après utilisation.

Intégration WhatsApp

AvoloPay envoie automatiquement des messages WhatsApp aux clients et aux membres de l'équipe. Chaque message est personnalisable depuis Paramètres → Messages.

Types de messages

Configuration des Cron Jobs

Les cron jobs sont des tâches planifiées exécutées automatiquement par votre hébergeur. Configurez-les depuis cPanel → Cron Jobs.

Commandes à configurer

Cron quotidien à 6h00 — Mise à jour des expirations :

0 6 * * * /usr/bin/php /home/VOTRE_USER/public_html/cron/cron_expiration.php

Cron quotidien à 9h00 — Notifications WhatsApp :

0 9 * * * /usr/bin/php /home/VOTRE_USER/public_html/cron/cron_notifications.php

Référence API

Toutes les APIs sont accessibles via le chemin comand/[nom].php grâce aux règles de réécriture .htaccess.

Structure Base de Données

Les tables clés du système :