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

11 KiB
Raw Permalink Blame History

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 Carlo
  • physics: трейт 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, текст через fontdue, прямоугольники, линии, графики; event-driven redraw. Полный редактор — в crate ui
  • app: winit, окно, событийный цикл, физика 1 кГц, камера, оверлей метрик
  • тележка: корпус + 4 колеса на шарнирах, velocity-моторы, WASD, golden-хеш; RTF 1.00 в окне, физика ~0.55 мс
  • chunked LOD рельефа с юбками: 2368 треугольников вместо 8192; физика на полном меше. Rings-clipmap — возможное продолжение (см. docs/ARCHITECTURE.md)
  • профилировать простой: причина — пропуски 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. Сервер ведёт авторитетную симуляцию, клиенты смотрят и управляют по сети.

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