Docs

OneCBridge

uticms.modules.onecbridge · verified 2026-07-11

Обзор

Scope
Реализованный код моста 1C/CommerceML; исключает reference archive for_analysis

Ключевые понятия

Exchange Session
Сохранённое состояние inbound exchange lifecycle.
Manual Import
Путь импорта, инициированный оператором: scanning, ZIP extraction, storage и runner services.
Analysis Archive
Reference material OneCBridge/for_analysis; не runtime bridge implementation.

Структура

  • Api
    • Prefix/api/bridge/1c
    • EndpointGET|POST /exchange
  • Services
    • ExchangeSessionService
    • ExchangeAuditService
    • IncomingPackageStorageService
    • CommerceMlParser
    • ImportOrchestrator
    • ShopImportMapper
    • ImportDeactivator
    • ManualImportRunner
  • PersistenceOneCBridge migrations и модели ExchangeSession, ExchangePackage, ExchangeLog
  • ConsoleOneCBridge import-file command

Факты

  • OneCBridge manifest требует Shop ^1.0 и устанавливает install в false. authoritative
  • Provider мержит module configuration, регистрирует bridge services, migrations, API routes, console command, views и bridge-specific exception renderer. authoritative
  • Exchange controller экспонируется под /api/bridge/1c/exchange для GET и POST через api middleware. authoritative
  • Exceptions для api/bridge/1c requests рендерятся через ExchangeResponseFormatter. authoritative

Инструкции

Investigate Import

  1. определить exchange session/package и audit records
  2. проследить storage, parser, orchestrator, mapper и deactivation stages
  3. проверить Shop data impact в безопасной среде
  4. использовать manual-import или console path только с controlled input files