Initial SFERA platform baseline

2026-05-16 19:03:49 +03:00
commit 3b845c8fce
282 changed files with 55045 additions and 0 deletions
@@ -0,0 +1,44 @@
+# SFERA 1C Extension
+
+Исходники расширения SFERA для опубликованной базы 1С.
+
+## Публикация
+
+HTTP-сервис расширения должен быть опубликован с корнем:
+
+```text
+sfera
+```
+
+Тогда URL формируются по правилу платформы 1С:
+
+```text
+http://server/base/hs/sfera/health
+http://server/base/hs/sfera/v1/metadata
+http://server/base/hs/sfera/v1/query
+http://server/base/hs/sfera/v1/data/read
+http://server/base/hs/sfera/v1/data/write
+http://server/base/hs/sfera/v1/metadata/apply
+```
+
+## Возможности
+
+- `health` - проверка публикации, версии расширения и режима безопасности.
+- `metadata.snapshot` - снимок доступных коллекций metadata и объектов.
+- `query.execute` - консоль запросов 1С. По умолчанию read-only/dry-run.
+- `data.read` - чтение данных через ограниченный запрос или менеджер объекта.
+- `data.write` - изменение данных только при явном `allow_mutation`.
+- `metadata.apply` - изменение структуры не выполняется из HTTP runtime. Возвращает план установки `.cfe`; применение делает Windows Agent через Designer.
+
+## Безопасность
+
+Расширение рассчитано на работу за сервером SFERA. Для опасных операций должны быть включены сразу все уровни:
+
+- публикация защищена пользователем 1С/IIS;
+- SFERA передает `X-SFERA-Token`;
+- в проекте включено `sfera_extension_allow_mutation`;
+- запрос содержит `allow_mutation=true`;
+- `dry_run=false`.
+
+Без этого операции изменения возвращают блокировку.
+