Document picker code and architecture

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

@@ -0,0 +1,23 @@
+# Документация кода 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.