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

47 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 обновлён.
- [ ] Лицензия базы и ограничения описаны в документации.