Fabula (jFabula)

1. Назначение и позиционирование

jFabula — браузерный клиент «Оперативный учёт». Исторически это перенос десктопного приложения на MS Access на web-платформу. Среда исполнения — обычный браузер; доступ — интернет/интранет.

• Классический SaaS — код и БД на стороне хоста.
• Гибрид — код с сервера производителя, БД у заказчика; локальный AwwS (Access Windows Web Server) — HTTP/прокси к MDAC/MDB, кэш модулей.

2. Архитектура и стек

Кодировка UI: Windows-1251. Язык интерфейса: русский. PWA: jFabula/manifest.json (display: standalone). Полноценный offline (service worker) в просмотренном коде не обнаружен.

3. Запуск, Auth, bootstrap

Точки входа

• /jFabula → forms/main.html
• /jFabula/db/{dbName} — конкретная база (пример: well)
• index.html — хаб продуктов (Фабула, PM, АРМы…)
• login.html + login.js — iframe-логин

Auth (jAuth)

1. Cookie: Login, dbName, Sha1 (SHA1 от login+password; Guest — фиксированный hash).
2. POST /auth/{dbName}/login.html с Base64-телом { Sql:'Auth', Login, Sha1, … }.
3. Успех → db_Client, Rights, Users; вызов main.Start (или pm/sb/am…).
4. Login=="Agent" → в UI показывается Login2.
5. ?reload=Y — ускоренный вход по cookie Sha1.

main.Start

1. Ожидание coreLib, mainTbls, docs.
2. Guards: User=="0" → /; isAdmin("N") без полного admin → /pm.
3. mainTbls(db); apiTbl (GandsIco, formula); getReferences (Sys, Gands, Firms…).
4. Profile → Tabs + wi.mainFilter → GotoTab(mainTab).
5. Цепочка ядра: Fabula.js → Fabula.mm.js / fabula.min.js / Fabula.ext.js.

4. Модель данных

Метамодель: Fabula-tables.js (mainTbls), Fabula.mm.js, ReStru.js.

5. Модуль «Заказы» (docs)

Файлы: forms/docs.html|js, docs.tabs.js, docs.print.js, docs.rep.js.

Статусы документа

Доп. гейты: ReadOnly config; чужая заявка; ДатаЗапрета; formula disDocAVR / disDocCompany / disDocType.

Жизненный цикл

• DocsNew — типы SYОП*; copy с режимами перенос(3)/копия(4)/склад(5)/закупка(6)/производство(7).
• DocsMerge — слияние отмеченных в текущий DocID (запрет Ax без F; >9 авансов _KKT).
• Импорт — Menu SYВкОпИм → setPlugin / sEval из SysExts.

Шапка

DocID, Company, DocType, Agent/Manager, FirmContract/FirmCustomer/Person, RegDate / DateAVR / DateAcc / TxtAcc, ParentDoc, Sum1/Sum2, Debt/Debt2, НДС/спецналог, Discount/Margin. Currency в UI закомментирован, поля в SQL остаются.

Строки Movement

• docs.move — продукция (Doc==DocID).
• docs.move2 — операции/затраты; фильтр П/М/Р/Б/Г/1 (подрядчики / материалы КОП 8* / работы 01–09 / бух Flag D / главные / подч.).
• MMPID — дерево; MMFlag: 0 / 1 / 9✓ / A✕ / B❄ / X. Удаление обычно на фазе 1.
• NewItem → editMoveForm / calc → insertMoveForm.

Подвкладки документа

Фильтры / Mode0 / HideCosts

DocsFilter: тип, долг, подчинённые, даты, товар/спец, gf.*, заказчик/платёж, propFilter. Mode «оф.» показывает Sum2; jf.Mode0 принудительно включает Mode для non-F; HideCosts прячет колонки и вкладки Операции/Затраты.

6. Модуль «Задачи» (pm)

Файлы: forms/pm.js, pmm.html. Может работать standalone на /pm.

• Список задач на базе Moves; фазы MMFlag; wiProperties.
• Forum: wiForum / Talk.
• Сигналы pmSignal0..2 в title-баре (переход / возврат / оплата).
• Таймеры TimeRefreshTalk / TimeRefreshMMID; chart по Talks.
• Config в Profile «PM»; связь с docs через goLink.

7. Модуль «Деньги» и ККТ

PayType → таблицы

