Merge pull request #3 from moevm/app_description

Первичное описание приложения, его общей структуры и основных функций

Author: baldchort

app_description/readme.md

@@ -0,0 +1,19 @@
+# Тема 13 - Сервис для организации субботников
+**Задача** - сделать сервис, где можно как самому организовать субботник, так и присоединится к чужому субботнику. В сервисе должны быть помимо стандартных страниц (Профили пользователей, поиск, комментарии, отзывы) также и страницы с персональной и общей статистикой (кто и где участвовал, сколько кв км убрали …).
+
+**Предполагаемый стек**: Python, ArangoDb, React.
+
+## Видение того, как устроено приложение ##
+![image](https://github.com/user-attachments/assets/21493523-f657-48b3-b18b-af618c4a21db)
+
+#### Бэкенд: ####
+Слой контроллеров - обрабатывает HTTP-запросы, валидирует данные, вызывает соответствующие сервисы и возвращает HTTP-ответы;
+Слой сервисов - инкапсулирует бизнес-логику приложения, выполняет операции с данными вызывает методы репозитория для работы с БД;
+Слой репозиториев - инкапсулирует взаимодействие с БД, осуществляет SQL-запросы.
+
+##### Пример обработки запроса GET /users/:id: #####
+1. Контроллер получает id из запроса и передаёт в сервис.
+2. Сервис вызывает метод репозитория.
+3. Репозиторий делает SQL-запрос и возвращает данные.
+4. Сервис может дополнительно обработать данные перед отправкой в контроллер.
+5. Контроллер отправляет ответ клиенту.