AER – Arreda & Risparmia

Panoramica

AER — Arreda & Risparmia è una piattaforma digitale completa per il settore arredamento in Veneto. Il progetto è composto da due applicazioni web distinte che lavorano in sinergia: un e-commerce vetrina per i clienti finali e un gestionale professionale per i rivenditori e gli amministratori.

L’architettura è basata su un monorepo Turborepo con workspace pnpm, che permette di condividere componenti UI, tipi e configurazioni tra le due app mantenendo deploy indipendenti tramite Coolify.

E-commerce Vetrina (Web)

L’app pubblica è una piattaforma e-commerce costruita con Next.js 15 e React Server Components, progettata per offrire un’esperienza di navigazione veloce e ottimizzata per la SEO.

Funzionalità principali

• Catalogo prodotti con navigazione per categorie e showroom
• Routing dinamico intelligente che distingue automaticamente categorie da punti vendita tramite /[nome_categoria]/[nome_prodotto]
• Pagine prodotto con galleria immagini, descrizioni dettagliate e informazioni showroom
• Caching avanzato con unstable_cache e revalidazione intelligente per prestazioni ottimali
• SEO-first: metadata dinamiche, sitemap automatica, struttura URL semantica
• Responsive design ottimizzato per mobile, tablet e desktop

Gestionale Professionale (Pro)

L’app gestionale è una dashboard completa costruita con Next.js 16 e React 19, dedicata alla gestione di prodotti, ordini e operazioni quotidiane dei rivenditori.

Sistema a doppio ruolo

• Shop: ogni rivenditore accede al proprio pannello per gestire catalogo, prezzi, disponibilità e ordini del proprio showroom
• Admin: accesso completo per supervisionare tutti i negozi, gestire utenti, categorie globali e analytics della piattaforma

Funzionalità gestionale

• Autenticazione sicura con Supabase Auth e gestione sessioni
• CRUD completo per prodotti, categorie, showroom e utenti
• Upload immagini tramite Supabase Storage con ottimizzazione automatica
• Dashboard analytics con metriche di vendita e performance
• Gestione ordini con tracking dello stato
• 50+ componenti UI personalizzati basati su shadcn/ui

Stack tecnologico

• Monorepo: Turborepo + pnpm workspaces
• Frontend: Next.js 15/16, React 19, TypeScript
• UI: shadcn/ui + Tailwind CSS v4
• Backend: Supabase (Auth, Database PostgreSQL, Storage)
• Data fetching: React Query (TanStack Query) con caching ottimizzato
• Testing: Vitest per unit e integration test
• Deploy: Coolify con deploy separati per ogni app
• Struttura: apps/web, apps/pro, packages/ui

Architettura

La struttura monorepo consente un workflow di sviluppo efficiente: i componenti UI condivisi nel package packages/ui vengono utilizzati da entrambe le app, garantendo coerenza visiva. Turborepo gestisce il build parallelo e il caching incrementale, riducendo drasticamente i tempi di CI/CD. Ogni app ha il proprio deploy indipendente su Coolify, permettendo aggiornamenti granulari senza impattare l’altra.

Stato

🔧 In fase di sviluppo attivo