# TODO Этапы — вертикальные срезы, а не слои. Каждый срез заканчивается тем, что можно показать и проверить, а не набором готовых подсистем. Порядок можно менять. Подробности: [docs/](docs/README.md). ## Готово - **M0 — Скелет.** docs, workspace, `fabrilis-limits`, pre-commit, CI. - **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 - [ ] `physics`: трейт `PhysicsBackend` + Rapier, один шарнир с мотором - [ ] `sensors`: энкодер и IMU (минимум: шум, задержка, дискретизация) - [ ] сценарий на Rust (Rhai позже): PD-регулятор по энкодеру - **DoD:** headless-тест поднимает звено в заданный угол, ошибка < 2 %, golden-хеш состояния; работает без окна и GPU. ## M3 — Деталь и конструкция Цель: собрать конструкцию из настоящих мешей и сохранить её. - [ ] импорт STL и OBJ, проверка меша (замкнутость, ориентация, единицы) - [ ] масса, COM, тензор инерции по мешу (+ property-тесты на сферах и кубах) - [ ] материалы (плотность, прочность, теплопроводность) - [ ] формат сцены и конструкции (RON), `storage` с миграциями - [ ] `parts`: библиотека деталей, минимальный BOM - **DoD:** тележка из трёх STL-деталей собирается, сохраняется и загружается; масса сходится с аналитикой в пределах 1 %. ## M4 — Мир и картинка Цель: та же конструкция едет по террейну в окне. - [ ] `worldgen`: высотная карта, чанки, коллайдеры - [ ] `render`: wgpu, clipmap, инстансинг - [ ] `ui`: список команд рисования, glyph atlas, event-driven redraw, оверлей отладки (текст через `fontdue`, прямоугольники, линии, клип) - [ ] `app`: winit, главный цикл, режим World - **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.