Lesstime/docs/deploy.md

Deploiement sur serveur Ubuntu (sans Docker)

Prerequis

• Ubuntu 22.04+ avec PHP 8.4, Node 24, PostgreSQL 16, Nginx
• Acces root ou sudo sur le serveur

1. Preparer la BDD

sudo -u postgres createuser lesstime
sudo -u postgres createdb -O lesstime lesstime
sudo -u postgres psql -c "ALTER USER lesstime WITH PASSWORD 'ton-mdp';"

2. Creer les dossiers

sudo mkdir -p /var/www/lesstime/var/log /var/www/lesstime/var/cache /var/www/lesstime/config/jwt
sudo chown -R www-data:www-data /var/www/lesstime

3. Configurer l'environnement

sudo nano /var/www/lesstime/.env

Contenu minimal :

APP_ENV=prod

sudo nano /var/www/lesstime/.env.local

Contenu :

APP_ENV=prod
APP_SECRET=<random-hex-32>
APP_DEBUG=0

DEFAULT_URI=http://project.malio-dev.fr/
CORS_ALLOW_ORIGIN='^https?://project\.malio-dev\.fr$'

DATABASE_URL="postgresql://lesstime:<mdp>@localhost:5432/lesstime?serverVersion=16&charset=utf8"

JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
JWT_PASSPHRASE=<passphrase>
JWT_COOKIE_SECURE=0
JWT_TOKEN_TTL=86400
JWT_COOKIE_TTL=86400

ENCRYPTION_KEY=<random-hex-32>

JWT_COOKIE_SECURE=0 car HTTP. Passer a 1 si HTTPS.

4. Installer le script de deploy

sudo cp script/deploy-release.sh /usr/local/bin/deploy-lesstime
sudo chmod +x /usr/local/bin/deploy-lesstime

Si le repo Gitea est prive, configurer un token :

echo "ton-token-gitea" | sudo tee /etc/lesstime-release-token
sudo chmod 600 /etc/lesstime-release-token

5. Deployer une release

sudo /usr/local/bin/deploy-lesstime v0.2.0

Le script telecharge l'artefact, extrait les fichiers, clear le cache et lance les migrations.

6. Generer les cles JWT

cd /var/www/lesstime
sudo -u www-data php bin/console lexik:jwt:generate-keypair --skip-if-exists --env=prod

7. Configurer Nginx

sudo cp deploy/nginx/lesstime.conf /etc/nginx/sites-available/lesstime
sudo ln -sf /etc/nginx/sites-available/lesstime /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

8. Creer le premier user admin

Hasher un mot de passe :

php /var/www/lesstime/bin/console security:hash-password --env=prod

Choisir App\Entity\User, taper le mdp, copier le hash. Puis :

sudo -u postgres psql lesstime -c "INSERT INTO \"user\" (username, roles, password, created_at) VALUES ('admin', '[\"ROLE_ADMIN\"]', '<le-hash>', NOW());"

9. Tester

curl http://project.malio-dev.fr/api/version
curl http://project.malio-dev.fr/

---

Connecter le serveur MCP a Claude Code

Le serveur MCP expose 22 tools (projets, taches, time tracking avec liaison tickets client, metadonnees) via le endpoint HTTP /_mcp.

1. Generer un token API

Sur le serveur (ou en local via Docker) :

# Production (serveur)
php /var/www/lesstime/bin/console app:generate-api-token admin --env=prod

# Dev (Docker)
docker exec -it php-lesstime-fpm php bin/console app:generate-api-token admin

La commande affiche un token de 64 caracteres. Ce token est lie a l'utilisateur et stocke en base (champ apiToken de l'entite User).

2. Configurer Claude Code

Transport HTTP (recommande pour la prod)

Creer ou modifier .mcp.json a la racine du projet :

{
    "mcpServers": {
        "lesstime": {
            "type": "http",
            "url": "http://project.malio-dev.fr/_mcp",
            "headers": {
                "Authorization": "Bearer <ton-token>"
            }
        }
    }
}

Transport STDIO (dev local via Docker)

{
    "mcpServers": {
        "lesstime-local": {
            "command": "docker",
            "args": [
                "exec",
                "-i",
                "php-lesstime-fpm",
                "php",
                "bin/console",
                "mcp:server"
            ]
        }
    }
}

Transport STDIO via SSH (prod sans endpoint HTTP)

{
    "mcpServers": {
        "lesstime": {
            "command": "ssh",
            "args": [
                "user@serveur",
                "php",
                "/var/www/lesstime/bin/console",
                "mcp:server",
                "--env=prod"
            ]
        }
    }
}

3. Redemarrer Claude Code

Apres modification de .mcp.json, relancer Claude Code pour qu'il detecte le serveur.

4. Verifier

Demander a Claude d'utiliser un outil MCP, par exemple :

• "Liste les projets sur Lesstime"
• "Cree une tache dans le projet LT"

Tools disponibles

Domaine	Tools
Projets	list-projects, get-project, create-project, update-project
Taches	list-tasks, get-task, create-task, update-task, delete-task
Metadonnees	list-statuses, list-priorities, list-efforts, list-tags, list-groups, create-group, update-group
Time tracking	list-time-entries, create-time-entry, update-time-entry, delete-time-entry (supporte clientTicketId)
Reference	list-users, list-clients