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