Prérequis

Avant d'installer TimePick, assurez-vous de disposer des éléments ci-dessous. Cette fiche ne couvre pas l'installation elle-même : elle liste seulement ce qu'il faut avoir en place au préalable, pour un poste de développement comme pour une instance de production.

Prérequis communs

• git — nécessaire pour cloner le dépôt du projet.
• Accès réseau — pour cloner le dépôt (GitHub) et télécharger les dépendances npm.

Installation locale (développement)

Node.js

• Version ≥ 20.19 ou ≥ 22.12.
• La version 22.x LTS est recommandée : c'est celle utilisée en production.

PostgreSQL

• Version 16 minimum.
• La version 17 est recommandée : c'est celle utilisée en production.

INFO

Pourquoi PostgreSQL 16 au minimum ? C'est la version minimale supportée par le projet : les statistiques du tableau de bord s'appuient notamment sur une forme récente de la fonction de date date_trunc (avec fuseau horaire), absente des versions anciennes de PostgreSQL. Avec une version non supportée, les statistiques du tableau de bord ne fonctionneront pas correctement.

Droits PostgreSQL requis

L'initialisation de la base de données crée l'extension uuid-ossp (utilisée pour générer les identifiants uniques de l'application).

WARNING

Selon votre installation PostgreSQL, la création de l'extension uuid-ossp peut nécessiter des droits superuser. Si l'initialisation échoue avec une erreur du type « permission denied to create extension », accordez le droit SUPERUSER à l'utilisateur PostgreSQL utilisé, ou faites pré-installer l'extension par un administrateur de la base.

Un privilège supplémentaire, CREATEDB, est nécessaire uniquement pour exécuter la suite de tests automatisés du projet. Il s'agit d'un besoin réservé aux personnes qui développent ou contribuent au code — pas aux opérateurs qui installent ou exploitent une instance TimePick.

MailHog (optionnel, développement uniquement)

MailHog intercepte localement les emails envoyés par l'application sans les délivrer réellement à leurs destinataires. Il permet de consulter le contenu des emails (liens de connexion, notifications…) depuis une interface web, pratique en développement quand aucun serveur SMTP réel n'est configuré.

MailHog n'a aucune utilité en production : voir la fiche Fournisseurs SMTP pour la configuration d'un vrai serveur d'envoi.

Installation en production

Pour un déploiement en production, TimePick fournit une image Docker construite en plusieurs étapes (« multi-stage build »), qui embarque la compilation du frontend et du backend. Il n'est pas nécessaire d'installer Node.js ou PostgreSQL manuellement sur le serveur de production : Docker et une base PostgreSQL 17 accessible suffisent.

Voir les fiches Installation en production (Docker) et Déploiement sur Coolify / VPS pour le détail.

Étape suivante

Une fois ces prérequis réunis, passez à la fiche Installation locale.