La pile technique et les outils à installer
Ce dont Ironlane est fait, et ce qu'il faut installer sur son ordinateur pour y travailler.
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.
Ce dont Ironlane est fait
Section intitulée « Ce dont Ironlane est fait »| 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.
Ce qu’il faut installer sur son poste
Section intitulée « Ce qu’il faut installer sur son poste »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.
Les commandes de tous les jours
Section intitulée « Les commandes de tous les jours »pnpm install # installer les dépendances et les crochets gitpnpm dev # lancer l'application en local (http://localhost:3210)pnpm lint # analyse du codepnpm exec tsc --noEmit # vérification des typespnpm unit # tests unitairespython3 scripts/controler-la-base.py # contrôles de la baseUn commit relance automatiquement la mise en forme, l’analyse et la détection de doublons sur les fichiers touchés.
Ce qu’on n’installe pas
Section intitulée « Ce qu’on n’installe pas »- 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.