transcriber/tasks/items/dev-run-task.md

# 🧹 Поднимать сервис для локальной работы одной командой

- **Тип:** chore
- **Категория:** Очередь — оснастка локального прогона: без неё каждую проверку начинают с двух терминалов и ручной уборки
- **Зачем:** Локальная проверка требует ручной чистки каталога данных и остановки процесса, а владельца панели заводят по одноразовой ссылке из журнала.

Шаг `task dev CONFIG=<путь> USER=<имя>` поднимает сервис, кладёт данные во
временный каталог, заводит владельца панели и гасит процесс по Ctrl+C.

Работа состоит из двух частей, и они едут одним коммитом: инструмент
подкоманда `cmd/devtools admin` и шаг `dev`, который её зовёт. Порознь они не
нужны — шаг без
инструмента не заведёт владельца панели, инструмент без шага останется вызовом,
который никто не делает.

Заглушки провайдера здесь больше нет: вход переезжает на доверенные заголовки
задачей `trusted-header-login`, и обычная учётная запись заводится первым же
запросом с заголовком. Каким способом заголовок попадает в запрос на машине без
прокси, решает та задача; этот шаг её решение только зовёт.

Задуманное устройство:

- конфиг пишет человек и передаёт путём — шаг его не сочиняет;
- шаг подменяет каталог данных: кладёт копию переданного конфига во временный
  каталог со своим `data_dir`, чтобы прогон начинался с пустой базы независимо от
  того, что написано в конфиге. Временное живёт в `/tmp` — в `data/` писать
  запрещено (CLAUDE.md, «Запреты»);
- владельца панели заводит подкоманда `cmd/devtools admin`. Пакет оснастки уже
  заведён задачей `trusted-header-login` и в образ не едет; своего пакета
  заводить не надо — решение владельца 2026-08-22: инструмент оснастки стоит
  четырёх мест, и платить их надо однажды. Базу подкоманда открывает тем же
  `pbrepo.New`, что и сервис, и потому получает её со схемой целиком; зовётся до
  подъёма сервиса, на пустом каталоге. Пароль существующего владельца не
  переписывает;
- обычная учётная запись заводится первым запросом с заголовком: имя берётся из
  `USER`, и заводить её отдельно шагу не нужно;
- `trap` на `INT` и `TERM` гасит процесс, `wait` держит терминал.

## Затрагивает

- `cmd/devtools` — подкоманда `admin` рядом с готовой `proxy`: заводит
  владельца панели в базе;
- `Taskfile.yml` — шаг `dev` с переменными `CONFIG` и `USER`;
- скрипт запуска в `scripts/` — он попадает под шаг `shell` гейта;
- `CLAUDE.md`, раздел «Команды»;
- `README.md`, раздел про локальный запуск;
- `Dockerfile` — строка сборки называет точку входа поимённо; новых пакетов не
  прибавляется, и правки ей не нужно.

## Критерии приёмки

- Команда поднимает сервис и печатает адрес, по которому открывать приложение,
  вместе со способом представиться. Оракул: прогон с тестовым конфигом — сервис
  слушает свой порт, названный адрес отвечает.
- Ctrl+C гасит процесс и не оставляет висящих. Оракул: `pgrep` по имени после
  остановки — пусто.
- Владелец панели входит своим паролем, а первый запрос с именем из `USER`
  заводит учётную запись. Оракул: вход по `auth-with-password` в коллекцию
  владельцев и запрос к коллекции пользователей во временной базе.
- Каталог данных лежит во временном месте, а `data/` не тронут. Оракул: путь базы
  из журнала подъёма и `git status` после прогона.
- `task gate` остаётся зелёным, скрипт проходит `shellcheck`, а образ не получает
  нового пакета. Оракул: прогон гейта целиком и `task image`.

## Рамки

Шаг локальный: наружу не ходит, боевых ключей не требует и в образ не попадает.
Идёт после `trusted-header-login` — до неё локальный вход устроен иначе.
Пароль владельца в конфиг **не заводится** — требование спеки `storage` «Пароль
владельца от панели не лежит в конфигурации» остаётся в силе, и работа его не
трогает. Распознавание при выдуманных ключах не работает — это остаётся как есть,
шаг его не подменяет.