docs: rewrite French README/DOCUMENTATION/cli README, drop internal CM1.x jargon

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-07-18 00:14:32 +02:00
parent a4f0e26263
commit 246f42c25a
3 changed files with 10 additions and 10 deletions

View File

@@ -104,7 +104,7 @@ Chaque **arête** du graphe porte trois inconnues :
| 1 | P | Pa |
| 2 | h | J/kg |
Sur une branche série (1 entrée / 1 sortie), les arêtes partagent souvent le **même ** (topologie CM1.4) : le solveur réduit alors le nombre dinconnues de débit.
Sur une branche série (un composant à une entrée et une sortie), les arêtes partagent généralement le **même débit** ṁ : le solveur fusionne alors ces inconnues et réduit dautant la taille du système.
### Degrés de liberté (DoF)
@@ -140,7 +140,7 @@ Tolérance typique : `1e-6`. Nombre ditérations CLI : souvent `300` (augment
### Boucle Newton (schéma)
```text
1. Seed initial (frontières + staging HP/BP si emergent_pressure)
1. Estimation initiale (frontières + pressions haute/basse initialisées par étages si `emergent_pressure`)
2. Calculer r(x) = résidus de tous les composants
3. Assembler J(x) = ∂r/∂x
4. Résoudre J·Δx = r
@@ -152,7 +152,7 @@ Tolérance typique : `1e-6`. Nombre ditérations CLI : souvent `300` (augment
- Pas de dynamique temporelle (régime permanent).
- Pas de CFD : les HX sont des modèles 0D/1D (LMTD, ε-NTU, corrélations).
- Les propriétés fluides viennent du **backend** (CoolProp…), pas dhypothèses hardcodées (politique « zero fallback » côté composants sérieux).
- Les propriétés fluides proviennent toujours du **backend** (CoolProp…), jamais de valeurs codées en dur : un composant sérieux ne fabrique pas de propriété de secours.
---
@@ -332,7 +332,7 @@ cargo run -p entropyk-cli -- schema -o model-ir.schema.json
2. Pour chaque composant : `create_component(...)` (CoolProp, params, modes orifice / emergent…)
3. Ajout des arêtes nommées `nom:port`
4. `finalize()` + contrôle DoF
5. Seed (frontières + staging HP/BP)
5. Estimation initiale (frontières + pressions haute/basse par étages)
6. Solve selon `solver.strategy`
7. Sérialisation JSON : états darêtes, performances, `dof`, `failure_diagnostics` si échec
@@ -576,7 +576,7 @@ Répertoire : `crates/cli/examples/`.
## 15. Conventions de développement
- **Langage code** : Rust, `Result` partout (politique zero-panic en production).
- **Langage** : Rust, `Result<T, E>` partout — pas de `panic!` en production.
- **Jacobiens** : analytiques exacts ; pas de différences finies sauf chemin explicitement documenté / temporaire.
- **Types** : newtypes SI (`Pressure`, `Enthalpy`…) — pas de `f64` nus aux frontières publiques.
- **Docs techniques / commits** : anglais ; communication projet possible en français.