feat(frontend): SPA Vue 3 + Vite + Tailwind v4 consommant l'API
Nouveau dossier /frontend avec un SPA complet qui couvre les écrans de la
maquette (cf. docs/Capture*.png) : public + admin token. Backend inchangé.
Stack
- Vue 3.5 + Vite 8 + TypeScript 6 + Tailwind v4 (via @tailwindcss/vite)
- Vue Router 4 en mode history, code-split par page (lazy import)
- Aucune lib UI, aucun store (pas de Pinia) — état local + fetch direct
- Bundle initial 50 kB gzip, total dist 240 kB
Pages
- / redirige vers /donut
- /dashboard 4 KPIs + mini donut + flux activité (via /api/stats + /api/activity)
- /donut viz SVG custom : 6 secteurs catégories, projets en points
colorés, anneaux plancher social / plafond écologique,
tooltip + click vers la fiche projet
- /projects grille de cartes paginée + filtres (catégorie, statut, recherche
avec debounce, query string comme source de vérité)
- /projects/new formulaire complet de création (token admin requis)
- /projects/:slug fiche : header méta + tabs Roadmap/Discussions/Ressources
+ panneau droit Progression + Équipe, modal "Rejoindre"
- /archives projets status=archived
- /categories 6 cartes coloured-top-border + count via /api/stats
- /admin/login saisie du token Bearer, validé via POST /api/members (vide)
- 404 fallback
Structure
- src/api/client.ts : wrapper fetch typé + token Bearer auto + ApiError
- src/composables/useAuth : token localStorage + reactivité Vue
- src/types/api.ts : types miroirs des réponses PHP
- src/utils/formatDate.ts : ISO/MySQL/DATE -> JJ mois AAAA, relatif, etc.
- src/components/ : Avatar, ProjectCard, StatusBadge, CategoryBadge,
ProgressBar, LoadingState, ErrorState, JoinProjectModal
- src/layouts/AppLayout : sidebar nav + main scrollable
- src/components/AppSidebar: logo donut SVG, CTA, nav, statut admin en bas
- src/pages/ : 10 pages ci-dessus
Intégration & déploiement
- vite.config.ts proxy /api/* vers http://donut-gestprojet.test (Laragon)
- caddy.conf prod : /api/* -> reverse_proxy PHP, le reste -> static dist/
avec fallback /index.html (history mode), cache long sur /assets/*
- DEPLOY.md mis à jour avec build local + rsync dist/ vers
/srv/donut/web/infolab-front/dist
- README.md mis à jour avec section "Frontend (SPA Vue 3)"
Build & types
- npm run build : vue-tsc strict (TS 6 + erasableSyntaxOnly) -> OK
- paths alias @/* configuré dans tsconfig.app.json
Vérifié localement
- npm run dev sur :5173, proxy /api -> Apache Laragon -> PHP
- Toutes les routes répondent 200 (curl http://localhost:5173/...)
- Routes API consommées correctement (categories, stats, projects, ...)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -201,6 +201,43 @@ curl -s -X DELETE "$URL/api/projects/cartographie-des-ilots-de-chaleur" \
|
||||
|
||||
---
|
||||
|
||||
## Frontend (SPA Vue 3)
|
||||
|
||||
Le SPA vit dans `/frontend/` — Vue 3 + Vite + TypeScript + Tailwind v4 + Vue Router.
|
||||
Il consomme l'API JSON et propose les pages : Tableau de bord, Vision Donut (viz
|
||||
SVG custom), Projets, Catégories, Fiche projet, Nouveau projet, Archives, Connexion admin.
|
||||
|
||||
### Dev local
|
||||
|
||||
```bash
|
||||
# Backend PHP : Laragon sert déjà /api/* sur http://donut-gestprojet.test
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev # http://localhost:5173 (Vite proxy /api vers Laragon)
|
||||
```
|
||||
|
||||
### Build de prod
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
npm run build # vue-tsc + vite build -> frontend/dist/
|
||||
```
|
||||
|
||||
Le SPA est servi par Caddy en statique depuis `frontend/dist/`, l'API par le
|
||||
conteneur PHP. Détails dans `DEPLOY.md`.
|
||||
|
||||
### Architecture
|
||||
|
||||
- **Aucune lib UI** — composants maison + Tailwind v4 (utilities classes).
|
||||
- **Pas de Pinia** : la source de vérité est l'API. État local via `ref`/`reactive`.
|
||||
- **HTTP** : `fetch` natif + petit wrapper `src/api/client.ts` (typage + erreurs).
|
||||
- **Auth admin** : token Bearer stocké dans `localStorage`, header injecté sur tous
|
||||
les writes. Validé "best-effort" au login en pingant POST /api/members avec body vide.
|
||||
- **Routing** : Vue Router 4 en mode `history`, code-split par page (lazy import).
|
||||
- **Donut viz** : SVG natif, géométrie polaire calculée à la main dans `DonutPage.vue`.
|
||||
|
||||
---
|
||||
|
||||
## Ajouter une nouvelle entité
|
||||
|
||||
1. Écrire la migration SQL dans `migrations/00X_xxx.sql` (CREATE TABLE).
|
||||
|
||||
Reference in New Issue
Block a user