Auto-build: codeassistant (python) from 8826a88

2026-07-22 12:41:02 +03:00 · 2026-07-20 17:20:59 +00:00
commit 54d9ff2a52
306 changed files with 149407 additions and 0 deletions
@@ -0,0 +1,138 @@
+---
+name: meta-compile
+description: Создать объект метаданных 1С. Используй когда нужно создать или добавить справочник, документ, регистр, перечисление, константу, общий модуль, обработку, отчёт и др.
+argument-hint: <JsonPath> <OutputDir>
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Glob
+---
+
+# /meta-compile — генерация объектов метаданных из JSON
+
+Принимает JSON-определение объекта → генерирует XML + модули в структуре выгрузки конфигурации и
+регистрирует объект в `Configuration.xml`.
+
+`ConfigDumpInfo.xml` намеренно не трогается: это служебный файл версий объектов, которым управляет
+платформа (для инкрементальной выгрузки).
+
+## Порядок работы
+
+1. Составь JSON по синтаксису ниже → запиши во временный файл.
+2. Запусти скрипт.
+3. Изменить созданный объект — `/meta-edit`; проверить — `/meta-validate`.
+
+```powershell
+python ".codeassistant/skills/meta-compile/scripts/meta-compile.py" -JsonPath "<json>" -OutputDir "<ConfigDir>"
+```
+
+| Параметр | Описание |
+|----------|----------|
+| `JsonPath` | Путь к JSON-файлу |
+| `OutputDir` | Корень выгрузки конфигурации (где `Configuration.xml`, `Catalogs/`, `Documents/`, …) |
+
+## Формат JSON
+
+**Один объект** `{ ... }` или **массив** объектов `[{ ... }, { ... }]` (batch — несколько объектов за прогон).
+
+```json
+{ "type": "Catalog", "name": "Номенклатура", "...свойства типа...": "..." }
+```
+
+`type` и `name` — обязательные. Остальное — по типу (см. индекс ниже). `synonym` по умолчанию выводится из
+`name` (CamelCase → слова через пробел); можно задать явно строкой или мультиязычно: `"synonym": { "ru": "…", "en": "…" }`.
+
+## Реквизиты (shorthand)
+
+Массивы `attributes`, `dimensions`, `resources` и колонки в `tabularSections` задаются строками:
+
+```
+"Имя"                          → String(10)
+"Имя: Тип"                     → с типом
+"Имя: Тип | req, index"        → с флагами
+```
+
+**Типы:** `String(100)`, `String(10, fixed)` (фикс. длина), `Number(15,2)`, `Boolean`, `Date`, `DateTime`,
+`Time`, ссылочные `CatalogRef.Xxx` / `DocumentRef.Xxx` / `EnumRef.Xxx` / `DefinedType.Xxx` и т.п.
+Составной тип — через `+`: `"Значение: String + Number(15,2) + CatalogRef.Контрагенты"`.
+
+**Флаги** (после `|`, через запятую):
+
+| Флаг | Значение | Где |
+|------|----------|-----|
+| `req` | обязательное заполнение | attributes, dimensions, resources |
+| `index` | индексировать | attributes, dimensions |
+| `indexAdditional` | индекс с доп. упорядочиванием | attributes |
+| `multiline` | многострочное поле | attributes |
+| `nonneg` | неотрицательное (Number) | attributes, resources |
+| `master` | ведущее измерение | dimensions (регистры) |
+| `mainFilter` | основной отбор | dimensions (регистры) |
+| `denyIncomplete` | запрет незаполненных | dimensions |
+| `useInTotals` | использовать в итогах | dimensions (регистр накопления) |
+
+Реквизиту нужны свойства сверх shorthand (значение заполнения, параметры выбора, формат, подсказка, …) —
+задаётся **объектной формой**, см. `reference/attributes.md`.
+
+## Табличные части
+
+```json
+"tabularSections": { "Товары": ["Номенклатура: CatalogRef.Номенклатура", "Количество: Number(15,3)"] }
+```
+
+Ключ — имя ТЧ, значение — массив колонок (shorthand) ЛИБО объект со свойствами ТЧ (см. `reference/attributes.md`).
+
+## Индекс: свойства по типам
+
+Для каждого типа — свой reference-файл со свойствами, дефолтами и допустимыми значениями:
+
+| Тип(ы) | Файл |
+|--------|------|
+| Catalog (справочник) | `reference/catalog.md` |
+| Document, DocumentJournal, Sequence, DocumentNumerator | `reference/document.md` |
+| InformationRegister, AccumulationRegister, AccountingRegister, CalculationRegister | `reference/registers.md` |
+| ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes | `reference/charts.md` |
+| ExchangePlan | `reference/exchangeplan.md` |
+| BusinessProcess, Task | `reference/process.md` |
+| Report, DataProcessor | `reference/report-dataprocessor.md` |
+| CommonModule, ScheduledJob, EventSubscription | `reference/code.md` |
+| HTTPService, WebService | `reference/web.md` |
+| Enum, Constant, DefinedType | `reference/simple.md` |
+| FunctionalOption, FilterCriterion, SettingsStorage, CommonForm, CommonPicture, CommonTemplate, служебные | `reference/other-types.md` |
+
+Кросс-типовые детали:
+- **`reference/attributes.md`** — объектная форма реквизита и колонки ТЧ (значение заполнения, параметры
+  выбора, формат, подсказка, границы, …) + свойства самой ТЧ.
+- **`reference/blocks.md`** — блоки объекта: представления, команды (+ характеристики/стандартные реквизиты).
+
+Эта инструкция и reference-файлы — полная документация. Не ищи примеры XML в выгрузках конфигураций.
+
+## Примеры
+
+Справочник с реквизитами:
+```json
+{ "type": "Catalog", "name": "Организации", "descriptionLength": 100,
+  "attributes": ["ИНН: String(12)", "КПП: String(9)", "Директор: CatalogRef.ФизическиеЛица"] }
+```
+
+Документ с движениями и ТЧ:
+```json
+{ "type": "Document", "name": "ПриходнаяНакладная",
+  "registerRecords": ["AccumulationRegister.ОстаткиТоваров"],
+  "attributes": ["Организация: CatalogRef.Организации", "Контрагент: CatalogRef.Контрагенты"],
+  "tabularSections": { "Товары": ["Номенклатура: CatalogRef.Номенклатура", "Количество: Number(15,3)", "Цена: Number(15,2)"] } }
+```
+
+Регистр сведений:
+```json
+{ "type": "InformationRegister", "name": "КурсыВалют", "periodicity": "Day",
+  "dimensions": ["Валюта: CatalogRef.Валюты | master, mainFilter, denyIncomplete"],
+  "resources": ["Курс: Number(15,4)", "Кратность: Number(10,0)"] }
+```
+
+Batch:
+```json
+[ { "type": "Enum", "name": "Статусы", "values": ["Новый", "Закрыт"] },
+  { "type": "Catalog", "name": "Валюты" },
+  { "type": "Constant", "name": "ОсновнаяВалюта", "valueType": "CatalogRef.Валюты" } ]
+```