Files
hpnn-proto/docs/CHANGE_SPLIT_DATAFLOW_DOCS_SUMMARY.md
T

46 lines
3.4 KiB
Markdown
Raw Normal View History

# Итоги: разделение документа потоков данных
**Дата:** 2026-08-17
**Статус:** выполнено
**План:** [CHANGE_SPLIT_DATAFLOW_DOCS_PLAN.md](CHANGE_SPLIT_DATAFLOW_DOCS_PLAN.md)
## Что сделано
`docs/ROUTING_DATAFLOW.md` удалён, вместо него — два самостоятельных документа,
по одному на каждый вид балансировки:
| Документ | Сценарий | Характер пути |
|---|---|---|
| [PUBLIC_LB_DATAFLOW.md](PUBLIC_LB_DATAFLOW.md) | клиент из `192.168.5.0/24` → `192.168.5.21:80` | целиком маршрутизируемый, `dec_ttl` в обе стороны |
| [PRIVATE_LB_DATAFLOW.md](PRIVATE_LB_DATAFLOW.md) | клиент внутри сегмента → `10.20.0.100:80` | коммутируемый для соседа по сегменту, маршрутизируемый для члена из другого |
Каждый документ самодостаточен: своя схема участников, свой конвейер таблиц,
свои потоки, таблица решений, точки обрыва, команды осмотра и ограничения.
Читатель, которому нужен один сценарий, не встречает ветвей другого.
## Как поделено содержимое
- **Публичный документ**: ARP- и ICMP-респондеры публичного сегмента, обучение
adjacency клиента, листенер `VIP:80`, DNAT, маршрутизация 20/21, обратный путь
через таблицу 15, профиль A как условие возврата ответа.
- **Приватный документ**: предпосылка «порт ВМ — порт OVS», сегментация и
обучение FDB в таблице 0, классификация по MAC назначения в таблице 1, два
пути выдачи в таблице 12, обратная трансляция в таблице 24, коммутация в
таблице 25, а также остальной трафик сегмента — `be↔be`, прямые обращения
клиента, egress, ARP и health-пробы.
- **Общее** (таблица слотов, `pool_id`, fail-close, health-check) упомянуто в
обоих ровно в той мере, в какой участвует в пути: пул и хэш у листенеров
общие, и это сказано в каждом документе.
Каждая диаграмма перерисована под свой сценарий: в публичном конвейере нет
таблиц 24 и 25, в приватном — ветви `reg0=1`.
## Изменённые файлы
- добавлены `docs/PUBLIC_LB_DATAFLOW.md`, `docs/PRIVATE_LB_DATAFLOW.md`;
- удалён `docs/ROUTING_DATAFLOW.md`;
- `README.md` — вместо одной ссылки две, с пояснением, какая для чего;
- `docs/STEP3_IMPLEMENTATION_PLAN.md` — ссылка в перечне документации.
Ссылок на удалённый документ в репозитории не осталось, кроме упоминаний в
плане и в этих итогах — там они описывают само изменение.