From cb1b0840e586e928833c37130ab4a747a0d5de6e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=9A=D0=B0?=
 =?UTF-8?q?=D0=BD?= <dmitry.kan@yandex.ru>
Date: Wed, 2 Jul 2025 15:48:05 +0300
Subject: [PATCH 1/6] =?UTF-8?q?fix:=D0=92=D0=BD=D0=B5=D1=81=D1=82=D0=B8=20?=
 =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20=D0=B2=20ER-=D0=B4=D0=B8?=
 =?UTF-8?q?=D0=B0=D0=B3=D1=80=D0=B0=D0=BC=D0=BC=D1=83=20=D0=BF=D0=BE=20?=
 =?UTF-8?q?=D0=B8=D1=82=D0=BE=D0=B3=D0=B0=D0=BC=20p2p=20=D1=80=D0=B5=D0=B2?=
 =?UTF-8?q?=D1=8C=D1=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md             |  70 ++++++++++++++++++++++++++++++++++++++++--
 filmorate_diagram.png | Bin 0 -> 64445 bytes
 2 files changed, 68 insertions(+), 2 deletions(-)
 create mode 100644 filmorate_diagram.png

diff --git a/README.md b/README.md
index 2cf454a..92a58b3 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,68 @@
-# java-filmorate
-Template repository for Filmorate project.
+# Filmorate
+Учебный проект с курса "Java-разработчик" от Яндекс Практикума.
+Проект является backend-сервисом для получения топа фильмов, рекомендованных к просмотру на основе пользовательских оценок. </br>
+**Стек: Java 21, Spring Boot, Apache Maven, REST, Postman, Lombok, JUnit 5**
+
+### Содержание
+- [Этапы работы над проектом](#этапы-работы-над-проектом)
+- [ER-диаграмма](#er-диаграмма)
+- [Примеры запросов к базе данных](#примеры-запросов-к-базе-данных)
+
+## Текущий этап работы над проектом:
+Спринт 12:
+- Проектирование будущей базы данных;
+- Создание ER-диаграммы базы данных.
+
+## Этапы работы над проектом
+1. Спринт 10:
+    - Создание каркаса приложения с использользованием Spring Boot;
+    - Вся логика и хранение данных находятся в контроллерах;
+    - Разработан базовый функционал: добавление, обновление и получение всех фильмов/пользователей;
+    - Написаны unit-тесты для текущего функционала.
+2. Спринт 11:
+    - Добавлены классы-хранилища для работы с данными о фильмах и пользователях;
+    - Добавлен новый функционал, позволяющий добавлять друзей и ставить лайки фильмам;
+    - Добавлены аннотации @service и @component для внедрения зависимостей;
+    - В классы контроллеры добавлена аннотация @ResponseStatus для указания HTTP-статуса ответа, который должен вернуться при обработке запроса;
+    - Добавлены классы ErrorHandler и ErrorResponse для централизованной обработки ошибок;
+    - Добавлены unit-тесты для нового функционала.
+
+## ER-диаграмма
+![Схема](filmorate_diagram.png)
+
+## Примеры запросов к базе данных
+
+1. Получить всех пользователей, кто родился не раньше 1995 года
+```sql
+SELECT *
+FROM users AS u
+WHERE EXTRACT(YEAR
+              FROM birthday) >= 1995
+ORDER BY birthday
+```
+2. Получить фильмы, у которых не меньше двух лайков
+```sql
+SELECT f.film_id,
+       f.name AS film_name,
+       f.description,
+       f.release_date,
+       COUNT(l.user_id) AS likes_count
+FROM films AS f
+LEFT JOIN likes l ON f.film_id = l.film_id
+GROUP BY f.film_id,
+         f.name,
+         f.description,
+         f.release_date
+HAVING COUNT(l.user_id) >= 2
+ORDER BY likes_count DESC;
+```
+
+3. Получить пользователей, у которых яндекс почта
+```sql
+SELECT u.user_id,
+       u.email,
+       u.login,
+       u.name
+FROM users AS u
+WHERE email LIKE '%yandex%'
+```
\ No newline at end of file
diff --git a/filmorate_diagram.png b/filmorate_diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..d42f70d3becce12db5912348b9bd359d7dea36af
GIT binary patch
literal 64445
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

literal 0
HcmV?d00001


From cce36a771f081cc360c1ae4ca86d2bf96e9f62db Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=9A=D0=B0?=
 =?UTF-8?q?=D0=BD?= <dmitry.kan@yandex.ru>
Date: Tue, 15 Jul 2025 18:43:24 +0300
Subject: [PATCH 2/6] =?UTF-8?q?feat:=20=D0=92=D1=8B=D0=BF=D0=BE=D0=BB?=
 =?UTF-8?q?=D0=BD=D0=B8=D1=82=D1=8C=20=D0=A4=D0=97-12.=20=D0=98=D0=B7?=
 =?UTF-8?q?=D0=BC=D0=B5=D0=BD=D0=B8=D1=82=D1=8C=20=D0=B0=D1=80=D1=85=D0=B8?=
 =?UTF-8?q?=D1=82=D0=B5=D0=BA=D1=82=D1=83=D1=80=D1=83=20=D0=BF=D1=80=D0=BE?=
 =?UTF-8?q?=D0=B5=D0=BA=D1=82=D0=B0=20=D0=B4=D0=BB=D1=8F=20=D1=80=D0=B0?=
 =?UTF-8?q?=D0=B1=D0=BE=D1=82=D1=8B=20=D1=81=20=D0=91=D0=94.=20=D0=94?=
 =?UTF-8?q?=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82=D1=8C=20=D0=B8=D0=BD=D1=82?=
 =?UTF-8?q?=D0=B5=D0=B3=D1=80=D0=B0=D1=86=D0=B8=D0=BE=D0=BD=D0=BD=D1=8B?=
 =?UTF-8?q?=D0=B5=20=D1=82=D0=B5=D1=81=D1=82=D1=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                     |  26 +-
 filmorate_diagram.png                         | Bin 64445 -> 65560 bytes
 pom.xml                                       | 114 ++++---
 .../filmorate/controller/FilmController.java  |  26 +-
 .../filmorate/controller/GenreController.java |  33 ++
 .../filmorate/controller/MpaController.java   |  33 ++
 .../filmorate/controller/UserController.java  |  28 +-
 .../filmorate/dal/BaseDbStorage.java          |  64 ++++
 .../filmorate/dal/FilmDbStorage.java          | 158 +++++++++
 .../filmorate/dal/FriendshipDbStorage.java    |  66 ++++
 .../filmorate/dal/GenreDbStorage.java         |  68 ++++
 .../filmorate/dal/LikesDbStorage.java         |  41 +++
 .../practicum/filmorate/dal/MpaDbStorage.java |  44 +++
 .../filmorate/dal/UserDbStorage.java          | 100 ++++++
 .../filmorate/dal/mappers/FilmRowMapper.java  |  35 ++
 .../dal/mappers/FriendshipRowMapper.java      |  20 ++
 .../filmorate/dal/mappers/GenreRowMapper.java |  20 ++
 .../filmorate/dal/mappers/LikesRowMapper.java |  20 ++
 .../filmorate/dal/mappers/MpaRowMapper.java   |  20 ++
 .../filmorate/dal/mappers/UserRowMapper.java  |  27 ++
 .../practicum/filmorate/dto/FilmDto.java      |  24 ++
 .../filmorate/dto/NewFilmRequest.java         |  21 ++
 .../filmorate/dto/NewUserRequest.java         |  18 +
 .../filmorate/dto/UpdateFilmRequest.java      |  24 ++
 .../filmorate/dto/UpdateUserRequest.java      |  22 ++
 .../practicum/filmorate/dto/UserDto.java      |  24 ++
 .../exception/InternalServerException.java    |   8 +
 .../filmorate/mapper/FilmMapper.java          |  93 +++++
 .../filmorate/mapper/UserMapper.java          |  67 ++++
 .../practicum/filmorate/model/Film.java       |   8 +-
 .../practicum/filmorate/model/Friendship.java |  10 +
 .../practicum/filmorate/model/Genre.java      |  12 +
 .../practicum/filmorate/model/Likes.java      |   9 +
 .../yandex/practicum/filmorate/model/Mpa.java |  12 +
 .../practicum/filmorate/model/User.java       |   6 +-
 .../filmorate/service/FilmService.java        | 150 +++++---
 .../filmorate/service/GenreService.java       |  30 ++
 .../filmorate/service/MpaService.java         |  30 ++
 .../filmorate/service/UserService.java        | 173 +++++-----
 .../storage/{film => }/FilmStorage.java       |   9 +-
 .../filmorate/storage/FriendshipStorage.java  |  16 +
 .../filmorate/storage/GenreStorage.java       |  17 +
 .../filmorate/storage/LikesStorage.java       |  14 +
 .../filmorate/storage/MpaStorage.java         |  15 +
 .../storage/{user => }/UserStorage.java       |   7 +-
 .../filmorate/utils/FilmValidate.java         |   5 +
 .../filmorate/utils/UserValidate.java         |   5 +
 src/main/resources/application.properties     |   7 +-
 src/main/resources/data.sql                   |  16 +
 src/main/resources/schema.sql                 |  51 +++
 .../filmorate/FilmorateApplicationTests.java  |   4 +-
 .../filmorate/dal/FilmDbStorageTest.java      | 224 ++++++++++++
 .../dal/FriendshipDbStorageTest.java          |  86 +++++
 .../filmorate/dal/GenreDbStorageTest.java     |  87 +++++
 .../filmorate/dal/LikesDbStorageTest.java     |  79 +++++
 .../filmorate/dal/MpaDbStorageTest.java       |  67 ++++
 .../filmorate/dal/UserDbStorageTest.java      | 129 +++++++
 .../FilmServiceTest.java}                     | 320 +++++++++++++-----
 .../UserServiceTest.java}                     | 276 ++++++++-------
 .../filmorate/storage/FilmTestStorage.java}   |  37 +-
 .../storage/FriendshipTestStorage.java        |  68 ++++
 .../filmorate/storage/GenreTestStorage.java   |  60 ++++
 .../filmorate/storage/LikesTestStorage.java   |  44 +++
 .../filmorate/storage/MpaTestStorage.java     |  54 +++
 .../filmorate/storage/UserTestStorage.java}   |  18 +-
 65 files changed, 2944 insertions(+), 455 deletions(-)
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/controller/GenreController.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/controller/MpaController.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/FilmDbStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/LikesDbStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/MpaDbStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FilmRowMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FriendshipRowMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/mappers/GenreRowMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/mappers/LikesRowMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/mappers/MpaRowMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dal/mappers/UserRowMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dto/FilmDto.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dto/NewFilmRequest.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dto/NewUserRequest.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dto/UpdateFilmRequest.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dto/UpdateUserRequest.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/dto/UserDto.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/exception/InternalServerException.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/mapper/FilmMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/mapper/UserMapper.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/model/Friendship.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/model/Genre.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/model/Likes.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/model/Mpa.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/service/GenreService.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/service/MpaService.java
 rename src/main/java/ru/yandex/practicum/filmorate/storage/{film => }/FilmStorage.java (51%)
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/storage/FriendshipStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/storage/GenreStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/storage/LikesStorage.java
 create mode 100644 src/main/java/ru/yandex/practicum/filmorate/storage/MpaStorage.java
 rename src/main/java/ru/yandex/practicum/filmorate/storage/{user => }/UserStorage.java (58%)
 create mode 100644 src/main/resources/data.sql
 create mode 100644 src/main/resources/schema.sql
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/dal/FilmDbStorageTest.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorageTest.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/dal/GenreDbStorageTest.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/dal/LikesDbStorageTest.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/dal/MpaDbStorageTest.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/dal/UserDbStorageTest.java
 rename src/test/java/ru/yandex/practicum/filmorate/{controller/FilmControllerTest.java => service/FilmServiceTest.java} (62%)
 rename src/test/java/ru/yandex/practicum/filmorate/{controller/UserControllerTest.java => service/UserServiceTest.java} (61%)
 rename src/{main/java/ru/yandex/practicum/filmorate/storage/film/InMemoryFilmStorage.java => test/java/ru/yandex/practicum/filmorate/storage/FilmTestStorage.java} (72%)
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/storage/FriendshipTestStorage.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/storage/GenreTestStorage.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/storage/LikesTestStorage.java
 create mode 100644 src/test/java/ru/yandex/practicum/filmorate/storage/MpaTestStorage.java
 rename src/{main/java/ru/yandex/practicum/filmorate/storage/user/InMemoryUserStorage.java => test/java/ru/yandex/practicum/filmorate/storage/UserTestStorage.java} (87%)

diff --git a/README.md b/README.md
index 92a58b3..493a848 100644
--- a/README.md
+++ b/README.md
@@ -10,8 +10,13 @@
 
 ## Текущий этап работы над проектом:
 Спринт 12:
-- Проектирование будущей базы данных;
-- Создание ER-диаграммы базы данных.
+- Переработана архитектура проекта;
+- Добавлены новые модели: MPA-рейтинг, Genre, Likes, Friendship;
+- Добавлен слой DAL для работы с данными из базы данных;
+- Добавлен маппинг для преобразования записей из базы данных в объекты и обратно;
+- Написаны интеграционные тесты;
+- Добавлены тестовые хранилища для unit-тестов;
+- Переработаны unit-тесты для граничных условий с учетом новой архитектуры проекта;
 
 ## Этапы работы над проектом
 1. Спринт 10:
@@ -26,6 +31,9 @@
     - В классы контроллеры добавлена аннотация @ResponseStatus для указания HTTP-статуса ответа, который должен вернуться при обработке запроса;
     - Добавлены классы ErrorHandler и ErrorResponse для централизованной обработки ошибок;
     - Добавлены unit-тесты для нового функционала.
+3. Спринт 12. Промежуточное задание:
+   - Спроектирована будущая база данных;
+   - Создана ER-диаграмма базы данных.
 
 ## ER-диаграмма
 ![Схема](filmorate_diagram.png)
@@ -34,7 +42,7 @@
 
 1. Получить всех пользователей, кто родился не раньше 1995 года
 ```sql
-SELECT *
+SELECT u.user_id, u.email, u.login, u.name, u.birthday
 FROM users AS u
 WHERE EXTRACT(YEAR
               FROM birthday) >= 1995
@@ -43,16 +51,15 @@ ORDER BY birthday
 2. Получить фильмы, у которых не меньше двух лайков
 ```sql
 SELECT f.film_id,
-       f.name AS film_name,
+       f.name AS title,
        f.description,
        f.release_date,
+       m.name AS mpa_rating,
        COUNT(l.user_id) AS likes_count
 FROM films AS f
 LEFT JOIN likes l ON f.film_id = l.film_id
-GROUP BY f.film_id,
-         f.name,
-         f.description,
-         f.release_date
+JOIN mpa_rating AS m ON f.rating_id = m.rating_id
+GROUP BY f.film_id, m.name
 HAVING COUNT(l.user_id) >= 2
 ORDER BY likes_count DESC;
 ```
@@ -64,5 +71,6 @@ SELECT u.user_id,
        u.login,
        u.name
 FROM users AS u
-WHERE email LIKE '%yandex%'
+WHERE email LIKE '%yandex%' OR email LIKE '%@ya.ru%'
+ORDER BY user_id
 ```
