# Инструкция для монтажёров: Project / Checkout

Этот сервис нужен, чтобы не путаться, у кого сейчас актуальная версия серии в Adobe Premiere Production.

Рабочий адрес сервиса:
- `https://premiere-project-server-ui.pages.dev`

Если адрес изменится, используйте ссылку от супервайзера.

## 1. Что делает сервис

Сервис фиксирует:
- кто взял серию в работу;
- кто её сдал;
- какая текущая версия;
- какой Production ZIP сейчас актуален.

Главное правило:
- одну серию одновременно редактирует только один монтажёр.

## 2. Вход в систему

1. Откройте ссылку сервиса.
2. Введите логин и пароль.
3. Нажмите `Войти`.

Если логин успешный, откроется список доступных вам серий.

## 3. Что вы видите на экране

В блоке `Проекты` у каждой серии есть статус:
- `СВОБОДЕН` — серию можно взять.
- `ЗАНЯТ` — серия занята другим монтажёром.
- `МОЙ` — серия сейчас у вас.

Кнопки и действия:
- `Взять` — захватить свободную серию.
- `Скачать Production` — скачать актуальный ZIP.
- `Загрузить Production` — загрузить новый ZIP после правок.
- `Сдать` — завершить работу и освободить серию.

## 4. Сортировка списка

Вверху есть поле `Сортировка`:
- `По имени` (по умолчанию);
- `По дате изменения`;
- `По типу` (сначала свободные, потом занятые).

Выбранный режим запоминается в браузере.

## 5. Базовый рабочий цикл (обязательно)

1. Нажмите `Взять` у нужной серии.
2. Нажмите `Скачать Production`.
3. Распакуйте ZIP.
4. Работайте в Premiere Production.
5. Перед сдачей загрузите результат через `Загрузить Production`.
6. После успешной загрузки нажмите `Сдать`.

Важно:
- нельзя сдавать серию, если не загружен новый Production для следующей версии;
- если серия не ваша, загрузка/сдача будет отклонена.

## 6. Как правильно загружать Production

Поддерживаются 2 варианта:
- выбрать готовый ZIP;
- выбрать папку Production (сервис сам упакует её в ZIP).

Рекомендации:
- загружайте именно Production-папку проекта;
- не переименовывайте корневую папку Production после скачивания;
- не удаляйте `.prodset` и связанные `.prproj`.

## 7. Как правильно скачивать и открывать

1. Нажмите `Скачать Production`.
2. Скачайте ZIP по открытой ссылке.
3. Распакуйте.
4. Откройте Production из распакованной структуры.

Имя архива выдаётся стабильно, без принудительной приписки версии.

### 7.1 Авто-архив старой версии (опционально)

Если хотите не удалять старую папку вручную, используйте скрипт:

```bash
/Users/kirill_savinov_m4max/Documents/PROGRAMMING/PremiereProjectServer/scripts/import_production_zip.sh \
  --zip "$HOME/Downloads/Production.zip" \
  --projects-dir "$HOME/Documents/Projects" \
  --target-name "Production"
```

Что делает скрипт:
- если папка `Production` уже есть, переименует её в `Production_Copy_YYYY-MM-DD_HH-mm`;
- перенесёт эту папку в `OLD` внутри папки проектов (по умолчанию `projects/OLD`, папка создаётся автоматически);
- распакованную новую версию поставит на место активной;
- удалит ZIP после успешного импорта (добавьте `--keep-zip`, если удалять не нужно).

### 7.2 Полный авто-режим (фоновый watcher)

Один раз запустите watcher:

```bash
/Users/kirill_savinov_m4max/Documents/PROGRAMMING/PremiereProjectServer/scripts/start_production_auto_import.sh \
  --projects-dir "$HOME/Documents/Projects" \
  --target-name "Production"
```

После этого новые ZIP из `Downloads` будут импортироваться автоматически.

Остановить watcher:

```bash
/Users/kirill_savinov_m4max/Documents/PROGRAMMING/PremiereProjectServer/scripts/stop_production_auto_import.sh \
  --projects-dir "$HOME/Documents/Projects"
```

### 7.3 Автозапуск без терминала при каждом старте Mac

Чтобы вообще не запускать watcher вручную, установите `LaunchAgent` один раз:

```bash
/Users/kirill_savinov_m4max/Documents/PROGRAMMING/PremiereProjectServer/scripts/install_production_auto_import_launch_agent.sh \
  --projects-dir "$HOME/Documents/Projects" \
  --target-name "Production"
```

После этого watcher будет сам стартовать при входе пользователя в macOS.

Удалить автозапуск:

```bash
/Users/kirill_savinov_m4max/Documents/PROGRAMMING/PremiereProjectServer/scripts/uninstall_production_auto_import_launch_agent.sh
```

## 8. Доступ к сериям (ограничения по пользователю)

Супервайзер может выдать вам доступ:
- ко всем сериям (`Видеть все`);
- только к выбранным сериям.

Если серия не назначена вам, вы её не увидите в списке.

## 9. Что нельзя делать

- Не начинать монтаж без `Взять`.
- Не нажимать `Сдать`, если не загружен новый Production.
- Не работать параллельно в одной серии двумя людьми.
- Не передавать свой логин/пароль другим.

## 10. Типовые проблемы и что делать

`Сессия истекла. Войди снова.`:
- просто войдите заново.

`Нет доступа к этому проекту`:
- серия не назначена вам, напишите супервайзеру.

`Загрузку bundle может запрашивать только тот, кто держит проект в работе`:
- сначала возьмите серию, затем загружайте.

`Сначала загрузи ZIP ... затем сдавай проект`:
- сначала выполните `Загрузить Production`, потом `Сдать`.

Если интерфейс ведёт себя странно:
1. Сделайте жёсткое обновление страницы (`Cmd+Shift+R` / `Ctrl+F5`).
2. Повторите действие.
3. Если не помогло — отправьте супервайзеру скрин и точный текст ошибки.

## 11. Короткий чек-лист перед сдачей

1. Я взял серию через сервис.
2. Я проверил, что это моя серия (`МОЙ`).
3. Я загрузил новый Production.
4. Только после этого нажал `Сдать`.
5. Убедился, что серия стала `СВОБОДЕН`.