{"blocks":[{"type":"paragraph","data":{"text":"Еще одна структура веб приложений… Которая была выверена «потом и кровью» и имеет достаточный уровень распределения."}},{"type":"header2","data":{"level":2,"text":"Введение"}},{"type":"paragraph","data":{"text":"С каждым годом разработки веб-приложений появляется все больше требований по эргономике, безопасности, архитектуре и прочим моментам. Это связано с быстрыми изменениями в мире, что выражает в нагрузках на проекты и качестве реализаций. Большая часть исследований и внимания со стороны разработчиков и управленцев направлена на архитектуру приложений, их безопасность и прочие фундаментальные вещи, которые прямо проецируются на производительность и удобство веб-приложения как со стороны разработчика, так и со стороны клиента [1]. Но, большая часть разработчиков и управленцев совершенно игнорируют тему организации структуры приложения, которая выражается именно в файловой организации."}},{"type":"paragraph","data":{"text":"Файловая структура — это совокупность файлов на диске и взаимосвязей между ними. Файл — это поименованная область внешней памяти. Файл характеризуется набором параметров: именем, размером, датой создания, датой последней модификации и атрибутами, которые используются операционной системой для его обработки."}},{"type":"paragraph","data":{"text":"Правильная организация файловой структуры веб-приложения позволит не только повысить скорость разработки, но и снизить порог вхождения для новых специалистов. Помимо этих моментов, грамотная организация файловой структуры обеспечивает сокращение времени на поиск нужного файла, который выполняется рекурсивно по иерархии дерева [3]. Такая простая операция достаточно трудоемка и «дорогая» по времени, если нет четкого определения структуры файлов в проекте."}},{"type":"header2","data":{"level":2,"text":"Анализ существующих современных файловых структур веб-приложений"}},{"type":"paragraph","data":{"text":"Проведенный анализ источников показал, что данная тема не столь популярна для исследования, поскольку имеет ряд тонкостей и индивидуальностей, относящиеся к определенным проектам и организациям со своей характеристикой. Большая часть исследований направлена на архитектуру веб-приложения, а не файловую структуру, в следствии чего, было необходимо рассматривать структуры на основе существующих проектов, тематических статей и технологий разработки [2]."}},{"type":"paragraph","data":{"text":"В общей случае, файловую структуру можно разделить на 2 категории: «самописная» и экосреда библиотеки разработки. В случае «самописных» реализаций везде прослеживается несколько базовых принципов: структура MVC (model-view-controller) приложения и структура жесткой привязки к страницам."}},{"type":"paragraph","data":{"text":"Если рассматривать классическую структуру MVC приложения, то структура папок выглядит следующим образом (рис. 1):"}},{"type":"image","data":{"file":{"id":228551,"url":"https://media.tproger.ru/uploads/2022/09/image-autoconverted-5.jpeg"},"alt":"","title":"","caption":"Рисунок 1. Структура папок MVC приложения","stretched":false,"withBackground":false,"withBorder":false,"width":331,"height":430,"optimizedFile":{"original":"https://media.tproger.ru/uploads/2022/09/image-autoconverted-5.jpeg","alt":"YAWAS — Ещё одна структура веб-приложений 1","dimensions":{"width":331,"height":430},"additionalSizes":{"srcSet":[{"url":"https://tproger.ru/signed_image/0gGq1GbWJVMhUlC8ntyywPgCGGVV8m_GHyjB0abS_A4/rs:fill:331:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":331},{"url":"https://tproger.ru/signed_image/wP4gVUVe0kASl_EInPloWzPwQ4Jdno6Bum5MVa52Cmo/rs:fill:662:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":662},{"url":"https://tproger.ru/signed_image/0gGq1GbWJVMhUlC8ntyywPgCGGVV8m_GHyjB0abS_A4/rs:fill:331:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":331},{"url":"https://tproger.ru/signed_image/wP4gVUVe0kASl_EInPloWzPwQ4Jdno6Bum5MVa52Cmo/rs:fill:662:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":662},{"url":"https://tproger.ru/signed_image/0gGq1GbWJVMhUlC8ntyywPgCGGVV8m_GHyjB0abS_A4/rs:fill:331:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":331},{"url":"https://tproger.ru/signed_image/wP4gVUVe0kASl_EInPloWzPwQ4Jdno6Bum5MVa52Cmo/rs:fill:662:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":662},{"url":"https://tproger.ru/signed_image/0gGq1GbWJVMhUlC8ntyywPgCGGVV8m_GHyjB0abS_A4/rs:fill:331:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":331},{"url":"https://tproger.ru/signed_image/wP4gVUVe0kASl_EInPloWzPwQ4Jdno6Bum5MVa52Cmo/rs:fill:662:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS1hdXRvY29udmVydGVkLTUuanBlZw=","dpr":1,"width":662}],"sizes":[{"media":"(min-width: 1441px)","size":"331px"},{"media":"(min-width: 1281px)","size":"331px"},{"media":"(min-width: 1281px)","size":"331px"},{"media":"(min-width: 961px)","size":"331px"},{"media":"(min-width: 671px)","size":"331px"},{"media":"(min-width: 500px)","size":"331px"}]}}}},{"type":"list","data":{"items":["Контроллеры. Здесь хранятся точки входа после запросов, которые выполняют логику приложения.","Модели. Здесь хранятся объекты таблиц базы данных (БД) в представлении, чаще всего, ActiveRecord.","Представления (виды). Здесь хранятся шаблоны и виды страниц."],"style":"ordered"}},{"type":"paragraph","data":{"text":"Основная проблема данной структуры в том, что «из коробки» нет предусмотренного места (папки) для хранения бизнес логики веб-приложения [4]. Для решения этой проблемы прибегают к дополнительным структурам или формируются собственные подходы. Если рассматривать данную структуру с точки зрения взаимодействия (рис. 2) и слоев, то получается, что запросы идут на основной файл приема (единая точка входа), который вызывает (исполняет) нужный контроллер. Контроллер работает с моделями, чтобы работать с данными, а потом отдает сформированные данные в представление, которое записывает в буфер и отправляет ответ на запрос клиенту."}},{"type":"image","data":{"file":{"id":228553,"url":"https://media.tproger.ru/uploads/2022/09/image-24.png"},"alt":"","title":"","caption":"Рисунок 2. Взаимодействие слоев MVC структуры","stretched":false,"withBackground":false,"withBorder":false,"width":562,"height":227,"optimizedFile":{"original":"https://media.tproger.ru/uploads/2022/09/image-24.png","alt":"YAWAS — Ещё одна структура веб-приложений 2","dimensions":{"width":562,"height":227},"additionalSizes":{"srcSet":[{"url":"https://tproger.ru/signed_image/OM_DN5O2VGUFD1au_QKc6REioDcdRgUo_GyWfZvxd-0/rs:fill:562:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":562},{"url":"https://tproger.ru/signed_image/xBXYfGTsof4mfeLERQM-JX_lRaUH87fGJTduD5zfiAk/rs:fill:1124:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":1124},{"url":"https://tproger.ru/signed_image/OM_DN5O2VGUFD1au_QKc6REioDcdRgUo_GyWfZvxd-0/rs:fill:562:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":562},{"url":"https://tproger.ru/signed_image/xBXYfGTsof4mfeLERQM-JX_lRaUH87fGJTduD5zfiAk/rs:fill:1124:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":1124},{"url":"https://tproger.ru/signed_image/OM_DN5O2VGUFD1au_QKc6REioDcdRgUo_GyWfZvxd-0/rs:fill:562:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":562},{"url":"https://tproger.ru/signed_image/xBXYfGTsof4mfeLERQM-JX_lRaUH87fGJTduD5zfiAk/rs:fill:1124:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":1124},{"url":"https://tproger.ru/signed_image/DdR1966T6cuPTsvIigQyTKG8s0q6M6XWwrbeMzF0YkE/rs:fill:466:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":466},{"url":"https://tproger.ru/signed_image/Yf-8mP729ZX8TqfoQs2pq8v7ynqr1W7KuOt3HB4ML3E/rs:fill:932:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VwbG9hZHMvMjAyMi8wOS9pbWFnZS0yNC5wbmc","dpr":1,"width":932}],"sizes":[{"media":"(min-width: 1441px)","size":"562px"},{"media":"(min-width: 1281px)","size":"562px"},{"media":"(min-width: 1281px)","size":"562px"},{"media":"(min-width: 961px)","size":"562px"},{"media":"(min-width: 671px)","size":"562px"},{"media":"(min-width: 500px)","size":"466px"}]}}}},{"type":"paragraph","data":{"text":"Очевидно, что такая структура является хорошей только для простых и небольших приложений, так как в данной структуре присутствует потенциальная возможность «загрязнения» и отсутствие строгого регламента на все возможные случаи [6]."}},{"type":"paragraph","data":{"text":"Второй тип структуры заключается в жесткой привязке к страницам. В основном, такие структуры формируют начинающие разработчики, которые не осведомлены темой шаблонов проектирования и не наделены должным опытом разработки и сопровождения различных проектов. Логика таковой структуры достаточно тривиальна — под каждую страницу выделяется папка с файлами, где располагается логика именно этой страницы [7]."}},{"type":"paragraph","data":{"text":"Несмотря на очевидные недостатки, плюсом данной структуры может быть «псевдомодульность», поскольку для удаления какого-то раздела попросту необходимо удалить папку и подправить ссылки меню. В сравнении с MVC структурой по данному вопросу можно сказать, что так просто удалить раздел не представляется возможным из-за другого принципа логического разнесения файлов."}},{"type":"paragraph","data":{"text":"Все вышесказанные слова крайне различно находят свое отражение в структурах современных веб-приложений, поскольку являются крайне гибкими и незаконченными. Проведя анализ и сформировав вышеуказанные выводы предлагается рассмотреть универсальную структуру веб-приложений, которая способна работать как модульно, так и разрозненно [8]."}},{"type":"header2","data":{"level":2,"text":"Предложение и обоснование структуры веб-приложения"}},{"type":"paragraph","data":{"text":"Предлагаемая структура имеет название YAWAS (Yet Another Web Application Structure) — еще одна структура веб приложений [5]."}},{"type":"header3","data":{"level":3,"text":"Файловая структура"}},{"type":"paragraph","data":{"text":"Файловая структура предназначена для упорядоченного и логичного хранения файлов. Приведенная структура обязательна для соблюдения и корректной работы системы/приложения."}},{"type":"code","data":{"code":"/: корневой каталог\n - /bin: (binaries) бинарные/исполняемые файлы.\n - /configs: конфигурационные файлы\n - /dumps: файлы резервных копий\n - /resources: файлы пользовательских ресурсов (изображения, стили и прочие файлы)\n - /runtime: переменные/изменяемые файлы\n - /log: файлы логов\n - /cache: файлы кэша\n - /src: (source) исходные файлы приложения/системы\n - /tests: файлы тестирования","language":"markup lazy-code"}},{"type":"paragraph","data":{"text":"В каждой папке присутствует свой README файл, который вносит разъяснения по выбранной директории, а также может хранить дополнительную файловую структуру."}},{"type":"header4","data":{"level":4,"text":"1. /bin — (binaries) бинарные/исполняемые файлы"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исполняемые файлы. Здесь расположены программы/скрипты/утилиты, которые можно использовать дополнительно для расширения функционирования системы. Например, здесь может находиться исполняемый файл console, который отвечает за работу с консолью для обеспечения вспомогательных функций, например, создание миграций. Файлы в этой папке вызываются через php FILE аргументы."}},{"type":"header4","data":{"level":4,"text":"2. /configs — конфигурационные файлы"}},{"type":"paragraph","data":{"text":"Этот каталог содержит конфигурационные файлы для приложения/системы. Файлы могут быть различных форматов и структур. Предназначение всех файлов в данном каталоге — настройка и конфигурация приложения/системы."}},{"type":"header4","data":{"level":4,"text":"3. /dumps — файлы резервных копий"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы резервных копий приложения/системы. Файлы могут быть различных форматов и структур."}},{"type":"header4","data":{"level":4,"text":"4. /resources — файлы пользовательских ресурсов (изображения, стили и прочие файлы)"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы пользовательских ресурсов: изображения, стили и прочие файлы. Вложенная структура может быть любой, но реализация основных папок обязательна (media, css и js)."}},{"type":"embed","data":{"link":"https://tproger.ru/news/telegram-popular"}},{"type":"paragraph","data":{"text":"Файловая структура"}},{"type":"code","data":{"code":"/resources: файлы пользовательских ресурсов (изображения, стили и прочие файлы)\n - /media: файлы медиа контента (изображения, иконки, видео и другие)\n - /css: файлы каскадных таблиц стилей\n - /js: файлы пользовательских скриптов JavaScript","language":"markup lazy-code"}},{"type":"header4","data":{"level":4,"text":"4.1. /resources/media — файлы медиа контента (изображения, иконки, видео и другие)"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы медиа контента: изображения, иконки, видео и прочие файлы. Вложенная структура может быть любой."}},{"type":"header4","data":{"level":4,"text":"4.2. /resources/css — файлы каскадных таблиц стилей"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы каскадных таблиц стилей. Вложенная структура может быть любой."}},{"type":"header4","data":{"level":4,"text":"4.3. /resources/js — файлы пользовательских скриптов JavaScript"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы пользовательских скриптов JavaScript. Вложенная структура может быть любой."}},{"type":"header4","data":{"level":4,"text":"5. /runtime — переменные/изменяемые файлы"}},{"type":"paragraph","data":{"text":"Этот каталог содержит часто изменяющиеся файлы с нефиксированным размером. Примерами таким файлов могут служить логи, кеши, базы данных и прочие."}},{"type":"paragraph","data":{"text":"Файловая структура"}},{"type":"code","data":{"code":"/runtime: переменные/изменяемые файлы\n - /log: файлы логов\n - /cache: файлы кэша","language":"markup lazy-code"}},{"type":"header4","data":{"level":4,"text":"5.1. /runtime/log — файлы логов"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы логов работы приложения/системы. Допускается любая вложенность папок, но только, если они отвечают за конкретный модуль/подсистему или иные элементы."}},{"type":"header4","data":{"level":4,"text":"5.2. /runtime/cache — файлы кеша"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы кеша приложения/системы. Допускается любая вложенность папок, но только, если они отвечают за конкретный модуль/подсистему или иные элементы."}},{"type":"header4","data":{"level":4,"text":"6. /src — (source) исходные файлы приложения/системы"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исходные файлы приложения/системы: контроллеры, модели, модули и прочие файлы, которые выполняют логику функционирования самого приложения."}},{"type":"paragraph","data":{"text":"Файловая структура"}},{"type":"code","data":{"code":"/src: (source) исходные файлы приложения/системы\n - /application: слой сервис логики приложения\n - /domain: слой доменной логики (предметной области), чистой бизнес логики без привязки к фреймворку\n - /events: события приложения/системы\n - /infrastructure: слой реализации доменного слоя (репозитории, модели и прочие элементы)\n - /presentation: слой запросов и представления (контроллеры и виды)","language":"markup lazy-code"}},{"type":"header4","data":{"level":4,"text":"6.1. /src/application — слой сервис логики приложения"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исходные файлы слоя реализации логики сервисов приложения. Сервисы должны быть привязаны к предметной области. Именование структуры директории сервисов должно совпадать с сущностями. Сервисы не должны иметь состояния. Структура сервисов может выглядеть следующим образом:"}},{"type":"code","data":{"code":"/src/application - слой сервис логики приложения\n - /services: сервисы бизнес логики\n - /service-name\n - / traits","language":"markup lazy-code"}},{"type":"paragraph","data":{"text":"Папка service-name является самим сервисом и должна называться соответствующим образом с привязкой к предметной области. Для корректного оперирования действиями сервиса лучше выносить действия в отдельные структуры:"}},{"type":"code","data":{"code":"/src/application/services/service-name: конкретный сервис\n - /create\n - ServiceNameCreate.php\n - ServiceNameCreateValidation.php\n - ServiceNameCreateException.php\n - /traits","language":"markup lazy-code"}},{"type":"paragraph","data":{"text":"Для передачи данных из сервиса в репозиторий или иные элементы следует использовать DTO. DTO (data transfer object) — объекты для передачи данных. Структура для DTO объектов в слое сервисной логики приложения может выглядеть следующим образом:"}},{"type":"code","data":{"code":"/src/application/services/service-name: конкретный сервис\n - /create\n - ServiceNameCreate.php\n - ServiceNameCreateValidation.php\n - ServiceNameCreateException.php\n - /dto\n - /traits","language":"markup lazy-code"}},{"type":"paragraph","data":{"text":"DTO должны располагаться в директориях действий, так как они привязаны к конкретным действиям бизнес логики."}},{"type":"header4","data":{"level":4,"text":"6.2. /src/domain — слой доменной логики (предметной области), чистой бизнес логики без привязки к фреймворку"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исходные файлы слоя доменной логики (предметной области), чистой бизнес логики без привязки к фреймворку. В данном слое реализуются сущности, объекты-значения, агрегаты и прочие элементы предметной области. Каждая сущность должна быть вынесена в отдельную директорию, где располагаются все необходимые элементы для ее работы."}},{"type":"paragraph","data":{"text":"Файловая структура"}},{"type":"code","data":{"code":"/src/domain: слой доменной логики (предметной области), чистой бизнес логики без привязки к фреймворку\n - /entity: директория сущности\n - /value-objects: объекты-значения сущности\n - /enums: статичные данные (нумераторы/константы/перечисления) сущности\n - /events: события сущности\n - /exceptions: исключения сущности","language":"markup lazy-code"}},{"type":"paragraph","data":{"text":"Сущность (entity) — это объект из предметной области. Сущность обязательно должна иметь идентификатор."}},{"type":"paragraph","data":{"text":"Объект-значение (value object) — это строительный блок сущности. Объект-значение не имеет идентификатор и обладает стабильным содержимым на все время жизни."}},{"type":"paragraph","data":{"text":"Константы/перечисления/нумераторы (enums) — статичные данные сущности. Данные объекты предназначены для хранения постоянных данных, которыми будет оперировать сущность."}},{"type":"header4","data":{"level":4,"text":"6.3. /src/events — файлы событий приложения/системы"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исходные файлы событий приложения/системы."}},{"type":"header4","data":{"level":4,"text":"6.4. /src/infrastructure — слой реализации доменного слоя (репозитории, модели и прочие элементы)"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исходные файлы слоя реализации доменного слоя (репозитории, модели и прочие элементы). Структура репозиториев должна быть привязана к доменному слою. Примерная структура может выглядеть следующим образом:"}},{"type":"code","data":{"code":"/src: (source) исходные файлы приложения/системы\n - /infrastructure: слой реализации доменного слоя (репозитории, модели и прочие элементы)\n - /repositories: репозитории (конкретная реализация доменного слоя)","language":"markup lazy-code"}},{"type":"paragraph","data":{"text":"Важный аспект методов репозитория — операции либо выполняются «как нужно», либо не выполняются вообще."}},{"type":"header4","data":{"level":4,"text":"6.4.1. /src/infrastructure/repositories — репозитории (конкретная реализация доменного слоя)"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исходные файлы конкретной реализации доменного слоя. Примерная структура для сущности entity может выглядеть следующим образом:"}},{"type":"code","data":{"code":"/src/infrastructure: слой реализации доменного слоя (репозитории, модели и прочие элементы)\n - /repositories: репозитории (конкретная реализация доменного слоя)\n - /entity\n - InMemoryEntityRepository.php\n - SqlEntityRepository.php\n - FileEntityRepository.php","language":"markup lazy-code"}},{"type":"paragraph","data":{"text":"Здесь реализованы 3 вида репозитория: в памяти, sql и файловый."}},{"type":"header4","data":{"level":4,"text":"6.5. /src/presentation — слой запросов и представления (контроллеры и виды)"}},{"type":"paragraph","data":{"text":"Этот каталог содержит исходные файлы слоя реализации запросов и представления (контроллеры и виды). Здесь располагаются точки приема запросов и отдачи ответов (контроллеры), а также виды (views), которые они могут генерировать."}},{"type":"header3","data":{"level":3,"text":"7. /tests — файлы тестирования"}},{"type":"paragraph","data":{"text":"Этот каталог содержит файлы тестирования функционала приложения/системы. Вложенная структура может быть любой в зависимости от используемых технологий."}},{"type":"header2","data":{"level":2,"text":"Заключение"}},{"type":"paragraph","data":{"text":"Проведенный анализ источников показал, что данная тема не столь популярна для исследования, поскольку имеет ряд тонкостей и индивидуальностей, относящиеся к определенным проектам и организациям со своей характеристикой. Существующие подходы файловых структур не имеют строгой типизации и допускают сильные вольности разработчиков, что может негативно отразиться на всем проекте."}},{"type":"paragraph","data":{"text":"Предложенная файловая структура YAWAS при строгом ее соблюдении предусматривает большую часть возможного функционала. Особенно важно отметить, что в в папке src ((source) исходные файлы приложения/системы) представлена структура для одного приложения. Если в проекте предусматривается множество приложений, то упомянутая структура оборачивается в соответствующие каталоги. Также предусматривается и другой вариант, который с одной стороны более модульный, но с другой стороны он имеет уровень избыточности и дублирования. При таком положении каждый руководитель проекта должен решить, по какому пути его команде идти."}},{"type":"paragraph","data":{"text":"Как было сказано ранее, здесь может быть несколько вариантов:"}},{"type":"list","data":{"items":["Добавлять вложенные папки в структуру, чтобы получать примерно так: src/presentation/controllers/admin","Разбить все «подсистемы» на папки, чтобы в src была примерно такая структура: src/admin-application и src/client-application. В таком случае, каждая папка (*-application) должна повторить текущую структуру папки src. Это дополнительно позволит добавить «глобальный» класс управления «подсистемой»: src/admin-application/AdminBundle.php."],"style":"ordered"}},{"type":"paragraph","data":{"text":"Таким образом, предлагаемая система учитывает большую часть вопросов по организации файлов и каталогов проекта с достаточным уровнем документирования."}},{"type":"header2","data":{"level":2,"text":"Список источников"}},{"type":"list","data":{"items":["Организация структуры приложения | Node.js с примерами кода. Date Views 23.05.2022 nodejsdev.ru/.","БЭМ | Организация файловой структуры. Date Views 21.05.2022 github.com/bem-site/bem-method/blob/bem-info-data/method/filestructure/filestructure.ru.md.","Файловая структура проекта. Node Hero: Глава 7 | by Andrey Melikhov | devSchacht | Medium. Date Views 19.05.2022 medium.com/devschacht/node-hero-chapter-7-4078fa61ece6.","Файловая структура приложения — Мегаобучалка. Date Views 22.05.2022 megaobuchalka.ru/16/42070.html.","mepihindeveloper/yawas: YAWAS (yet another web application structure) — структура директорий веб приложения. Date Views 24.05.2022 github.com/mepihindeveloper/yawas.","Попков, И. В. БЭМ. Компонентный подход к веб-разработке / И. В. Попков, Л. В. Курзаева // Международный студенческий научный вестник. — 2018. — № 5. — С. 165. — EDN XZPCTJ.","Макаренко, С. И. Принципы построения и функционирования аппаратно-программных средств телекоммуникационных систем / С. И. Макаренко, А. А. Ковальский, С. А. Краснов. — Санкт-Петербург : Издательство «Наукоемкие технологии», 2020. — 357 с. — ISBN 978-5-6044429-8-2. — EDN DOWPGX.","Крюков, В. В. Типовые организационные и технологические решения для создания региональной информационной среды вуза и филиалов / В. В. Крюков, К. И. Шахгельдян // Открытое образование. — 2004. — № 5. — С. 38-52. — EDN UQIHMV."],"style":"ordered"}}]}

Ошибка в настройках сайта