Auto-build: codeassistant (python) from 8826a88

.codeassistant/skills/form-compile/references/roles-access.md

@@ -0,0 +1,73 @@
+# Доступ по ролям
+
+Единый механизм платформы для разграничения по ролям: задаётся общее значение для всех ролей плюс исключения для конкретных ролей. Один и тот же формат значения у четырёх ключей — каждый на своём владельце:
+
+| Ключ | Владелец | Смысл |
+|------|----------|-------|
+| `userVisible` | элемент формы | пользовательская видимость элемента |
+| `view` | реквизит формы | право просмотра |
+| `edit` | реквизит формы | право редактирования |
+| `use` | команда формы | доступность команды |
+
+Ключ необязателен: его отсутствие = полный доступ для всех ролей.
+
+## Значение
+
+Две формы (одинаковы для всех четырёх ключей):
+
+**Скаляр** `true` / `false` — общее значение для всех ролей, без исключений:
+
+```json
+{ "input": "Поле", "userVisible": false }
+```
+
+**Объект** `{ "common": <bool>, "roles": { "ИмяРоли": <bool>, … } }` — общее значение `common` плюс явные исключения по ролям:
+
+```json
+{ "name": "Реквизит",
+  "edit": { "common": false, "roles": { "ПолныеПрава": true } } }
+```
+
+Роль, **не указанная** в `roles`, наследует `common`. Указанная — задаёт явный `true`/`false` (может и совпадать с `common`).
+
+## Имя роли
+
+Ключи в `roles` — имена ролей конфигурации (`ПолныеПрава`, `Бухгалтер`, …).
+
+## Примеры
+
+Элемент скрыт у всех пользователей:
+
+```json
+{ "input": "Комментарий", "userVisible": false }
+```
+
+Реквизит не виден никому и редактируется только одной ролью:
+
+```json
+{ "name": "СуммаБонуса",
+  "view": false,
+  "edit": { "common": false, "roles": { "ПолныеПрава": true } } }
+```
+
+Поле доступно для просмотра всем, но редактируемо только администратору:
+
+```json
+{ "name": "Статус",
+  "view": true,
+  "edit": { "common": false, "roles": { "Администратор": true } } }
+```
+
+Команда недоступна по умолчанию, разрешена только бухгалтеру:
+
+```json
+{ "name": "ПровестиЗакрытие",
+  "use": { "common": false, "roles": { "Бухгалтер": true } } }
+```
+
+Обратный случай — доступно всем, кроме одной роли:
+
+```json
+{ "name": "РедактироватьЦену",
+  "edit": { "common": true, "roles": { "Кладовщик": false } } }
+```