---
name: web-ui-refactor-surface-addressable-architecture
description: memory note web-ui-refactor-surface-addressable-architecture
metadata:
  type: project
---
# Refonte web UI/UX fondee sur des surfaces adressables

- Date: 2026-08-14
- Type: decision

## Decision

La refonte web d'IdeA est cadre comme un noyau fonctionnel commun servi par deux shells UX distincts:
- `desktop-parity workspace`
- `mobile task-flow`

L'abstraction structurante retenue n'est pas le composant React ni le panneau, mais la `surface adressable`.

## Invariants

- Le `LayoutTree` existant reste borne au canevas central projet et ne doit pas modeliser les tabs/fenetres/sheets du shell navigateur.
- Un nouveau contrat `WorkspaceSession` porte la composition du shell desktop web: zones, surfaces ouvertes, presentations (`inPlace | tab | window | sheet`), focus et restauration.
- Les donnees metier restent derriere les gateways frontend existants; la refonte shell ne doit pas dupliquer ni recabler les features aux transports.
- La synchro cross-window/tab releve d'un bus de presentation cote web; le backend reste source de verite des donnees metier et du live state.
- Chaque surface declare une politique de partage explicite (`bound`, `followFocus`, `ephemeral`) pour eviter les restaurations ambiguës et les vues stale.

## Consequences

- La parite desktop web avec l'AppImage doit etre fonctionnelle, pas une imitation aveugle des primitives OS.
- Le mobile n'est pas un desktop responsive reduit; il suit un task-flow mono-surface priorisant les usages courts et decisionnels.
- Toute feature actuelle d'IdeA doit etre mappee a un catalogue de surfaces ouvrables et a une ou plusieurs presentations selon le contexte.

## Programme recommande

1. A0 inventaire complet des features/surfaces.
2. A1 noyau surfaces et politique d'ouverture.
3. A2 shell desktop web.
4. A3 ouverture en onglet/fenetre navigateur.
5. A4 persistance/restauration/synchro.
6. A5 migration progressive des features.
7. A6 shell mobile dedie.
8. A7 hardening QA.