Конвертер метаданных конфигурации 1С в формат Markdown для использования в Model Context Protocol (MCP).

Программа автоматически определяет формат метаданных 1С (CFG или EDT) и конвертирует их в удобную для чтения документацию в формате Markdown. Также создается CSV каталог всех объектов.

• CFG формат (Конфигуратор) - файлы XML с Configuration.xml в корне
• EDT формат (Eclipse Development Tools) - файлы MDO с .project и src/ в корне

Внизу приведена таблица поддерживаемых типов метаданных: русское имя, англоязычный идентификатор (используется в коде) и ключ, который принимает опция --types.

Опция --types принимает перечисление ключей через запятую. Пример валидного значения:

documents,catalogs,accumulationregisters,informationregisters,enums,chartsofcharacteristictypes,constants,filtercriterias

Шаблон имени Markdown-файла: Тип_Имя.md, где Тип — русское название типа (например, Документ, Справочник), а Имя — системное имя объекта.

# Клонируем репозиторий
git clone <repository-url>
cd onec-cfg2md

# Устанавливаем зависимости
go mod tidy

# Собираем программу
go build -o bin/onec-cfg2md .

# Автоопределение формата и обработка всех документов
./bin/onec-cfg2md ./src ./output

# Принудительное указание формата
./bin/onec-cfg2md --format=edt ./edt-project ./docs

# Обработка только документов в подробном режиме
./bin/onec-cfg2md --format=cfg --types=documents --verbose ./cfg ./docs

• --format - принудительное указание формата (cfg/edt)
• --types - типы объектов для обработки (documents,catalogs,enums,charts)
• --verbose - подробный вывод процесса обработки

# Обработка примера EDT формата
onec-cfg2md ./fixtures/input/edt ./result/edt

# Обработка примера CFG формата  
onec-cfg2md ./fixtures/input/cfg ./result/cfg

# Только документы с подробным выводом
onec-cfg2md --types=documents --verbose ./fixtures/input/edt ./docs

Для каждого объекта создается файл вида Тип_Имя.md:

# Документ: АвансовыйОтчет (Авансовый отчет)

## Реквизиты шапки

- Организация (Справочник.Организации)
- ПодотчетноеЛицо (Справочник.ФизическиеЛица)
- Валюта (Справочник.Валюты)

## Табличные части

### ПрочиеРасходы (Расходы)

- Сумма (Число)
- Комментарий (Строка)

Файл objects.csv содержит сводную информацию:

Имя объекта;Тип объекта;Синоним;Файл
Документ.АвансовыйОтчет;Документ;Авансовый отчет;Документ_АвансовыйОтчет.md

make build       # Основная программа

make test           # Unit тесты
make run-test-edt   # Тест EDT формата
make run-test-cfg   # Тест CFG формата

├── main.go              # точка входа (вызов CLI)
├── cmd/                 # реализация CLI (cobra-команды)
├── pkg/
│   ├── detector/        # определение формата (CFG/EDT)
│   ├── generator/       # генераторы Markdown и CSV
│   ├── model/           # модель метаданных (MetadataObject и пр.)
│   ├── parser/          # парсеры CFG и EDT (cfg_parser.go, edt_parser.go) 
│   └── testutil/        # вспомогательные модули для тестов
├── fixtures/            # тестовые фикстуры (input/ и output/)
└── docs/                # техническая документация

Подробное техническое задание доступно в файле docs/TECHNICAL_SPECIFICATION.md.

LICENSE