fix #23 by adding validating on first startup and close #30 by adding

version number

Signed-off-by: galeon <dertiellis@gmail.com>

doc/cpp/LauncherBackend.md

@@ -46,16 +46,34 @@
 3. `migrateLegacyBuildsFile()` переносит старый `versions.json` в `customBuilds.json`. Это должно
    случиться до следующего шага, иначе поверх старых данных появится пустой файл.
 4. `loadData()` читает профили и сборки и сортирует их по `id`.
-5. `ensureDataFiles()` создаёт недостающие файлы.
-6. Если `BuildSwitcher` нашёл журнал оборванного переключения, бэкенд сразу продолжает его через
+5. Если это первый запуск, `importGameDir()` заводит сборку под то, что уже лежит в папке игры
+   (см. ниже).
+6. `ensureDataFiles()` создаёт недостающие файлы.
+7. Если `BuildSwitcher` нашёл журнал оборванного переключения, бэкенд сразу продолжает его через
    `resumeInterrupted()`. Пользователю ничего не предлагается. Если начать переключение заново,
    оно сначала заархивирует полуразобранную `.minecraft` поверх целого архива прежней сборки.
-7. Подписка на сигналы сервисов.
+8. Подписка на сигналы сервисов.
 
 Все проблемы, найденные по пути (битый JSON, папка без права записи, пропущенные записи сборок),
 копятся в `m_storageIssues` и уходят одним `launchError` через `QTimer::singleShot(0)`: к этому
 моменту QML уже подписан на сигнал.
 
+### Сборка из папки игры
+
+Первым запуском считается старт, когда нет ни `settings.json`, ни `customBuilds.json`, ни
+старого `versions.json`. Проверка делается до `loadData()`: битый файл она отводит в `.bak`, а
+`ensureDataFiles()` потом создаёт пустой. Существующий пустой `customBuilds.json` — это решение
+пользователя «сборок нет», и импорта тогда нет.
+
+Если [GameDirImport::detect()](gamedirimport.md) что-то нашёл, запись сборки добавляется сразу,
+минуя `addCustomBuild()` (тот начал бы установку), становится активной и сохраняется вместе с
+`activeBuildId`. `BuildSwitcher` не вызывается: сборка описывает то, что уже разложено в папке
+игры, а активная сборка без архива — штатное состояние. Сама папка игры только читается.
+
+Имя: `<loaderTitle> <версия>` или `Minecraft <версия>`, а без версии — `build.title.fromGameDir`.
+Через `QTimer::singleShot(0)` приходит `gameDirImported(buildName)`, раньше сообщения об ошибках
+хранилища, чтобы оно их не перекрыло. Main.qml показывает по нему зелёную плашку.
+
 ## Файлы на диске
 
 Все пути берутся из [launcherpaths.h](launcherpaths.md).