fabrilis/TODO.md
loki5512344 1042269d7e
Finish M4: cart, log facade, idle diagnostics and terrain LOD
Add the core::log facade with five levels and a sink; migrate the app dev log and enable trace in --dev. Replace the dropped cubes with a four-wheel cart on revolute joints driven by velocity motors, add WASD controls, a golden trajectory and a slope test. Instrument idle frame spikes and throttle the window title. Add chunked terrain LOD with skirts (2368 vs 8192 triangles) while physics keeps the full mesh. Pin Rust 1.100.0; edition stays 2024.
2026-11-17 14:32:52 +01:00

138 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# TODO
Этапы — вертикальные срезы, а не слои. Каждый срез заканчивается тем, что можно
показать и проверить, а не набором готовых подсистем. Порядок можно менять.
Подробности: [docs/](docs/README.md).
## Готово
- **M0 — Скелет.** docs, workspace, `fabrilis-limits`, pre-commit.
- **M1 — Детерминированное ядро.** `core::units`, `core::time` (u64 нс),
`core::math` поверх `libm`, `core::sched` (эпохи, точки синхронизации),
`core::fidelity`, `core::snapshot`, `core::id`, golden-тест детерминизма.
## M2 — Один шарнир (готово)
Цель: замкнутый контур «сценарий → мотор → шарнир → датчик → регулятор» без мира,
рендера и электроники. Это проверка того, что ядро, физика и мост данных стыкуются.
- [x] `core::vec`: `Vec3`, `Mat3`, `Quat`, `Transform` (f64, через `core::math`)
- [x] `core::units`: `Radians`; `RadiansPerSecond` и `NewtonMeters` — вместе с шарниром
- [x] `core::rng`: seeded генератор (xoshiro256** через SplitMix64) для тестов и Monte Carlo
- [x] `physics`: трейт `PhysicsBackend` + Rapier, один шарнир с мотором
- [x] `sensors`: энкодер и IMU (шум, смещение, задержка, квантование); IMU пока
одноосный по Z, три оси — когда понадобится сценарию
- [x] сценарий на Rust (Rhai позже): PD-регулятор по энкодеру
- **DoD выполнен:** headless-тест поднимает звено из 60° в 0°, ошибка 0.013 рад
(0.7 %), золотой хеш закреплён; без окна и GPU.
## M3 — Деталь и конструкция (DoD выполнен)
Цель: собрать конструкцию из настоящих мешей и сохранить её.
- [x] импорт STL и OBJ, проверка меша (замкнутость, ориентация, единицы)
- [x] масса, COM, тензор инерции по мешу (+ property-тесты на сферах и кубах)
- [x] материалы: плотность, модуль Юнга, предел текучести, база сталь/алюминий/PLA
- [x] формат сцены и конструкции (RON), `storage`: blob по хешу, версии, миграции
- [ ] `parts`: библиотека деталей, минимальный BOM
- **DoD выполнен:** три STL-детали собираются, сохраняются в папку проекта и
загружаются; масса 68.2 кг сходится с аналитикой в пределах 1 %, миграция v0→v1
проверена тестом. Осталась библиотека деталей и BOM — это уходит в M10.
## M4 — Мир и картинка
Цель: та же конструкция едет по террейну в окне.
- [x] `worldgen`: высотная карта, коллайдеры (trimesh), golden-хеш; чанки — вместе с рендером
- [x] `render`: wgpu, окно, глубина, меш рельефа, инстансинг кубов, offscreen-тесты;
clipmap LOD — позже, отдельным шагом
- [x] `ui`/оверлей: список команд рисования, glyph atlas, текст через `fontdue`,
прямоугольники, линии, графики; event-driven redraw. Полный редактор — в crate `ui`
- [x] `app`: winit, окно, событийный цикл, физика 1 кГц, камера, оверлей метрик
- [x] тележка: корпус + 4 колеса на шарнирах, velocity-моторы, WASD, golden-хеш;
RTF 1.00 в окне, физика ~0.55 мс
- [x] chunked LOD рельефа с юбками: 2368 треугольников вместо 8192; физика на полном
меше. Rings-clipmap — возможное продолжение (см. docs/ARCHITECTURE.md)
- [x] профилировать простой: причина — пропуски callback'ов композитора и внешние
заморозки, не приложение. Собственный кадр ~1.2 мс; в лог добавлены render/overlay/
title/metrics-фазы, заголовок обновляется раз в секунду (LOGGING.md)
- **DoD M4 выполнен:** тележка едет по склону (golden-тест + окно), RTF 1.00 на
эталонной сцене, физика ~0.55 мс; картинка не влияет на результат симуляции.
## M5 — Паук стоит и ходит
Цель: эталонный механизм, ради которого всё строится.
- [ ] `examples/spider`: конструкция, приводы, контроллер (без прошивки на МК)
- [ ] контакт стопы с землёй, трение, устойчивость
- [ ] метрики: нагрузки на шарниры, потребление, опрокидывание
- **DoD:** паук стоит и делает 10 шагов без падения; лог и видео; повтор
бит-в-бит при 1/2/8 потоках.
## M6 — Тепло и электроника
- [ ] `analog`: MNA, нелинейные элементы (Newton), сходимость (gmin/source stepping)
- [ ] `thermal`: тепло и вентиляция, `wiring`: провода как элементы
- [ ] очередь событий в планировщике (фронты PWM, прерывания, отказы)
- **DoD:** RC-цепь совпадает с экспонентой; провод греется по `I²R`; просадка
питания от тока мотора видна в сценарии.
## M7 — Мост и приводы
- [ ] `actuators`: моторы, серво, мышцы (Хилл, McKibben, SMA)
- [ ] `bridge`: пины ↔ схема ↔ приводы ↔ физика, сильные связи (COUPLING.md)
- **DoD:** контроллер через PWM/ADC крутит мотор с обратной ЭДС; сильная связь
сходится, откат шага воспроизводим.
## M8 — RISC-V и Bench
- [ ] RV32IMAC, `soc` (UART, GPIO, PWM, ADC, таймеры), `riscv-tests`
- [ ] режим Bench, точность по тактам
- **DoD:** `riscv-tests` проходят; та же прошивка, что на реальной плате, ходит
паука в Fabrilis.
## M9 — Структура
- [ ] балки и FEM, поле напряжений, режимы вида
- [ ] разрушение и усталость (модель «узлы и хрупкие балки»)
- **DoD:** консоль даёт `δ = PL³/3EI` с ошибкой < 1 %; рама паука держит ходьбу,
а при заданной перегрузке ломается предсказуемо.
## M10 — Сценарии, анализ, Lab
- [ ] `scripting`: Rhai с нашим `core::math`
- [ ] `analysis`: развёртки, Monte Carlo, метрики устойчивости, отказы
- [ ] режим Lab, редактор конструкций и схем: панели, дерево, таблица свойств,
графики, 3D-вид; shaping и IME для полей ввода (UI.md)
- **DoD:** отчёт по сценарию воспроизводим с тем же seed; при 1/8/24 потоках
метрики совпадают.
## M11 — Linux
- [ ] RV64GC, MMU Sv39, device tree из карты памяти, virtio
- [ ] загрузка Linux, реальные драйверы
- **DoD:** Linux грузится и видит периферию симулированной платы.
## M12 — Железо и ISA
- [ ] `platform`: P/E-ядра, GPU-профиль, регулятор нагрузки
- [ ] управление временем: замедление, перемотка
- [ ] arm/avr через трейт `Cpu`
## Открытые вопросы
См. docs/DECISIONS.md.
## Позже — сетевой режим
Подробности: [docs/NETWORK.md](docs/NETWORK.md). Сервер ведёт авторитетную
симуляцию, клиенты смотрят и управляют по сети.
- [ ] S1: headless-сервер, мир тикает без окна
- [ ] S2: снапшоты по сети, один клиент рисует состояние сервера
- [ ] S3: несколько клиентов с разными камерами
- [ ] S4: ввод одного клиента, подтверждение и отказ при разрыве
- [ ] S5: интернет, дельты, переподключение, токен
## Диагностика и логи (сразу после M4d)
- [x] `core::log`: уровни, приёмник, макросы; выключенный уровень не форматирует строку
- [x] приложение: CSV метрик и dev-лог по флагам (`--metrics-log`, `--log`, `--dev`, `--append`)
- [x] `core::log`-фасад и приёмник: приложение переведено; дальше добавлять логи в crate'ах
- [x] логи в ключевых точках: старт и конфиг, деградации, ошибки, сводки раз в секунду, пики
- [ ] тест: golden-хеш симуляции не зависит от включённых логов
- **DoD:** в библиотеках нет `println!`, `--dev` даёт debug/trace, обычный запуск — warn/info;
выключенный уровень не строит строку
## Headless CLI и обучение контроллеров (после M4d)
Подробности: [docs/CLI.md](docs/CLI.md). Отдельный бинарник без окна и GPU; общий
код прогонов — в `modes`.
- [ ] C1: `fabrilis-cli` + `simulate`, CSV на выходе, golden-хеш
- [ ] C2: `validate` и коды возврата (1 — провал допуска)
- [ ] C3: `sweep` и Monte Carlo по процессам
- [ ] C4: протокол команд JSON-RPC (stdio/Unix-сокет) + `repl` для внешнего управления
- [ ] C5: `serve` — headless-сервер (стыкуется с NETWORK.md S1)
- [ ] C6: MCP-адаптер поверх команд (агент/нейросеть рулит движком)
- **DoD C1:** тот же мир без окна, результат совпадает с GUI-прогоном по seed.