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.
6.9 KiB
6.9 KiB
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 Carlophysics: трейт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::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.