enrollments;
+```
+
+В этом сценарии мы выбираем ленивую загрузку (`FetchType.LAZY`). Поскольку нам не всегда нужно получать доступ ко всем записям курса, ленивая загрузка гарантирует, что записи будут извлечены только при явном запросе.
+
+---
+
+# [Далее: Создание Репозитория](../interacting/repository.md)
diff --git a/docs/ru/jpa/practice/creation/relationships.md b/docs/ru/jpa/practice/creation/relationships.md
new file mode 100644
index 0000000..9040aab
--- /dev/null
+++ b/docs/ru/jpa/practice/creation/relationships.md
@@ -0,0 +1,44 @@
+# Определение Связей Между Сущностями
+
+## Введение
+
+Это руководство посвящено пониманию и реализации связей между сущностями в проекте Spring Boot с использованием JPA (Java Persistence API). Конкретно мы рассмотрим отношение между сущностью `Enrollment` и ее связанными сущностями `Student` и `Course`.
+
+## Цель
+
+Цель этого руководства - предоставить четкие инструкции по определению и пониманию связей сущностей в проекте Spring Boot с JPA. К концу этого руководства вы поймете, как установить ассоциации между сущностями и реализовать их в вашем приложении.
+
+## Связи Между Сущностями
+
+
+### Характеристики Сущности Enrollment:
+
+- `id` (UUID): Первичный ключ для сущности.
+- `student` (Student): Студент, связанный с записью на курс.
+- `course` (Course): Курс, связанный с записью на курс.
+- `enrollmentDate` (Date): Дата записи на курс.
+- `grade` (int): Оценка, полученная за курс.
+
+#### Отношение со Студентом
+
+Отношение между сущностью `Enrollment` и сущностью `Student` представляет собой сценарий, когда студент записывается на курс. Это отношение Многие-к-Одному, где много записей на курс может быть связано с одним студентом. Чтобы установить это отношение, аннотируйте атрибут `student` в сущности `Enrollment` аннотацией `@ManyToOne`.
+
+```java
+@ManyToOne
+@JoinColumn(name = "student_id")
+private Student student;
+```
+
+#### Отношение с Курсом
+
+Аналогично отношение между сущностью `Enrollment` и сущностью `Course` означает сценарий, когда на курс записывается несколько студентов. Это также отношение Многие-к-Одному, где много записей на курс может быть связано с одним курсом. Аннотируйте атрибут `course` в сущности `Enrollment` аннотацией `@ManyToOne`.
+
+```java
+@ManyToOne
+@JoinColumn(name = "course_id")
+private Course course;
+```
+
+---
+
+# [Далее: Стратегии Извлечения](fetching.md)
diff --git a/docs/ru/jpa/practice/dependencies/driver.md b/docs/ru/jpa/practice/dependencies/driver.md
new file mode 100644
index 0000000..5867be1
--- /dev/null
+++ b/docs/ru/jpa/practice/dependencies/driver.md
@@ -0,0 +1,100 @@
+# JPA: Настройка зависимостей
+
+## Введение
+
+Это руководство сосредотачивается на настройке зависимостей для проекта Spring Boot с использованием JPA (Java Persistence API). Оно охватывает необходимые шаги по включению драйверов базы данных для различных баз данных, таких как PostgreSQL, MySQL, Oracle, MongoDB и Microsoft SQL Server. Следуя этому руководству, вы настроите все необходимые зависимости для установления соединений с этими базами данных в вашем приложении Spring Boot.
+
+## Цель
+
+Цель этого руководства - предоставить четкие инструкции по настройке необходимых зависимостей для Spring Boot и JPA, с особенным акцентом на драйверах баз данных для различных баз данных.
+
+## Настройка зависимостей
+
+### Драйверы баз данных
+
+Для подключения к различным базам данных в вашем приложении Spring Boot включите соответствующие драйверы баз данных.
+
+#### PostgreSQL
+
+**Для Gradle:**
+```groovy
+implementation "org.postgresql:postgresql"
+```
+
+**Для Maven:**
+```xml
+
+ org.postgresql
+ postgresql
+ INSERT_VERSION_HERE
+
+```
+
+#### MySQL
+
+**Для Gradle:**
+```groovy
+implementation "mysql:mysql-connector-java"
+```
+
+**Для Maven:**
+```xml
+
+ mysql
+ mysql-connector-java
+ INSERT_VERSION_HERE
+
+```
+
+#### Драйвер Oracle Database
+
+**Для Gradle:**
+```groovy
+implementation 'com.oracle.database.jdbc:ojdbc8'
+```
+
+**Для Maven:**
+```xml
+
+ com.oracle.database.jdbc
+ ojdbc8
+
+```
+
+#### Драйвер MongoDB (MongoDB Java Driver)
+
+**Для Gradle:**
+```groovy
+implementation 'org.mongodb:mongodb-driver-sync:4.4.3'
+```
+
+**Для Maven:**
+```xml
+
+ org.mongodb
+ mongodb-driver-sync
+ 4.4.3
+
+```
+
+#### Драйвер Microsoft SQL Server JDBC
+
+**Для Gradle:**
+```groovy
+implementation 'com.microsoft.sqlserver:mssql-jdbc:9.4.0.jre11'
+```
+
+**Для Maven:**
+```xml
+
+ com.microsoft.sqlserver
+ mssql-jdbc
+ 9.4.0.jre11
+
+```
+
+Эти зависимости облегчают подключение к базам данных.
+
+---
+
+# [Далее: JPA Настройка зависимостей](jpa.md)
\ No newline at end of file
diff --git a/docs/ru/jpa/practice/dependencies/jpa.md b/docs/ru/jpa/practice/dependencies/jpa.md
new file mode 100644
index 0000000..4f68d7a
--- /dev/null
+++ b/docs/ru/jpa/practice/dependencies/jpa.md
@@ -0,0 +1,183 @@
+# Настройка зависимостей JPA
+
+## Введение
+
+Это руководство сосредоточено на настройке зависимостей для проекта Spring Boot с использованием JPA (Java Persistence API). Оно охватывает необходимые шаги для включения зависимостей Spring Boot Starter JDBC и Spring Boot Starter Data JPA.
+
+## Цель
+
+Цель этого руководства - предоставить четкие инструкции по настройке необходимых зависимостей для Spring Boot и JPA, с акцентом на зависимостях Spring Boot Starter JDBC и Spring Boot Starter Data JPA.
+
+## Настройка зависимостей
+
+### Spring Boot Starter JDBC
+
+Для включения поддержки JDBC в вашем приложении Spring Boot:
+
+#### Gradle
+
+```groovy
+implementation "org.springframework.boot:spring-boot-starter-jdbc"
+```
+
+#### Maven
+
+```xml
+
+ org.springframework.boot
+ spring-boot-starter-jdbc
+
+```
+
+Эта зависимость обеспечивает автоконфигурацию для доступа к данным на основе JDBC.
+
+### Spring Boot Starter Data JPA
+
+Для включения поддержки JPA (Java Persistence API) в вашем приложении Spring Boot:
+
+#### Gradle
+
+```groovy
+implementation "org.springframework.boot:spring-boot-starter-data-jpa"
+```
+
+#### Maven
+
+```xml
+
+ org.springframework.boot
+ spring-boot-starter-data-jpa
+
+```
+
+Эта зависимость упрощает настройку репозиториев на основе JPA и предоставляет конфигурации по умолчанию для Hibernate.
+
+### Дополнительная конфигурация для Spring WebMVC
+
+Если вы используете Spring WebMVC, вам необходимо добавить дополнительную конфигурацию для настройки бинов и свойств, связанных с сохранением состояния.
+
+#### Создание класса конфигурации Persistence
+
+Создайте новый класс с именем `PersistenceConfig` в пакете `com.example.config`:
+
+```java
+package com.example.config;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.PropertySource;
+import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
+import org.springframework.jdbc.datasource.DriverManagerDataSource;
+import org.springframework.orm.jpa.JpaTransactionManager;
+import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean;
+import org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter;
+import org.springframework.transaction.PlatformTransactionManager;
+import org.springframework.transaction.annotation.EnableTransactionManagement;
+
+import javax.persistence.EntityManagerFactory;
+import javax.sql.DataSource;
+
+/**
+ * Класс конфигурации для настройки бинов и свойств, связанных с сохранением состояния.
+ *
+ *
+ * Этот класс настраивает источник данных, фабрику менеджеров сущностей и менеджер транзакций для JPA.
+ * Он считывает свойства подключения к базе данных из внешнего файла свойств.
+ *
+ */
+@Configuration
+@EnableTransactionManagement
+@EnableJpaRepositories(basePackages = "com.example.repository")
+@PropertySource({"classpath:application.properties"})
+public class PersistenceConfig {
+
+ @Value("${spring.datasource.driver}")
+ private String dbDriver;
+
+ @Value("${spring.datasource.url}")
+ private String dbUrl;
+
+ @Value("${spring.datasource.username}")
+ private String dbUsername;
+
+ @Value("${spring.datasource.password}")
+ private String dbPassword;
+
+ @Value("${spring.jpa.properties.hibernate.dialect}")
+ private String hibernateDialect;
+
+ @Value("${spring.jpa.properties.hibernate.show_sql}")
+ private boolean hibernateShowSql;
+
+ @Value("${spring.jpa.hibernate.ddl-auto}")
+ private String hibernateHbm2ddlAuto;
+
+ /**
+ * Определение бина DataSource.
+ *
+ *
+ * Этот метод настраивает источник данных, используя свойства, определенные в файле application.properties.
+ *
+ *
+ * @return Бин DataSource
+ */
+ @Bean
+ public DataSource dataSource() {
+ DriverManagerDataSource dataSource = new DriverManagerDataSource();
+ dataSource.setDriverClassName(dbDriver);
+ dataSource.setUrl(dbUrl);
+ dataSource.setUsername(dbUsername);
+ dataSource.setPassword(dbPassword);
+ return dataSource;
+ }
+
+ /**
+ * Определение бина EntityManagerFactory.
+ *
+ *
+ * Этот метод настраивает фабрику менеджеров сущност
+
+ей с использованием настроенного источника данных и свойств Hibernate.
+ *
+ *
+ * @param dataSource бин источника данных
+ * @return Бин EntityManagerFactory
+ */
+ @Bean
+ public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) {
+ LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
+ em.setDataSource(dataSource);
+ em.setPackagesToScan("com.example.entity");
+
+ HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
+ vendorAdapter.setDatabasePlatform(hibernateDialect);
+ vendorAdapter.setShowSql(hibernateShowSql);
+ vendorAdapter.setGenerateDdl("update".equalsIgnoreCase(hibernateHbm2ddlAuto));
+ em.setJpaVendorAdapter(vendorAdapter);
+
+ return em;
+ }
+
+ /**
+ * Определение бина TransactionManager Spring.
+ *
+ *
+ * Этот метод настраивает менеджер транзакций для JPA с использованием настроенной фабрики менеджеров сущностей.
+ *
+ *
+ * @param entityManagerFactory бин фабрики менеджеров сущностей
+ * @return Бин TransactionManager
+ */
+ @Bean
+ public PlatformTransactionManager transactionManager(EntityManagerFactory entityManagerFactory) {
+ JpaTransactionManager txManager = new JpaTransactionManager();
+ txManager.setEntityManagerFactory(entityManagerFactory);
+ return txManager;
+ }
+}
+```
+
+---
+
+# [Следующий: Создание сущностей](../creation/create-entity.md)
\ No newline at end of file
diff --git a/docs/ru/jpa/practice/interacting/jpa-repository.md b/docs/ru/jpa/practice/interacting/jpa-repository.md
new file mode 100644
index 0000000..fd57f6f
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/jpa-repository.md
@@ -0,0 +1,52 @@
+# Создание JpaRepository
+
+## Введение
+
+Это руководство демонстрирует, как создать репозиторий для управления сущностями в проекте Spring Boot с использованием JPA (Java Persistence API) с помощью JpaRepository.
+
+## Цель
+
+Цель этого руководства - предоставить четкие инструкции по настройке репозитория для управления сущностями в приложении Spring Boot. По окончании этого руководства вы сможете создать классы репозитория и сервиса для сущности `Course`.
+
+## Структура каталогов
+
+```
+src/
+└── main/
+ └── java/
+ └── com/
+ └── example/
+ └── demo/
+ ├── data/
+ │ └── entities/
+ │ ├── Student.java
+ │ ├── Enrollment.java
+ │ └── Course.java
+ └── repository/
+ ├── StudentRepository.java
+ └── CourseRepository.java
+
+```
+
+## Класс репозитория
+
+### CourseRepository.java
+
+```java
+package com.yourcompany.yourproject.repository;
+
+import com.yourcompany.yourproject.model.Course;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface CourseRepository extends JpaRepository {
+ // Добавьте методы репозитория для сущности курса
+}
+```
+
+Аннотация `@Repository` является аннотацией стереотипа Spring, используемой для указания того, что декорированный класс является компонентом репозитория в слое доступа к данным. Она служит маркером для любого класса, который выполняет роль репозитория, облегчая перевод исключений в едиерное иерархия исключений Spring.
+
+---
+
+# [Далее: Создание записи](jpa-repository/create.md)
diff --git a/docs/ru/jpa/practice/interacting/jpa-repository/create.md b/docs/ru/jpa/practice/interacting/jpa-repository/create.md
new file mode 100644
index 0000000..eda726e
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/jpa-repository/create.md
@@ -0,0 +1,38 @@
+# Создание записей в таблице с использованием JpaRepository
+
+## Введение
+
+Это руководство демонстрирует, как создавать записи в таблице, используя слой репозитория в приложении Spring Boot с JPA (Java Persistence API) и JpaRepository.
+
+## Цель
+
+Цель этого руководства - проиллюстрировать процесс создания записей в таблице путем реализации метода в интерфейсе `CourseRepository` с использованием JpaRepository.
+
+## Метод репозитория
+
+### CourseRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Course;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+import java.util.UUID;
+
+@Repository
+public interface CourseRepository extends JpaRepository {
+
+ Course save(Course course);
+}
+```
+
+### Объяснение
+
+Метод `save(Course course)`, предоставленный JpaRepository, позволяет нам сохранить новую запись в таблице `Course`.
+
+Вызывая этот метод и передавая объект `Course` в качестве параметра, JpaRepository автоматически обрабатывает процесс сохранения сущности в базе данных.
+
+---
+
+# [Далее: Чтение записи](read.md)
diff --git a/docs/ru/jpa/practice/interacting/jpa-repository/delete.md b/docs/ru/jpa/practice/interacting/jpa-repository/delete.md
new file mode 100644
index 0000000..adea12c
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/jpa-repository/delete.md
@@ -0,0 +1,41 @@
+# Удаление записей из таблицы с использованием JpaRepository
+
+## Введение
+
+В этом руководстве показано, как удалять записи из таблицы, используя слой репозитория в приложении Spring Boot с JPA (Java Persistence API) и JpaRepository.
+
+## Цель
+
+Цель этого руководства - проиллюстрировать процесс удаления записей из таблицы путем реализации метода в интерфейсе `CourseRepository` с использованием JpaRepository.
+
+## Метод репозитория
+
+### CourseRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Course;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+import java.util.UUID;
+
+@Repository
+public interface CourseRepository extends JpaRepository {
+
+ void deleteById(UUID id);
+}
+```
+
+## Объяснение
+
+Метод `deleteById(UUID id)` следует соглашению, распознаваемому JpaRepository, для удаления записей на основе их уникального идентификатора.
+
+- Ключевое слово `delete` указывает, что этот метод используется для удаления данных.
+- `ById` указывает критерий для идентификации записи, которую нужно удалить. В данном случае мы нацелены на запись с определенным идентификатором.
+
+Следуя этому соглашению по именованию, JpaRepository автоматически генерирует соответствующий SQL-запрос для удаления желаемой записи из базы данных. Это упрощает процесс разработки, устраняя необходимость писать явные SQL-запросы на удаление, что позволяет разработчикам сосредоточиться на определении сигнатур методов, отражающих предполагаемые операции удаления данных.
+
+---
+
+# [Далее: Пользовательский запрос](query.md)
diff --git a/docs/ru/jpa/practice/interacting/jpa-repository/query.md b/docs/ru/jpa/practice/interacting/jpa-repository/query.md
new file mode 100644
index 0000000..5d2c4b5
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/jpa-repository/query.md
@@ -0,0 +1,43 @@
+# Пользовательский запрос с использованием JpaRepository
+
+## Введение
+
+Это руководство демонстрирует, как реализовать методы пользовательского запроса, используя аннотацию `@Query` в слое репозитория приложения Spring Boot с JPA (Java Persistence API) и JpaRepository.
+
+## Цель
+
+Цель этого руководства - проиллюстрировать процесс создания методов пользовательского запроса в интерфейсе репозитория для выполнения определенных операций с базой данных, адаптированных к требованиям приложения.
+
+## Метод репозитория
+
+### CourseRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Course;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.stereotype.Repository;
+import java.util.List;
+
+@Repository
+public interface CourseRepository extends JpaRepository {
+
+ @Query("SELECT c FROM Course c WHERE c.instructor = :instructor")
+ List findCoursesByInstructor(@Param("instructor") String instructor);
+}
+```
+
+### Объяснение
+
+Аннотация `@Query` позволяет нам определять пользовательские запросы JPQL (Java Persistence Query Language) непосредственно в интерфейсе репозитория.
+
+- `"SELECT c FROM Course c WHERE c.instructor = :instructor"` - это запрос JPQL, который выбирает все курсы, где имя инструктора соответствует предоставленному значению.
+- Аннотация `@Param("instructor")` привязывает параметр метода `instructor` к именованному параметру `:instructor` в запросе JPQL.
+
+Используя `@Query`, мы можем создавать сложные запросы, адаптированные к конкретным потребностям извлечения данных, обеспечивая гибкость и контроль над операциями с базой данных.
+
+---
+
+# [Next: Tasks](../../../lab-work.md)
\ No newline at end of file
diff --git a/docs/ru/jpa/practice/interacting/jpa-repository/read.md b/docs/ru/jpa/practice/interacting/jpa-repository/read.md
new file mode 100644
index 0000000..7cd66e0
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/jpa-repository/read.md
@@ -0,0 +1,42 @@
+# Чтение записей из таблицы с использованием JpaRepository
+
+## Введение
+
+Это руководство демонстрирует, как извлекать данные из таблицы, используя слой репозитория в приложении Spring Boot с JPA (Java Persistence API) и JpaRepository.
+
+## Цель
+
+Цель этого руководства - проиллюстрировать процесс чтения данных из таблицы путем реализации метода в интерфейсе `CourseRepository` с использованием JpaRepository.
+
+## Метод репозитория
+
+### CourseRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Course;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+import java.util.List;
+
+@Repository
+public interface CourseRepository extends JpaRepository {
+
+ List findCoursesByInstructor(String instructor);
+}
+```
+
+### Объяснение
+
+Сигнатура метода `findCoursesByInstructor(String instructor)` следует определенному соглашению по именованию, распознаваемому Spring Data JPA.
+
+- Ключевое слово `find` указывает, что этот метод используется для извлечения данных.
+- `Courses` представляет тип сущности, который мы хотим извлечь.
+- `ByInstructor` указывает критерий для фильтрации результатов. В данном случае мы запрашиваем курсы на основе атрибута `instructor`.
+
+Следуя этому соглашению по именованию, Spring Data JPA автоматически генерирует соответствующий SQL-запрос за кулисами, чтобы извлечь необходимые данные из базы данных. Это упрощает процесс разработки, устраняя необходимость писать явные SQL-запросы, что позволяет разработчикам сосредоточиться на определении сигнатур методов, отражающих желаемые операции извлечения данных.
+
+---
+
+# [Далее: Удаление записи](delete.md)
diff --git a/docs/ru/jpa/practice/interacting/repository.md b/docs/ru/jpa/practice/interacting/repository.md
new file mode 100644
index 0000000..16e82e1
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/repository.md
@@ -0,0 +1,50 @@
+# Создание репозитория
+
+## Введение
+
+Это руководство демонстрирует, как создать репозиторий для управления сущностями в проекте Spring Boot с использованием JPA (Java Persistence API).
+
+## Цель
+
+Цель этого руководства - предоставить четкие инструкции по настройке репозитория для управления сущностями в приложении Spring Boot. По окончании этого руководства вы сможете создать репозиторий для сущности `Student`.
+
+## Структура каталогов
+
+```
+src/
+└── main/
+ └── java/
+ └── com/
+ └── example/
+ └── demo/
+ ├── data/
+ │ └── entites/
+ │ ├── Student.java
+ │ ├── Enrollment.java
+ │ └── Course.java
+ └── repository/
+ └── StudentRepository.java
+
+```
+
+## Класс репозитория
+
+### StudentRepository.java
+
+```java
+package com.yourcompany.yourproject.repository;
+
+import com.yourcompany.yourproject.model.Student;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public class StudentRepository {
+ // Добавьте методы репозитория для сущности студента
+}
+```
+
+Аннотация `@Repository` является аннотацией стереотипа Spring, используемой для указания того, что декорированный класс является компонентом репозитория в слое доступа к данным. Она служит маркером для любого класса, который выполняет роль репозитория, облегчая перевод исключений в едиерное иерархия исключений Spring.
+
+---
+
+# [Далее: Создание записи](repository/create.md)
diff --git a/docs/ru/jpa/practice/interacting/repository/create.md b/docs/ru/jpa/practice/interacting/repository/create.md
new file mode 100644
index 0000000..8fbbbf9
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/repository/create.md
@@ -0,0 +1,46 @@
+# Создание новых записей в таблице с использованием слоя репозитория
+
+## Введение
+
+Это руководство иллюстрирует, как создавать новые записи в таблице, используя слой репозитория в приложении Spring Boot с JPA (Java Persistence API).
+
+## Цель
+
+Цель этого руководства - продемонстрировать процесс создания новых записей в таблице с использованием слоя репозитория. Мы достигнем этого, реализовав метод в интерфейсе `StudentRepository`, используя `EntityManager` вместо `JpaRepository`.
+
+## Метод репозитория
+
+### StudentRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Student;
+import org.springframework.stereotype.Repository;
+import javax.persistence.EntityManager;
+import javax.persistence.PersistenceContext;
+import javax.transaction.Transactional;
+
+@Repository
+public class StudentRepository {
+
+ @PersistenceContext
+ private EntityManager entityManager;
+
+ public void saveStudent(Student student) {
+ entityManager.persist(student);
+ }
+}
+```
+
+### Объяснение
+
+- `@Repository`: Эта аннотация помечает класс как компонент репозитория в слое доступа к данным.
+
+- `@PersistenceContext`: Эта аннотация используется для внедрения экземпляра EntityManager в класс репозитория.
+
+- `entityManager.persist(student)`: Этот код сохраняет новую сущность `Student` в базе данных.
+
+---
+
+# [Далее: Чтение записи](read.md)
diff --git a/docs/ru/jpa/practice/interacting/repository/delete.md b/docs/ru/jpa/practice/interacting/repository/delete.md
new file mode 100644
index 0000000..c6ade0d
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/repository/delete.md
@@ -0,0 +1,47 @@
+# Удаление записей из таблицы с использованием слоя репозитория
+
+## Введение
+
+В этом руководстве показано, как удалять записи из таблицы, используя слой репозитория в приложении Spring Boot с JPA (Java Persistence API).
+
+## Цель
+
+Цель этого руководства - продемонстрировать процесс удаления записей из таблицы, реализовав метод в интерфейсе `StudentRepository` с использованием `EntityManager`.
+
+## Метод репозитория
+
+### StudentRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Student;
+import org.springframework.stereotype.Repository;
+import javax.persistence.EntityManager;
+import javax.persistence.PersistenceContext;
+import javax.transaction.Transactional;
+
+@Repository
+public class StudentRepository {
+
+ @PersistenceContext
+ private EntityManager entityManager;
+
+ public void deleteStudent(UUID id) {
+ Student studentToDelete = entityManager.find(Student.class, id);
+ entityManager.remove(studentToDelete);
+ }
+}
+```
+
+### Объяснение
+
+- `@Repository`: Эта аннотация помечает класс как компонент репозитория в слое доступа к данным.
+
+- `@PersistenceContext`: Эта аннотация используется для внедрения экземпляра EntityManager в класс репозитория.
+
+- `entityManager.remove(studentToDelete)`: Этот код удаляет сущность `Student` из базы данных.
+
+---
+
+# [Далее: Пользовательский запрос](query.md)
diff --git a/docs/ru/jpa/practice/interacting/repository/query.md b/docs/ru/jpa/practice/interacting/repository/query.md
new file mode 100644
index 0000000..b25f84d
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/repository/query.md
@@ -0,0 +1,48 @@
+# Создание пользовательских запросов в таблице с использованием слоя репозитория
+
+## Введение
+
+В этом руководстве показано, как создавать пользовательские запросы для извлечения записей из таблицы, используя слой репозитория в приложении Spring Boot с JPA (Java Persistence API).
+
+## Цель
+
+Цель этого руководства - проиллюстрировать процесс создания пользовательских запросов для извлечения записей из таблицы, реализовав метод в интерфейсе `StudentRepository` с использованием `EntityManager`.
+
+## Метод репозитория
+
+### StudentRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Student;
+import org.springframework.stereotype.Repository;
+import javax.persistence.EntityManager;
+import javax.persistence.PersistenceContext;
+import java.util.List;
+
+@Repository
+public class StudentRepository {
+
+ @PersistenceContext
+ private EntityManager entityManager;
+
+ public List findStudentsByMajor(String major) {
+ return entityManager.createQuery("SELECT s FROM Student s WHERE s.major = :major", Student.class)
+ .setParameter("major", major)
+ .getResultList();
+ }
+}
+```
+
+### Объяснение
+
+- `@Repository`: Эта аннотация помечает класс как компонент репозитория в слое доступа к данным.
+
+- `@PersistenceContext`: Эта аннотация используется для внедрения экземпляра EntityManager в класс репозитория.
+
+- `entityManager.createQuery(...)`: Этот код создает пользовательский запрос на JPQL (Java Persistence Query Language) для извлечения записей на основе предоставленного критерия (`major` в этом примере).
+
+---
+
+# [Далее: Создание JpaRepository](../jpa-repository.md)
diff --git a/docs/ru/jpa/practice/interacting/repository/read.md b/docs/ru/jpa/practice/interacting/repository/read.md
new file mode 100644
index 0000000..36e6af3
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/repository/read.md
@@ -0,0 +1,46 @@
+# Чтение записей из таблицы с использованием слоя репозитория
+
+## Введение
+
+В этом руководстве показано, как читать записи из таблицы, используя слой репозитория в приложении Spring Boot с JPA (Java Persistence API).
+
+## Цель
+
+Цель этого руководства - проиллюстрировать процесс чтения записей из таблицы, реализовав метод в интерфейсе `StudentRepository` с использованием `EntityManager`.
+
+## Метод репозитория
+
+### StudentRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Student;
+import org.springframework.stereotype.Repository;
+import javax.persistence.EntityManager;
+import javax.persistence.PersistenceContext;
+import java.util.UUID;
+
+@Repository
+public class StudentRepository {
+
+ @PersistenceContext
+ private EntityManager entityManager;
+
+ public Student findStudentById(UUID id) {
+ return entityManager.find(Student.class, id);
+ }
+}
+```
+
+### Объяснение
+
+- `@Repository`: Эта аннотация помечает класс как компонент репозитория в слое доступа к данным.
+
+- `@PersistenceContext`: Эта аннотация используется для внедрения экземпляра EntityManager в класс репозитория.
+
+- `entityManager.find(Student.class, id)`: Этот код извлекает сущность `Student` из базы данных на основе предоставленного `id`.
+
+---
+
+# [Далее: Обновление записи](update.md)
diff --git a/docs/ru/jpa/practice/interacting/repository/update.md b/docs/ru/jpa/practice/interacting/repository/update.md
new file mode 100644
index 0000000..2fe9b31
--- /dev/null
+++ b/docs/ru/jpa/practice/interacting/repository/update.md
@@ -0,0 +1,46 @@
+# Обновление записей в таблице с использованием слоя репозитория
+
+## Введение
+
+Это руководство иллюстрирует, как обновлять записи в таблице с использованием слоя репозитория в приложении Spring Boot с JPA (Java Persistence API).
+
+## Цель
+
+Цель этого руководства - продемонстрировать процесс обновления записей в таблице, реализовав метод в интерфейсе `StudentRepository` с использованием `EntityManager`.
+
+## Метод репозитория
+
+### StudentRepository.java
+
+```java
+package com.example.demo.repository;
+
+import com.example.demo.data.entities.Student;
+import org.springframework.stereotype.Repository;
+import javax.persistence.EntityManager;
+import javax.persistence.PersistenceContext;
+import javax.transaction.Transactional;
+
+@Repository
+public class StudentRepository {
+
+ @PersistenceContext
+ private EntityManager entityManager;
+
+ public Student updateStudent(Student student) {
+ return entityManager.merge(student);
+ }
+}
+```
+
+### Объяснение
+
+- `@Repository`: Эта аннотация помечает класс как компонент репозитория в слое доступа к данным.
+
+- `@PersistenceContext`: Эта аннотация используется для внедрения экземпляра EntityManager в класс репозитория.
+
+- `entityManager.merge(student)`: Этот код обновляет сущность `Student` в базе данных.
+
+---
+
+# [Далее: Удаление записи](delete.md)
diff --git a/docs/ru/springsecurity/lab-work.md b/docs/ru/springsecurity/lab-work.md
new file mode 100644
index 0000000..2166b50
--- /dev/null
+++ b/docs/ru/springsecurity/lab-work.md
@@ -0,0 +1,62 @@
+[English](../../en/springsecurity/lab-work.md) | [中文](../../cn/springsecurity/lab-work.md) | Русский
+
+# Лабораторные работы по Spring Security
+
+Добро пожаловать в лабораторные работы по Spring Security! Цель этой серии задач - помочь вам на практике познакомиться с Spring Security, а также создать почти полноценный проект. Если вы начинающий или просто стремитесь улучшить свои навыки, эти практические задачи помогут вам разобраться в различных аспектах интеграции безопасности в приложение на Spring.
+
+## Цель лабораторных работ
+
+Основная цель этих лабораторных работ - предоставить вам практический опыт и уверенность в использовании безопасности в среде Spring. Spring Security широко используется для аутентификации, авторизации и обеспечения безопасности вашего приложения, и через эти задачи вы получите полезные знания о конфигурации, аутентификации, авторизации и многом другом.
+
+## Задачи практики
+
+1. [Задача 1: Настройка Spring Security](practice/configure-spring-security.md)
+2. [Задача 2: Создание базовой реализации для пользователя](practice/base-implementation-user.md)
+3. [Задача 3: Шифрование пароля](practice/password-encryption.md)
+4. [Задача 4: Добавление фиктивных пользователей](practice/add-dummy-users.md)
+5. [Задача 5: Создание идентификации для пользователей](practice/create-identity-to-users.md)
+6. [Задача 6: Создание базы для авторизации на сервере](practice/setup-server-authorization.md)
+7. [Задача 7: Авторизация аутентифицированных пользователей](practice/authorize-server-authenticated.md)
+8. [Задача 8: Авторизация по ролям](practice/authorize-server-role.md)
+9. [Задача 9: Авторизация по полномочиям](practice/authorize-server-authority.md)
+10. [Задача 10: Настройка Thymeleaf Security](practice/configure-thymeleaf-security.md)
+11. [Задача 11: Авторизация аутентифицированных пользователей](practice/authorize-client-authenticated.md)
+12. [Задача 12: Авторизация по ролям](practice/authorize-client-role.md)
+13. [Задача 13: Авторизация по полномочиям](practice/authorize-client-authority.md)
+14. [Задача 14: Пользовательская форма входа](practice/custom-login-form.md)
+
+## Задачи лабораторной работы
+
+
+
+### Задача 1: Настройка Spring Security
+Инициализация Spring Security в вашем проекте.
+
+### Задача 2: Определение Ролей и Полномочий Пользователей
+Определение различных пользовательских ролей (Менеджер, Учитель, Студент) и их соответствующих полномочий.
+
+### Задача 3: Настройка Безопасности в Контроллерах
+Защита путей приложения (endpoins) с использованием контроля доступа на основе ролей.
+
+#### Детали реализации
+**Роль Менеджера**:
+- Добавление Нового Учителя (`/teachers/new`)
+- Изменение Профиля Учителя (`/teachers/{id}/edit`)
+- Изменение Профиля Студента (`/students/{id}/edit`)
+- Изменение Оценок Студента (`/students/{id}/marks/edit`)
+
+**Роль Учителя**:
+- Изменение Оценок Студента (`/students/{id}/marks/edit`)
+- Добавление Нового Предмета (`/subjects/new`)
+- Добавление Нового Теста (`/tests/new`)
+
+**Роль Студента**:
+- Прохождение Теста (`/tests/{id}/take`)
+- Просмотр Оценок (`/students/{id}/marks`)
+
+### Задача 4: Реализация Авторизации в Шаблонах Thymeleaf
+
+Ограничение доступа к элементам пользовательского интерфейса на основе ролей пользователей.
+
+### Задача 5: Тестирование Контроля Доступа на Основе Ролей
+Убедитесь, что enpoints и элементы пользовательского интерфейса правильно защищены.
diff --git a/docs/ru/springsecurity/practice/add-dummy-users.md b/docs/ru/springsecurity/practice/add-dummy-users.md
new file mode 100644
index 0000000..d439254
--- /dev/null
+++ b/docs/ru/springsecurity/practice/add-dummy-users.md
@@ -0,0 +1,68 @@
+# Добавление фиктивных пользователей
+
+В этом задании описан процесс обновления класса `CustomUserDetailsService` для включения метода добавления фиктивных пользователей в хранилище в памяти, чтобы использовать его в качестве простого демонстрационного примера создания пользователей.
+
+## Цель
+
+Обновить класс `CustomUserDetailsService`, чтобы включить метод добавления фиктивных пользователей, позволяющий инициализировать данные пользователей в хранилище в памяти.
+
+## Шаги
+
+1. **Обновление класса CustomUserDetailsService:**
+
+ Сначала нам нужно обновить класс `CustomUserDetailsService`, чтобы добавить метод добавления фиктивных пользователей. Мы будем использовать этот метод во время инициализации бина для заполнения хранилища в памяти данными о фиктивных пользователях.
+
+ ```java
+ @Service
+ public class CustomUserDetailsService implements UserDetailsService {
+
+ private final UsersRepository usersRepository;
+ private final PasswordEncoder passwordEncoder;
+
+ @Autowired
+ public CustomUserDetailsService(UsersRepository usersRepository, PasswordEncoder passwordEncoder) {
+ this.usersRepository = usersRepository;
+ this.passwordEncoder = passwordEncoder;
+
+ // Вызываем метод addDummyUsers для добавления фиктивных пользователей во время инициализации бина
+ addDummyUsers();
+ }
+
+ @Override
+ public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
+ // Получаем данные пользователя из репозитория
+ CustomUserDetails userDetails = usersRepository.findByUsername(username);
+ if (userDetails == null) {
+ throw new UsernameNotFoundException("Пользователь с именем пользователя не найден: " + username);
+ }
+ return userDetails;
+ }
+
+ // Метод для добавления фиктивных пользователей
+ private void addDummyUsers() {
+ // Создаем фиктивных пользователей
+ CustomUserDetails admin = new CustomUserDetails("admin", passwordEncoder.encode("admin"), true, true, true, true);
+ CustomUserDetails moderator = new CustomUserDetails("moderator", passwordEncoder.encode("moderator"), true, true, true, true);
+ CustomUserDetails user = new CustomUserDetails("user", passwordEncoder.encode("user"), true, true, true, true);
+
+ // Добавляем пользователей в репозиторий
+ usersRepository.save(admin);
+ usersRepository.save(moderator);
+ usersRepository.save(user);
+ }
+ }
+ ```
+
+ В этом обновленном классе:
+ - Мы добавили конструктор, который принимает `UsersRepository` и `PasswordEncoder` в качестве зависимостей.
+ - Во время инициализации бина конструктор вызывает метод `addDummyUsers` для заполнения хранилища в памяти фиктивными пользователями.
+ - Метод `addDummyUsers` создает фиктивных пользователей с захардкоженными именами пользователей и паролями.
+ - Наконец, фиктивные пользователи сохраняются в репозитории с помощью метода `save`.
+
+## Заключение
+
+Поздравляем! Вы успешно добавили фиктивных пользователей для имитации базы данных в вашем приложении с использованием Spring Security. Путем инициализации списка фиктивных пользователей в классе UserRepositoryImpl и заполнения его во время запуска приложения вы теперь можете аутентифицировать и авторизовывать пользователей в вашем приложении.
+
+---
+
+# [СЛЕДУЮЩЕЕ ЗАДАНИЕ: Создание идентификации для пользователей](create-identity-to-users.md)
diff --git a/docs/ru/springsecurity/practice/authorize-client-authenticated.md b/docs/ru/springsecurity/practice/authorize-client-authenticated.md
new file mode 100644
index 0000000..2fb7c91
--- /dev/null
+++ b/docs/ru/springsecurity/practice/authorize-client-authenticated.md
@@ -0,0 +1,54 @@
+# Авторизация аутентифицированных пользователей (на клиентской стороне)
+
+Этот файл описывает процесс авторизации пользователей на основе их статуса аутентификации на клиентской стороне с использованием Thymeleaf. Путем отображения или скрытия элементов в представлении в зависимости от статуса аутентификации пользователя можно контролировать видимость определенных функциональностей или действий.
+
+## Цель
+
+Контролировать видимость элементов, связанных с добавлением и удалением студентов, в зависимости от статуса аутентификации пользователя в представлениях Thymeleaf.
+
+## Шаги
+
+1. **Обновление шаблонов Thymeleaf:**
+
+ Измените шаблоны Thymeleaf для условного отображения элементов в зависимости от статуса аутентификации пользователя.
+
+ ```html
+
+
+
+ Управление студентами
+
+
+ Управление студентами
+
+
+
+
+
+
+
+
+
+
Добро пожаловать в систему управления студентами. Здесь вы можете управлять записями студентов.
+
Управление студентами
+
+
+
+
+
+
+
+
+
+
Добро пожаловать в систему управления студентами. Здесь вы можете управлять записями студентов.
+
Управление студентами
+
+
+
+
+
+
+
+
+
+
Добро пожаловать в систему управления студентами. Здесь вы можете управлять записями студентов.
+