mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-07-16 15:55:16 +03:00
chore(repo): нормализация EOL к LF + .gitattributes
Приводим авторский контент (.ps1/.psm1/.py/.mjs/.md/.json, пин .bsl) к единому LF и закрепляем политикой в .gitattributes. Инструмент правки всегда пишет LF, поэтому единый LF убирает EOL-шум в диффах, ложные срабатывания blame и налог на ручную синхронизацию CRLF-файлов. BOM на .ps1 сохранён (git с eol=lf меняет только CR<->LF, BOM не трогает). Данные 1С (*.xml) и бинарники под нормализацию не берём. Гейт: PS-порт 459/459, Python-порт 459/459, web-test E2E 22/22 (с пересборкой стенда). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
+147
-147
@@ -1,147 +1,147 @@
|
||||
# Веб-публикация 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 ← удаление
|
||||
```
|
||||
|
||||
### Типичный цикл разработки
|
||||
|
||||
1. **Настройка** — `/db-list add` зарегистрировать базу в `.v8-project.json`
|
||||
2. **Загрузка** — `/db-load-xml` загрузить конфигурацию
|
||||
3. **Обновление** — `/db-update` применить к БД
|
||||
4. **Публикация** — `/web-publish` опубликовать базу (при первом запуске скачает Apache)
|
||||
5. **Проверка** — открыть `http://localhost:8081/{appname}` в браузере
|
||||
6. **Правка** — изменить исходники
|
||||
7. **Синхронизация** — `/db-load-git` + `/db-update`
|
||||
8. **Проверка** — обновить страницу в браузере
|
||||
9. **Завершение** — `/web-stop` остановить Apache
|
||||
|
||||
## Конфигурация в `.v8-project.json`
|
||||
|
||||
Поле `webPath` указывает путь к каталогу Apache. Если не задано, используется `tools/apache24` от корня проекта.
|
||||
|
||||
Полное описание формата — в [справочнике .v8-project.json](v8-project-guide.md).
|
||||
|
||||
## Сценарии использования
|
||||
|
||||
### Опубликовать базу
|
||||
|
||||
```
|
||||
> Опубликуй базу 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
|
||||
```
|
||||
|
||||
Скрипт выдаст инструкцию:
|
||||
1. Скачайте Apache Lounge (x64 VS17) с https://www.apachelounge.com/download/
|
||||
2. Распакуйте содержимое `Apache24/` в `tools/apache24` (или путь из `webPath`)
|
||||
3. Запустите команду повторно
|
||||
|
||||
## Спецификации
|
||||
|
||||
- [web-spec.md](web-spec.md) — техническая спецификация (VRD, httpd.conf, wsap24.dll, portable Apache)
|
||||
- [build-spec.md](build-spec.md) — пакетный режим конфигуратора 1С
|
||||
# Веб-публикация 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 ← удаление
|
||||
```
|
||||
|
||||
### Типичный цикл разработки
|
||||
|
||||
1. **Настройка** — `/db-list add` зарегистрировать базу в `.v8-project.json`
|
||||
2. **Загрузка** — `/db-load-xml` загрузить конфигурацию
|
||||
3. **Обновление** — `/db-update` применить к БД
|
||||
4. **Публикация** — `/web-publish` опубликовать базу (при первом запуске скачает Apache)
|
||||
5. **Проверка** — открыть `http://localhost:8081/{appname}` в браузере
|
||||
6. **Правка** — изменить исходники
|
||||
7. **Синхронизация** — `/db-load-git` + `/db-update`
|
||||
8. **Проверка** — обновить страницу в браузере
|
||||
9. **Завершение** — `/web-stop` остановить Apache
|
||||
|
||||
## Конфигурация в `.v8-project.json`
|
||||
|
||||
Поле `webPath` указывает путь к каталогу Apache. Если не задано, используется `tools/apache24` от корня проекта.
|
||||
|
||||
Полное описание формата — в [справочнике .v8-project.json](v8-project-guide.md).
|
||||
|
||||
## Сценарии использования
|
||||
|
||||
### Опубликовать базу
|
||||
|
||||
```
|
||||
> Опубликуй базу 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
|
||||
```
|
||||
|
||||
Скрипт выдаст инструкцию:
|
||||
1. Скачайте Apache Lounge (x64 VS17) с https://www.apachelounge.com/download/
|
||||
2. Распакуйте содержимое `Apache24/` в `tools/apache24` (или путь из `webPath`)
|
||||
3. Запустите команду повторно
|
||||
|
||||
## Спецификации
|
||||
|
||||
- [web-spec.md](web-spec.md) — техническая спецификация (VRD, httpd.conf, wsap24.dll, portable Apache)
|
||||
- [build-spec.md](build-spec.md) — пакетный режим конфигуратора 1С
|
||||
|
||||
Reference in New Issue
Block a user