Auto-build: opencode (python) from 78fc3ba

2026-08-15 07:49:01 +03:00 · 2026-08-13 18:14:31 +00:00
commit d5c0a1e0fb
324 changed files with 174517 additions and 0 deletions
@@ -0,0 +1,115 @@
+---
+name: role-compile
+description: Создание роли 1С из описания прав. Используй когда нужно создать новую роль с набором прав на объекты
+argument-hint: <JsonPath> <OutputDir>
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Glob
+---
+
+# /role-compile — генерация роли 1С из JSON DSL
+
+Принимает JSON-определение роли → генерирует `Roles/Имя.xml` (метаданные) и `Roles/Имя/Ext/Rights.xml` (права). UUID автоматически.
+
+## Параметры и команда
+
+| Параметр | Описание |
+|----------|----------|
+| `JsonPath` | Путь к JSON-определению роли |
+| `OutputDir` | Корень выгрузки конфигурации (где `Configuration.xml`, `Roles/` и т.д.) |
+
+```powershell
+python ".opencode/skills/role-compile/scripts/role-compile.py" -JsonPath "<json>" -OutputDir "<ConfigDir>"
+```
+
+Создаёт `{OutputDir}/Roles/Имя.xml` и `{OutputDir}/Roles/Имя/Ext/Rights.xml`. Регистрирует `<Role>` в `Configuration.xml`.
+
+## JSON DSL
+
+### Структура
+
+```json
+{ "name": "ИмяРоли", "synonym": "Отображаемое имя", "objects": [...], "templates": [...] }
+```
+
+Необязательные: `comment` (""), `setForNewObjects` (false), `setForAttributesByDefault` (true), `independentRightsOfChildObjects` (false).
+
+### Shorthand-строки и объектная форма
+
+```json
+"objects": [
+  "Catalog.Номенклатура: @view",
+  "Document.Реализация: @edit",
+  "DataProcessor.Загрузка: @view",
+  "InformationRegister.Цены: Read, Update",
+  { "name": "Document.Продажа", "preset": "view", "rights": {"Delete": false}, "rls": {"Read": "#Шаблон(\"\")"} }
+]
+```
+
+- Shorthand: `"Тип.Имя: @пресет"` или `"Тип.Имя: Право1, Право2"`
+- Объектная форма: `preset` + `rights` (переопределения) + `rls` (ограничения)
+
+### Пресеты
+
+| Пресет | Действие |
+|--------|----------|
+| `@view` | Просмотр — Read, View (+InputByString для справочников/документов; Use+View для обработок/отчётов) |
+| `@edit` | Полное редактирование — CRUD + Interactive* + Posting (документы) |
+
+`@` обязателен в shorthand. В объектной форме — `"preset": "view"` без `@`.
+
+Для сервисов (WebService, HTTPService, IntegrationService) пресеты не определены — используй явные права: `"WebService.Имя: Use"`.
+
+### Русские синонимы
+
+Поддерживаются русские типы (`Справочник`→Catalog, `Документ`→Document) и права (`Чтение`→Read, `Просмотр`→View). Каноничная форма — английская.
+
+### Шаблоны RLS
+
+```json
+"templates": [{"name": "ДляОбъекта(Мод)", "condition": "ГДЕ Организация = &ТекОрг"}]
+```
+
+Ссылка в `rls`: `"#ДляОбъекта(\"\")"`. Символ `&` автоматически экранируется в XML.
+
+## Примеры
+
+### Простая роль
+
+```json
+{
+  "name": "ЧтениеНоменклатуры", "synonym": "Чтение номенклатуры",
+  "objects": ["Catalog.Номенклатура: @view", "Catalog.Контрагенты: @view", "DataProcessor.Загрузка: @view"]
+}
+```
+
+### Роль с RLS
+
+```json
+{
+  "name": "ЧтениеДокументовПоОрганизации",
+  "synonym": "Чтение документов (ограничение по организации)",
+  "objects": [
+    "Catalog.Организации: @view",
+    {"name": "Document.РеализацияТоваровУслуг", "preset": "view", "rls": {"Read": "#ДляОбъекта(\"\")"}}
+  ],
+  "templates": [{"name": "ДляОбъекта(Модификатор)", "condition": "ГДЕ Организация = &ТекущаяОрганизация"}]
+}
+```
+
+## Что можно писать в `objects`
+
+Права имеют 27 типов объектов; тип или имя права вне списка — ошибка: роль не создаётся, файлы не пишутся, `Configuration.xml` не меняется. Права нельзя назначить на `Enum`, `CommonModule`, `DefinedType`, `CommonPicture`, `CommonTemplate`, `Language`, `FunctionalOption`, `EventSubscription`, `ScheduledJob`, `StyleItem`, `SettingsStorage` и подобные — в дереве редактора ролей их нет.
+
+Права на части объекта задаются точечным путём: `Catalog.Контрагенты.Attribute.ИНН: View, Edit`, `WebService.Обмен.Operation.Загрузить: Use`.
+
+Полные таблицы «тип → права», виды вложенности (включая внешние источники данных), список типов без прав, таблицы пресетов и дополнительные примеры — в `dsl-reference.md`.
+
+## Верификация
+
+```
+/role-validate <RightsPath> [MetadataPath]  — проверка корректности XML, прав, RLS
+/role-info <RightsPath>                     — визуальная сводка структуры
+```
@@ -0,0 +1,203 @@
+# Role DSL — полная справка
+
+Подробная справка по JSON DSL для `/role-compile`. Компактное описание — в [SKILL.md](SKILL.md).
+
+## Какие объекты можно писать в `objects`
+
+Права в роли имеют ровно 27 типов. Тип вне этого списка — ошибка компиляции: роль не
+создаётся, файлы не пишутся.
+
+| Тип | Права |
+|-----|-------|
+| `Configuration` | Administration, DataAdministration, UpdateDataBaseConfiguration, ConfigurationExtensionsAdministration, ActiveUsers, EventLog, ExclusiveMode, ThinClient, ThickClient, WebClient, MobileClient, ExternalConnection, Automation, Output, SaveUserData, TechnicalSpecialistMode, InteractiveOpenExtDataProcessors, InteractiveOpenExtReports, AnalyticsSystemClient, CollaborationSystemInfoBaseRegistration, MainWindowModeNormal, MainWindowModeWorkplace, MainWindowModeEmbeddedWorkplace, MainWindowModeFullscreenWorkplace, MainWindowModeKiosk |
+| `Catalog`, `ChartOfCharacteristicTypes` | Read, Insert, Update, Delete, View, Edit, InputByString, Interactive* (Insert, SetDeletionMark, ClearDeletionMark, Delete, DeleteMarked), *PredefinedData, *DataHistory* |
+| `Document` | то же + Posting, UndoPosting, InteractivePosting, InteractivePostingRegular, InteractiveUndoPosting, InteractiveChangeOfPosted |
+| `ChartOfAccounts`, `ChartOfCalculationTypes`, `ExchangePlan` | Read, Insert, Update, Delete, View, Edit, InputByString, Interactive*, *DataHistory* (без InteractiveDeleteMarked у ChartOfAccounts) |
+| `BusinessProcess` | Read, Insert, Update, Delete, View, Edit, InputByString, Start, InteractiveInsert, InteractiveSetDeletionMark, InteractiveClearDeletionMark, InteractiveDelete, InteractiveActivate, InteractiveStart |
+| `Task` | то же, но вместо Start/InteractiveStart — Execute, InteractiveExecute |
+| `InformationRegister` | Read, Update, View, Edit, TotalsControl, *DataHistory* |
+| `AccumulationRegister`, `AccountingRegister` | Read, Update, View, Edit, TotalsControl |
+| `CalculationRegister` | Read, View |
+| `Constant` | Read, Update, View, Edit, *DataHistory* |
+| `DocumentJournal` | Read, View |
+| `Sequence` | Read, Update |
+| `DataProcessor`, `Report` | Use, View |
+| `WebService`, `HTTPService`, `IntegrationService` | Use |
+| `CommonForm`, `CommonCommand`, `Subsystem`, `FilterCriterion` | View |
+| `CommonAttribute` | View, Edit |
+| `SessionParameter` | Get, Set |
+| `ExternalDataSource` | Use, Administration, StandardAuthenticationChange, SessionStandardAuthenticationChange, SessionOSAuthenticationChange |
+
+Полные списки прав по каждому типу — в коде навыка (`scripts/role-compile.ps1`,
+таблица `$knownRights`); навык проверяет каждое имя права и отвергает несуществующее.
+
+### Вложенные объекты
+
+Путь длиннее двух сегментов задаёт права на часть объекта. Вид вложенности —
+предпоследний сегмент, он определяет набор прав.
+
+| Вид | Права |
+|-----|-------|
+| `Attribute`, `StandardAttribute`, `TabularSection`, `StandardTabularSection`, `Dimension`, `Resource`, `AccountingFlag`, `ExtDimensionAccountingFlag`, `AddressingAttribute` | View, Edit |
+| `Command`, вложенная `Subsystem` | View |
+| `Operation` (веб-сервис), `Method` (HTTP-сервис, под `URLTemplate`), `IntegrationServiceChannel` | Use |
+| `Recalculation` (регистр расчёта) | Read, Update |
+
+Виды `Operation`, `Method`, `IntegrationServiceChannel`, `Recalculation` и виды внешнего
+источника допустимы только у своего типа-родителя. Графы журнала документов
+(`DocumentJournal.Ж.Column.Г`) собственных прав не имеют.
+
+Примеры: `Catalog.Контрагенты.Attribute.ИНН: View, Edit`,
+`Document.Реализация.TabularSection.Товары.Attribute.Цена: View`,
+`WebService.Обмен.Operation.Загрузить: Use`,
+`HTTPService.API.URLTemplate.Файлы.Method.get: Use`.
+
+### Вложенные объекты внешнего источника данных
+
+Виды `Table`, `Cube`, `Function`, `Field`, `DimensionTable` бывают **только** под
+`ExternalDataSource`.
+
+| Путь | Права |
+|------|-------|
+| `ExternalDataSource.И.Table.Т` | Read, Insert, Update, Delete, View, Edit, InputByString, InteractiveInsert, InteractiveDelete |
+| `ExternalDataSource.И.Table.Т.Field.П` | View, Edit |
+| `ExternalDataSource.И.Cube.К` | Read, View |
+| `ExternalDataSource.И.Cube.К.Dimension.И`, `…Resource.Р` | View |
+| `ExternalDataSource.И.Cube.К.DimensionTable.Т` | Read, View |
+| `ExternalDataSource.И.Cube.К.DimensionTable.Т.Field.П` | View, Edit |
+| `ExternalDataSource.И.Function.Ф` | Use, View |
+| `…Table.Т.Command.К`, `…Cube.К.Command.К`, `…DimensionTable.Т.Command.К` | View |
+
+### Типы объектов без прав в ролях
+
+Права нельзя назначить на `Enum`, `CommonModule`, `DefinedType`, `CommonPicture`,
+`CommonTemplate`, `Language`, `FunctionalOption`, `FunctionalOptionsParameter`,
+`EventSubscription`, `ScheduledJob`, `StyleItem`, `Style`, `SettingsStorage`,
+`XDTOPackage`, `WSReference`, `DocumentNumerator` — в дереве редактора ролей этих типов нет.
+
+Попытка — ошибка компиляции. Права на перечисления особенно опасны: конфигурация с таким
+блоком не загружается в информационную базу, конфигуратор зависает без сообщений.
+
+## Формат записи объектов
+
+Массив `objects` принимает строки (shorthand) и объекты (полная форма).
+
+```json
+{
+  "name": "Document.Реализация",
+  "preset": "view",
+  "rights": { "Delete": false },
+  "rls": { "Read": "#ДляОбъекта(\"\")" }
+}
+```
+
+- `preset` — базовый набор прав (`"view"`, `"edit"`)
+- `rights` — переопределения: dict `{"Right": true/false}` или массив `["Right1", "Right2"]`
+- `rls` — RLS-ограничения: `{"ИмяПрава": "текст условия"}`
+
+Русские имена типов и прав тоже принимаются (`Справочник.Контрагенты: Чтение`), каноничная
+форма — английская.
+
+## Пресеты — подробные таблицы
+
+Пресеты обозначаются `@` в строковом формате. В объектной форме ключ `preset` без `@`.
+
+### `@view` — просмотр
+
+| Тип объекта | Права |
+|-------------|-------|
+| Catalog, ExchangePlan, Document, ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes, BusinessProcess, Task | Read, View, InputByString |
+| InformationRegister, AccumulationRegister, AccountingRegister, CalculationRegister, Constant, DocumentJournal | Read, View |
+| Sequence | Read |
+| CommonForm, CommonCommand, Subsystem, FilterCriterion, CommonAttribute | View |
+| DataProcessor, Report | Use, View |
+| SessionParameter | Get |
+| Configuration | ThinClient, WebClient, Output, SaveUserData, MainWindowModeNormal |
+
+### `@edit` — полное редактирование
+
+| Тип объекта | Права |
+|-------------|-------|
+| Catalog, ExchangePlan, ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes | Read, Insert, Update, Delete, View, Edit, InputByString, InteractiveInsert, InteractiveSetDeletionMark, InteractiveClearDeletionMark |
+| Document | Read, Insert, Update, Delete, View, Edit, InputByString, Posting, UndoPosting, InteractiveInsert, InteractiveSetDeletionMark, InteractiveClearDeletionMark, InteractivePosting, InteractivePostingRegular, InteractiveUndoPosting, InteractiveChangeOfPosted |
+| BusinessProcess | Read, Insert, Update, Delete, View, Edit, InputByString, Start, InteractiveInsert, InteractiveSetDeletionMark, InteractiveClearDeletionMark, InteractiveActivate, InteractiveStart |
+| Task | Read, Insert, Update, Delete, View, Edit, InputByString, Execute, InteractiveInsert, InteractiveSetDeletionMark, InteractiveClearDeletionMark, InteractiveActivate, InteractiveExecute |
+| InformationRegister, AccumulationRegister, AccountingRegister, Constant | Read, Update, View, Edit |
+| DocumentJournal | Read, View |
+| Sequence | Read, Update |
+| SessionParameter | Get, Set |
+| CommonAttribute | View, Edit |
+
+Для сервисов (WebService, HTTPService, IntegrationService) и внешних источников данных
+пресеты не определены — задавай права явно: `"WebService.Имя: Use"`.
+
+## Шаблоны ограничений (RLS templates)
+
+```json
+"templates": [
+  {
+    "name": "ДляОбъекта(Модификатор)",
+    "condition": "// текст шаблона\nГДЕ 1=1\n&Модификатор"
+  }
+]
+```
+
+- `&` в условии автоматически экранируется в `&amp;` в XML
+- Ссылка на шаблон в `rls`: `"#ИмяШаблона(\"параметры\")"` — начинается с `#`
+- Параметры шаблона можно передавать пустыми: `#ДляОбъекта("")`
+
+## Примеры
+
+### Роль с RLS
+
+```json
+{
+  "name": "ЧтениеДокументовПоОрганизации",
+  "synonym": "Чтение документов (ограничение по организации)",
+  "objects": [
+    "Catalog.Организации: @view",
+    {
+      "name": "Document.РеализацияТоваровУслуг",
+      "preset": "view",
+      "rls": {
+        "Read": "#ДляОбъекта(\"\")"
+      }
+    }
+  ],
+  "templates": [
+    {
+      "name": "ДляОбъекта(Модификатор)",
+      "condition": "ГДЕ Организация = &ТекущаяОрганизация"
+    }
+  ]
+}
+```
+
+### Роль с переопределением прав из пресета
+
+```json
+{
+  "name": "ОграниченноеРедактирование",
+  "synonym": "Редактирование без удаления",
+  "objects": [
+    {
+      "name": "Catalog.Контрагенты",
+      "preset": "edit",
+      "rights": { "Delete": false }
+    }
+  ]
+}
+```
+
+### Роль с правами на части объекта
+
+```json
+{
+  "name": "МенеджерБезЦен",
+  "synonym": "Менеджер без доступа к ценам",
+  "objects": [
+    "Catalog.Номенклатура: @view",
+    { "name": "Catalog.Номенклатура.Attribute.Цена", "rights": { "View": false, "Edit": false } }
+  ]
+}
+```