Студия автора

Локальное приложение, в котором собирается практика. Три шага, каждый заканчивается утверждением, и ничего не уезжает студентам, пока автор не согласился с результатом.

запуск

TESTCONTAINERS_RYUK_DISABLED=true uv run gen studio --pack packs/spike --mock --port 8765

Флаг	Что делает
--pack	каталог пака; создаётся, если его нет
--port	порт студии, по умолчанию 8765
--mock	вместо вызовов LLM берёт заготовленные ответы из <пак>/mock_llm/

Живая генерация требует ключа в .env (OPENROUTER_API_KEY). Docker нужен всегда: проверки исполняются в эфемерном Postgres, который студия поднимает сама.

Раскладка

Верхней шапки нет — по вертикали место дороже. Слева узкая полоса шагов, дальше содержимое шага, у третьего шага добавляется список заданий и инспектор справа.

шаг 3Полоса шагов, список заданий с поиском и группами по темам, отчёт задания, инспектор.

Полоса шагов показывает состояние каждого шага цветом точки и подписью:

Состояние	Что значит
пусто	шаг ещё не проходили
черновик	результат есть, но не утверждён
утверждено	зафиксировано хэшем, можно идти дальше
устарело	предыдущий шаг изменился после утверждения этого

Внизу полосы — переключатель светлой и тёмной схемы и имя текущего пака.

Порядок шагов

Предметная область

Название занятия, про что база, темы SQL с квотами заданий. Генерируется описание базы и DDL, схема тут же проверяется на живом Postgres. Подробно

Задания

Формулировки по утверждённой области. Покрытие тем считается до утверждения: не хватает заданий по теме — студия покажет, по какой. Подробно

Решения и проверки

На каждое задание — эталонное решение, спека данных, варианты, набор проверок и негативные решения. Отчёт приёмки показывает всё это целиком. Подробно

Шаги строго последовательны: пока область не утверждена, второй шаг сообщит об этом вместо формы. Это не формальность — задания генерируются по DDL области, а проверки строятся по формулировкам заданий.

Что делать без API-ключа

Любой шаг проходится вручную: студия отдаёт готовый промт, автор относит его в любую нейросеть и вставляет ответ обратно. Формат ответа тот же, что у API, поэтому дальше конвейер не различает, откуда пришёл JSON. Ручной режим

Что автор видит и чего не видит студент

Студия показывает автору всё содержимое пака: эталонные решения, все варианты данных с квотами, ожидаемые результаты, все проверки, включая скрытые, негативные решения и матрицу их отлова. Приложение студента отдаёт из этого только открытые примеры и тот скрытый вариант, на котором решение студента уже упало.

Открывайте студию на широком экране

С 1280 пикселей видны все три колонки. Ниже 1280 инспектор скрывается кнопкой «Показать инспектор», ниже 1024 список заданий превращается в выездной.