openspec: архивирован change gotosocial-publisher (2026-09-13), delta влита в specs/gotosocial-publisher

openspec/changes/archive/2026-09-13-gotosocial-publisher/specs/gotosocial-publisher/spec.md

@@ -0,0 +1,69 @@
+## ADDED Requirements
+
+### Requirement: Fediverse-канал в publisher-service
+
+* publisher-service MUST уметь публиковать карточку в GoToSocial через Mastodon-совместимый REST API при указании fediverse-канала в запросе или конфиге.
+* publisher-service MUST отправлять текст статуса через `POST /api/v1/statuses` с заголовком `Authorization: Bearer <GT_SOCIAL_ACCESS_TOKEN>`.
+* publisher-service MUST обрезать текст до 5000 символов (лимит GtS) перед публикацией, сохраняя ссылку на оригинал последней строкой.
+* publisher-service MAY поддерживать visibility из конфига (`GT_SOCIAL_VISIBILITY`, default `public`).
+* publisher-service MUST включать fediverse-канал в fan-out: ошибка одного канала не должна отменять публикацию в остальные (поведение как у Telegram-каналов).
+* publisher-service MUST в режиме `dry_run` эмулировать публикацию в fediverse без реального HTTP-запроса наружу.
+
+#### Scenario: Публикация карточки в GoToSocial
+
+GIVEN конфиг publisher содержит `GT_SOCIAL_URL=https://social.dedinit.ru` и `GT_SOCIAL_ACCESS_TOKEN=<токен @vesti>`,
+WHEN веб (или curl) отправляет `POST /api/v1/publish` с `card: {text, media?}` и каналом `@vesti@dedinit.ru`,
+THEN publisher вызывает `POST https://social.dedinit.ru/api/v1/statuses` с Bearer-токеном и текстом,
+AND ответ содержит `results["@vesti@dedinit.ru"].message_id` = id созданного статуса
+AND `ok=true`, если GtS вернул 200.
+
+#### Scenario: Публикация с медиа
+
+GIVEN у карточки есть `media` и файл существует,
+WHEN publisher публикует в fediverse-канал,
+THEN publisher сначала загружает файл через `POST /api/v2/media` (multipart), получает `media_id`,
+AND передаёт массив `media_ids` в `POST /api/v1/statuses` (до 6 вложений).
+
+#### Scenario: dry_run не уходит наружу
+
+GIVEN `dry_run=true` в запросе,
+WHEN publisher обрабатывает fediverse-канал,
+THEN в `results["@vesti@dedinit.ru"]` возвращается пустой `ChannelResult()` (message_id=0)
+AND реальный HTTP-запрос к social.dedinit.ru НЕ выполняется.
+
+#### Scenario: GtS недоступен
+
+GIVEN GoToSocial не отвечает (сеть/HTTP 5xx),
+WHEN publisher публикует в fediverse-канал,
+THEN в `results["@vesti@dedinit.ru"].error` — понятное сообщение об ошибке
+AND остальные каналы (Telegram) публикуются как обычно
+AND `ok=false` (но без общего 502, если хотя бы один канал успешен).
+
+### Requirement: Конфигурация fediverse
+
+* publisher-service MUST читать настройки GtS из env: `GT_SOCIAL_URL`, `GT_SOCIAL_ACCESS_TOKEN`, `GT_SOCIAL_VISIBILITY` (SECRETS в .env).
+* publisher-service MUST добавлять в `/healthz` блок `gotosocial`: url, аккаунт (из verify_credentials), `token_set`.
+* publisher-service MUST определять fediverse-канал по признаку: содержит `@` + точка (например `@vesti@dedinit.ru`) или префикс `gt:` — и НЕ трактовать его как Telegram (chat_id).
+
+#### Scenario: healthz показывает состояние GtS
+
+GIVEN publisher запущен с настроенным GT_SOCIAL_ACCESS_TOKEN,
+WHEN GET /healthz,
+THEN ответ содержит `gotosocial: {url, token_set: true, account: <username>}` (или `account_ok: false` при сбое verify_credentials).
+
+#### Scenario: token не задан
+
+GIVEN `GT_SOCIAL_ACCESS_TOKEN` пуст,
+WHEN publisher получает запрос публикации в fediverse-канал,
+THEN результат канала содержит `error` «GT_SOCIAL_ACCESS_TOKEN не задан» (HTTP-статус общий 502 при пустых остальных),
+AND healthz показывает `token_set: false`.
+
+### Requirement: Удаление статуса (поддержка отмены тестовых)
+
+* delete_status MUST удалять статус по id через `DELETE /api/v1/statuses/{id}` (для отмены тестовых публикаций/очистки канала); это SHOULD-часть publisher-service.
+
+#### Scenario: Удаление статуса
+
+GIVEN существует статус с id=123 в GtS,
+WHEN вызывается `gotosocial.delete_status(123)`,
+THEN GtS возвращает 200 и статус исчезает из ленты (проверяется GET /api/v1/statuses/123 → 404).