CiderScope est une application web pour creer des seances d'analyse sensorielle, guider les jurys pendant la degustation, collecter leurs reponses et analyser les reponses d'un panel.

Le projet est associe a une plateforme d'analyse sensorielle IFPC. Il expose deux parcours principaux : un parcours participant pour rejoindre une seance active et repondre au questionnaire, et un parcours administration pour configurer les seances, suivre les jurys et exploiter les resultats.

Cette application a été codée en partie par IA (Claude/GPT).

• Creer, dupliquer, activer, desactiver et supprimer des seances de degustation.
• Declarer les echantillons par code et libelle optionnel.
• Composer un questionnaire avec des questions par produit, globales ou autonomes.
• Gerer les participants par nom de jury et par poste de degustation.
• Afficher l'ordre de service personnel des echantillons avant le questionnaire.
• Enregistrer les reponses dans Supabase, avec file d'attente locale si une sauvegarde echoue hors-ligne.
• Consulter une synthese d'analyse par seance et exporter les donnees.
• Autoriser ou masquer le resume des resultats cote participant apres la seance.

Les types de questions disponibles sont definis dans types/index.ts et construits dans l'administration :

L'ecran d'analyse est charge a la demande et s'appuie sur Chart.js. Selon le questionnaire, il peut afficher :

• une synthese des criteres les plus marques par echantillon ;
• les moyennes et ecarts-types des questions d'echelle ;
• les toiles d'araignee, analyses HRATA, ACP et performance jury pour les questions radar ;
• les tests de Friedman, comparaisons post-hoc de Nemenyi et concordance de Kendall pour les classements et seuils ;
• les analyses des tests discriminatifs, dont triangulaire, duo-trio et A / non-A ;
• le seuil 3-AFC BET selon la logique documentee dans l'interface ;
• un nuage de mots pour les reponses texte ;
• une vue par jury et une table des donnees brutes.

Deux exports CSV sont disponibles depuis l'administration :

• CSV standard au format base de donnée ;
• CSV FactoMineR/R pour les donnees en mode tableau.

1. Selectionner une seance active.
2. S'identifier par prenom ; la reprise sur le meme navigateur est automatique et ne demande aucun mot de passe.
3. Choisir un poste de degustation disponible.
4. Lire l'ordre de service personnalise.
5. Remplir les questions et valider chaque etape complete.
6. Consulter le resume du panel uniquement si l'animateur l'a autorise.

1. Se connecter a l'espace admin.
2. Gerer les seances et leurs statuts.
3. Configurer les echantillons et le questionnaire.
4. Suivre ou supprimer les jurys associes a une seance.
5. Ouvrir les analyses et exporter les resultats.

Les identifiants admin restent volontairement simples pour l'usage local. Ils peuvent être remplacés par ADMIN_USERNAME et ADMIN_PASSWORD; le cookie de session est signé côté serveur.

• Overview : objectif du projet et stack technique.
• Getting Started : installation locale et lancement.
• Integrations : Supabase, Vercel et GitHub Actions.
• Auto DevOps : notes preparatoires pour un pipeline automatise.
• Kubernetes : templates documentaires de deploiement Kubernetes.
• Contributing : workflow de contribution et regles de qualite.
• Changelog : changements notables du projet.

• Next.js 16 avec App Router
• React 19
• TypeScript strict
• Tailwind CSS
  • Supabase via les routes serveur
• Chart.js et react-chartjs-2
• Vitest
• GitHub Actions
• Vercel

• Node.js 22 recommande
• npm
• Un projet Supabase avec les tables decrites dans supabase-schema.sql

npm install
npm run dev

L'application locale est accessible sur http://localhost:3000.

Creer un fichier .env.local a la racine :

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=
SUPABASE_SERVICE_ROLE_KEY=
DATABASE_URL=
DIRECT_URL=

ADMIN_USERNAME=ifpc
ADMIN_PASSWORD=ifpc
ADMIN_SESSION_SECRET=

MICROSOFT_GRAPH_TENANT_ID=
MICROSOFT_GRAPH_CLIENT_ID=
MICROSOFT_GRAPH_CLIENT_SECRET=
OUTLOOK_ORGANIZER_EMAIL=lucas.semaan@ifpc.eu
OUTLOOK_WEBHOOK_NOTIFICATION_URL=https://votre-domaine.vercel.app/api/outlook/webhook
OUTLOOK_WEBHOOK_CLIENT_STATE=
CRON_SECRET=

Option de developpement :

NEXT_PUBLIC_ENABLE_TEST_DATA=1

Cette option affiche le bouton de generation de participants fictifs dans l'administration pour lancer des tests.

