Aller au contenu

La pile technique et les outils à installer

Ce dont Ironlane est fait, et ce qu'il faut installer sur son ordinateur pour y travailler.

Voir en Markdown

Cette page répond à deux questions : de quoi Ironlane est fait, et que faut-il installer sur son poste pour y travailler. Pour installer une instance sur un serveur, voir Installer Ironlane chez soi. Pour préparer Claude Code, voir le kit de développement.

Besoin Outil Pourquoi
Application web Next.js (App Router), React, TypeScript Rendu côté serveur, actions serveur, un seul langage
Base de données PostgreSQL seul : règles d’accès, droits et comptes vivent dans la base ; connexion dans l’application ; fichiers sur disque Les règles et les droits vivent dans la base
Styles Tailwind CSS Un vocabulaire commun et une échelle fermée
Paquets pnpm, jamais npm Magasin partagé, pas de fichier de verrouillage parasite
Mise en forme et analyse Prettier, ESLint, Ruff (Python) Tenues au commit et dans l’intégration continue
Code mort Knip Refuse l’export que rien n’importe
Tests unitaires Le lanceur de tests de Node Un seul lanceur
Tests de bout en bout Playwright Sur une copie locale, jamais sur la production
Outils d’import et de contrôle Python 3 Contrôles de la base, rejeu des fonctions
Hébergement Un serveur Linux avec Docker, installable en une commande Un seul serveur à tenir
Agents Claude Code Voir le kit

Les versions exactes sont dans le fichier package.json du dépôt (le champ packageManager fixe celle de pnpm). Pour une version majeure récente d’un cadre, on lit la documentation livrée avec le paquet : elle n’est pas celle que connaît un modèle d’intelligence artificielle.

Pour travailler sur le code, en local :

À installer À quoi cela sert Remarque
Git Récupérer le code, commiter
Node.js (20 ou plus) Lancer l’application et les outils La version exacte suit package.json
pnpm Installer les dépendances Jamais npm. Les paquets se gèrent par pnpm
Python 3 Contrôles de la base, outils d’import Installé dans un environnement .venv du dépôt
Docker (ou OrbStack) Faire tourner la base locale Nécessaire ; environ 2 Go d’images la première fois
Un éditeur de code Lire et écrire Au choix
Claude Code Travailler avec l’agent et le kit Facultatif si vous écrivez seul

Le kit de développement vérifie ce qui manque avec la commande node scripts/kit/start.mjs --check : elle ne change rien et liste les manques.

Facultatif :

  • Une clé d’API pour le robot (lecture de pièces, incohérences). Sans elle, le robot n’est pas branché et l’écran le dit.
  • Un relais de courriel pour les notifications.
  • Une clé d’API de calcul d’itinéraires pour les tournées par la route. Sans elle, les tournées se calculent à vol d’oiseau.
Fenêtre de terminal
pnpm install # installer les dépendances et les crochets git
pnpm dev # lancer l'application en local (http://localhost:3210)
pnpm lint # analyse du code
pnpm exec tsc --noEmit # vérification des types
pnpm unit # tests unitaires
python3 scripts/controler-la-base.py # contrôles de la base

Un commit relance automatiquement la mise en forme, l’analyse et la détection de doublons sur les fichiers touchés.

  • Pas de npm : un fichier de verrouillage de npm casse le magasin partagé de pnpm.
  • Pas de paquet nouveau sans discussion. Un paquet s’ajoute après accord, en disant ce qu’il fait que le projet ne sait pas déjà faire.
  • Pas de base distante pour développer. Une base locale suffit et c’est la seule que le kit utilise.