fabrilis/TODO.md
loki5512344 79928b645b
Initial commit: Fabrilis docs, rules and deterministic core
Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
2026-11-16 23:06:29 +01:00

6.9 KiB
Raw Blame History

TODO

Этапы — вертикальные срезы, а не слои. Каждый срез заканчивается тем, что можно показать и проверить, а не набором готовых подсистем. Порядок можно менять. Подробности: docs/.

Готово

  • 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 — Один шарнир

Цель: замкнутый контур «сценарий → мотор → шарнир → датчик → регулятор» без мира, рендера и электроники. Это проверка того, что ядро, физика и мост данных стыкуются.

  • 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 (минимум: шум, задержка, дискретизация)
  • сценарий на 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.