gotosocial/openspec/changes/deploy-gotosocial/specs/gotosocial-deploy/spec.md

GoToSocial Deploy — Delta Spec

ADDED Requirements

Requirement: Инстанс GoToSocial работает в Docker на bigbox

• MUST: Сервис GoToSocial запускается как Docker-контейнер из /opt/gotosocial через docker compose
• MUST: Используется образ с фиксированным тегом последнего стабильного релиза (например superseriousbusiness/gotosocial:v0.22.1)
• MUST: Контейнер имеет volume для данных: data/sqlite.db (SQLite) и data/storage (медиа)
• MUST: Приложение слушает порт внутри контейнера, проброшенный наружу (например 8080:8080)
• SHOULD: Рестарт контейнера настроен (restart: unless-stopped)

Scenario: Контейнер запущен

• GIVEN контейнер запущен, WHEN docker ps, THEN контейнер gotosocial в статусе Up
• GIVEN сервис работает, WHEN curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:<port>/, THEN HTTP 200

Requirement: Split-domain — host social.dedinit.ru, account-domain dedinit.ru

• MUST: В config.yaml: host: social.dedinit.ru, account-domain: dedinit.ru, protocol: https
• MUST: Не менять host/account-domain после первого запуска (необратимо)
• MUST: На apex dedinit.ru (Jino) добавлены редиректы:
  • /.well-known/webfinger → https://social.dedinit.ru/.well-known/webfinger
  • /.well-known/nodeinfo → https://social.dedinit.ru/.well-known/nodeinfo
  • /.well-known/host-meta → https://social.dedinit.ru/.well-known/host-meta
• SHOULD: Проверить редиректы после публикации на apex

Scenario: Webfinger резолвится

• GIVEN инстанс запущен, WHEN curl -s -H 'Accept: application/json' 'https://social.dedinit.ru/.well-known/webfinger?resource=acct:estorozhenko@dedinit.ru', THEN JSON с actor
• GIVEN apex настроен, WHEN curl -s -o /dev/null -w '%{http_code}' -L 'https://dedinit.ru/.well-known/webfinger?resource=acct:estorozhenko@dedinit.ru', THEN 200 после редиректа

Requirement: TLS через Caddy на vps02

• MUST: Caddy (vps02, host net) имеет блок social.dedinit.ru { reverse_proxy 10.8.0.2:<port> }
• MUST: Caddy выпускает Let's Encrypt сертификат для social.dedinit.ru автоматически
• MUST: GtS доверяет прокси: в config.yaml trusted-proxies включает IP/подсеть Caddy (например 10.8.0.2)
• SHOULD: Header Host и X-Forwarded-Proto передаются в GtS

Scenario: HTTPS работает

• GIVEN Caddy настроен, WHEN curl -s -o /dev/null -w '%{http_code}' https://social.dedinit.ru/, THEN 200
• GIVEN сертификат, WHEN echo | openssl s_client -connect social.dedinit.ru:443 2>/dev/null | openssl x509 -noout -dates, THEN даты валидны

Requirement: SMTP-отправка писем

• MUST: config.yaml содержит SMTP: smtp.jino.ru:587, STARTTLS, логин social@dedinit.ru (пароль из .env)
• MUST: Письма (подтверждение email, уведомления) отправляются через SMTP-сервер
• SHOULD: Проверка отправки тестового письма

Scenario: Отправка письма

• GIVEN SMTP настроен, WHEN администратор инициирует отправку (например создание пользователя / тест), THEN письмо доставлено на указанный адрес
• GIVEN неверный пароль SMTP, WHEN отправка, THEN в логах GtS ошибка аутентификации (не тихий fail)

Requirement: Метрики Prometheus

• MUST: В config.yaml: metrics-enabled: true
• MUST: Переменные окружения OTEL_METRICS_PRODUCERS=prometheus, OTEL_METRICS_EXPORTER=prometheus
• MUST: Эндпоинт /metrics отдаёт метрики в формате Prometheus (Go runtime, Gin HTTP, Bun DB)
• SHOULD: Prometheus на bigbox скрейпит 127.0.0.1:<port>/metrics (добавлен job)

Scenario: Эндпоинт метрик

• GIVEN GtS запущен, WHEN curl -s http://127.0.0.1:<port>/metrics | head, THEN вывод содержит go_goroutines, gin_, bun_ префиксы
• GIVEN Prometheus настроен, WHEN curl http://127.0.0.1:9090/api/v1/targets, THEN job gotosocial в статусе UP

Requirement: Логи в JSON для сбора

• MUST: config.yaml: log-format: json (для Promtail/Loki)
• SHOULD: Promtail собирает docker-логи контейнера gotosocial (label container=gotosocial / job gotosocial)

Scenario: Логи в JSON

• GIVEN контейнер пишет логи, WHEN docker logs gotosocial | head, THEN строки в JSON-формате

MODIFIED Requirements

(нет)