70 lines
4.1 KiB
Markdown
70 lines
4.1 KiB
Markdown
# manager-app
|
||
|
||
Interface de gestion de contenu Flutter (web/desktop) pour configurer `tablet-app` et `mymuseum-visitapp`.
|
||
|
||
## Stack
|
||
- Flutter web (cible principale), support desktop partiel
|
||
- State management : **Provider** + `ChangeNotifier`
|
||
- Navigation : **GoRouter**
|
||
- Firebase Storage (upload de ressources)
|
||
|
||
## Structure
|
||
```
|
||
lib/
|
||
├── main.dart # Entry point, init Firebase, GoRouter, breakpoints responsive
|
||
├── app_context.dart # Provider root wrapping ManagerAppContext
|
||
├── client.dart # Wrapper exposant les 12+ facades API générées
|
||
├── constants.dart # Couleurs, types de sections, langues, types de ressources
|
||
├── Models/ # ManagerAppContext (état central), Session, Menu...
|
||
├── Helpers/ # FileHelper (localStorage session), PDFHelper
|
||
├── Components/ # 48+ widgets réutilisables (inputs, pickers, players...)
|
||
└── Screens/ # Écrans par domaine
|
||
├── Main/ # Dashboard principal avec menu latéral
|
||
├── Configurations/ # Builder de configuration par type de section
|
||
│ └── SubSection/ # Map, Menu, Slider, Quiz, Article, PDF, Video, Weather, Event, Parcours, Game, Agenda
|
||
├── Resources/ # CRUD ressources (Image, Video, Audio, PDF, JSON...)
|
||
├── Applications/ # Liaison config ↔ app device
|
||
├── Kiosk_devices/ # Gestion des devices
|
||
├── Users/ # Gestion des utilisateurs
|
||
├── ApiKeys/ # Gestion des clés API
|
||
├── Notifications/ # Push notifications
|
||
└── Statistics/ # Analytics visiteurs
|
||
```
|
||
|
||
## Client API généré (manager_api_new/)
|
||
**C'est ici que le client est généré.** Il est consommé via dépendance locale par `tablet-app` et `mymuseum-visitapp`.
|
||
|
||
- **Éditer manuellement** les fichiers de `manager_api_new/` en miroir des changements backend — **ne pas relancer le générateur OpenAPI**, il écraserait des patches locaux déjà accumulés dans ce client.
|
||
- 16 classes API : AuthenticationApi, ConfigurationApi, SectionApi, SectionMapApi, SectionEventApi, ResourceApi, DeviceApi, UserApi, StatsApi, AIApi, etc.
|
||
- 130+ DTOs générés dans `manager_api_new/lib/model/`
|
||
|
||
## Package layout partagé (myinfomate_layout/)
|
||
Package Dart pur (pas de dépendance Flutter) contenant `bentoLayout()` — le placement "bento" dense (chaque card occupe colSpan × lignes rowSpan sur une grille à N colonnes, même principe que `grid-auto-flow: dense` en CSS). Utilisé pour l'aperçu live de `app_configuration_link_screen.dart` ET par `mymuseum-visitapp` (même placement, pour que l'aperçu soit fidèle au rendu réel). Côté web (`visitapp-web`), le même rendu est obtenu nativement via CSS Grid (pas de portage JS nécessaire). Tests dans `myinfomate_layout/test/` (fixtures `bento_layout_cases.json`).
|
||
|
||
La taille d'une card = deux entiers `gridColSpan` / `gridRowSpan` (1 ou 2), portés par `AppConfigurationLinkDTO` (donc réglables indépendamment par plateforme). Dans l'aperçu, ils se règlent via un sélecteur de forme par ligne (`card_shape_selector.dart`) OU par glisser du coin d'une card (drag 2D) — les deux écrivent le même champ.
|
||
|
||
## État central (ManagerAppContext)
|
||
Contient : credentials, accessToken, instanceId, instanceDTO, référence au client API, configuration/section sélectionnée.
|
||
Accès via `context.read<AppContext>()` ou `context.watch<AppContext>()`.
|
||
|
||
## Flow d'authentification
|
||
1. `FileHelper().readSessionWeb()` → localStorage
|
||
2. Si pas de session → `/login`
|
||
3. POST `/api/Authentication/AuthenticateWithJson` → TokenDTO
|
||
4. Init `Client` avec le host backend
|
||
5. Fetch `InstanceDTO` → détermine les features (isMobile, isTablet, isWeb, isVR, isStatistic)
|
||
6. Redirect vers `/main/:view`
|
||
|
||
## Breakpoints responsive
|
||
- Mobile : 0–550px
|
||
- Tablet : 550–800px
|
||
- Desktop : 801–1920px
|
||
- 4K : 1921px+
|
||
|
||
## Commandes utiles
|
||
```bash
|
||
flutter run -d chrome # Lancer en web
|
||
flutter build web # Build web
|
||
flutter pub run build_runner build # Regénérer code généré
|
||
```
|