La fonctionnalite d'inscription utilise les routes serveur Next.js. Elles utilisent d'abord le service role Supabase, puis basculent en local sur DIRECT_URL ou DATABASE_URL si SUPABASE_SERVICE_ROLE_KEY n'est pas renseignee. Appliquer la migration supabase/migrations/202606161130_session_slots.sql, puis supabase/migrations/202607021200_outlook_calendar_invitations.sql et supabase/migrations/202607021330_remove_ics_fallback.sql, puis supabase/migrations/202607021500_immediate_outlook_invitations.sql, puis supabase/migrations/202607021700_slot_waitlist.sql, puis supabase/migrations/202607021730_promote_waitlist_on_cancel.sql, puis supabase/migrations/202607021800_outlook_decline_webhook.sql, puis supabase/migrations/202607171200_security_hardening.sql, avant de l'utiliser.

• SUPABASE_SERVICE_ROLE_KEY reste uniquement cote serveur et permet aux API de faire respecter les controles metier.
• La migration de durcissement ferme l'accès navigateur direct aux séances/réponses, ajoute un jeton local transparent pour la reprise et limite à 20 les demandes d'inscription quotidiennes par adresse.
• ADMIN_USERNAME, ADMIN_PASSWORD et ADMIN_SESSION_SECRET pilotent le cookie admin HTTP-only utilise par les nouvelles API admin.
• Si Microsoft Graph est configure, chaque inscription cree immediatement une invitation Outlook dediee dans le calendrier de OUTLOOK_ORGANIZER_EMAIL.
• Si un creneau est complet, l'inscription reste possible en liste d'attente et l'invitation Outlook est envoyee en provisoire.
• Quand une inscription confirmee est annulee, la premiere personne en liste d'attente est automatiquement confirmee.
• L'application Entra doit avoir la permission Microsoft Graph Calendars.ReadWrite en application permission, avec admin consent.
• OUTLOOK_WEBHOOK_NOTIFICATION_URL doit pointer vers l'URL publique HTTPS /api/outlook/webhook.
• Le cron Vercel /api/cron/outlook-webhook renouvelle une fois par jour l'abonnement Graph aux changements du calendrier Outlook.
• Les participants acceptent ou refusent l'invitation depuis Outlook. Les suppressions de creneau cote admin annulent les invitations Outlook.
• Si un participant refuse l'invitation Outlook, le webhook Graph annule son inscription Senso et les écrans se réactualisent automatiquement.
• Le rappel Outlook natif est configure 24 heures avant le creneau. Microsoft Graph ne permet qu'un rappel natif par evenement.
• L'ancien fallback de fichier calendrier a ete retire : les inscriptions aux creneaux utilisent uniquement les invitations Outlook.

Le schema Supabase est documente dans supabase-schema.sql. Il cree :

• sessions : configuration, statut actif, compteur de jurys et visibilite des resultats ;
• answers : reponses par couple seance / jury.
• session_slots, slot_registrations et email_domain_whitelist via la migration des creneaux d'inscription.

Les politiques publiques historiques de sessions et answers sont retirées par la migration de durcissement. Les accès sensibles passent par les API serveur protégées.

npm run dev
npm run lint
npm run typecheck
npm run test
npm run build

Validation CI locale :

npm run ci

La CI GitHub execute npm ci, npm run lint, npm run typecheck, npm run test et npm run build sur les push vers main et les pull requests.

Le depot contient vercel.json avec le framework nextjs, ce qui indique un deploiement Vercel.

Les fichiers k8s/deployment.yaml, k8s/service.yaml et k8s/ingress.yaml sont des templates documentaires. Ils doivent etre adaptes avant un deploiement reel, notamment avec une image Docker, une registry, un ConfigMap et un Secret.

• app/ : layout, page principale, providers et routage applicatif Next.js.
• components/features/ : composants metier du questionnaire et des cartes de seance.
• components/views/Home/ : ecran d'accueil.
• components/views/Participant/ : parcours participant.
• components/views/Admin/ : gestion des seances, questions, jurys et acces admin.
• components/views/Analyse/ : analyses statistiques, visualisations et exports.
• components/ui/ : primitives d'interface partagees.
• hooks/ : orchestration d'etat applicatif avec useSenso.
• lib/ : client Supabase, calculs statistiques, CSV, validation, file hors-ligne et logique de steps.
• types/ : types TypeScript publics du domaine.
• docs/ : documentation projet et integrations.
• k8s/ : manifests Kubernetes a adapter.
• public/ : logos, icones et assets statiques.
• .github/workflows/ : pipeline CI.

Les contributions passent par pull request vers main. Avant de pousser, executer :

npm run ci

Consulter CONTRIBUTING.md pour les conventions de developpement.

• Ne jamais commiter de secrets Supabase ou de fichiers .env.local.
• Verifier les politiques RLS Supabase avant toute exposition publique.
• Remplacer l'authentification admin locale actuelle par une solution configuree avant production.
• Documenter le contact de signalement de vulnerabilite lorsque le projet est ouvert a des tiers.

Ce projet est distribué sous licence GNU GPL v3.0.

Vous pouvez utiliser, modifier et redistribuer ce logiciel, à condition que les versions redistribuées restent sous licence GPL et que le code source reste disponible conformément aux termes de la licence.

Voir le fichier LICENSE pour le texte complet.