\ No newline at end of file
diff --git a/filmorate_diagram.png b/filmorate_diagram.png
index d42f70d3becce12db5912348b9bd359d7dea36af..68b563dedb7075ea8042e3de014c81ad8b266564 100644
GIT binary patch
literal 65560
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
O`4Q`Ivf{XR%-;Yu>lm~E

literal 64445
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

diff --git a/pom.xml b/pom.xml
index 9c95881..f1eb76c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1,59 +1,63 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-	<modelVersion>4.0.0</modelVersion>
-	<parent>
-		<groupId>org.springframework.boot</groupId>
-		<artifactId>spring-boot-starter-parent</artifactId>
-		<version>3.2.4</version>
-		<relativePath/> <!-- lookup parent from repository -->
-	</parent>
-	<groupId>ru.yandex.practicum</groupId>
-	<artifactId>filmorate</artifactId>
-	<version>0.0.1-SNAPSHOT</version>
-	<name>filmorate</name>
-	<description>filmorate</description>
-	<properties>
-		<java.version>21</java.version>
-	</properties>
-	<dependencies>
-		<dependency>
-			<groupId>org.springframework.boot</groupId>
-			<artifactId>spring-boot-starter-web</artifactId>
-		</dependency>
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.2.4</version>
+        <relativePath/> <!-- lookup parent from repository -->
+    </parent>
+    <groupId>ru.yandex.practicum</groupId>
+    <artifactId>filmorate</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>filmorate</name>
+    <description>filmorate</description>
+    <properties>
+        <java.version>21</java.version>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.zalando</groupId>
+            <artifactId>logbook-spring-boot-starter</artifactId>
+            <version>3.7.2</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jdbc</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+    </dependencies>
 
-		<dependency>
-			<groupId>org.projectlombok</groupId>
-			<artifactId>lombok</artifactId>
-			<scope>provided</scope>
-		</dependency>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
 
-		<dependency>
-			<groupId>org.springframework.boot</groupId>
-			<artifactId>spring-boot-starter-test</artifactId>
-			<scope>test</scope>
-		</dependency>
-
-		<dependency>
-			<groupId>org.springframework.boot</groupId>
-			<artifactId>spring-boot-starter-validation</artifactId>
-		</dependency>
-
-		<dependency>
-			<groupId>org.zalando</groupId>
-			<artifactId>logbook-spring-boot-starter</artifactId>
-			<version>3.7.2</version>
-		</dependency>
-
-	</dependencies>
-
-	<build>
-		<plugins>
-			<plugin>
-				<groupId>org.springframework.boot</groupId>
-				<artifactId>spring-boot-maven-plugin</artifactId>
-			</plugin>
-		</plugins>
-	</build>
-
-</project>
+</project>
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/controller/FilmController.java b/src/main/java/ru/yandex/practicum/filmorate/controller/FilmController.java
index 7829e10..f47eae7 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/controller/FilmController.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/controller/FilmController.java
@@ -4,7 +4,9 @@
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.HttpStatus;
 import org.springframework.web.bind.annotation.*;
-import ru.yandex.practicum.filmorate.model.Film;
+import ru.yandex.practicum.filmorate.dto.FilmDto;
+import ru.yandex.practicum.filmorate.dto.NewFilmRequest;
+import ru.yandex.practicum.filmorate.dto.UpdateFilmRequest;
 import ru.yandex.practicum.filmorate.service.FilmService;
 
 import java.util.Collection;
@@ -18,22 +20,22 @@ public class FilmController {
     private final FilmService filmService;
 
     @GetMapping
-    public Collection<Film> findAll() {
+    public Collection<FilmDto> findAll() {
         log.info("Получен запрос на получение списка всех фильмов");
         return filmService.findAll();
     }
 
     @PostMapping
     @ResponseStatus(HttpStatus.CREATED)
-    public Film create(@RequestBody Film newFilm) {
-        log.info("Получен запрос на добавление фильма {}", newFilm.getName());
-        return filmService.create(newFilm);
+    public FilmDto create(@RequestBody NewFilmRequest newFilmRequest) {
+        log.info("Получен запрос на добавление фильма {}", newFilmRequest.getName());
+        return filmService.create(newFilmRequest);
     }
 
     @PutMapping
-    public Film update(@RequestBody Film film) {
-        log.info("Получен запрос на обновление фильма c Id:{}", film.getId());
-        return filmService.update(film);
+    public FilmDto update(@RequestBody UpdateFilmRequest filmRequest) {
+        log.info("Получен запрос на обновление фильма c Id:{}", filmRequest.getId());
+        return filmService.update(filmRequest);
     }
 
     @DeleteMapping("/{id}")
@@ -44,9 +46,9 @@ public void delete(@PathVariable("id") Long filmId) {
     }
 
     @GetMapping("/{id}")
-    public Film getById(@PathVariable("id") Long filmId) {
+    public FilmDto getById(@PathVariable("id") Long filmId) {
         log.info("Получен запрос на получение фильма с Id:{}", filmId);
-        return filmService.getById(filmId);
+        return filmService.findById(filmId);
     }
 
     @PutMapping("/{id}/like/{userId}")
@@ -64,9 +66,9 @@ public void removeLike(@PathVariable("id") Long filmId, @PathVariable("userId")
     }
 
     @GetMapping("/popular")
-    public Collection<Film> getPopularFilms(
+    public Collection<FilmDto> getPopularFilms(
             @RequestParam(defaultValue = "10") int count) {
         log.info("Получен запрос на получение топ-{} фильмов по количеству лайков", count);
-        return filmService.getPopularFilms(count);
+        return filmService.findPopularFilms(count);
     }
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/controller/GenreController.java b/src/main/java/ru/yandex/practicum/filmorate/controller/GenreController.java
new file mode 100644
index 0000000..c024332
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/controller/GenreController.java
@@ -0,0 +1,33 @@
+package ru.yandex.practicum.filmorate.controller;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import ru.yandex.practicum.filmorate.model.Genre;
+import ru.yandex.practicum.filmorate.service.GenreService;
+
+import java.util.Collection;
+
+@Slf4j
+@RestController
+@RequestMapping("/genres")
+@RequiredArgsConstructor
+public class GenreController {
+
+    private final GenreService genreService;
+
+    @GetMapping
+    public Collection<Genre> findAll() {
+        log.info("Получен запрос на получение всех пользователей");
+        return genreService.findAll();
+    }
+
+    @GetMapping("/{id}")
+    public Genre findById(@PathVariable("id") Long genreId) {
+        log.info("Получен запрос на получение жанра с id:{}", genreId);
+        return genreService.findById(genreId);
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/controller/MpaController.java b/src/main/java/ru/yandex/practicum/filmorate/controller/MpaController.java
new file mode 100644
index 0000000..4f148c0
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/controller/MpaController.java
@@ -0,0 +1,33 @@
+package ru.yandex.practicum.filmorate.controller;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import ru.yandex.practicum.filmorate.model.Mpa;
+import ru.yandex.practicum.filmorate.service.MpaService;
+
+import java.util.Collection;
+
+@Slf4j
+@RestController
+@RequestMapping("/mpa")
+@RequiredArgsConstructor
+public class MpaController {
+
+    private final MpaService mpaService;
+
+    @GetMapping
+    public Collection<Mpa> findAll() {
+        log.info("Получен запрос на получение всех MPA-рейтингов");
+        return mpaService.findAll();
+    }
+
+    @GetMapping("/{id}")
+    public Mpa findById(@PathVariable("id") Long ratingId) {
+        log.info("Получен запрос на получение MPA-рейтинга с id:{}", ratingId);
+        return mpaService.findById(ratingId);
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java b/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java
index e0f3ebe..2dac69f 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java
@@ -4,6 +4,10 @@
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.HttpStatus;
 import org.springframework.web.bind.annotation.*;
+import ru.yandex.practicum.filmorate.dto.NewUserRequest;
+import ru.yandex.practicum.filmorate.dto.UpdateFilmRequest;
+import ru.yandex.practicum.filmorate.dto.UpdateUserRequest;
+import ru.yandex.practicum.filmorate.dto.UserDto;
 import ru.yandex.practicum.filmorate.model.User;
 import ru.yandex.practicum.filmorate.service.UserService;
 
@@ -18,22 +22,22 @@ public class UserController {
     private final UserService userService;
 
     @GetMapping
-    public Collection<User> findAll() {
+    public Collection<UserDto> findAll() {
         log.info("Получен запрос на получение всех пользователей");
         return userService.findAll();
     }
 
     @PostMapping
     @ResponseStatus(HttpStatus.CREATED)
-    public User create(@RequestBody User newUser) {
-        log.info("Получен запрос на добавление нового пользователя {}", newUser.getLogin());
-        return userService.create(newUser);
+    public UserDto create(@RequestBody NewUserRequest newUserRequest) {
+        log.info("Получен запрос на добавление нового пользователя {}", newUserRequest.getLogin());
+        return userService.create(newUserRequest);
     }
 
     @PutMapping
-    public User update(@RequestBody User user) {
-        log.info("Получен запрос на обновление пользователя с id:{}", user.getId());
-        return userService.update(user);
+    public UserDto update(@RequestBody UpdateUserRequest userRequest) {
+        log.info("Получен запрос на обновление пользователя с id:{}", userRequest.getId());
+        return userService.update(userRequest);
     }
 
     @DeleteMapping("/{id}")
@@ -44,7 +48,7 @@ public void delete(@PathVariable("id") Long userId) {
     }
 
     @GetMapping("/{id}")
-    public User getById(@PathVariable("id") Long userId) {
+    public UserDto getById(@PathVariable("id") Long userId) {
         log.info("Получен запрос на получение пользователя с Id:{}", userId);
         return userService.getById(userId);
     }
@@ -64,14 +68,14 @@ public void removeFriend(@PathVariable("id") Long userId, @PathVariable("friendI
     }
 
     @GetMapping("/{id}/friends")
-    public Collection<User> getFriends(@PathVariable("id") Long userId) {
+    public Collection<UserDto> getFriends(@PathVariable("id") Long userId) {
         log.info("Получен запрос на получение списка всех друзей пользователя с Id:{}", userId);
-        return userService.getFriends(userId);
+        return userService.findAllFriends(userId);
     }
 
     @GetMapping("/{id}/friends/common/{otherId}")
-    public Collection<User> getCommonFriends(@PathVariable("id") Long userId, @PathVariable("otherId") Long otherId) {
+    public Collection<UserDto> getCommonFriends(@PathVariable("id") Long userId, @PathVariable("otherId") Long otherId) {
         log.info("Получен запрос на получение списка общих друзей у пользователей с Id:{} и {}", userId, otherId);
-        return userService.getCommonFriends(userId, otherId);
+        return userService.findCommonFriends(userId, otherId);
     }
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java
new file mode 100644
index 0000000..1f170b7
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java
@@ -0,0 +1,64 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.dao.EmptyResultDataAccessException;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.jdbc.support.GeneratedKeyHolder;
+import ru.yandex.practicum.filmorate.exception.InternalServerException;
+
+import java.sql.PreparedStatement;
+import java.sql.Statement;
+import java.util.List;
+import java.util.Optional;
+
+@RequiredArgsConstructor
+public class BaseDbStorage<T> {
+
+    protected final JdbcTemplate jdbc;
+    protected final RowMapper<T> mapper;
+
+    protected Optional<T> findOne(String query, Object... params) {
+        try {
+            T result = jdbc.queryForObject(query, mapper, params);
+            return Optional.ofNullable(result);
+        } catch (EmptyResultDataAccessException ignored) {
+            return Optional.empty();
+        }
+    }
+
+    protected List<T> findMany(String query, Object... params) {
+        return jdbc.query(query, mapper, params);
+    }
+
+    protected boolean delete(String query, long id) {
+        int rowsDeleted = jdbc.update(query, id);
+        return rowsDeleted > 0;
+    }
+
+    protected void update(String query, Object... params) {
+        int rowsUpdated = jdbc.update(query, params);
+        if (rowsUpdated == 0) {
+            throw new InternalServerException("Не удалось обновить данные");
+        }
+    }
+
+    protected long insert(String query, Object... params) {
+        GeneratedKeyHolder keyHolder = new GeneratedKeyHolder();
+        jdbc.update(connection -> {
+            PreparedStatement ps = connection
+                    .prepareStatement(query, Statement.RETURN_GENERATED_KEYS);
+            for (int idx = 0; idx < params.length; idx++) {
+                ps.setObject(idx + 1, params[idx]);
+            }
+            return ps;}, keyHolder);
+
+        Long id = keyHolder.getKeyAs(Long.class);
+
+        if (id != null) {
+            return id;
+        } else {
+            throw new InternalServerException("Не удалось сохранить данные");
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/FilmDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/FilmDbStorage.java
new file mode 100644
index 0000000..811245b
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/FilmDbStorage.java
@@ -0,0 +1,158 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.*;
+import ru.yandex.practicum.filmorate.storage.*;
+
+import java.util.*;
+import java.util.stream.Collectors;
+
+@Slf4j
+@Repository
+public class FilmDbStorage extends BaseDbStorage<Film> implements FilmStorage {
+
+    @Autowired
+    private GenreStorage genreStorage;
+    @Autowired
+    private LikesStorage likesStorage;
+    @Autowired
+    private MpaStorage mpaStorage;
+
+    private static final String INSERT_QUERY = "INSERT INTO films" +
+            "(name, description, release_date, duration, rating_id) " +
+            "VALUES (?, ?, ?, ?, ?)";
+    private static final String DELETE_QUERY = "DELETE FROM films WHERE film_id = ?";
+    private static final String UPDATE_QUERY = "UPDATE films SET " +
+            "name = ?, description = ?, release_date = ?, duration = ?, rating_id = ? WHERE film_id = ?";
+    private static final String FIND_BY_ID_QUERY = "SELECT f.film_id, f.name, f.description, f.release_date, " +
+            "f.duration, m.rating_id, m.name AS mpa_name " +
+            "FROM films AS f " +
+            "INNER JOIN mpa_rating AS m ON f.rating_id = m.rating_id " +
+            "WHERE f.film_id = ?";
+    private static final String FIND_ALL_FILMS_QUERY = "SELECT f.film_id, f.name, f.description, f.release_date, " +
+            "f.duration, m.rating_id, m.name AS mpa_name " +
+            "FROM films AS f " +
+            "INNER JOIN mpa_rating AS m ON f.rating_id = m.rating_id";
+    private static final String FIND_POPULAR_FILMS_QUERY = "SELECT f.film_id, f.name, f.description, " +
+            "f.release_date, f.duration, m.rating_id, m.name AS mpa_name, COUNT(l.user_id) AS likes " +
+            "FROM films As f " +
+            "INNER JOIN mpa_rating AS m ON f.rating_id = m.rating_id " +
+            "LEFT JOIN likes AS l ON f.film_id = l.film_id " +
+            "GROUP BY f.film_id " +
+            "ORDER BY likes DESC " +
+            "LIMIT ?";
+
+    public FilmDbStorage(JdbcTemplate jdbc, RowMapper<Film> mapper) {
+        super(jdbc, mapper);
+    }
+
+    // Добавление фильма
+    @Override
+    public Film create(Film film) {
+        long id = insert(
+                INSERT_QUERY,
+                film.getName(),
+                film.getDescription(),
+                film.getReleaseDate(),
+                film.getDuration(),
+                film.getMpa().getId()
+        );
+        film.setId(id);
+
+        if (film.getGenres() != null) {
+            genreStorage.setGenreForFilm(id, film.getGenres());
+        }
+
+        mpaStorage.findMpaFilm(id).ifPresent(film::setMpa);
+
+        return film;
+    }
+
+    // Удаление фильма
+    @Override
+    public void delete(Long id) {
+        delete(DELETE_QUERY, id);
+    }
+
+    // Изменение фильма
+    @Override
+    public Film update(Film film) {
+        update(
+                UPDATE_QUERY,
+                film.getName(),
+                film.getDescription(),
+                film.getReleaseDate(),
+                film.getDuration(),
+                film.getMpa().getId(),
+                film.getId()
+        );
+
+        if (film.getGenres() != null) {
+            genreStorage.setGenreForFilm(film.getId(), film.getGenres());
+        }
+
+        // Возвращаем полный объект из БД
+        return findById(film.getId()).orElseThrow();
+    }
+
+    // Получение фильма по id
+    @Override
+    public Optional<Film> findById(Long id) {
+        Optional<Film> film = findOne(FIND_BY_ID_QUERY, id);
+        film.ifPresent(this::loadFilmData);
+        return film;
+    }
+
+    // Получение всех фильмов
+    @Override
+    public Collection<Film> findAll() {
+        Collection<Film> films = findMany(FIND_ALL_FILMS_QUERY);
+        films.forEach(this::loadFilmData);
+        return films;
+    }
+
+    // Получение популярных фильмов по количеству лайков
+    @Override
+    public Collection<Film> findPopularFilms(int count) {
+        Collection<Film> films = findMany(FIND_POPULAR_FILMS_QUERY, count);
+        films.forEach(this::loadFilmData);
+        return films;
+    }
+
+    // Общий вспомогательный метод для загрузки всех данных фильма
+    private void loadFilmData(Film film) {
+        loadLikes(film);
+        loadGenres(film);
+        loadMpa(film);
+    }
+
+    // Вспомогательный метод для загрузки данных о лайках фильма
+    private void loadLikes(Film film) {
+        Set<Long> likes = likesStorage.getLikesOnFilm(film.getId()).stream()
+                .map(Likes::getUserId)
+                .collect(Collectors.toCollection(HashSet::new));
+        film.setLikesByUsers(likes);
+    }
+
+    // Вспомогательный метод для загрузки данных о жанрах фильма
+    private void loadGenres(Film film) {
+        Collection<Genre> genres = genreStorage.findGenreForFilm(film.getId());
+        film.setGenres(genres != null ?
+                genres.stream()
+                        .sorted(Comparator.comparing(Genre::getId))
+                        .collect(Collectors.toCollection(LinkedHashSet::new)) :
+                new LinkedHashSet<>());
+    }
+
+    // Вспомогательный метод для загрузки данных о рейтинге фильма
+    private void loadMpa(Film film) {
+        if (film.getMpa() == null || film.getMpa().getName() == null) {
+            mpaStorage.findMpaById(film.getMpa().getId())
+                    .ifPresent(film::setMpa);
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorage.java
new file mode 100644
index 0000000..4cb5c01
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorage.java
@@ -0,0 +1,66 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.*;
+import ru.yandex.practicum.filmorate.storage.FriendshipStorage;
+
+import java.util.Collection;
+import java.util.Optional;
+import java.util.stream.Collectors;
+
+@Slf4j
+@Repository
+public class FriendshipDbStorage extends BaseDbStorage<Friendship> implements FriendshipStorage {
+
+    private final UserDbStorage userStorage;
+
+    private static final String INSERT_QUERY = "INSERT INTO friendship(user_id, friend_id) VALUES (?, ?)";
+    private static final String DELETE_QUERY = "DELETE FROM friendship WHERE user_id = ? AND friend_id = ?";
+    private static final String FIND_FRIENDS_QUERY =
+            "SELECT f.user_id, f.friend_id FROM friendship f WHERE f.user_id = ?";
+    private static final String FIND_COMMON_FRIENDS_QUERY =
+            "SELECT f1.user_id, f1.friend_id " +
+                    "FROM friendship f1 " +
+                    "JOIN friendship f2 ON f1.friend_id = f2.friend_id " +
+                    "WHERE f1.user_id = ? AND f2.user_id = ?";
+
+    public FriendshipDbStorage(JdbcTemplate jdbc, RowMapper<Friendship> mapper, UserDbStorage userStorage) {
+        super(jdbc, mapper);
+        this.userStorage = userStorage;
+    }
+
+    // Добавление друга
+    @Override
+    public void addFriend(Long userId, Long friendId) {
+        update(INSERT_QUERY, userId, friendId);
+    }
+
+    // Удаление друга
+    @Override
+    public void removeFriend(Long userId, Long friendId) {
+        update(DELETE_QUERY, userId, friendId);
+    }
+
+    // Получение всех друзей пользователя
+    @Override
+    public Collection<User> findAllFriends(Long userId) {
+        return findMany(FIND_FRIENDS_QUERY, userId).stream()
+                .map(friendship -> userStorage.findById(friendship.getFriendId()))
+                .filter(Optional::isPresent)
+                .map(Optional::get)
+                .collect(Collectors.toList());
+    }
+
+    // Получение общих друзей
+    @Override
+    public Collection<User> findCommonFriends(Long userId, Long otherId) {
+        return findMany(FIND_COMMON_FRIENDS_QUERY, userId, otherId).stream()
+                .map(friendship -> userStorage.findById(friendship.getFriendId()))
+                .filter(Optional::isPresent)
+                .map(Optional::get)
+                .collect(Collectors.toList());
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java
new file mode 100644
index 0000000..400770b
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java
@@ -0,0 +1,68 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.Genre;
+import ru.yandex.practicum.filmorate.storage.GenreStorage;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+import java.util.Optional;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+@Slf4j
+@Repository
+public class GenreDbStorage extends BaseDbStorage<Genre> implements GenreStorage {
+
+    private static final String FIND_ALL_GENRES_QUERY = "SELECT genre_id, name FROM genre";
+    private static final String FIND_BY_ID_QUERY = "SELECT genre_id, name FROM genre WHERE genre_id = ?";
+    private static final String FIND_GENRE_FOR_FILM_QUERY = "SELECT g.genre_id, g.name FROM genre As g " +
+            "INNER JOIN film_genres AS fg ON g.genre_id = fg.genre_id " +
+            "WHERE fg.film_id = ?";
+    private static final String INSERT_GENRES_FOR_FILM_QUERY = "INSERT INTO film_genres (film_id, genre_id) " +
+            "VALUES(?, ?)";
+    private static final String DELETE_ALL_GENRES_FOR_FILM_QUERY = "DELETE FROM film_genres WHERE film_id = ?";
+
+    public GenreDbStorage(JdbcTemplate jdbc, RowMapper<Genre> mapper) {
+        super(jdbc, mapper);
+    }
+
+    // Получение всех жанров
+    @Override
+    public Collection<Genre> findAllGenres() {
+        return findMany(FIND_ALL_GENRES_QUERY);
+    }
+
+    // Получение жанра по id
+    @Override
+    public Optional<Genre> findById(Long genreId) {
+        return findOne(FIND_BY_ID_QUERY, genreId);
+    }
+
+    // Получение жанров для указанного фильма
+    @Override
+    public Collection<Genre> findGenreForFilm(Long filmId) {
+        return findMany(FIND_GENRE_FOR_FILM_QUERY, filmId);
+    }
+
+    // Добавление жанра для фильма
+    @Override
+    public void setGenreForFilm(Long filmId, Collection<Genre> genres) {
+        if (genres == null) {
+            return;
+        }
+
+        // Удаление всех текущих жанров
+        jdbc.update(DELETE_ALL_GENRES_FOR_FILM_QUERY, filmId);
+
+        // Добавление новых жанров
+        for (Genre genre : genres) {
+            jdbc.update(INSERT_GENRES_FOR_FILM_QUERY,
+                    filmId, genre.getId());
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/LikesDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/LikesDbStorage.java
new file mode 100644
index 0000000..98fd65b
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/LikesDbStorage.java
@@ -0,0 +1,41 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.Likes;
+import ru.yandex.practicum.filmorate.storage.LikesStorage;
+
+import java.util.Collection;
+
+@Slf4j
+@Repository
+public class LikesDbStorage extends BaseDbStorage<Likes> implements LikesStorage {
+
+    private static final String INSERT_QUERY = "INSERT INTO likes (film_id, user_id) VALUES (?, ?)";
+    private static final String DELETE_QUERY = "DELETE FROM likes WHERE film_id = ? AND user_id = ?";
+    private static final String FIND_LIKES_ON_FILM_QUERY = "SELECT film_id, user_id FROM likes WHERE film_id = ?";
+
+    public LikesDbStorage(JdbcTemplate jdbc, RowMapper<Likes> mapper) {
+        super(jdbc, mapper);
+    }
+
+    // Добавление лайка фильму
+    @Override
+    public void addLikeToFilm(Long filmId, Long userId) {
+        update(INSERT_QUERY, filmId, userId);
+    }
+
+    // Удаление лайка у фильма
+    @Override
+    public void removeLikeFromFilm(Long filmId, Long userId) {
+        update(DELETE_QUERY, filmId, userId);
+    }
+
+    // Получение всех лайков фильма
+    @Override
+    public Collection<Likes> getLikesOnFilm(Long filmId) {
+        return findMany(FIND_LIKES_ON_FILM_QUERY, filmId);
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/MpaDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/MpaDbStorage.java
new file mode 100644
index 0000000..0fd1046
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/MpaDbStorage.java
@@ -0,0 +1,44 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.Mpa;
+import ru.yandex.practicum.filmorate.storage.MpaStorage;
+
+import java.util.Collection;
+import java.util.Optional;
+
+@Slf4j
+@Repository
+public class MpaDbStorage extends BaseDbStorage<Mpa> implements MpaStorage {
+
+    private static final String FIND_ALL_MPA_QUERY = "SELECT rating_id, name FROM mpa_rating";
+    private static final String FIND_BY_ID_QUERY = "SELECT rating_id, name FROM mpa_rating WHERE rating_id = ?";
+    private static final String FIND_MPA_FILM_QUERY = "SELECT m.rating_id, m.name FROM films AS f " +
+            "INNER JOIN mpa_rating AS m ON f.rating_id = m.rating_id " +
+            "WHERE f.film_id = ?";
+
+    public MpaDbStorage(JdbcTemplate jdbc, RowMapper<Mpa> mapper) {
+        super(jdbc, mapper);
+    }
+
+    // Получение всех рейтингов
+    @Override
+    public Collection<Mpa> findAll() {
+        return findMany(FIND_ALL_MPA_QUERY);
+    }
+
+    // Получение рейтинга по его id
+    @Override
+    public Optional<Mpa> findMpaById(Long ratingId) {
+        return findOne(FIND_BY_ID_QUERY, ratingId);
+    }
+
+    // Получение рейтинга для фильма
+    @Override
+    public Optional<Mpa> findMpaFilm(Long filmId) {
+        return findOne(FIND_MPA_FILM_QUERY, filmId);
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
new file mode 100644
index 0000000..364832a
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
@@ -0,0 +1,100 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.User;
+import ru.yandex.practicum.filmorate.storage.UserStorage;
+
+import java.util.Collection;
+import java.util.Optional;
+import java.util.stream.Collectors;
+
+@Slf4j
+@Repository
+public class UserDbStorage extends BaseDbStorage<User> implements UserStorage {
+
+    private static final String INSERT_QUERY = "INSERT INTO users(email, login, name, birthday) " +
+            "VALUES(?, ?, ?, ?)";
+    private static final String DELETE_QUERY = "DELETE FROM users WHERE user_id = ?";
+    private static final String UPDATE_QUERY = "UPDATE users SET email = ?, login = ?, name = ?, birthday = ? " +
+            "WHERE user_id = ?";
+    private static final String FIND_BY_ID_QUERY = "SELECT user_id, email, login, name, birthday " +
+            "FROM users " +
+            "WHERE user_id = ?";
+    private static final String FIND_ALL_USERS_QUERY = "SELECT user_id, email, login, name, birthday FROM users";
+    private static final String FIND_FRIENDS_QUERY = "SELECT user_id, email, login, name, birthday FROM users " +
+            "WHERE user_id IN(SELECT friend_id FROM friendship WHERE user_id = ?)";
+
+    public UserDbStorage(JdbcTemplate jdbc, RowMapper<User> mapper) {
+        super(jdbc, mapper);
+    }
+
+    // Добавление пользователя
+    @Override
+    public User create(User user) {
+        long id = insert(
+                INSERT_QUERY,
+                user.getEmail(),
+                user.getLogin(),
+                user.getName(),
+                user.getBirthday()
+        );
+        user.setId(id);
+        return user;
+    }
+
+    // Удаление пользователя
+    @Override
+    public void delete(Long id) {
+        delete(DELETE_QUERY, id);
+    }
+
+    // Изменение пользователя
+    @Override
+    public User update(User user) {
+        update(
+                UPDATE_QUERY,
+                user.getEmail(),
+                user.getLogin(),
+                user.getName(),
+                user.getBirthday(),
+                user.getId()
+        );
+        return user;
+    }
+
+    // Получение пользователя по id
+    @Override
+    public Optional<User> findById(Long id) {
+        Optional<User> user = findOne(FIND_BY_ID_QUERY, id);
+        user.ifPresent(value -> value.setFriends(
+                findMany(FIND_FRIENDS_QUERY, value.getId())
+                        .stream()
+                        .map(User::getId)
+                        .collect(Collectors.toSet())
+        ));
+        return user;
+    }
+
+    // Получение всех пользователей
+    @Override
+    public Collection<User> findAll() {
+        Collection<User> users = findMany(FIND_ALL_USERS_QUERY);
+
+        if(users.isEmpty()) {
+            return users;
+        }
+
+        users.forEach(user -> {
+            user.setFriends(
+                    findMany(FIND_FRIENDS_QUERY, user.getId())
+                            .stream()
+                            .map(User::getId)
+                            .collect(Collectors.toSet())
+            );
+        });
+        return users;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FilmRowMapper.java b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FilmRowMapper.java
new file mode 100644
index 0000000..430d335
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FilmRowMapper.java
@@ -0,0 +1,35 @@
+package ru.yandex.practicum.filmorate.dal.mappers;
+
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Component;
+import ru.yandex.practicum.filmorate.model.Film;
+import ru.yandex.practicum.filmorate.model.Mpa;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.util.HashSet;
+import java.util.LinkedHashSet;
+
+@Component
+public class FilmRowMapper implements RowMapper<Film> {
+
+    @Override
+    public Film mapRow(ResultSet rs, int rowNum) throws SQLException {
+        Film film = new Film();
+        film.setId(rs.getLong("film_id"));
+        film.setName(rs.getString("name"));
+        film.setDescription(rs.getString("description"));
+        film.setReleaseDate(rs.getDate("release_date").toLocalDate());
+        film.setDuration(rs.getInt("duration"));
+
+        Mpa mpa = new Mpa();
+        mpa.setId(rs.getLong("rating_id"));
+        mpa.setName(rs.getString("mpa_name"));
+        film.setMpa(mpa);
+
+        film.setLikesByUsers(new HashSet<>());
+        film.setGenres(new LinkedHashSet<>());
+
+        return film;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FriendshipRowMapper.java b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FriendshipRowMapper.java
new file mode 100644
index 0000000..33cb4cc
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/FriendshipRowMapper.java
@@ -0,0 +1,20 @@
+package ru.yandex.practicum.filmorate.dal.mappers;
+
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Component;
+import ru.yandex.practicum.filmorate.model.Friendship;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+
+@Component
+public class FriendshipRowMapper implements RowMapper<Friendship> {
+
+    @Override
+    public Friendship mapRow(ResultSet rs, int rowNum) throws SQLException {
+        Friendship friendship = new Friendship();
+        friendship.setUserId(rs.getLong("user_id"));
+        friendship.setFriendId(rs.getLong("friend_id"));
+        return friendship;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/GenreRowMapper.java b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/GenreRowMapper.java
new file mode 100644
index 0000000..a321799
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/GenreRowMapper.java
@@ -0,0 +1,20 @@
+package ru.yandex.practicum.filmorate.dal.mappers;
+
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Component;
+import ru.yandex.practicum.filmorate.model.Genre;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+
+@Component
+public class GenreRowMapper implements RowMapper<Genre> {
+
+    @Override
+    public Genre mapRow(ResultSet rs, int rowNum) throws SQLException {
+        Genre genre = new Genre();
+        genre.setId(rs.getLong("genre_id"));
+        genre.setName(rs.getString("name"));
+        return genre;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/LikesRowMapper.java b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/LikesRowMapper.java
new file mode 100644
index 0000000..c5229d1
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/LikesRowMapper.java
@@ -0,0 +1,20 @@
+package ru.yandex.practicum.filmorate.dal.mappers;
+
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Component;
+import ru.yandex.practicum.filmorate.model.Likes;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+
+@Component
+public class LikesRowMapper implements RowMapper<Likes> {
+
+    @Override
+    public Likes mapRow(ResultSet rs, int rowNum) throws SQLException {
+        Likes likes = new Likes();
+        likes.setFilmId(rs.getLong("film_id"));
+        likes.setUserId(rs.getLong("user_id"));
+        return likes;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/MpaRowMapper.java b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/MpaRowMapper.java
new file mode 100644
index 0000000..9ed8a00
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/MpaRowMapper.java
@@ -0,0 +1,20 @@
+package ru.yandex.practicum.filmorate.dal.mappers;
+
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Component;
+import ru.yandex.practicum.filmorate.model.Mpa;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+
+@Component
+public class MpaRowMapper implements RowMapper<Mpa> {
+
+    @Override
+    public Mpa mapRow(ResultSet rs, int rowNum) throws SQLException {
+        Mpa mpa = new Mpa();
+        mpa.setId(rs.getLong("rating_id"));
+        mpa.setName(rs.getString("name"));
+        return mpa;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/UserRowMapper.java b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/UserRowMapper.java
new file mode 100644
index 0000000..36e492c
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/mappers/UserRowMapper.java
@@ -0,0 +1,27 @@
+package ru.yandex.practicum.filmorate.dal.mappers;
+
+import org.springframework.jdbc.core.RowMapper;
+import org.springframework.stereotype.Component;
+import ru.yandex.practicum.filmorate.model.User;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.util.HashSet;
+
+@Component
+public class UserRowMapper implements RowMapper<User> {
+
+    @Override
+    public User mapRow(ResultSet rs, int rowNum) throws SQLException {
+        User user = new User();
+        user.setId(rs.getLong("user_id"));
+        user.setEmail(rs.getString("email"));
+        user.setLogin(rs.getString("login"));
+        user.setName(rs.getString("name"));
+        user.setBirthday(rs.getDate("birthday").toLocalDate());
+
+        user.setFriends(new HashSet<>());
+
+        return user;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dto/FilmDto.java b/src/main/java/ru/yandex/practicum/filmorate/dto/FilmDto.java
new file mode 100644
index 0000000..91a3298
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dto/FilmDto.java
@@ -0,0 +1,24 @@
+package ru.yandex.practicum.filmorate.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.Data;
+import ru.yandex.practicum.filmorate.model.*;
+
+import java.time.LocalDate;
+import java.util.Set;
+
+@Data
+public class FilmDto {
+
+    @JsonProperty(access = JsonProperty.Access.READ_ONLY)
+    private Long id;
+    private String name;
+    private String description;
+    private LocalDate releaseDate;
+    private Integer duration;
+    private Mpa mpa;
+    @JsonProperty(access = JsonProperty.Access.READ_ONLY)
+    private Set<Long> likesByUsers;
+    @JsonProperty(access = JsonProperty.Access.READ_ONLY)
+    private Set<Genre> genres;
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dto/NewFilmRequest.java b/src/main/java/ru/yandex/practicum/filmorate/dto/NewFilmRequest.java
new file mode 100644
index 0000000..fa23850
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dto/NewFilmRequest.java
@@ -0,0 +1,21 @@
+package ru.yandex.practicum.filmorate.dto;
+
+import lombok.Data;
+import ru.yandex.practicum.filmorate.model.Genre;
+import ru.yandex.practicum.filmorate.model.Mpa;
+
+import java.time.LocalDate;
+import java.util.LinkedHashSet;
+import java.util.Set;
+
+@Data
+public class NewFilmRequest {
+
+    private Long id;
+    private String name;
+    private String description;
+    private LocalDate releaseDate;
+    private Integer duration;
+    private Mpa mpa;
+    private Set<Genre> genres = new LinkedHashSet<>();
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dto/NewUserRequest.java b/src/main/java/ru/yandex/practicum/filmorate/dto/NewUserRequest.java
new file mode 100644
index 0000000..8d3d39e
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dto/NewUserRequest.java
@@ -0,0 +1,18 @@
+package ru.yandex.practicum.filmorate.dto;
+
+import lombok.Data;
+
+import java.time.LocalDate;
+
+@Data
+public class NewUserRequest {
+
+    private String email;
+    private String login;
+    private String name;
+    private LocalDate birthday;
+
+    public String getName() {
+        return (name == null || name.isBlank()) ? login : name;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dto/UpdateFilmRequest.java b/src/main/java/ru/yandex/practicum/filmorate/dto/UpdateFilmRequest.java
new file mode 100644
index 0000000..2e977a7
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dto/UpdateFilmRequest.java
@@ -0,0 +1,24 @@
+package ru.yandex.practicum.filmorate.dto;
+
+import lombok.*;
+import ru.yandex.practicum.filmorate.model.Genre;
+import ru.yandex.practicum.filmorate.model.Mpa;
+
+import java.time.LocalDate;
+import java.util.LinkedHashSet;
+import java.util.Set;
+
+@Data
+@Builder(toBuilder = true)
+@NoArgsConstructor
+@AllArgsConstructor
+public class UpdateFilmRequest {
+
+    private Long id;
+    private String name;
+    private String description;
+    private LocalDate releaseDate;
+    private Integer duration;
+    private Mpa mpa;
+    private Set<Genre> genres = new LinkedHashSet<>();
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dto/UpdateUserRequest.java b/src/main/java/ru/yandex/practicum/filmorate/dto/UpdateUserRequest.java
new file mode 100644
index 0000000..682fba3
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dto/UpdateUserRequest.java
@@ -0,0 +1,22 @@
+package ru.yandex.practicum.filmorate.dto;
+
+import lombok.*;
+
+import java.time.LocalDate;
+
+@Data
+@Builder(toBuilder = true)
+@NoArgsConstructor
+@AllArgsConstructor
+public class UpdateUserRequest {
+
+    private Long id;
+    private String email;
+    private String login;
+    private String name;
+    private LocalDate birthday;
+
+    public String getName() {
+        return (name == null || name.isBlank()) ? login : name;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dto/UserDto.java b/src/main/java/ru/yandex/practicum/filmorate/dto/UserDto.java
new file mode 100644
index 0000000..c44827f
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/dto/UserDto.java
@@ -0,0 +1,24 @@
+package ru.yandex.practicum.filmorate.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.util.Set;
+
+@Data
+public class UserDto {
+
+    @JsonProperty(access = JsonProperty.Access.READ_ONLY)
+    private Long id;
+    private String email;
+    private String login;
+    private String name;
+    private LocalDate birthday;
+    @JsonProperty(access = JsonProperty.Access.READ_ONLY)
+    private Set<Long> friends;
+
+    public String getName() {
+        return (name == null || name.isBlank()) ? login : name;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/exception/InternalServerException.java b/src/main/java/ru/yandex/practicum/filmorate/exception/InternalServerException.java
new file mode 100644
index 0000000..8e1a88b
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/exception/InternalServerException.java
@@ -0,0 +1,8 @@
+package ru.yandex.practicum.filmorate.exception;
+
+public class InternalServerException extends RuntimeException {
+
+    public InternalServerException(String message) {
+        super(message);
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/mapper/FilmMapper.java b/src/main/java/ru/yandex/practicum/filmorate/mapper/FilmMapper.java
new file mode 100644
index 0000000..1b18769
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/mapper/FilmMapper.java
@@ -0,0 +1,93 @@
+package ru.yandex.practicum.filmorate.mapper;
+
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
+import ru.yandex.practicum.filmorate.dto.FilmDto;
+import ru.yandex.practicum.filmorate.dto.NewFilmRequest;
+import ru.yandex.practicum.filmorate.dto.UpdateFilmRequest;
+import ru.yandex.practicum.filmorate.model.Film;
+import ru.yandex.practicum.filmorate.model.Genre;
+
+import java.util.Comparator;
+import java.util.HashSet;
+import java.util.LinkedHashSet;
+import java.util.stream.Collectors;
+
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+public class FilmMapper {
+
+    // Добавление фильма
+    public static Film mapToFilm(NewFilmRequest request) {
+        Film film = new Film();
+        film.setName(request.getName());
+        film.setDescription(request.getDescription());
+        film.setReleaseDate(request.getReleaseDate());
+        film.setDuration(request.getDuration());
+        film.setMpa(request.getMpa());
+        film.setGenres(request.getGenres().stream()
+                .sorted(Comparator.comparing(Genre::getId))
+                .collect(Collectors.toCollection(LinkedHashSet::new)));
+        film.setLikesByUsers(new HashSet<>());
+        return film;
+    }
+
+    // Изменение фильма
+    public static Film mapToFilm(UpdateFilmRequest request) {
+        Film film = new Film();
+        film.setId(request.getId());
+        film.setName(request.getName());
+        film.setDescription(request.getDescription());
+        film.setReleaseDate(request.getReleaseDate());
+        film.setDuration(request.getDuration());
+        film.setMpa(request.getMpa());
+        film.setGenres(request.getGenres().stream()
+                .sorted(Comparator.comparing(Genre::getId))
+                .collect(Collectors.toCollection(LinkedHashSet::new)));
+        film.setLikesByUsers(new HashSet<>());
+        return film;
+    }
+
+    // Преобразование в DTO
+    public static FilmDto mapToDto(Film film) {
+        FilmDto dto = new FilmDto();
+        dto.setId(film.getId());
+        dto.setName(film.getName());
+        dto.setDescription(film.getDescription());
+        dto.setReleaseDate(film.getReleaseDate());
+        dto.setDuration(film.getDuration());
+        dto.setMpa(film.getMpa());
+
+        dto.setGenres(film.getGenres() != null ?
+                new LinkedHashSet<>(film.getGenres()) :
+                new LinkedHashSet<>());
+
+        dto.setLikesByUsers(film.getLikesByUsers() != null ?
+                new HashSet<>(film.getLikesByUsers()) :
+                new HashSet<>());
+
+        return dto;
+    }
+
+    // Частичное изменение фильма
+    public static Film updateFilmFields(Film film, UpdateFilmRequest request) {
+        if (request.getName() != null) {
+            film.setName(request.getName());
+        }
+        if (request.getDescription() != null) {
+            film.setDescription(request.getDescription());
+        }
+        if (request.getReleaseDate() != null) {
+            film.setReleaseDate(request.getReleaseDate());
+        }
+        if (request.getDuration() != null) {
+            film.setDuration(request.getDuration());
+        }
+        if (request.getMpa() != null) {
+            film.setMpa(request.getMpa());
+        }
+        if (request.getGenres() != null) {
+            film.setGenres(new LinkedHashSet<>(request.getGenres()));
+        }
+        return film;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/mapper/UserMapper.java b/src/main/java/ru/yandex/practicum/filmorate/mapper/UserMapper.java
new file mode 100644
index 0000000..f66adfe
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/mapper/UserMapper.java
@@ -0,0 +1,67 @@
+package ru.yandex.practicum.filmorate.mapper;
+
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
+import ru.yandex.practicum.filmorate.dto.NewUserRequest;
+import ru.yandex.practicum.filmorate.dto.UpdateUserRequest;
+import ru.yandex.practicum.filmorate.dto.UserDto;
+import ru.yandex.practicum.filmorate.model.User;
+
+import java.util.HashSet;
+
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+public class UserMapper {
+
+    // Добавление пользователя
+    public static User mapToUser(NewUserRequest request) {
+        User user = new User();
+        user.setEmail(request.getEmail());
+        user.setLogin(request.getLogin());
+        user.setName(request.getName());
+        user.setBirthday(request.getBirthday());
+        user.setFriends(new HashSet<>());
+        return user;
+    }
+
+    // Изменение пользователя
+    public static User mapToUser(UpdateUserRequest request) {
+        User user = new User();
+        user.setId(request.getId());
+        user.setEmail(request.getEmail());
+        user.setLogin(request.getLogin());
+        user.setBirthday(request.getBirthday());
+        user.setFriends(new HashSet<>());
+        return user;
+    }
+
+    // Преобразование в DTO
+    public static UserDto mapToDto(User user) {
+        UserDto dto = new UserDto();
+        dto.setId(user.getId());
+        dto.setEmail(user.getEmail());
+        dto.setLogin(user.getLogin());
+        dto.setName(user.getName());
+        dto.setBirthday(user.getBirthday());
+        dto.setFriends(user.getFriends() != null ?
+                new HashSet<>(user.getFriends()) :
+                new HashSet<>());
+        return dto;
+    }
+
+    // Частичное изменение пользователя
+    public static User updateUserFields(User user, UpdateUserRequest request) {
+        if (request.getEmail() != null) {
+            user.setEmail(request.getEmail());
+        }
+        if (request.getLogin() != null) {
+            user.setLogin(request.getLogin());
+        }
+        if (request.getName() != null) {
+            user.setName(request.getName());
+        }
+        if (request.getBirthday() != null) {
+            user.setBirthday(request.getBirthday());
+        }
+        return user;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/model/Film.java b/src/main/java/ru/yandex/practicum/filmorate/model/Film.java
index b2514ef..16c9d84 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/model/Film.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/model/Film.java
@@ -14,13 +14,11 @@
 public class Film {
 
     private Long id;
-    private Set<Long> likesByUsers;
-
     private String name;
-
     private String description;
-
     private LocalDate releaseDate;
-
     private Integer duration;
+    private Mpa mpa;
+    private Set<Long> likesByUsers;
+    private Set<Genre> genres;
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/model/Friendship.java b/src/main/java/ru/yandex/practicum/filmorate/model/Friendship.java
new file mode 100644
index 0000000..8376838
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/model/Friendship.java
@@ -0,0 +1,10 @@
+package ru.yandex.practicum.filmorate.model;
+
+import lombok.Data;
+
+@Data
+public class Friendship {
+
+    private Long userId;
+    private Long friendId;
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/model/Genre.java b/src/main/java/ru/yandex/practicum/filmorate/model/Genre.java
new file mode 100644
index 0000000..f9aa66e
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/model/Genre.java
@@ -0,0 +1,12 @@
+package ru.yandex.practicum.filmorate.model;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@EqualsAndHashCode(of = {"id"})
+public class Genre {
+
+    private Long id;
+    private String name;
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/model/Likes.java b/src/main/java/ru/yandex/practicum/filmorate/model/Likes.java
new file mode 100644
index 0000000..6b89aca
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/model/Likes.java
@@ -0,0 +1,9 @@
+package ru.yandex.practicum.filmorate.model;
+
+import lombok.Data;
+
+@Data
+public class Likes {
+    private Long filmId;
+    private Long userId;
+}
diff --git a/src/main/java/ru/yandex/practicum/filmorate/model/Mpa.java b/src/main/java/ru/yandex/practicum/filmorate/model/Mpa.java
new file mode 100644
index 0000000..d106e01
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/model/Mpa.java
@@ -0,0 +1,12 @@
+package ru.yandex.practicum.filmorate.model;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@EqualsAndHashCode(of = {"id"})
+public class Mpa {
+
+    private Long id;
+    private String name;
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/model/User.java b/src/main/java/ru/yandex/practicum/filmorate/model/User.java
index b51ef9e..1625a49 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/model/User.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/model/User.java
@@ -14,15 +14,11 @@
 public class User {
 
     private Long id;
-    private Set<Long> friends;
-
     private String email;
-
     private String login;
-
     private String name;
-
     private LocalDate birthday;
+    private Set<Long> friends;
 
     public String getName() {
         return (name == null || name.isBlank()) ? login : name;
diff --git a/src/main/java/ru/yandex/practicum/filmorate/service/FilmService.java b/src/main/java/ru/yandex/practicum/filmorate/service/FilmService.java
index f01a054..c4eca69 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/service/FilmService.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/service/FilmService.java
@@ -3,10 +3,13 @@
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
+import ru.yandex.practicum.filmorate.dto.FilmDto;
+import ru.yandex.practicum.filmorate.dto.NewFilmRequest;
+import ru.yandex.practicum.filmorate.dto.UpdateFilmRequest;
 import ru.yandex.practicum.filmorate.exception.*;
+import ru.yandex.practicum.filmorate.mapper.FilmMapper;
 import ru.yandex.practicum.filmorate.model.*;
-import ru.yandex.practicum.filmorate.storage.film.FilmStorage;
-import ru.yandex.practicum.filmorate.storage.user.UserStorage;
+import ru.yandex.practicum.filmorate.storage.*;
 import ru.yandex.practicum.filmorate.utils.FilmValidate;
 
 import java.util.*;
@@ -19,68 +22,130 @@ public class FilmService {
     private final FilmStorage filmStorage;
     private final UserStorage userStorage;
     private final FilmValidate filmValidate;
+    private final GenreStorage genreStorage;
+    private final MpaStorage mpaStorage;
+    private final LikesStorage likesStorage;
+
+    // Получение всех фильмов
+    public Collection<FilmDto> findAll() {
+        return filmStorage.findAll().stream()
+                .map(FilmMapper::mapToDto)
+                .toList();
+    }
 
-    public Collection<Film> findAll() {
-        return filmStorage.findAll();
+    // Получение фильма по id
+    public FilmDto findById(Long filmId) {
+        return filmStorage.findById(filmId)
+                .map(FilmMapper::mapToDto)
+                .orElseThrow(() -> new NotFoundException("Фильм не найден"));
     }
 
-    public Film create(Film film) {
+    // Добавление фильма
+    public FilmDto create(NewFilmRequest request) {
+        Film film = FilmMapper.mapToFilm(request);
         filmValidate.validateFilm(film);
-        return filmStorage.create(film);
+
+        if (film.getGenres() != null) {
+            film.getGenres().forEach(genre -> {
+                genreStorage.findById(genre.getId())
+                        .orElseThrow(() -> {
+                            log.warn("Жанр с id:{} не найден", genre.getId());
+                            return new NotFoundException("Жанр не найден");
+                        });
+            });
+        }
+
+        Long mpaId = film.getMpa().getId();
+        if (mpaId != null) {
+            mpaStorage.findMpaById(mpaId)
+                    .orElseThrow(() -> {
+                        log.warn("Рейтинг с id:{} не найден", mpaId);
+                        return new NotFoundException("Рейтинг MPA не найден");
+                    });
+        }
+
+        film = filmStorage.create(film);
+        return FilmMapper.mapToDto(film);
     }
 
-    public Film update(Film film) {
+    // Обновление фильма
+    public FilmDto update(UpdateFilmRequest request) {
+        Film film = FilmMapper.mapToFilm(request);
         filmValidate.validateFilm(film);
-        return filmStorage.update(film);
-    }
 
-    public void delete(Long id) {
-        filmStorage.delete(id);
+        Film oldFilm = filmStorage.findById(request.getId())
+                .orElseThrow(() -> {
+                    log.warn("Фильм с id:{} не найден", request.getId());
+                    return new NotFoundException("Фильм не найден");
+                });
+
+        Long mpaId = film.getMpa().getId();
+        if (mpaId != null) {
+            mpaStorage.findMpaById(mpaId)
+                    .orElseThrow(() -> {
+                        log.warn("Рейтинг с id:{} не найден", mpaId);
+                        return new NotFoundException("Рейтинг MPA не найден");
+                    });
+        }
+
+        if (film.getGenres() != null) {
+            film.getGenres().forEach(genre -> {
+                genreStorage.findById(genre.getId())
+                        .orElseThrow(() -> {
+                            log.warn("Жанр с id:{} не найден", genre.getId());
+                            return new NotFoundException("Жанр не найден");
+                        });
+            });
+        }
+
+        film = FilmMapper.updateFilmFields(oldFilm, request);
+        film.setLikesByUsers(oldFilm.getLikesByUsers());
+        return FilmMapper.mapToDto(filmStorage.update(film));
     }
 
-    public Film getById(Long id) {
-        return filmStorage.getById(id);
+    // Удаление фильма по id
+    public void delete(Long filmId) {
+        filmStorage.delete(filmId);
     }
 
     // Метод добавления лайка фильму(по id) от пользователя c указанным id
     public void addLike(Long filmId, Long userId) {
-        final Film film = filmStorage.getById(filmId);
-        if (film == null) {
-            log.warn("Попытка лайкнуть несуществующий фильм Id:{}", filmId);
-            throw new NotFoundException("Фильм не найден");
-        }
-
-        final User user = userStorage.getById(userId);
-        if (user == null) {
-            log.warn("Попытка лайка от несуществующего пользователя Id:{}", userId);
-            throw new NotFoundException("Пользователь не найден");
-        }
+        final Film film = filmStorage.findById(filmId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка лайкнуть несуществующий фильм Id:{}", filmId);
+                    throw new NotFoundException("Фильм не найден");
+                });
+
+        final User user = userStorage.findById(userId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка лайка от несуществующего пользователя Id:{}", userId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
 
         Set<Long> likes = film.getLikesByUsers();
         if (likes.contains(userId)) {
             log.debug("Пользователь с Id:{} уже ставил лайк фильму с Id:{}", userId, filmId);
             return;
         }
-
         likes.add(userId);
         film.setLikesByUsers(likes);
-        filmStorage.update(film);
+        likesStorage.addLikeToFilm(filmId, userId);
         log.debug("Пользователь с Id:{} поставил лайк фильму c Id:{}", userId, filmId);
     }
 
     // Метод удаления лайка у фильма(по id) от пользователя с указанным id
     public void removeLike(Long filmId, Long userId) {
-        final Film film = filmStorage.getById(filmId);
-        if (film == null) {
-            log.warn("Попытка удалить лайк у несуществующего фильма с Id:{}", filmId);
-            throw new NotFoundException("Фильм не найден");
-        }
-
-        final User user = userStorage.getById(userId);
-        if (user == null) {
-            log.warn("Попытка удалить лайк от несуществующего пользователя c Id:{}", userId);
-            throw new NotFoundException("Пользователь не найден");
-        }
+        final Film film = filmStorage.findById(filmId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка удалить лайк у несуществующего фильма с Id:{}", filmId);
+                    throw new NotFoundException("Фильм не найден");
+                });
+
+        final User user = userStorage.findById(userId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка удалить лайк от несуществующего пользователя c Id:{}", userId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
 
         Set<Long> likes = film.getLikesByUsers();
         if (!likes.contains(userId)) {
@@ -89,20 +154,17 @@ public void removeLike(Long filmId, Long userId) {
         }
         likes.remove(userId);
         film.setLikesByUsers(likes);
-        filmStorage.update(film);
+        likesStorage.removeLikeFromFilm(filmId, userId);
         log.debug("Пользователь с Id:{} удалил лайк фильму c Id:{}", userId, filmId);
     }
 
-    // Метод вывода 10 популярных фильмов по количеству лайков
-    public Collection<Film> getPopularFilms(int count) {
-        if (count <= 0) {
-            throw new ValidationException("Количество фильмов должно быть положительным");
-        }
-
+    // Метод получения популярных фильмов по количеству лайков
+    public Collection<FilmDto> findPopularFilms(int count) {
         Collection<Film> films = filmStorage.findAll();
         return films.stream()
                 .sorted((f1, f2) -> f2.getLikesByUsers().size() - f1.getLikesByUsers().size())
                 .limit(count)
+                .map(FilmMapper::mapToDto)
                 .toList();
     }
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/service/GenreService.java b/src/main/java/ru/yandex/practicum/filmorate/service/GenreService.java
new file mode 100644
index 0000000..ceb291b
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/service/GenreService.java
@@ -0,0 +1,30 @@
+package ru.yandex.practicum.filmorate.service;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import ru.yandex.practicum.filmorate.exception.NotFoundException;
+import ru.yandex.practicum.filmorate.model.Genre;
+import ru.yandex.practicum.filmorate.storage.GenreStorage;
+
+import java.util.Collection;
+
+@Slf4j
+@Service
+public class GenreService {
+
+    @Autowired
+    private GenreStorage genreStorage;
+
+    public Collection<Genre> findAll() {
+        return genreStorage.findAllGenres();
+    }
+
+    public Genre findById(Long genreId) {
+        return genreStorage.findById(genreId)
+                .orElseThrow(() -> {
+                    log.warn("Жанр с id:{} не найден", genreId);
+                    return new NotFoundException("Жанр не найден");
+                });
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/service/MpaService.java b/src/main/java/ru/yandex/practicum/filmorate/service/MpaService.java
new file mode 100644
index 0000000..a599f88
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/service/MpaService.java
@@ -0,0 +1,30 @@
+package ru.yandex.practicum.filmorate.service;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import ru.yandex.practicum.filmorate.exception.NotFoundException;
+import ru.yandex.practicum.filmorate.model.Mpa;
+import ru.yandex.practicum.filmorate.storage.MpaStorage;
+
+import java.util.Collection;
+
+@Slf4j
+@Service
+public class MpaService {
+
+    @Autowired
+    private MpaStorage mpaStorage;
+
+    public Collection<Mpa> findAll() {
+        return mpaStorage.findAll();
+    }
+
+    public Mpa findById(Long ratingId) {
+        return mpaStorage.findMpaById(ratingId)
+                .orElseThrow(() -> {
+                    log.warn("Рейтинг с id:{} не найден", ratingId);
+                    return new NotFoundException("Рейтинг MPA не найден");
+                });
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/service/UserService.java b/src/main/java/ru/yandex/practicum/filmorate/service/UserService.java
index c2e60f6..7346bed 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/service/UserService.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/service/UserService.java
@@ -3,13 +3,17 @@
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
+import ru.yandex.practicum.filmorate.dto.NewUserRequest;
+import ru.yandex.practicum.filmorate.dto.UpdateUserRequest;
+import ru.yandex.practicum.filmorate.dto.UserDto;
 import ru.yandex.practicum.filmorate.exception.*;
+import ru.yandex.practicum.filmorate.mapper.UserMapper;
 import ru.yandex.practicum.filmorate.model.User;
-import ru.yandex.practicum.filmorate.storage.user.UserStorage;
+import ru.yandex.practicum.filmorate.storage.FriendshipStorage;
+import ru.yandex.practicum.filmorate.storage.UserStorage;
 import ru.yandex.practicum.filmorate.utils.UserValidate;
 
 import java.util.*;
-import java.util.stream.Collectors;
 
 @Slf4j
 @Service
@@ -18,134 +22,144 @@ public class UserService {
 
     private final UserStorage userStorage;
     private final UserValidate userValidate;
+    private final FriendshipStorage friendshipStorage;
 
-    public Collection<User> findAll() {
-        return userStorage.findAll();
+    // Получение всех пользователей
+    public Collection<UserDto> findAll() {
+        return userStorage.findAll().stream()
+                .map(UserMapper::mapToDto)
+                .toList();
     }
 
-    public User create(User user) {
-        userValidate.validateUser(user);
-        return userStorage.create(user);
+    // Получение пользователя по id
+    public UserDto getById(Long userId) {
+        return userStorage.findById(userId)
+                .map(UserMapper::mapToDto)
+                .orElseThrow(() -> new NotFoundException("Пользователь не найден"));
     }
 
-    public User update(User user) {
+    // Добавление пользователя
+    public UserDto create(NewUserRequest request) {
+        User user = UserMapper.mapToUser(request);
         userValidate.validateUser(user);
-        return userStorage.update(user);
+
+        User createdUser = userStorage.create(user);
+        return UserMapper.mapToDto(createdUser);
     }
 
-    public void delete(Long id) {
-        userStorage.delete(id);
+    // Обновление пользователя
+    public UserDto update(UpdateUserRequest request) {
+        User user = UserMapper.mapToUser(request);
+        userValidate.validateUser(user);
+
+        User oldUser = userStorage.findById(request.getId())
+                .orElseThrow(() -> {
+                    log.warn("Пользователь с id:{} не найден", request.getId());
+                    return new NotFoundException("Пользователь не найден");
+                });
+        user = UserMapper.updateUserFields(oldUser, request);
+        return UserMapper.mapToDto(userStorage.update(user));
     }
 
-    public User getById(Long id) {
-        return userStorage.getById(id);
+    // Удаление пользователя
+    public void delete(Long userId) {
+        userStorage.delete(userId);
     }
 
     // Метод добавления пользователей в друзья
     public void addFriend(Long userId, Long friendId) {
-        final User user = userStorage.getById(userId);
-        if (user == null) {
-            log.warn("Попытка несуществующего пользователя с Id:{} добавить в друзья пользователей", userId);
-            throw new NotFoundException("Пользователь не найден");
-        }
-
-        final User friend = userStorage.getById(friendId);
-        if (friend == null) {
-            log.warn("Попытка добавить в друзья несуществующего пользователя с Id:{}", friendId);
-            throw new NotFoundException("Пользователь не найден");
-        }
+        final User user = userStorage.findById(userId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка несуществующего пользователя с Id:{} добавить в кого-то в друзья", userId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
+
+        final User friend = userStorage.findById(friendId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка добавить в друзья несуществующего пользователя с Id:{}", friendId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
 
         if (user.equals(friend)) {
             log.warn("Попытка добавить самого себя в друзья");
             throw new DuplicateException("Нельзя добавить самого себя в друзья");
         }
 
-        Set<Long> userFriends = user.getFriends();
-        if (userFriends.contains(friendId)) {
-            log.debug("Пользователь с Id:{} уже добавил в друзья пользователя с Id:{}", userId, friendId);
-            return;
+        if (user.getFriends().contains(friendId)) {
+            log.warn("Попытка пользователя с Id:{} снова добавить в друзья пользователя с Id:{}", userId, friendId);
+            throw new DuplicateException("Пользователь уже отправлял запрос на дружбу");
         }
-
-        userFriends.add(friendId);
-        user.setFriends(userFriends);
+        user.getFriends().add(friendId);
         userStorage.update(user);
 
-        Set<Long> friendFriends = friend.getFriends();
-        friendFriends.add(userId);
-        friend.setFriends(friendFriends);
-        userStorage.update(friend);
+        friendshipStorage.addFriend(userId, friendId);
         log.debug("Пользователи с Id:{} и Id:{} теперь друзья", userId, friendId);
     }
 
     // Метод удаления пользователей из друзей
     public void removeFriend(Long userId, Long friendId) {
-        final User user = userStorage.getById(userId);
-        if (user == null) {
-            log.warn("Попытка несуществующего пользователя с Id:{} удалить кого-то из друзей", userId);
-            throw new NotFoundException("Пользователь не найден");
-        }
-
-        final User friend = userStorage.getById(friendId);
-        if (friend == null) {
-            log.warn("Попытка удалить из друзей несуществующего пользователя с Id:{}", friendId);
-            throw new NotFoundException("Пользователь не найден");
-        }
+        final User user = userStorage.findById(userId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка несуществующего пользователя с Id:{} удалить кого-то из друзей", userId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
+
+        final User friend = userStorage.findById(friendId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка удалить из друзей несуществующего пользователя с Id:{}", friendId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
 
         if (user.equals(friend)) {
             log.warn("При удалении из друзей были переданы одинаковые Id: userId={}, friendId={}", userId, friendId);
             throw new DuplicateException("Нельзя удалить самого себя из друзей");
         }
 
-        Set<Long> userFriends = user.getFriends();
-        if (!userFriends.contains(friendId)) {
-            log.debug("Пользователь с Id:{} не добавлял в друзья пользователя с Id:{}", userId, friendId);
+        if (!user.getFriends().contains(friendId)) {
+            log.warn("Пользователь с Id:{} не добавлял в друзья пользователя с Id:{}", userId, friendId);
             return;
         }
 
-        userFriends.remove(friendId);
-        user.setFriends(userFriends);
+        user.getFriends().remove(friendId);
         userStorage.update(user);
 
-        Set<Long> friendFriends = friend.getFriends();
-        friendFriends.remove(userId);
-        friend.setFriends(friendFriends);
-        userStorage.update(friend);
+        friendshipStorage.removeFriend(userId, friendId);
         log.debug("Пользователи с Id:{} и Id:{} больше не друзья", userId, friendId);
     }
 
     // Метод получения списка всех друзей пользователя
-    public Collection<User> getFriends(Long id) {
-        final User user = userStorage.getById(id);
-
-        if (user == null) {
-            log.warn("Попытка получить друзей несуществующего пользователя c Id:{}", id);
-            throw new NotFoundException("Пользователь не найден");
-        }
+    public Collection<UserDto> findAllFriends(Long userId) {
+        final User user = userStorage.findById(userId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка получить друзей несуществующего пользователя c Id:{}", userId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
 
         // Возвращаем пустую коллекцию, если у пользователя нет друзей
-        if (user.getFriends().isEmpty()) {
-            log.debug("У пользователя с Id:{} нет друзей", id);
+        if (user.getFriends() == null || user.getFriends().isEmpty()) {
+            log.debug("У пользователя с Id:{} нет друзей", userId);
             return Collections.emptyList();
         }
 
-        return user.getFriends().stream()
-                .map(userStorage::getById)
-                .collect(Collectors.toList());
+        return userStorage.findAll().stream()
+                .filter(u -> user.getFriends().contains(u.getId()))
+                .map(UserMapper::mapToDto)
+                .toList();
     }
 
     // Метод получения общих друзей
-    public Collection<User> getCommonFriends(Long userId, Long friendId) {
-        final User user = getById(userId);
-        if (user == null) {
-            log.warn("Попытка получить общих друзей у несуществующего пользователя c Id:{}", userId);
-            throw new NotFoundException("Пользователь не найден");
-        }
-
-        final User friend = getById(friendId);
-        if (friend == null) {
-            log.warn("Попытка получить общих друзей с несуществующим пользователем с Id:{}",friendId);
-            throw new NotFoundException("Пользователь не найден");
-        }
+    public Collection<UserDto> findCommonFriends(Long userId, Long friendId) {
+        final User user = userStorage.findById(userId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка получить общих друзей у несуществующего пользователя c Id:{}", userId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
+
+        final User friend = userStorage.findById(friendId)
+                .orElseThrow(() -> {
+                    log.warn("Попытка получить общих друзей с несуществующим пользователем с Id:{}",friendId);
+                    throw new NotFoundException("Пользователь не найден");
+                });
 
         // Поиск пересечения друзей
         Set<Long> intersection = new HashSet<>(user.getFriends());
@@ -157,6 +171,7 @@ public Collection<User> getCommonFriends(Long userId, Long friendId) {
 
         return userStorage.findAll().stream()
                 .filter(u -> intersection.contains(u.getId()))
+                .map(UserMapper::mapToDto)
                 .toList();
     }
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/film/FilmStorage.java b/src/main/java/ru/yandex/practicum/filmorate/storage/FilmStorage.java
similarity index 51%
rename from src/main/java/ru/yandex/practicum/filmorate/storage/film/FilmStorage.java
rename to src/main/java/ru/yandex/practicum/filmorate/storage/FilmStorage.java
index 51f315e..e5350ef 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/storage/film/FilmStorage.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/storage/FilmStorage.java
@@ -1,18 +1,21 @@
-package ru.yandex.practicum.filmorate.storage.film;
+package ru.yandex.practicum.filmorate.storage;
 
 import ru.yandex.practicum.filmorate.model.Film;
 
 import java.util.Collection;
+import java.util.Optional;
 
 public interface FilmStorage {
 
     Film create(Film film);
 
-    void delete(Long id);
+    void delete(Long filmId);
 
     Film update(Film film);
 
-    Film getById(Long id);
+    Optional<Film> findById(Long filmId);
 
     Collection<Film> findAll();
+
+    Collection<Film> findPopularFilms(int count);
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/FriendshipStorage.java b/src/main/java/ru/yandex/practicum/filmorate/storage/FriendshipStorage.java
new file mode 100644
index 0000000..7c30f84
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/storage/FriendshipStorage.java
@@ -0,0 +1,16 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import ru.yandex.practicum.filmorate.model.User;
+
+import java.util.Collection;
+
+public interface FriendshipStorage {
+
+    void addFriend(Long userId, Long friendId);
+
+    void removeFriend(Long userId, Long friendId);
+
+    Collection<User> findAllFriends(Long userId);
+
+    Collection<User> findCommonFriends(Long userId, Long friendId);
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/GenreStorage.java b/src/main/java/ru/yandex/practicum/filmorate/storage/GenreStorage.java
new file mode 100644
index 0000000..ef6faa9
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/storage/GenreStorage.java
@@ -0,0 +1,17 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import ru.yandex.practicum.filmorate.model.Genre;
+
+import java.util.Collection;
+import java.util.Optional;
+
+public interface GenreStorage {
+
+    Collection<Genre> findAllGenres();
+
+    Optional<Genre> findById(Long genreId);
+
+    Collection<Genre> findGenreForFilm(Long filmId);
+
+    void setGenreForFilm(Long filmId, Collection<Genre> genres);
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/LikesStorage.java b/src/main/java/ru/yandex/practicum/filmorate/storage/LikesStorage.java
new file mode 100644
index 0000000..23cfd82
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/storage/LikesStorage.java
@@ -0,0 +1,14 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import ru.yandex.practicum.filmorate.model.Likes;
+
+import java.util.Collection;
+
+public interface LikesStorage {
+
+    void addLikeToFilm(Long filmId, Long userId);
+
+    void removeLikeFromFilm(Long filmId, Long userId);
+
+    Collection<Likes> getLikesOnFilm(Long filmId);
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/MpaStorage.java b/src/main/java/ru/yandex/practicum/filmorate/storage/MpaStorage.java
new file mode 100644
index 0000000..21efe32
--- /dev/null
+++ b/src/main/java/ru/yandex/practicum/filmorate/storage/MpaStorage.java
@@ -0,0 +1,15 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import ru.yandex.practicum.filmorate.model.Mpa;
+
+import java.util.Collection;
+import java.util.Optional;
+
+public interface MpaStorage {
+
+    Collection<Mpa> findAll();
+
+    Optional<Mpa> findMpaById(Long ratingId);
+
+    Optional<Mpa> findMpaFilm(Long filmId);
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/user/UserStorage.java b/src/main/java/ru/yandex/practicum/filmorate/storage/UserStorage.java
similarity index 58%
rename from src/main/java/ru/yandex/practicum/filmorate/storage/user/UserStorage.java
rename to src/main/java/ru/yandex/practicum/filmorate/storage/UserStorage.java
index 95a43e2..74b5430 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/storage/user/UserStorage.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/storage/UserStorage.java
@@ -1,18 +1,19 @@
-package ru.yandex.practicum.filmorate.storage.user;
+package ru.yandex.practicum.filmorate.storage;
 
 import ru.yandex.practicum.filmorate.model.User;
 
 import java.util.Collection;
+import java.util.Optional;
 
 public interface UserStorage {
 
     User create(User user);
 
-    void delete(Long id);
+    void delete(Long findId);
 
     User update(User user);
 
-    User getById(Long id);
+    Optional<User> findById(Long userId);
 
     Collection<User> findAll();
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/utils/FilmValidate.java b/src/main/java/ru/yandex/practicum/filmorate/utils/FilmValidate.java
index 1155956..ddee851 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/utils/FilmValidate.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/utils/FilmValidate.java
@@ -39,5 +39,10 @@ public static void validateFilm(Film film) {
             log.error("Попытка добавить фильм с некорректной продолжительностью");
             throw new ValidationException("Недопустимая продолжительность фильма");
         }
+
+        if (film.getMpa() == null || film.getMpa().getId() == null) {
+            log.error("Попытка добавить фильм без рейтинга");
+            throw new ValidationException("Mpa-рейтинг фильма не может быть пустым");
+        }
     }
 }
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/utils/UserValidate.java b/src/main/java/ru/yandex/practicum/filmorate/utils/UserValidate.java
index a76a93c..5f2ce5b 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/utils/UserValidate.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/utils/UserValidate.java
@@ -28,6 +28,11 @@ public static void validateUser(User user) {
             throw new ValidationException("Дата рождения не может быть в будущем");
         }
 
+        if (user.getBirthday() == null) {
+            log.error("Попытка ввести пустую дату рождения");
+            throw new ValidationException("Дата рождения не может быть null");
+        }
+
         if (user.getEmail().isEmpty()) {
             log.error("Попытка добавить пустой email");
             throw new ValidationException("email не может быть пустым");
diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties
index 4a23bbc..a91ce0b 100644
--- a/src/main/resources/application.properties
+++ b/src/main/resources/application.properties
@@ -1,2 +1,7 @@
 server.port=8080
-logging.level.org.zalando.logbook=TRACE
\ No newline at end of file
+logging.level.org.zalando.logbook=TRACE
+spring.sql.init.mode=always
+spring.datasource.url=jdbc:h2:file:./db/filmorate;MODE=PostgreSQL
+spring.datasource.driverClassName=org.h2.Driver
+spring.datasource.username=sa
+spring.datasource.password=password
\ No newline at end of file
diff --git a/src/main/resources/data.sql b/src/main/resources/data.sql
new file mode 100644
index 0000000..b121b6a
--- /dev/null
+++ b/src/main/resources/data.sql
@@ -0,0 +1,16 @@
+MERGE INTO genre (genre_id, name)
+VALUES
+  (1, 'Комедия'),
+  (2, 'Драма'),
+  (3, 'Мультфильм'),
+  (4, 'Триллер'),
+  (5, 'Документальный'),
+  (6, 'Боевик');
+
+MERGE INTO mpa_rating (rating_id, name)
+VALUES
+  (1, 'G'),
+  (2, 'PG'),
+  (3, 'PG-13'),
+  (4, 'R'),
+  (5, 'NC-17');
\ No newline at end of file
diff --git a/src/main/resources/schema.sql b/src/main/resources/schema.sql
new file mode 100644
index 0000000..afe2d46
--- /dev/null
+++ b/src/main/resources/schema.sql
@@ -0,0 +1,51 @@
+CREATE TABLE IF NOT EXISTS mpa_rating (
+  rating_id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  name varchar(5) NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS films (
+  film_id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  name varchar(200) NOT NULL,
+  description varchar(200),
+  release_date date NOT NULL,
+  duration bigint NOT NULL,
+  rating_id bigint NOT NULL,
+  FOREIGN KEY (rating_id) REFERENCES mpa_rating (rating_id)
+);
+
+CREATE TABLE IF NOT EXISTS users (
+  user_id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  email varchar NOT NULL,
+  login varchar NOT NULL,
+  name varchar,
+  birthday date NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS likes (
+  film_id bigint,
+  user_id bigint,
+  PRIMARY KEY (film_id, user_id),
+  FOREIGN KEY (film_id) REFERENCES films (film_id) ON DELETE CASCADE,
+  FOREIGN KEY (user_id) REFERENCES users (user_id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS friendship (
+  user_id bigint,
+  friend_id bigint,
+  PRIMARY KEY (user_id, friend_id),
+  FOREIGN KEY (user_id) REFERENCES users (user_id) ON DELETE CASCADE,
+  FOREIGN KEY (friend_id) REFERENCES users (user_id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS genre (
+  genre_id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  name varchar(50) NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS film_genres (
+  film_id bigint,
+  genre_id bigint,
+  PRIMARY KEY (film_id, genre_id),
+  FOREIGN KEY (film_id) REFERENCES films (film_id) ON DELETE CASCADE,
+  FOREIGN KEY (genre_id) REFERENCES genre (genre_id)
+);
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/FilmorateApplicationTests.java b/src/test/java/ru/yandex/practicum/filmorate/FilmorateApplicationTests.java
index be537be..e188d8d 100644
--- a/src/test/java/ru/yandex/practicum/filmorate/FilmorateApplicationTests.java
+++ b/src/test/java/ru/yandex/practicum/filmorate/FilmorateApplicationTests.java
@@ -3,10 +3,10 @@
 import org.junit.jupiter.api.Test;
 import org.springframework.boot.test.context.SpringBootTest;
 
-@SpringBootTest
+@SpringBootTest(classes = FilmorateApplication.class)
 class FilmorateApplicationTests {
 
 	@Test
 	void contextLoads() {
 	}
-}
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/dal/FilmDbStorageTest.java b/src/test/java/ru/yandex/practicum/filmorate/dal/FilmDbStorageTest.java
new file mode 100644
index 0000000..c3dac0c
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/dal/FilmDbStorageTest.java
@@ -0,0 +1,224 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.RequiredArgsConstructor;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
+import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest;
+import org.springframework.context.annotation.Import;
+import org.springframework.jdbc.core.JdbcTemplate;
+import ru.yandex.practicum.filmorate.dal.mappers.*;
+import ru.yandex.practicum.filmorate.model.*;
+
+import java.time.LocalDate;
+import java.util.*;
+import java.util.stream.Collectors;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+@JdbcTest
+@AutoConfigureTestDatabase
+@RequiredArgsConstructor(onConstructor_ = @Autowired)
+@Import({
+        FilmDbStorage.class,
+        GenreDbStorage.class,
+        LikesDbStorage.class,
+        MpaDbStorage.class,
+        FilmRowMapper.class,
+        GenreRowMapper.class,
+        LikesRowMapper.class,
+        MpaRowMapper.class})
+class FilmDbStorageTest {
+
+    private final FilmDbStorage filmDbStorage;
+    private final JdbcTemplate jdbcTemplate;
+    private final LikesDbStorage likesDbStorage;
+
+    @BeforeEach
+    public void beforeEach() {
+        // Очистка данных
+        jdbcTemplate.execute("DELETE FROM film_genres");
+        jdbcTemplate.execute("DELETE FROM likes");
+        jdbcTemplate.execute("DELETE FROM films");
+        jdbcTemplate.execute("DELETE FROM mpa_rating");
+        jdbcTemplate.execute("DELETE FROM genre");
+
+        // Инициализация mpa и жанров для тестов
+        jdbcTemplate.update("INSERT INTO mpa_rating (rating_id, name) VALUES (1, 'G'), (2, 'PG')");
+        jdbcTemplate.update("INSERT INTO genre (genre_id, name) VALUES (1, 'Комедия'), (2, 'Драма')");
+
+        // Создание тестовых пользователей
+        jdbcTemplate.update("INSERT INTO users (user_id, email, login, name, birthday) VALUES " +
+                "(1, 'user@mail.ru', 'login1', 'user_login', '1995-02-13'), " +
+                "(2, 'user@yandex.ru', 'login2', 'user2_login', '1996-02-14')");
+    }
+
+    // Тест создания фильма с валидными данными и получения его по id
+    @Test
+    public void createFilm_withValidFields_return_filmAddedWithGeneratedId() {
+        Film film = createTestFilm("Фильм", "Описание фильма",
+                LocalDate.of(1995, 2, 13), 120, 1L, Set.of(1L));
+
+        // Сохранение фильма в БД и поиск по id
+        Film newFilm = filmDbStorage.create(film);
+        Optional<Film> filmOptional = filmDbStorage.findById(newFilm.getId());
+        assertTrue(filmOptional.isPresent(), "Фильм должен существовать");
+
+        // Получение фильма из Optional
+        Film retrievedFilm = filmOptional.get();
+
+        // Проверка основных полей фильма
+        assertFilmEquals(film, filmOptional.get());
+
+        // Проверка связей фильма и MPA
+        assertNotNull(retrievedFilm.getMpa(), "MPA не должен быть null");
+        assertEquals(1L, retrievedFilm.getMpa().getId(), "id MPA должен совпадать");
+        assertEquals("G", retrievedFilm.getMpa().getName(), "Название MPA должно быть 'G'");
+
+        // Проверка связей фильма и жанров
+        assertNotNull(retrievedFilm.getGenres(), "Жанры не должны быть null");
+        assertEquals(1, retrievedFilm.getGenres().size(), "Должен быть 1 жанр");
+        assertEquals(1L, retrievedFilm.getGenres().iterator().next().getId(),
+                "id жанра должно быть 1");
+    }
+
+    // Тест получения списка всех созданных фильмов
+    @Test
+    public void findAll_afterAddingTwoFilms_returnsCollectionSize2() {
+        Film film = createTestFilm("Фильм", "Описание фильма",
+                LocalDate.of(1995, 2, 13), 120, 1L, Set.of(1L));
+        Film film2 = createTestFilm("Фильм 2", "Описание фильма 2",
+                LocalDate.of(2001, 3, 21), 145, 2L, Set.of(1L, 2L));
+
+        // Сохранение фильмов в БД
+        filmDbStorage.create(film);
+        filmDbStorage.create(film2);
+
+        Collection<Film> films = filmDbStorage.findAll();
+        assertEquals(2, films.size(), "Должны быть найдены 2 фильма");
+    }
+
+    // Тест обновления фильма
+    @Test
+    public void update_existingFilmWithValidData_fieldsUpdated() {
+        Film film = createTestFilm("Фильм", "Описание фильма",
+                LocalDate.of(1995, 2, 13), 120, 1L, Collections.emptySet());
+
+        // Сохранение фильма в БД
+        Film createdFilm = filmDbStorage.create(film);
+
+        // Обновление данных фильма
+        Film updatedFilm = createTestFilm("Фильм 2", "Описание фильма 2",
+                LocalDate.of(2001, 3, 21), 145, 2L, Set.of(1L, 2L));
+        updatedFilm.setId(createdFilm.getId());
+
+        //Обновление фильма в БД и получение его из Optional
+        filmDbStorage.update(updatedFilm);
+        Film retrievedFilm = filmDbStorage.findById(createdFilm.getId()).orElseThrow();
+
+        // Проверка основных полей фильма
+        assertFilmEquals(updatedFilm, retrievedFilm);
+
+        // Проверка связей фильма и MPA
+        assertNotNull(retrievedFilm.getMpa(), "MPA не должен быть null");
+        assertEquals(2L, retrievedFilm.getMpa().getId(), "id MPA должен совпадать");
+        assertEquals("PG", retrievedFilm.getMpa().getName(), "Название MPA должно быть 'PG'");
+
+        // Проверка связей фильма и жанров
+        assertNotNull(retrievedFilm.getGenres(), "Жанры не должны быть null");
+        assertEquals(2, retrievedFilm.getGenres().size(), "Должно быть 2 жанра");
+    }
+
+    // Тест удаления фильма по id
+    @Test
+    public void delete_existingFilm_removesFilm() {
+        Film film = createTestFilm("Фильм", "Описание фильма",
+                LocalDate.of(1995, 2, 13), 120, 1L, Collections.emptySet());
+
+        // Сохранение фильма в БД
+        filmDbStorage.create(film);
+
+        // Удаление фильма
+        filmDbStorage.delete(film.getId());
+        Optional<Film> filmOptional = filmDbStorage.findById(film.getId());
+        assertEquals(Optional.empty(), filmOptional, "Созданный фильм должен быть удален");
+    }
+
+    // Тест на получение списка популярных фильмов
+    @Test
+    public void getPopularFilms_returnsFilmsOrderedByLikes() {
+        Film film1 = createTestFilm("Фильм 1", "Описание 1",
+                LocalDate.of(2000, 1, 1), 100, 1L, Set.of(1L));
+        Film film2 = createTestFilm("Фильм 2", "Описание 2",
+                LocalDate.of(2001, 1, 1), 120, 2L, Set.of(2L));
+
+        // Сохранение фильмов в БД
+        Film createdFilm = filmDbStorage.create(film1);
+        Film createdFilm2 = filmDbStorage.create(film2);
+
+        // Добавление лайков (film2 - 2 лайка, film1 - 0 лайков)
+        likesDbStorage.addLikeToFilm(createdFilm2.getId(), 1L);
+        likesDbStorage.addLikeToFilm(createdFilm2.getId(), 2L);
+        likesDbStorage.addLikeToFilm(createdFilm.getId(), 2L);
+
+        Collection<Film> popularFilms = filmDbStorage.findPopularFilms(2);
+
+        assertNotNull(popularFilms, "Список не должен быть null");
+        assertEquals(2, popularFilms.size(), "Должны вернуться 2 фильма");
+
+        // Преобразование в список для проверки порядка
+        List<Film> filmsList = new ArrayList<>(popularFilms);
+
+        // Проверка порядка сортировки (по убыванию лайков)
+        assertEquals(createdFilm2.getId(), filmsList.get(0).getId(),
+                "Первым должен быть фильм с наибольшим количеством лайков");
+        assertEquals(2, filmsList.get(0).getLikesByUsers().size(),
+                "У первого фильма должно быть 2 лайка");
+
+        assertEquals(createdFilm.getId(), filmsList.get(1).getId(),
+                "Вторым должен быть фильм с меньшим количеством лайков");
+        assertEquals(1, filmsList.get(1).getLikesByUsers().size(),
+                "У второго фильма должен быть 1 лайк");
+    }
+
+    // Вспомогательный метод для создания тестового фильма
+    private Film createTestFilm(
+            String name,
+            String description,
+            LocalDate release_date,
+            int duration,
+            Long mpaId,
+            Set<Long> genresId) {
+        Film film = new Film();
+        film.setName(name);
+        film.setDescription(description);
+        film.setReleaseDate(release_date);
+        film.setDuration(duration);
+
+        Mpa mpa = new Mpa();
+        mpa.setId(mpaId);
+        film.setMpa(mpa);
+
+
+        Set<Genre> genres = genresId.stream()
+                .map(id -> {
+                    Genre g = new Genre();
+                    g.setId(id);
+                    return g;
+                })
+                .collect(Collectors.toSet());
+        film.setGenres(genres);
+
+        return film;
+    }
+
+    // Вспомогательный метод для проверки основных полей фильма
+    private void assertFilmEquals(Film expected, Film actual) {
+        assertEquals(expected.getName(), actual.getName(), "Название фильма должно совпадать");
+        assertEquals(expected.getDescription(), actual.getDescription(), "Описание должно совпадать");
+        assertEquals(expected.getReleaseDate(), actual.getReleaseDate(), "Дата релиза должна совпадать");
+        assertEquals(expected.getDuration(), actual.getDuration(),
+                "Продолжительность фильма должна совпадать");
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorageTest.java b/src/test/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorageTest.java
new file mode 100644
index 0000000..7c19280
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/dal/FriendshipDbStorageTest.java
@@ -0,0 +1,86 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.RequiredArgsConstructor;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
+import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest;
+import org.springframework.context.annotation.Import;
+import org.springframework.jdbc.core.JdbcTemplate;
+import ru.yandex.practicum.filmorate.dal.mappers.FriendshipRowMapper;
+import ru.yandex.practicum.filmorate.dal.mappers.UserRowMapper;
+import ru.yandex.practicum.filmorate.model.User;
+
+import java.util.Collection;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+@JdbcTest
+@AutoConfigureTestDatabase
+@RequiredArgsConstructor(onConstructor_ = @Autowired)
+@Import({FriendshipDbStorage.class, FriendshipRowMapper.class, UserDbStorage.class, UserRowMapper.class})
+public class FriendshipDbStorageTest {
+
+    private final FriendshipDbStorage friendshipDbStorage;
+    private final JdbcTemplate jdbcTemplate;
+
+    @BeforeEach
+    public void beforeEach() {
+        jdbcTemplate.execute("DELETE FROM friendship");
+        jdbcTemplate.execute("DELETE FROM users");
+
+        // Создание тестовых пользователей
+        jdbcTemplate.update("INSERT INTO users (user_id, email, login, name, birthday) VALUES " +
+                "(1, 'user@yandex.ru', 'Mult1k', 'Дмитрий', '1995-02-13'), " +
+                "(2, 'user@gmail.com.ru', 'Friend', 'Саша', '1995-04-24'), " +
+                "(3, 'user@yahoo.com', 'Friend2', 'Ксения', '1996-02-14')");
+    }
+
+    // Тест добавления в друзья и получение списка всех друзей
+    @Test
+    public void addFriend_addFriendship() {
+        // Добавление пользователем user в друзья пользователей friend и friend2
+        friendshipDbStorage.addFriend(1L, 2L);
+        friendshipDbStorage.addFriend(1L, 3L);
+
+        // Получение списка друзей пользователя user
+        Collection<User> friends = friendshipDbStorage.findAllFriends(1L);
+        assertEquals(2, friends.size(), "У пользователя должно быть 2 друга");
+
+        // Получение списка друзей пользователей friend и friend2 - список должен быть пуст, тк дружба односторонняя
+        Collection<User> friendFriends = friendshipDbStorage.findAllFriends(2L);
+        assertEquals(0, friendFriends.size(), "У пользователя friend не должно быть друзей");
+        Collection<User> friendFriends2 = friendshipDbStorage.findAllFriends(3L);
+        assertEquals(0, friendFriends2.size(), "У пользователя friend2 не должно быть друзей");
+    }
+
+    // Тест удаления пользователя из друзей
+    @Test
+    public void delete_existingFriend_removesFriend() {
+        // Добавление пользователем user в друзья пользователя friend
+        friendshipDbStorage.addFriend(1L, 2L);
+
+        // Удаление пользователем user из друзей пользователя friend
+        friendshipDbStorage.removeFriend(1L, 2L);
+
+        // Получение списка друзей пользователя user
+        Collection<User> friends = friendshipDbStorage.findAllFriends(1L);
+        assertTrue(friends.isEmpty(), "У пользователя не должно быть друзей");
+    }
+
+    // Тест получения общего списка друзей
+    @Test
+    public void getCommonFriends_returnsCommonFriends() {
+        // Добавление пользователями с id 1L и 2L в друзья пользователя с id 3L
+        friendshipDbStorage.addFriend(1L, 3L);
+        friendshipDbStorage.addFriend(2L, 3L);
+
+        // Получение списка общего друга(Friend2) у пользователей User и Friend
+        Collection<User> commonFriends = friendshipDbStorage.findCommonFriends(1L, 2L);
+        assertEquals(1, commonFriends.size(),
+                "У пользователей Mult1k и Friend должен быть 1 общий друг");
+        assertFalse(commonFriends.isEmpty(), "Список общих друзей пуст");
+        assertEquals(3L, commonFriends.iterator().next().getId(), "Неверный id общего друга");
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/dal/GenreDbStorageTest.java b/src/test/java/ru/yandex/practicum/filmorate/dal/GenreDbStorageTest.java
new file mode 100644
index 0000000..2ad0e7c
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/dal/GenreDbStorageTest.java
@@ -0,0 +1,87 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.RequiredArgsConstructor;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
+import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest;
+import org.springframework.context.annotation.Import;
+import org.springframework.jdbc.core.JdbcTemplate;
+import ru.yandex.practicum.filmorate.dal.mappers.GenreRowMapper;
+import ru.yandex.practicum.filmorate.model.Genre;
+
+import java.util.*;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+@JdbcTest
+@AutoConfigureTestDatabase
+@RequiredArgsConstructor(onConstructor_ = @Autowired)
+@Import({GenreDbStorage.class, GenreRowMapper.class})
+public class GenreDbStorageTest {
+
+    private final GenreDbStorage genreDbStorage;
+    private final JdbcTemplate jdbcTemplate;
+
+    @BeforeEach
+    public void beforeEach() {
+        jdbcTemplate.execute("DELETE FROM film_genres");
+        jdbcTemplate.execute("DELETE FROM films");
+        // Создание тестового фильма
+        jdbcTemplate.update("INSERT INTO films (" +
+                "film_id, " +
+                "name, " +
+                "description, " +
+                "release_date, " +
+                "duration, " +
+                "rating_id) " +
+                "VALUES (1, 'Тестовый фильм', 'Описание фильма', '2025-07-14', 120, 1)");
+    }
+
+    // Тест получения списка всех жанров из БД
+    @Test
+    public void findAllGenres_returnAllGenresFromDataSql() {
+        Collection<Genre> genres = genreDbStorage.findAllGenres();
+        assertEquals(6, genres.size(), "Должно быть 6 жанров в БД");
+    }
+
+    // Тест получения жанра из БД по id
+    @Test
+    public void findGenreById_returnGenreFromDataSql() {
+        // Получение жанра из Optional
+        Optional<Genre> genre = genreDbStorage.findById(1L);
+        assertTrue(genre.isPresent(), "Жанр с id:1 должен существовать");
+        assertEquals("Комедия", genre.get().getName(), "Жанр с id:1 должен быть комедией");
+    }
+
+    // Тест получения жанров для указанного фильма
+    @Test
+    public void findGenreForFilm_returnGenresForFilm() {
+        // Добавляем жанры для тестового фильма с id:1
+        jdbcTemplate.update("INSERT INTO film_genres (film_id, genre_id) VALUES (1, 1)");
+        jdbcTemplate.update("INSERT INTO film_genres (film_id, genre_id) VALUES (1, 2)");
+
+        Collection<Genre> genres = genreDbStorage.findGenreForFilm(1L);
+        assertEquals(2, genres.size(), "У фильма должно быть 2 жанра");
+        assertTrue(genres.stream().anyMatch(g -> g.getId() == 1L && g.getName().equals("Комедия")),
+                "Должен быть жанр 'Комедия' (id=1)");
+        assertTrue(genres.stream().anyMatch(g -> g.getId() == 2L && g.getName().equals("Драма")),
+                "Должен быть жанр 'Драма' (id=2)");
+    }
+
+    // Тест добавления жанров для фильма
+    @Test
+    public void setGenresFilm_addGenresToFilm() {
+        // Добавляем жанры для тестового фильма с id:1
+        jdbcTemplate.update("INSERT INTO film_genres (film_id, genre_id) VALUES (1, 1)");
+        jdbcTemplate.update("INSERT INTO film_genres (film_id, genre_id) VALUES (1, 2)");
+
+        Collection<Genre> genres = genreDbStorage.findGenreForFilm(1L);
+        assertTrue(genres.stream().anyMatch(g -> g.getId() == 1L && g.getName().equals("Комедия")),
+                "Должен быть жанр 'Комедия' (id=1)");
+        assertTrue(genres.stream().anyMatch(g -> g.getId() == 2L && g.getName().equals("Драма")),
+                "Должен быть жанр 'Драма' (id=2)");
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/dal/LikesDbStorageTest.java b/src/test/java/ru/yandex/practicum/filmorate/dal/LikesDbStorageTest.java
new file mode 100644
index 0000000..3e74a4a
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/dal/LikesDbStorageTest.java
@@ -0,0 +1,79 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.RequiredArgsConstructor;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
+import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest;
+import org.springframework.context.annotation.Import;
+import org.springframework.jdbc.core.JdbcTemplate;
+import ru.yandex.practicum.filmorate.dal.mappers.LikesRowMapper;
+import ru.yandex.practicum.filmorate.model.Likes;
+
+import java.util.Collection;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+@JdbcTest
+@AutoConfigureTestDatabase
+@RequiredArgsConstructor(onConstructor_ = @Autowired)
+@Import({LikesDbStorage.class, LikesRowMapper.class})
+public class LikesDbStorageTest {
+
+    private final LikesDbStorage likesDbStorage;
+    private final JdbcTemplate jdbcTemplate;
+
+    @BeforeEach
+    public void beforeEach() {
+        jdbcTemplate.execute("DELETE FROM likes");
+        jdbcTemplate.execute("DELETE FROM films");
+        jdbcTemplate.execute("DELETE FROM users");
+
+        // Создание тестового фильма
+        jdbcTemplate.update("INSERT INTO films (" +
+                "film_id, " +
+                "name, " +
+                "description, " +
+                "release_date, " +
+                "duration, " +
+                "rating_id) " +
+                "VALUES (1, 'Тестовый фильм', 'Описание фильма', '2025-07-14', 120, 1)");
+
+        // Создание тестовых пользователей
+        jdbcTemplate.update("INSERT INTO users (user_id, email, login, name, birthday) VALUES " +
+                "(1, 'user@yandex.ru', 'Mult1k', 'Дмитрий', '1995-02-13'), " +
+                "(2, 'user@gmail.com.ru', 'Friend', 'Саша', '1995-04-24')");
+    }
+
+    // Тест добавления лайка фильму
+    @Test
+    public void addLike_shouldAddLike() {
+        likesDbStorage.addLikeToFilm(1L, 2L);
+        Collection<Likes> likes = likesDbStorage.getLikesOnFilm(1L);
+        assertEquals(1, likes.size(), "У тестового фильма должен быть 1 лайк");
+    }
+
+    // Тест удаления лайка у фильма
+    @Test
+    public void deleteLike_removesLikeFromFilm() {
+        likesDbStorage.addLikeToFilm(1L, 2L);
+        likesDbStorage.removeLikeFromFilm(1L, 2L);
+        Collection<Likes> likes = likesDbStorage.getLikesOnFilm(1L);
+        assertEquals(0, likes.size(), "У тестового фильма не должно быть лайков");
+    }
+
+    // Тест получения всех лайков у фильма
+    @Test
+    public void getAllLikesFromFilm_returnAllLikesFromFilm() {
+        likesDbStorage.addLikeToFilm(1L, 1L);
+        likesDbStorage.addLikeToFilm(1L, 2L);
+        Collection<Likes> likes = likesDbStorage.getLikesOnFilm(1L);
+        assertEquals(2, likes.size(), "У тестового фильма должно быть 2 лайка");
+        assertTrue(likes.stream().anyMatch(like -> like.getUserId() == 1L),
+                "Должен быть лайк от Дмитрия");
+        assertTrue(likes.stream().anyMatch(like -> like.getUserId() == 2L),
+                "Должен быть лайк от Саши");
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/dal/MpaDbStorageTest.java b/src/test/java/ru/yandex/practicum/filmorate/dal/MpaDbStorageTest.java
new file mode 100644
index 0000000..2c342d0
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/dal/MpaDbStorageTest.java
@@ -0,0 +1,67 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.RequiredArgsConstructor;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
+import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest;
+import org.springframework.context.annotation.Import;
+import org.springframework.jdbc.core.JdbcTemplate;
+import ru.yandex.practicum.filmorate.dal.mappers.MpaRowMapper;
+import ru.yandex.practicum.filmorate.model.Mpa;
+
+import java.util.Collection;
+import java.util.Optional;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+@JdbcTest
+@AutoConfigureTestDatabase
+@RequiredArgsConstructor(onConstructor_ = @Autowired)
+@Import({MpaDbStorage.class, MpaRowMapper.class})
+public class MpaDbStorageTest {
+
+    private final MpaDbStorage mpaDbStorage;
+    private final JdbcTemplate jdbcTemplate;
+
+    @BeforeEach
+    public void beforeEach() {
+        jdbcTemplate.execute("DELETE FROM films");
+        // Создание тестового фильма
+        jdbcTemplate.update("INSERT INTO films (" +
+                "film_id, " +
+                "name, " +
+                "description, " +
+                "release_date, " +
+                "duration, " +
+                "rating_id) " +
+                "VALUES (1, 'Тестовый фильм', 'Описание фильма', '2025-07-14', 120, 5)");
+    }
+
+    // Тест получения всех жанров
+    @Test
+    public void findAllMpa_returnAllMpaFromDataSql() {
+        Collection<Mpa> allMpa = mpaDbStorage.findAll();
+        assertEquals(5, allMpa.size(), "Должно быть 5 MPA-рейтингов в БД");
+    }
+
+    // Тест получения MPA-рейтинга из БД по id
+    @Test
+    public void findMpa_returnMpaFromDataSql() {
+        // Получение MPA-рейтинга из Optional
+        Optional<Mpa> mpa = mpaDbStorage.findMpaById(4L);
+        assertTrue(mpa.isPresent(), "Жанр с id:4 должен существовать");
+        assertEquals("R", mpa.get().getName(), "Жанр с id:4 должен быть R");
+    }
+
+    // Тест получения жанра для указанного фильма
+    @Test
+    public void findMpaForFilm_returnMpaToFilm() {
+        Optional<Mpa> mpaFilm = mpaDbStorage.findMpaFilm(1L);
+        assertTrue(mpaFilm.isPresent(), "Фильм должен иметь рейтинг");
+        assertEquals(5, mpaFilm.get().getId(), "Фильм должен иметь рейтинг с id=5");
+        assertEquals("NC-17", mpaFilm.get().getName(), "Фильм должен иметь рейтинг NC-17");
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/dal/UserDbStorageTest.java b/src/test/java/ru/yandex/practicum/filmorate/dal/UserDbStorageTest.java
new file mode 100644
index 0000000..3bef5bd
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/dal/UserDbStorageTest.java
@@ -0,0 +1,129 @@
+package ru.yandex.practicum.filmorate.dal;
+
+import lombok.RequiredArgsConstructor;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
+import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest;
+import org.springframework.context.annotation.Import;
+import org.springframework.jdbc.core.JdbcTemplate;
+import ru.yandex.practicum.filmorate.dal.mappers.*;
+import ru.yandex.practicum.filmorate.model.User;
+
+import java.time.LocalDate;
+import java.util.Collection;
+import java.util.Optional;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+@JdbcTest
+@AutoConfigureTestDatabase
+@RequiredArgsConstructor(onConstructor_ = @Autowired)
+@Import({UserDbStorage.class, UserRowMapper.class})
+public class UserDbStorageTest {
+
+    private final UserDbStorage userDbStorage;
+    private final JdbcTemplate jdbcTemplate;
+
+    @BeforeEach
+    public void beforeEach() {
+        // Очистка данных
+        jdbcTemplate.execute("DELETE FROM users");
+    }
+
+    // Тест создания пользователя с валидными данными и получения его по id
+    @Test
+    public void createUser_withValidFields_return_userAddedWithGeneratedId() {
+        User user = createUserTest("user@yandex.ru", "Mult1k", "Дмитрий",
+                LocalDate.of(1995, 2, 13));
+
+        // Сохранение пользователя в БД и поиск по id
+        User newUser = userDbStorage.create(user);
+        Optional<User> userOptional = userDbStorage.findById(newUser.getId());
+        assertTrue(userOptional.isPresent(), "Пользователя должен существовать");
+
+        // Получение пользователя из Optional
+        User retrievedUser = userOptional.get();
+
+        // Проверка основных полей пользователя
+        assertUserEquals(user, retrievedUser);
+    }
+
+    // Тест получения списка всех созданных пользователей
+    @Test
+    public void findAll_afterAddingTwoUsers_returnsCollectionSize2() {
+        User user = createUserTest("user@yandex.ru", "Mult1k", "Дмитрий",
+                LocalDate.of(1995, 2, 13));
+        User user2 = createUserTest("user@gmail.com", "Login2", "name",
+                LocalDate.of(1995, 4, 24));
+
+        // Сохранение пользователей в БД
+        userDbStorage.create(user);
+        userDbStorage.create(user2);
+
+        Collection<User> users = userDbStorage.findAll();
+        assertEquals(2, users.size(), "Должно быть найдено 2 пользователя");
+    }
+
+    // Тест обновления пользователя
+    @Test
+    public void update_existingUserWithValidData_fieldsUpdated() {
+        User user = createUserTest("user@yandex.ru", "Mult1k", "Дмитрий",
+                LocalDate.of(1995, 2, 13));
+
+        // Сохранение пользователя в БД
+        User createdUser = userDbStorage.create(user);
+
+        // Обновление данных пользователя
+        User updatedUser = createUserTest("user@gmail.com", "Login2", "name",
+                LocalDate.of(1995, 4, 24));
+        updatedUser.setId(createdUser.getId());
+
+        // Обновление пользователя в БД и получение его из Optional
+        userDbStorage.update(updatedUser);
+        User retrievedUser = userDbStorage.findById(createdUser.getId()).orElseThrow();
+
+        // Проверка основных полей пользователя
+        assertEquals(updatedUser, retrievedUser);
+    }
+
+    // Тест удаления пользователя по id
+    @Test
+    public void delete_existingUser_removesUser() {
+        User user = createUserTest("user@yandex.ru", "Mult1k", "Дмитрий",
+                LocalDate.of(1995, 2, 13));
+
+        // Сохранение пользователя в БД
+        userDbStorage.create(user);
+
+        // Удаление пользователя
+        userDbStorage.delete(user.getId());
+        Optional<User> userOptional = userDbStorage.findById(user.getId());
+        assertEquals(Optional.empty(), userOptional, "Созданный пользователя должен быть удален");
+    }
+
+    // Вспомогательный метод для создания тестового пользователя
+    private User createUserTest(
+            String email,
+            String login,
+            String name,
+            LocalDate birthday
+    ) {
+        User user = new User();
+        user.setEmail(email);
+        user.setLogin(login);
+        user.setName(name);
+        user.setBirthday(birthday);
+        return user;
+    }
+
+    // Вспомогательный метод для проверки основных полей пользователя
+    private void assertUserEquals(User expected, User actual) {
+        assertEquals(expected.getEmail(), actual.getEmail(), "Email должен совпадать");
+        assertEquals(expected.getLogin(), actual.getLogin(), "Логин пользователя должен совпадать");
+        assertEquals(expected.getName(), actual.getName(), "Имя пользователя должно совпадать");
+        assertEquals(expected.getBirthday(), actual.getBirthday(), "Дата рождения должна совпадать");
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/controller/FilmControllerTest.java b/src/test/java/ru/yandex/practicum/filmorate/service/FilmServiceTest.java
similarity index 62%
rename from src/test/java/ru/yandex/practicum/filmorate/controller/FilmControllerTest.java
rename to src/test/java/ru/yandex/practicum/filmorate/service/FilmServiceTest.java
index 2a46821..79c2c05 100644
--- a/src/test/java/ru/yandex/practicum/filmorate/controller/FilmControllerTest.java
+++ b/src/test/java/ru/yandex/practicum/filmorate/service/FilmServiceTest.java
@@ -1,63 +1,93 @@
-package ru.yandex.practicum.filmorate.controller;
+package ru.yandex.practicum.filmorate.service;
 
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
+import ru.yandex.practicum.filmorate.controller.*;
+import ru.yandex.practicum.filmorate.dto.*;
 import ru.yandex.practicum.filmorate.exception.*;
-import ru.yandex.practicum.filmorate.model.Film;
-import ru.yandex.practicum.filmorate.model.User;
-import ru.yandex.practicum.filmorate.service.FilmService;
-import ru.yandex.practicum.filmorate.storage.film.InMemoryFilmStorage;
-import ru.yandex.practicum.filmorate.storage.user.InMemoryUserStorage;
-import ru.yandex.practicum.filmorate.utils.FilmValidate;
+import ru.yandex.practicum.filmorate.model.*;
+import ru.yandex.practicum.filmorate.storage.*;
+import ru.yandex.practicum.filmorate.utils.*;
 
 import java.time.LocalDate;
 import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
 
 import static org.junit.jupiter.api.Assertions.*;
 
-class FilmControllerTest {
+public class FilmServiceTest {
+    private final Map<Long, Film> films = new HashMap<>();
 
     private FilmController filmController;
-    private InMemoryFilmStorage filmStorage;
-    private InMemoryUserStorage userStorage;
+    private FilmTestStorage filmTestStorage;
+    private UserTestStorage userTestStorage;
     private FilmValidate filmValidate;
-
+    private GenreTestStorage genreTestStorage;
+    private MpaTestStorage mpaTestStorage;
+    private LikesTestStorage likesTestStorage;
+    private UserController userController;
+    private UserValidate userValidate;
+    private FriendshipTestStorage friendshipTestStorage;
 
     @BeforeEach
     public void beforeEach() {
-        filmStorage = new InMemoryFilmStorage();
-        userStorage = new InMemoryUserStorage();
+        films.clear();
+
+        filmTestStorage = new FilmTestStorage();
+        userTestStorage = new UserTestStorage();
         filmValidate = new FilmValidate();
+        genreTestStorage = new GenreTestStorage();
+        mpaTestStorage = new MpaTestStorage();
+        likesTestStorage = new LikesTestStorage();
+
         filmController = new FilmController(
-                new FilmService(filmStorage, userStorage, filmValidate)
+                new FilmService(filmTestStorage,
+                        userTestStorage,
+                        filmValidate,
+                        genreTestStorage,
+                        mpaTestStorage,
+                        likesTestStorage)
         );
+
+        userController = new UserController(new UserService(userTestStorage, userValidate, friendshipTestStorage));
     }
 
     // Тест успешного создания фильма с валидными данными
     @Test
     public void create_allRequiredFieldsValid_filmAddedWithGeneratedId() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм 1");
         film.setDescription("Описание фильма");
         film.setReleaseDate(LocalDate.of(1995, 2, 13));
         film.setDuration(120);
 
-        Film createdFilm = filmController.create(film);
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film.setMpa(mpa);
+
+        FilmDto createdFilm = filmController.create(film);
 
         assertNotNull(createdFilm.getId(), "Фильму не был присвоен id");
-        assertEquals(1, filmController.findAll().size(),
+        assertEquals(1, filmTestStorage.findAll().size(),
                 "Неверное количество фильмов после создания");
     }
 
     // Тест граничного условия для даты релиза - релиз раньше 28.12.1895 не допустим
     @Test
     public void create_releaseDateBeforeFirstFilm_throwsValidationException() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм с некорректной датой релиза");
         film.setDescription("Описание фильма");
         film.setReleaseDate(LocalDate.of(1895, 12, 27));
         film.setDuration(120);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film.setMpa(mpa);
+
         assertThrows(ValidationException.class, () -> filmController.create(film),
                 "Ожидалось ValidationException при дате релиза раньше 28.12.1895");
     }
@@ -65,24 +95,34 @@ public void create_releaseDateBeforeFirstFilm_throwsValidationException() {
     // Тест граничного условия для даты релиза - релиз 28.12.1895 должен быть допустим
     @Test
     public void create_releaseDateEqualsFirstFilm_noValidationErrors() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Старый фильм");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(1895, 12, 28));
         film.setDuration(15);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film.setMpa(mpa);
+
         assertDoesNotThrow(() -> filmController.create(film), "Дата релиза 28.12.1895 должна быть допустима");
     }
 
     // Тест добавления фильма без даты релиза - релиз не может быть null
     @Test
     public void create_releaseDateNull_throwsValidationException() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм");
         film.setDescription("Описание");
         film.setReleaseDate(null);
         film.setDuration(15);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film.setMpa(mpa);
+
         assertThrows(NullPointerException.class, () -> filmController.create(film),
                 "Дата релиза не может быть null");
     }
@@ -90,13 +130,18 @@ public void create_releaseDateNull_throwsValidationException() {
     // Тест на обновление несуществующего фильма
     @Test
     public void update_nonExistentFilmId_throwsNotFoundException() {
-        Film film = new Film();
+        UpdateFilmRequest film = new UpdateFilmRequest();
         film.setId(14L);
         film.setName("Фильм");
         film.setDescription("Описание фильма");
         film.setReleaseDate(LocalDate.of(1995, 12, 28));
         film.setDuration(120);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film.setMpa(mpa);
+
         assertThrows(NotFoundException.class, () -> filmController.update(film),
                 "Ожидалось NotFoundException при обновлении несуществующего фильма");
     }
@@ -104,13 +149,18 @@ public void update_nonExistentFilmId_throwsNotFoundException() {
     // Тест проверяет валидацию Id при обновлении - Id не должен быть null
     @Test
     public void update_nullId_throwsValidationException() {
-        Film film = new Film();
+        UpdateFilmRequest film = new UpdateFilmRequest();
         film.setId(null);
         film.setName("Фильма с нулевым id");
         film.setDescription("Описание фильма");
         film.setReleaseDate(LocalDate.of(2025, 1, 14));
         film.setDuration(120);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film.setMpa(mpa);
+
         assertThrows(ValidationException.class, () -> filmController.update(film),
                 "Ожидалось ValidationException при обновлении с null ID");
     }
@@ -119,69 +169,105 @@ public void update_nullId_throwsValidationException() {
     @Test
     public void update_existingFilmWithValidData_fieldsUpdated() {
         // Создание фильма
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Начало");
         film.setDescription("Сон внутри сна");
         film.setReleaseDate(LocalDate.of(2010, 7, 22));
         film.setDuration(148);
-        Film createdFilm = filmController.create(film);
+
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film.setMpa(mpa);
+
+        FilmDto createdFilm = filmController.create(film);
 
         // Обновление фильма
-        Film updatedFilm = new Film();
+        UpdateFilmRequest updatedFilm = new UpdateFilmRequest();
         updatedFilm.setId(createdFilm.getId());
         updatedFilm.setName("Уже не Начало");
         updatedFilm.setDescription("Просто описание");
         updatedFilm.setReleaseDate(LocalDate.of(1996, 1, 1));
         updatedFilm.setDuration(150);
-        Film result = filmController.update(updatedFilm);
+
+        mpa.setId(2L);
+        mpa.setName("PG");
+        updatedFilm.setMpa(mpa);
+
+        FilmDto result = filmController.update(updatedFilm);
 
         assertEquals("Уже не Начало", result.getName(), "Название фильма не обновилось");
         assertEquals("Просто описание", result.getDescription(), "Описание фильма не обновилось");
         assertEquals(150, result.getDuration(), "Продолжительность фильма не обновилась");
+        assertEquals("PG", result.getMpa().getName(), "MPA-рейтинг фильма не обновился");
     }
 
     // Тест на получение списка всех созданных фильмов
     @Test
     public void findAll_afterAddingTwoFilms_returnsCollectionSize2() {
         // Создаем 2 фильма
-        Film film1 = new Film();
+        NewFilmRequest film1 = new NewFilmRequest();
         film1.setName("Брат");
         film1.setDescription("Описание фильма");
         film1.setReleaseDate(LocalDate.of(1997, 12, 12));
         film1.setDuration(100);
-        filmController.create(film1);
 
-        Film film2 = new Film();
+        Mpa mpa = new Mpa();
+        mpa.setId(1L);
+        mpa.setName("G");
+        film1.setMpa(mpa);
+
+        FilmDto createdFilm = filmController.create(film1);
+
+        NewFilmRequest film2 = new NewFilmRequest();
         film2.setName("Брат 2");
         film2.setDescription("Описание продолжения");
         film2.setReleaseDate(LocalDate.of(2000, 5, 11));
         film2.setDuration(127);
-        filmController.create(film2);
+
+        Mpa mpa2 = new Mpa();
+        mpa2.setId(1L);
+        mpa2.setName("G");
+        film2.setMpa(mpa2);
+
+        FilmDto createdFilm2 = filmController.create(film2);
 
         assertEquals(2, filmController.findAll().size(), "Неверное количество фильмов в списке");
+        assertEquals("Брат", createdFilm.getName(), "Название 1-го фильма должно быть Брат");
+        assertEquals("Брат 2", createdFilm2.getName(), "Название 2-го фильма должно быть Брат 2");
     }
 
     // Тест граничного условия для описания - 200 символов должно быть допустимо
     @Test
     public void create_descriptionExactly200Chars_noValidationErrors() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм");
         film.setDescription("A".repeat(200));
         film.setReleaseDate(LocalDate.of(2025, 5, 30));
         film.setDuration(95);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(3L);
+        mpa.setName("PG-13");
+        film.setMpa(mpa);
+
         assertDoesNotThrow(() -> filmController.create(film), "Описание в 200 символов должно быть допустимо");
     }
 
     // Тест граничного условия описания - длина описания не может превышать 200 символов
     @Test
     public void create_description201Chars_throwsValidationException() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм");
         film.setDescription("А".repeat(201));
         film.setReleaseDate(LocalDate.of(1995, 12, 28));
         film.setDuration(120);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(4L);
+        mpa.setName("R");
+        film.setMpa(mpa);
+
         assertThrows(ValidationException.class, () -> filmController.create(film),
                 "Ожидалось ValidationException при описании длиной 201 символ ");
     }
@@ -189,12 +275,17 @@ public void create_description201Chars_throwsValidationException() {
     // Тест граничного условия для продолжительности: минимальная продолжительность (1 минута) должна быть допустима
     @Test
     public void create_durationOne_noValidationErrors() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2025, 5, 30));
         film.setDuration(1);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(4L);
+        mpa.setName("R");
+        film.setMpa(mpa);
+
         assertDoesNotThrow(() -> filmController.create(film),
                 "Продолжительность фильма в 1 минуту должна быть допустима");
     }
@@ -202,12 +293,17 @@ public void create_durationOne_noValidationErrors() {
     // Тест граничного условия для продолжительности - продолжительность должна быть больше 0
     @Test
     public void create_duration0_throwsValidationException() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(1995, 12, 28));
         film.setDuration(0);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(4L);
+        mpa.setName("R");
+        film.setMpa(mpa);
+
         assertThrows(ValidationException.class, () -> filmController.create(film),
                 "Ожидалось ValidationException при продолжительности 0");
     }
@@ -215,12 +311,17 @@ public void create_duration0_throwsValidationException() {
     // Тест граничного условия для продолжительности - продолжительность не может быть меньше 0
     @Test
     public void create_durationNegative_throwsValidationException() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(1995, 12, 28));
         film.setDuration(-1);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
+
         assertThrows(ValidationException.class, () -> filmController.create(film),
                 "Ожидалось ValidationException при отрицательной продолжительности");
     }
@@ -228,12 +329,17 @@ public void create_durationNegative_throwsValidationException() {
     // Тест проверяет валидацию имени фильма - пустая строка недопустима
     @Test
     public void create_EmptyName_throwsValidationException() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2024, 12, 31));
         film.setDuration(160);
 
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
+
         assertThrows(ValidationException.class, () -> filmController.create(film),
                 "Ожидалось ValidationException при пустом имени фильма");
     }
@@ -249,14 +355,19 @@ public void create_nullFilm_throwsValidationException() {
     // Тест успешного удаления фильма по Id
     @Test
     public void delete_existingFilm_removesFilm() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм для удаления");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2025, 6, 14));
         film.setDuration(100);
-        filmController.create(film);
 
-        filmController.delete(film.getId());
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
+
+        FilmDto filmForDelete = filmController.create(film);
+        filmController.delete(filmForDelete.getId());
 
         assertEquals(0, filmController.findAll().size(), "Фильм должен быть удален");
     }
@@ -271,16 +382,21 @@ public void delete_nonExistentFilm_throwsNotFoundException() {
     // Тест получения фильма по Id
     @Test
     public void getById_existingFilm_returnsFilm() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм для поиска");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2025, 6, 14));
         film.setDuration(100);
-        filmController.create(film);
 
-        Film foundFilm = filmController.getById(film.getId());
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
 
-        assertEquals(film, foundFilm, "Найденный фильм должен соответствовать созданному");
+        FilmDto createdFilm = filmController.create(film);
+        FilmDto foundFilm = filmController.getById(createdFilm.getId());
+
+        assertEquals(foundFilm, createdFilm, "Найденный фильм должен соответствовать созданному");
     }
 
     // Тест получения несуществующего фильма по Id
@@ -290,125 +406,165 @@ public void getById_nonExistentFilm_throwsNotFoundException() {
                 "Ожидалось NotFoundException при поиске несуществующего фильма");
     }
 
-    // Тест добавления лайка фильму
+    // Тест добавления лайка
     @Test
     public void addLike_validUserAndFilm_addsLike() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм для лайка");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2025, 6, 14));
         film.setDuration(100);
-        filmController.create(film);
 
-        User user = new User();
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
+
+        FilmDto createdFilm = filmController.create(film);
+
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userStorage.create(user);
 
-        filmController.addLike(film.getId(), user.getId());
+        UserDto createdUser = userController.create(user);
+        filmController.addLike(createdFilm.getId(), createdUser.getId());
 
-        Film updatedFilm = filmController.getById(film.getId());
-        assertTrue(updatedFilm.getLikesByUsers().contains(user.getId()), "Лайк должен быть добавлен");
+        FilmDto updatedFilm = filmController.getById(createdFilm.getId());
+        assertTrue(updatedFilm.getLikesByUsers().contains(createdUser.getId()), "Лайк должен быть добавлен");
     }
 
     //Тест добавления лайка несуществующему фильму
     @Test
     public void addLike_nonExistentFilm_throwsNotFoundException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userStorage.create(user);
 
-        assertThrows(NotFoundException.class, () -> filmController.addLike(999L, user.getId()),
+        UserDto createdUser = userController.create(user);
+
+        assertThrows(NotFoundException.class, () -> filmController.addLike(999L, createdUser.getId()),
                 "Ожидалось NotFoundException при лайке несуществующего фильма");
     }
 
     // Тест добавления лайка от несуществующего пользователя
     @Test
     public void addLike_nonExistentUser_throwsNotFoundException() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм для лайка");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2025, 6, 14));
         film.setDuration(100);
-        filmController.create(film);
 
-        assertThrows(NotFoundException.class, () -> filmController.addLike(film.getId(), 999L),
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
+
+        FilmDto createdFilm = filmController.create(film);
+
+        assertThrows(NotFoundException.class, () -> filmController.addLike(createdFilm.getId(), 999L),
                 "Ожидалось NotFoundException при лайке от несуществующего пользователя");
     }
 
     // Тест успешного удаления лайка
     @Test
     public void removeLike_existingLike_removesLike() {
-        Film film = new Film();
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм для лайка");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2025, 6, 14));
         film.setDuration(100);
-        filmController.create(film);
 
-        User user = new User();
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
+
+        FilmDto createdFilm = filmController.create(film);
+
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userStorage.create(user);
 
-        filmController.addLike(film.getId(), user.getId());
-        filmController.removeLike(film.getId(), user.getId());
+        UserDto createdUser = userController.create(user);
 
-        Film updatedFilm = filmController.getById(film.getId());
-        assertFalse(updatedFilm.getLikesByUsers().contains(user.getId()), "Лайк должен быть удален");
+        filmController.addLike(createdFilm.getId(), createdUser.getId());
+        filmController.removeLike(createdFilm.getId(), createdFilm.getId());
+
+        FilmDto updatedFilm = filmController.getById(createdFilm.getId());
+        assertFalse(updatedFilm.getLikesByUsers().contains(createdUser.getId()), "Лайк должен быть удален");
     }
 
     // Тест получения популярных фильмов
     @Test
     public void getPopularFilms_returnsFilmsOrderedByLikes() {
-        Film film = new Film();
+        // Создаем 3 фильма
+        NewFilmRequest film = new NewFilmRequest();
         film.setName("Фильм для 2 лайков");
         film.setDescription("Описание");
         film.setReleaseDate(LocalDate.of(2025, 6, 14));
         film.setDuration(100);
-        filmController.create(film);
 
-        Film film2 = new Film();
+        Mpa mpa = new Mpa();
+        mpa.setId(5L);
+        mpa.setName("NC-17");
+        film.setMpa(mpa);
+
+        FilmDto createdFilm1 = filmController.create(film);
+
+        NewFilmRequest film2 = new NewFilmRequest();
         film2.setName("Фильм для 1 лайка");
         film2.setDescription("Описание");
         film2.setReleaseDate(LocalDate.of(2025, 6, 14));
         film2.setDuration(120);
-        filmController.create(film2);
 
-        Film film3 = new Film();
+        Mpa mpa2 = new Mpa();
+        mpa2.setId(1L);
+        mpa2.setName("G");
+        film2.setMpa(mpa2);
+
+        FilmDto createdFilm2 = filmController.create(film2);
+
+        NewFilmRequest film3 = new NewFilmRequest();
         film3.setName("Фильм без лайков");
         film3.setDescription("Описание");
         film3.setReleaseDate(LocalDate.of(2025, 5, 14));
         film3.setDuration(70);
-        filmController.create(film3);
 
-        User user = new User();
+        Mpa mpa3 = new Mpa();
+        mpa3.setId(4L);
+        mpa3.setName("R");
+        film3.setMpa(mpa3);
+
+        FilmDto createdFilm3 = filmController.create(film3);
+
+        // Создаем 2 пользователей
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userStorage.create(user);
+        UserDto createdUser = userController.create(user);
 
-        User user2 = new User();
+        NewUserRequest user2 = new NewUserRequest();
         user2.setEmail("user@yandex.ru");
         user2.setLogin("user2_login");
         user2.setBirthday(LocalDate.of(1996, 2, 14));
-        userStorage.create(user2);
+        UserDto createdUser2 = userController.create(user2);
 
-        // film получает 2 лайка
-        filmController.addLike(film.getId(), user.getId());
-        filmController.addLike(film.getId(), user2.getId());
+        // createdFilm1 получает 2 лайка
+        filmController.addLike(createdFilm1.getId(), createdUser.getId());
+        filmController.addLike(createdFilm1.getId(), createdUser2.getId());
 
-        // film2 получает 1 лайк
-        filmController.addLike(film2.getId(), user2.getId());
+        // createdFilm2 получает 1 лайк
+        filmController.addLike(createdFilm2.getId(), createdUser2.getId());
 
-        Collection<Film> popularFilms = filmController.getPopularFilms(2);
+        Collection<FilmDto> popularFilms = filmController.getPopularFilms(2);
 
         assertEquals(2, popularFilms.size(), "Должны вернуться 2 фильма");
-        assertEquals(film.getId(), popularFilms.iterator().next().getId(),
+        assertEquals(createdFilm1.getId(), popularFilms.iterator().next().getId(),
                 "Первый фильм должен быть самым популярным");
     }
 }
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/controller/UserControllerTest.java b/src/test/java/ru/yandex/practicum/filmorate/service/UserServiceTest.java
similarity index 61%
rename from src/test/java/ru/yandex/practicum/filmorate/controller/UserControllerTest.java
rename to src/test/java/ru/yandex/practicum/filmorate/service/UserServiceTest.java
index ae1ae21..853d5e4 100644
--- a/src/test/java/ru/yandex/practicum/filmorate/controller/UserControllerTest.java
+++ b/src/test/java/ru/yandex/practicum/filmorate/service/UserServiceTest.java
@@ -1,42 +1,51 @@
-package ru.yandex.practicum.filmorate.controller;
+package ru.yandex.practicum.filmorate.service;
 
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
+import ru.yandex.practicum.filmorate.controller.UserController;
+import ru.yandex.practicum.filmorate.dto.*;
 import ru.yandex.practicum.filmorate.exception.*;
 import ru.yandex.practicum.filmorate.model.User;
-import ru.yandex.practicum.filmorate.service.UserService;
-import ru.yandex.practicum.filmorate.storage.user.InMemoryUserStorage;
+import ru.yandex.practicum.filmorate.storage.FriendshipTestStorage;
+import ru.yandex.practicum.filmorate.storage.UserTestStorage;
 import ru.yandex.practicum.filmorate.utils.UserValidate;
 
 import java.time.LocalDate;
 import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
 
 import static org.junit.jupiter.api.Assertions.*;
 
-class UserControllerTest {
+public class UserServiceTest {
+
+    private final Map<Long, User> users = new HashMap<>();
 
     private UserController userController;
-    private InMemoryUserStorage userStorage;
+    private UserTestStorage userTestStorage;
     private UserValidate userValidate;
+    private FriendshipTestStorage friendshipTestStorage;
 
     @BeforeEach
     public void beforeEach() {
-        userStorage = new InMemoryUserStorage();
+        users.clear();
+
+        userTestStorage = new UserTestStorage();
         userValidate = new UserValidate();
-        userController = new UserController(
-                new UserService(userStorage, userValidate)
-        );
+        friendshipTestStorage = new FriendshipTestStorage();
+
+        userController = new UserController(new UserService(userTestStorage, userValidate, friendshipTestStorage));
     }
 
     // Тест успешного создания пользователя с валидными данными
     @Test
     public void create_allRequiredFieldsValid_userAddedWithGeneratedId() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
 
-        User createdUser = userController.create(user);
+        UserDto createdUser = userController.create(user);
 
         assertNotNull(createdUser.getId(), "Пользователю не был присвоен id");
         assertEquals(1, userController.findAll().size(),
@@ -46,13 +55,13 @@ public void create_allRequiredFieldsValid_userAddedWithGeneratedId() {
     // Тест создания пользователя с пустым именем (должно подставляться значение login)
     @Test
     public void create_emptyName_nameEqualsLogin() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setName("");
         user.setBirthday(LocalDate.of(1995, 2, 13));
 
-        User createdUser = userController.create(user);
+        UserDto createdUser = userController.create(user);
 
         assertEquals("user_login", createdUser.getName(),
                 "При пустом имени должно подставляться значение login");
@@ -61,13 +70,13 @@ public void create_emptyName_nameEqualsLogin() {
     // Тест создания пользователя с null именем (должно подставляться значение login)
     @Test
     public void create_nullName_nameEqualsLogin() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setName(null);
         user.setBirthday(LocalDate.of(1995, 2, 13));
 
-        User createdUser = userController.create(user);
+        UserDto createdUser = userController.create(user);
 
         assertEquals("user_login", createdUser.getName(),
                 "При null имени должно подставляться значение login");
@@ -76,7 +85,7 @@ public void create_nullName_nameEqualsLogin() {
     // Тест валидации email - не может быть пустым
     @Test
     public void create_emptyEmail_throwsValidationException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("");
         user.setLogin("login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
@@ -88,7 +97,7 @@ public void create_emptyEmail_throwsValidationException() {
     // Тест валидации email - должен быть корректным форматом
     @Test
     public void create_invalidEmailFormat_throwsValidationException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("invalid-email");
         user.setLogin("login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
@@ -100,13 +109,13 @@ public void create_invalidEmailFormat_throwsValidationException() {
     // Тест уникальности email - нельзя создать пользователя с существующим email
     @Test
     public void create_duplicateEmail_throwsDuplicateException() {
-        User user1 = new User();
+        NewUserRequest user1 = new NewUserRequest();
         user1.setEmail("user@mail.ru");
         user1.setLogin("login1");
         user1.setBirthday(LocalDate.of(1996, 2, 14));
         userController.create(user1);
 
-        User user2 = new User();
+        NewUserRequest user2 = new NewUserRequest();
         user2.setEmail("user@mail.ru");
         user2.setLogin("login2");
         user2.setBirthday(LocalDate.of(1995, 2, 13));
@@ -118,7 +127,7 @@ public void create_duplicateEmail_throwsDuplicateException() {
     // Тест добавления пользователя с email, равным null
     @Test
     public void create_nullEmail_throwsValidationException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail(null);
         user.setLogin("login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
@@ -130,7 +139,7 @@ public void create_nullEmail_throwsValidationException() {
     // Тест валидации логина - не может быть пустым
     @Test
     public void create_emptyLogin_throwsValidationException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("");
         user.setBirthday(LocalDate.of(1995, 2, 13));
@@ -142,7 +151,7 @@ public void create_emptyLogin_throwsValidationException() {
     // Тест валидации логина - не может содержать пробелов
     @Test
     public void create_loginWithSpaces_throwsValidationException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("login with spaces");
         user.setBirthday(LocalDate.of(1995, 2, 13));
@@ -154,7 +163,7 @@ public void create_loginWithSpaces_throwsValidationException() {
     // Тест валидации даты рождения - не может быть в будущем
     @Test
     public void create_birthdayInFuture_throwsValidationException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("login");
         user.setBirthday(LocalDate.now().plusDays(1));
@@ -166,7 +175,7 @@ public void create_birthdayInFuture_throwsValidationException() {
     // Тест обновления несуществующего пользователя
     @Test
     public void update_nonExistentUserId_throwsNotFoundException() {
-        User user = new User();
+        UpdateUserRequest user = new UpdateUserRequest();
         user.setId(999L);
         user.setEmail("user@mail.ru");
         user.setLogin("login");
@@ -180,19 +189,19 @@ public void update_nonExistentUserId_throwsNotFoundException() {
     @Test
     public void update_existingUserWithValidData_fieldsUpdated() {
         // Создание пользователя
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        User createdUser = userController.create(user);
+        UserDto createdUser = userController.create(user);
 
         // Обновление пользователя
-        User updatedUser = new User();
+        UpdateUserRequest updatedUser = new UpdateUserRequest();
         updatedUser.setId(createdUser.getId());
         updatedUser.setEmail("new@mail.ru");
         updatedUser.setLogin("new_login");
         updatedUser.setBirthday(LocalDate.of(1995, 2, 13));
-        User result = userController.update(updatedUser);
+        UserDto result = userController.update(updatedUser);
 
         assertEquals("new@mail.ru", result.getEmail(), "Email не обновился");
         assertEquals("new_login", result.getLogin(), "Логин не обновился");
@@ -203,20 +212,24 @@ public void update_existingUserWithValidData_fieldsUpdated() {
     // Тест получения списка всех пользователей
     @Test
     public void findAll_afterAddingTwoUsers_returnsCollectionSize2() {
-        User user1 = new User();
+        NewUserRequest user1 = new NewUserRequest();
         user1.setEmail("user1@mail.ru");
         user1.setLogin("login1");
         user1.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user1);
+        UserDto createdUser = userController.create(user1);
 
-        User user2 = new User();
+        NewUserRequest user2 = new NewUserRequest();
         user2.setEmail("user2@mail.ru");
         user2.setLogin("login2");
         user2.setBirthday(LocalDate.of(1996, 2, 14));
-        userController.create(user2);
+        UserDto createdUser2 = userController.create(user2);
 
         assertEquals(2, userController.findAll().size(),
                 "Неверное количество пользователей в списке");
+        assertEquals("login1", createdUser.getLogin(),
+                "Логин 1-го пользователя должен быть login1");
+        assertEquals("login2", createdUser2.getLogin(),
+                "Логин 2-го пользователя должен быть login2");
     }
 
     // Тест проверяет невозможность добавить пользователя равного null
@@ -230,13 +243,14 @@ public void create_nullUser_throwsValidationException() {
     // Тест успешного удаления пользователя
     @Test
     public void delete_existingUser_removesUser() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
 
-        userController.delete(user.getId());
+        UserDto userForDelete = userController.create(user);
+        userController.delete(userForDelete.getId());
+
         assertEquals(0, userController.findAll().size(), "Пользователь должен быть удален");
     }
 
@@ -250,15 +264,15 @@ public void delete_nonExistentUser_throwsNotFoundException() {
     // Тест получения пользователя по Id
     @Test
     public void getById_existingUser_returnsFilm() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
 
-        User foundUser = userController.getById(user.getId());
+        UserDto createdUser = userController.create(user);
+        UserDto foundUser = userController.getById(createdUser.getId());
 
-        assertEquals(user, foundUser, "Найденный пользователь должен соответствовать созданному");
+        assertEquals(foundUser, createdUser, "Найденный пользователь должен соответствовать созданному");
     }
 
     // Тест получения несуществующего пользователя
@@ -268,146 +282,156 @@ public void getById_nonExistentUser_throwsNotFoundException() {
                 "Ожидалось NotFoundException при поиске несуществующего пользователя");
     }
 
-    // Тест добавления в друзья
+    // Тест успешного добавления в друзья
     @Test
     public void addFriend_validUserAndFriend() {
-        User user = new User();
+        // Создаем основного пользователя
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
+        UserDto createdUser = userController.create(user);
 
-        User friend = new User();
+        // Создаем друга
+        NewUserRequest friend = new NewUserRequest();
         friend.setEmail("user@yandex.ru");
         friend.setLogin("friend_login");
         friend.setBirthday(LocalDate.of(1996, 2, 14));
-        userController.create(friend);
-
-        userController.addFriend(user.getId(), friend.getId());
-
-        User updatedUser = userController.getById(user.getId());
-        User updatedFriend = userController.getById(friend.getId());
-        assertAll(
-                () -> assertTrue(updatedUser.getFriends().contains(friend.getId()),
-                        "Друг должен быть в списке пользователя"),
-                () -> assertTrue(updatedFriend.getFriends().contains(user.getId()),
-                        "Пользователь должен быть в списке друга"),
-                () -> assertEquals(1, updatedUser.getFriends().size(),
-                        "Должен быть ровно один друг"),
-                () -> assertEquals(1, updatedFriend.getFriends().size(),
-                        "Должен быть ровно один друг")
-        );
+        UserDto userForFriend = userController.create(friend);
+
+        userController.addFriend(createdUser.getId(), userForFriend.getId());
+        UserDto updatedUser = userController.getById(createdUser.getId());
+
+        assertTrue(updatedUser.getFriends().contains(userForFriend.getId()),
+                "Друг должен быть в списке пользователя");
+        assertEquals(1, updatedUser.getFriends().size(),
+                "У пользователя должен быть ровно один друг");
+    }
+
+    // Тест, что дружба является односторонней
+    @Test
+    public void addFriend_shouldCreateOneSidedFriendship() {
+        // Создаем основного пользователя
+        NewUserRequest user = new NewUserRequest();
+        user.setEmail("user@mail.ru");
+        user.setLogin("user_login");
+        user.setBirthday(LocalDate.of(1995, 2, 13));
+        UserDto createdUser = userController.create(user);
+
+        // Создаем друга
+        NewUserRequest friend = new NewUserRequest();
+        friend.setEmail("user@yandex.ru");
+        friend.setLogin("friend_login");
+        friend.setBirthday(LocalDate.of(1996, 2, 14));
+        UserDto userForFriend = userController.create(friend);
+
+        userController.addFriend(createdUser.getId(), userForFriend.getId());
+        UserDto updatedUser = userController.getById(createdUser.getId());
+        UserDto updatedFriend = userController.getById(userForFriend.getId());
+
+        // Проверка, что у пользователя появился друг
+        assertTrue(updatedUser.getFriends().contains(userForFriend.getId()),
+                "Друг должен быть в списке друзей пользователя");
+
+        // Проверка, что у друга нет пользователя в друзьях
+        assertFalse(updatedFriend.getFriends().contains(createdUser.getId()),
+                "У друга не должно быть пользователя в друзьях");
+        assertEquals(0, updatedFriend.getFriends().size(),
+                "У друга не должно быть друзей");
     }
 
     // Тест на добавление несуществующего друга
     @Test
     public void addFriend_nonExistentFriend_throwsNotFounderException() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
+        UserDto createdUser = userController.create(user);
 
-        assertThrows(NotFoundException.class, () -> userController.addFriend(user.getId(), 999L),
+        assertThrows(NotFoundException.class, () -> userController.addFriend(createdUser.getId(), 999L),
                 "Ожидалось NotFoundException при добавлении в друзья несуществующего пользователя");
     }
 
     // Тест успешного удаления друга
     @Test
     public void deleteFriend_existingFriend_removesFriend() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
+        UserDto createdUser = userController.create(user);
 
-        User friend = new User();
+        NewUserRequest friend = new NewUserRequest();
         friend.setEmail("user@yandex.ru");
         friend.setLogin("friend_login");
         friend.setBirthday(LocalDate.of(1996, 2, 14));
-        userController.create(friend);
-
-        // добавляем друга и проверяем, что дружба взаимна у двух пользователей
-        userController.addFriend(user.getId(), friend.getId());
-        User updatedUser = userController.getById(user.getId());
-        User updatedFriend = userController.getById(friend.getId());
-
-        assertAll(
-                () -> assertTrue(updatedUser.getFriends().contains(friend.getId()),
-                        "Друг должен быть в списке пользователя"),
-                () -> assertTrue(updatedFriend.getFriends().contains(user.getId()),
-                        "Пользователь должен быть в списке друга"),
-                () -> assertEquals(1, updatedUser.getFriends().size(),
-                        "Должен быть ровно один друг"),
-                () -> assertEquals(1, updatedFriend.getFriends().size(),
-                        "Должен быть ровно один друг")
-        );
+        UserDto friendForDelete = userController.create(friend);
 
-        // удаляем друга
-        userController.removeFriend(updatedUser.getId(), updatedFriend.getId());
-        // Получаем обновленные данные
-        User userAfterRemove = userController.getById(user.getId());
-        User friendAfterRemove = userController.getById(friend.getId());
+        // добавляем друга и проверяем, что у пользователя появился друг
+        userController.addFriend(createdUser.getId(), friendForDelete.getId());
+        UserDto userWithFriend = userController.getById(createdUser.getId());
+
+        assertTrue(userWithFriend.getFriends().contains(friendForDelete.getId()),
+                "Друг должен быть в списке друзей пользователя");
+
+        // удаляем друга и получаем обновленные данные
+        userController.removeFriend(createdUser.getId(), friendForDelete.getId());
+        UserDto userAfterRemove = userController.getById(createdUser.getId());
 
         // проверяем, что дружба удалилась у обоих
-        assertAll(
-                () -> assertFalse(userAfterRemove.getFriends().contains(friend.getId()),
-                        "Друг должен быть удален из списка пользователя"),
-                () -> assertFalse(friendAfterRemove.getFriends().contains(user.getId()),
-                        "Пользователь должен быть удален из списка друга"),
-                () -> assertEquals(0, userAfterRemove.getFriends().size(),
-                        "Список друзей пользователя должен быть пустым"),
-                () -> assertEquals(0, friendAfterRemove.getFriends().size(),
-                        "Список друзей друга должен быть пустым")
-        );
+        assertFalse(userAfterRemove.getFriends().contains(friendForDelete.getId()),
+                "Друг должен быть удален из списка пользователя");
+        assertEquals(0, userAfterRemove.getFriends().size(),
+                "Список друзей пользователя должен быть пустым");
     }
 
     // Тест на получение всех друзей
     @Test
     public void getFriends_returnsAllFriends() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
+        UserDto createdUser = userController.create(user);
 
-        User friend = new User();
+        NewUserRequest friend = new NewUserRequest();
         friend.setEmail("user@yandex.ru");
         friend.setLogin("friend_login");
         friend.setBirthday(LocalDate.of(1996, 2, 14));
-        userController.create(friend);
+        UserDto userForFriend = userController.create(friend);
 
-        User friend2 = new User();
+        NewUserRequest friend2 = new NewUserRequest();
         friend2.setEmail("friend@gmail.com");
         friend2.setLogin("Mult1k3");
         friend2.setBirthday(LocalDate.of(1988, 2, 28));
-        userController.create(friend2);
+        UserDto userForFriend2 = userController.create(friend2);
 
         // добавляем пользователей в друзья
-        userController.addFriend(user.getId(), friend.getId());
-        userController.addFriend(user.getId(), friend2.getId());
-        User updatedUser = userController.getById(user.getId());
+        userController.addFriend(createdUser.getId(), userForFriend.getId());
+        userController.addFriend(createdUser.getId(), userForFriend2.getId());
+        UserDto updatedUser = userController.getById(createdUser.getId());
 
         // Получаем список друзей
-        Collection<User> friends = userController.getFriends(updatedUser.getId());
+        Collection<UserDto> friends = userController.getFriends(updatedUser.getId());
 
         assertEquals(2, friends.size(), "Должно быть 2 друга");
-        assertTrue(friends.stream().anyMatch(f -> f.getId().equals(friend.getId())),
+        assertTrue(friends.stream().anyMatch(f -> f.getId().equals(userForFriend.getId())),
                 "Друг 1 должен быть в списке");
-        assertTrue(friends.stream().anyMatch(f -> f.getId().equals(friend2.getId())),
+        assertTrue(friends.stream().anyMatch(f -> f.getId().equals(userForFriend2.getId())),
                 "Друг 2 должен быть в списке");
     }
 
     // Тест на получение пустого списка, если у пользователя нет друзей
     @Test
     public void getFriends_userWithNoFriends_returnsEmptyList() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
+        UserDto createdUser = userController.create(user);
 
-        Collection<User> friends = userController.getFriends(user.getId());
+        Collection<UserDto> friends = userController.getFriends(createdUser.getId());
 
         assertTrue(friends.isEmpty(), "Список друзей должен быть пустым");
     }
@@ -415,34 +439,34 @@ public void getFriends_userWithNoFriends_returnsEmptyList() {
     // Тест на получение списка общих друзей у двух пользователей
     @Test
     public void getCommonFriends_returnsCommonFriends() {
-        User user = new User();
+        NewUserRequest user = new NewUserRequest();
         user.setEmail("user@mail.ru");
         user.setLogin("user_login");
         user.setBirthday(LocalDate.of(1995, 2, 13));
-        userController.create(user);
+        UserDto createdUser = userController.create(user);
 
-        User user2 = new User();
+        NewUserRequest user2 = new NewUserRequest();
         user2.setEmail("user@yandex.ru");
         user2.setLogin("friend_login");
         user2.setBirthday(LocalDate.of(1996, 2, 14));
-        userController.create(user2);
+        UserDto createdUser2 = userController.create(user2);
 
-        User commonFriend = new User();
-        commonFriend.setEmail("friend@gmail.com");
-        commonFriend.setLogin("Mult1k3");
-        commonFriend.setBirthday(LocalDate.of(1988, 2, 28));
-        userController.create(commonFriend);
+        NewUserRequest request = new NewUserRequest();
+        request.setEmail("friend@gmail.com");
+        request.setLogin("Mult1k3");
+        request.setBirthday(LocalDate.of(1988, 2, 28));
+        UserDto commonFriend = userController.create(request);
 
         // добавляем общего друга
-        userController.addFriend(user.getId(), commonFriend.getId());
-        userController.addFriend(user2.getId(), commonFriend.getId());
+        userController.addFriend(createdUser.getId(), commonFriend.getId());
+        userController.addFriend(createdUser2.getId(), commonFriend.getId());
 
         // обновляем данные
-        User updatedUser = userController.getById(user.getId());
-        User updatedUser2 = userController.getById(user2.getId());
+        UserDto updatedUser = userController.getById(createdUser.getId());
+        UserDto updatedUser2 = userController.getById(createdUser2.getId());
 
         // Проверяем общих друзей
-        Collection<User> commonFriends = userController.getCommonFriends(
+        Collection<UserDto> commonFriends = userController.getCommonFriends(
                 updatedUser.getId(),
                 updatedUser2.getId()
         );
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/film/InMemoryFilmStorage.java b/src/test/java/ru/yandex/practicum/filmorate/storage/FilmTestStorage.java
similarity index 72%
rename from src/main/java/ru/yandex/practicum/filmorate/storage/film/InMemoryFilmStorage.java
rename to src/test/java/ru/yandex/practicum/filmorate/storage/FilmTestStorage.java
index 6ad50a0..9138ec9 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/storage/film/InMemoryFilmStorage.java
+++ b/src/test/java/ru/yandex/practicum/filmorate/storage/FilmTestStorage.java
@@ -1,25 +1,31 @@
-package ru.yandex.practicum.filmorate.storage.film;
+package ru.yandex.practicum.filmorate.storage;
 
 import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Component;
+import org.springframework.context.annotation.Primary;
+import org.springframework.stereotype.Repository;
 import ru.yandex.practicum.filmorate.exception.*;
 import ru.yandex.practicum.filmorate.model.Film;
 
 import java.util.*;
+import java.util.stream.Collectors;
 
 import static ru.yandex.practicum.filmorate.utils.ControllersUtils.getNextId;
 
+/**
+ * Утилитарный класс - тестовое хранилище для Film
+ */
+
 @Slf4j
-@Component
-public class InMemoryFilmStorage implements FilmStorage {
+@Repository
+@Primary
+public class FilmTestStorage implements FilmStorage {
 
     private final Map<Long, Film> films = new HashMap<>();
     private final Set<String> filmNames = new HashSet<>();
 
-    // Добавление фильма
+    // Создание фильма
     @Override
     public Film create(Film film) {
-
         checkFilmNamesUniqueness(film.getName());
         filmNames.add(film.getName().toLowerCase());
         film.setId(getNextId(films.keySet()));
@@ -32,12 +38,11 @@ public Film create(Film film) {
     @Override
     public void delete(Long id) {
         validateFilmId(id);
-
         filmNames.remove(films.get(id).getName().toLowerCase());
         films.remove(id);
     }
 
-    // Изменение фильма
+    // Обновление фильма
     @Override
     public Film update(Film film) {
         validateFilmId(film.getId());
@@ -59,15 +64,25 @@ public Film update(Film film) {
 
     // Получение фильма по id
     @Override
-    public Film getById(Long id) {
+    public Optional<Film> findById(Long id) {
         validateFilmId(id);
-        return films.get(id);
+        return Optional.ofNullable(films.get(id));
     }
 
     // Получение всех фильмов
     @Override
     public Collection<Film> findAll() {
-        return List.copyOf(films.values());
+        return films.values();
+    }
+
+    // Получения списка популярных фильмов
+    @Override
+    public Collection<Film> findPopularFilms(int count) {
+        return films.values().stream()
+                .sorted((f1, f2) -> Integer.compare(f2.getLikesByUsers().size(),
+                        f1.getLikesByUsers().size()))
+                .limit(count)
+                .collect(Collectors.toList());
     }
 
     // Вспомогательный метод для проверки на наличие дубликата названия фильма
diff --git a/src/test/java/ru/yandex/practicum/filmorate/storage/FriendshipTestStorage.java b/src/test/java/ru/yandex/practicum/filmorate/storage/FriendshipTestStorage.java
new file mode 100644
index 0000000..e3e774e
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/storage/FriendshipTestStorage.java
@@ -0,0 +1,68 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.context.annotation.Primary;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.User;
+
+import java.util.*;
+
+/**
+ * Утилитарный класс - тестовое хранилище Friendship
+ */
+
+@Slf4j
+@Repository
+@Primary
+public class FriendshipTestStorage implements FriendshipStorage {
+
+    private final Map<Long, Set<Long>> friendships = new HashMap<>();
+    private UserTestStorage userTestStorage;
+
+    @Override
+    public void addFriend(Long userId, Long friendId) {
+        if (!friendships.containsKey(userId)) {
+            friendships.put(userId, new HashSet<>());
+        }
+        friendships.get(userId).add(friendId);
+    }
+
+    @Override
+    public void removeFriend(Long userId, Long friendId) {
+        // Получаем множество друзей пользователя
+        Set<Long> userFriends = friendships.get(userId);
+
+        // Если множество существует — удаляем друга
+        if (userFriends != null) {
+            userFriends.remove(friendId);
+        }
+    }
+
+    @Override
+    public Collection<User> findAllFriends(Long userId) {
+        Set<Long> friendIds = friendships.getOrDefault(userId, Set.of());
+        List<User> friends = new ArrayList<>();
+
+        for (Long friendId : friendIds) {
+            userTestStorage.findById(friendId).ifPresent(friends::add);
+        }
+
+        return friends;
+    }
+
+    @Override
+    public Collection<User> findCommonFriends(Long userId, Long otherId) {
+        Set<Long> userFriends = friendships.getOrDefault(userId, Set.of());
+        Set<Long> otherFriends = friendships.getOrDefault(otherId, Set.of());
+        List<User> commonFriends = new ArrayList<>();
+
+        // Пересечение множеств
+        for (Long friendId : userFriends) {
+            if (otherFriends.contains(friendId)) {
+                userTestStorage.findById(friendId).ifPresent(commonFriends::add);
+            }
+        }
+
+        return commonFriends;
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/storage/GenreTestStorage.java b/src/test/java/ru/yandex/practicum/filmorate/storage/GenreTestStorage.java
new file mode 100644
index 0000000..30fff9d
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/storage/GenreTestStorage.java
@@ -0,0 +1,60 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.context.annotation.Primary;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.Genre;
+
+import java.util.*;
+import java.util.stream.Collectors;
+
+/**
+ * Утилитарный класс - тестовое хранилище Genre
+ */
+
+@Slf4j
+@Repository
+@Primary
+public class GenreTestStorage implements GenreStorage {
+    private final Map<Long, Genre> genres = new HashMap<Long, Genre>() {{
+        Genre genre1 = new Genre();
+        genre1.setId(1L);
+        genre1.setName("Комедия");
+        put(1L, genre1);
+
+        Genre genre2 = new Genre();
+        genre2.setId(2L);
+        genre2.setName("Драма");
+        put(2L, genre2);
+    }};
+
+    // Хранение связей жанров и фильма
+    private final Map<Long, Set<Long>> filmToGenres = new HashMap<>();
+
+    @Override
+    public Collection<Genre> findAllGenres() {
+        return new ArrayList<>(genres.values());
+    }
+
+    @Override
+    public Optional<Genre> findById(Long id) {
+        return Optional.ofNullable(genres.get(id));
+    }
+
+    @Override
+    public Collection<Genre> findGenreForFilm(Long filmId) {
+        return filmToGenres.getOrDefault(filmId, Set.of())
+                .stream()
+                .map(genres::get)
+                .filter(Objects::nonNull)
+                .collect(Collectors.toList());
+    }
+
+    @Override
+    public void setGenreForFilm(Long filmId, Collection<Genre> genres) {
+        Set<Long> genreIds = genres.stream()
+                .map(Genre::getId)
+                .collect(Collectors.toSet());
+        filmToGenres.put(filmId, genreIds);
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/storage/LikesTestStorage.java b/src/test/java/ru/yandex/practicum/filmorate/storage/LikesTestStorage.java
new file mode 100644
index 0000000..250801d
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/storage/LikesTestStorage.java
@@ -0,0 +1,44 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.context.annotation.Primary;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.Likes;
+
+import java.util.*;
+import java.util.stream.Collectors;
+
+/**
+ * Утилитарный класс - тестовое хранилище Likes
+ */
+
+@Slf4j
+@Repository
+@Primary
+public class LikesTestStorage implements LikesStorage {
+
+    private final Map<Long, Set<Long>> filmLikes = new HashMap<>();
+
+    @Override
+    public void addLikeToFilm(Long filmId, Long userId) {
+        filmLikes.computeIfAbsent(filmId, k -> new HashSet<>()).add(userId);
+    }
+
+    @Override
+    public void removeLikeFromFilm(Long filmId, Long userId) {
+        filmLikes.getOrDefault(filmId, Set.of()).remove(userId);
+    }
+
+    @Override
+    public Collection<Likes> getLikesOnFilm(Long filmId) {
+        return filmLikes.getOrDefault(filmId, Set.of())
+                .stream()
+                .map(userId -> {
+                    Likes like = new Likes();
+                    like.setFilmId(filmId);
+                    like.setUserId(userId);
+                    return like;
+                })
+                .collect(Collectors.toList());
+    }
+}
\ No newline at end of file
diff --git a/src/test/java/ru/yandex/practicum/filmorate/storage/MpaTestStorage.java b/src/test/java/ru/yandex/practicum/filmorate/storage/MpaTestStorage.java
new file mode 100644
index 0000000..048a3ce
--- /dev/null
+++ b/src/test/java/ru/yandex/practicum/filmorate/storage/MpaTestStorage.java
@@ -0,0 +1,54 @@
+package ru.yandex.practicum.filmorate.storage;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.context.annotation.Primary;
+import org.springframework.stereotype.Repository;
+import ru.yandex.practicum.filmorate.model.Mpa;
+
+import java.util.*;
+
+/**
+ * Утилитарный класс - тестовое хранилище Mpa
+ */
+
+@Slf4j
+@Repository
+@Primary
+public class MpaTestStorage implements MpaStorage {
+
+    // Добавление MPA-рейтингов в тестовое хранилище Mpa
+    private final Map<Long, Mpa> mpas = new HashMap<Long, Mpa>() {{
+        put(1L, createMpa(1L, "G"));
+        put(2L, createMpa(2L, "PG"));
+        put(3L, createMpa(3L, "PG-13"));
+        put(4L, createMpa(4L, "R"));
+        put(5L, createMpa(5L, "NC-17"));
+    }};
+
+    // Хранение связей фильмов и MPA
+    private final Map<Long, Long> filmToMpa = new HashMap<>();
+
+    @Override
+    public Collection<Mpa> findAll() {
+        return mpas.values();
+    }
+
+    @Override
+    public Optional<Mpa> findMpaById(Long id) {
+        return Optional.ofNullable(mpas.get(id));
+    }
+
+    @Override
+    public Optional<Mpa> findMpaFilm(Long filmId) {
+        return Optional.ofNullable(filmToMpa.get(filmId))
+                .flatMap(this::findMpaById);
+    }
+
+    // Вспомогательный метод для добавления рейтингов
+    private Mpa createMpa(Long id, String name) {
+        Mpa mpa = new Mpa();
+        mpa.setId(id);
+        mpa.setName(name);
+        return mpa;
+    }
+}
\ No newline at end of file
diff --git a/src/main/java/ru/yandex/practicum/filmorate/storage/user/InMemoryUserStorage.java b/src/test/java/ru/yandex/practicum/filmorate/storage/UserTestStorage.java
similarity index 87%
rename from src/main/java/ru/yandex/practicum/filmorate/storage/user/InMemoryUserStorage.java
rename to src/test/java/ru/yandex/practicum/filmorate/storage/UserTestStorage.java
index 6eba877..eccd271 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/storage/user/InMemoryUserStorage.java
+++ b/src/test/java/ru/yandex/practicum/filmorate/storage/UserTestStorage.java
@@ -1,7 +1,8 @@
-package ru.yandex.practicum.filmorate.storage.user;
+package ru.yandex.practicum.filmorate.storage;
 
 import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Component;
+import org.springframework.context.annotation.Primary;
+import org.springframework.stereotype.Repository;
 import ru.yandex.practicum.filmorate.exception.*;
 import ru.yandex.practicum.filmorate.model.User;
 
@@ -9,9 +10,14 @@
 
 import static ru.yandex.practicum.filmorate.utils.ControllersUtils.getNextId;
 
+/**
+ * Утилитарный класс - тестовое хранилище для User
+ */
+
 @Slf4j
-@Component
-public class InMemoryUserStorage implements UserStorage {
+@Repository
+@Primary
+public class UserTestStorage implements UserStorage {
 
     private final Map<Long, User> users = new HashMap<>();
     private final Set<String> usersEmail = new HashSet<>();
@@ -62,9 +68,9 @@ public User update(User user) {
 
     // Получение пользователя по id
     @Override
-    public User getById(Long id) {
+    public Optional<User> findById(Long id) {
         validateUserId(id);
-        return users.get(id);
+        return Optional.ofNullable(users.get(id));
     }
 
     // Получение всех пользователей

From 87c763ea45fe6ac233ed9e0f8fe1b88a29b9e78e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=9A=D0=B0?=
 =?UTF-8?q?=D0=BD?= <dmitry.kan@yandex.ru>
Date: Tue, 15 Jul 2025 20:03:52 +0300
Subject: [PATCH 3/6] =?UTF-8?q?fix:=20=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=B8=D1=82=D1=8C=20CodeStyle?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../yandex/practicum/filmorate/controller/UserController.java   | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java b/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java
index 2dac69f..80e262f 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/controller/UserController.java
@@ -5,10 +5,8 @@
 import org.springframework.http.HttpStatus;
 import org.springframework.web.bind.annotation.*;
 import ru.yandex.practicum.filmorate.dto.NewUserRequest;
-import ru.yandex.practicum.filmorate.dto.UpdateFilmRequest;
 import ru.yandex.practicum.filmorate.dto.UpdateUserRequest;
 import ru.yandex.practicum.filmorate.dto.UserDto;
-import ru.yandex.practicum.filmorate.model.User;
 import ru.yandex.practicum.filmorate.service.UserService;
 
 import java.util.*;

From 2909cd1a1af4e41b85235987f354d185efd907ea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=9A=D0=B0?=
 =?UTF-8?q?=D0=BD?= <dmitry.kan@yandex.ru>
Date: Tue, 15 Jul 2025 20:05:47 +0300
Subject: [PATCH 4/6] =?UTF-8?q?fix:=20=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=B8=D1=82=D1=8C=20CodeStyle?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java
index 1f170b7..ba00dc4 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/BaseDbStorage.java
@@ -51,7 +51,7 @@ protected long insert(String query, Object... params) {
             for (int idx = 0; idx < params.length; idx++) {
                 ps.setObject(idx + 1, params[idx]);
             }
-            return ps;}, keyHolder);
+            return ps; }, keyHolder);
 
         Long id = keyHolder.getKeyAs(Long.class);
 

From 457c8972978c4521c583d62953be1e40dbc92587 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=9A=D0=B0?=
 =?UTF-8?q?=D0=BD?= <dmitry.kan@yandex.ru>
Date: Tue, 15 Jul 2025 20:07:36 +0300
Subject: [PATCH 5/6] =?UTF-8?q?fix:=20=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=B8=D1=82=D1=8C=20CodeStyle?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../ru/yandex/practicum/filmorate/dal/GenreDbStorage.java     | 4 ----
 .../java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java | 1 +
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java
index 400770b..e7aac81 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/GenreDbStorage.java
@@ -7,12 +7,8 @@
 import ru.yandex.practicum.filmorate.model.Genre;
 import ru.yandex.practicum.filmorate.storage.GenreStorage;
 
-import java.util.ArrayList;
 import java.util.Collection;
-import java.util.List;
 import java.util.Optional;
-import java.util.stream.Collectors;
-import java.util.stream.Stream;
 
 @Slf4j
 @Repository
diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
index 364832a..77f7d14 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
@@ -95,6 +95,7 @@ public Collection<User> findAll() {
                             .collect(Collectors.toSet())
             );
         });
+
         return users;
     }
 }
\ No newline at end of file

From 57686086f037f857d7bcfe0d21460a92ae3ee595 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=9A=D0=B0?=
 =?UTF-8?q?=D0=BD?= <dmitry.kan@yandex.ru>
Date: Tue, 15 Jul 2025 20:13:07 +0300
Subject: [PATCH 6/6] =?UTF-8?q?fix:=20=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=B8=D1=82=D1=8C=20CodeStyle?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java b/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
index 77f7d14..16e3e78 100644
--- a/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
+++ b/src/main/java/ru/yandex/practicum/filmorate/dal/UserDbStorage.java
@@ -83,7 +83,7 @@ public Optional<User> findById(Long id) {
     public Collection<User> findAll() {
         Collection<User> users = findMany(FIND_ALL_USERS_QUERY);
 
-        if(users.isEmpty()) {
+        if (users.isEmpty()) {
             return users;
         }