🔷 PFV - Système Pyramidal v2.0

📋 Vue d'ensemble

Application web progressive (PWA) pour la gestion d'un système pyramidal avec :

• Codes uniques hiérarchiques : Cercle → Famille → Individu
• Intégration Google Drive pour sauvegarde automatique
• Système de paiements complet et transparent
• Mode hors ligne avec IndexedDB

---

🎯 Système de codes pyramidaux

Structure hiérarchique

Cercle:     C-001
  ├─ Famille:    C-001-F-01
  │    ├─ Individu: C-001-F-01-I-01
  │    ├─ Individu: C-001-F-01-I-02
  │    └─ Individu: C-001-F-01-I-03
  │
  └─ Famille:    C-001-F-02
       ├─ Individu: C-001-F-02-I-01
       └─ Individu: C-001-F-02-I-02

Format des codes

Niveau	Format	Exemple	Description
Cercle	C-XXX	C-001	3 chiffres (001-999)
Famille	C-XXX-F-YY	C-001-F-01	Cercle + 2 chiffres (01-99)
Individu	C-XXX-F-YY-I-ZZ	C-001-F-01-I-01	Famille + 2 chiffres (01-99)

Limites du système

• 999 cercles maximum
• 99 familles par cercle
• 99 individus par famille

---

💰 Système de paiements

Types de transactions

1. Paiements individuels : Transactions avec un individu spécifique
2. Paiements familiaux : Transactions avec une famille entière
3. Paiements par cercle : Transactions avec un cercle complet

Sens des paiements

• Reçu : De l'entité vers PFV (⬅️)
• Versé : De PFV vers l'entité (➡️)

Modes de paiement supportés

• 💵 Espèces
• 📱 Mobile Money
• 🏦 Virement bancaire
• 📝 Chèque

Statuts

• 🟡 En attente : À valider
• 🟢 Validé : Approuvé
• 🔴 Rejeté : Refusé

---

🚀 Installation et déploiement

1. Configuration Google Drive

Pour activer l'intégration Drive :

1. Allez sur https://console.cloud.google.com
2. Créez un nouveau projet "PFV"
3. Activez l'API Google Drive
4. Créez des identifiants OAuth 2.0:
   • Type: Application Web
   • URL autorisées: Votre domaine GitHub Pages
5. Copiez le Client ID et l'API Key
6. Modifiez js/config.js:

   drive: {
       clientId: 'VOTRE_CLIENT_ID.apps.googleusercontent.com',
       apiKey: 'VOTRE_API_KEY'
   }

2. Déploiement sur GitHub Pages

# 1. Créer un dépôt sur GitHub
git init
git add .
git commit -m "Initial commit PFV v2.0"
git branch -M main
git remote add origin https://github.com/VOTRE_NOM/pfv-pwa.git
git push -u origin main

# 2. Activer GitHub Pages
# Settings → Pages → Source: main branch

3. Installation sur Android

1. Ouvrez Chrome sur Android
2. Allez sur votre URL GitHub Pages
3. Menu → "Installer l'application"
4. ✅ Terminé !

---

📁 Structure du projet

pfv-revised/
├── index.html              # Interface principale
├── manifest.json           # Configuration PWA
├── sw.js                   # Service Worker
├── css/
│   └── styles.css         # Design moderne Google-style
├── js/
│   ├── config.js          # Configuration et utilitaires
│   ├── codes.js           # Système de codes pyramidaux
│   ├── db.js              # Base de données IndexedDB
│   ├── drive.js           # Intégration Google Drive
│   └── app.js             # Application principale
└── assets/
    ├── icon-192.png       # Icône PWA 192x192
    └── icon-512.png       # Icône PWA 512x512

---

🎓 Guide d'utilisation

Créer un cercle

1. Onglet Cercles → ➕ Nouveau cercle
2. Entrez le code (ex: C-001)
3. Renseignez le nom, la localité, le principe
4. Validez

Créer une famille

1. Onglet Familles → ➕ Nouvelle famille
2. Sélectionnez le cercle parent
3. Le code est généré automatiquement
4. Renseignez les informations
5. Validez

Créer un individu

