https://github.com/xastt/skillswap

Микросервисное веб-приложение поиска навыков "SkillSwap"
https://github.com/xastt/skillswap

docker flyway-migrations kafka spring spring-security

Last synced: 2 months ago
JSON representation

Микросервисное веб-приложение поиска навыков "SkillSwap"

• Host: GitHub
• URL: https://github.com/xastt/skillswap
• Owner: Xastt
• Created: 2025-02-07T08:48:01.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-19T09:00:28.000Z (over 1 year ago)
• Last Synced: 2025-04-02T10:18:08.133Z (about 1 year ago)
• Topics: docker, flyway-migrations, kafka, spring, spring-security
• Language: Java
• Homepage:
• Size: 3.41 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# SkillSwap v3.0

***Работа проекта:***

- Веб-приложение SkillSwap предоставляет пользователям уникальную возможность находить или размещать навыки,

  по которым они хотят получить или провести урок. 

- **v2.0**: Архитектура системы построена на основе двух микросервисов. Первый отвечает за реализацию ключевых 

функций приложения, а второй обеспечивает рассылку уведомлений по электронной почте. Пользователи получают 

приветственное письмо после регистрации, а также оповещения, если кто-то заинтересовался их предложением. 

Взаимодействие между микросервисами осуществляется через брокер сообщений Kafka.

- Доступ к платформе предоставляется только после прохождения первичной регистрации, включающей стандартную 

аутентификацию и ввод личных данных. После этого пользователь может либо найти нужный навык, либо предложить 

свой. В целях безопасности каждый пользователь имеет право изменять только свои персональные данные. Для 

реализации этого функционала используется Spring Security: система сравнивает данные аутентифицированного 

пользователя из контекста с данными на платформе. Если они совпадают, доступ разрешен; в противном случае пользователь 

перенаправляется на страницу с предупреждением.

  

- Для удобства пользователей на платформе реализован поиск по названию навыка. Также предусмотрена возможность 

редактирования предлагаемых услуг (цены, описания) и личных данных. 

-  **v3.0**: Если пользователь выбирает навык и желает связаться с его обладателем, платформа предоставляет 

контактные данные и открывает транзакцию со статусом IN_PROCESS. В зависимости от итогового статуса сделки 

(CANCELED или COMPLETED), пользователю предлагается оставить отзыв и оценить наставника. Рейтинг преподавателя 

формируется на основе всех полученных оценок, что помогает другим пользователям выбирать качественные услуги. 

Чтобы предотвратить накрутку рейтинга, система проверяет, что сделка заключается между разными пользователями. 

В случае попытки обмана система перенаправляет на страницу с предупреждением.

 - **Обработка ошибок**: Все действия в приложении логируются. В случае возникновения ошибки, она передается 

на уровень контроллера, где обрабатывается, а пользователь видит страницу с предложением повторить попытку.

---

В начале работы над проектом были составлены следующие UML-диаграммы:

- Диаграмма вариантов использования

  ![фото](SkillSwap/img/UseCaseDiagram.png)

- Диаграмма классов

  ![фото](SkillSwap/img/ClassDiagram.png)

- Диаграмма базы данных

  ![фото](SkillSwap/img/ERDDiagram.png)

- Диаграмма последовательности

  ![фото](SkillSwap/img/SequenceDiagram.png)

---

### Использованные технологии:

1. Java 

2. Spring

3. Spring Boot 

4. Spring Security 

5. Spring Validator

6. Spring Data

7. Spring Mail

8. Kafka

9. Docker

10. Hibernate

11. PostgreSQL

12. Flyway

13. HTML, CSS, Thymeleaf

14. Maven

15. Slf4j

16. Flyway

---

### Интерфейс приложения:

1. В начале пользователей встречает приветственная страница и просит пройти регистрацию.

   

    ![фото](SkillSwap/img/welcomePage.png)

- Регистрация

  ![фото](SkillSwap/img/RegistrationForm.png)

- Вход в систему + демонстрация валидации

  ![фото](SkillSwap/img/LogInForm.png)

- Ввод личных данных

  ![фото](SkillSwap/img/newPers.png)

- Валидация личных данных

  ![фото](SkillSwap/img/PersInfDataValidation.png)

- Приветственное письмо

  ![фото](SkillSwap/img/HelloMsg.png)

2. После прохождения регистрации и аутентификации пользователь имеет полный

доступ к платформе и ее содержимому.

- Пользователи приложения

  ![фото](SkillSwap/img/persInfIndex.png)

- Просмотр чужих личных данных

  ![фото](SkillSwap/img/AccessToSomethingElseData.png)

- Просмотр своих личных данных

  ![фото](SkillSwap/img/PersonShow.png)

- Изменение личных данных

  ![фото](SkillSwap/img/PersonEdit.png)

- Страница с навыками

  ![фото](SkillSwap/img/profInfIndex.png)

- Добавление профессиональных данных(для преподавателей)

  ![фото](SkillSwap/img/newSkill.png)

- Изменение профессиональных данных(для преподавателей)

  ![фото](SkillSwap/img/EditProfInf.png)

3. Далее пользователь может найти нужный навык, связаться с преподавателем

и в случае успеха оставить ему отзыв.

- Поиск навыка

  ![фото](SkillSwap/img/FindSkill.png)

- Просмотр данных навыка

  ![фото](SkillSwap/img/SkillShowExchange.png)

- Страница личных контактов

  ![фото](SkillSwap/img/skillExchangeYesNo.png)

- Письмо с оповещением о заинтересованности в предоставляемом навыке

  ![фото](SkillSwap/img/IntrestedSkill.png)

- Попытка сделать сделку самому с собой

  ![фото](SkillSwap/img/GetContactsWithYourSelf.png)

- Случай, если сделка не состоялась

  ![фото](SkillSwap/img/skillExchangeNo.png)

- Случай, если сделка состоялась

  ![фото](SkillSwap/img/Review.png)

- Страница после отправки отзыва

  ![фото](SkillSwap/img/ReviewSubmitRes.png)

4. Обработка ошибок

- Страница, появляющаяся при возникновении ошибки

  ![фото](SkillSwap/img/ExceptionHandling.png)