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