Merge branch 'main' of https://github.com/vladimir-kharin/1c_formatter

Author: vladimir-kharin

readme.md

@@ -1,24 +1,26 @@
 # Оформлятор модулей 1С
 
-**Оформлятор модулей 1С** — инструмент для автоматизации работы с исходным кодом 1С как с данными. Он позволяет:
+**Оформлятор модулей 1С** — расширяемый форматтер структуры модулей 1С. Он позволяет:
 - Форматировать код, расставлять области (можно расширять форматтер под ваши регламенты, стандарты 1С и т.д.).
 - Документировать методы при помощи LLM (вам остается проверить, поправить при необходимости).
 - Анализировать код (в том числе строить граф вызовов, находить используемые поля и пр.).
 - Перетаскивать функционал из других конфигураций, переводить язык синтаксиса и решать иные «точечные» задачи автоматизации. Но для этого нужно разрабатывать свои дополнительные компоненты (под ваши конерктные задачи).
 
 Проект реализован целиком на языке 1С, поэтому любой разработчик 1С может изучить и доработать его под свои нужды без необходимости в освоении дополнительных стеков.
 
+[Публикация на](https://infostart.ru/1c/tools/2297756/) ![Инфостарт](https://infostart.ru/bitrix/templates/sandbox_empty/assets/tpl/abo/img/logo.svg)
+
 ## Возможности
 Что есть уже сейчас:
 
+- **Расстановка стандартных областей** в модуле и автоматическое распределение по ним методов.
+- **Документирование методов** с использованием LLM (есть режим где не нужен ключ API, но ограниченный - не более 15 тыс. символов в одном запросе и ограничения по количеству запросов в минуту).
+- **Формирование текста модуля** на основании структуры данных (дерева) модуля.
 - **Парсинг кода** в структуры нескольких уровней абстракции:
   - Токенизация.
   - Построение абстрактного синтаксического дерева (АСД).
   - Формирование структуры модуля (области, переменные, сигнатуры методов с информацией из документации в комментарии над методом). Это основное представление для дальнейших операций.
   - Анализ связей в коде (например, вызовы методов, используемые поля и т.д.).
-- **Расстановка стандартных областей** в модуле и автоматическое распределение по ним методов.
-- **Документирование методов** с использованием LLM (есть режим где не нужен ключ API, но ограниченный - не более 15 тыс. символов в одном запросе и ограничения по количеству запросов в минуту).
-- **Формирование текста модуля** на основании структуры данных (дерева) модуля.
 
 ## Типовой сценарий использования
 Наиболее распространённый процесс «оформления» модуля выглядит так:
@@ -35,6 +37,8 @@
 5. **Формирование итогового текста модуля**: «Действия» → «Сформировать тексты модулей...».
 6. **Копирование результата** обратно в Конфигуратор.
 
+[Видеодемонстрация](https://vk.com/video-219359576_456239020), где в частности рассматривается внутреннее устройство и добавление компонент к решению.
+
 ![Demo GIF](./images/demo.gif)
 
 ## Структура репозитория и установка