# 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](/code-ouvert/installation/). Pour préparer Claude Code, voir [le kit de développement](/code-ouvert/kit/).

## Ce dont Ironlane est fait

:::caution[En cours de construction]
Ironlane devient une application Next.js sur PostgreSQL seul, installable en une commande (une image Docker, un fichier `docker-compose`, un fichier d'exemple de variables). Cette page décrit cette cible. Le dépôt actuel utilise encore d'autres composants pour la connexion, les fichiers et l'hébergement ; ils disparaissent au fil de la construction.
:::

| 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](/code-ouvert/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

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

```bash
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.

## 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.

## Voir aussi

- [Installer Ironlane chez soi](/code-ouvert/installation/)
- [Démarrer avec le kit de développement](/code-ouvert/kit/)
- [Contribuer](/code-ouvert/contribuer/)
- [Les tests et les contrôles](/ingenierie/tests/)
