English: the app (server/, analysis.py, routes and JSON fields), instructions/analyst.md, docs; the table of shared renames
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
1d80a77cb1
commit
a3e6ade845
24 files changed
+1959
-1835
No files matched your search
@@ -0,0 +1,142 @@
|
||||
# English translation and renames: the shared names
|
||||
|
||||
2026-11-16. Decided by the user: everything in the seven repositories of the architecture (`docs/architecture.drawio`) goes to English, the labels of `labeling/auto` included, and French file names and identifiers are renamed. This table fixes every name that crosses a file or a repository boundary; inside a file, translate freely but consistently. Conversations with the user stay in French; the repositories are in English.
|
||||
|
||||
## Rules for every translator
|
||||
|
||||
- Text (docs, prompts, comments, docstrings, program output, UI, label descriptions): English, same meaning, same structure, nothing added or dropped. Keep proper nouns, sensor names (PR04, CTR03), station names, label ids (NORDEND-243), family keys, numbers, units, dates and date formats exactly as they are.
|
||||
- The evidence vocabulary stays as it is: `confirmed`, `strongly supported`, `consistent with`, `possible`, `insufficient evidence`, `not observed`.
|
||||
- History references (D-119, E-004, "wf-improve session X, mod. 1, S2", commit hashes) stay as they are.
|
||||
- Frozen, not translated (a README in each may be translated): `Optimizer/archive/**`, `labeling/docs/archive/**`, `Diagnostic-App/docs/superpowers/**` (plans and specs are history), `labeling/manual/*.jsonl` descriptions (the user's own; only their keys are migrated).
|
||||
- Never touch `.env`; never copy metric identifiers (`SIM_CCID`, `ip*`).
|
||||
- Do not commit: the orchestrator commits each repository after the integration checks.
|
||||
|
||||
## 1. Label files (`labeling/auto/*.jsonl`, `labeling/manual/*.jsonl`, an analysis' `labels.jsonl`)
|
||||
|
||||
| French key | English key |
|
||||
|---|---|
|
||||
| `id` | `id` |
|
||||
| `debut` | `start` |
|
||||
| `fin` | `end` |
|
||||
| `categorie` | `family` |
|
||||
| `description` | `description` |
|
||||
| `revue` | `review` |
|
||||
| `analyse` | `analysis` |
|
||||
|
||||
Family values do not change (`Visibility`, `Obstruction`, `Target issue`, `Thermal displacement`, `No data`, `Displacement`). New labels are written in English.
|
||||
|
||||
## 2. labeling
|
||||
|
||||
| Before | After |
|
||||
|---|---|
|
||||
| `familles.md` | `families.md` (its table column « Pour le client » → "For the client") |
|
||||
| `regles-d-etiquetage.md` | `labeling-rules.md` |
|
||||
| `carte-des-etiquettes.md` | `label-map.md` |
|
||||
| `connaissances/` | `knowledge/` |
|
||||
| `connaissances/cas-annotes-par-l-expert.md` | `knowledge/expert-annotated-cases.md` |
|
||||
| `connaissances/chaine-de-mesure.md` | `knowledge/measurement-chain.md` |
|
||||
| `connaissances/colonnes-des-deplacements.md` | `knowledge/displacement-columns.md` |
|
||||
| `connaissances/cycle-thermique.md` | `knowledge/thermal-cycle.md` |
|
||||
| `connaissances/images-de-la-camera.md` | `knowledge/camera-images.md` |
|
||||
| `connaissances/incident-de-barcelone.md` | `knowledge/barcelona-incident.md` |
|
||||
| `connaissances/les-trous.md` | `knowledge/gaps.md` |
|
||||
| `connaissances/metriques-de-qualite.md` | `knowledge/quality-metrics.md` |
|
||||
| `controle.py` | `validate.py` |
|
||||
| `ids.py`, `precedents.py` | unchanged names |
|
||||
| `precedents.py --exclure`, `--famille` | `--exclude`, `--family` (`--k`, `--index`, `--check` unchanged) |
|
||||
|
||||
Provenance strings of `precedents.py`: `auto, reviewed on <date>`, `auto, not reviewed (analysis <name>)`.
|
||||
|
||||
## 3. An analysis folder (`labeling/auto/analyses/<STATION>_<start>_<end>/`)
|
||||
|
||||
| Before | After |
|
||||
|---|---|
|
||||
| `demande.json` (keys `station`, `debut`, `fin`, `indices`) | `request.json` (keys `station`, `start`, `end`, `hints`) |
|
||||
| `etiquettes.jsonl` | `labels.jsonl` |
|
||||
| `analyse.md` | `analysis.md` |
|
||||
| `rapport.md` | `report.md` |
|
||||
| `outils/` (the analyst's scripts) | `scripts/` |
|
||||
| `outils.md` (the tool-builder's report) | `tools.md` |
|
||||
| `travail/` | `work/` |
|
||||
| `travail/journal.jsonl` | `work/log.jsonl` |
|
||||
| `travail/session` | `work/session` |
|
||||
| `travail/versees.jsonl` | `work/submitted.jsonl` |
|
||||
| `travail/optimisation.jsonl` | `work/optimization.jsonl` |
|
||||
|
||||
Figures keep their file names unless the report translator renames them and fixes every link to them.
|
||||
|
||||
## 4. tools (`~/tools`)
|
||||
|
||||
Files (`scripts/`): `donnees.py` → `data.py`, `inventaire.py` → `inventory.py`, `resume.py` → `summary.py`, `plages.py` → `ranges.py`, `jours.py` → `days.py`, `ensemble.py` → `overview.py`, `metriques.py` → `metrics.py`, `qualite.py` → `quality.py`, `stations.py` → `stations.py`, `graphique.py` → `plot.py`, `vignettes.py` → `thumbnails.py`, `gif.py` → `gif.py`. `GUIDE.md` keeps its name.
|
||||
|
||||
Names imported from another file (exactly these):
|
||||
|
||||
| Module | Before → after |
|
||||
|---|---|
|
||||
| `data` (ex `donnees`) | `charger` → `load`, `charger_camera` → `load_camera`, `charger_temperature` → `load_temperature`, `charger_metriques` → `load_metrics`, `est_reference` → `is_reference`, `rejetee` → `rejected`, `filtrer` → `filter_window`, `instant` → `parse_time`, `iso` → `iso`, `heure_image` → `image_time`, `trouver` → `find_files`, `POSE` → `POSE` |
|
||||
| `plot` (ex `graphique`) | `borne` → `bound`, `COLONNES` → `COLUMNS` |
|
||||
| `summary` (ex `resume`) | `QUALITE` → `QUALITY`, `ARRONDI` → `ROUNDING`, `bruit_propre` → `own_noise`, `duree` → `duration`, `STATS` → `STATS`, `COLONNES` → `COLUMNS` |
|
||||
| `inventory` (ex `inventaire`) | `METRIQUE_RE` → `METRIC_RE` |
|
||||
| `metrics` (ex `metriques`) | `cibles` → `targets`, `coupe` → `cut`, `suites` → `runs` |
|
||||
|
||||
The app (`Diagnostic-App/app/server/station.py`) imports `data` and uses `load`, `load_camera`, `image_time`, `parse_time`, `iso`.
|
||||
|
||||
Command-line options:
|
||||
|
||||
| Before | After | Before | After |
|
||||
|---|---|---|---|
|
||||
| `--autres` | `--others` | `--marge` | `--margin` |
|
||||
| `--bords` | `--edges` | `--marque` | `--mark` |
|
||||
| `--bornes` | `--bounds` | `--metriques` | `--metrics` |
|
||||
| `--calme` | `--calm` | `--metriques-seules` | `--metrics-only` |
|
||||
| `--capteurs` | `--sensors` | `--min-mesures` | `--min-measurements` |
|
||||
| `--colonne` | `--column` | `--niveau periode\|fenetre` | `--level period\|window` |
|
||||
| `--colonnes` | `--columns` | `--noms` | `--names` |
|
||||
| `--commun` | `--common` | `--nuit` | `--night` |
|
||||
| `--contraste` | `--contrast` | `--numeros` | `--numbers` |
|
||||
| `--contre` | `--against` | `--pas` | `--step` |
|
||||
| `--debut` | `--start` | `--rayon` | `--radius` |
|
||||
| `--duree` | `--duration` | `--residus …\|non` | `--residuals …\|no` |
|
||||
| `--etiquettes` | `--labels` | `--rigide` | `--rigid` |
|
||||
| `--fichiers` | `--files` | `--sans` | `--without` |
|
||||
| `--fin` | `--end` | `--sauf` | `--except` |
|
||||
| `--fixe` | `--fixed` | `--seuil` | `--threshold` |
|
||||
| `--fusion` | `--merge` | `--sortie` | `--out` |
|
||||
| `--glissant` | `--rolling` | `--suivre` | `--follow` |
|
||||
| `--heures` | `--times` | `--table T1/T2\|non` | `--table T1/T2\|no` |
|
||||
| `--hors` | `--outside` | `--essai` | `--self-test` |
|
||||
| `--jours` | `--days` | `--lissage` | `--smoothing` |
|
||||
| `--largeur` | `--width` | | |
|
||||
|
||||
Unchanged: `--figure`, `--fraction`, `--instants`, `--k`, `--max`, `--min`, `--stat median|min|max`, `--zone`. Default output folder: `out/diagnostic` (unchanged). Output: English text, every number, date format and column order identical.
|
||||
|
||||
## 5. agents (`~/agents`)
|
||||
|
||||
- `agents/analyste.md` → `agents/analyst.md`, agent `agents:analyst`. Its request: `Station: data/<STATION>/. Range: <start> → <end> (UTC). Hints: <…> | none. Output folder: <folder>/. DETECTORS: yes | no. Events: <command> (only with DETECTORS: yes). INSTRUCTIONS: <file>.`
|
||||
- `agents/tool-builder.md`, agent `agents:tool-builder`. Its request: `Analysis: <analysis folder>/. Tools: <tools repository>/. Write <report>.`
|
||||
- `upgrader`, `validator`: already English.
|
||||
|
||||
## 6. Diagnostic-App
|
||||
|
||||
- `consignes/analyste.md` → `instructions/analyst.md`.
|
||||
- `app/serveur/` → `app/server/`: `serveur.py` → `server.py`, `station.py`, `analyse.py` → `analysis.py`, `check.py`.
|
||||
- `app/web/src/commun.jsx` → `app/web/src/common.jsx`; `App.jsx`, `main.jsx`, `pages/Data.jsx`, `pages/Images.jsx` keep their names.
|
||||
- API: `/api/courbes` → `/api/curves`, `/api/detecteurs` → `/api/detectors`, `/api/etiquettes` → `/api/labels`, `/api/analyses/{name}/rapport.html` → `report.html`, `/optimiser` → `/optimize`, `/bilan.html` → `/summary.html`; the others unchanged. JSON fields between server and page: English, chosen by the Diagnostic-App translator, the same on both sides.
|
||||
- Environment variables `AIMSIGHT_DATA`, `AIMSIGHT_LABELS`, `AIMSIGHT_PORT`, the VS Code task "Run app" and the six links (`data`, `labeling`, `detectors`, `tools`, `agents`, `optimizer`) keep their names.
|
||||
|
||||
## 7. Optimizer
|
||||
|
||||
- `seances/` → `sessions/` (the default `OUT` of `improve`: `sessions/<analysis>_<YYYYMMDDTHHMMZ>/`).
|
||||
|
||||
## 8. detectors
|
||||
|
||||
- Already English. `bench/score.py` and `bench/regression.py` read the label keys of section 1 (`start`, `end`, `family`, `description`); `CLAUDE.md` and `README.md` say so (the "French keys" line goes).
|
||||
|
||||
## 9. aimsight-data
|
||||
|
||||
- `extraction/pomper.py` → `extraction/pump.py`, `extraction/pomper.sh` → `extraction/pump.sh`, `extraction/lenzspitze_absolu.py` → `extraction/lenzspitze_absolute.py`; `stations.txt` unchanged.
|
||||
- Options: `--du` → `--from`, `--au` → `--to`, `--delai` → `--delay`; `--diff`, `--every`, `--images`, `--out` unchanged.
|
||||
- `out/pompage.log` → `out/pump.log`, `out/pompage.lock` → `out/pump.lock`.
|
||||
- VS Code tasks: « pomper » → "pump", « pomper une plage » → "pump a range".
|
||||
- The Windows Task Scheduler task « AIMsight pompage » keeps its name; its action points to `extraction/pump.sh` (updated by the orchestrator with `schtasks.exe`).
|
||||
- `.env` variable names do not change.
|
||||
Reference in new issue
Block a user