contracts/DOC/how-to-test-upload-devops.md

Как проверить загрузку файлов в Contracts (для DevOps Nubes)

Цель: воспроизвести «чистую» загрузку файла с клиента на сервер, без обработки, чтобы поймать обрыв на ингрессе/периметре (граница ~64 КБ, плавает по маршруту).

1. Какой инстанс / где смотреть

• Деплой и домен: смотри contracts-flask/deploy/ и VM.md (в этой репе).
• Внешний путь: NSX Edge + AVI ALB → Kubernetes Ingress (nginx) → поды Flask.
• Сервер отдаёт именно загрузку файлов: интерфейс = выбор файла в локали → клиент режет на чанки 50 КБ → POST /chunk → сервер копит и собирает файл.

2. Что важно знать (контекст из истории)

• Проблема ингресса уже встречалась: прямой POST файла резался client_max_body_size (весной, PDF 153 КБ → «✗ Сеть»).
• Сейчас обход — чанковая загрузка по 50 КБ (file.slice(0,50KB) → /chunk). Значит, «большой файл» для проверки = много чанков, а не один POST.
• Для диагностики полезно проверить ОБА способа: а) обычная загрузка через UI (чанки); б) прямой большой POST = то, что ближе к «чистому» обрыву на шлюзе.

3. Как проверять (по шагам)

Шаг 1. Поднять/найти инстанс

• Определи, где сейчас развёрнут сервис (см. deploy/, VM.md).
• Убедись, что сервис отвечает (лендинг/UI).

Шаг 2. Чистая загрузка через UI (чанки)

• В веб-интерфейсе выбери файл в локали (начни с 1–5 МБ).
• Наблюдай прогресс: чанки должны идти последовательно.
• Критерий сбоя: прогресс встаёт, «✗ Сеть», или не хватает чанков при сборе.

Шаг 3. Прямой большой POST (обнажает границу шлюза)

• Одним запросом отправь файл ~1–5 МБ на endpoint загрузки.
• Ожидание: если проблема есть — запрос обрывается на ~середине, частичная передача, таймаут.
• Сравни с малым файлом (~10 КБ): должен пройти мгновенно.

Шаг 4. Серия размеров (найти границу)

• Прогони один и тот же файл в размерах: ~10 КБ, ~50 КБ, ~64 КБ, ~100 КБ, ~1 МБ, ~5 МБ.
• Зафиксируй порог, с которого начинаются сбои (у нас он плавает ~64 КБ).

Шаг 5. Снять симптомы «глазами пользователя»

• Что видит пользователь: прогресс%, код ошибки браузера, «Сеть»/таймаут.
• Если есть доступ к подам: логи nginx-ингресса и пода на момент обрыва (хватит ли байт пришло).

4. Что сообщить DevOps по результатам

• Размер, на котором воспроизводится обрыв (порог).
• Это чанки или прямой POST.
• Точное время и домен инстанса (у нас баг нестабилен — плавает по маршруту, поэтому важно поймать момент и передать «на горячем»).

5. Полезные ссылки из репо

• History/sessions/session-07-chunks.md — вся история чанковой загрузки и обхода client_max_body_size.
• History/architecture-research-v2-2026-06-27.md — поток Upload→Parse→…