Documentation du projet

Minutrel — V0.1

Documentation de référence issue du projet Minutrel 0.1.0.

Documentation de la version 0.1.0Documentation Markdown ↓

Le temps de vos projets, ensemble. Application libre AGPL-3.0-or-later, autohébergée, pour suivre le travail d’une équipe depuis le navigateur ou un client macOS, Windows et Linux.

La V0.1 propose un client ordinateur autonome, utilisable sans serveur ni compte en ligne, et un espace d’équipe autohébergé partagé avec le web. Comptes et rôles, projets, chronomètres, travail hors connexion avec file d’envoi, saisies manuelles, notes, rapports CSV/PDF/ZIP, API, webhook entrant et MCP sont inclus. L’interface est disponible en français, anglais et allemand.

Les clients utilisent Tauri et la WebView du système. Le serveur commun conserve les données d’équipe dans SQLite. L’espace personnel et la file locale restent sur l’ordinateur ; la connexion à l’équipe est facultative.

Guides illustrés : Français · English · Deutsch.

Découvrir Minutrel en vidéo

Présentation de Minutrel en anglais

Présentation · Fonctionnement et premiers pas · Playlist YouTube

Les 12 vidéos en anglais, avec voix, musique originale et sous-titres, sont répertoriées dans la vidéothèque et son English catalog. Les douze vidéos sont publiques sur YouTube ; les guides assistants et autohébergement proposent aussi un téléchargement MP4. Les exemples utilisent des données fictives de la préversion V0.1.

Essayer en local

Installer Node.js 24 (version verrouillée dans .nvmrc), puis :

sh
npm ci --ignore-scripts
npm run demo

Ouvrir http://127.0.0.1:8080. Les identifiants aléatoires de la démonstration sont dans .cache/demo/access.json. Les données sont fictives et isolées dans .cache/demo/. Aucun service IA n’est sollicité. Arrêter avec Ctrl+C.

Créer votre propre espace

sh
npm ci --ignore-scripts
npm run build
npm start

Ouvrir http://127.0.0.1:8081, puis créer le premier administrateur avec le secret du fichier data/setup-token. Il n’y a pas de mot de passe par défaut. La base et la clé de chiffrement restent dans data/.

L’administrateur crée les membres et attribue leurs rôles ; le responsable gère les projets et leurs affectations. Tous les appareils se connectent à cette même instance.

Autohébergement avec Docker

sh
docker compose up -d --build
docker compose exec minutrel cat /app/data/setup-token

Ouvrir http://127.0.0.1:8080. La configuration par défaut expose le service uniquement sur la machine hôte. Pour votre équipe, configurer une adresse HTTPS et le proxy selon le guide d’autohébergement. Les données sont persistées dans un volume Docker.

Application ordinateur

Configurer l’adresse du serveur de l’équipe à la connexion. Le compte, les projets, les temps et les droits sont les mêmes que sur le web.

Pour travailler seul sans serveur, choisir Utiliser sur cet ordinateur. Créer vos projets, chronométrer, noter le travail et exporter directement. Pour rejoindre ensuite une équipe, choisir Ouvrir un espace d’équipe ; le transfert des temps personnels demande une correspondance explicite de projets.

Un compte d’équipe peut aussi travailler temporairement hors connexion sur ordinateur après une première connexion. Les commandes de temps et les nouvelles saisies sont écrites localement avant envoi, puis les droits et conflits sont contrôlés sur le serveur. Voir les modes et la synchronisation.

Le bouton Mini chrono et l’icône de barre de menus ouvrent un widget déplaçable au-dessus des fenêtres ordinaires : choisir un projet Minutrel, démarrer, mettre en pause, reprendre, terminer. Aucun dossier de l’ordinateur n’est demandé. Raccourci proposé : Ctrl/Cmd + Alt + M, si le système le permet.

Pour construire l’installateur sur la plateforme courante, installer les prérequis Tauri, Rust via rustup, puis :

sh
npm run build:desktop

Le script produit un .dmg sur macOS, un installateur NSIS sur Windows ou un .deb sur Linux dans apps/desktop/src-tauri/target/. Les paquets V0.1 sont des paquets de test non signés. La CI prépare les trois plateformes.

Travail et assistants IA

  • Le fil du travail : notes privées ou partagées et comptes rendus mensuels à valider.
  • Les connexions : créer un jeton MCP personnel à durée limitée pour Codex ou Claude Code. Les commandes du chronomètre exigent un droit supplémentaire explicite.
  • Ollama / vLLM / Claude : un administrateur peut configurer un moteur de rédaction facultatif. Chaque génération demande l’accord du membre pour envoyer ses descriptions et notes. Aucun modèle n’est embarqué dans les clients.
  • Les rapports : les administrateurs sélectionnent le mois et les salariés, puis téléchargent CSV, PDF ou ZIP. Les chiffres proviennent des temps finalisés ; un texte IA ne peut pas changer les durées.

Les modèles réels et leurs identifiants sont à configurer sur votre infrastructure. Les adaptateurs ont des tests de protocole ; aucun abonnement ni modèle payant n’est fourni.

Vérifications et sauvegardes

sh
npm run check
python3 scripts/check_repository.py
python3 scripts/check_brand.py
npm run backup

La sauvegarde serveur inclut une copie SQLite cohérente et la clé nécessaire à la restauration. Voir la procédure. Le client permet aussi l’export de sa copie locale ; sauvegarder son dossier de configuration complet. Les invitations par lien et l’import général d’un espace JSON restent au backlog.

Repères du dépôt

DossierContenu
apps/webPoint d’entrée du navigateur et configuration Vite
apps/desktopClient natif Tauri, trousseau, widget et barre de menus
apps/apiAPI, authentification, SQLite, rapports et intégrations
packages/domainCalcul des durées et calendrier des rapports
packages/contractsTypes des échanges
packages/uiInterface React FR/EN/DE, stockage local et file de synchronisation
brandLogos, icônes, polices libres, couleurs et charte
infra, .githubDéploiement, sauvegardes et intégration continue
site-presentationSite vitrine et documentation en français et en anglais
videoSources de la vidéo de présentation

Cahier des charges · État précis de la V0.1 · Architecture · API · Recette · Préparer GitHub · Vérification préliminaire du nom · Charte de marque.

API et webhook de notes privées · Avant publication.

Code : AGPL-3.0-or-later. Les polices Manrope conservent leur licence SIL OFL ; voir LICENSING.md. Lors de l’exploitation d’une version modifiée en réseau, fournir aux utilisateurs le code source correspondant selon la licence.

Ctrl/Cmd + K pour ouvrir · Échap pour fermer · La recherche reste sur ce site.