- 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.
2.3 KiB
2.3 KiB
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
- Абстракция
GeoLookup(trait) + реализация наmaxminddb, чтобы тесты не требовали бинарной базы. - Интеграция в
Gateway::handle_clientпосле blacklist, до PoW. - Fail-fast:
geoipвключён, база не читается → отказ старта с понятной ошибкой. - Тесты: фикстура MMDB в
tests/fixtures/(маленькая, с явной лицензией).
Критерии приёмки
- Конфиг валидируется: неизвестная страна/ASN — ошибка, а не тихий пропуск.
- Нет базы — фича выключена, edge работает.
- Метрики покрыты тестами; docs/configuration.md обновлён.
- Лицензия базы и ограничения описаны в документации.