mymuseum-visitapp/lib/constants.dart
Thomas Fransolet 6709726208 Splash, loader et mode hors ligne : ce qui etait invisible le reste
Le fil rouge de ces corrections : des replis silencieux. Une exception
rattrapee, une image absente, un fichier local jamais rattache — rien ne
plantait, mais rien ne marchait non plus, et aucun message ne le disait.

Splash et loader
- assets/splash et assets/loader ne contenaient que des PNG 1x1
  transparents. errorBuilder ne se declenche pas : le fichier est valide,
  juste vide. Logo et loader etaient donc invisibles PARTOUT, splash comme
  ecrans de chargement. assets/loader est supprime, kLoaderAsset avec.
- Le splash natif etait blanc (launch_background en @android:color/white,
  theme Light) puis l'app basculait en sombre. Fond unifie sur #111111,
  cote natif comme Dart, avec values-v31 : Android 12+ ignore
  windowBackground et repart sur le theme sans ces attributs.
- Le loader et l'image principale viennent maintenant du manager
  (Applications -> Mobile). InstanceImages les garde sur le device : le
  splash s'affiche avant tout appel API, il ne peut lire qu'un cache.
  Alimente au boot depuis instanceGetDetail, qui porte deja les
  ApplicationInstances — aucun appel supplementaire.
- Ouvrir une section montrait une page blanche avec un loader au milieu.
  SlideFromRightRoute devient non opaque et SectionPage garde un fond
  transparent tant que la section n'est pas prete : le visiteur garde sous
  les yeux l'ecran d'ou il vient.

Hors ligne
- L'audio d'un article ne repartait jamais du MP3 local : audioFile
  n'etait jamais renseigne, le lecteur retombait toujours sur l'URL.
- L'image de titre d'un article passait par NetworkImage, donc une croix
  rouge des que le reseau manque, alors que le fichier est sur le device.
- L'accueil ne gardait en base que order/gridSpan : une visite jamais
  telechargee disparaissait de la grille hors ligne. La visite entiere est
  desormais mise en cache, et une visite injoignable reste affichee,
  ternie et non ouvrable, plutot qu'absente.
- L'etat reseau datait du premier chargement et n'etait jamais remesure.
  WidgetsBindingObserver etait declare mais jamais enregistre : aucun
  rappel n'arrivait. L'accueil se recharge au retour dans l'app et
  remesure avant de refuser l'ouverture d'une visite.

Divers
- Le futur de getSectionDetail etait construit dans future:, donc relance
  a chaque rebuild — chaque rotation d'ecran refaisait l'appel reseau.
- ImageCustomProvider listait le repertoire d'une visite non telechargee :
  exception a chaque construction de chaque image, pour finir de toute
  facon sur le reseau.
- Scanner un QR d'une autre visite empilait les ConfigurationPage.
  pushAndRemoveUntil : une visite est une destination de premier niveau.
- Le scanner arrive sur l'accueil, en pastille de verre comme les autres
  actions de cet ecran. ScannerBouton prend size et transparent, et garde
  son apparence d'origine ailleurs.
- Le titre d'un article n'etait pas centre : customStylesBuilder ne
  s'applique qu'aux elements, et un titre sans balise n'en a aucun.
- Le lecteur audio replie ne lancait pas la lecture au premier appui, il
  ouvrait le panneau. Il lit, puis ouvre. En lecture auto il reste replie.
- Le dialogue de telechargement faisait la hauteur de l'ecran : un Center
  prend toute la hauteur maximale que lui donne un AlertDialog.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-09 16:47:27 +02:00

191 lines
7.5 KiB
Dart

