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.
10 KiB
10 KiB
TODO
Этапы — вертикальные срезы, а не слои. Каждый срез заканчивается тем, что можно показать и проверить, а не набором готовых подсистем. Порядок можно менять. Подробности: docs/.
Готово
- 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 — Один шарнир (готово)
Цель: замкнутый контур «сценарий → мотор → шарнир → датчик → регулятор» без мира, рендера и электроники. Это проверка того, что ядро, физика и мост данных стыкуются.
core::vec:Vec3,Mat3,Quat,Transform(f64, черезcore::math)core::units:Radians;RadiansPerSecondиNewtonMeters— вместе с шарниромcore::rng: seeded генератор (xoshiro256** через SplitMix64) для тестов и Monte Carlophysics: трейтPhysicsBackend+ Rapier, один шарнир с моторомsensors: энкодер и IMU (шум, смещение, задержка, квантование); IMU пока одноосный по Z, три оси — когда понадобится сценарию- сценарий на Rust (Rhai позже): PD-регулятор по энкодеру
- DoD выполнен: headless-тест поднимает звено из 60° в 0°, ошибка 0.013 рад (0.7 %), золотой хеш закреплён; без окна и GPU.
M3 — Деталь и конструкция (DoD выполнен)
Цель: собрать конструкцию из настоящих мешей и сохранить её.
- импорт STL и OBJ, проверка меша (замкнутость, ориентация, единицы)
- масса, COM, тензор инерции по мешу (+ property-тесты на сферах и кубах)
- материалы: плотность, модуль Юнга, предел текучести, база сталь/алюминий/PLA
- формат сцены и конструкции (RON),
storage: blob по хешу, версии, миграции parts: библиотека деталей, минимальный BOM- DoD выполнен: три STL-детали собираются, сохраняются в папку проекта и загружаются; масса 68.2 кг сходится с аналитикой в пределах 1 %, миграция v0→v1 проверена тестом. Осталась библиотека деталей и BOM — это уходит в M10.
M4 — Мир и картинка
Цель: та же конструкция едет по террейну в окне.
worldgen: высотная карта, коллайдеры (trimesh), golden-хеш; чанки — вместе с рендеромrender: wgpu, окно, глубина, меш рельефа, инстансинг кубов, offscreen-тесты; clipmap LOD — позже, отдельным шагомui: список команд рисования, glyph atlas, event-driven redraw, оверлей отладки (текст черезfontdue, прямоугольники, линии, клип)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::mathanalysis: развёртки, 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. Сервер ведёт авторитетную симуляцию, клиенты смотрят и управляют по сети.
- S1: headless-сервер, мир тикает без окна
- S2: снапшоты по сети, один клиент рисует состояние сервера
- S3: несколько клиентов с разными камерами
- S4: ввод одного клиента, подтверждение и отказ при разрыве
- S5: интернет, дельты, переподключение, токен
Диагностика и логи (сразу после M4d)
core::log: уровни, приёмник, макросы; выключенный уровень не форматирует строку- приложение: CSV метрик и dev-лог по флагам (
--metrics-log,--log,--dev,--append) core::log-фасад и приёмник: перевести приложение, затем добавлять логи в crate'ах- логи в ключевых точках: старт и конфиг, деградации, ошибки, сводки раз в секунду, пики
- тест: golden-хеш симуляции не зависит от включённых логов
- DoD: в библиотеках нет
println!,--devдаёт debug/trace, обычный запуск — warn/info; выключенный уровень не строит строку
Headless CLI и обучение контроллеров (после M4d)
Подробности: 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.