# KJP Port Simulator

KJP Port Simulator réunit deux outils complémentaires :

- `simulateur-port.html`, un simulateur pédagogique de manœuvre au moteur pour voilier habitable ;
- `generateur-port.html`, un éditeur cartographique permettant de créer et modifier des ports au format communautaire KJP.

Les deux livrables sont des fichiers HTML autonomes. Le simulateur fonctionne hors ligne. Le générateur reste utilisable localement, mais la recherche de lieux et les fonds cartographiques nécessitent une connexion Internet.

![Vue générale du simulateur](docs/images/01-navigation-generale.jpg)

## Essayer immédiatement
https://arnaud2moissac.github.io/KJP_Port_Simulator/simulateur-port.html

ou
1. Téléchargez ou clonez le dépôt.
2. Ouvrez `simulateur-port.html` dans un navigateur récent.
3. Choisissez une situation ou un défi, larguez les amarres si nécessaire, puis manœuvrez avec les flèches ou les commandes tactiles.

Le [guide utilisateur](docs/guide-utilisateur.md) présente la prise en main, les aussières, les pendilles méditerranéennes et les principes du moteur physique sans répéter toute l'interface.

Pour créer un port, ouvrez `generateur-port.html`, dessinez ou analysez une zone OpenStreetMap, définissez son entrée, puis exportez un fichier `.kjp`. La structure du format est décrite dans [ports/KJP.md](ports/KJP.md).

https://arnaud2moissac.github.io/KJP_Port_Simulator/generateur-port.html


## Développer

Prérequis : Node.js 20 ou plus récent.

```bash
npm ci
npm run build:simulator
npm run build:port-generator
npm run verify:release
```

Les fichiers HTML à la racine sont générés. Les modifications se font dans `src/`, puis sont intégrées par les scripts de build. Consultez [CONTRIBUTING.md](CONTRIBUTING.md) avant de proposer une évolution.

## Versions de la release 2.0

- date de publication : 23 septembre 2026 ;
- produit : `2.0.0` ;
- moteur physique : `5.5.0` ;
- profil pédagogique Sun Odyssey 36i : `5.6.0` ;
- générateur et schéma KJP courant : `1.1.0` et schéma `3`.

La version 2.0 utilise le renderer Three.js natif comme chemin graphique principal,
avec un secours Canvas 2D direct, et conserve un livrable HTML autonome utilisable
hors ligne. Elle intègre également le guide utilisateur illustré et le port de
La Trinité-sur-Mer actualisé.

Ces numéros évoluent séparément : une amélioration scientifique du moteur ne change pas nécessairement le format des ports.
Le [rapport de recalibration aérodynamique](docs/validation/rapport-recalibration-aerodynamique.md)
documente les lois, les hypothèses et les contrôles de la version physique courante.

## Licence et prudence

Le projet est distribué sous [licence Apache 2.0](LICENSE). Il s'agit d'un outil pédagogique, pas d'un simulateur certifié ni d'un substitut à l'entraînement avec un moniteur et un équipage réel.

## Contributeurs

- Arnaud de Moissac : kjp.bzh@gmail.com