upload-platform/HISTORY/2026-09-05-code-documentation.md

Документация кода picker-only

Что сделано

• Добавлены подробные комментарии и JSDoc в собственные JS-модули picker-а.
• Добавлены пояснения к Flask entrypoint, HTML-шаблону, CSS и пакетному upload/__init__.py.
• Добавлен docs/CODE-REFERENCE.md со схемой архитектуры, моделью узлов, состоянием, публичным API, функциями модулей и описанием legacy-кода.
• Ссылки на справочник добавлены в корневой и модульный README.
• Legacy set_status.js документирован отдельно; его поведение не менялось.

Границы

• Поведение picker-а намеренно не изменялось.
• site/static/vendor/fflate.min.js не редактировался.
• Старые backend/VM-файлы и .pyc не удалялись.

Проверка

• node --input-type=module --check для собственных JS-файлов: PASS.
• python3 -m py_compile site/app.py upload/__init__.py: PASS.
• git diff --check: PASS.