guard/docs/roadmap/v0.5-geoip-asn.md
loki5512344 280284667f
docs: per-task roadmap, architecture and changelog
- Split TODO into a thin status index plus docs/roadmap/ with one file per
  task (v0.4 reliability, v0.5 product, v0.6 research, icebox).
- Add docs/architecture.md (current processes, packet/data path, layers,
  storage, metrics) and docs/development.md (rules, gates, DoD).
- Add CHANGELOG.md reconstructed from history; move round details out of
  TODO.
- Align docs with the code: config defaults and missing [detect]/
  [protocol.http] sections, XDP metric names, ClickHouse table and TTL,
  Redis RDB restore, multiarch clang include, CLI binary name.
- Add scripts/check_docs_links.sh and run it in CI.
- release profile: thin LTO + one codegen unit. Binary 12.3 MB -> 9.7 MB,
  http parser bench 314 ns -> 278 ns; panic=abort stays off for
  catch_unwind in the Redis subscriber.
- Drop the unused JWT role claim; fix 'rampart doctor' hints in the CLI.
2026-11-16 14:51:50 +01:00

2.3 KiB
Raw Blame History

v0.5 — GeoIP/ASN reputation

Milestone v0.5
Status idea
Priority P1
Depends on —

Цель

Фильтрация и репутация по стране/ASN: блокировка нежелательных регионов, понижение репутации хостинговых ASN, белый список «домашних» сетей.

Зачем

Feature-флаг geoip и maxminddb в зависимостях есть, но реализации нет — «мёртвый код = баг» по правилам проекта. Для VDS-ниши страна/ASN — базовый фильтр, который конкуренты либо не дают, либо дают только в платной версии.

Scope

  • Загрузка MaxMind MMDB (страна, ASN) при старте; hot-reload файла по SIGHUP или таймеру.
  • Конфиг: список разрешённых/запрещённых стран и ASN, режим (drop/challenge).
  • Метрики: вердикты по странам/ASN, ошибки чтения базы.
  • XDP-путь не трогаем: GeoIP — userspace-фильтр на этапе Gateway.

Non-goals

  • Собственная GeoIP-база.
  • Блокировка по городу/координатам.

Approach

  1. Абстракция GeoLookup (trait) + реализация на maxminddb, чтобы тесты не требовали бинарной базы.
  2. Интеграция в Gateway::handle_client после blacklist, до PoW.
  3. Fail-fast: geoip включён, база не читается → отказ старта с понятной ошибкой.
  4. Тесты: фикстура MMDB в tests/fixtures/ (маленькая, с явной лицензией).

Критерии приёмки

  • Конфиг валидируется: неизвестная страна/ASN — ошибка, а не тихий пропуск.
  • Нет базы — фича выключена, edge работает.
  • Метрики покрыты тестами; docs/configuration.md обновлён.
  • Лицензия базы и ограничения описаны в документации.