Intranet Tarbouriech — Documentation
Documentation technique complète de la plateforme intranet Laravel.
:::info À qui s'adresse ce document Cette documentation est destinée aux développeurs qui travaillent sur le projet, qu'il s'agisse de reprendre le code existant, d'ajouter un module ou de comprendre les décisions d'architecture. Elle sert également de contexte de référence pour les agents IA (Thalia, Claude Code, Cursor…). :::
Vision du projet
Migration d'un framework PHP custom legacy vers une plateforme Laravel modulaire moderne centralisant toutes les applications métier internes de Tarbouriech.tech.
Objectifs
| Objectif | Détail |
|---|---|
| Maintenabilité | Architecture prévisible, conventions strictes |
| Modularité | Chaque domaine métier est un module isolé |
| Sécurité | Authentification centralisée Keycloak, RBAC serveur |
| IA-ready | Architecture friendly pour les agents IA (Thalia) |
| Production-grade | Logs, transactions, soft deletes, tests |
Stack technique
| Composant | Technologie |
|---|---|
| Backend | Laravel 13.x (^13.0) · PHP 8.3+ |
| Base de données | PostgreSQL (database: medithau) |
| Frontend | Blade · Bootstrap 5.3.3 · Vite |
| Authentification | Keycloak OIDC (socialiteproviders/keycloak) |
| Modules | nwidart/laravel-modules |
| Serveur web | Nginx + Nginx Proxy Manager |
| WebSocket | Laravel Reverb |
Modules actifs
| Module | Sous-domaine | Rôle |
|---|---|---|
| Admin | admin.* | RBAC, utilisateurs, services, applications, alias, groupes |
| Dashboard | dashboard.* | Portail d'accueil — liens alias groupés |
| Alert | (interne) | Notifications et alertes transversales |
| Actualite | actualite.* | Actualités internes avec génération IA |
| Analyses | analyses.* | Données qualité eau — intégration INTECMAR |
| Elevage | elevage.* | Gestion du cycle d'élevage ostréicole |
| EdiEngine | edi.* | Traitement et parsing de fichiers EDI |
| ChrConnector | chr.* | Connecteur système CHR |
| Infrastructure | infrastructure.* | Supervision Proxmox, Synology, TrueNAS, RustDesk |
| Ai | (interne) | Configuration centralisée des providers IA |
| Api | (interne) | Bridge OpenWebUI — API REST Bearer token |
| IdeaBox | ideabox.* | Boîte à idées collaborative |
| IA | ia.* | Gouvernance Thalia — modèles, quotas, rôles |
| Thalia | (interne) | Runtime agent IA — audit, permissions, validation |
| ThaliaBridge | (interne) | Connecteurs read-only : BookStack, GitLab… |
Structure des serveurs
| Environnement | IP | Chemin |
|---|---|---|
| Développement | 192.168.1.33 | /var/www/html/laravel |
| Production | 192.168.1.27 | /var/www/dashboard |
Golden Workflow
Toute requête suit ce flux obligatoire :
Route → Middleware → Form Request → Policy → Controller → Service → Model/Repository → Event/Log → Response
→ Voir Workflows / Golden Flow pour le détail complet.
Navigation rapide
- Nouveau sur le projet ? → Architecture / Vue d'ensemble
- Créer un module ? → Workflows / Création de module
- Comprendre l'IA ? → Thalia / Vue d'ensemble
- Conventions de code ? → Conventions / Nommage
- Design système ? → Design System / Vue d'ensemble