Add design persistence, world rendering, metrics overlay and logs
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:
parent
79928b645b
commit
93075ab1fd
107 changed files with 14785 additions and 46 deletions
|
|
@ -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). Если понадобится экосистема, заменим фасад, не меняя
|
||||
места вызовов.
|
||||
|
||||
## Идеи на потом (пока не включены)
|
||||
Каждый пункт можно включить отдельным шагом, когда проект дорастёт.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue