# DoDo Provider Console · 0.1.1

Самостоятельная панель провайдера на вашем сервере. Она управляет вашим сервисом
через API DoDo и не содержит основную админку, общую базу пользователей,
административные ключи DoDo или настройки VPN-нод.

В этой версии есть подключение установки, отдельный вход владельца/редактора,
оформление, домены и DNS TXT, черновики и публикация сторис, загрузка фото/видео,
фильтры статистики 1/7/30 дней и по платформе. Установка панели сама по себе
не подтверждает домен выдачи ключей, допуск сервиса или оплату конкретного абонента.

## Что нужно

- Linux-сервер с Docker и Docker Compose v2; обратный прокси с действующим HTTPS.
- Отдельный домен кабинета, например `cabinet.example.com`, с A/AAAA на сервер.
- Аккаунт Google владельца сервиса в DoDo. Пароль и API-токен Remnawave не нужны.
- Исходящий HTTPS-доступ сервера к `api.dodoproxy.app`.

Панель не требует host network, привилегированного контейнера, Docker socket,
доступа к VPN-нодам или изменения маршрутов. Контейнер запускается от UID/GID
10001, с read-only корнем, отдельным приватным томом `/data`, лимитом 256 МБ
и публикацией порта только на `127.0.0.1:8795`.

## Установка из подготовленного архива

В архиве должны быть `dist/`, `Dockerfile.release`, `compose.yaml`, `.env.example`
и эта инструкция. Приватных файлов DoDo и полного backend-проекта в нём нет.

1. Распакуйте архив в отдельный каталог. Проверьте контрольные суммы:

   ```sh
   sha256sum -c SHA256SUMS
   cp .env.example .env
   ```

2. В `.env` задайте **точный HTTPS origin вашей панели**, без завершающего `/`:

   ```dotenv
   DODO_CONSOLE_ORIGIN=https://cabinet.example.com
   ```

   Это адрес кабинета, не домен выдачи ключей и не адрес API DoDo. Нестандартные
   порты и HTTP в production не принимаются. Корневые пароли, токены панели
   Remnawave и Firebase-ключи сюда добавлять не нужно.

3. Запустите:

   ```sh
   docker compose build --pull console
   docker compose up -d console
   docker compose ps
   ```

4. Настройте Caddy или существующий nginx на HTTPS-проксирование к
   `127.0.0.1:8795`, сохранив исходный `Host`. В `Caddyfile.example` дан минимальный
   пример. Публичный порт 8795 открывать не нужно. Проверку TLS не отключайте.

5. Откройте ваш кабинет в браузере. Получите приватный код первой настройки
   **в терминале своего сервера**:

   ```sh
   docker compose exec console node show-setup-code.mjs
   ```

   Команда намеренно выводит чувствительный код. Не присылайте его в поддержку,
   не публикуйте в скриншотах и не сохраняйте в Git. Обычные логи панели его
   не печатают. На странице кабинета введите код и нажмите «Подключить к DoDo».

6. Панель покажет короткий одноразовый код и ссылку на официальный кабинет DoDo.
   Войдите там через Google, выберите свой сервис или зарегистрируйте новый,
   проверьте адрес подключаемой установки и подтвердите действие. Вернитесь
   в свою панель: она проверяет результат не чаще одного раза в пять секунд.

7. После привязки нажмите «Войти через DoDo» и отдельно подтвердите вход человека.
   Доступ установки **не заменяет** роль владельца или редактора. Google-вход
   проходит на домене DoDo; регистрировать своё Google OAuth-приложение не нужно.

## Домены и привязка приложения

В разделе «Домены» добавьте **точный host выдачи ключей**, например
`sub.example.com`. Он может отличаться от адреса установленной панели.
Получите TXT-запись, разместите выданное значение в DNS и нажмите «Проверить DNS».
Уникальное значение берётся из кабинета, не из чужой инструкции.

После подтверждения домена и допуска сервиса добавьте к настоящему успешному
HTTPS-ответу выдачи ключа:

```http
x-dodo-provider-id: UUID_ВАШЕГО_СЕРВИСА
```

Этот UUID показан в обзоре. Это публичный идентификатор, не секрет API.
Название сервиса (`profile-title`) и контакт поддержки (`support-url`) не дают
прав на чужие отчёты. Право управлять данными проверяет центральный API.

Для публичного оформления и сторис модуль внутри Remnawave, signer и подтверждение
конкретного абонента не нужны. Строгое подтверждение абонента — другой протокол;
публичный ID и TXT не доказывают оплату и не открывают закрытую аудиторию.

## Сторис

Создайте черновик, загрузите JPEG/PNG/WebP или MP4, затем опубликуйте на 12 либо
24 часа. В этой панели фото ограничены 10 МБ, видео — 16 МБ и 30 секундами.
Файлы проверяет и обрабатывает сервер DoDo. Для публикации нужны действующий
DNS и допуск DoDo. Медиа опубликованной сторис сначала снимите с публикации.

Одновременно выполняется только одна бинарная передача — загрузка или просмотр
медиа. Другой запрос получит предложение повторить позже. Это защищает память
контейнера; панель не создаёт бесконечную очередь загрузок.

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

## Статистика: что именно показывается

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

Версия 0.1.1 показывает устройства с отчётами, платформы, модели, версии ОС и
DoDo, дату последнего отчёта и историю по дням UTC. Периоды — 1/7/30 дней.
Пакет приложения связывает публичный provider ID с точным доменом выдачи ключа;
сервер проверяет действующее DNS-подтверждение и допуск сервиса. Старые отчёты
только с названием и поддержкой не присваиваются кабинету задним числом.

Нужна новая совместимая версия iOS-клиента. Старые клиенты и Android пока не
передают этот дополнительный scope. Фильтр Android подготовлен, но до переноса
клиента реальных Android-отчётов этого типа не будет. Первые данные приходят в
рамках существующего лимита: максимум две попытки за 24 часа, не чаще 12 часов.

Это **не число людей онлайн и не число платящих абонентов**: одна установка
может иметь ключи нескольких сервисов, а после переустановки идентификатор может
измениться. Публичные ID и DNS не доказывают оплату или владение конкретным ключом.
Источник отмечен как сведения приложения, не проверенная база клиентов панели.
При отсутствии приёмника отображается `—`; при подключённом приёмнике без
отчётов — ноль и пояснение. В кабинет передаются только агрегаты, без списка
устройств, их идентификаторов, исходных URL и ключей. Отзыв аналитики удаляет
индивидуальные данные; при удалении ключа следующая отправка обновляет учёт.
Устаревшее/отозванное DNS-подтверждение исключает соответствующие записи.
В разбивках показываются первые 200 вариантов с пояснением; общий счётчик точный
в пределах полученных и прошедших проверку отчётов.

Адресные push, платежи и управление VPN-нодами в эту версию панели не входят.

## Сеансы, обновление доступа и отзыв

- API-доступ каждой установки отдельный, хранится в `/data/installation.json`
  с правами 600 и может быть отозван в основном кабинете DoDo. Срок — 30 дней.
- Сеанс человека действует до одного часа. Он хранится только в памяти сервера;
  после перезапуска потребуется новый вход.
- При смене роли, блокировке сервиса или отзыве установки центральный сервер
  проверяет права повторно. Панель не получает полномочия владельца платформы.
- Если срок установки истёк или доступ отозван, выберите «Повторно привязать
  установку». Потребуются приватный setup-код с сервера и новое подтверждение
  в DoDo. Старый файл доступа сохраняется до успешного завершения, затем все
  локальные человеческие сеансы закрываются. Старую запись установки отзовите
  в основном кабинете. Не удаляйте файлы вручную для обхода этой процедуры.

При недоступности DoDo кабинет покажет ошибку и позволит повторить действие.
Изменения не отправляются бесконечно и не повторяются автоматически. После
таймаута записи сначала обновите раздел: действие могло успеть завершиться.
Выход из локального кабинета работает и при недоступном DoDo.

Работа ключей и VPN не зависит от доступности установленной панели.

## Обновление, копия и откат

Перед обновлением сохраните текущий архив программы и сделайте приватную копию
тома. В нём находятся секреты установки, поэтому резерв нельзя публиковать:

```sh
umask 077
docker compose exec -T console tar -czf - -C /data . > console-private-backup.tar.gz
```

Разверните новый подготовленный архив, сохранив `.env`, имя Compose-проекта
и существующий том. Затем:

```sh
docker compose build --pull console
docker compose up -d --no-deps console
docker compose ps
```

Для отката верните предыдущий архив, соберите и запустите его с тем же томом.
Старая версия должна поддерживать текущий API DoDo; не понижайте версию вслепую.
Центральные данные сервиса не хранятся в этом контейнере и не восстанавливаются
из локальной копии поверх общей базы DoDo.

Для остановки достаточно `docker compose stop console`. Перед окончательным
удалением отзовите установку через основной кабинет. `docker compose down`
сохраняет именованный том; не добавляйте `-v`, если не хотите удалить приватные
данные без возможности восстановления.

## Сборка разработчиком

В исходном репозитории (из `backend-admin`):

```sh
npm ci --ignore-scripts
node provider-console/build.mjs
node node_modules/typescript/bin/tsc --noEmit -p provider-console/tsconfig.json
node --import tsx --test tests/provider-console-selfhost.test.ts
node provider-console/package-release.mjs /ПУТЬ/К/НОВОМУ/КАТАЛОГУ
```

`build.mjs` создаёт универсальный Node.js bundle с Express и его зависимостями.
В поставляемом runtime нет `npm install`, полного backend-проекта или owner UI.
`package-release.mjs` копирует только разрешённые runtime-файлы и создаёт
`SHA256SUMS`; существующий каталог не перезаписывается.

Для изолированного локального стенда предусмотрен явный non-production режим:
`DODO_CONSOLE_LOCAL_DEVELOPMENT=1`, HTTP только на literal loopback, отдельный
loopback API fixture и HTTPS `DODO_CONSOLE_REGISTRATION_ORIGIN` для метаданных
установки. В production переопределение центрального API игнорируется, а
небезопасный origin отвергается. Эти параметры не меняют VPN, прокси и маршруты Mac.

Проверка Node.js-кода и локального HTTP-цикла не является подтверждением запуска
Docker на сервере реального провайдера. Такой пилот нужно фиксировать отдельно.