import 'package:flutter/material.dart';
import 'package:flutter/services.dart' show appFlavor;
// Third-party integrations — injectées via --dart-define, jamais committées.
//
// ⚠️ GEMINI_API_KEY absente = repli sur la voix système du téléphone, et c'est
// **le comportement par défaut de tous les builds**. Utile pour tester sans dépenser de
// jetons, trompeur si on l'ignore : jusqu'au 2026-08-13 le repli était silencieux et
// personne ne savait que les APK ne parlaient pas avec la voix du produit. Il se signale
// désormais dans les logs (`[VoiceController] GEMINI_API_KEY absente…`).
//
// Pour entendre la vraie voix :
// flutter run --flavor dev --dart-define=GEMINI_API_KEY=xxxx
// flutter build apk --flavor mdlf --dart-define=GEMINI_API_KEY=xxxx --dart-define=INSTANCE_ID=... --dart-define=API_BASE_URL=... --dart-define=API_KEY=...
//
// Whisper STT (OpenAI ou serveur auto-hébergé compatible) — clé vide = STT du device.
const kWhisperApiKey = String.fromEnvironment('WHISPER_API_KEY', defaultValue: '');
const kWhisperEndpoint = String.fromEnvironment('WHISPER_ENDPOINT',
defaultValue: 'https://api.openai.com/v1/audio/transcriptions');
// Gemini TTS (2.5 Flash)
const kGeminiApiKey = String.fromEnvironment('GEMINI_API_KEY', defaultValue: '');
// ⚠️ Repli seulement. La voix réelle vient du CMS — `Instance.guideVoiceId`, réglée par le
// client dans manager-app (sélecteur Viva/Marco). Le défaut valait `Algieba`, une voix que
// personne n'a validée : il date d'avant le sélecteur, et rien ne lisait le choix du client.
// Sulafat = Viva (féminine), écoutée et validée le 2026-08-07 ; Umbriel = Marco (masculine).
const kGeminiTtsVoice = String.fromEnvironment('GEMINI_TTS_VOICE', defaultValue: 'Sulafat');
const kGeminiTtsPrompt = String.fromEnvironment('GEMINI_TTS_PROMPT',
defaultValue: 'Voix de guide de musée, ton chaleureux et bienveillant, rythme posé et clair.');
// ElevenLabs retiré du pipeline (trop cher). Fichier impl/elevenlabs_tts_engine.dart
// conservé comme référence mais non utilisé.
// Lunettes Ray-Ban Meta — DESACTIVE par defaut.
//
// Avec meta_wearables_dat 0.1.3 (SDK DAT 0.3.0), le SDK plantait le processus
// au demarrage sur certains telephones : SIGABRT dans
// com.facebook.wearable.airshield.security.PrivateKey.<clinit>,
// « __cxa_guard_acquire detected recursive initialization ». C'est une
// initialisation statique C++ cote natif (mwdat-core / airshield) : aucun
// try/catch Dart ne peut l'attraper, l'app meurt avant d'afficher quoi que
// ce soit. Constate le 2026-09-07 sur Xiaomi klimt / Android 16 / arm64.
//
// Migre vers flutter_meta_wearables_dat 0.9.1 (SDK DAT 0.9.0) : le correctif
// est plausible mais NON VERIFIE — a revalider sur le Xiaomi avant de
// retirer ce drapeau.
//
// Pour tester les lunettes : --dart-define=ENABLE_GLASSES=true
const kEnableGlasses = bool.fromEnvironment('ENABLE_GLASSES', defaultValue: false);
const kPicovoiceAccessKey = String.fromEnvironment('PICOVOICE_ACCESS_KEY', defaultValue: '');
// API configuration — injectées au build via --dart-define
// Ex: flutter build appbundle --flavor mdlf --dart-define=INSTANCE_ID=65ccc67265373befd15be511 --dart-define=API_BASE_URL=https://api.mymuseum.be --dart-define=API_KEY=xxxx
//
// Les replis suivent le flavor. Ils étaient constants et pointaient sur le PC de
// dev : un `flutter run --flavor fortsaintheribert` sans dart-define lançait une
// app cliente sur http://192.168.31.228:5000, et le boot restait bloqué le temps
// que le socket meure — écran de splash blanc pendant deux minutes.
const kApiBaseUrl = String.fromEnvironment('API_BASE_URL',
defaultValue:
_flavor == 'dev' ? 'http://192.168.31.228:5000' : 'https://api.mymuseum.be');
const kApiKey = String.fromEnvironment('API_KEY', defaultValue: '');
// Empreinte du commit, injectee au build :
// --dart-define=GIT_SHA=$(git rev-parse --short HEAD)
// Affichee avec le numero de version en bas de la feuille Parametres, pour
// relier un APK installe sur le terrain au commit exact qui l'a produit.
const kGitSha = String.fromEnvironment('GIT_SHA', defaultValue: 'dev');
const kInstanceId = String.fromEnvironment('INSTANCE_ID',
defaultValue: _flavor == 'mdlf'
? '65ccc67265373befd15be511'
: _flavor == 'fortsaintheribert'
? '633ee379d9405f32f166f047'
: '63514fd67ed8c735aaa4b8f2');
// Flavor lu depuis le --flavor gradle (appFlavor). Le --dart-define=FLAVOR reste
// accepté en repli pour les scripts de build existants.
const _flavor = appFlavor ?? String.fromEnvironment('FLAVOR', defaultValue: 'dev');
// Le meme flavor, lisible hors de ce fichier (badge de version des Parametres).
const kFlavor = _flavor;
// Colors — définies par flavor
// Pour modifier les couleurs d'un client : changer les valeurs hex ci-dessous
// puis rebuilder avec --dart-define=FLAVOR=nomduclient
// Couleurs identiques pour tous les clients actuels
const kBackgroundColor = Color(0xFFFFFFFF);
const kMainColor = Color(0xFF306bac);
const kSecondColor = Color(0xFF309cb0);
const kConfigurationColor = Color(0xFF2F4858);
/*const kArticleTitleSize = 25.0;
const kArticleDescriptionSize = 12.5;*/
const kArticleContentSize = 16.0;
const kArticleContentBiggerSize = 24.0;
const List<String> languages = [
"FR",
"NL",
"EN",
"DE",
"IT",
"ES",
"PL",
"CN",
"AR",
"UK"
]; // hmmmm depends on config..
const String defaultLanguage = "EN";
const kDefaultPadding = 20.0;
const kMainGrey = Color(0xFF424242);
const kSecondGrey = Color(0xFF555457);
//const kSecondRed = Color(0xFF622727);
const kTextRed = Color(0xFFba0505);
const kBackgroundGrey = Color(0xFFb5b7b9);
const kBackgroundSecondGrey = Color(0xFF5b5b63);
const kMainColor0 = Color(_flavor == 'mdlf'
? 0xFFe52122
: // rouge
_flavor == 'fortsaintheribert'
? 0xFF306bac
: // bleu
0xFF306bac // test (défaut)
);
const kMainColor1 = Color(_flavor == 'mdlf'
? 0xFFed7082
: // rouge clair
_flavor == 'fortsaintheribert'
? 0xFF308aae
: // bleu
0xFF308aae // test (défaut)
);
const kMainColor2 = Color(_flavor == 'mdlf'
? 0xFFed7082
: // rouge clair
_flavor == 'fortsaintheribert'
? 0xFF309cb0
: // bleu
0xFF309cb0 // test (défaut)
);
const kAppTitle = _flavor == 'mdlf'
? 'MDLF'
: _flavor == 'fortsaintheribert'
? 'Fort Saint-Héribert'
: 'MyMuseum Dev';
/// Fond du démarrage : celui de l'accueil, pas `kBackgroundColor` (blanc). Le
/// splash natif et le splash Dart le partagent avec `@color/splash_background`
/// côté Android — sinon le lancement enchaîne blanc, blanc, puis noir.
const kSplashBackground = Color(0xFF111111);
const kSplashLogoAsset = _flavor == 'mdlf'
? 'assets/splash/mdlf.png'
: _flavor == 'fortsaintheribert'
? 'assets/splash/fortsaintheribert.png'
: 'assets/splash/dev.png';
const kBackgroundLight = Color(0xfff3f3f3);
const kGreen = Color(0xFF15bd5b);
const kTitleSize = 40.0;
const kDescriptionSize = 25.0;
const kSectionTitleDetailSize = 50.0;
const kSectionDescriptionDetailSize = 35.0;
const kMenuTitleDetailSize = 25.0;
const kMenuDescriptionDetailSize = 18.0;
const kNoneInfoOrIncorrect = 35.0;
// our default Shadow
const kDefaultShadow = BoxShadow(
offset: Offset(0, 15),
blurRadius: 27,
color: kBackgroundGrey, // Black color with 12% opacity
);
/*
const kTextStyle = TextStyle(
fontSize: 23,
color: kPrimaryColor,
fontWeight: FontWeight.w600,
);*/