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 ou reprendre un jury existant.
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 indentifiants actuels sont en dur dans le code car il n'y a pas de besoin fort de sécurité pour notre usage interne. Une identification sécurisée serait nécessaire en fonction des besoins.

• 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 client
• 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=

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.

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.

Il faudra penser à restreindre les politiques RLS avant production. Le fichier SQL contient actuellement des politiques publiques a adapter selon l'authentification retenue.

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.