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.
This commit is contained in:
commit
79928b645b
222 changed files with 5335 additions and 0 deletions
56
docs/DEPENDENCIES.md
Normal file
56
docs/DEPENDENCIES.md
Normal file
|
|
@ -0,0 +1,56 @@
|
|||
# Зависимости
|
||||
|
||||
Правило: пишем своё, где это разумно; берём готовое, только когда оно отлично
|
||||
работает и писать самим слишком дорого. Каждая внешняя зависимость обосновывается
|
||||
записью в DECISIONS.md.
|
||||
|
||||
## Замеры (16.11.2026, версии по умолчанию из crates.io)
|
||||
«Crate'ов на Linux» — зависимости, которые реально собираются на Linux.
|
||||
Размер исходников и строки считаны для всех платформ (включая Windows и macOS),
|
||||
поэтому завышены; для оценки скорости сборки смотри число crate'ов.
|
||||
|
||||
| Библиотека | Crate'ов на Linux | Исходники, МБ | Строк Rust | Решение |
|
||||
|---|---|---|---|---|
|
||||
| `libm` | 1 | 0.6 | 20 тыс. | берём (детерминированная математика) |
|
||||
| `serde` | 7 | 4.2 | 119 тыс. | берём (форматы) |
|
||||
| `ron` | 10 | 5.2 | 149 тыс. | берём (форматы сцен и конструкций) |
|
||||
| `rayon` | 6 | 1.8 | 53 тыс. | берём позже (развёртки, Monte Carlo) |
|
||||
| `fontdue` | 8 | 3.2 | 86 тыс. | берём для текста в своём UI; позже можно заменить своим растеризатором |
|
||||
| `rhai` | 25 | 25.6 | 669 тыс. | берём (скрипты) |
|
||||
| `rapier3d-f64` | 46 | 55.0 | 1757 тыс. | временно, пока не напишем свой backend (D3); вариант на f64 + `enhanced-determinism` |
|
||||
| `wgpu` | 61 | 209.1 | 4163 тыс. | берём; самый тяжёлый, см. ниже |
|
||||
| `winit` | 72 | 234.7 | 4163 тыс. | берём (окна и ввод на трёх ОС писать самим слишком дорого) |
|
||||
| `gltf` | 37 | 19.3 | 541 тыс. | не берём сейчас: свой минимальный читатель; возьмём, только если glTF станет обязательным |
|
||||
| `nalgebra` | 19 | 36.4 | 1289 тыс. | не берём в симуляции (свой `core::vec`) |
|
||||
| `glam` | 1 | 6.4 | 250 тыс. | не берём в симуляции (свой `core::vec`) |
|
||||
| `egui` | 54 | 35.1 | 944 тыс. | не берём (D20) |
|
||||
| `proptest` | 26 | 54.5 | 1441 тыс. | dev-зависимость, берём для property-тестов (D26) |
|
||||
| `criterion` | 51 | 166.7 | 1643 тыс. | dev-зависимость, берём для бенчмарков (D26) |
|
||||
| `ash` (Vulkan напрямую) | 3 | 5.0 | 131 тыс. | запасной вариант вместо `wgpu` |
|
||||
|
||||
## Что пишем сами
|
||||
Планировщик, единицы, векторная математика, эмулятор CPU и SoC, аналоговый
|
||||
решатель, балки и FEM, тепло, аэродинамика, мышцы, мир, рендер-слой, UI, импорт
|
||||
STL/OBJ и минимальный glTF, физический backend (после старта на Rapier).
|
||||
|
||||
## Тяжёлые, которые оставляем пока
|
||||
- **`wgpu`** (61 crate): самый тяжёлый, но скрыт за crate'ом `render`. Если время
|
||||
сборки или размер начнут мешать, переходим на `ash` (3 crate'а): придётся
|
||||
написать свой менеджер памяти, swapchain и синхронизацию, а шейдеры
|
||||
компилировать заранее. Минус `ash`: macOS только через MoltenVK.
|
||||
- **`winit`** (72 crate'а): окна на Wayland, X11, Windows и macOS вручную — слишком
|
||||
большая работа без пользы для цели проекта.
|
||||
- **`rapier3d-f64`**: вариант Rapier на `f64` (тот же набор crate'ов) плюс фича
|
||||
`enhanced-determinism`; нужен для быстрого старта и не вносит границу `f32`.
|
||||
Авторитетные результаты со временем считает свой backend.
|
||||
- **`rhai`**: заменить своим языком возможно, но это отдельный большой проект.
|
||||
|
||||
## UI
|
||||
Свой UI на нашем рендере (D20, D34): immediate-mode список команд, панели, текст,
|
||||
кнопки, ползунки, графики, дерево деталей, таблица свойств, окно 3D-вида, потом
|
||||
редактор схем и жгутов. Растеризация шрифта через `fontdue`; shaping/IME для
|
||||
текстовых полей — кандидаты `cosmic-text`/`Parley`, решение на M10 (UI.md).
|
||||
Сначала оверлей отладки (M4), полноценный редактор в M10.
|
||||
Отвергнуты: `egui` (не нравится), `iced` (тяжёлый), `slint` (лицензия GPL/коммерческая
|
||||
несовместима с MIT), `xilem` (молодой). Blueprint ShapeUI — источник контрактов,
|
||||
не фундамент (UI.md).
|
||||
Loading…
Add table
Add a link
Reference in a new issue