1. Onglet Individus → ➕ Nouvel individu
2. Sélectionnez la famille parente
3. Le code est généré automatiquement
4. Renseignez nom, téléphone, email, rôle
5. Validez

Enregistrer un paiement

1. Onglet Paiements → ➕ Nouveau paiement
2. Choisissez le type (individu/famille/cercle)
3. Sélectionnez le bénéficiaire
4. Entrez le montant
5. Choisissez le sens (reçu/versé)
6. Sélectionnez le mode de paiement
7. Validez

Sauvegarde sur Drive

• Automatique : Toutes les 30 minutes si connecté
• Manuelle : Bouton "Connecter Drive" dans l'en-tête

---

📊 Exports disponibles

L'application permet d'exporter les données en plusieurs formats :

• JSON : Sauvegarde complète (via Drive)
• CSV : Export des cercles, familles, individus, paiements
• Visualisation : Arbre pyramidal dans le dashboard

---

🔒 Sécurité et confidentialité

Stockage local

• Toutes les données sont dans IndexedDB (navigateur)
• Aucune donnée envoyée vers un serveur externe
• Effacement possible à tout moment

Google Drive (optionnel)

• Nécessite autorisation explicite
• Données stockées dans votre Drive personnel
• Vous gardez le contrôle total

Validation des données

• Codes uniques obligatoires
• Téléphones uniques pour les individus
• Vérification de la hiérarchie

---

🛠️ Maintenance et mises à jour

Mise à jour du code

git pull origin main
git add .
git commit -m "Description des modifications"
git push origin main

GitHub Pages se met à jour automatiquement (2-5 min).

Vider le cache

Dans Chrome:

1. F12 → Application → Storage
2. Clear site data

Ou dans le code :

caches.keys().then(keys => 
    keys.forEach(key => caches.delete(key))
)

---

📈 Statistiques et rapports

Le dashboard affiche :

• Nombre total de cercles
• Nombre total de familles
• Nombre total d'individus
• Total des paiements reçus
• Total des paiements versés
• Solde actuel
• Arbre pyramidal complet

---

⚡ Performance

Optimisations

• Chargement rapide (< 2s)
• Mode hors ligne complet
• IndexedDB pour données locales
• CSS moderne sans frameworks lourds
• JavaScript vanilla (pas de dépendances)

Compatibilité

• ✅ Chrome Android (recommandé)
• ✅ Chrome Desktop
• ✅ Edge
• ⚠️ Firefox (PWA limité)
• ⚠️ Safari (PWA limité)

---

🐛 Résolution de problèmes

L'application ne s'installe pas

• Vérifiez que vous êtes en HTTPS
• Vérifiez le manifest.json
• Créez les icônes manquantes

Google Drive ne se connecte pas

• Vérifiez le Client ID et API Key
• Vérifiez les URLs autorisées dans Google Console
• Testez en navigation privée

Les données ne se sauvegardent pas

• Vérifiez la console (F12)
• Testez IndexedDB : indexedDB.databases()
• Effacez le cache et rechargez

Le Service Worker ne fonctionne pas

navigator.serviceWorker.getRegistrations()
    .then(regs => regs.forEach(reg => reg.unregister()))

---

📞 Support

Pour toute question :

1. Vérifiez ce README
2. Consultez la console (F12)
3. Créez une Issue sur GitHub

---

🎯 Fonctionnalités clés

✅ Codes pyramidaux uniques (3 niveaux)
✅ Gestion complète (CRUD)
✅ Paiements bidirectionnels (reçu/versé)
✅ Google Drive (sauvegarde auto)
✅ Mode hors ligne (PWA)
✅ Design moderne (Google Material)
✅ Responsive (mobile-first)
✅ Exports (JSON/CSV)
✅ Tableau de bord visuel
✅ Validation des données

---

🏁 Prochaines étapes

1. ✅ Générer les icônes (192x192 et 512x512)
2. ✅ Configurer Google Drive
3. ✅ Tester en local
4. ✅ Déployer sur GitHub
5. ✅ Installer sur Android

---

Version: 2.0
Auteur: Fondateur PFV
Licence: Propriétaire
Date: 2025

🌟 Système simplifié, performant et professionnel ! 🌟