Правки для лучшей интеграции

This commit is contained in:
NikitaKalitov
2026-08-26 14:16:38 +03:00
parent 0d714ab38e
commit e8c05d307c
10 changed files with 453 additions and 123 deletions
+6 -6
View File
@@ -20,7 +20,7 @@
{ "index": "index-300d7ef5.html" }
```
Портал читает его при открытии модалки — `fetch('app.json', { cache: 'no-store' })`
Портал читает его при открытии модалки — `fetch('app-manifest.js', { cache: 'no-store' })`
в `src/helpers/chart-builder.ts` — и уже к полученному имени дописывает
параметры. Поэтому выкладка конструктора **не требует пересборки портала**.
@@ -83,7 +83,7 @@ cd D:\Development\Work\portal-front; npm run dev
Проверка, что связка поднята:
```powershell
curl.exe -s http://localhost:5173/local/modules/vniigaz.bpmn/assets/app.json
curl.exe -s http://localhost:5173/local/modules/vniigaz.bpmn/assets/app-manifest.js
```
Пустой ответ — не поднят `preview` или не собран конструктор.
@@ -108,7 +108,7 @@ cd D:\Development\Work\portal-front; npm run build
Проверка после выкладки:
```powershell
curl.exe -s https://ВАШ-ДОМЕН/local/modules/vniigaz.bpmn/assets/app.json
curl.exe -s https://ВАШ-ДОМЕН/local/modules/vniigaz.bpmn/assets/app-manifest.js
```
Имя в ответе должно совпадать с реально лежащим файлом. Открыть `index-<hash>.html`
@@ -132,7 +132,7 @@ curl.exe -s https://ВАШ-ДОМЕН/local/modules/vniigaz.bpmn/assets/app.json
состоится, ошибок в консоли не будет.
Второе требование к встраивающей стороне — не писать имя `index-<hash>.html`
строкой, а брать актуальное из `app.json` (или искать единственный `index-*.html`,
строкой, а брать актуальное из `app-manifest.js` (или искать единственный `index-*.html`,
но тогда очистка каталога при деплое обязательна). Подробности — в
`backend-quickstart.md`, раздел 1.
@@ -147,7 +147,7 @@ curl.exe -s https://ВАШ-ДОМЕН/local/modules/vniigaz.bpmn/assets/app.json
| Что видно | Причина | Что делать |
|---|---|---|
| «Не удалось загрузить схему» в модалке | манифест не отдался либо не пришёл `diagram:ready` за 10 секунд | проверить `app.json` через curl, затем в Network — дошёл ли `index-<hash>.js` |
| «Не удалось загрузить схему» в модалке | манифест не отдался либо не пришёл `diagram:ready` за 10 секунд | проверить `app-manifest.js` через curl, затем в Network — дошёл ли `index-<hash>.js` |
| Пустой iframe, в консоли 404 на `index-<hash>.js` | файлы сборки не докопированы или скопированы не в тот каталог | перекопировать `dist/` целиком |
| Приложение висит на «Загрузка диаграммы…» | `diagram:ready` ушёл не туда: origin хоста не совпал с ожидаемым | для админки — сверить `VITE_BITRIX_ORIGIN` с адресной строкой; для dev — проверить, что конструктор открывается через прокси портала, а не напрямую с 5800 |
| Портал открывает старую версию схемы | в каталоге лежат файлы прошлых сборок, `app.json` указывает на новый, а старый html закеширован браузером | очистить каталог при деплое; хеш в имени сам по себе кэш не победит, если старый файл остаётся на месте |
| Портал открывает старую версию схемы | в каталоге лежат файлы прошлых сборок, `app-manifest.js` указывает на новый, а старый html закеширован браузером | очистить каталог при деплое; хеш в имени сам по себе кэш не победит, если старый файл остаётся на месте |