Расположение, организация и именование файлов пространств имен
Материал из GedeminWiki
Рекомендуется придерживаться следующих правил при создании новых пространств имен:
- Пространства имен, принадлежащие одному решению, располагаются в одной папке. Например, Гостиница, Склад, Бухгалтерия и т.п.
- Если некоторое решение базируется на более общем решении, то его папка располагается внутри папки общего решения. Например, папка Розничная торговля внутри папки Торговля.
- Объекты решения должны быть сгруппированы по морфологическим признакам и расположены в отдельных пространствах имен. Например, домены, таблицы, методы, отчеты. Для большого решения объекты могут быть сгруппированы по функциональным, а затем по морфологическим признакам. Например, Приемка товара.Домены, Приемка товара.Таблицы, Отпуск товара.Домены, Отпуск товара.Таблицы, Отпуск товара.Отчеты и т.п.
- Если некоторый объект используется более чем в одном решении, то его следует выделить в отдельный файл (файлы). Не следует располагать в одном файле объекты, которые используются в нескольких разных решениях и объекты которые используются только в одном решении.
- Имя пространства имен формируется следующим образом: Префикс компании.Решение[.Под решение...].Функция[.Подфункция...].Тип объекта[.Подтип...][.Объект].yml
- Внутри папки должен находиться минимум один пакет. Пакет, имя которого совпадает с именем решения, является основным для установки решения в пакетном режиме. Дополнительно, в отдельные пакеты могут быть оформлены опциональные части решения.
Примеры:
Папка Торговля GS.Торговля.yml -- пакет для установки решения ... GS.Торговля.Валютная торговля.Домены.yml GS.Торговля.Валютная торговля.Документ переоценки.Таблицы.USR_TRADE_PEREOC.yml GS.Торговля.Валютная торговля.Документ переоценки.Макросы.yml ... Папка Торговля/Розничная торговля ... GS.Торговля.Розница.yml -- пакет для установки решения. Зависит от пакета Торговля. GS.Торговля.Розница.Отпуск на кассу.Макросы.yml ...