mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-06-11 00:14:56 +03:00

Files

T

Nick Shirokov 01315839fb docs: add .v8-project.json reference guide

Consolidate project config documentation into a single guide covering all
fields (v8path, databases, webPath, ffmpegPath, tts, webUrl), with "who fills"
column and resolution algorithm. Replace duplicated format sections in
db-guide.md and web-guide.md with links to the new guide.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-03 13:14:08 +03:00

6.2 KiB

Raw Blame History

Веб-публикация 1С

Навыки группы /web-* позволяют публиковать информационные базы 1С через Apache HTTP Server для доступа из браузера (веб-клиент). Это замыкает цикл разработки: правка исходников → загрузка → обновление БД → открытие в браузере.

Навыки

Навык	Скрипт	Описание
`/web-publish`	`.ps1`	Публикация базы (VRD + httpd.conf + запуск Apache)
`/web-info`	`.ps1`	Статус Apache и список публикаций
`/web-stop`	`.ps1`	Остановка Apache
`/web-unpublish`	`.ps1`	Удаление публикации (одной или всех `--all`)

Рабочий цикл

правки в исходниках → /db-load-xml → /db-update → /web-publish → браузер
                                                        ↑
                                   /web-info ← статус   |
                                   /web-stop ← остановка|
                                   /web-unpublish ← удаление

Типичный цикл разработки

Настройка — /db-list add зарегистрировать базу в .v8-project.json
Загрузка — /db-load-xml загрузить конфигурацию
Обновление — /db-update применить к БД
Публикация — /web-publish опубликовать базу (при первом запуске скачает Apache)
Проверка — открыть http://localhost:8081/{appname} в браузере
Правка — изменить исходники
Синхронизация — /db-load-git + /db-update
Проверка — обновить страницу в браузере
Завершение — /web-stop остановить Apache

Конфигурация в `.v8-project.json`

Поле webPath указывает путь к каталогу Apache. Если не задано, используется tools/apache24 от корня проекта.

Полное описание формата — в справочнике .v8-project.json.

Сценарии использования

Опубликовать базу

> Опубликуй базу bp-demo

Claude вызовет /web-publish bp-demo → скачает Apache (если нет) → сгенерирует VRD → настроит httpd.conf → запустит Apache → выдаст URL.

Проверить статус

> Что с веб-сервером?

Claude вызовет /web-info → покажет состояние Apache, порт, список публикаций, последние ошибки.

Опубликовать на другом порту

> Опубликуй ERP на порту 9090

Claude вызовет /web-publish erp --port 9090.

Сменить пользователя публикации

> Переключи публикацию bp-demo на пользователя Иванов

Claude вызовет /web-publish bp-demo с -UserName "Иванов" — перезапишет VRD с новым пользователем.

Параллельные публикации под разными пользователями

> Добавь ещё одну публикацию bp-demo под Ивановым, Admin оставь

Claude вызовет /web-publish bp-demo --appname bpdemo-ivanov --user Иванов — создаст вторую публикацию. Обе будут доступны одновременно по разным URL.

Остановить сервер

> Останови Apache

Claude вызовет /web-stop.

Удалить публикацию

> Убери публикацию bpdemo

Claude вызовет /web-unpublish bpdemo → удалит блок из httpd.conf → удалит каталог → перезапустит Apache (если есть другие публикации).

Удалить все публикации

> Удали все веб-публикации

Claude вызовет /web-unpublish --all → удалит все блоки из httpd.conf → удалит все каталоги → остановит Apache.

Работа с сервисами

Протестировать HTTP-сервис

> Вызови HTTP-сервис ОбменДанными метод ПолучитьСтатус

Claude составит curl/Invoke-WebRequest к http://localhost:8081/appname/hs/exchange/status

Проверить OData

> Покажи список справочников через OData

Claude вызовет http://localhost:8081/appname/odata/standard.odata/$metadata

Получить WSDL web-сервиса

> Покажи WSDL сервиса ОбменСВнешнимиСистемами

Claude откроет http://localhost:8081/appname/ws/ExchangeWithExternalSystems?wsdl

Ручная установка Apache

Если автоматическая загрузка невозможна (прокси, firewall), используйте флаг --manual:

> Опубликуй базу --manual

Скрипт выдаст инструкцию:

Скачайте Apache Lounge (x64 VS17) с https://www.apachelounge.com/download/
Распакуйте содержимое Apache24/ в tools/apache24 (или путь из webPath)
Запустите команду повторно

Спецификации

web-spec.md — техническая спецификация (VRD, httpd.conf, wsap24.dll, portable Apache)
build-spec.md — пакетный режим конфигуратора 1С

6.2 KiB Raw Blame History Unescape Escape