ANAQ-Sup -Fiche de présence des visiteurs

Application web de dématérialisation de la fiche de présence des visiteurs de l'ANAQ-Sup (Autorité Nationale d'Assurance Qualité de l'Enseignement Supérieur).

Les visiteurs se présentent à l'accueil pour obtenir des informations sur les établissements d'enseignement supérieur habilités et les programmes accrédités. Cette application remplace la fiche papier par un formulaire en ligne, avec recueil du consentement, tableau de bord et exports.

---

1. Fonctionnalités

Interface publique

• Formulaire responsive (ordinateur, tablette, smartphone)
• Champs obligatoires : prénom, nom, pays d'origine, téléphone, email, formation recherchée
• Sélecteur de pays : les 250 pays avec drapeau, recherche insensible aux accents et aux séparateurs (« cote divoire » trouve « Côte d'Ivoire »), pays fréquents épinglés en tête, navigation entièrement au clavier
• Téléphone international : indicatif et drapeau par pays, formatage à la saisie et validation réelle du numéro (pas un simple contrôle de format)
• Suggestions de saisie (pays et formations) pour un remplissage rapide
• Case de consentement obligatoire, versionnée et horodatée côté serveur
• Page de confirmation avec retour immédiat au formulaire pour le visiteur suivant
• Page « Politique de confidentialité » (gabarit à faire valider juridiquement)

Espace administrateur (/admin, authentifié -non lié depuis les pages publiques : les visiteurs n'ont pas à connaître son existence, les agents habilités y accèdent par l'URL directe)

• Tableau de bord : total, aujourd'hui, cette semaine, ce mois-ci
• Graphiques : fréquentation sur 14 jours, top formations, top pays
• Liste des visiteurs : recherche plein texte, tri, pagination, filtres par période / pays / formation
• Fiche détaillée d'un visiteur, avec traçabilité complète du consentement
• Suppression avec confirmation obligatoire
• Export Excel (.xlsx) et PDF de la liste filtrée
• Génération d'une fiche PDF individuelle
• Archives du service aux usagers : registre annuel des sollicitations reçues par email (nom, adresse), consultable par mois, avec recherche, exports Excel / PDF et page de statistiques exportable en PDF (volume mensuel, usagers distincts et récurrents, catégories d'expéditeurs, messageries). Bouton Ajouter pour enregistrer une nouvelle sollicitation (prénom, nom, email, spécialité) ; modification (nom, email, spécialité) et suppression de chaque ligne, avec confirmation. La spécialité (formation demandée) alimente le classement des spécialités les plus demandées dans les statistiques

---

2. Stack technique

Domaine	Choix
Framework	Next.js 15 (App Router) + React 19
Langage	TypeScript (strict)
Styles	Tailwind CSS v4
Composants	shadcn/ui (Radix UI)
Base de données	PostgreSQL via Supabase
Authentification	Supabase Auth
Validation	Zod (client et serveur)
Sélecteur de pays	cmdk + Radix Popover (recherche clavier)
Téléphone international	react-phone-number-input + libphonenumber-js
Graphiques	Recharts
Export Excel	SheetJS (xlsx)
Export PDF	jsPDF + jspdf-autotable
Déploiement	Vercel

Aucun serveur backend dédié : Supabase joue le rôle de Backend-as-a-Service, ce qui réduit le coût d'infrastructure et de maintenance de la V1.

---

3. Architecture

src/
├── app/
│   ├── page.tsx                     # Formulaire public
│   ├── confirmation/                # Page de confirmation
│   ├── politique-confidentialite/
│   ├── admin/
│   │   ├── actions.ts               # Server Actions (connexion, suppression)
│   │   ├── login/                   # Connexion administrateur
│   │   └── (protected)/             # Groupe de routes protégées
│   │       ├── layout.tsx           # requireAdmin() + coquille d'admin
│   │       ├── dashboard/
│   │       ├── visitors/[id]/
│   │       └── archives/                # Liste + statistiques/
│   └── api/
│       ├── visitors/                # POST public (enregistrement)
│       └── admin/
│           ├── exports/excel|pdf/
│           ├── exports/archives/excel|pdf|stats/
│           └── visitors/[id]/pdf/
│
├── components/
│   ├── ui/                          # Primitives shadcn/ui
│   ├── visitor/                     # Formulaire public
│   ├── admin/                       # Tableau, filtres, exports, dialogues
│   └── charts/                      # Graphiques Recharts
│
├── lib/
│   ├── supabase/                    # client / server / admin / middleware
│   ├── repositories/                # Accès aux données (contrat + Supabase)
│   ├── services/                    # Logique métier
│   ├── validation/                  # Schémas Zod
│   ├── exports/                     # Excel, PDF, nommage de fichiers
│   ├── auth/                        # Garde d'accès administrateur
│   ├── security/                    # Limitation de débit
│   └── constants.ts, env.ts, utils.ts
│
├── types/                           # Modèle métier + typage de la base
└── middleware.ts                    # Rafraîchissement de session + garde /admin

supabase/migrations/                 # Schéma SQL, RLS, compte administrateur
scripts/archive-docx-to-sql.mjs      # Registre Word → SQL d'import des archives

Séparation des responsabilités

This is the beginning of the README. Read the rest at the original. Read the full README ↗