Module	Description
Accueil	Dashboard avec accès aux modules
Clients	Gestion des clients, relevés de vision, ordonnances
Produits	Catalogue (montures, verres, lentilles, accessoires), alertes stock, codes QR, images
Fournisseurs	Gestion des fournisseurs
Achats & Stock	Factures d'achat, réception de stock, upload PDF
Point de Vente	Panier, paiements fractionnés, historique des ventes
Atelier	Suivi des commandes de montage (4 statuts : EN_ATTENTE → EN_COURS → TERMINE → PRET)
Rapports	KPIs, graphiques (ventes, catégories, stocks), export CSV

Stack

Framework: Next.js 16 (App Router), React 19, TypeScript 5
Base de données: SQLite via Prisma ORM
UI: Tailwind CSS 4, shadcn/ui, lucide-react
État & données: Zustand, TanStack Query, TanStack Table
Formulaires: react-hook-form + Zod
Graphiques: Recharts
Autre: Framer Motion, DND Kit, Sharp, QR Code, Sonner (toasts)

Démarrage rapide

# Cloner et configurer
bun install
echo 'DATABASE_URL="file:./dev.db"' > .env

# Base de données
bunx prisma generate
bunx prisma db push

# Lancer le serveur de développement
bun run dev
# → http://localhost:3000

Scripts

Commande	Description
`bun run dev`	Serveur de développement (port 3000)
`bun run build`	Build production
`bun start`	Serveur production
`bun run lint`	ESLint
`bun run db:push`	Push Prisma schema → DB
`bun run db:generate`	Générer client Prisma
`bun run db:migrate`	Migration Prisma
`bun run db:reset`	Reset base de données

Structure

src/
├── app/
│   ├── page.tsx              # SPA — commutation de modules
│   ├── layout.tsx            # Layout racine
│   ├── globals.css           # Styles Tailwind + shadcn
│   └── api/                  # API REST (12 groupes de routes)
├── components/
│   ├── clients/              # Module Clients
│   ├── products/             # Module Produits
│   ├── pos/                  # Module Point de Vente
│   ├── purchases/            # Module Achats
│   ├── suppliers/            # Module Fournisseurs
│   ├── atelier/              # Module Atelier
│   ├── reports/              # Module Rapports
│   └── ui/                   # Composants shadcn/ui
├── hooks/                    # Hooks personnalisés
└── lib/                      # Utilitaires (db, optical-utils, qr-code)

API

Toutes les routes sous /api/ suivent le pattern REST :

api/clients, api/clients/[id], api/clients/[id]/patients
api/patients, api/patients/[id], api/patients/[id]/ordonnances
api/produits, api/produits/[id], api/produits/[id]/images
api/fournisseurs, api/fournisseurs/[id], api/fournisseurs/[id]/factures
api/achats/factures, api/achats/factures/[id], api/achats/factures/[id]/valider
api/pos/products, api/pos/clients, api/pos/sales, api/pos/sales/[id]
api/atelier/orders, api/atelier/orders/[id]
api/reports/dashboard, api/reports/sales, api/reports/inventory, api/reports/export/*
api/fichiers/[id]

Base de données SQLite auto-contenue — aucun serveur externe requis.