revivalsoft/gestpers repository overview

⁠GestPers — Installation

⁠Prérequis

• Docker Desktop⁠ installé et démarré
• C'est tout !

⁠Installation en 3 étapes

⁠1. Créez un fichier docker-compose.yml

Créez un dossier vide sur votre machine (ex: gestpers/), puis créez-y un fichier docker-compose.yml avec le contenu suivant :

services:
  app:
    image: revivalsoft/gestpers:v4
    ports:
      - "8090:80"
    environment:
      APP_ENV: prod
      APP_SECRET: changeme_generate_a_real_secret
      DATABASE_URL: "mysql://gestpers:secret@db:3306/gestpers?serverVersion=10.11.2-MariaDB&charset=utf8mb4"
      # Optionnel : IA sur les plannings (Google Gemini, gratuit, sans CB)
      # Obtenez une clé sur https://aistudio.google.com → Get API key → Create API key in new project
      # GEMINI_API_KEY: AIzaSy-votre-clé-ici
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: mariadb:11
    environment:
      MYSQL_DATABASE: gestpers
      MYSQL_USER: gestpers
      MYSQL_PASSWORD: secret
      MYSQL_ROOT_PASSWORD: rootsecret
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 5s
      timeout: 5s
      retries: 10
    restart: unless-stopped

volumes:
  db_data:

⁠2. Lancez l'application

Dans le dossier contenant votre docker-compose.yml :

docker compose up -d

Docker télécharge automatiquement l'image et démarre l'application.

⁠3. Ouvrez votre navigateur

http://localhost:8090⁠

⁠Mise à jour vers une nouvelle version

docker compose pull
docker compose up -d

Les migrations sont appliquées automatiquement au redémarrage.

⁠Commandes utiles

⁠⚠️ Sauvegarde des données

Vos données sont stockées dans un volume Docker nommé db_data.

Pour sauvegarder :

docker compose exec db mariadb-dump -u gestpers -psecret gestpers > sauvegarde.sql

Pour restaurer :

docker compose exec -T db mariadb -u gestpers -psecret gestpers < sauvegarde.sql

⁠Requête IA sur les plannings (optionnel)

GestPers intègre une interface de questions en langage naturel sur vos plannings, alimentée par Google Gemini (gratuit, sans carte bancaire).

⁠1. Obtenir une clé API Gemini

Rendez-vous sur aistudio.google.com⁠, connectez-vous avec un compte Google, puis cliquez sur Get API key → Create API key in new project. La clé commence par AIza….

⁠2. Configurer GestPers

Dans votre docker-compose.yml, décommentez et renseignez la ligne GEMINI_API_KEY :

      GEMINI_API_KEY: AIzaSy-votre-clé-ici

Puis redémarrez :

docker compose up -d

⁠Fonctionnement

• GestPers interroge automatiquement la liste des modèles disponibles pour votre clé et choisit le plus adapté.
• Si un modèle est indisponible, le suivant est essayé automatiquement.
• La fonctionnalité est accessible aux managers et administrateurs via le menu Requête IA.

⁠Changer le port

Si le port 8090 est occupé, éditez docker-compose.yml :

ports:
  - "8091:80"   # remplacez 8091 par un port libre

Puis relancez :

docker compose up -d