$npx -y skills add Arman-Kudaibergenov/1c-ai-development-kit --skill web-publishЭтот скилл MUST быть вызван когда пользователь просит опубликовать базу, настроить веб-доступ, веб-клиент, открыть в браузере через Apache. SHOULD также вызывать после создания или обновления базы для обеспечения доступа через браузер. Do NOT использовать для проверки статуса — и
| 1 | # /web-publish — Публикация 1С через Apache |
| 2 | |
| 3 | Генерирует `default.vrd`, настраивает `httpd.conf` и запускает Apache HTTP Server для веб-доступа к информационной базе. При необходимости скачивает portable Apache. Идемпотентный — повторный вызов обновляет конфигурацию. |
| 4 | |
| 5 | ## Usage |
| 6 | |
| 7 | ``` |
| 8 | /web-publish [database] |
| 9 | /web-publish dev |
| 10 | /web-publish dev --manual |
| 11 | /web-publish dev --port 9090 |
| 12 | ``` |
| 13 | |
| 14 | ## Параметры подключения |
| 15 | |
| 16 | Прочитай `.v8-project.json` из корня проекта и разреши базу: |
| 17 | 1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую |
| 18 | 2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json` |
| 19 | 3. Если не указал — сопоставь текущую ветку Git с `databases[].branches` |
| 20 | 4. Если ветка не совпала — используй `default` |
| 21 | |
| 22 | **ОБЯЗАТЕЛЬНО передавай все найденные параметры:** |
| 23 | - **`-V8Path`** — из `v8path` в `.v8-project.json`. Если не передать, скрипт автоопределит версию платформы, что может выбрать не ту версию |
| 24 | - **`-UserName`** — из поля `user` найденной записи базы (если есть) |
| 25 | - **`-Password`** — из поля `password` найденной записи базы (если есть) |
| 26 | - **`-ApachePath`** — из `webPath` в `.v8-project.json` (если есть) |
| 27 | |
| 28 | Если файла `.v8-project.json` нет — предложи `/db-list add`. |
| 29 | |
| 30 | ## Команда |
| 31 | |
| 32 | ```powershell |
| 33 | powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 <параметры> |
| 34 | ``` |
| 35 | |
| 36 | ### Параметры скрипта |
| 37 | |
| 38 | | Параметр | Обязательный | Описание | |
| 39 | |----------|:------------:|----------| |
| 40 | | `-V8Path <путь>` | нет | Каталог bin платформы (для wsap24.dll) | |
| 41 | | `-InfoBasePath <путь>` | * | Файловая база | |
| 42 | | `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) | |
| 43 | | `-InfoBaseRef <имя>` | * | Имя базы на сервере | |
| 44 | | `-UserName <имя>` | нет | Имя пользователя | |
| 45 | | `-Password <пароль>` | нет | Пароль | |
| 46 | | `-AppName <имя>` | нет | Имя публикации (по умолчанию из имени каталога базы) | |
| 47 | | `-ApachePath <путь>` | нет | Корень Apache (по умолчанию `tools/apache24`) | |
| 48 | | `-Port <порт>` | нет | Порт (по умолчанию `8081`) | |
| 49 | | `-Manual` | нет | Не скачивать — только проверить и дать инструкцию | |
| 50 | |
| 51 | > `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef` |
| 52 | |
| 53 | ## Несколько пользователей одной базы |
| 54 | |
| 55 | Повторный вызов с тем же AppName **заменяет** публикацию (идемпотентность). Это используется для: |
| 56 | - смены пользователя: «опубликуй под Ивановым» → тот же AppName, новый `-UserName` |
| 57 | - перезапуска после `/web-stop`: тот же вызов поднимает Apache обратно |
| 58 | |
| 59 | Если пользователь просит **параллельную** публикацию под другим пользователем (для тестирования разных наборов прав), добавь суффикс к AppName: |
| 60 | - база `bpdemo`, пользователь `Иванов` → `-AppName bpdemo-ivanov` |
| 61 | - база `bpdemo`, пользователь `Admin` → `-AppName bpdemo-admin` (или просто `bpdemo`) |
| 62 | |
| 63 | Ключевые слова: «ещё одну публикацию», «дополнительно», «параллельно», «под другим пользователем не убирая текущую». |
| 64 | |
| 65 | ## После выполнения |
| 66 | |
| 67 | 1. Сообщи URL-ы: |
| 68 | - Веб-клиент: `http://localhost:{Port}/{AppName}` |
| 69 | - OData: `http://localhost:{Port}/{AppName}/odata/standard.odata` |
| 70 | - HTTP-сервисы: `http://localhost:{Port}/{AppName}/hs/<RootUrl>/...` |
| 71 | - Web-сервисы: `http://localhost:{Port}/{AppName}/ws/<Имя>?wsdl` |
| 72 | 2. Предложи открыть в браузере |
| 73 | 3. Если нужно протестировать сервис — помоги составить запрос |
| 74 | 4. Если база не зарегистрирована — предложи `/db-list add` |
| 75 | |
| 76 | ## Примеры |
| 77 | |
| 78 | ```powershell |
| 79 | # Файловая база |
| 80 | powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" |
| 81 | |
| 82 | # С явным именем публикации и портом |
| 83 | powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBasePath "C:\Bases\MyDB" -AppName "mydb" -Port 9090 |
| 84 | |
| 85 | # Серверная база |
| 86 | powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" |
| 87 | |
| 88 | # Ручной режим (только инструкция) |
| 89 | powershell.exe -NoProfile -File .claude/skills/web-publish/scripts/web-publish.ps1 -InfoBasePath "C:\Bases\MyDB" -Manual |
| 90 | ``` |