- 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. |
||
|---|---|---|
| .. | ||
| anti-bot.md | ||
| architecture.md | ||
| benchmark.md | ||
| ddos.md | ||
| ebpf.md | ||
| envoy.md | ||
| haproxy.md | ||
| io_uring.md | ||
| load-test-report.md | ||
| networking.md | ||
| observability.md | ||
| papers.md | ||
| README.md | ||
| rust-performance.md | ||
| security.md | ||
Rampart - Research & Deep Dives
Это исследовательская документация. Здесь живут глубокие разборы технологий, эксперименты и идеи для версий v0.4+.
Для текущей архитектуры смотри ../architecture.md; здесь — исследования, эксперименты и обоснования решений.
Структура
| Файл | Что внутри | Актуально с |
|---|---|---|
| architecture.md | Дизайн-обоснование универсального редизайна (историческое) | v0.3 |
| ddos.md | Векторы атак L3/L4/L7, методы защиты, AI-боты | v0.1 |
| ebpf.md | XDP/eBPF фильтр, BPF maps, ringbuf, verifier | v0.4 |
| rust-performance.md | Zero-copy, io_uring, SO_REUSEPORT, NUMA, profiling | v0.3 |
| io_uring.md | Объединено с rust-performance.md | v0.4 |
| haproxy.md | HAProxy конфиг, mTLS, замена на Rust LB | v0.2 |
| envoy.md | EWMA балансировка, Circuit Breaker, xDS API | v0.5 |
| observability.md | Prometheus, OpenTelemetry, ClickHouse, Parca | v0.3 |
| anti-bot.md | Sonar, challenge системы, AI-обходы, fingerprint | v0.2 |
| benchmark.md | Инструменты, методология, ожидаемые результаты | v0.3 |
| security.md | STRIDE, mTLS, Zero Trust, supply chain | v0.2 |
| networking.md | WireGuard, BGP Anycast, QUIC, MTU | v0.3 |
| papers.md | Ссылки на статьи, RFC, проекты для изучения | - |
Как читать
Хочу понять текущее устройство
→ ../architecture.md
Хочу понять, почему система такая
→ architecture.md + ddos.md
Хочу добавить защиту от ботов
→ anti-bot.md
Хочу выжать максимум производительности
→ rust-performance.md + io_uring.md + ebpf.md
Хочу настроить мониторинг
→ observability.md
Хочу понять безопасность системы
→ security.md + networking.md
Операционные документы (корень docs/)
| Файл | Описание |
|---|---|
| deployment.md | Пошаговый деплой |
| configuration.md | Примеры конфигов |
| vds_compatibility.md | Таблица провайдеров |
| disaster_recovery.md | Failover сценарии |
| runbook.md | Инструкции для админа |
| api.md | REST API спецификация |
| testing.md | Методология тестирования |
| troubleshooting.md | FAQ |
Версия: 0.5-research | Июль 2026