Начальный коммит: Vulkan-редактор SimVulcan + исследование KBC-LBM

Состояние на момент заведения репозитория.

C++ приложение (src/, shaders/, tests/) — минимальный редактор 3D-моделей
на Vulkan 1.3: орбитальная камера, три опорные сетки через начало координат,
загрузка .obj с режимами отображения. Весь Vulkan изолирован в src/vk/.

Исследование (docs/) — оригинальные статьи по KBC (docs/origins) и
Python-решатель D2Q9 KBC-N1 с AMR 2x и SDF+Bouzidi (docs/theory).

В решателе перед коммитом исправлены дефекты, найденные сверкой с
первоисточниками: относительный порог знаменателя энтропийного стабилизатора
(абсолютный вырождал KBC в LBGK на 77-99% узлов), заворот вход/выход в углах
домена, диагностика средней плотности по фиктивным узлам тела, зашитый
refine=2. Подробности — docs/theory/solver_2x_sdf/README.md.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.gitignore

@@ -0,0 +1,55 @@
+# ---------------------------------------------------------------------------
+#  Сборка
+# ---------------------------------------------------------------------------
+# Каталог пресетов CMake целиком: объектники, SPIR-V, скопированные assets,
+# и _deps — клоны зависимостей через FetchContent (только они ~775 МБ).
+/build/
+/out/
+CMakeUserPresets.json          # локальные пресеты разработчика, не общие
+compile_commands.json          # генерится (CMAKE_EXPORT_COMPILE_COMMANDS), часто симлинк в корень
+
+# Зависимости, если их когда-нибудь начнут класть вручную (сейчас каталог пуст,
+# всё тянет FetchContent). Убрать строку, если вендорить их в репозиторий.
+/extern/*
+!/extern/.gitkeep
+
+# ---------------------------------------------------------------------------
+#  Артефакты выполнения приложения
+# ---------------------------------------------------------------------------
+# SimVulcan пишет их в текущий каталог при запуске (обычно внутри build/,
+# но при запуске из другого места окажутся здесь).
+imgui.ini
+pipeline_cache.bin
+
+# ---------------------------------------------------------------------------
+#  Python (docs/theory — исследовательский код)
+# ---------------------------------------------------------------------------
+__pycache__/
+*.py[cod]
+.ipynb_checkpoints/
+.venv/
+venv/
+.pytest_cache/
+
+# Числовые сводки демо-прогонов: генерятся скриптами demos_gpu/*.py на GPU-сервере
+# (ноутбук цитирует их значения в markdown). Сами прогоны воспроизводимы.
+docs/theory/demos_gpu/out/
+docs/theory/solver_2x_sdf/out/
+
+# ВАЖНО: docs/theory/figures/ и docs/theory/anim/ НЕ игнорируются намеренно —
+# ноутбук kbc_lbm.ipynb их встраивает, и без них он нечитаем на свежем клоне
+# (перегенерация требует GPU-сервера). См. заметку о них в README ветки research.
+
+# ---------------------------------------------------------------------------
+#  Редакторы и ОС
+# ---------------------------------------------------------------------------
+.vs/
+.vscode/
+.idea/
+*.user
+*.suo
+*.swp
+*~
+.DS_Store
+Thumbs.db
+desktop.ini