fabrilis/TODO.md
loki5512344 878d144b77 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

97 lines
6.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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