Skip to content

ARCHITECTURE.md

Latest commit

 

History

History
73 lines (63 loc) · 5.04 KB

ARCHITECTURE.md

File metadata and controls

73 lines (63 loc) · 5.04 KB
Raw

Архитектура

Один процесс Python (main.py → backend/app/desktop.py) открывает окно pywebview с React-интерфейсом из frontend/dist. Все действия UI идут через ApiBridge (backend/app/api_bridge.py) — его методы являются контрактом между фронтом и бэком.

flowchart LR
    React["React 19<br/>frontend/dist"] -- "window.pywebview.api" --> Bridge["ApiBridge<br/>backend/app/api_bridge.py"]
    WMS["WMS «Честный знак»"] -- "HTTP :8791<br/>X-CHZ-Token" --> Chz["chz_bridge_server.py"]
    Chz --> Bridge
    Bridge --> Auth["backend/auth<br/>файл → профиль → Selenium"]
    Bridge --> Kontur["backend/kontur<br/>api.py + cryptopro.py"]
    Bridge --> Services["backend/services<br/>history_db, bartender, update"]
    Auth -.->|cookies| Kontur
    Kontur --> MK[("mk.kontur.ru")]
    Services --> Hist["full_orders_history.json"]
    Services --> BT["BarTender"]
Loading

Потоки данных

Заказ кодов. Экран Orders → ApiBridge → backend/kontur/api.py (REST к mk.kontur.ru; подпись документов — cryptopro.py, CAdES) → запись в backend/services/history_db.py → full_orders_history.json. «Настоящие» статусы дотягивает отдельный процесс backend/app/true_status_worker.py, который ApiBridge запускает сабпроцессом.

Cookies (авторизация). backend/auth/service.py, по убыванию дешевизны: (1) файл runtime/auth/kontur_cookies.json; (2) cookies из профиля Яндекс Браузера (yandex_cookies.py); (3) Selenium + YandexDriver (browser.py). Каждый источник подтверждается живым GET /api/v1/user — TTL файла сам по себе ничего не доказывает. Selenium открывает реальный профиль с окном за экраном (--window-position=-32000,-32000) плюс Win32 SW_HIDE; параллельный «сторож» прячет окна новых процессов browser.exe, а после неудачной попытки осиротевшие процессы принудительно завершаются. Фоновая пролонгация доступа — раз в ~9 ч (prolongation.py).

Обновления. UI раз в 5 минут зовёт check_for_updates (git fetch + сравнение HEAD с origin/main); кнопка «Обновить» → apply_update → git merge --ff-only origin/main, перезапуск вручную. frontend/dist закоммичен сознательно: UI приезжает тем же pull, Node.js на рабочих ПК не нужен. Жёсткий путь — Update.bat → scripts/update_windows.ps1 (stash → pull/reset → пересборка окружения).

Локальная история. history_db.py хранит в full_orders_history.json пути к CSV/PDF, флаги ТСД и архив удалённых. Список заказов на экране берётся из Контура; между ПК файл не синхронизируется.

WMS («Честный знак»). backend/app/chz_bridge_server.py слушает 0.0.0.0:8791 (env CHZ_BRIDGE_ENABLED/HOST/PORT/TOKEN). POST /api/chz/requests (обязательный заголовок X-CHZ-Token) → ApiBridge.receive_wms_chz_request → заявка попадает в очередь заказов; GET /api/chz/health — доступность и число активных заявок. Без окна мост поднимает backend/app/server_only.py (ярлык «CRPT server» в автозагрузке). Отдельного экрана CHZ в UI нет.

Известные ограничения

  • Профиль Яндекс Браузера блокируется запущенным браузером: при «profile is in use» приложение завершает процессы browser.exe и повторяет попытку — открытый у пользователя браузер при этом закроется.
  • api_bridge.py — монолит ~6.9 тыс. строк. Методы — контракт для UI; распиливать только с сохранением сигнатур.
  • Selenium кликает по абсолютным XPath живой вёрстки Контура (browser.py) — редизайн mk.kontur.ru их ломает.
  • HEADLESS = False принципиально: через --headless=new авторизация не проходит.
  • Порт 8791 слушает 0.0.0.0; POST защищён только токеном — CHZ_BRIDGE_TOKEN обязателен.
  • Копия из exe-установщика не содержит .git: внутриприложенческие обновления там не работают.