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.
97 lines
6.9 KiB
Markdown
97 lines
6.9 KiB
Markdown
# 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.
|