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.
This commit is contained in:
Loki 2026-11-16 14:51:50 +01:00
parent 1b3ae5e546
commit 280284667f
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
38 changed files with 1582 additions and 623 deletions

100
CHANGELOG.md Normal file
View file

@ -0,0 +1,100 @@
# Changelog
Все значимые изменения проекта. Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
версии — [Semantic Versioning](https://semver.org/lang/ru/).
---
## [Unreleased]
### Added
- `docs/architecture.md` — текущее устройство системы (процессы, путь трафика,
слои, хранилища, метрики).
- `docs/development.md` — принципы, лимиты, гейты, Definition of Done.
- `docs/roadmap/` — по одному файлу на задачу; `TODO.md` стал тонким индексом.
- `CHANGELOG.md` — этот файл.
### Changed
- `[profile.release]`: `lto = "thin"`, `codegen-units = 1`. Релизный бинарь с
`protocol-http` уменьшился с 12.3 МБ до 9.7 МБ (−21%); `http_parser/evaluate`
в criterion — 314 нс → 278 нс (−12%), остальные бенчмарки в пределах шума.
- CI: экшены обновлены до node24-версий, раннер закреплён на `ubuntu-24.04`.
### Fixed
- Docker edge image: в сборку добавлен `benches/`, без него Cargo не парсил
манифест и образ не собирался (exit 101).
- `rampart-cli status` подсказывал неверный бинарь (`rampart doctor` вместо
`rampart-cli doctor`).
- Документация приведена в соответствие с кодом: дефолты `[xdp]`/`[detect]`,
имена метрик XDP, таблица ClickHouse (`rampart_events`), восстановление Redis
из RDB, путь к схеме конфига, команда сборки BPF с multiarch-инклюдом.
### Removed
- Неиспользуемое поле `role` в JWT claims (RBAC не реализован; вернуть вместе с
реальными ролями).
---
## [0.3.0-dev] — 2026-11-16
Big-bang редизайн: из Minecraft-специфичной защиты в универсальную L3/L4/L7
платформу.
### Added
- Единый пакет `rampart` с бинарями `rampart`, `rampart-manager`, `rampart-cli`,
`rampart-tui`; Java-плагины и dashboard удалены.
- Протокол-плагины: `protocol-http` (HTTP/1.1 request-head) и
`protocol-minecraft` (handshake/list/login, один upstream, PROXY v2).
- XDP: universal-фильтр для IPv4/IPv6, LPM blacklist/whitelist, SYN-throttle,
UDP policy (pass/drop/rate-limit), prefix-статистика, RST-challenge,
ringbuf-события и opt-in auto-ban.
- Subnet-level detection: prefix-статистика `/24` и `/64`, оценка числа
источников по bitmap, лестница вердиктов strict → challenge → block.
- Traffic Intel в горячем пути: EWMA-детектор, репутация, авто-баны, webhook
алерты на переход состояния.
- Manager API: pagination/`SCAN` вместо `KEYS`, rate-limit мутаций, body limit
и таймауты, graceful shutdown, backfill метаданных blacklist, `X-Forwarded-For`
только от `MANAGER_TRUSTED_PROXIES`.
- PROXY protocol v2 на входе: строгая валидация адреса, доверенные CIDR,
запрет бана доверенных сетей.
- TUI-дашборд live-метрик; Prometheus `/metrics`.
- Инфраструктура: fuzz-цели `http_head` и `proxy_v2`, criterion-бенчмарки
горячего пути, e2e-тест edge на loopback, netns-скрипты XDP.
### Changed
- IPv6-паритет XDP: blacklist, UDP rate-limit, prefix-статистика, whitelist.
- Expiry банов переведён на монотонные часы; просроченные префиксные баны
удаляет userspace-reaper.
- Тесты вынесены из `src/` в `tests/` (правило «тесты отдельно от кода»).
### Fixed
- XDP: длина TCP-payload по `ip->tot_len` (Ethernet-паддинг), VLAN/QinQ до L3,
фрагменты по blacklist, чтение map до `bpf_map_delete_elem` (UAF), `.rodata`
раскладка и имена карт в загрузчике.
- Data path: backoff на `accept()`, корректный shutdown, глобальный бюджет,
rate-limit до PoW, таймауты connect/handshake/relay.
- Blacklist: CIDR-баны диапазонами, нормализация IPv4-mapped, TOCTOU,
атомарный `replace_redis`.
- Manager: auth bypass, утечки и зависания, найденные ревью.
### Security
- `API_PASSWORD` ≥ 16 символов и не `changeme`; `JWT_SECRET` ≥ 32 непробельных
байт; audience-валидация.
- `syn_challenge_enabled` требует собственный секрет, placeholder отклоняется.
- Compose без публичных Redis/ClickHouse и без дефолтных паролей; пустой
`CORS_ORIGIN` → cross-origin запрещён.
---
## [0.2.0] — 2026-07-20
- Первый публичный релиз: 6-слойный Minecraft-стек (XDP → PoW → Rust core →
Velocity → Paper agent → Traffic Intel), Java-плагины и dashboard.