📚 Documentation Kazalendar

Index complet de la documentation pour Kazalendar - Application de gestion intelligente pour artisans

---

🚀 Démarrage rapide

Nouveau sur Kazalendar ? Commencez ici :

1. 📖 README principal - Vue d'ensemble du projet
2. 🔧 Guide d'installation - Installer et configurer
3. 🏗️ Architecture - Comprendre la structure
4. 💡 Fonctionnalités complètes - Découvrir toutes les features

---

📂 Documentation par thème

🔧 Configuration

Configuration des services externes et de l'environnement :

Document	Description
Configuration Supabase	Base de données, auth, storage
Configuration Stripe	Paiements par carte
Configuration FCM v1	Notifications push Firebase
Configuration Premium	Abonnements Google Play / App Store
Agent IA	Backend Agent IA et WhatsApp
Configuration Webhook	Webhooks Stripe
Icônes d'application	Icônes app
Nom de l'application	Changer le nom
Réseaux sociaux	Configuration réseaux sociaux
Support Database	Table support_tickets
Onboarding Database	Tables onboarding

---

💡 Fonctionnalités

Documentation détaillée de chaque fonctionnalité :

📅 Calendrier et Commandes

Document	Description
Gestion du calendrier	Vue calendrier et navigation
Détails de commande	Page de détails complète
Page complète commande	Vue détaillée
Ajout prix commandes	Gestion des prix
Refresh commandes	Actualisation
Configuration horaires	Horaires de travail
Vue jour complet	Jours complets

👥 Clients

Document	Description
Gestion des clients	CRUD clients complet
Navigation clients	Navigation

💳 Paiements et Stripe

Guides principaux :

Document	Description
Configuration Stripe	Configuration de base
Résumé système de paiement	⭐ Vue d'ensemble complète
Test complet paiement	Scénarios de test
Workflow Acomptes	Gestion des acomptes
Quick Start Acomptes	Guide rapide acomptes
Historique paiements	Transactions

Stripe Connect :

Document	Description
README Stripe Connect	Multi-vendeurs
Migration Stripe Connect	Migration
Webhook Stripe Connect	Webhooks
Commissions	Gestion commissions

Configuration avancée :

Document	Description
Configuration Webhook	Webhooks
Configuration URLs	URLs de paiement
Navigateur interne	WebView
Validation mobile	Mobile
Notifications paiement	Notifications

Flows de paiement :

Document	Description
Paiement par carte	Carte bancaire
Flow intégré v1	Version 1
Flow intégré v2	Version 2

Debug et dépannage :

Document	Description
Debug Stripe	Débogage
Description système	Architecture

🤖 Agent IA Conversationnel

Document	Description
Guide d'activation Agent IA	⭐ Configuration complète
Documentation technique	Détails techniques
Debug WhatsApp	Résolution problèmes

📤 Partage de calendrier

Document	Description
Partage de calendrier	Export en image avec thèmes

💎 Système Premium

Document	Description
Configuration Premium	⭐ Guide principal
Mode test Premium	Tests
Diagnostic Premium	Débogage
Résolution Premium	Corrections
Codes promotionnels	Codes promo

🎨 Design et Interface

Document	Description
Design général	Design system
Design linéaire	Vue linéaire
Cartes floating	Cartes visibles
Système modal	Modales
Design System complet	⭐ Composants UI, spacing, tokens
Améliorations UX/UI	Quick wins implémentés

🚀 Onboarding et Support

Document	Description
Onboarding	Flow d'accueil utilisateur
Support	Système de tickets
Force Update	Mise à jour forcée

💰 Business et Pricing

Document	Description
Stratégie Marketing	Plan marketing complet avec calendrier
Scripts Instagram	Tous les scripts de Reels et posts
Analyse Pricing	Stratégie de prix
Actions Pricing	Implémentation technique
Tracking Coûts IA	Suivi des coûts API

---

🛠️ Guides de développement

Guide	Description
Installation complète	Guide d'installation détaillé
Architecture	Structure du projet et patterns
Workflow de développement	Bonnes pratiques
Déploiement	Play Store / App Store
Tests manuels Agent IA	Guide de tests

---

🐛 Résolution de problèmes

Document	Description
Diagnostic rapide	⭐ Commencer ici
Debug webhook paiement	Webhooks
Debug notifications	Notifications
Résolution compilation	Build errors
Résolution finale compilation	Compilation
Résolution customer name	Customer name
Résolution expires_at	Expires at
Résolution finale	Finale
Résolution sérialisation	Serialization
Résolution webhook	Webhook

