Files
TravelMateAdmin/INDEX.md
Van Leemput Dayron f9690045ea feat: Implement Database Service and ViewModels for Messages and Support Requests
- Added DatabaseService to handle database operations for messages and support requests.
- Created IDatabaseService interface to define the contract for database operations.
- Developed ViewModels for Dashboard, Messages, and Support pages to manage data and commands.
- Implemented XAML views for Dashboard, Messages, and Support, including data binding and UI elements.
- Created SQL script for setting up the database schema and inserting test data.
2026-01-12 18:04:10 +01:00

233 lines
8.1 KiB
Markdown

# 📚 Index de Documentation - TravelMate Admin
Guide complet pour naviguer dans la documentation du projet.
---
## 🚀 Pour Commencer
**Nouveau sur le projet ? Commencez ici :**
1. 📖 [README.md](README.md) - **Lisez-moi d'abord** - Vue d'ensemble du projet
2. ⚡ [QUICKSTART.md](QUICKSTART.md) - Installation en 5 minutes
3. 🎉 Lancez l'application !
---
## 📂 Documentation par CatĂ©gorie
### đŸ—ïž Architecture & DĂ©veloppement
| Fichier | Description | Quand le consulter |
|---------|-------------|-------------------|
| [ARCHITECTURE.md](ARCHITECTURE.md) | Architecture MVVM détaillée, flux de données, patterns | Comprendre la structure du code |
| [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md) | Résumé complet, fichiers créés, checklist | Vue d'ensemble technique |
| [CHANGELOG.md](CHANGELOG.md) | Historique des versions et modifications | Voir les changements apportés |
### ⚙ Configuration & Installation
| Fichier | Description | Quand le consulter |
|---------|-------------|-------------------|
| [QUICKSTART.md](QUICKSTART.md) | Guide rapide d'installation (5 min) | PremiĂšre installation |
| [CONFIGURATION.md](CONFIGURATION.md) | Configuration de la base de données | ProblÚmes de connexion DB |
| [README.md](README.md) | Guide complet avec tous les détails | Documentation générale |
### đŸ’» DĂ©veloppement & Maintenance
| Fichier | Description | Quand le consulter |
|---------|-------------|-------------------|
| [COMMANDS.md](COMMANDS.md) | Commandes utiles (build, DB, debug) | Tùches de développement |
| [SQL_REFERENCE.md](SQL_REFERENCE.md) | RequĂȘtes SQL complĂštes | GĂ©rer la base de donnĂ©es |
### 📊 Base de DonnĂ©es
| Fichier | Description | Quand le consulter |
|---------|-------------|-------------------|
| [database_setup.sql](database_setup.sql) | Script SQL de création + données test | Initialiser la DB |
| [SQL_REFERENCE.md](SQL_REFERENCE.md) | Guide complet des requĂȘtes SQL | OpĂ©rations sur les donnĂ©es |
---
## 🎯 Guides par ScĂ©nario
### Scénario 1 : Je veux installer l'app rapidement
1. [QUICKSTART.md](QUICKSTART.md) - Suivez les 5 étapes
2. [database_setup.sql](database_setup.sql) - Exécutez ce script
3. Modifiez `TravelMateAdmin/Configuration/AppSettings.cs`
4. Lancez l'app !
### Scénario 2 : J'ai des problÚmes de connexion DB
1. [CONFIGURATION.md](CONFIGURATION.md) - Guide de dépannage
2. Vérifiez `AppSettings.cs`
3. [COMMANDS.md](COMMANDS.md) - Commandes de test MySQL
### Scénario 3 : Je veux comprendre le code
1. [ARCHITECTURE.md](ARCHITECTURE.md) - Pattern MVVM expliqué
2. [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md) - Structure des fichiers
3. Lisez les commentaires dans le code source
### Scénario 4 : Je veux ajouter une fonctionnalité
1. [ARCHITECTURE.md](ARCHITECTURE.md) - Section "Extensibilité"
2. [COMMANDS.md](COMMANDS.md) - Commandes de build/test
3. Suivez le pattern existant (Models → Services → ViewModels → Views)
### Scénario 5 : Je veux gérer les données
1. [SQL_REFERENCE.md](SQL_REFERENCE.md) - Toutes les requĂȘtes SQL
2. [COMMANDS.md](COMMANDS.md) - Section "Base de Données"
### Scénario 6 : Je veux personnaliser l'UI
1. [README.md](README.md) - Section "Personnalisation"
2. Modifiez les couleurs dans les fichiers XAML
3. Consultez les Views existantes comme exemples
---
## 📖 Structure de la Documentation
```
Documentation/
├── README.md ⭐ Point d'entrĂ©e principal
├── QUICKSTART.md 🚀 Installation rapide
├── ARCHITECTURE.md đŸ—ïž Architecture technique
├── CONFIGURATION.md ⚙ Configuration DB
├── COMMANDS.md đŸ’» Commandes de dev
├── SQL_REFERENCE.md 📊 RĂ©fĂ©rence SQL
├── PROJECT_SUMMARY.md 📝 RĂ©sumĂ© complet
├── CHANGELOG.md 📅 Historique des versions
└── INDEX.md 📚 Ce fichier
Code Source/
├── TravelMateAdmin/
│ ├── Models/ 📩 ModĂšles de donnĂ©es
│ ├── Services/ 🔧 Couche d'accĂšs aux donnĂ©es
│ ├── ViewModels/ 🎭 Logique de prĂ©sentation
│ ├── Views/ 🎹 Interface utilisateur
│ ├── Converters/ 🔄 Converters XAML
│ └── Configuration/ ⚙ Configuration app
Base de Données/
└── database_setup.sql đŸ—„ïž Script SQL
```
---
## 🔍 Index par Mots-ClĂ©s
### A
- **Architecture MVVM** → [ARCHITECTURE.md](ARCHITECTURE.md)
- **Ajouter une fonctionnalitĂ©** → [ARCHITECTURE.md](ARCHITECTURE.md#extensibilitĂ©)
### B
- **Base de donnĂ©es** → [CONFIGURATION.md](CONFIGURATION.md), [SQL_REFERENCE.md](SQL_REFERENCE.md)
- **Build** → [COMMANDS.md](COMMANDS.md#dĂ©veloppement)
- **Backup** → [COMMANDS.md](COMMANDS.md#base-de-donnĂ©es)
### C
- **Commandes** → [COMMANDS.md](COMMANDS.md)
- **Configuration** → [CONFIGURATION.md](CONFIGURATION.md)
- **Connexion DB** → [CONFIGURATION.md](CONFIGURATION.md)
- **CommunityToolkit.Mvvm** → [ARCHITECTURE.md](ARCHITECTURE.md)
### D
- **Dashboard** → [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md)
- **DatabaseService** → [ARCHITECTURE.md](ARCHITECTURE.md)
- **DĂ©pannage** → [CONFIGURATION.md](CONFIGURATION.md), [QUICKSTART.md](QUICKSTART.md)
### F
- **Filtres** → [ARCHITECTURE.md](ARCHITECTURE.md)
### I
- **Installation** → [QUICKSTART.md](QUICKSTART.md)
- **Injection de dĂ©pendances** → [ARCHITECTURE.md](ARCHITECTURE.md)
### M
- **MariaDB** → [CONFIGURATION.md](CONFIGURATION.md)
- **Messages** → [README.md](README.md)
- **MySQL** → [CONFIGURATION.md](CONFIGURATION.md), [SQL_REFERENCE.md](SQL_REFERENCE.md)
- **MVVM** → [ARCHITECTURE.md](ARCHITECTURE.md)
### N
- **Navigation** → [ARCHITECTURE.md](ARCHITECTURE.md)
- **NuGet** → [COMMANDS.md](COMMANDS.md)
### P
- **Performance** → [ARCHITECTURE.md](ARCHITECTURE.md), [SQL_REFERENCE.md](SQL_REFERENCE.md)
- **Problùmes** → [QUICKSTART.md](QUICKSTART.md), [CONFIGURATION.md](CONFIGURATION.md)
### Q
- **Quick Start** → [QUICKSTART.md](QUICKSTART.md)
### R
- **RequĂȘtes SQL** → [SQL_REFERENCE.md](SQL_REFERENCE.md)
### S
- **SĂ©curitĂ©** → [CONFIGURATION.md](CONFIGURATION.md), [ARCHITECTURE.md](ARCHITECTURE.md)
- **Services** → [ARCHITECTURE.md](ARCHITECTURE.md)
- **SQL** → [SQL_REFERENCE.md](SQL_REFERENCE.md)
- **Support** → [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md)
### T
- **Tests** → [COMMANDS.md](COMMANDS.md), [ARCHITECTURE.md](ARCHITECTURE.md)
### V
- **ViewModels** → [ARCHITECTURE.md](ARCHITECTURE.md)
- **Views** → [ARCHITECTURE.md](ARCHITECTURE.md)
### X
- **XAML** → [ARCHITECTURE.md](ARCHITECTURE.md), [README.md](README.md)
---
## 📊 Statistiques de la Documentation
| Type | Nombre | Lignes Totales |
|------|--------|----------------|
| Fichiers Markdown | 8 | ~1500+ lignes |
| Sections | 100+ | - |
| Exemples de code | 50+ | - |
| Commandes | 100+ | - |
| RequĂȘtes SQL | 60+ | - |
---
## 🆘 Aide Rapide
**Je ne trouve pas ce que je cherche !**
1. Utilisez Ctrl+F (Cmd+F sur Mac) dans ce fichier pour chercher un mot-clé
2. Consultez la section "Guides par Scénario" ci-dessus
3. Ouvrez [README.md](README.md) pour une vue d'ensemble
4. Tous les fichiers sont en Markdown, faciles à lire avec n'importe quel éditeur
**Suggestions de documentation manquante ?**
N'hésitez pas à créer une issue ou à contribuer !
---
## 🎓 Ordre de Lecture RecommandĂ©
### Pour les Débutants
1. [README.md](README.md) - Vue d'ensemble
2. [QUICKSTART.md](QUICKSTART.md) - Installation
3. [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md) - Résumé
4. Lancez l'app et explorez !
### Pour les Développeurs
1. [ARCHITECTURE.md](ARCHITECTURE.md) - Comprendre la structure
2. [COMMANDS.md](COMMANDS.md) - Commandes de dev
3. [SQL_REFERENCE.md](SQL_REFERENCE.md) - Opérations DB
4. Code source dans TravelMateAdmin/
### Pour les Administrateurs DB
1. [CONFIGURATION.md](CONFIGURATION.md) - Configuration
2. [database_setup.sql](database_setup.sql) - Script d'installation
3. [SQL_REFERENCE.md](SQL_REFERENCE.md) - Référence complÚte
4. [COMMANDS.md](COMMANDS.md#base-de-données) - Maintenance
---
**DerniĂšre mise Ă  jour** : 12 janvier 2026
**Version de la documentation** : 1.0.0