Add design persistence, world rendering, metrics overlay and logs
Some checks failed
ci / check (macos-latest) (push) Has been cancelled
ci / check (ubuntu-latest) (push) Has been cancelled
ci / check (windows-latest) (push) Has been cancelled

M3: STL/OBJ import with mesh validation, mass/COM/inertia, material database, RON scene with content-addressed blobs and v0->v1 migration. M4: deterministic heightmap terrain, trimesh colliders, wgpu renderer with instancing and depth, winit app with 1 kHz physics, fly camera, on-screen metrics overlay and per-frame CSV/dev logs. Docs: UI, logging, network and headless CLI plans.
This commit is contained in:
Loki 2026-11-16 23:34:05 +01:00
parent 79928b645b
commit 93075ab1fd
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
107 changed files with 14785 additions and 46 deletions

View file

@ -90,6 +90,41 @@ crate `tools/limits` (`fabrilis-limits`). У каждого crate'а есть `b
где это разумно).
- Архитектурное изменение сопровождается записью в `DECISIONS.md`.
## Логирование (обязательно с первого дня)
Код пишет диагностику сразу, а не «потом добавим». Единая точка — фасад
`fabrilis_core::log` с уровнями; приложение ставит приёмник (stderr, файл, dev-лог).
`println!`/`eprintln!` в библиотечном коде запрещены: только `main` для `--help` и
ошибок запуска.
| Уровень | Когда | Пример |
|---|---|---|
| `error` | работать дальше нельзя | не создался GPU-девайс, не загрузился проект |
| `warn` | работаем, но деградация | шейдер не поддержан, шаг не сошёлся, поле не распознано |
| `info` | жизненный цикл, один раз на событие | старт, seed и размер мира, загружено N деталей, режим |
| `debug` | сводки и важные изменения | раз в секунду FPS/TPS/RTF, смена камеры, решение сходимости |
| `trace` | покадрово/пошагово, только для разбора | входные события, каждый шаг решателя, пики контактов |
Правила:
- Уровень выбирается по смыслу события, а не по желанию. Горячий цикл логирует
только `trace` и только после проверки уровня: строка не должна строиться, если
уровень выключен.
- Логи не влияют на симуляцию: логгер не меняет порядок, состояние и время.
В crate'ах симуляции по-прежнему нет `Instant::now`/`SystemTime::now`; время для
логов ставит приёмник в `app`.
- Пишем факты в виде `key=value`, а не склейку предложений: `frame=120
frame_ms=18.4 physics_max_ms=0.6 trigger=contact`.
- Ошибки и деградации логируются там, где возникли, а не только наверху.
- Не логировать секреты и личные пути; большие буферы и меши не дампить.
- Сообщения на английском (как комментарии), уровни и поля — стабильные.
- Тесты: формат строки, парсеры, поведение выключенного уровня (строка не
форматируется), неизменность golden-хеша при включённых логах.
`log`/`tracing` сейчас не берём: нужен свой минимальный фасад без зависимостей и с
контролем детерминизма (D35). Если понадобится экосистема, заменим фасад, не меняя
места вызовов.
## Идеи на потом (пока не включены)
Каждый пункт можно включить отдельным шагом, когда проект дорастёт.