guard/docs/research
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
..
anti-bot.md v0.3: 6-layer architecture complete 2026-07-21 15:47:36 +02:00
architecture.md docs: per-task roadmap, architecture and changelog 2026-11-16 14:51:50 +01:00
benchmark.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
ddos.md v0.3: 6-layer architecture complete 2026-07-21 15:47:36 +02:00
ebpf.md v0.3: 6-layer architecture complete 2026-07-21 15:47:36 +02:00
envoy.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
haproxy.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
io_uring.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
load-test-report.md feat: VDS stress test harness (edge-only) and load-test results 2026-08-04 19:16:27 +02:00
networking.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
observability.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
papers.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
README.md docs: per-task roadmap, architecture and changelog 2026-11-16 14:51:50 +01:00
rust-performance.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
security.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00

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