- 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.
233 lines
8.1 KiB
Markdown
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
|