# 🏢 Support-System - Documentation Complète du Projet

> **Dernière mise à jour**: 31 Juillet 2026
> **Framework**: Laravel 12
> **Stack**: PHP 8.2+, MySQL, Tailwind CSS 4, Vite 7
> **Base de données**: `supportclicngo` (préfixe: `clic23_`)

---

## 📑 Table des Matières

1. [Aperçu Général](#1-aperçu-général)
2. [Architecture du Projet](#2-architecture-du-projet)
3. [Base de Données](#3-base-de-données)
4. [Système de Routage](#4-système-de-routage)
5. [Modèles (Models)](#5-modèles-models)
6. [Contrôleurs (Controllers)](#6-contrôleurs-controllers)
7. [Vues (Views)](#7-vues-views)
8. [Services & Helpers](#8-services--helpers)
9. [Système de Permissions & Rôles](#9-système-de-permissions--rôles)
10. [Module Tickets / Support](#10-module-tickets--support)
11. [Module Voyages (Travel ERP)](#11-module-voyages-travel-erp)
12. [Module Visa](#12-module-visa)
13. [Module Finance](#13-module-finance)
14. [Module Frontend / Portail](#14-module-frontend--portail)
15. [API Mobile](#15-api-mobile)
16. [Notifications](#16-notifications)
17. [Système Legacy / CodeIgniter](#17-système-legacy--codeigniter)
18. [Configuration](#18-configuration)
19. [Middleware](#19-middleware)
20. [Tâches et Jobs](#20-tâches-et-jobs)
21. [Dépannage & Scripts](#21-dépannage--scripts)

---

## 1. Aperçu Général

Ce projet est un **système de support client / helpdesk** complet, initialement développé sous CodeIgniter et migré vers Laravel 12. Il intègre également des modules ERP de voyage (Travel ERP) et de visa, ainsi qu'un module de finance (caisse, fournisseurs, achats).

### Fonctionnalités Principales

| Catégorie | Fonctionnalités |
|---|---|
| **Support / Ticketing** | Création de tickets, réponses, pièces jointes, statuts personnalisés, priorités, champs personnalisés, historique, SLA |
| **Base de connaissances** | FAQ catégorisées, articles de knowledge base, documentation |
| **Gestion Utilisateurs** | Rôles, permissions fines, groupes d'utilisateurs, profils |
| **Portail Client** | Interface client dédiée, soumission de tickets, suivi, FAQ, réservations |
| **Travel ERP** | Packages de voyage, hôtels, guides, réservations, passagers, paiements, devis |
| **Visa** | Pays, offres de visa, conditions, réservations, paiements |
| **Finance** | Caisses, sessions de caisse, fournisseurs, achats, Grand Livre |
| **Frontend Builder** | Éditeur de page de connexion (hero, services, logos, actualités, footer) |
| **API Mobile** | Authentification, tickets, notifications push |
| **Notifications** | In-app, email (templates), push mobile |
| **Rapports** | Performance agents, temps de réponse, statuts, export tickets |
| **Backups** | Backup/Restauration de base de données |

### Rôles Utilisateurs

| Rôle | Description | IDs/Slugs |
|---|---|---|
| **Super Admin** | Accès complet, configuré via `.env` (`SUPPORT_SUPER_ADMIN_IDS`) | Variable |
| **Manager (Gestionnaire)** | Gestion complète des tickets, rapports, utilisateurs | slugs: `manager`, `gestionnaire-de-ticket`, etc. |
| **Agent** | Gestion des tickets assignés et personnels | slugs: `agent`, `ticket-agent`, etc. |
| **Client** | Portail client : création de tickets, FAQ, réservations | Role ID = 3 ou nom "Client" |

---

## 2. Architecture du Projet

```
support-system/
├── app/
│   ├── Console/Commands/         # Commandes artisan
│   ├── Helpers/
│   │   └── settings.php          # Helpers globaux (get_setting, number_to_french_words...)
│   ├── Http/
│   │   ├── Controllers/          # Contrôleurs (Admin, Client, Ticket, Travel, Finance, etc.)
│   │   └── Middleware/           # Middleware (Auth mobile API, SetLocale)
│   ├── Jobs/
│   │   └── SendMobilePushJob.php # Job d'envoi de notifications push
│   ├── Models/                   # Modèles Eloquent (30+ modèles)
│   │   ├── Finance/              # Modèles du module Finance
│   │   └── Travel/               # Modèles du module Travel
│   ├── Providers/
│   │   └── AppServiceProvider.php
│   ├── Services/                 # Services métier
│   │   ├── FileStorageService.php
│   │   ├── FinanceCashboxService.php
│   │   ├── LegacySqlInstallService.php  # Import/migration depuis CodeIgniter
│   │   ├── MobileAuthTokenService.php
│   │   ├── MobilePushService.php
│   │   └── NotificationService.php
│   └── Support/                  # Classes utilitaires
│       ├── FrontendPortalBuilder.php    # Builder pour le portail frontend
│       ├── LegacyPasswordVerifier.php   # Vérification mots de passe legacy
│       ├── SupportAccessService.php
│       └── WindowsSafeFilesystem.php
├── bootstrap/                    # Bootstrap Laravel
├── config/                       # Fichiers de configuration (15 fichiers)
├── database/
│   ├── factories/                # Factories pour tests
│   ├── migrations/               # 60+ fichiers de migration
│   ├── nws/                      # Scripts SQL (nettoyage, import)
│   ├── seeders/                  # 20+ seeders
│   ├── sql/                      # Fichiers SQL externes
│   └── updates/                  # Scripts de mise à jour
├── docs/                         # Documentation additionnelle
├── lang/                         # Fichiers de langue (fr, en...)
├── public/                       # Assets publics
├── resources/
│   ├── css/app.css               # Styles Tailwind
│   ├── js/                       # JavaScript
│   └── views/                    # Vues Blade organisées par module
├── routes/
│   ├── api.php                   # Routes API (legacy-install + mobile)
│   ├── console.php               # Commandes console
│   └── web.php                   # Routes web (frontend + admin + client) - 399 lignes
├── storage/                      # Stockage Laravel
├── tests/                        # Tests unitaires & fonctionnels
├── vendor/                       # Dépendances Composer
├── .env                          # Variables d'environnement
├── composer.json                 # Dépendances PHP
├── package.json                  # Dépendances JS
└── vite.config.js                # Configuration Vite
```

---

## 3. Base de Données

### Configuration

| Paramètre | Valeur |
|---|---|
| **Connexion** | MySQL |
| **Base** | `supportclicngo` |
| **Préfixe** | `clic23_` |
| **Charset** | `utf8mb4` |
| **Session Driver** | `database` |
| **Cache Store** | `database` |

### Tables Principales (Modèles Eloquent)

| Modèle | Table | Description |
|---|---|---|
| User | `users` | Utilisateurs (admins, agents, clients) |
| Role | `roles` | Rôles (slug, permissions) |
| Permission | `permissions` | Permissions granulaires |
| Profile | `profiles` | Profils utilisateurs |
| UserGroup | `user_groups` | Groupes d'utilisateurs |
| Ticket | `tickets` | Tickets de support |
| TicketReply | `ticket_replies` | Réponses aux tickets |
| TicketFile | `ticket_files` | Pièces jointes |
| TicketHistory | `ticket_histories` | Historique des modifications |
| TicketStatus | `ticket_statuses` / `custom_statuses` | Statuts personnalisés |
| TicketPriority | `ticket_priorities` | Priorités |
| Category | `categories` | Catégories de tickets |
| CustomField | `custom_fields` | Champs personnalisés |
| CustomFieldValue | `custom_field_values` | Valeurs des champs personnalisés |
| ResponseTemplate | `response_templates` | Templates de réponse |
| EmailTemplate | `email_templates` | Templates d'email |
| Faq / FaqCategory | `faq` / `faq_categories` | FAQ |
| Announcement | `announcements` | Annonces |
| Contact | `contacts` | Contacts |
| Setting | `settings` | Paramètres (clé-valeur) |
| FrontendContent | `frontend_content` | Contenu du portail frontend |
| SliderImage | `slider_images` | Images du slider hero |
| Offre | `offres` | Offres commerciales |
| Backup | `backups` | Backups BDD |
| Notification | `notifications` | Notifications in-app |
| MobileApiToken | `mobile_api_tokens` | Tokens API mobile |
| TodoTask | `todo_tasks` | Tâches internes |
| ClientCommission | `client_commissions` | Commissions clients |
| **Travel ERP** | | |
| TravelProgramTemplate | `travel_program_templates` | Templates de programme |
| TravelGuide | `travel_guides` | Guides (Morchid) |
| TravelHotel | `travel_hotels` | Hôtels |
| TravelPackage | `travel_packages` | Packages |
| TravelReservation | `travel_reservations` | Réservations |
| TravelPassenger | `travel_passengers` | Passagers |
| TravelPayment | `travel_payments` | Paiements voyage |
| **Visa** | | |
| VisaCountry | `visa_countries` | Pays |
| VisaOffer | `visa_offers` | Offres visa |
| VisaCondition | `visa_conditions` | Conditions |
| VisaBooking | `visa_bookings` | Réservations visa |
| VisaPassenger | `visa_passengers` | Passagers visa |
| VisaPayment | `visa_payments` | Paiements visa |
| **Finance** | | |
| CashRegister | `cash_registers` | Caisses |
| CashSession | `cash_sessions` | Sessions de caisse |
| CashCategory | `cash_categories` | Catégories de mouvements |
| Supplier | `suppliers` | Fournisseurs |
| SupplierPayment | `supplier_payments` | Paiements fournisseurs |
| PurchaseOrder | `purchase_orders` | Achats |

### Structure des Tickets

```
tickets
├── ID (PK)
├── title
├── body
├── userid → users.ID (créateur)
├── categoryid → categories.ID
├── status → ticket_statuses.id
├── assignedid → users.ID (agent assigné)
├── priority → ticket_priorities.id
├── timestamp
├── last_reply_timestamp
├── last_reply_userid
├── notes
├── rating (1-5)
├── public (0/1)
├── archived (0/1)
├── guest_email / guest_password (tickets invités)
├── close_ticket_date / close_ticket_user_id / close_timestamp
```

---

## 4. Système de Routage

### Routes Web Principales (`routes/web.php` - 399 lignes)

#### Routes Publiques
| Méthode | URI | Nom | Description |
|---|---|---|---|
| GET | `/` | `home` | Page d'accueil / portail |
| GET | `/services` | `frontend.services` | Services publics |
| GET | `/destinations` | `frontend.destinations` | Destinations |
| GET | `/about` | `frontend.about` | À propos |
| GET | `/contact` | `frontend.contact` | Contact |
| GET/POST | `/login` | `login` | Connexion |
| POST | `/logout` | `logout` | Déconnexion |
| GET | `/lang/{lang}` | `lang.switch` | Changement de langue |

#### Routes Client (`/client/*`)
| Préfixe | Description |
|---|---|
| `/client` | Dashboard client |
| `/client/tickets` | Liste, création, affichage, réponse des tickets |
| `/client/faq` | FAQ |
| `/client/knowledge` | Base de connaissances |
| `/client/services` | Services |
| `/client/funds` | Fonds / Paiements Stripe |
| `/client/plans` | Plans tarifaires |
| `/client/travel` | Packages de voyage (Omra, Tours) |
| `/client/hotels` | Hôtels (front, conditionnel `modules.hotels`) |
| `/client/visa` | Visa (conditionnel `modules.visa`) |
| `/client/profile` | Profil client |
| `/client/mes-reservations` | Réservations du client |
| `/client/notifications` | Notifications |
| `/client/change-language` | Changement de langue |
| `/client/public-tickets` | Tickets publics |

#### Routes Admin (`/admin/*`)
| Préfixe | Contrôleur(s) | Description |
|---|---|---|
| `/admin/dashboard` | `DashboardController` | Dashboard admin (`manager.dashboard`) |
| `/admin/settings` | `SettingsController` | Paramètres généraux + ajax + theme + ticket settings |
| `/admin/profile` | `UserProfileController` | Profil personnel admin |
| `/admin/users` | `UserController` | Gestion des utilisateurs |
| `/admin/roles` | `RoleController` | Gestion des rôles |
| `/admin/permissions` | `PermissionController` | Gestion des permissions |
| `/admin/categories` | `CategoryController` | Catégories de tickets |
| `/admin/custom-fields` | `CustomFieldController` | Champs personnalisés + by-category |
| `/admin/custom-statuses` | `CustomStatusController` | Statuts personnalisés |
| `/admin/priorities` | `PriorityController` | Priorités |
| `/admin/response-templates` | `ResponseTemplateController` | Templates de réponse |
| `/admin/user-groups` | `UserGroupController` | Groupes d'utilisateurs |
| `/admin/announcements` | `AnnouncementController` | Annonces |
| `/admin/contacts` | `ContactController` | Contacts |
| `/admin/contact-lists` | `ContactListController` | Listes de contacts |
| `/admin/email-templates` | `EmailTemplateController` | Templates email |
| `/admin/frontend-content` | `FrontendContentController` | Contenu portail (GET index, POST save) |
| `/admin/sliders` | `SliderController` | Sliders hero |
| `/admin/backups` | `BackupController` | Backups BDD + restore + download |
| `/admin/notifications` | `NotificationController` | Notifications + settings |
| `/admin/members` | `MemberController` | Membres |
| `/admin/clients/{id}/profile` | `AdminClientProfileController` | Profil client |
| `/admin/tickets/*` | `Ticket\TicketTicketController` | Gestion complète: index, create, store, show, edit, update, destroy, reply, status, priority, assign, category, archive, sync, data, custom-fields-for-filter, open, mine, assigned, progress, timeout, closed, archived, custom-views, categories, custom-fields, canned-responses, custom-statuses, replies CRUD, attachments, history, response-time |
| `/admin/support/*` | `Support\*` | Knowledge, FAQ, Documentation |
| `/admin/reports/*` | `Report\ReportReportController` | Rapports, statistiques, export |
| `/admin/tasks/*` | `Task\TaskTaskController` | Tâches internes + catégories |
| `/admin/finances/*` | `Finance\*` (legacy) | Règlements, packages, réservations, offres |
| `/admin/finance/*` | (si `MODULE_FINANCE=true`) | Caisses, fournisseurs, achats |
| `/admin/travel/*` | `Travel\*` | 14 contrôleurs (hôtels, pays, villes, catégories, services, conditions, packages, réservations, paiements, passagers, guides, templates) |
| `/admin/visa/*` | `Admin\Visa*` | Offres, conditions, réservations, paiements, passagers |
| `/admin/grand-livre` | `GrandLivreController` | Grand Livre (conditionnel `modules.travel_erp`) |
| `/admin/client/manage` | `Client\ClientClientController` | Gestion clients |
| `/admin/members-area/profile` | `Member\MemberMemberController` | Zone membres |
| `/admin/preview-login` | Fonction de callback | Prévisualisation template portail |

---

## 5. Modèles (Models)

### Relations Importantes

```
User
├── belongsTo → Role (UserRole)
├── belongsToMany → Profile
├── belongsToMany → UserGroup (via user_group_users)
├── hasMany → MobileApiToken
├── hasMany → Ticket (userid)
├── hasMany → ClientCommission
├── hasMany → TravelReservation (client_user_id)
└── hasMany → VisaBooking

Ticket
├── belongsTo → User (userid)
├── belongsTo → Category (categoryid)
├── belongsTo → User (assignedid) → assignedAgent
├── belongsTo → TicketStatus (status) → statusRecord
├── belongsTo → TicketPriority (priority) → priorityRecord
├── hasMany → TicketReply (ticketid)
├── hasMany → TicketFile (ticketid)
├── hasMany → TicketHistory (ticketid)
└── hasMany → CustomFieldValue (ticketid)

Category
├── belongsTo → Category (parent) → parentCategory
├── hasMany → Category (children)
├── belongsTo → User (default_user_id) → defaultAgent
└── belongsToMany → Profile
```

### Conventions Legacy

- **Clé primaire**: `ID` (au lieu de `id`) — le modèle User définit `$primaryKey = 'ID'`
- **Timestamps**: Plusieurs tables legacy n'ont pas `created_at`/`updated_at`
- **Double encodage UTF-8**: La fonction `fix_mojibake()` corrige le texte mal encodé
- **User Model (366 lignes)**: Gère `name`, `first_name`, `last_name`, `username`, `role_id`, `user_role`, `is_active`, `active`, `client_type` (B2B/B2C), `avatar`

---

## 6. Contrôleurs (Controllers)

### Structure

```
App\Http\Controllers\
├── AuthController.php              # Authentification
├── ClientController.php            # Portail client (principal)
├── Controller.php                  # Base controller
├── DashboardController.php         # Dashboard admin
├── FrontendController.php          # Pages publiques (home, services, etc.)
├── LanguageController.php          # Changement de langue
├── LegacyInstallController.php     # Installation/import legacy
├── SliderImageController.php       # Gestion sliders
├── TicketController.php            # Controller ticket générique
├── VisaController.php              # Visa côté client (index, country, book)
├── Admin/                          # 30+ contrôleurs admin
│   ├── AdminClientProfileController.php
│   ├── AnnouncementController.php
│   ├── BackupController.php
│   ├── CategoryController.php
│   ├── ContactController.php
│   ├── ContactListController.php
│   ├── CustomFieldController.php
│   ├── CustomStatusController.php
│   ├── EmailTemplateController.php
│   ├── Finance/ (8 contrôleurs: Dashboard, CashRegister, CashSession, CashMovement, CashCategory, Supplier, SupplierPayment, PurchaseOrder)
│   ├── FrontendContentController.php
│   ├── GrandLivreController.php
│   ├── NotificationController.php
│   ├── PermissionController.php
│   ├── PriorityController.php
│   ├── ResponseTemplateController.php
│   ├── RoleController.php
│   ├── SectionSettingsController.php
│   ├── SettingsController.php
│   ├── SliderController.php
│   ├── TicketSettingsController.php
│   ├── UserController.php
│   ├── UserGroupController.php
│   ├── UserProfileController.php
│   ├── VisaConditionController.php
│   ├── VisaOfferController.php
│   ├── VisaPassengerController.php
│   ├── VisaPaymentController.php
│   └── VisaReservationController.php
├── Api/Mobile/                     # Contrôleurs API mobile
│   ├── AppConfigController.php     # Config, contacts, faq, services, notifications
│   ├── AuthController.php          # login, logout
│   ├── ProfileController.php       # show, update
│   ├── PushController.php          # register, unregister, send
│   └── TicketController.php        # index, store, show, reply, updateStatus, formData, subcategories, customFields
├── Client/ClientClientController.php
├── Finance/ (Reglement, Package, Reservation, Offre)
├── Member/MemberMemberController.php
├── Report/ReportReportController.php
├── Support/ (Documentation, FAQ, Knowledge)
├── Task/ (TaskTaskController, TaskCategoryController)
├── Ticket/ (TicketTicketController, TicketCategory, TicketCustomField, TicketCannedResponse, TicketCustomStatus)
└── Travel/ (14 contrôleurs: Hotel, Package, Reservation, Payment, Passenger, Guide, ProgramTemplate, City, Country, Category, Service, Condition, ClientHotel)
```

---

## 7. Vues (Views)

### Organisation par Module

```
resources/views/
├── admin/                          # Vues administrateur
│   ├── dashboard.blade.php
│   ├── announcements/              # Annonces (index, create, edit...)
│   ├── backups/                    # Backups
│   ├── categories/                 # Catégories
│   ├── clients/                    # Clients
│   ├── contact-lists/              # Listes de contacts
│   ├── contacts/                   # Contacts
│   ├── custom-fields/              # Champs personnalisés
│   ├── custom-statuses/            # Statuts personnalisés
│   ├── email-templates/            # Templates email
│   ├── finance/                    # Finances (caisse, fournisseurs, achats)
│   ├── finances/                   # Finances legacy
│   ├── frontend-content/           # Éditeur de contenu portail
│   ├── grand-livre/                # Grand Livre
│   ├── members/                    # Membres
│   ├── members_area/               # Zone membres
│   ├── notifications/              # Notifications
│   ├── offres/                     # Offres
│   ├── partials/                   # Partials admin (sidebar, etc.)
│   ├── payments/                   # Paiements
│   ├── permissions/                # Permissions
│   ├── priorities/                 # Priorités
│   ├── profiles/                   # Profils
│   ├── reports/                    # Rapports
│   ├── response-templates/         # Templates de réponse
│   ├── roles/                      # Rôles
│   ├── settings/                   # Paramètres
│   ├── sliders/                    # Sliders
│   ├── support/                    # Support (knowledge, FAQ, docs)
│   ├── tasks/                      # Tâches
│   ├── tickets/                    # Tickets admin
│   ├── travel/                     # Travel ERP admin
│   ├── user_profile/               # Profil utilisateur
│   ├── user-groups/                # Groupes utilisateurs
│   ├── user-roles/                 # Rôles utilisateurs
│   ├── users/                      # Utilisateurs
│   └── visa/                       # Visa admin
├── agent/                          # Dashboard agent
│   └── dashboard.blade.php
├── auth/                           # Authentification
│   ├── login.blade.php
│   └── templates/                  # Templates de portail (portal_builder)
├── client/                         # Portail client
│   ├── index.blade.php             # Dashboard client
│   ├── dashboard.blade.php
│   ├── faq.blade.php
│   ├── funds.blade.php
│   ├── knowledge.blade.php
│   ├── knowledge_search.blade.php
│   ├── plans.blade.php
│   ├── public_tickets.blade.php
│   ├── services.blade.php
│   ├── view_faq.blade.php
│   ├── view_knowledge.blade.php
│   ├── view_ticket.blade.php
│   ├── change_language.blade.php
│   ├── hotels/                     # Hôtels client
│   ├── layouts/                    # Layouts client
│   ├── profile/                    # Profil
│   ├── tickets/                    # Tickets client (index, create...)
│   └── travel/                     # Voyages client
├── emails/                         # Templates email
│   └── plain-notification.blade.php
├── frontend/                       # Pages publiques
│   ├── about.blade.php
│   ├── contact.blade.php
│   ├── destinations.blade.php
│   ├── home.blade.php
│   ├── services.blade.php
│   └── layouts/
├── install/                        # Pages d'installation/import
│   ├── legacy-full-repair.blade.php
│   └── legacy-import.blade.php
├── layouts/
│   ├── app.blade.php               # Layout principal
│   └── partials/
├── members/
│   └── index.blade.php
├── visa/                           # Visa côté client
│   ├── country.blade.php
│   └── index.blade.php
└── welcome.blade.php
```

---

## 8. Services & Helpers

### Services (`app/Services/`)

| Service | Fichier | Description |
|---|---|---|
| **FileStorageService** | `FileStorageService.php` | Gestion du stockage de fichiers |
| **FinanceCashboxService** | `FinanceCashboxService.php` | Logique métier caisse/finance |
| **LegacySqlInstallService** | `LegacySqlInstallService.php` | **454 lignes** - Import SQL depuis CodeIgniter, réparation schéma, compatibilité. Gère: backupPath, files, importFile, schemaStatus, repairSchema, ensureLaravelInfrastructureTables, ensureLaravelApplicationCompatibility, executeSqlFile, dumpTableDefinitions, defaultTicketStatuses |
| **MobileAuthTokenService** | `MobileAuthTokenService.php` | Gestion des tokens API mobile |
| **MobilePushService** | `MobilePushService.php` | Envoi de notifications push |
| **NotificationService** | `NotificationService.php` | **184 lignes** - Envoi de notifications (in-app + email). Méthodes: send(), notifyAdmins(), notifyCategoryEmails(), isTypeEnabled(), 12 types de notifications |

### Support Classes (`app/Support/`)

| Classe | Description |
|---|---|
| **FrontendPortalBuilder** | **665 lignes** - Builder complet pour le portail frontend. Gère: 3 templates (showcase_modern, editorial_support, custom_builder), 6 sections, 8 effets de transition, contenus par défaut, flux RSS distants, colonnes footer dynamiques, hydratation legacy |
| **LegacyPasswordVerifier** | Vérification des mots de passe au format CodeIgniter |
| **SupportAccessService** | Service d'accès au support |
| **WindowsSafeFilesystem** | Compatibilité système de fichiers Windows |

### Helpers Globaux (`app/Helpers/settings.php`)

| Fonction | Description |
|---|---|
| `get_setting($key, $default)` | Récupère une valeur de la table `settings` (avec cache statique) |
| `setting($key, $default)` | Alias de `get_setting` |
| `number_to_french_words($number)` | Convertit un nombre en mots français (ex: "Cent vingt-trois Dinars") |
| `fix_mojibake($text)` | Corrige le texte double-encodé UTF-8 |

---

## 9. Système de Permissions & Rôles

### Configuration (`config/support_access.php` - 411 lignes)

#### 53 Permissions Individuelles

| ID | Slug | Description |
|---|---|---|
| 1 | `dashboard_access` | Accès dashboard |
| 2 | `admin_access` | Accès administration |
| 3 | `admin_settings` | Paramètres admin |
| 4 | `admin_members` | Gestion membres |
| 5 | `admin_payment` | Gestion paiements |
| 6 | `admin_announcements` | Gestion annonces |
| 7 | `manage_tickets` | Gestion tickets |
| 8 | `view_all_tickets` | Voir tous les tickets |
| 9 | `view_assigned_tickets` | Voir tickets assignés |
| 10 | `view_your_tickets` | Voir ses tickets |
| 11 | `ticket_manager` | Manager tickets |
| 12 | `ticket_worker` | Travailleur tickets |
| 13 | `categories_manage` | Gestion catégories |
| 14 | `custom_fields_manage` | Gestion champs personnalisés |
| 15 | `ticket_statuses_manage` | Gestion statuts |
| 16 | `priorities_manage` | Gestion priorités |
| 17 | `response_templates_manage` | Templates de réponse |
| 18 | `users_manage` | Gestion utilisateurs |
| 19 | `members_view` | Voir membres |
| 20 | `roles_manage` | Gestion rôles |
| 21 | `permissions_manage` | Gestion permissions |
| 22 | `profiles_manage` | Gestion profils |
| 23 | `knowledge_view` | Voir knowledge base |
| 24 | `knowledge_manage` | Gérer knowledge base |
| 25 | `faq_view` | Voir FAQ |
| 26 | `faq_manage` | Gérer FAQ |
| 27 | `faq_manager` | Manager FAQ |
| 28 | `documentation_view` | Voir documentation |
| 29 | `documentation_manage` | Gérer documentation |
| 30 | `documentation_manager` | Manager documentation |
| 31 | `knowledge_manager` | Manager knowledge |
| 32 | `reports_view` | Voir rapports |
| 33 | `reports_response_time` | Rapport temps de réponse |
| 34 | `reports_user_tickets` | Rapport tickets utilisateur |
| 35 | `tickets_export` | Export tickets |
| 36 | `tasks_view` | Voir tâches |
| 37 | `tasks_manage` | Gérer tâches |
| 38 | `settings_manage` | Gérer paramètres |
| 39 | `ticket_settings_manage` | Paramètres tickets |
| 40 | `section_settings_manage` | Paramètres sections |
| 41 | `email_templates_manage` | Templates email |
| 42 | `client_access` | Accès client |
| 43 | `packages_manage` | Gérer packages |
| 44 | `reservations_manage` | Gérer réservations |
| 45 | `offres_manage` | Gérer offres |
| 46 | `sliders_manage` | Gérer sliders |
| 47 | `contact_lists_manage` | Gérer listes contacts |
| 48 | `edit_content_frontend_manage` | Éditer contenu frontend |
| 49 | `visa_offers_manage` | Gérer offres visa |
| 50 | `visa_reservations_manage` | Gérer réservations visa |
| 51 | `fast_links_view` | Voir liens rapides |
| 52 | `reglements_view` | Voir règlements |
| 53 | `reglements_manage` | Gérer règlements |

#### 9 Sections de Permissions
1. **Dashboard** - Accès dashboard, indicateurs
2. **Tickets** - Gestion tickets, statuts, priorités, catégories, champs
3. **Rapports** - SLA, export, analyses
4. **Support & Contenu** - Knowledge, FAQ, Documentation
5. **Utilisateurs & Profils** - Users, membres, rôles, permissions
6. **Login Page** - Sliders, contenu frontend
7. **Settings** - Paramètres, emails, contacts, liens rapides
8. **Tâches & Finance** - Tâches, offres, réservations, règlements, visa
9. **Client** - Espace client

#### Permissions par Rôle Legacy (pré-configuré)
- **Manager / Gestionnaire** (6 variantes de slug): 18 permissions
- **Agent** (6 variantes de slug): 4 permissions
- **Content Manager** (2 variantes): 6 permissions
- **Login Page Manager**: 2 permissions
- **Settings Manager** (2 variantes): 6 permissions
- **Tasks Manager**: 2 permissions
- **Finance Manager**: 5 permissions
- **Client**: 2 permissions

---

## 10. Module Tickets / Support

### Flux de Ticket
1. **Création**: Client (ou admin) crée un ticket → catégorie → sous-catégorie → champs personnalisés → pièces jointes → priorité
2. **Attribution**: Auto-assignation ou manuelle par le manager
3. **Traitement**: Réponses, changements de statut, notes internes
4. **Résolution/Fermeture**: Statut "Fermé" ou "Résolu", archivage possible
5. **Évaluation**: Note (rating 1-5)

### Statuts par Défaut
| ID | Nom | Couleur | Closable |
|---|---|---|---|
| 1 | Nouveau | #0c4756 | Non |
| 2 | En cours | #fab13e | Non |
| 3 | Fermé | #ec6060 | Oui |
| 4 | Libéré | #5d686e | Non |
| 5 | Résolu | #7bef79 | Oui |
| 6 | Commentaire | #6326DD | Non |
| 7 | Litige | #6326DD | Non |

### Routes Ticket Admin
- `GET /admin/tickets` - Liste (DataTables server-side)
- `GET /admin/tickets/data` - Données AJAX
- `GET /admin/tickets/create` - Formulaire création
- `POST /admin/tickets` - Store
- `GET /admin/tickets/{id}` - Détail
- `GET /admin/tickets/{id}/edit` - Édition
- `PUT /admin/tickets/{id}` - Update
- `DELETE /admin/tickets/{id}` - Suppression
- `POST /admin/tickets/{id}/reply` - Répondre
- `POST /admin/tickets/{id}/status` - Changer statut
- `POST /admin/tickets/{id}/priority` - Changer priorité
- `POST /admin/tickets/{id}/assign` - Assigner agent
- `PUT /admin/tickets/{id}/category` - Changer catégorie
- `POST /admin/tickets/{id}/archive` - Archiver
- `GET /admin/tickets/{id}/sync` - Synchroniser
- `GET /admin/tickets/{id}/history` - Historique
- `GET /admin/tickets/{id}/response-time` - Temps de réponse
- Filtres: open, mine, assigned, priority, progress, timeout, closed, archived, custom-views, status/{status}

---

## 11. Module Voyages (Travel ERP)

### Architecture
```
Travel\
├── TravelProgramTemplate    # Templates de programme (Omra, Tour, etc.)
├── TravelGuide              # Guides/Morchid (nom, contact, langue)
├── TravelHotel              # Hôtels (nom, ville, pays, catégorie, services, conditions) avec toggle
├── TravelPackage            # Packages (template, hôtels, prix, dates, compagnie aérienne, fournisseur)
│   └── TravelPricingLine    # Lignes de prix (type chambre, passagers, prix, commission, extra_bed_type)
├── TravelReservation        # Réservations client (package, passagers, statut, calcul total)
├── TravelPassenger          # Passagers (nom, prénom, passeport, date naissance, baby flag)
└── TravelPayment            # Paiements (réservation, montant, justificatif, méthode)
```

### Routes Admin Travel
- Templates: `/admin/travel/program-templates`
- Hôtels: `/admin/travel/hotels` (avec toggle, cities-by-country)
- Pays: `/admin/travel/countries` (avec toggle)
- Villes: `/admin/travel/cities` (avec toggle)
- Catégories hôtel: `/admin/travel/hotel-categories` (avec toggle)
- Services: `/admin/travel/services` (avec toggle)
- Conditions: `/admin/travel/conditions` (avec toggle)
- Packages: `/admin/travel/packages` (+ template-info, hotels-data, pricing-lines, poster)
- Réservations: `/admin/travel/reservations` (+ calc-total, passengers, update-status, devis)
- Paiements: `/admin/travel/payments` (index, show, store, destroy)
- Passagers: `/admin/travel/passengers`
- Guides: `/admin/travel/guides` (sans create/edit/show)
- Quick Supplier: `/admin/travel/suppliers/quick-store` (AJAX)

---

## 12. Module Visa

### Architecture
```
VisaCountry    # Pays (nom, code ISO, drapeau, actif)
VisaOffer      # Offres de visa (pays, type, prix, durée, commission)
VisaCondition  # Conditions (pays, type visa, documents requis, délais)
VisaBooking    # Réservations (client, offre, statut, date)
VisaPassenger  # Passagers (booking, nom, prénom, passeport)
VisaPayment    # Paiements (booking, montant, justificatif, passager)
```

### Routes Admin Visa
- Offres: `/admin/visa/offers`
- Conditions: `/admin/visa/conditions` (param: `visa_condition`)
- Réservations (bookings): `/admin/visa/reservations` (index, show, destroy, updateStatus, download)
- Paiements: `/admin/visa/payments` (index, show, store, destroy)
- Passagers: `/admin/visa/passengers`

---

## 13. Module Finance

### Activation
Contrôlé par `MODULE_FINANCE=true` dans `.env` et `config('modules.finance')`.

### Architecture
```
Finance\
├── CashRegister      # Caisses (nom, solde, devise)
├── CashSession       # Sessions de caisse (ouverture/fermeture)
├── CashMovement      # Mouvements (entrées/sorties)
├── CashCategory      # Catégories de mouvements
├── Supplier          # Fournisseurs (nom, contact, solde)
├── SupplierPayment   # Paiements fournisseurs
└── PurchaseOrder     # Achats/Bons de commande
```

### Routes Admin Finance
- Dashboard: `/admin/finance/dashboard`
- Caisses: `/admin/finance/cash-registers`
- Sessions: `/admin/finance/cash-sessions` (index, store, close)
- Mouvements: `/admin/finance/cash-movements` (index, create, store, destroy)
- Catégories: `/admin/finance/cash-categories`
- Fournisseurs: `/admin/finance/suppliers` (+ grand-livre, statement-print, summary)
- Paiements: `/admin/finance/supplier-payments`
- Achats: `/admin/finance/purchases` (+ cancel)

### Grand Livre
- `/admin/grand-livre` - Vue consolidée (conditionnel `modules.travel_erp`)
- Données AJAX: packages, réservations, clients

---

## 14. Module Frontend / Portail

### FrontendPortalBuilder (`app/Support/FrontendPortalBuilder.php` - 665 lignes)

#### Templates
| Key | Label | Description |
|---|---|---|
| `showcase_modern` | Template 1 | Hero fond photo, cartes numérotées, présentation corporate |
| `editorial_support` | Template 2 | Hero split, actualités éditoriales, footer accent |
| `custom_builder` | Template Personnalisé | Choix libre des variantes, couleurs, ordre et CSS |

#### Sections Configurables
| Section | Variantes |
|---|---|
| **Hero** | `banner_card`, `orbit_spotlight` (+ 8 effets de transition) |
| **Services** | `numbered_tiles`, `icon_blocks` (6-12 services) |
| **Présentation** | `split_story`, `feature_matrix` |
| **Logos** | `logo_strip`, `logo_grid` (6 logos) |
| **Actualités** | `card_grid`, `spotlight_news` (flux RSS distant supporté) |
| **Footer** | `deep_footer`, `gradient_footer` (6 colonnes configurables) |

#### Contenu Stocké
- Table `frontend_content` (key_name → content)
- Cache des flux d'actualités distants (20 min)
- Thème: couleurs primaire/secondaire via `settings` table

---

## 15. API Mobile

### Routes (`routes/api.php`)
- Non authentifié: login, config, contacts, faq, services
- Authentifié (Bearer token): logout, push register/unregister/send, profile, notifications, tickets CRUD + formData + subcategories + customFields

### Contrôleurs (`app/Http/Controllers/Api/Mobile/`)
- `AppConfigController`: config, contacts, faq, services, notifications
- `AuthController`: login, logout
- `ProfileController`: show, update
- `PushController`: register, unregister, send
- `TicketController`: CRUD + formData + subcategories + customFields

### Middleware
- `AuthenticateMobileApiToken`: Vérifie le token dans `Authorization: Bearer {token}`

---

## 16. Notifications

### Service (`App\Services\NotificationService`)

#### 12 Types de Notifications
`ticket_created`, `ticket_reply`, `ticket_closed`, `status_changed`, `ticket_assigned`, `reservation_created`, `visa_booking_created`, `payment_created`, `payment_removed`, `reservation_deleted`, `client_booking`

#### Canaux
- **Local (in-app)**: Stocké en BDD (`notifications` table)
- **Email**: Templates (table `email_templates`) avec variables `{{name}}`, `{{title}}`, `{{message}}`, `{{url}}`, `{{date}}`
- **Push Mobile**: Via `MobilePushService` + `SendMobilePushJob`

#### Paramètres
- Stockés dans `settings` table (per-type enabling)
- Interface admin: `/admin/notifications/settings`

---

## 17. Système Legacy / CodeIgniter

### LegacySqlInstallService (`app/Services/LegacySqlInstallService.php` - 454 lignes)
- **Import SQL**: Importe fichiers SQL CodeIgniter depuis `database/backups/`
- **Analyse de schéma**: Compare dump SQL avec la base actuelle
- **Réparation**: Ajoute colonnes/tables manquantes, timestamps
- **Compatibilité Laravel**: Tables `sessions`, `cache`, `cache_locks`
- **Compatibilité applicative**: Statuts tickets par défaut, `is_closable`, `order`

### Conventions Legacy
- **PK nommée `ID`**: Au lieu de `id`
- **Pas de timestamps**: Sur beaucoup de tables legacy
- **Double encodage UTF-8**: `fix_mojibake()` + `Ticket::decodeLegacyText()`
- **Mots de passe**: `LegacyPasswordVerifier` pour hashs CodeIgniter
- **Permissions legacy**: `config/support_access.php` → `legacy_role_permission_slugs_by_role_slug`

### Fichiers de Migration Legacy (8 fichiers)
- `revert_tickets_table_to_codeigniter`
- `revert_categories_to_codeigniter`
- `revert_ticket_support_tables_to_codeigniter`
- `create_legacy_user_group_tables`
- `add_laravel_compatibility_to_legacy_database`
- `create_legacy_core_tables`
- `create_legacy_support_tables`
- `create_legacy_misc_tables`

---

## 18. Configuration

### Fichiers de Configuration (`config/`)
| Fichier | Description |
|---|---|
| `app.php` | Nom, env, debug, locale, modules flags |
| `auth.php` | Authentification |
| `cache.php` | Cache (database) |
| `cors.php` | CORS |
| `database.php` | Connexions BDD (mysql, sqlite, mariadb, pgsql, sqlsrv), préfixe `clic23_` |
| `filesystems.php` | Stockage fichiers |
| `frontend_portal.php` | Activation templates (showcase_modern, editorial_support) |
| `logging.php` | Canaux de log |
| `mail.php` | Email (SMTP Gmail) |
| `mobile_push.php` | Push mobile |
| `modules.php` | Activation modules: travel_erp, hotels, packages, visa, finance |
| `queue.php` | Queue (database) |
| `services.php` | Services externes |
| `session.php` | Sessions (driver: database, table: sessions, lifetime: 120) |
| `support_access.php` | **411 lignes** - Permissions, rôles, sections, legacy mapping |

### Variables .env Importantes
```
APP_NAME=Laravel
APP_ENV=local, APP_DEBUG=true
APP_LOCALE=fr
DB_CONNECTION=mysql, DB_DATABASE=supportclicngo, DB_PREFIX=clic23_
SESSION_DRIVER=database, QUEUE_CONNECTION=database, CACHE_STORE=database
MODULE_VISA=true, MODULE_PACKAGES=true, MODULE_GRAND_LIVRE=true, MODULE_FINANCE=true
MAIL_MAILER=smtp, MAIL_HOST=smtp.gmail.com, MAIL_PORT=587
```

---

## 19. Middleware

| Middleware | Fichier | Description |
|---|---|---|
| **AuthenticateMobileApiToken** | `AuthenticateMobileApiToken.php` | Vérifie le token API mobile dans le header |
| **SetLocale** | `SetLocale.php` | Définit la locale de l'application |

---

## 20. Tâches et Jobs

| Job | Description |
|---|---|
| `SendMobilePushJob` | Envoi asynchrone de notifications push mobiles |

### Queue
- Driver: `database`
- Lancement: `php artisan queue:listen --tries=1 --timeout=0`

---

## 21. Dépannage & Scripts

### Scripts Utilitaires Racine
| Fichier | Utilité |
|---|---|
| `check_db.php`, `db_check.php`, `db_test.php` | Vérification connexion BDD |
| `check_tickets.php` | Vérification tickets |
| `list_tables.php`, `inspect_db.php`, `get_db_info.php` | Inspection BDD |
| `fix*.php` (7 scripts) | Correctifs divers (routes, tickets, finance, ID, nowdoc) |
| `generate_*.php` (3 scripts) | Génération structure/lang |
| `migrate_settings.php`, `migrate_sidebar.php` | Migration settings |
| `populate_*.php` (3 scripts) | Population modèles/migrations |
| `revert_tickets.php`, `drop_all_tables.php` | Rollback |
| `route_check.php`, `url_check.php` | Vérification routes |
| `sync_views.php` | Synchronisation vues |
| `test_accounts.php` | Test comptes |
| `update_user.php`, `create_dirs.php` | Maintenance |

### Dossiers de Données SQL
| Dossier | Contenu |
|---|---|
| `database/nws/` | Scripts SQL (nettoyage, import `supportclicngo`) |
| `database/sql/` | SQL externes (`travel_hotels_module.sql`) |
| `database/updates/` | Scripts de mise à jour, migrations SQL |
| `database/Update_only_tickets_data_drop_insert/` | Updates tickets |

---

## 📊 Résumé Technique Final

### Stack Technique
| Technologie | Version |
|---|---|
| Laravel | 12.x |
| PHP | 8.2+ |
| MySQL | - |
| Tailwind CSS | 4.x |
| Vite | 7.x |
| Axios | 1.x |

### Modules Activables
| Module | Flag .env | Config |
|---|---|---|
| Travel ERP | `MODULE_TRAVEL_ERP` | `config('modules.travel_erp')` |
| Hotels | `MODULE_HOTELS` | `config('modules.hotels')` |
| Packages | `MODULE_PACKAGES` | `config('modules.packages')` |
| Visa | `MODULE_VISA` | `config('modules.visa')` |
| Finance | `MODULE_FINANCE` | `config('modules.finance')` |

### Commandes Utiles
```bash
php artisan serve                          # Serveur développement
php artisan queue:listen --tries=1         # Queue worker
npm run dev                                # Assets frontend
php artisan migrate                        # Migrations
php artisan db:seed                        # Seeders
php artisan config:clear                   # Clear config cache
php artisan test                           # Tests
```

### 🔑 10 Points Clés
1. **Système hybride**: Migration CodeIgniter → Laravel avec couche de compatibilité
2. **PK = `ID`**: Convention legacy maintenue dans tous les modèles
3. **Préfixe BDD `clic23_`**: Toutes les tables sont préfixées
4. **53 Permissions granulaires**: 9 sections, rôles pré-configurés
5. **Double encodage UTF-8**: Problème connu, corrigé par `fix_mojibake()` et `decodeLegacyText()`
6. **5 Modules activables**: Travel, Hotels, Packages, Visa, Finance (`.env`)
7. **API Mobile**: Authentification par token, push notifications
8. **Frontend Builder**: 3 templates, 6 sections configurables, contenu éditable
9. **Notifications 12 types**: In-app, email (templates), push mobile
10. **Locale française**: Interface en français, helper `number_to_french_words`

---

*Documentation générée le 31/07/2026 - Pour mise à jour, modifier ce fichier.*