ID платежа: {Company}{Y}{PayType}{#####}. В архиве — MoneyAll / PartPayAll / …

Операции

• NewItem (CFZ), Merge (FZ), CorrectMoney (SumRest), DelItem с ограничениями (_KKT / kkt:).
• PartPay: payDoc/doPay — разнесение на долги Docs.
• ForcePay (FBZ) из вкладки оплат документа.
• Импорт: importMoney.fun_* (1S, Yandex, Qiwi, CloudPayments, RNCB, RNKB, GenBank, VTB, CSV, Robokassa, Common…). Список в UI — из SY-меню БД.

ККТ / atol (add/exts/ext.kkt.js)

• KKT из GandsExt GSExType=KKT; команды из atol + formula kkt%.
• Профиль Касса / Эквайринг (Company → касса/ККТ).
• Команды: Отгрузка/sale, Аванс/advance, возврат; Flag A→Online, K→PayKeeper, R→RBSoft (+ close смены).
• Результат в Property _KKT / Notice kkt:. Отладка: add/sf/atol.html.

8. Контрагенты и номенклатура

Firms

Типы FirmTypes; список + форма Firms/ClientFIO; props; контакты; связанные движения; поиск по ИНН/ОГРН; адрес/карта; холдинг Parent_ID; действие «Обновить ЭДО: Астрал».

Gands (кратко)

Иерархический справочник кодов GSID (2/4/6/8 символов) плюс отдельное дерево ~SYSTEM (SY…) — системные справочники и настройки приложения. Подробности — в § Номенклатура и ~SYSTEM.

Номенклатура и ~SYSTEM — подробное описание

Файлы UI: forms/gands.html|js. Метамодель: Fabula-tables.js (db.tbl.Sys / Gands / SysExts / formula). Live-цифры БД well: Sys ≈ 1+4+34+471 узлов (L2/L4/L6/L8); formula ≈ 469; производные кэши DocTypes 30, CodesOp 371, Agents 406, Storage 16, Regions 89…

1. Как устроена вкладка

• Левое дерево #gandsList — уровни раскрытия кнопками 1/2/3/4 (gands.Draw(2|4|6|8)): код GSID длины 2→4→6→8.
• Правая карточка #gandsExt — имена уровней, артикул/КОП/единицы/флаги, свойства (wiProperties), расширения GandsExt, файлы/иконки, движения по GS, действия «Изменить код», «Инвентаризация», «Амортизация», стикер.
• Фильтры: глобальный фильтр; Группа (Gands4); Склад (Storage); Флаги (gandsFlag); расширения Тип/Имя/Значение; «хитрый» prop-filter.

2. Код GSID и уровни

Поля записи: GSKindName/GSName, GSCodeNumber (артикул/таб.№), GSCOP, GSUnit, GSFlag, FirmDefault, цены, Sort/Sort4. Расширения — таблица GandsExt (GSExType/Name/Attr1/Attr2/Flag), свойства — Property (ExtClass=Gands).

3. Дерево ~SYSTEM (live well)

~SYSTEM (SY)
├── ВКЛАДКИ (SYВк)       — меню/действия модулей UI и плагины
├── СПРАВОЧНИКИ (SYСП)   — классификаторы, конфигурация, параметры, филиалы
├── ТИПЫ ОПЕРАЦИЙ (SYОП) — DocTypes (продажи/закупки/производство/склад/прочее)
└── СОТРУДНИКИ (SYСо)    — оргструктура → Agents/Users/Profile

3.1. SYВк — ВКЛАДКИ

Конфигурация пунктов меню вкладок приложения (не товар). L6 → модуль; L8 → конкретное действие/отчёт/фильтр/плагин.

Типы расширений на вкладках: import (меню импорта), query/query2 (отчёты), plugin (URL в Attr1 через formula), property, fis, help…

3.2. SYСП — СПРАВОЧНИКИ (ядро настроек)

SYСПКТ — Параметры (L8, well):

Филиал SYСПФиXX несёт в GandsExt/Property: ИНН/КПП/ОГРН/адреса/телефоны/email, подписи 1-я/2-я, налоги (НДС с датами → Taxes), расчётные счета (р/с → ourBank + привязка KKT), настройки ЭДО. Разбор по well — §7.

3.3. SYОП — ТИПЫ ОПЕРАЦИЙ (DocTypes)

Каждый L6 — семейство документов; L8 — конкретный DocType (ключ = последние 2 символа кода). При создании заказа меню берётся отсюда (DocsNew / SYОП*).

На типе документа в Exts задаются: фильтры номенклатуры (Фильтр/Фильтр2), подчинённые документы, SpecForm, печатные формы, правила поведения строк.

3.4. SYСо — СОТРУДНИКИ

Оргструктура → Agents / Users. L6 = отдел; L8 = сотрудник (GSCodeNumber = ID пользователя).

У сотрудника в property: подмена/просмотр (расширение списка Users), склад, контакты, фото. Profile пользователя хранится как GandsExt на его SYСо*-узле (GSCodeNumber=User): Main/Filters/PM/Касса/Эквайринг… (SHA1/Rights в SysExts специально скрываются из общей выборки).

4. Как System «разворачивается» в кэши клиента

При загрузке mainTbls:

1. Gands WHERE Left(GSID,2)<>'SY' — товары.
2. Sys WHERE Left(GSID,2)='SY' — system-дерево; из листьев собираются DocTypes, Companes, Agents, Users…
3. SysExts / sys-import — все GandsExt с GSExID LIKE 'SY%' (кроме formula/config в отдельном потоке).
4. funTbls раскладывает Exts в специализированные таблицы: plugins, KKT, Storage, Status, Tags, CodesOp, pmState, Pathes, Domain, Regions, Assigning, providerEDO, gandsUnit, ourBank, Taxes, autoSql, template, localReport…
5. formula (+ formula2 из sys) — ~469 текстовых правил/SQL-фрагментов/шаблонов UI.

5. Товарная номенклатура (не SY)

• Те же 4 уровня кода, но корни — товарные группы (не SY).
• Склады/флаги/единицы берутся из System-параметров; движения и остатки — из Movement.
• Спецдействия: инвентаризация, амортизация, стикер, импорт, отладка Zaprintom/спецформы.
• Live: кассы/точки как отдельные GS (ФоКасса-*, ФоПушкина-*, ФоСклад, zaprintom.fo…).

6. Подробно: SYСПКТКП — КОП (коды операций)

Узел System SYСПКТКП («Параметры. КОП»). Записи GandsExt с этим GSExID (кроме property/help) загружаются в db.tbl.CodesOp. Live well: 371 кода (L1: 9 · L2: 56 · L3: 208 · L4: 98).

Семантика и флаги

• КОП пишется в строках Movement (CodeOp) и платежах; фильтр gf.CodeOp; разнесение PartPay по КОП долга.
• В коде: Flag с буквой A → AVR=true (участвует в АВР/учёте выручки); I → percIn (проценты); D — документооборот/бух; T/Z — спец. режимы (работы/зарплата); префикс d часто у «детализируемых» групп.
• Иерархия: 1 символ → класс; 2 → группа; 3–4 → конкретная операция (в т.ч. работы 01xx).
• В UI затрат docs.move2: КОП 8* ≈ материалы; 01*–09* ≈ работы (см. moveExt).

Классы L1 (well)

Группы L2 — обзор по классам

Примеры детализации

00 Документооборот → 001 УПД покупатели, 002 поставщики, 003/004 кассовые ордера, 005 счёт поставщика, 006 материалы, 007 топливо, 00F web Fabula, 00S Zaprintom…

10 Дизайн (A) → 100 почасовой, 101 разработка, 109 предпечатная подготовка.

01 Работа реклама (A) (флаг TA) → 010 макетирование, 0100 креатив, 0101 макетирование, 0120 ШФ, 0140 монтаж наружки, 0142 лазер… — «трудовые» КОП производственных строк.

12 Широкоформат (A) → 120 собственная / 121 сторонняя / 122 ДТФ.

7. Подробно: SYСПФи — филиалы (наши юрлица)

Листья SYСПФиXX (XX = 2-символьный код филиала) → db.tbl.Companes. Расширения филиала (property / «Подпись» / «Налог» / «р/с» / ЭДО / KKT) собираются в Companes + ourBank / Taxes / hash KKT.

Карточка филиала — что хранится

Филиалы well (Companes)

У многих юрлиц заполнены GUID 1С (Code1C), цвет филиала в UI, email (zaprintom.ru / vwell.su / vwell.biz).

Расчётные счета и ККТ

• ourBank ≈ 114 счетов по филиалам; Flag: A — счёт по умолчанию, h — скрыт в части списков, E — эквайринг, n — варианты hide-списков; в Attr2 может быть имя KKT.
• На Fi (тест): 0000 + эквайринг/VTB/Best2pay/РНКБ/UniTeller → KKT «Тест-RBSoft» / «Тест-Онлайн».
• Боевые кассы привязаны к Ел/Фо/РР: ФоКасса-*, zaprintom.fo/el, RB-Fo/Zap/РР, *-Онлайн (atol online), локальные /atol/…/api/v2 и прямой IP 192.168.3.178:16732.
• Профиль пользователя «Касса» / «Эквайринг» выбирает кассу по коду Company текущего филиала документа.

Как это стыкуется с документами

Docs.Company = код филиала (Fi/АО/Фо/…)
  → Companes[Company] даёт реквизиты печати, НДС, default RS
  → ourBank фильтруется по Gr=Company
  → KKT из профиля Касса/Эквайринг для этого Company
  → Mode0 / MainCompany (formula) влияют на «официальный» филиал

8. Практический смысл для сопровождения

• Новый тип заказа → лист под SYОП* + Exts (фильтр GS, печать, SpecForm).
• Новый пункт меню вкладки / плагин → SYВк* + Ext type import/query/plugin.
• Новый КОП / фаза / склад / тег → соответствующий лист SYСПКТ*.
• Новый филиал / р/с / ККТ → SYСПФиXX + property/р/с/KKT.
• Новый сотрудник → SYСо** + Profile Exts; права — строка Rights (не всегда видна в дереве).
• Бизнес-правила печати/SQL/режимов → formula (и ConfigLoc), не обязательно отдельный JS.

9. Права, Profile, Config, formula

Буквы Rights (db.isAdmin(tag))

Проверка: sIn(Rights, tag.split("")) или полный admin 'A'. В коде часто комбо: CFZ, FBZ, BFL, CWF…

Profile / Config

• Profile в GandsExt: Main, Filters, PM, Money, Firms, Gands, doc.report.setup*, Касса, Эквайринг, Tag…
• getConfig(Prop) ≡ formula(Prop); setConfig → Property Config/ConfigLoc.
• ReStruConfig: Version, Mode0, ExtURL/2, MainCompany, ДатаЗапрета, Таймер выхода…

Механизм db.tbl.formula

Runtime-конфигурация и мини-язык выражений: бизнес-правила живут в БД (GandsExt), клиент подставляет/вычисляет их через глобальную formula() (Fabula.mm.js). Live well: ~469 строк → ~425 уникальных ключей в hash.

Хранение и загрузка

GandsExt WHERE GSExType = 'formula'
  → db.tbl.formula  (Src: main)
  Sql: SELECT GEIDC, GSExName AS Key,
              GSExAttr1 + iif(Flag LIKE '%d%' AND Attr2 NOT NULL, Attr2, '') AS Val,
              GSExFlag
  funAfterLoad: hash[Key] = r; при дублях имени Val += Val

db.tbl.formula2 — копия схемы, Src: sys (системная БД; в well hash пуст)
db.tbl.atol     — тот же паттерн для GSExType='atol' (команды ККТ)

• Формулы не обязаны висеть только на SYСПКТ*: Type=formula встречается на SY, SYВк*, SYСо, SYСПКТ*, ХФ и др. Ключ — GSExName.
• В общем SysExts type formula/config отфильтрованы; отдельный preload / apiTbl / mainTbls.
• Flag d (~256 шт. в well): к Val дописывается Attr2 (длинные шаблоны в двух полях).
• Имена с * — часто шаблоны печати/черновики (оферта, cashAVR…), всё равно в hash.
• Редактирование: номенклатура/~SYSTEM → Ext type formula; сброс кэша dbReloadTbl(db,"formula") / смена фазы может инвалидировать hash.

API formula(parm, isEval, n, args)

Мини-язык внутри Val

• {…} — блок вычисления или ссылка на другую formula по имени ({docSale}, {PayCompany(cash, firm)}).
• P[1]…P[n] — позиционные параметры вызова name(arg1,arg2) или массив args / isEval-массив подстановок.
• $0…$9 — временные глобалы (mi5.browser.js); $$() сохранить/восстановить, $$(1) очистить. Типичный паттерн шаблона: {$1=…, $2=fa.Cur(), … , "SELECT "+$1}.
• [end] → ,"" (обрыв цепочек iif в шаблонах).
• Комментарии SQL/JS снимаются через sComment; HTML-entities > и т.п. нормализуются перед sEval.
• {input} — плейсхолдер (хитрые фильтры / отчёты), не вычисляется внутри formula.

// пример: предикат «продажа»
docSale.Val ≈ Mid( {"P[1]" || "DocID"}, 4, 2) IN ('ру','рг','по',…)
formula("docSale(DocID)", true)
  → Mid( DocID, 4, 2) IN ('ру','рг',…)

// пример: константа филиала
MainCompany → [filial]Fi[/filial]
DateArx     → 01.01.25

// пример: конфиг ЭДО
Astral.Doki → таблица Fi|Ко|Ел|Фо… → globalId | org id

Классы формул (по применению)

Well: ~278 с {, ~138 «простых» строк, Flag пуст ~101 / d ~256 / h/hd/dh — скрытие/режимы в UI редактора.

Связь с остальным клиентом

• db.getConfig(p) → formula(p); архив/филиал в lib/db.js (DateArx, MainCompany).
• Отчёты / ХФ / plugins URL / Tags span — почти везде formula(…, true) перед показом или SQL.
• autoSql может брать тело из db.tbl.autoSql и прогонять через formula.
• Смена MMFlag: pre/do-скрипты из Base64 + formula; меню фаз — formula с ключом GS.
• Вкладка задач (pmm): чекбокс перезагрузки «формулы» вместе с Sys/SysExts.

10. Ядро fa / db / фильтр / WebSocket

fa — текущий контекст

Нет единого store: объект берётся из активной вкладки + кэш fa.doc / fa.move.

db.Query

formReq → Ajax /db/{dbName}/{CacheName}; Src sys → dbsys; *Src — параллельные запросы. apiTbl — GET готовых таблиц; getReferences — пакетный Preload. Архив: DateArx + gf.Arx → *ARX / *All.

MainFilter

switch(вкладки) → docs/pm/gands/firms/money.Filter. Общие gf.*: Date1/2, Arx, CodeOp, Company, Firm, Agent, WorkerType. Persist Filters в Profile. fa.getFilter — SQL-фрагменты.

WebSocket

db.ws → /ws/{db}/{user}. Команды: ping, setflag/settalk → pm.signalPM; msg/reload/tel/signdoc/update. Live в основном для задач/Talk; полный refresh Docs/Money — частичный.

11. Плагины, интеграции, спецформы

В Fabula слово «плагин» означает три разных механизма:

1. Кнопки вкладки «Плагины» (#main.Plugins) — полноценные iframe-приложения в зоне #supp. Конфиг: SYВкДп + GSExType=plugin. См. § ниже.
2. setPlugin(url, firm, doc, mmid) — модальный диалог-iframe поверх заказа (счёт, оплата, печать, calc из строки…). Контекст в hash Base64: mmid;doc;docid;firm. Внешние http(s)/kontur открываются в window.open.
3. add/exts/*.js — встроенные расширения ядра (1С, ЭДО, ККТ, маркировка), не кнопки вкладки.

Кнопки вкладки «Плагины» (toolbar)

Где в UI

• Шестая «вкладка» в TabsMainTitle: иконка hub + подпись Плагины (onclick=addMenu — мини-меню на узких экранах) + контейнер #main.Plugins с кнопками-иконками.
• Клик по кнопке → SubTabs(this): выделяет кнопку, пишет Profile Main.subTab = URL, показывает #supp и вставляет <iframe src="URL"> (подстановки [user]/[db]).
• Первая кнопка «Закрыть все» — чистит iframe’ы и subTab.
• На ширине <800px блок main.Plugins скрывается (main.Resize); доступ через «Плагины» → addMenu.

Откуда берётся реестр

GandsExt на SYВкДп, GSExType = "plugin"
  → Fabula-tables.js funTbls:
      db.tbl.plugins.rec.push({
        Key: GSExID,           // "SYВкДп"
        Val: GSExName,         // подпись (title картинки)
        ImportName: formula(GSExAttr1),  // URL
        Ico: GSExAttr2,        // путь или {icon8("…")}
        Flag: GSExFlag         // права / скрытие
      })
  → SubTabs() строит кнопки из plugins.rec

Фильтры показа кнопки

Live well, User=140, Rights=A: на панели 9 плагинов (+ «Закрыть все»). В SysExts всего 18 записей type=plugin; 9 скрыты префиксом * и/или флагом h.

Каталог well — видимые кнопки

Скрытые в реестре (* / Flag h) — well

Как добавить / изменить кнопку

1. В номенклатуре → ~SYSTEM → ВКЛАДКИ → Дополнительно (SYВкДп).
2. Ext type plugin: Name = подпись; Attr1 = URL (можно [db], [user], formula {db.User}); Attr2 = иконка (/path.png или {icon8("name")}); Flag = буквы Rights или пусто; имя с * — скрыть с панели, оставить в данных.
3. Перезагрузка справочников / сессии → кнопка в main.Plugins.

Отличие от setPlugin из заказа

Интеграции ядра (add/exts)

Подключаются из Fabula.ext.js (_require): edo, 1C, marka, kkt. ЭП (ext.eds.js) подгружается лениво из ЭДО при локальной подписи. Внешние HTTP чаще идут через серверный прокси /curl/… + Base64 curl-команды (секреты в {Config.*} / Profile, не в клиентском git).

Карта «кто кого зовёт»

Fabula.ext.js
  ├─ ext.edo.js   (_Astral)  ← firms «Обновить ЭДО», bill/УПД, tasks
  │     └─ ext.eds.js (EDS)  ← КриптоПро CAdES при signDocLocal
  ├─ ext.1C.js    (_1C)      ← иконка [1c] в документах/номенклатуре, ExportDoc
  ├─ ext.marka.js (Marka)    ← ЧЗ/СУЗ, коды в Props, чек с КМ
  └─ ext.kkt.js   (atol)     ← Аванс/Отгрузка/возврат; Preview чека; atol.html

1С — ext.1C.js (_1C)

• Транспорт: OData REST 1С через /curl; URL/ключ — {Config.1c-url}, {Config.1c-key} (Basic).
• Связка объектов: GUID в GandsExt _GUID / Companes.Code1C; на документе Property _1C с тегами [1s]тип[/1s].
• Основные методы: GUID — сверка номенклатуры по артикулу; viewCatalog / viewDoc — просмотр в UI; findCatalog (ИНН/КПП) / findDocument; ExportDoc / offDocument — выгрузка Реализация / Счёт на оплату; offMaterials, nextUPD, Connect, Catalog, Get.
• UI: иконка 1С в разметке документа (Fabula.js) → _1C.viewDoc / viewCatalog.

ЭДО Астрал — ext.edo.js (_Astral)

• API: https://api.doc.astral.ru (боевой); тестовый/Fi — api.1cdocs.cloud.astral-dev.ru.
• Ящики филиалов: formula Astral.Doki → fil → gbID|orgID; токен в Profile Astral-Doki / @astral.token.
• Карточка фирмы: Property _ЭДО.Астрал (контакты, приглашения, globalId); кнопка live «Обновить ЭДО: Астрал» → importFirm (counterparties/contacts, invitations in/out, globalIds по ИНН/КПП).
• Документы: создание/отправка УПД и связанных пакетов, события в Talk, проверки через formula (chkEDO*, hasEDO, firmEDO, Diadoc.Kontur…).
• Операторы ЭДО: справочник providerEDO (~50 кодов 2xx: Контур, СБИС/Тензор, Такском, Калуга-Астрал, Сберключ…) — расшифровка ID оператора в UI.
• Также подключается из bill.js / bill2.js / tasks.js.

ЭП КриптоПро — ext.eds.js (EDS)

• Загрузка /lib/cpro/cadesplugin_api.js; нужен Chrome-плагин cpcsp_chrome_nmcades.
• Init — Store сертификатов; getCert — выбор; signDoc — CAdES-BES (подпись времени + имя документа), attach/detach.
• Вызов из ЭДО при локальной подписи исходящих пакетов; похожий код в tasks.js для фоновых сценариев.

ККТ — ext.kkt.js (atol)

• Реестр касс: db.tbl.KKT из SysExts (имя → cfg JSON: server, users, Authorization…); live well ≈ 24 кассы (Фо*/Ел*/РР*, zaprintom.*, Тест-RBSoft/Онлайн, RB-*…).
• Протоколы: Атол API (POST JSON + опрос uuid / rePlay); Flag R → ветка atol.RBSoft; также VTB/QRM для эквайринговых чеков/refund.
• Операции UI: atol.KKT — Аванс / Отгрузка / возврат / закрытие смены; Build — шаблон чека из formula (kktTemplate, kktNDS, kktClient…); результат в Property _KKT; Preview / Show — просмотр + ссылка ОФД.
• Консоль: плагин /add/sf/atol.html — список команд, atol.Do на выбранной кассе.
• Права: буква C; консоль toolbar — Flag CFW. Связь с маркировкой: CheckMarks / [marka].

Маркировка / Честный знак — ext.marka.js (Marka)

• GTIN на номенклатуре (GandsExt GTIN по филиалу); OMS/токены на Companes.
• Коды в Property документа (тег [marka]); сканер fromScaner.
• СУЗ / True API: заказ кодов, буферы, utilisation, проверка в ЧЗ, печать КМ.
• CreateDoc / CheckDoc — документы СУЗ из строк заказа; MarkaAtol — короткий код для чека.

Онлайн-оплаты и банк

Платёжная форма /pay — add/sf/pay.js

Открывается через setPlugin("/pay?doc=…") (docs, accept, am, tasks). Провайдеры:

hookpay.js — callback после оплаты: определяет провайдера по query, проверяет подпись, проводит платёж/PartPay. Return URL-ориентир: https://bord.com.ru.

Импорт банка / эквайринг

• Меню импорта: jf.MenuImport + SysExts type import (SYВкПл…).
• Шаблоны назначения: db.tbl.Assigning (→ CodeOp + FirmPay).
• tasks.js фоном обрабатывает Robokassa / Best2p / UniTel / CloudP / VTB / СБП и при необходимости чеки ККТ.

Спецформы add/sf (подробнее)

Конфиг интеграций (где крутить)

12. Печать, отчёты и хитрые фильтры

Печать текущего документа

• Pipeline: docs.Reports → setPlugin(docs.print.html) → dr / DocsReports.
• Список печатных форм: GandsExt на SYВкОпОт с GSExType <> 'query' и именем без ведущего * (см. docs.print.js thisQuery).
• Шаблоны: jFabula/rep/; опции drep.* (гл/подч, MarkDoc, noCost, Stamp, Sum2, noNDS…).
• Экспорт: PDF /load/pdf?, PNG/html2canvas, Excel, печать браузера.

Отчёты — узлы SYВк..От

Кодировка узлов

Два UI-канала

Поля Ext отчёта

• GSExType — группа в дереве: для печати «Документы», «Договора»…; для аналитики обычно query.
• GSExName — подпись (+ опционально [ico]…[/ico]); ведущий * — скрыт в обычном меню.
• GSExAttr1 (+ Attr2) — тело: URL шаблона /jFabula/rep/…, [file]…, SQL-шаблон с {opt(…)} / fa.getFilter, или function (…) => ….
• GSExFlag — права (после снятия служебных h/d): буквы Rights; d часто = «динамический»/фильтр-aware; h — доп. скрытие в части меню.

Язык query-отчётов

{opt(1,"!Дата2") + opt("filter","Dates,CodeOp,Company,Firm,Agent")
 ,opt(2,"Незавершёнка"), …}
SELECT … FROM Moves/Docs …
{fa.getFilter("Dates","GSDt")} {fa.getFilter("Company")}
…

opt/formula собирают UI-переключатели и WHERE из глобального фильтра вкладки. Результат гоняется через wiSql / wiReport.preRender (кнопка LocalReports).

Каталог well — печать (SYВкОпОт, не-query)

Каталог well — query по вкладкам (видимые без *)

Хитрые фильтры — узлы SYВк..ХФ

Назначение

Не «отчёт на экран», а готовый SQL-предикат для списка текущей вкладки: выбирается в комбо «Ещё…» / title «Хитрый фильтр» справа у prop-фильтра и добавляется в WHERE (propFilter.getFilterSF() → AND к Filter вкладки).

Привязка код ↔ System

Реализация: wiPropFilter в lib/wi.combo.js. Загрузка: SELECT … FROM GandsExt WHERE GSExID=… AND Left(Name,1)<>'*' AND Type<>'formula'. Дерево: GSExType = группа (часто «[red]Ошибки[/red] …»), листья = пункты фильтра.

Как собирается WHERE

1. Пользователь выбирает один/несколько пунктов в Tree-комбо SM (value через ;).
2. getFilterSF для каждого пункта берёт FiltWhere = Attr1 (или Attr, если Flag содержит d).
3. Плейсхолдер {input} → prompt; ** → %; затем formula(sf).
4. Модуль: wh += AND (sf) вместе с обычным prop-фильтром (Свойство=Значение) и глобальным main.filter.

Счётчики [2]/[] в имени — live-статистика (funStat / CountSql модуля): сколько записей попадёт под фильтр.

Каталог well — хитрые фильтры

Как добавить отчёт или хитрый фильтр

1. Печатная форма заказа: Ext на SYВкОпОт, Type=«Документы» (или Договора…), Attr1=путь HTML/[file], без * в имени.
2. Аналитика вкладки: Ext на соответствующий SYВк*От, Type=query, Attr1=SQL/{opt…}; Flag=буквы прав; * в имени — черновик/скрытый.
3. Хитрый фильтр: Ext на SYВк*ХФ, Type=группа («Ошибки…»), Name=подпись [n], Attr1=SQL-условие по ключу списка (DocID / MMID / PayID / FirmID / GSID); без Type=formula.

13. Live UI (сессия БД well)

Проверено в браузере агента: http://localhost:9000/jFabula/db/well?reload=Y (User=Миланин А.А., v.12-01). Загружается ~34 script-модуля (common/core/wi/Fabula/forms…). Скриншоты сохранены в Fabula.doc.img/.

Заказы

• Список № / Фирма / Сумма / Долг / Затраты; глобальный фильтр (даты±архив, филиал, КОП, фирма, сотрудник, роль).
• Действия документа: создать / копировать·разделить / удалить; печать «Счёт», «Счёт на оплату (эксп)», «Ком предложение»; «Перевозки. Создать ЭПЭ».
• Подвкладки: Продукция (N), Операции, Оплаты, Затраты, Макеты; calc-строки, быстрые задачи, ККТ, пересчёт сумм.
• Пример: Fi6pa00008 (амортизация/техника, ~1.42 млн, 79 позиций продукции).

Задачи (PM)

• Плотная производственная лента: фазы, исполнители, даты+дни, история смены фаз, свойства/макеты.
• Типовой ассортимент live: рулонная этикетка, визитки, брошюры, пластиковые карты, баннер, таблички, ДТФ/сублимация, фотокниги, УПД ЭДО, доставка/курьер, проверка макета, предпечатка, ламинация, порезка…
• Бренд/канал в задачах: Zaprintom; счётчик порядка ∑ 155 391 301 / 5 287 634; пагинация «по 4000».
• Действия: «Создать задачу», «Проверка макета»; деталь задачи с Talk/историей и свойствами (пункт выдачи, слияние заявок, макеты PDF).

Деньги

• Фильтры Тип / начисл. / выдача; Приход / Расход / Остаток; «объединять»; поиск по № документа/задачи/платежа.

Контрагенты

• Создать фирму; поиск ИНН/ОГРН; юр. название/адрес; свойства; Excel/печать; «Обновить ЭДО: Астрал».

Номенклатура

• Дерево 1–4 уровней; отдельно корень ~SYSTEM (см. подробный §).
• Фильтры: группа/склад/флаги/расширения; стикер; загрузка файлов; остатки.
• Live-справочники касс/точек: ФоКасса-*, ФоПушкина-*, ФоСамокиша-*, ФоСклад, zaprintom.fo…
• Кнопки «Отладка Zaprintom», «Отладка спецформы».

Плагины (кнопки title → URL)

Краткий снимок live; полный разбор UI/конфига/скрытых — §11 кнопки «Плагины».

14. Экосистема и развёртывание

Мобильная версия: наличие и особенности

1. Что есть в основном клиенте (jFabula)

• Детектор window.AA (lib/mi5.browser.js, также login): UA-sniff Android / iPhone / iPad / … При live-обходе в Pixel-эмуляции AA === true.
• Ширина окна: WinSize() выставляет флаги w800 / w1200 / w1600 и isVert (портрет). Адаптация идёт больше по ширине, чем по «это телефон».
• main.Resize (forms/main.js) при w800:
  • скрывает блок статуса Status3;
  • скрывает ленту кнопок #main.Plugins (плагины уходят в мини-меню addMenu по клику «…»);
  • укорачивает подписи вкладок (sLeft(title2, 0) — фактически иконки без текста);
  • уменьшает именованные иконки (20px вместо 24).
• Плагины / спецформы (setPlugin в Fabula.js): при AA iframe открывается на весь экран (left:0; top:0; width/height:100%), без десктопных 5%/80%.
• PWA-заготовка: jFabula/manifest.json (display: standalone, иконки 48/96/512), в main.html — viewport, theme-color, apple-touch-icon, link на manifest. Service worker / offline-кэш в коде не подтверждены → «добавить на экран» возможно, автономной работы нет.

2. Чего нет

• Нет отдельного mobile-роута / мобильного CSS-лейаута модулей docs/pm/money/firms/gands.
• Нет touch-first навигации, карточных списков вместо гридов, жестов — UI остаётся табличным.
• На узком экране полный ops-контур формально открывается, но practically неудобен (горизонтальный скролл таблиц, мелкие контролы).

3. Настоящий мобильный контур = АРМ + APK

4. Практическая модель использования

Офис / широкий экран  →  полный jFabula (docs, pm, money, firms, gands, SYSTEM)
Узкий браузер         →  тот же jFabula + ужатие shell (w800); полный учёт «на коленке»
Поле / склад / агент  →  /add/am, arm-stock, /acc  ±  Mobula.apk (AndroidFunction)

Итог для внедрения: мобильность — это линейка узких АРМ и оболочка Mobula, а не паритет функций с десктопной Фабулой. PWA-манифест — задел «иконка на домашний экран», не offline-ERP.

15. Сквозные сценарии

Заказ → оплата → чек

DocsNew (SYОП*) → NewItem/calc строки → статус Wk
  → docs.pay AutoPay/ForcePay → PartPay
  → atol.KKT (Аванс/Отгрузка) → Property _KKT
  → печать Счёта/АВР

Строка → задача PM

Movement + MMFlag → docs.move.toPM / goLink(pm, MMID)
  → фазы, Talk, сигналы → goLink(docs, doc&mmid)

Импорт банка → разнесение

MenuImport → importMoney.fun_* → Bank/Cash
  → money.pay.payDoc → PartPay → CorrectMoney

Плагин из документа

SpecForm / Bill / calc / внешний URL
  → setPlugin(form, firm, doc, mmid) → iframe Start()

16. Ключевые файлы и символы

17. Ограничения разбора

18. Преимущества и недостатки текущего проекта

Оценка по коду + live-сессии well. Это зрелая отраслевая система «под производство», а не зелёный greenfield-продукт.

Итоговая оценка