Гарды перед инжектом¶

Прежде чем тронуть update.rpf, install pipeline проходит серию проверок. Если любая не прошла — install прерывается с понятной ошибкой.

Список гардов в порядке¶

flowchart TD
  Start[reduxInstall called] --> G1{1. UpdateRpfMutex
уже acquired?}
  G1 -->|да| Wait[Ждём 10 мин max]
  G1 -->|нет| G2{2. GTA path
existed?}
  Wait --> G2
  G2 -->|нет| FailGta[Ошибка: GTA не найдена]
  G2 -->|да| G3{3. update.rpf
readable?}
  G3 -->|нет| FailLock[Ошибка: файл заблокирован,
покажи кто держит]
  G3 -->|да| G4{4. Текущий SHA
совпадает с CLEAN или LAST?}
  G4 -->|DIRTY без force| FailDirty[Ошибка: DIRTY_FILES_NEED_CONFIRM,
UI открывает modal]
  G4 -->|matchesClean
matchesLast
DIRTY+force| G5{5. Backup есть?}
  G5 -->|нет| FailBackup[Ошибка: нужен backup,
UI открывает BackupScreen]
  G5 -->|да| G6{6. Diskspace
достаточно?}
  G6 -->|нет| FailSpace[Ошибка: нужно 5+ ГБ свободного]
  G6 -->|да| G7{7. ArchiveFix.exe
existed?}
  G7 -->|нет| FailFix[Ошибка: ArchiveFix не найден]
  G7 -->|да| Proceed[Поехали install]

Гард 1: Mutex¶

using var _mtx = await UpdateRpfMutex.AcquireAsync($"redux-install:{reduxId}");

Не проверка в строгом смысле — а lock на shared resource. Если другой install уже идёт — ждём 10 минут, потом throw'аем TimeoutException.

UI на это ловит — показывает «другой мод устанавливается». Юзер не может запустить два install параллельно.

Гард 2: GTA path¶

var gtaRoot = await GetGtaPathAsync();
if (string.IsNullOrWhiteSpace(gtaRoot) || !Directory.Exists(gtaRoot))
{
    EmitInstallProgress(reduxId, displayName, "error", 0, "GTA не найдена.");
    return new InjectResultDto(false, "GTA не найдена. Укажи путь в Admin → Settings → Paths.", null);
}

Юзер мог:

• Удалить GTA после первого setup'а Miami;
• Переименовать папку GTA;
• Сменить hard drive (GTA теперь на D: вместо C:\, settings всё ещё указывает на C:).

В любом случае — ошибка с указанием куда полезть Settings.

Гард 3: File readable¶

var updateRpf = Path.Combine(gtaRoot, "update", "update.rpf");
if (!File.Exists(updateRpf))
{
    return new InjectResultDto(false, "update.rpf отсутствует в GTA-папке. Verify integrity через Rockstar Launcher.", null);
}

try
{
    using var probe = File.Open(updateRpf, FileMode.Open, FileAccess.Read, FileShare.Read);
}
catch (IOException)
{
    var lockers = FileLockDetector.WhoIsLocking(updateRpf);
    return new InjectResultDto(false,
        $"update.rpf занят. Закрой: {string.Join(", ", lockers.Select(l => l.ProcessName))}",
        null);
}

GTA может быть запущена. Rockstar Launcher делает auto-verify файлов в фоне. Антивирус скан'ит. Любой из них держит update.rpf в shared read mode, но не в shared write — мы не можем писать.

FileLockDetector даёт список процессов. UI показывает modal «закрой эти программы и попробуй снова».

Гард 4: Preflight (CLEAN / LAST / DIRTY)¶

Уже описано детально. Главное:

• matchesClean — ОК сразу.
• matchesLast — auto-restore clean → ОК.
• DIRTY + force=false — error DIRTY_FILES_NEED_CONFIRM. UI открывает 3-way modal (Preserve / Force / Cancel).
• DIRTY + force=true — юзер согласился перетереть → restore-clean → ОК.

Гард 5: Backup ready¶

Если clean копия отсутствует у нас (например юзер впервые запустил Miami) — install не может работать. Нужен backup.

var backupStatus = await _backupService.GetStatusAsync(gtaRoot, CancellationToken.None);
if (!backupStatus.CleanUpdatePresent)
{
    return new InjectResultDto(false, "BACKUP_REQUIRED", null);
}

UI на это ловит — открывает BackupScreen. Юзер видит wizard «сначала забэкапим твой update.rpf, потом сможем ставить моды».

После успешного backup — autoredirect на ту же install operation.

Гард 6: Diskspace¶

var driveInfo = new DriveInfo(Path.GetPathRoot(updateRpf)!);
const long REQUIRED_FREE = 5L * 1024 * 1024 * 1024;   // 5 ГБ
if (driveInfo.AvailableFreeSpace < REQUIRED_FREE)
{
    return new InjectResultDto(false,
        $"На диске {driveInfo.Name} осталось мало места ({driveInfo.AvailableFreeSpace / 1024 / 1024} МБ). " +
        $"Нужно минимум 5 ГБ для безопасного install'а.",
        null);
}

5 ГБ потому что:

• 2 ГБ — снапшот .preinstall;
• 2 ГБ — новый update.rpf.hnt_temp во время Smart Rebuild;
• 200-400 МБ — patch.zip downloaded;
• 200 МБ — распакованный patch_files/;
• Запас.

Если меньше 5 ГБ — Smart Rebuild может частично записать новый файл и не довести до конца. Юзер получит crash GTA. Лучше отказать до начала.

Гард 7: ArchiveFix presence¶

var archiveFixPath = ResolveArchiveFixPath();
if (!File.Exists(archiveFixPath))
{
    return new InjectResultDto(false,
        "ArchiveFix.exe не найден. Переустанови Miami Graphics — этот файл должен лежать в additionals\\.",
        null);
}

Без ArchiveFix — Smart Rebuild соберёт RPF, но GTA отбросит файл как corrupted. Лучше не начинать install чем оставить юзера с битым update.rpf.

Если файл отсутствует — это значит юзер: либо вручную удалил additionals/, либо anti-virus поставил в карантин, либо install Miami был incomplete. UI говорит «переустанови Miami».

После всех гардов¶

Если все 7 прошли — поехали install:

1. Snapshot update.rpf → .preinstall.
2. Restore clean если matchesLast или DIRTY+force.
3. Download patch.zip.
4. Smart Rebuild.
5. ArchiveFix.
6. Save install_state.json.

Если любой из этих шагов упал — TryRollbackAsync восстанавливает .preinstall.

Что мы НЕ проверяем¶

• Antivirus presence — нет надёжного API чтобы понять «Антивирус сейчас сканирует наш файл». Просто пробуем write и обрабатываем IOException.
• GTA version compatibility — мы устанавливаем мод независимо от того target_gta_version. UI показывает warning если версии расходятся, но не блокирует. Юзер сам решает.
• Network connectivity перед download — пробуем download, если упал — error. Нет смысла probe-ить до того.

Failure mode таблица¶

Дальше: что будет если не пройти →