Files
hpnn-proto/docs/CHANGE_SPLIT_DATAFLOW_DOCS_SUMMARY.md
T

3.4 KiB

Итоги: разделение документа потоков данных

Дата: 2026-08-17 Статус: выполнено План: CHANGE_SPLIT_DATAFLOW_DOCS_PLAN.md

Что сделано

docs/ROUTING_DATAFLOW.md удалён, вместо него — два самостоятельных документа, по одному на каждый вид балансировки:

Документ Сценарий Характер пути
PUBLIC_LB_DATAFLOW.md клиент из 192.168.5.0/24 → 192.168.5.21:80 целиком маршрутизируемый, dec_ttl в обе стороны
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 — ссылка в перечне документации.

Ссылок на удалённый документ в репозитории не осталось, кроме упоминаний в плане и в этих итогах — там они описывают само изменение.