feat: Добавлены комментарии и документация в RoleConverter для улучшения понимания кода

- Добавлены Javadoc комментарии для методов и класса, описывающие их функциональность и параметры.
- Обновлены пути к файлам прав доступа.

Author: johnnyshut

src/main/java/com/github/_1c_syntax/bsl/reader/designer/converter/RoleConverter.java

@@ -31,11 +31,21 @@
 import java.nio.file.Path;
 import java.nio.file.Paths;
 
+/**
+ * Конвертер для чтения ролей из формата конфигуратора
+ */
 @DesignerConverter
 public class RoleConverter extends AbstractReadConverter {
 
   private static final String DATA_FIELD = "data";
 
+  /**
+   * Выполняет чтение роли из XML, включая данные прав доступа из файла Rights.xml
+   *
+   * @param reader  Ридер XML потока
+   * @param context Контекст десериализации
+   * @return Прочитанный объект роли с данными прав доступа
+   */
   @Override
   public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
     var readerContext = super.read(reader, context);
@@ -57,11 +67,24 @@ public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext co
     return readerContext.build();
   }
 
+  /**
+   * Проверяет, может ли конвертер обработать указанный тип
+   *
+   * @param type Тип класса для проверки
+   * @return true, если тип является Role или его подклассом
+   */
   @Override
   public boolean canConvert(Class type) {
     return Role.class.isAssignableFrom(type);
   }
 
+  /**
+   * Формирует путь к файлу Rights.xml для роли
+   *
+   * @param path Путь к файлу описания роли
+   * @param name Имя роли
+   * @return Путь к файлу Rights.xml
+   */
   private static Path dataPath(Path path, String name) {
     return Paths.get(path.getParent().toString(), name, "Ext", "Rights.xml");
   }

src/main/java/com/github/_1c_syntax/bsl/reader/edt/converter/RoleConverter.java

@@ -30,11 +30,21 @@
 
 import java.nio.file.Path;
 
+/**
+ * Конвертер для чтения ролей из формата ЕДТ
+ */
 @EDTConverter
 public class RoleConverter extends AbstractReadConverter {
 
   private static final String DATA_FIELD = "data";
 
+  /**
+   * Выполняет чтение роли из XML, включая данные прав доступа из файла Rights.rights
+   *
+   * @param reader  Ридер XML потока
+   * @param context Контекст десериализации
+   * @return Прочитанный объект роли с данными прав доступа
+   */
   @Override
   public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
     var readerContext = super.read(reader, context);
@@ -56,11 +66,23 @@ public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext co
     return readerContext.build();
   }
 
+  /**
+   * Проверяет, может ли конвертер обработать указанный тип
+   *
+   * @param type Тип класса для проверки
+   * @return true, если тип является Role или его подклассом
+   */
   @Override
   public boolean canConvert(Class type) {
     return Role.class.isAssignableFrom(type);
   }
 
+  /**
+   * Формирует путь к файлу Rights.rights для роли
+   *
+   * @param path Путь к файлу описания роли
+   * @return Путь к файлу Rights.rights
+   */
   private static Path dataPath(Path path) {
     return Path.of(path.getParent().toString(), "Rights.rights");
   }