Indexium/docs/adr/002-async-indexer.md

ADR-002: Асинхронный событийный индексатор поверх GitHub Releases

Дата: 2026-09-06 Статус: Принято

Контекст

Нужен дешёвый и устойчивый к лимитам GitHub способ индексировать моды. Хранить .jar у себя дорого, проксировать трафик — упрёмся в bandwidth и rate limits.

Решение

Бэкенд не хранит артефакты. GitHub Releases CDN — источник правды для файлов. Мы только:

• принимаем webhook release.published (HMAC + queue + 202),
• воркер читает zip central directory через Range Request,
• парсит манифест (fabric.mod.json и т.д.),
• пишет метаданные в Postgres,
• отдаёт прямые download_url на objects.githubusercontent.com.

Подробнее в docs/architecture.md.

Последствия

• Плюс: минимальный storage, нет egress costs, +5k–12.5k RPH через GitHub App.
• Минус: зависимость от доступности GitHub CDN (приемлемо — моды и так там).
• Вынесен malware-скан и SHA-256 сверка как обязательные.

Альтернативы

• Хранить файлы у себя (S3) — отклонено: дорого, дублирование.
• Полный pull .jar на каждый релиз — отклонено: трафик, медленно.