Обзор
Проверено 2 октября 2026 для этого сайта документации · у продукта нет инфраструктуры, потому что ничего не создано
Сегодня развёрнут только этот сайт документации, и его публикует каждый пуш в основную ветку: промежуточной среды нет, инфраструктуры продукта тоже пока нет.
Пуш в основную ветку — это публикация. Всё, что до него, происходит в отдельной ветке.
Что есть сегодня
| Что | Состояние на 2 октября 2026 |
|---|---|
| Исходный код | Один закрытый репозиторий на GitHub, в котором лежат этот сайт и инструменты вокруг него |
| Сайт документации | Статический сайт на DigitalOcean App Platform, собранный с помощью VitePress |
| Публикация | Автоматически при каждом пуше в основную ветку |
| Языки | Английский, русский и украинский, собираются и публикуются вместе |
| Приложение, API, мобильное приложение | Не созданы, не развёрнуты |
Как изменение попадает на сайт
- Работа идёт в отдельной ветке, в собственной рабочей копии.
- Проверка. Сайт собирается, затем проверяется то, чего успешная сборка не ловит: страница, которой нет на одном из трёх языков, мёртвая ссылка или якорь, страница, на которую ничто не ссылается. Затем сборка запускается, и каждая страница должна ответить.
- Ревью делает владелец. Агента-ревьюера нет: изменение читает и запущенный сайт смотрит человек, которому принадлежит проект.
- Слияние в основную ветку публикует.
- Кто-то открывает изменённую страницу на публичном сайте. Успешный деплой — ещё не видимая страница.
Так процесс был настроен 2 октября 2026. Через все пять шагов ещё не прошло ни одно изменение: коммиты, сделанные до этой даты, пушились прямо в основную ветку.
Рабочие копии и агенты
Одна задача получает одну рабочую копию, одну ветку и одного агента; этим управляет Orca. У каждой копии свои порты, поэтому несколько копий могут работать рядом, не задевая ни друг друга, ни основную копию. Агент доводит задачу до состояния «готово к ревью» и на этом останавливается; сам он изменения не сливает.
Скрипты, на которых это держится, — подготовка, запуск, проверка, уборка — 2 октября 2026 были пройдены от начала до конца в настоящей рабочей копии. Создавать копию через саму Orca ещё не пробовали.
Локальный запуск
Из корня репозитория make dev запускает сайт в режиме отслеживания изменений и открывает небольшую локальную панель: ссылки на локальный и опубликованный сайт на каждом языке, рабочие копии и то, что в них запущено, и живые логи. make check запускает проверку. И то и другое описано в README-файлах репозитория.
Чего нет
- Нет непрерывной интеграции. Проверка запускается на машине разработчика. На сервере ничто не остановит пуш, который её пропустил.
- Нет промежуточной или предварительной среды. Публичный сайт — единственная развёрнутая копия.
- Нет мониторинга. Опубликованный сайт проверяется, только пока у кого-то открыта локальная панель.
- Трекер задач не подключён. Задача — это то, с чем создана рабочая копия.
- Нет инфраструктуры для продукта. Хостинг, база данных, секреты, резервные копии и выпуск мобильного приложения не определены; см. Архитектуру. Единственное высказанное намерение — что более поздний сервис солвера будет работать в Kubernetes рядом с API; см. Агент и солвер.
Что читать дальше
- Архитектура: что придётся развернуть, когда это будет создано.
- Открытые вопросы: что решено, а что нет.