drhider/History/upload-integration/2026-09-15-upload-platform-v022-integration-report.md

2026-09-15: Интеграция upload-platform v0.2.2 в drhider

1. Цель и контекст

Интеграция протестированного модульного релиза upload-platform v0.2.2 в сервис drhider. Версия сервиса повышена: v0.0.77 \rightarrow v0.0.78.

2. Выполненные изменения

Ядро модуля upload/

• Слой 1 (Frontend): переход на модульный initFilePicker с распаковкой ZIP через fflate, древовидным представлением папок и архивов, встроенным сворачиванием/разворачиванием групп и дедупликацией. Устаревшие ручные парсеры удалены.
• Слой 2 (Transit Upload):
  • Frontend: пофайловый стриминговый транзит uploadViaVM (PUT на ВМ \rightarrow POST /api/upload_refs \rightarrow исходящий pull \rightarrow DELETE из буфера \rightarrow повтор для следующего файла).
  • Backend: обновлён Blueprint create_upload_refs_blueprint: добавлена поддержка локальных путей/mock-буфера (is_path_only_prefix), кастомного httpxTransport для безопасного тестирования, возвращение параметра added.
  • Session: in-memory хранилище сессий с потокобезопасным TTL и проверкой лимитов.

Приложение Flask и маршруты

• В site/routes/main_bp.py добавлены маршруты раздачи бандлов: /file-picker/<path:filename> и /dist/<path:filename>.
• Бандлы file-picker.iife.js и file-picker.esm.js размещены в dist/ и site/static/dist/.

Пользовательский интерфейс (site/templates/index.html)

• Вёрстка выбора файлов заменена контейнером #filePicker.
• Инициализирован FilePicker.initFilePicker с разрешёнными расширениями (.pdf, .doc, .docx, .txt, .md).
• Логика кнопки «🛡️ Обфусцировать» переведена на FilePicker.uploadViaVM с поддержкой отмены (AbortController) и пофайловым отображением статусов.
• Сохранён и адаптирован этап 2 обработки (SSE /api/process_stream/<sid>, тикеры времени, статистика LLM, выгрузка ZIP и CSV).

Тесты

• Скопированы и адаптированы тесты:
  • tests/test_hardening.py (проверка устойчивости, malformed requests, SSRF, traversal).
  • tests/test_safe_name.py (санитизация путей).
• Обновлён tests/test_upload.py (длина сессии uuid4().hex = 32 символа).

3. Проверки и верификация

• pytest tests/: 39 passed в 4 тестовых файлах.
• python3 tests/test_builder.py: 20/20 PASS.
• python3 tests/test_extractor.py: 10/10 PASS.
• python3 tests/test_replacer.py: 10/10 PASS.
• python3 tests/test_scanner.py: 20/20 PASS.
• python3 tests/test_zip.py: 28/28 PASS.
• Проверка синтаксиса py_compile по всем .py файлам проекта: ALL PY FILES COMPILED OK.
• Проверка импортов ядра: from drhider import obfuscate_files, LLMClient \rightarrow OK.
• Проверка HTTP:
  • GET / \rightarrow HTTP 200, HTML отрендерен (28571 байт).
  • GET /health \rightarrow HTTP 200, {"ok":true,"version":"0.0.78"}.
  • GET /file-picker/file-picker.iife.js \rightarrow HTTP 200 (44465 байт).