fabrilis/TODO.md
loki5512344 190ef9cc4b 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.
2026-11-16 23:40:39 +01:00

134 lines
10 KiB
Markdown
Raw 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 — позже, отдельным шагом
- [ ] `ui`: список команд рисования, glyph atlas, event-driven redraw, оверлей отладки
(текст через `fontdue`, прямоугольники, линии, клип)
- [x] `app`: winit, окно 1280×720, событийный цикл, World-сцена с рельефом и кубом
(физика в окне — следующий шаг)
- [ ] профилировать простой: почему иногда подпрыгивает нагрузка при стоящих кубах
(сон тел, островки контактов, оверлей); писать пики в лог (LOGGING.md)
- **DoD:** тележка едет по склону; RTF ≥ 1 на эталонной сцене (см. бюджет в
ARCHITECTURE.md); картинка не влияет на результат симуляции.
## 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)
- [ ] `core::log`: уровни, приёмник, макросы; выключенный уровень не форматирует строку
- [x] приложение: CSV метрик и dev-лог по флагам (`--metrics-log`, `--log`, `--dev`, `--append`)
- [ ] `core::log`-фасад и приёмник: перевести приложение, затем добавлять логи в crate'ах
- [ ] логи в ключевых точках: старт и конфиг, деградации, ошибки, сводки раз в секунду, пики
- [ ] тест: 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.