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

View file

@ -3,7 +3,8 @@
> Это исследовательская документация. Здесь живут глубокие разборы технологий,
> эксперименты и идеи для версий v0.4+.
>
> Для текущей архитектуры (v0.1-v0.3) смотри `ARCHITECTURE.md` в корне репо.
> Для текущей архитектуры смотри [../architecture.md](../architecture.md); здесь —
> исследования, эксперименты и обоснования решений.
---
@ -11,7 +12,7 @@
| Файл | Что внутри | Актуально с |
|---|---|---|
| [architecture.md](./architecture.md) | Общая архитектура, компоненты, схемы C4 | v0.1 |
| [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 |
@ -30,7 +31,9 @@
## Как читать
```
Хочу написать первую версию (v0.1)
Хочу понять текущее устройство
→ ../architecture.md
Хочу понять, почему система такая
→ architecture.md + ddos.md
Хочу добавить защиту от ботов
→ anti-bot.md

View file

@ -1,7 +1,8 @@
# Architecture — Rampart
# Architecture — Rampart (design rationale, v0.3)
> Relevant for: v0.3+ (universal redesign)
> Status: primary design document
> Status: historical design rationale — the current system is described in
> [../architecture.md](../architecture.md)
> Language: English (research notes) — see [RU summary](#russian-summary) at the end
---