---

📋 Guides par cas d'usage

🎯 Je veux...

... installer le projet pour la première fois

1. 📖 README principal
2. 🔧 Guide d'installation
3. 🗄️ Configuration Supabase
4. 💳 Configuration Stripe
5. 🔔 Configuration FCM

... configurer les paiements

1. 💳 Configuration Stripe
2. 💰 Résumé système de paiement ⭐
3. 🔗 Stripe Connect
4. 📝 Quick Start Acomptes
5. 🧪 Tester les paiements

... activer les abonnements Premium

1. 💎 Configuration Premium ⭐
2. 🎟️ Codes promotionnels
3. 🧪 Mode test

... activer l'Agent IA WhatsApp

1. 🤖 Guide d'activation Agent IA ⭐
2. 📖 Documentation technique
3. 🐛 Debug WhatsApp

... déployer en production

1. 📦 Guide de déploiement
2. 🔐 Vérifier les variables d'environnement (.env)
3. 🧪 Tester le système complet
4. ✅ Checklist de déploiement

... résoudre un problème

1. 🔍 Diagnostic rapide ⭐
2. 🐛 Documentation troubleshooting
3. 📖 Documentation de la fonctionnalité concernée
4. 📝 Consulter les logs : flutter logs ou adb logcat

---

🏗️ Architecture du projet

kazacalendar_mobile/
├── lib/
│   ├── core/                           # Composants partagés
│   │   ├── config/                    # Supabase, Stripe, Agent IA
│   │   ├── services/                  # Notifications, FCM
│   │   ├── theme/                     # Thème de l'app
│   │   └── widgets/                   # Widgets réutilisables
│   │
│   ├── features/                       # Features (Clean Architecture)
│   │   ├── calendar/                  # 📅 Calendrier et commandes
│   │   ├── clients/                   # 👥 Gestion clients
│   │   ├── auth/                      # 🔐 Authentification
│   │   ├── settings/                  # ⚙️ Paramètres
│   │   ├── payment/                   # 💳 Paiements
│   │   ├── stripe_connect/            # 🔗 Stripe Connect
│   │   ├── share_calendar/            # 📤 Partage
│   │   ├── text_analysis/             # 📝 Analyse IA
│   │   ├── agent_ia/                  # 🤖 Agent IA
│   │   ├── premium/                   # 💎 Premium
│   │   └── promo_code/                # 🎟️ Codes promo
│   │
│   ├── firebase_options.dart          # Config Firebase
│   └── main.dart                       # Point d'entrée
│
├── android/                            # Projet Android natif
├── ios/                                # Projet iOS natif
├── supabase/                           # Migrations SQL
│   ├── migrations/                    # Scripts SQL
│   └── functions/                     # Edge Functions
│
├── docs/                               # 📚 Documentation
│   ├── configuration/                 # Configuration
│   ├── premium/                       # Premium
│   ├── payment/                       # Paiements
│   ├── features/                      # Fonctionnalités
│   ├── troubleshooting/               # Dépannage
│   └── guides/                        # Guides dev
│
├── scripts/                            # Scripts utilitaires
│   ├── deploy_webhook.sh              # Déploiement webhooks
│   ├── test_webhook.sh                # Tests webhooks
│   └── test_stripe_mobile_validation.sh
│
├── assets/                             # Images et ressources
├── .env                                # Variables d'environnement
├── pubspec.yaml                        # Dépendances Flutter
└── README.md                           # Documentation principale

➡️ Architecture détaillée

---

🛠️ Technologies utilisées

Frontend

• Flutter 3.3.0+ - Framework mobile cross-platform
• Dart 3.3.0+ - Langage de programmation
• Material Design 3 - Design system

Backend / BaaS

• Supabase - Backend as a Service
  • PostgreSQL Database
  • Authentication
  • Storage
  • Real-time subscriptions
  • Edge Functions (webhooks)

Paiements

• Stripe - Paiements par carte pour commandes
• Stripe Connect - Multi-vendeurs
• Google Play Billing - Abonnements Android
• Apple StoreKit - Abonnements iOS

IA et Automatisation

• API Agent IA (Node.js/Express externe)
• WhatsApp Business API
• Meta API (Instagram - en préparation)

Notifications

• Firebase Cloud Messaging (FCM)
• Flutter Local Notifications

➡️ Stack technique complet

---

📱 Fonctionnalités disponibles

✅ Fonctionnalités principales

