# 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.