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.
138 lines
11 KiB
Markdown
138 lines
11 KiB
Markdown
# TODO
|
||
|
||
Этапы — вертикальные срезы, а не слои. Каждый срез заканчивается тем, что можно
|
||
показать и проверить, а не набором готовых подсистем. Порядок можно менять.
|
||
Подробности: [docs/](docs/README.md).
|
||
|
||
## Готово
|
||
- **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 — Один шарнир (готово)
|
||
Цель: замкнутый контур «сценарий → мотор → шарнир → датчик → регулятор» без мира,
|
||
рендера и электроники. Это проверка того, что ядро, физика и мост данных стыкуются.
|
||
- [x] `core::vec`: `Vec3`, `Mat3`, `Quat`, `Transform` (f64, через `core::math`)
|
||
- [x] `core::units`: `Radians`; `RadiansPerSecond` и `NewtonMeters` — вместе с шарниром
|
||
- [x] `core::rng`: seeded генератор (xoshiro256** через SplitMix64) для тестов и Monte Carlo
|
||
- [x] `physics`: трейт `PhysicsBackend` + Rapier, один шарнир с мотором
|
||
- [x] `sensors`: энкодер и IMU (шум, смещение, задержка, квантование); IMU пока
|
||
одноосный по Z, три оси — когда понадобится сценарию
|
||
- [x] сценарий на Rust (Rhai позже): PD-регулятор по энкодеру
|
||
- **DoD выполнен:** headless-тест поднимает звено из 60° в 0°, ошибка 0.013 рад
|
||
(0.7 %), золотой хеш закреплён; без окна и GPU.
|
||
|
||
## M3 — Деталь и конструкция (DoD выполнен)
|
||
Цель: собрать конструкцию из настоящих мешей и сохранить её.
|
||
- [x] импорт STL и OBJ, проверка меша (замкнутость, ориентация, единицы)
|
||
- [x] масса, COM, тензор инерции по мешу (+ property-тесты на сферах и кубах)
|
||
- [x] материалы: плотность, модуль Юнга, предел текучести, база сталь/алюминий/PLA
|
||
- [x] формат сцены и конструкции (RON), `storage`: blob по хешу, версии, миграции
|
||
- [ ] `parts`: библиотека деталей, минимальный BOM
|
||
- **DoD выполнен:** три STL-детали собираются, сохраняются в папку проекта и
|
||
загружаются; масса 68.2 кг сходится с аналитикой в пределах 1 %, миграция v0→v1
|
||
проверена тестом. Осталась библиотека деталей и BOM — это уходит в M10.
|
||
|
||
## M4 — Мир и картинка
|
||
Цель: та же конструкция едет по террейну в окне.
|
||
- [x] `worldgen`: высотная карта, коллайдеры (trimesh), golden-хеш; чанки — вместе с рендером
|
||
- [x] `render`: wgpu, окно, глубина, меш рельефа, инстансинг кубов, offscreen-тесты;
|
||
clipmap LOD — позже, отдельным шагом
|
||
- [x] `ui`/оверлей: список команд рисования, glyph atlas, текст через `fontdue`,
|
||
прямоугольники, линии, графики; event-driven redraw. Полный редактор — в crate `ui`
|
||
- [x] `app`: winit, окно, событийный цикл, физика 1 кГц, камера, оверлей метрик
|
||
- [x] тележка: корпус + 4 колеса на шарнирах, velocity-моторы, WASD, golden-хеш;
|
||
RTF 1.00 в окне, физика ~0.55 мс
|
||
- [x] chunked LOD рельефа с юбками: 2368 треугольников вместо 8192; физика на полном
|
||
меше. Rings-clipmap — возможное продолжение (см. docs/ARCHITECTURE.md)
|
||
- [x] профилировать простой: причина — пропуски 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](docs/NETWORK.md). Сервер ведёт авторитетную
|
||
симуляцию, клиенты смотрят и управляют по сети.
|
||
|
||
- [ ] S1: headless-сервер, мир тикает без окна
|
||
- [ ] S2: снапшоты по сети, один клиент рисует состояние сервера
|
||
- [ ] S3: несколько клиентов с разными камерами
|
||
- [ ] S4: ввод одного клиента, подтверждение и отказ при разрыве
|
||
- [ ] S5: интернет, дельты, переподключение, токен
|
||
|
||
## Диагностика и логи (сразу после M4d)
|
||
- [x] `core::log`: уровни, приёмник, макросы; выключенный уровень не форматирует строку
|
||
- [x] приложение: CSV метрик и dev-лог по флагам (`--metrics-log`, `--log`, `--dev`, `--append`)
|
||
- [x] `core::log`-фасад и приёмник: приложение переведено; дальше добавлять логи в crate'ах
|
||
- [x] логи в ключевых точках: старт и конфиг, деградации, ошибки, сводки раз в секунду, пики
|
||
- [ ] тест: golden-хеш симуляции не зависит от включённых логов
|
||
- **DoD:** в библиотеках нет `println!`, `--dev` даёт debug/trace, обычный запуск — warn/info;
|
||
выключенный уровень не строит строку
|
||
|
||
## Headless CLI и обучение контроллеров (после M4d)
|
||
Подробности: [docs/CLI.md](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.
|