feat(web): add web publishing skills (web-publish, web-info, web-stop, web-unpublish)

Phase 1 of web publishing: publish 1C infobases via portable Apache HTTP Server. Closes the feedback loop: edit → load → update → open in browser. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-08-13 23:13:22 +03:00 · 2026-02-22 16:28:22 +03:00
parent bc9087957f
commit bc4778d6cc
10 changed files with 1178 additions and 0 deletions
@@ -0,0 +1,184 @@
+# Веб-публикация 1С — техническая спецификация
+
+Описание артефактов, необходимых для публикации информационной базы 1С через Apache HTTP Server.
+
+## default.vrd
+
+Дескриптор виртуального ресурса. XML-файл, описывающий подключение к информационной базе.
+
+### Формат
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
+       xmlns:xs="http://www.w3.org/2001/XMLSchema"
+       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+       base="/appname"
+       ib="connection-string">
+</point>
+```
+
+### Атрибут `base`
+
+URL-путь публикации. Должен начинаться с `/`, совпадает с `Alias` в httpd.conf.
+
+### Атрибут `ib`
+
+Строка подключения к информационной базе.
+
+**Файловая база:**
+```
+File=&quot;C:\Bases\MyDB&quot;;
+```
+
+**Серверная база:**
+```
+Srvr=&quot;server01&quot;;Ref=&quot;MyDB&quot;;
+```
+
+**С авторизацией:**
+```
+File=&quot;C:\Bases\MyDB&quot;;Usr=&quot;Admin&quot;;Pwd=&quot;123&quot;;
+```
+
+> Кавычки внутри значения `ib` экранируются как `&quot;` (XML-сущность).
+
+### Расположение
+
+`{ApachePath}/publish/{AppName}/default.vrd`
+
+## httpd.conf для 1С
+
+### LoadModule
+
+Apache загружает модуль расширения 1С:
+
+```apache
+LoadModule _1cws_module "C:/Program Files/1cv8/8.3.24.1691/bin/wsap24.dll"
+```
+
+- Модуль `wsap24.dll` — 64-разрядный, требует x64-версию Apache
+- Путь использует forward slashes
+
+### Listen
+
+```apache
+Listen 8080
+```
+
+Порт для веб-клиента. По умолчанию `8080` (стандартный `80` может быть занят).
+
+### Alias + Directory
+
+Для каждой публикации добавляется блок:
+
+```apache
+Alias "/appname" "C:/path/to/apache/publish/appname"
+<Directory "C:/path/to/apache/publish/appname">
+    AllowOverride All
+    Require all granted
+    SetHandler 1c-application
+    ManagedApplicationDescriptor "C:/path/to/apache/publish/appname/default.vrd"
+</Directory>
+```
+
+- `Alias` — URL-путь → физический каталог
+- `SetHandler 1c-application` — делегирование обработки запросов модулю wsap24
+- `ManagedApplicationDescriptor` — путь к default.vrd
+
+### Маркерный подход
+
+Скрипты используют маркерные комментарии для идемпотентного управления блоками:
+
+```apache
+# --- 1C: global ---
+Listen 8080
+LoadModule _1cws_module "C:/Program Files/1cv8/8.3.24.1691/bin/wsap24.dll"
+# --- End: global ---
+
+# --- 1C Publication: mydb ---
+Alias "/mydb" "C:/tools/apache24/publish/mydb"
+<Directory "C:/tools/apache24/publish/mydb">
+    AllowOverride All
+    Require all granted
+    SetHandler 1c-application
+    ManagedApplicationDescriptor "C:/tools/apache24/publish/mydb/default.vrd"
+</Directory>
+# --- End: mydb ---
+```
+
+При повторном запуске блок между маркерами заменяется целиком.
+
+## wsap24.dll
+
+Модуль расширения Apache для 1С:Предприятие 8.3.
+
+- Расположение: `{V8Path}/wsap24.dll` (в каталоге `bin` платформы)
+- Архитектура: x64 (Apache тоже должен быть x64)
+- Имя модуля: `_1cws_module`
+
+## Portable Apache
+
+### Дистрибутив
+
+Apache Lounge — Windows-сборка Apache HTTP Server (x64):
+- Сайт: `https://www.apachelounge.com/download/`
+- Прямая ссылка (2.4.62, VS17): `https://www.apachelounge.com/download/VS17/binaries/httpd-2.4.62-240904-win64-VS17.zip`
+- Внутри ZIP: каталог `Apache24/` с полной структурой
+
+### Структура после установки
+
+```
+tools/apache24/
+├── bin/
+│   ├── httpd.exe
+│   └── ...
+├── conf/
+│   ├── httpd.conf
+│   └── ...
+├── logs/
+│   ├── error.log
+│   └── access.log
+├── modules/
+│   └── ...
+└── publish/
+    └── {appname}/
+        └── default.vrd
+```
+
+### Пост-распаковка
+
+1. `Expand-Archive` распаковывает ZIP во временный каталог
+2. Содержимое `Apache24/` перемещается в `{ApachePath}`
+3. В `httpd.conf` патчится `ServerRoot`:
+
+```apache
+Define SRVROOT "C:/path/to/apache24"
+ServerRoot "${SRVROOT}"
+```
+
+Путь `SRVROOT` — абсолютный, с forward slashes.
+
+### Запуск
+
+```
+httpd.exe                  # foreground (для отладки)
+httpd.exe -k start         # фоновый запуск (не работает без установки сервиса)
+```
+
+> Portable Apache запускается напрямую через `Start-Process httpd.exe` без установки Windows-сервиса.
+
+### Остановка
+
+```
+httpd.exe -k stop           # graceful shutdown (требует сервис)
+Stop-Process -Name httpd    # принудительная остановка (portable)
+```
+
+### Перезагрузка
+
+```
+httpd.exe -k restart        # graceful restart (требует сервис)
+```
+
+Для portable варианта: остановка + запуск.