Дверная система ARLINE — архитектура

flowchart LR
  subgraph USER["Пользователь"]
    W["Мастер установки<br/>команда меню + ниша mbget door"]
    C["Карточка системы<br/>C# CardForm, модально"]
    R["Редактор составов<br/>аналог DoorSys63Form07"]
  end
  subgraph BRIDGE["Мост UI ↔ Python"]
    SH["shim.c + Entry.cs<br/>ProtoDLL, protoobj edit"]
    CB["card_bridge.py<br/>JSON в %TEMP%"]
  end
  subgraph DOMAIN["Предметная логика · чистый Python, без k3"]
    SPEC["DoorSystemSpec<br/>DoorSpec v2"]
    FG["flapgraph<br/>граф делителей, округление"]
    RULES["Правила систем<br/>формулы описаний"]
    RES["Резолвер ролей<br/>контракт 083 §4"]
    CAT["catalog083<br/>носители справочника"]
  end
  subgraph BUILD["Построение в K3"]
    BLD["mDoorSysLIB<br/>system_props_from_spec"]
    PARTS["Узлы: трек · створка · фурнитура"]
    RX["reactor<br/>reconcile + K3Renderer"]
  end
  subgraph DATA["Данные"]
    NG[("Справочник K3<br/>СИС · СЕЧ · РОЛ · СНП")]
    ATTR[("Атрибут прототипа<br/>DoorSpec v2")]
  end
  ORA["Оракул LeroyProtoLIB<br/>DoorSysLM → DOORS63"]
  W --> SH
  C --> SH
  SH --> CB --> SPEC
  CB --> FG
  R --> CAT
  SPEC --> FG
  SPEC --> RULES
  SPEC --> RES --> CAT --> NG
  SPEC --> BLD
  FG --> BLD
  RES --> BLD
  BLD --> PARTS --> RX --> SCENE["Сцена K3<br/>один объект системы"]
  BLD --> ATTR
  SCENE -.-> ORA
  

classDiagram
  direction LR
  class Система {
    СИС · NGoods вид 98
    зазоры SlipTop/Bot/Left/Right/Doors
    тип движения TypeFlap
    пределы ширины и высоты
    наложение створок
  }
  class Сечение {
    СЕЧ · NGoods
    назначение uDS_Function
    геометрия ProfileType
    w h s zh zw zhg Nbreak K3File
  }
  class Роль {
    РОЛ · NGoods
    закон расстановки FixOrder
    смещения FixDetail
    режим установки install_mode
    маска типов створки
    отдельной строкой IsCalc
  }
  class СистемаНаправляющих {
    СНП · «Italum 34»
    номинал uDS_SizeRail
    сечения трека верх/низ по рядам
  }
  class Артикул {
    позиция номенклатуры
    цвет uProfColor
    модель k3file, вес
    потомки ParentID
  }
  class ЦветПрофиля {
    Г1: цвет профиля → цвет комплектующих
  }
  Система "1" --> "*" Сечение : состав
  Система "1" --> "*" Роль : фурнитура
  Система "1" --> "1" СистемаНаправляющих
  Сечение "1" --> "*" Артикул : палитра ListMat
  Роль "1" --> "*" Артикул : кандидаты ListMat
  Артикул --> ЦветПрофиля

  class ДвернаяСистема {
    один прототип в сцене
    атрибут DoorSpec v2
  }
  class Проём {
    x1 y1 z1
    анкер xb yb zb
    из ниши mbget door + отступы
  }
  class Направляющая {
    ряд, верх/низ
    длина = ширина проёма − 1
  }
  class Створка {
    номер, ручей, сторона
    габарит по правилам системы
  }
  class Раскладка {
    граф делителей
    устойчивые id
  }
  class Делитель {
    H или V
    врезной или накладной
    позиция в мм
  }
  class Секция {
    устойчивый id
    пакет вставки или наследует общий
  }
  class ГруппаДеления {
    разделить на N
    умное округление
  }
  class ПакетВставки {
    слои от A к F
    материал, толщина 4/8/10
    отделки
  }
  class Фурнитура {
    роль → артикул
    ролики, стопор, шлегель, доводчик
  }
  ДвернаяСистема "1" --> "1" Проём
  ДвернаяСистема "1" --> "1..*" Направляющая
  ДвернаяСистема "1" --> "2..8" Створка
  ДвернаяСистема ..> Система : тип из каталога
  Створка "1" --> "1" Раскладка
  Раскладка "1" --> "*" Делитель
  Раскладка "1" --> "1..*" Секция
  Раскладка "1" --> "*" ГруппаДеления
  Секция "1" --> "0..1" ПакетВставки
  Створка "1" --> "*" Фурнитура
  Фурнитура ..> Роль : резолв
  

sequenceDiagram
  actor П as Пользователь
  participant K3 as K3
  participant SH as shim + Entry.cs
  participant F as CardForm (C#)
  participant PY as card_bridge.py + doorsys
  participant RX as reactor
  П->>K3: двойной клик по системе
  K3->>SH: protoobj edit → ProtoDLL
  SH->>PY: прочитать DoorSpec v2 из атрибута
  PY-->>F: модель вкладок: Система · Трек · Створка 1..N
  loop каждая правка в форме
    П->>F: делитель, материал, число створок
    F->>PY: edit(правка, контекст формы)
    PY-->>F: новая раскладка, размеры, предупреждения
  end
  П->>F: ОК
  F-->>SH: результат, K3 получает «отмену»
  SH->>PY: post_later: применить
  PY->>RX: reconcile одного прототипа
  RX->>K3: изменить только затронутые узлы
  

sequenceDiagram
  actor И as Инженер
  participant E as Редактор составов (своё окно)
  participant DB as Справочник K3
  participant B as Мост WM_COPYDATA
  participant K3 as K3 (открыт заказ)
  И->>E: меняет значение (зазор, смещение, артикул)
  E->>E: проверка целостности
  E->>DB: транзакция, проверка каждого оператора
  E->>B: «обновить справочник и перестроить систему N»
  B->>K3: nprefresh + reconcile выбранной системы
  K3-->>И: новая геометрия в окне