• 📅 Calendrier intelligent avec gestion des disponibilités
• 📋 Gestion des commandes avec statuts multiples
• 👥 Base de données clients complète
• 💳 Paiements intégrés via Stripe (acomptes, liens de paiement)
• 🤖 Agent IA conversationnel WhatsApp (extraction automatique)
• 📝 Analyse de texte automatique
• 📤 Partage de calendrier avec thèmes personnalisables
• 💎 Système Premium avec abonnements (10 features)
• 🎟️ Codes promotionnels
• 🔔 Notifications push Firebase

➡️ Liste complète avec détails

---

💎 Premium vs Gratuit

🆓 Version Gratuite

• ✅ 5 commandes/mois maximum
• ✅ Clients illimités
• ✅ 1 template de calendrier
• ✅ Gestion manuelle des commandes
• ⚠️ Filigrane sur exports de calendrier
• ❌ Agent IA désactivé
• ❌ Paiements en ligne limités

💎 Version Premium (9,99€/mois ou 99€/an)

• ✅ Commandes illimitées
• ✅ Export sans filigrane
• ✅ Agent IA conversationnel (WhatsApp)
• ✅ Paiements en ligne intégrés (Stripe)
• ✅ Templates personnalisés
• ✅ Couleurs de marque
• ✅ Limiteur de capacité avancé
• ✅ Lien de réservation partageable
• ✅ Rappels automatisés
• ✅ Support prioritaire

➡️ Détails des fonctionnalités Premium

---

🔐 Sécurité

Variables d'environnement

Fichier .env (ne jamais committer !)

# Stripe
STRIPE_SECRET_KEY=sk_test_xxxxxxxxxxxxx
STRIPE_PUBLISHABLE_KEY=pk_test_xxxxxxxxxxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxx
STRIPE_TEST_MODE=true

# Supabase
SUPABASE_URL=https://xxxxx.supabase.co
SUPABASE_ANON_KEY=eyJxxxxxxxxxxxxxx
SUPABASE_SERVICE_ROLE_KEY=eyJxxxxxxxxxxxxxx

# Agent IA (optionnel)
AGENT_API_URL=http://localhost:3000

Bonnes pratiques de sécurité

• ❌ Ne jamais committer les clés API dans Git
• ✅ Utiliser .env pour tous les secrets
• ✅ .gitignore configuré correctement
• ✅ Row Level Security (RLS) activé sur toutes les tables Supabase
• ✅ Validation webhook Stripe avec signature
• ✅ HTTPS uniquement en production

---

📞 Support et ressources

Documentation

• 📚 Documentation complète (vous êtes ici)
• 🔧 Résolution de problèmes
• 💡 Guides de configuration
• 📖 Guides de fonctionnalités

En cas de problème

1. ✅ Consultez le Diagnostic rapide
2. ✅ Vérifiez les logs : flutter logs ou adb logcat
3. ✅ Testez avec les scripts dans /scripts
4. ✅ Consultez la documentation Stripe/Supabase

Ressources externes

• Documentation Flutter
• Documentation Dart
• Documentation Supabase
• Documentation Stripe
• Documentation Firebase
• Flutter Codelabs

---

🗺️ Roadmap de lecture recommandée

Pour un nouveau développeur

Jour 1 - Installation et setup

1. README principal
2. Guide d'installation
3. Configuration Supabase
4. Architecture

Jour 2 - Comprendre le code

1. Architecture détaillée
2. Fonctionnalités principales
3. Gestion des clients

Jour 3 - Paiements

1. Configuration Stripe
2. Résumé système de paiement ⭐
3. Quick Start Acomptes
4. Tester les paiements

Jour 4 - Features avancées

1. Agent IA
2. Système Premium
3. Partage de calendrier

Jour 5 - Production

1. Workflow de développement
2. Déploiement
3. Diagnostic rapide

---

📝 Contribuer à la documentation

La documentation est un projet vivant. Pour contribuer :

1. ✏️ Identifiez un manque ou une amélioration
2. 📄 Créez/modifiez le fichier markdown correspondant
3. 🔗 Mettez à jour cet index si nécessaire
4. 🚀 Ouvrez une Pull Request

Conventions d'écriture :

• Utilisez des emojis pour les sections principales (📅 🤖 💳 💎 etc.)
• Gardez un ton clair, pédagogique et professionnel
• Ajoutez des exemples de code formatés
• Incluez des liens vers la documentation officielle
• Indiquez les documents principaux avec ⭐

---

Documentation Kazalendar - Application de gestion intelligente pour artisans

Retour au README principal • Installation • Support

---

Made with ❤️ for artisans and entrepreneurs

---

Dernière mise à jour : 2025-11-22