Skip to content

Repository files navigation

PulseNotes - Notes UVSQ, statistiques de promotion et bulletins PDF

Ouvrir PulseNotes · Installer · Documentation · API PHP · Releases

Build et release Derniere release Frontend React Proxy PHP Stockage

Ce que fait PulseNotes

PulseNotes est une interface alternative pour consulter les résultats universitaires UVSQ avec une lecture plus claire des notes, des statistiques de promotion, du suivi des changements et des exports PDF personnalisés.

Le navigateur ne contacte jamais directement CAS ou Bulletins UVSQ. Toutes les connexions passent par un proxy PHP côté serveur, ce qui permet de proposer deux usages propres: un service global partagé et une installation personnelle auto-hébergée.

Le service global expose aussi l’installateur personnel via https://pulsenotes.mmi.place/install.sh, utilisable depuis le Terminal cPanel o2switch.

Accès et éditions

Besoin Edition recommandée Lien ou paquet Stockage
Utiliser le service partagé Globale https://pulsenotes.mmi.place MySQL ou PostgreSQL
Héberger pour soi Personnelle pulsenotes-personal.zip SQLite
Déployer un service administré Globale pulsenotes-global.zip MySQL ou PostgreSQL
Edition Usage Mot de passe UVSQ
Globale Plusieurs étudiants, sessions séparées Jamais enregistré
Personnelle Un seul étudiant, accès local par PIN, schéma ou mot de passe Chiffré sur l’installation privée

Les deux éditions partagent le même frontend React et le même coeur PHP. Leur point d’entrée impose le mode de déploiement afin d’éviter toute configuration ambiguë.

Fonctionnalités

  • synthèse par semestre, année ou parcours complet;
  • notes par module ou en liste filtrable;
  • rangs, min/moyenne/max et distributions chargés à la demande;
  • détection des notes nouvelles ou modifiées;
  • analyses par UE, module et période;
  • bulletins officiels et exports PDF PulseNotes;
  • liens publics révocables pour présenter une note unique en installation personnelle;
  • navigation clavier, accessibilité et interface mobile dédiée.
  • mises à jour stables déclenchées naturellement par l’application, sans tâche cron.

Démarrage local

Prérequis: Node.js 20.19 ou supérieur, npm, WSL, PHP 8.1 ou supérieur et Docker Desktop pour le mode global.

rundev-global.bat
rundev-individuel.bat

rundev-global.bat démarre Docker et le conteneur MySQL dédié. rundev-individuel.bat utilise SQLite localement. rundev.bat affiche un menu permettant de choisir le mode au lancement.

Service Adresse
Application http://localhost:5173
API locale http://127.0.0.1:8787
Mode démonstration http://localhost:5173/?demo=1

Construire les distributions

build-release.bat

Les livrables sont générés directement dans output/.

output/
├── global/
├── personal/
├── install-personal-o2switch.sh
├── pulsenotes-global.zip
├── pulsenotes-global.zip.sha256
├── pulsenotes-personal.zip
└── pulsenotes-personal.zip.sha256

Chaque push sur main exécute les tests et construit les livrables. Si la version de src/package.json diffère de la dernière release stable, le workflow publie automatiquement la release vX.Y.Z. Sinon, il termine sans créer de release parasite. Les tags v* explicites publient également une release versionnée.

Documentation

Guide Contenu
Centre de documentation Index de tous les guides
Installation Déploiement global, personnel et o2switch
Développement Environnement, commandes et structure
Architecture Flux applicatifs et séparation des éditions
Fonctionnalités Produit, pages, PDF et partage
Données Sources, calculs et valeurs absentes
Sécurité Sessions, chiffrement, rétention et partages
Interface Responsive, accessibilité et composants
Livraison Contrôles et génération des archives
Référence API Routes et paramètres du proxy PHP

Le Wiki GitHub sert de porte d’entrée courte et renvoie vers ces documents maintenus dans le dépôt.

Statut

PulseNotes est en développement actif. Avant un déploiement public, utilisez un compte UVSQ de test, configurez HTTPS et appliquez la checklist de livraison.

About

Interface sécurisée pour consulter et analyser ses résultats UVSQ

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages