Architecture : paquets, contrat, stockage
Ce qu'il faut retenir
- Tout le code est dans des paquets (
packages/*), rangés en couches ; les applicationsapp/etwidget/ne sont plus que des coquilles (environ 120 lignes dansapp/src/, 36 danswidget/src/, tests à part). - Un paquet n'importe que les couches en dessous de lui ; un gardien, lancé par
pnpm checkavant chaque envoi, refuse tout écart. - Un contrat unique,
packages/, et un seul paquet touche au stockage du navigateur :core/ src/ types. ts @flux/. Rien n'est envoyé à un serveur.stockage
Le monorepo
L'application, le widget, leurs paquets et Storybook partagent un espace pnpm à la racine du dépôt (pnpm- : app, widget, packages/*, storybook).
Le portail de documentation docs/ a son propre espace et n'en fait pas partie ; il héberge pourtant cette documentation (docs/).
Règle d'or : une application ne contient que ce qui la rend déployable (point d'entrée, assemblage des routes, thème, fichiers publics, configuration de build et de déploiement). Aucun écran, aucun calcul, aucun accès au stockage.
À la racine : app/ et widget/ (les deux coquilles), packages/ (les douze paquets), storybook/, les deux gardiens scripts/ et scripts/, et les fichiers de configuration communs.
L'arborescence complète du dépôt
Code
Les couches
Les paquets sont rangés en couches, de bas en haut. Un paquet n'importe qu'un paquet d'une couche en dessous de la sienne, jamais une application, jamais un autre paquet « fonctionnalité ».
Source : package.json de chaque paquet, table COUCHES de scripts/check-architecture.mjs
Comment lire
Une flèche va d'un paquet vers une couche dont il dépend ; seules les flèches principales sont dessinées (un paquet fonctionnalité lit aussi core, data, le design system et les illustrations). Le widget d'intégration ne dépend ni de @flux/ui ni de Mantine : il est posé dans le site d'un partenaire.
Le gardien de l'architecture
scripts/ est lancé par pnpm check, donc par le crochet git avant chaque envoi. Il échoue si :
| Règle | Ce qui est refusé |
|---|---|
| 1 | un fichier de packages/ importe app/ ou widget/, ou un chemin relatif qui sort de son paquet (on importe @flux/ et les exports de son package.json) |
| 2 | un paquet dépend d'une couche au-dessus de la sienne, d'un autre paquet « fonctionnalité » ou d'un paquet absent de la table des couches |
| 3 | une coquille dépasse 300 lignes (app/src/ hors de app/, app/, widget/src/), ou contient un dossier ecrans/, logique/ ou composants/ |
| 4 | un fichier hors de @flux/ appelle localStorage, sessionStorage ou indexedDB |
| 5 | @flux/widget dépend de Mantine, directement ou par un autre paquet |
| 6 | le portail (docs/src, docs/scripts) recopie une fonction du service unique @flux/, ou lit packages/ ailleurs que dans docs/ |
Source : scripts/check-architecture.mjs, interne/plans/plan-packages.md
Comment lire
Les exceptions sont écrites dans le script, chacune avec sa raison : les tests de @flux/core lisent le vrai jeu de packages/ par un chemin relatif, les tests relisent le stockage du navigateur de test, et le design system efface une ancienne clé de Mantine au démarrage.
Les paquets
Douze paquets : deux pour le domaine (core, data), trois pour l'interface (design-, illustrations, ui), un service (stockage), un d'intégration (widget) et cinq fonctionnalités (visiteur, gestionnaire, projection, widget-, itineraires).
Le détail des douze paquets : couche, contenu, entrées
| Paquet | Couche | Contenu | Entrées (exports) |
|---|---|---|---|
@flux/core | domaine | le contrat (types.ts) et toute la logique pure, testée : affluence, alternatives, itinéraires, expériences, profils ; l'état de l'adresse et les communes du visiteur ; la logique du gestionnaire (anticiper, estimations, itinéraires bis, signalements, avis) ; le service unique « une demande, une réponse » ; le contrat et les préréglages des partenaires du widget | ., ./visiteur, ./gestion, ./services, ./partenaires, ./declarations |
@flux/data | domaine | le jeu de données embarqué, l'index léger, les services, la climatologie, la météo, le jeu compact du portail. Voir les données | ., ./leger (code des applications), ./compact (portail, sans zod) |
@flux/ | interface | ThemeEclaireurs, theme, palette, jetons --ecl-*, contrastes, points de rupture, polices | ., ./styles.css, ./tokens.css |
@flux/ | interface | Éclaireurs, plaquettes des questions, jeu des goûts, illustrations par type de sortie | ., ./svg/* |
@flux/ui | interface | composants génériques sur Mantine, un dossier par composant (dont graphiques et champs de l'espace gestionnaire), encodeur QR sans dépendance | ., ./qr, ./styles.css |
@flux/ | services | le seul paquet qui touche au stockage du navigateur : liste unique des clés, stockageNavigateur, profilsLocaux, appareil, cache météo, « Mon lieu », sauvegarde (export et import), partage du profil de groupe, partenaires du widget, sorties composées | ., ./cles, ./sauvegarde, ./partage, ./partenaires, ./sorties |
@flux/widget | intégration | moteur du widget (résumé d'un lieu), composant WidgetPlutotLa, élément <plutot- en Shadow DOM, code d'intégration ; sans Mantine | ., ./embed, ./composant, ./exemple, ./moteur, ./snippet |
@flux/ | fonctionnalité | écrans visiteur, profil et jeu des goûts, contexte, hooks de carte, routesVisiteur et creerRoutesVisiteur | . |
@flux/ | fonctionnalité | écrans et composants gestionnaire, contexte, routesGestionnaire et creerRoutesGestionnaire (écrans chargés à la demande), coquille seule pour les écrans d'un autre paquet | . (routes), ./ecrans, ./cadre |
@flux/ | fonctionnalité | page de démonstration « deux téléphones » | . |
@flux/ | fonctionnalité | accueil du site du widget, éditeur des partenaires, exemples, page d'un partenaire, routesWidget | . (routes), ./ecrans |
@flux/ | fonctionnalité | sorties composées : galerie, récit défilant sur une carte, « Composer le mien », éditeur du gestionnaire | ., ./routes |
Source : packages//package.json et packages//src/index.ts
Comment lire
Une ligne par paquet, de bas en haut. Un paquet fonctionnalité exporte des routes et des écrans, jamais un routeur : l'application choisit le sien (par fragment pour app/, par chemin pour widget/).
Conventions d'un paquet : un package.json avec des exports explicites, un src/index.ts, aucune étape de compilation (Vite et Vitest lisent le TypeScript), les tests à côté du code (*.test.ts, *.test.tsx), un .module.css à côté de chaque composant ou écran, des histoires Storybook pour chaque composant et chaque écran.
Écrans dans Storybook : la rubrique « Écrans » montre les vraies routes de @flux/, @flux/ et @flux/ (fichiers Ecrans. de chaque paquet), en téléphone et en ordinateur, avec le jeu embarqué. L'heure est fixée et la météo est la climatologie du lieu, pour des captures reproductibles.
Autres exports de @flux/core
Besoins d'accès : evaluerAccesSite, evaluerAccesExperience, experiencesAdaptees, BESOINS_, LIBELLES_, AVERTISSEMENT_. Modules profil (AXES_GOUT, QUESTIONS_, profilDepuisChoix, agregerGroupe), apprentissage (mettreAJourProfil, expliquerProfil), identite (identiteDuLieu, offreDuLieu), personnalisation (proposerPersonnalise, proposerBouquet, planifierBouquet, evaluerServices), moments (momentAlternatif, calendrier14Jours, urlOpenMeteo), circuits (construireCircuit), et dans alternatives : garantirEnvies, couvertureEnvies, estGardeePourEnvie, risqueDeRebond, varierOrdre, separerMemeEndroit.
Versions des outils et dépendances
Les paquets exposent leur source TypeScript directement ("exports":) : pas d'étape de compilation entre paquets, Vite et Vitest lisent le TypeScript.
Le QR code est encodé par @flux/ui lui-même (packages/), et Open-Meteo est appelé avec fetch. Versions (catalogue de pnpm-) : React 19.3, React Router 8.5, Vite 8.3, TypeScript 6.0, Vitest 5.1, zod 4.6, Biome 2.6, Tauri 2.12, happy-dom 21, Mantine 9.7.5 (@mantine/, @mantine/), postcss-, Storybook 10.6.6, polices @fontsource- et @fontsource-.
Le contrat du domaine
packages/ est le contrat. Les paquets l'implémentent (core), le remplissent (data) ou l'affichent (ui, app) ; il ne change que sur décision, car tout le reste en dépend.
Source : packages/core/src/types.ts
Comment lire
Chaque boîte est un type de types.ts (champs abrégés) ; les flèches disent « contient » ou « pointe vers ». La flèche Site → Site : relie une entrée à l'entrée principale de son lieu.
Champs du contrat ajoutés au fil du projet
| Champ | Type | Sens |
|---|---|---|
Site.lieuId | string, obligatoire | identifiant du lieu : l'id de l'entrée principale (le site lui-même s'il est seul). Voir les données |
DemandeVisite. | string, facultatif | nom du départ (« votre position », une commune), repris dans les phrases |
Signalement. | string (ISO 8601), facultatif | instant de création du signalement |
Signalement. | string (ISO 8601), facultatif | instant où un gestionnaire l'a levé ; la fin effective est la plus tôt de fin et leveLe |
BesoinAcces | "fauteuil" | "malvoyant" | "chien" | "poussette" | "marche- | besoins d'accès du groupe, posés en images |
DemandeVisite. | BesoinAcces[], facultatif | lu par proposerAlternatives et itineraireDeLaDemande ; reste sur le téléphone (fragment de l'adresse) |
Site. | ServicesSite, facultatif | toilettes, bancs, eau, jeux, part d'ombre, accès en fauteuil, chiens relevés autour du site, avec leur source ; une valeur absente veut dire « inconnu », jamais « non » |
JeuDeDonnees. | ClimatStation[], facultatif | normales mensuelles de 48 stations Météo-France, pour le repli sans prévision |
Source : packages/core/src/types.ts
Comment lire
Une ligne par champ ajouté au contrat. "pedalo" veut dire « Sur l'eau », ouvert à tous. Les règles des besoins d'accès sont sur la page Candidats et exclusions.
Les autres types (profil de goûts ProfilGouts, groupe ProfilGroupe et MembreGroupe, carte d'identité CarteIdentite, prévision PrevisionMeteo, bouquet BouquetExperiences, proposition PropositionPersonnalisee) sont dans les modules de @flux/core, pas dans le contrat. Demandes ouvertes : un champ ServicesSite. unique pour « Mon lieu » et les accès vérifiés, MembreGroupe., Alternative., DemandeVisite..
Types énumérés, contrôle par zod, types étendus
Types énumérés : Categorie (5 familles), Mode (pied, velo, transport, voiture), TypeExperience (8 types, dont pedalo affiché « Sur l'eau »), NiveauAffluence (calme, modere, charge, sature), BesoinAcces (5 besoins).
La cohérence entre le contrat et le jeu est vérifiée deux fois : par les schémas zod au chargement, et par un test de types (expectTypeOf) qui échoue si un schéma s'écarte du type.
@flux/core rend aussi des types étendus, assignables au contrat : ItineraireEstime (avec direct, jusquALArrivee, surPlace, heureDepart, explications) et EtapeEstimee (avec moment, heure, ecartKm, detourKm). Les ajouter au contrat reste à décider.
Stockage, aujourd'hui et demain
L'interface Stockage (dans le contrat) cache l'endroit où vivent les saisies : lister, enregistrer et supprimer les signalements, les itinéraires bis et les avis, puis exporter et importer le tout.
L'interface Stockage, en TypeScript
TypeScript
Sur l'appareil : stockageNavigateur (packages/), clé localStorage plutot-la:v1, qui contient { signalements, itinerairesBis, avis }. Si le stockage est indisponible (navigation privée), les saisies restent en mémoire pour la session. Les contextes visiteur et gestionnaire relisent le stockage sur l'événement storage : c'est ce qui fait marcher la projection.
Les itinéraires bis sont des sorties. Depuis le 11 novembre 2026, ils s'éditent dans l'éditeur des sorties et sont rangés avec elles (clé plutot-, identifiant bis--). Ce que lit le visiteur ne change pas : listerItinerairesBis() rend toujours des ItineraireBis, déduits des sorties (packages/). À l'ouverture de l'espace gestionnaire, migrerItinerairesBis (migration-) range dans les sorties les itinéraires saisis à l'ancienne, sans perte : celui dont un lieu n'est plus au catalogue reste où il est.
Les réglages publiés. Pour atteindre tous les visiteurs sans serveur, le gestionnaire exporte ses réglages « pour publication » : un seul fichier daté (les quatre collections), envoyé à l'équipe du site. Elle relit les fichiers reçus, les fusionne (node scripts/ : le plus récent gagne, par identifiant), dépose un fichier JSON par collection dans app/ et redéploie le site. L'application les lit en lecture seule, après l'appareil (app/).
D'autres données vivent sur l'appareil, chacune sous sa clé : les profils (seulement après l'accord), l'identifiant de l'appareil, le cache météo, les déclarations « Mon lieu », les sorties composées et les partenaires du widget. Les profils ont une clé à part pour que l'export de l'espace gestionnaire ne contienne jamais de données de santé.
Les douze clés gardées sur l'appareil
| Clé | Contenu | Écrite par | Effacée par « Tout effacer » du visiteur |
|---|---|---|---|
plutot-la:v1 | signalements, avis, et les itinéraires bis saisis à l'ancienne (rangés dans les sorties à l'ouverture de l'espace gestionnaire) | interface Stockage | non (données des gestionnaires et avis publiés) |
plutot- | accord (date), goûts, groupe (besoins et santé compris) | profilsLocaux, seulement après l'accord | oui |
plutot- | identifiant tiré au hasard, graine de l'anti-rebond, jamais envoyé | appareilLocal | oui |
plutotla: | dernière prévision Open-Meteo d'un site, avec sa date | cacheMeteoNavigateur | oui (garde la trace des sites consultés) |
plutot- | déclarations « Mon lieu » des gestionnaires, par lieuId | declarationsNavigateur (packages/) | non |
plutot- | sorties composées créées ou modifiées dans l'éditeur des sorties, itinéraires bis compris (bis--…) ; l'ancienne clé plutot- (même format) est relue tant que la nouvelle manque, puis effacée à la première écriture | stockageLocalSorties (packages/) | non (données des gestionnaires, comprises dans l'export et l'import) |
plutot- | journal local des erreurs : 20 au plus, 7 jours au plus, sans position ni profil (journal des erreurs) | installerJournalErreurs, noterErreur (packages/) | oui |
plutot- | carnet des coins calmes : un tampon par lieu calme et par jour, de jour seulement, 200 au plus, sans position ; gardé sur l'appareil seulement avec l'accord du profil (sinon en mémoire, effacé à la fermeture) | ajouterAuCarnet (packages/) | oui |
plutot- | langue choisie (fr ou en) | langueChoisie (packages/) | oui |
plutot- | copie des itinéraires bis tels qu'ils étaient avant leur passage dans l'éditeur des sorties, jointe à l'export | copieBisNavigateur (packages/) | non (données des gestionnaires) |
plutot- | partenaires du widget enregistrés dans l'éditeur du widget | enregistrerPartenaire (packages/) | non |
plutotla- | ancien choix du thème clair ou sombre : effacé au démarrage (plus de mode sombre) | <ThemeEclaireurs> | non |
Source : packages/stockage/src/cles.ts (liste unique des clés), navigateur.ts, declarations.ts, sorties.ts, partenaires.ts
Comment lire
Les profils ont une clé à part pour que l'export et l'import de l'espace gestionnaire ne contiennent jamais de données de santé (RGPD, article 9). « Tout effacer » appelle effacerDonneesVisiteur() : il efface les profils, l'identifiant de l'appareil, le cache météo, le journal des erreurs, le carnet et la langue choisie, et laisse ce qui appartient aux gestionnaires (saisies, « Mon lieu », sorties, partenaires du widget). Les deux préfixes (plutot-la: et plutotla:) cohabitent pour l'instant.
Les réglages publiés : collections, fusion, garde-fous
Fichier (reglages/…) | Contenu | Lu par |
|---|---|---|
signalements. | signalements en cours ou à venir, non levés | Stockage. |
itineraires- | itinéraires bis publiés | Stockage. |
sorties.json | sorties publiées (itinéraires bis compris) | StockageSorties. (galerie, éditeur) |
mon- | déclarations « Mon lieu » | StockageDeclarations. |
Source : COLLECTIONS_REGLAGES (packages/stockage/src/reglages.ts), exporterPourPublication et sourceFichierPublie (publie.ts)
Comment lire
Chaque fichier a la forme { format:. Un fichier absent, illisible ou d'un autre format ne donne aucun document ; un document invalide est écarté seul.
- Adaptateurs :
stockageAvecReglagesPublies,sortiesAvecReglagesPubliesetdeclarationsAvecReglagesPubliesenveloppent les stockages de l'appareil. Lecture : l'appareil d'abord, puis les documents publiés dont l'identifiant n'y est pas. Écritures, avis, export et import : l'appareil seul. - Source différée (
sourceReglagesDifferee) : le fichier n'est chargé qu'à la première lecture, puis gardé 5 minutes en mémoire ; un échec donne une liste vide et se réessaie plus tard. - Vérification double : à l'export et à la lecture, avec les schémas zod de
@flux/data; seuls les documents publiés passent, jamais un texte avec une adresse électronique ou un téléphone. Les avis, les profils et l'appareil ne sont jamais publiés.
Demain : un serveur, derrière la même interface (SourceReglages, avec une écriture par rôle), sans toucher aux écrans.
Source : packages/stockage/src/reglages.ts · la cible n'est pas construite
Comment lire
À gauche, ce qui marche aujourd'hui : l'appareil passe devant le fichier publié. À droite, seul l'adaptateur changera ; les écrans appellent toujours les mêmes interfaces.
Décision du 11 novembre 2026 : des fichiers publiés d'abord (faits et branchés), puis un serveur dans la suite Récit, l'outil qui fabrique ce portail, quand il en proposera un. La cible : comptes par structure (office de tourisme, gestionnaire de site, Département), droits par site ou commune, connexion par un fournisseur d'identité (OIDCDonnées et outils : OpenID Connect. Protocole standard pour se connecter à un service avec un compte existant (celui d'une administration, par exemple), sans créer un nouveau mot de passe. Il est envisagé pour les comptes des gestionnaires de l'application Plutôt là., par exemple celui du Département ou ProConnect), journal d'audit qui garde la structure (jamais une personne), modération et limitation des avis. Les champs creeLe et leveLe de Signalement sont déjà là.
Routage
createHashRouter de React Router : toutes les adresses sont après #. Le même build marche donc à l'identique dans un navigateur, servi depuis un sous-dossier, dans la PWA et dans Tauri, sans réglage serveur.
Les adresses de l'application et leur assemblage
| Adresse | Écran |
|---|---|
#/ | Accueil visiteur |
#/site/:id, /questions, /affluence, /alternatives, /calendrier, /chemin/: | Parcours visiteur ; réponses dans la requête (?date=), plus etape=1…7 sur l'écran des questions |
#/profil, /profil/jeu, /profil/, /profil/, /profil/, /profil/, /profil/, /profil/ | « Mieux me connaître », sous la route-cadre de l'accord |
#/itineraires, /itineraires/, /itineraires/: | Sorties composées (visiteur) |
Application du gestionnaire : #/admin, /sites/:, /sites/:, /itineraires, /itineraires/, /itineraires/:, /avis, /donnees, /sauvegarde | Espace gestionnaire |
Application du gestionnaire : #/admin/, /admin/ | Éditeur des sorties et des itinéraires bis |
Application du gestionnaire : #/projection | Projection mobile (grand écran) |
Source : app/src/routes.tsx, app/src/gestion/routes.tsx, routes.tsx de @flux/visiteur, @flux/gestionnaire et @flux/itineraires
Comment lire
Une ligne par groupe d'adresses. Dans l'application publique, une adresse du gestionnaire (#/admin…) affiche la page d'erreur du visiteur.
Depuis le 11 novembre 2026, ce sont deux applications du même domaine, construites par le même pnpm build (deux passes de Vite). app/ assemble l'application publique : routesVisiteur (@flux/) et les sorties composées (@flux/, dans la coquille du visiteur) ; app/ en fait le routeur. app/ assemble celle du gestionnaire, donnée aux offices de tourisme : l'espace gestionnaire avec l'éditeur des sorties (creerRoutesGestionnaire de @flux/), la projection (@flux/), et un renvoi vers l'application publique pour toute adresse du visiteur (« Fiche visiteur », « Voir la page visiteur »). Les deux lisent les mêmes stockages (app/) : sur un même appareil, les données locales sont partagées. Les fichiers construits de l'application publique ne contiennent ni @flux/, ni @flux/, ni l'éditeur des sorties. Deux paquets « fonctionnalité » ne s'importent jamais : c'est l'application qui les relie. L'accueil visiteur est hors de la route-cadre <AttendreJeu> (il vit sur l'index léger) ; les autres routes visiteur, dont routesProfil, attendent le jeu ; la route /admin attend prechargerJeu() et a sa propre page d'erreur avec « Réessayer ». Chaque espace déclare ses routes dans son paquet. L'espace visiteur exporte aussi creerRoutesVisiteur(environnement), qui injecte un jeu, un stockage et une horloge pour les tests.
Interface
L'interface est construite sur Mantine 9 et prend le style « Les Éclaireurs », tiré de l'image d'origine « Les Éclaireurs ». La présentation complète (palette, contrastes, typographie, composants, illustrations) est dans le design system.
- Trois paquets.
@flux/porte toutes les couleurs, les jetons CSSdesign- system --ecl-*et le thème Mantine ;@flux/porte les dessins ;illustrations @flux/uiassemble les composants. Les autres paquets ne définissent aucune couleur. - Un composant, un dossier :
packages/contientui/ src/ composants/ <Nom>/ Nom.tsx,Nom.,module. css Nom.,stories. tsx Nom.test.tsxetindex.ts. Les écrans des paquets fonctionnalité ont aussi chacun leur.module.css. - Le style est séparé du React. Tout le style est dans des fichiers CSS. Sont interdits :
style={{…}}(sauf une variable CSS calculée,style=), les props{{ "-- x": valeur }} stylesetsxen objets, les « style props » de Mantine (mt=,c=…), le CSS-in-JS et toute couleur en dur hors du design system. Les variantes passent par des classes et des attributsdata-*. Le scriptscripts/le contrôle ;check- styles. mjs pnpm checkle lance avec--strict, qui refuse aussi une ombre hors élément flottant et toute règle de mode sombre.
Ordre des styles, thème clair, mobile, accessibilité, mini-carte
- Ordre des styles : l'entrée importe
@flux/(Mantine dansdesign- system/ styles. css @layer mantine, polices, jetons, styles globaux), puis@flux/. Jamaisui/ styles. css @mantine/directement : hors de sa couche, Mantine passerait devant les styles du thème.core/ styles. css - Toujours clair (décision de l'équipe projet) :
<ThemeEclaireurs>force Mantine enlightet efface la cléplutotla-au démarrage ; aucunmode- couleur prefers-, aucun interrupteur.color- scheme index.htmldéclare<meta name=: l'ancienne valeur"color- scheme" content= "light"> light darkexpliquait probablement l'affichage sombre que personne n'avait demandé. - Interactif ou information : ce qui se clique a un fond plein ou un contour 1 px (
--ecl-) ; ce qui se lit est surcontour- interactif --ecl-, sans contour ; une seule ombre,surface- info --ecl-, sous ce qui flotte. Détail : 10 · Design system.ombre- flottant - Mobile d'abord : conçu pour 360 à 430 px ; cibles tactiles de 48 px par défaut (44 px au moins) ; marges de sécurité iOS (
env(safe-) ; une action principale par écran, en bas.area- inset- *) - Accessibilité : contraste AA vérifié par des tests (texte 4,5:1, éléments d'interface 3:1) ; chaque carte illustrée a un libellé texte (dessin marqué décoratif) ; anneau de focus de 2 px ; mouvement réduit respecté (durées à 0) ; addon a11y de Storybook en mode erreur.
- Mini-carte (
MiniCarte) : SVG sans fond de carte ni dépendance, projection locale, échelle et nord ; cible tactile de 48 px autour de chaque marqueur. - Choisi = soleil : un choix sélectionné prend le fond soleil pâle
--ecl-, un contour 2 px encre et une coche ; le lagon reste réservé à « calme ».fond- choisi
Couleurs d'affluence, tirées de l'image, du frais au chaud :
| Niveau | Icône et mot | Fond | Texte sur le fond | Dessin |
|---|---|---|---|---|
| Calme | ✓ Calme | lagon #2BB0AD | encre | un Éclaireur seul |
| Modéré | − Modéré | soleil #FFC941 | encre | trois Éclaireurs |
| Chargé | ! Chargé | corail #FD795B | encre | une petite foule |
Très fréquenté (sature) | × Très fréquenté | rouge #E01E1E | papier #FFFCF5 | une place bondée |
Source : packages/design-system/src/palette.ts et CONTRASTES.md
Comment lire
Le niveau n'est jamais porté par la couleur seule : chaque pastille a une icône et un mot, et la jauge des crans remplis. Le bloc d'affluence du résultat prend la teinte pâle du niveau (--ecl-), sans contour.
PWA et déploiement web
Le même build sert le web, la PWA et Tauri : chemins relatifs, un manifeste, un service worker, des icônes générées par script. Détail dans la page Mobile et, pour Vercel, dans Développer.
Le détail : configuration, manifeste, service worker, icônes, en-têtes
vite.:config. ts base: "./"(chemins relatifs), pour servir le même build sur le web et dans Tauri.public/: nom « Plutôt là »,manifest. webmanifest display:, portrait, couleur crèmestandalone #FEF4E1des Éclaireurs, icônes normales et maskable, raccourci vers l'espace visiteur (plus aucun vers le gestionnaire, une autre application qu'on n'installe pas).public/sw.js: service worker, un seul cacheplutot-la-v3(changerVERSIONforce tous les appareils à repartir d'un cache vide). Il laisse passer l'application du gestionnaire, servie dans sa portée, sans la mettre en cache. Détail dans la page Mobile.- Icônes et métadonnées :
app/dessine l'Éclaireur au chapeau en autocollant sur fond encre et produitscripts/ icones/ generer. mjs favicon.svgetfavicon.ico,icon.svg, les PNG 192 et 512 (normaux et maskable),apple-, les icônes des raccourcis, l'image de partagetouch- icon. png og-image.png(1 200 × 630) etsrc-(source detauri/ app- icon. png pnpm tauri icon). Rendu par Chrome sans tête, sans dépendance ; le script ne réécrit un fichier que si son contenu change. Usage, depuisapp/:node scripts/, puisicones/ generer. mjs pnpm tauri icon src-.tauri/ app- icon. png index.htmlporte la description,color-, la couleur du thème crème (scheme: light #FEF4E1) et les balises Open Graph (titre, description, image) pour l'aperçu des liens partagés.main.tsxn'enregistre le service worker que dans un build web (pas en développement, pas dans Tauri).vercel.json: installation et build avec pnpm 12.15, sortiedist, en-têtes de cache et de sécurité. Le pas-à-pas du déploiement est dans Développer, section « Déployer sur Vercel ».
Taille
Le jeu n'est pas dans le premier chargement : 457 Ko compressés au premier chargement, contre 735 Ko avec le jeu, soit 38 % de moins.
Le détail de la mesure
L'application importe seulement @flux/ ; l'index léger (68 Ko compressé) suffit à l'accueil, et jeu.json est seul dans son fichier (jeu-*.js, 283 Ko compressé), chargé par import dynamique en arrière-plan. Mesure du vérificateur (gzip -9 des fichiers listés dans index.html) : 457 Ko au premier chargement, contre 735 Ko avec le jeu (simulation), soit 38 % de moins. Restent dans le premier chargement : zod (environ 27 Ko compressés, par chargerServices) et le module « Mon lieu » (environ 3 Ko). Le jeu reste sous 2 Mo (1,99 Mo) grâce à l'omission de lieuId quand il vaut id ; les services et la climatologie sont dans des fichiers à part.
Limites
À garder en tête
- Pas de serveur : saisies, profils et cache météo restent sur l'appareil ; signalements, itinéraires bis, sorties et « Mon lieu » n'atteignent les autres téléphones qu'après un export pour publication, relu et mis en ligne par l'équipe du site.
stockageNavigateur.écrit sans vérifier ; l'espace gestionnaire vérifie avant de l'appeler, mais d'autres appelants ne seraient pas protégés.importer - Le gardien de l'architecture lit les imports par des expressions régulières : un import construit à l'exécution lui échappe.
Toutes les limites (5)
- Les tailles de bundle viennent d'un build local, sans mesure sur un vrai réseau mobile.
- Dans la projection, le thème est appliqué aux cadres par
contentDocument(même origine seulement) ; le lien de partage du groupe ne marcherait pas depuis Tauri (tauri://…).