# ADR-002 : Vue 3 SPA comme frontend admin (dérogation à WES ADR-005)

**Statut :** Accepté (dérogation documentée)
**Date :** 2026-07-07
**Contexte :** Frontend de l'application admin (`resources/js/`)

---

## Contexte

WES ADR-005 prescrit Livewire 3 comme frontend principal des applications web Welely, et rejette explicitement Vue/React en SPA complète.

Ce projet (`gestionstock`) est construit depuis son origine — un boilerplate SaaS Laravel + Vue 3 préexistant — sur une SPA Vue 3 complète (stores Vuex, plugins axios, routing côté client), sans aucune trace de Livewire. Cette base est antérieure à l'adoption de WES par l'équipe.

## Décision

Ce projet conserve Vue 3 SPA comme frontend admin. Aucune migration vers Livewire n'est engagée : à ce stade de maturité du produit (fonctionnalités riches, interactions complexes côté client — POS, dashboard temps réel, formulaires dynamiques), une réécriture vers Livewire représenterait un chantier disproportionné par rapport au bénéfice, sans problème concret que Livewire résoudrait ici.

## Alternatives Considérées

### Réécriture progressive vers Livewire
Rejetée : le produit est fonctionnellement mature ; réécrire l'ensemble de l'UI (POS, gestion de stock, rapports, superadmin) en Livewire représenterait plusieurs mois de travail pour un gain non démontré, dans une application qui n'a pas de problème de performance ou de maintenabilité directement imputable au choix Vue/SPA.

### Ne rien documenter
Rejetée : même raisonnement que l'ADR-001 — une divergence architecturale non documentée fausse les décisions futures qui s'appuieraient sur l'ADR-005.

## Conséquences

- Les nouvelles fonctionnalités de ce projet continuent en Vue 3, cohérent avec l'existant.
- Les standards `standards/vuejs.md` de WES s'appliquent à ce projet plutôt que `standards/livewire.md`.
- Les futurs projets Welely démarrant de zéro doivent suivre l'ADR-005 (Livewire) sauf nouvelle dérogation justifiée.

## Quand Réviser

- Si une réécriture front majeure est budgétée pour d'autres raisons (ex: refonte UX complète).
- Si la duplication de logique entre ce projet Vue et d'autres projets Livewire de l'organisation devient un coût de maintenance significatif.