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
+
+
+
+ Управление студентами
+
+
+ Управление студентами
+
+
+
+
+
+
+
+
+
+
Добро пожаловать в систему управления студентами. Здесь вы можете управлять записями студентов.
+
Управление студентами
+
+
+
+
+
+
+
+
+
+
Добро пожаловать в систему управления студентами. Здесь вы можете управлять записями студентов.
+
Управление студентами
+
+
+
+
+
+
+
+
+
+
Добро пожаловать в систему управления студентами. Здесь вы можете управлять записями студентов.
+
+ * Этот метод настраивает менеджер транзакций для JPA с использованием настроенной фабрики сущностей.
+ *
+ *
+ * @param entityManagerFactory бин фабрики сущностей
+ * @return бин TransactionManager
+ */
+ @Bean
+ public PlatformTransactionManager transactionManager(EntityManagerFactory entityManagerFactory) {
+ JpaTransactionManager txManager = new JpaTransactionManager();
+ txManager.setEntityManagerFactory(entityManagerFactory);
+ return txManager;
+ }
+}
+```
+
+Следуя этим шагам, вы сможете включить управление транзакциями в вашем приложении Spring Boot, что позволит вам эффективно управлять транзакциями базы данных.
+
+---
+
+# [Далее: Создание сущностей и репозиториев](lessons/entities-and-repositories.md)
\ No newline at end of file
diff --git a/docs/ru/transactions/practice/lessons/basic-transactional-operations.md b/docs/ru/transactions/practice/lessons/basic-transactional-operations.md
new file mode 100644
index 0000000..5439b83
--- /dev/null
+++ b/docs/ru/transactions/practice/lessons/basic-transactional-operations.md
@@ -0,0 +1,50 @@
+## Урок 2: Внедрение основных транзакционных операций
+
+## Цель
+
+Этот раздел направлен на введение простых, но важных транзакционных методов для зачисления студентов и управления курсами в приложении Spring Boot.
+
+## Шаги
+
+1. **Зачисление студента на курс**
+
+ **Сценарий**: В качестве администратора университета вам необходимо зачислить студента на курс. Это действие должно быть не должно вызвать проблем и гарантировать целостность данных, даже если происходит несколько зачислений одновременно или возникают проблемы с базой данных.
+
+ **Реализация метода `enrollStudentInCourse`**: Создайте метод для зачисления студента на курс. Обеспечьте, чтобы этот процесс был транзакционным, что означает, что это как единый пакетный процесс, гарантирующий, что весь процесс единый. Мы используем `Propagation.REQUIRED`, чтобы убедиться, что этот метод участвует в любой существующей транзакции или создает новую, если таковой не существует. Кроме того, мы устанавливаем `Isolation.SERIALIZABLE`, чтобы гарантировать, что даже если есть параллельные транзакции, они не мешают друг другу, сохраняя целостность данных.
+
+ ```java
+ @Transactional(propagation = Propagation.REQUIRED, isolation = Isolation.SERIALIZABLE)
+ public void enrollStudentInCourse(UUID studentId, UUID courseId) {
+ // Ваша реализация здесь
+ }
+ ```
+
+2. **Получение списка студентов для курса**
+
+ **Сценарий**: Чтобы создать список группы для курса, вам необходимо получить список студентов, которые зачислены на него. Эта операция должна гарантировать, что вы всегда получаете точные данные базы данных, даже если происходят другие действия одновременно.
+
+ **Реализация метода `getStudentsForCourse`**: Разработайте метод для извлечения студентов для определенного курса. Он должен гарантировать, что данные, которые вы извлекаете, согласованы, независимо от любых текущих транзакций. Мы используем `Propagation.REQUIRED`, чтобы убедиться, что этот метод участвует в любой существующей транзакции или создает новую, если таковая не существует. Мы устанавливаем `Isolation.READ_COMMITTED`, чтобы гарантировать, что данные, которые мы извлекаем, зафиксированы и видны другим транзакциям, поддерживая последовательность.
+
+ ```java
+ @Transactional(propagation = Propagation.REQUIRED, isolation = Isolation.READ_COMMITTED)
+ public List getStudentsForCourse(UUID courseId) {
+ // Ваша реализация здесь
+ }
+ ```
+
+3. **Добавление нового курса**
+
+ **Сценарий**: Новый курс готовится к новому учебному году. При добавлении нового курса в систему вы хотите убедиться, что это действие не мешает ничему другому, происходящему в системе, сохраняя свою независимость.
+
+ **Реализация метода `addNewCourse`**: Создайте метод для добавления нового курса в систему. Убедитесь, что этот процесс не запутывается с другими текущими транзакциями. Мы используем `Propagation.NOT_SUPPORTED`, чтобы убедиться, что этот метод не участвует в какой-либо текущей транзакции, обеспечивая его автономность и избегая потенциальных конфликтов с другими операциями.
+
+ ```java
+ @Transactional(propagation = Propagation.NOT_SUPPORTED)
+ public Course addNewCourse(String title) {
+ // Ваша реализация здесь
+ }
+ ```
+
+---
+
+# [СЛЕДУЮЩЕЕ: Улучшение транзакционных методов с подробным логированием](transactional-logging.md)
diff --git a/docs/ru/transactions/practice/lessons/entities-and-repositories.md b/docs/ru/transactions/practice/lessons/entities-and-repositories.md
new file mode 100644
index 0000000..9c2e951
--- /dev/null
+++ b/docs/ru/transactions/practice/lessons/entities-and-repositories.md
@@ -0,0 +1,39 @@
+## Урок 1: Создание сущностей и репозиториев
+
+## Цель
+
+Цель этой задачи - определить основные сущности (Студент, Курс, Зачисление, Лог) и настроить соответствующие репозитории в проекте Spring Boot с использованием Spring Data JPA.
+
+## Шаги
+
+1. **Обратитесь к предоставленной ER-диаграмме, чтобы определить классы сущностей.**
+ 
+ Если у вас уже есть классы сущностей на основе предоставленной ER-диаграммы, перейдите к шагу 2. В противном случае проанализируйте ER-диаграмму и создайте следующие классы сущностей:
+
+ - Student (Студент)
+ - Course (Курс)
+ - Enrollment (Зачисление)
+ - Log (Лог)
+
+ Обеспечьте наличие необходимых атрибутов в каждом классе, как показано на ER-диаграмме.
+
+2. **Создайте репозитории для сущностей.**
+
+ Например, давайте создадим репозиторий для сущности `Student`:
+
+ ```java
+ package com.example.demo.repository;
+
+ import com.example.demo.entity.Student;
+ import org.springframework.data.jpa.repository.JpaRepository;
+
+ public interface StudentRepository extends JpaRepository {
+ }
+ ```
+
+ Если у вас уже есть репозитории, перейдите к следующему шагу. В противном случае повторите описанный выше шаг для репозиториев оставшихся сущностей (Course, Enrollment, Log).
+
+---
+
+# [СЛЕДУЮЩЕЕ: Реализация базовых транзакционных операций](basic-transactional-operations.md)
+
diff --git a/docs/ru/transactions/practice/lessons/nested-and-non-transactional-operations.md b/docs/ru/transactions/practice/lessons/nested-and-non-transactional-operations.md
new file mode 100644
index 0000000..c6473e0
--- /dev/null
+++ b/docs/ru/transactions/practice/lessons/nested-and-non-transactional-operations.md
@@ -0,0 +1,66 @@
+## Урок 4: Реализация вложенных транзакций и операций без транзакции
+
+## Цель
+
+Этот раздел направлен на изучение использования вложенных транзакций и операций без транзакции в слое сервиса, обеспечивая студентам понимание управления сложными транзакционными сценариями.
+
+## Шаги
+
+1. **Обновление деталей курса и зачислений**
+
+ **Сценарий**: В качестве администратора университета вам часто приходится обновлять как детали курса, так и зачисления, связанные с этим курсом. Эта операция должна обеспечивать целостность и непрерывность данных, даже если происходит несколько обновлений одновременно.
+
+ **Реализация метода `updateCourseAndEnrollments`**: Определите метод для обновления деталей курса и зачислений с необходимым транзакционным поведением. Мы используем `Propagation.REQUIRED`, чтобы убедиться, что этот метод участвует в любой существующей транзакции или создает новую, если таковой не существует. Установка `Isolation.REPEATABLE_READ` гарантирует, что данные, считываемые этим методом, остаются согласованными на протяжении всей транзакции. Внутри этого метода мы выполняем вложенную транзакцию, вызывая метод `updateEnrollments` для обновления зачислений, обеспечивая атомарность и изоляцию этой операции от внешней транзакции.
+
+ ```java
+ @Transactional(propagation = Propagation.REQUIRED, isolation = Isolation.REPEATABLE_READ)
+ public void updateCourseAndEnrollments(UUID courseId, String newTitle) {
+ // Запись начала процесса обновления
+ logAction("Update Course and Enrollments", "Start");
+
+ try {
+ // Реализация обновления деталей курса
+ // ...
+
+ // Вложенная транзакция для обновления зачислений
+ updateEnrollments(courseId);
+
+ // Запись успешного обновления
+ logAction("Update Course and Enrollments", "Success");
+ } catch (Exception e) {
+ // Запись неудачи
+ logAction("Update Course and Enrollments", "Failure: " + e.getMessage());
+ throw e;
+ }
+ }
+ ```
+
+2. **Независимое обновление зачислений**
+
+ **Сценарий**: Некоторые административные задачи могут потребовать обновления зачислений независимо от обновлений курса. Эта операция должна поддерживать целостность данных, позволяя при этом отдельное транзакционное управление.
+
+ **Реализация метода `updateEnrollments`**: Определите метод для обновления зачислений для курса с вложенным транзакционным поведением. Мы используем `Propagation.NESTED`, чтобы указать, что этот метод выполняется в рамках внешней транзакции, но может быть отменен независимо при необходимости. Установка `Isolation.REPEATABLE_READ` гарантирует, что данные, считываемые этим методом, остаются согласованными на протяжении всей транзакции.
+
+ ```java
+ @Transactional(propagation = Propagation.NESTED, isolation = Isolation.REPEATABLE_READ)
+ public void updateEnrollments(UUID courseId) {
+ // Запись начала процесса обновления зачислений
+ logAction("Update Enrollments", "Start");
+
+ try {
+ // Реализация обновления зачислений
+ // ...
+
+ // Запись успешного обновления
+ logAction("Update Enrollments", "Success");
+ } catch (Exception e) {
+ // Запись неудачи
+ logAction("Update Enrollments", "Failure: " + e.getMessage());
+ throw e;
+ }
+ }
+ ```
+
+---
+
+# [ДАЛЕЕ: Задания](../../lab-work.md)
diff --git a/docs/ru/transactions/practice/lessons/transactional-logging.md b/docs/ru/transactions/practice/lessons/transactional-logging.md
new file mode 100644
index 0000000..c55423b
--- /dev/null
+++ b/docs/ru/transactions/practice/lessons/transactional-logging.md
@@ -0,0 +1,105 @@
+## Урок 3: Дополнение транзакционных методов логгированием
+
+## Цель
+
+Этот раздел направлен на интеграцию логгирования для каждой транзакционной операции, обеспечивая запись действий с их результатами.
+
+## Шаги
+
+1. **Реализация метода журналирования(логгирования)**
+
+ **Сценарий**: Прежде чем улучшать транзакционные методы с помощью журналирования, нам нужно реализовать метод для обработки журналирования независимо от основной транзакции. Это гарантирует, что логгирование происходит надежно, независимо от результата основной транзакции.
+
+ **Реализация метода `logAction`**: Создайте метод для независимого записывания действий, обеспечивая точное отслеживание результатов транзакции. Мы используем `Propagation.REQUIRES_NEW`, чтобы выполнить операцию логгирования в отдельной транзакции, делая ее независимой от любых текущих транзакций и гарантируя ее завершение даже в случае сбоя основной транзакции.
+
+ ```java
+ @Transactional(propagation = Propagation.REQUIRES_NEW)
+ public void logAction(String action, String outcome) {
+ Log log = new Log(action, outcome, LocalDateTime.now());
+ logRepository.save(log);
+ }
+ ```
+
+2. **Логгирование зачисления студента на курс**
+
+ **Сценарий**: В качестве администратора университета вам необходимо зарегистрировать зачисление студента на курс для отслеживания успешных зачислений и возможных ошибок.
+
+ **Улучшение метода `enrollStudentInCourse`**: Измените метод для журналирования успешного или неудачного действия.
+
+ ```java
+ @Transactional(propagation = Propagation.REQUIRED, isolation = Isolation.SERIALIZABLE)
+ public void enrollStudentInCourse(UUID studentId, UUID courseId) {
+ // Запись начала процесса зачисления
+ logAction("Enroll Student", "Start");
+
+ try {
+ // Реализация зачисления студента на курс
+ // ...
+
+ // Журналирование успешного зачисления
+ logAction("Enroll Student", "Success");
+ } catch (Exception e) {
+ // Журналирование ошибки
+ logAction("Enroll Student", "Failure: " + e.getMessage());
+ throw e;
+ }
+ }
+ ```
+
+3. **Запись получения списка студентов для курса**
+
+ **Сценарий**: Для поддержания аудита активностей, связанных с курсом, вам необходимо зарегистрировать получение списка студентов для курса и гарантировать, что журналирование происходит даже в случае исключений.
+
+ **Улучшение метода `getStudentsForCourse`**: Измените метод для журналирования успешного или неудачного действия.
+
+ ```java
+ @Transactional(propagation = Propagation.REQUIRED, isolation = Isolation.READ_COMMITTED)
+ public List getStudentsForCourse(UUID courseId) {
+ // Запись начала получения списка студентов для курса
+ logAction("Retrieve Students for Course", "Start");
+
+ try {
+ // Реализация получения списка студентов для курса
+ // ...
+
+ // Журналирование успешного получения
+ logAction("Retrieve Students for Course", "Success");
+ return students;
+ } catch (Exception e) {
+ // Журналирование ошибки
+ logAction("Retrieve Students for Course", "Failure: " + e.getMessage());
+ throw e;
+ }
+ }
+ ```
+
+4. **Запись добавления нового курса**
+
+ **Сценарий**: При добавлении нового курса важно зарегистрировать результат операции для отслеживания успешного или неудачного добавления.
+
+ **Улучшение метода `addNewCourse`**: Измените метод для журналирования успешного или неудачного действия.
+
+ ```java
+ @Transactional(propagation = Propagation.NOT_SUPPORTED)
+ public Course addNewCourse(String title) {
+ // Запись начала добавления нового курса
+ logAction("Add New Course", "Start");
+
+ try {
+ // Реализация добавления нового курса
+ // ...
+
+ // Журналирование успешного добавления
+ logAction("Add New Course", "Success");
+ return savedCourse;
+ } catch (Exception e) {
+ // Журналирование ошибки
+ logAction("Add New Course", "Failure: " + e.getMessage());
+ throw e;
+ }
+ }
+ ```
+
+---
+
+# [ДАЛЕЕ: Реализация вложенных транзакций и непривязанных к транзакции операций](nested-and-non-transactional-operations.md)
\ No newline at end of file
diff --git a/docs/srcs/jmeter/disable-element.png b/docs/srcs/jmeter/disable-element.png
new file mode 100644
index 0000000..2ecf91e
Binary files /dev/null and b/docs/srcs/jmeter/disable-element.png differ
diff --git a/docs/srcs/jmeter/interface.png b/docs/srcs/jmeter/interface.png
new file mode 100644
index 0000000..1e18560
Binary files /dev/null and b/docs/srcs/jmeter/interface.png differ
diff --git a/docs/srcs/jmeter/new-http-cookie-manager-button.png b/docs/srcs/jmeter/new-http-cookie-manager-button.png
new file mode 100644
index 0000000..efa9a6f
Binary files /dev/null and b/docs/srcs/jmeter/new-http-cookie-manager-button.png differ
diff --git a/docs/srcs/jmeter/new-recording-controller-button.png b/docs/srcs/jmeter/new-recording-controller-button.png
new file mode 100644
index 0000000..b86d960
Binary files /dev/null and b/docs/srcs/jmeter/new-recording-controller-button.png differ
diff --git a/docs/srcs/jmeter/new-regular-expression-button.png b/docs/srcs/jmeter/new-regular-expression-button.png
new file mode 100644
index 0000000..dbe8971
Binary files /dev/null and b/docs/srcs/jmeter/new-regular-expression-button.png differ
diff --git a/docs/srcs/jmeter/new-simple-controller-button.png b/docs/srcs/jmeter/new-simple-controller-button.png
new file mode 100644
index 0000000..3458971
Binary files /dev/null and b/docs/srcs/jmeter/new-simple-controller-button.png differ
diff --git a/docs/srcs/jmeter/recording-controller-button.png b/docs/srcs/jmeter/recording-controller-button.png
new file mode 100644
index 0000000..2b0faf2
Binary files /dev/null and b/docs/srcs/jmeter/recording-controller-button.png differ
diff --git a/docs/srcs/jmeter/regular-expression-extractor-fields.png b/docs/srcs/jmeter/regular-expression-extractor-fields.png
new file mode 100644
index 0000000..ffacef5
Binary files /dev/null and b/docs/srcs/jmeter/regular-expression-extractor-fields.png differ
diff --git a/docs/srcs/jmeter/run-test-scenraio-button.png b/docs/srcs/jmeter/run-test-scenraio-button.png
new file mode 100644
index 0000000..67466c7
Binary files /dev/null and b/docs/srcs/jmeter/run-test-scenraio-button.png differ
diff --git a/docs/srcs/jmeter/setting-port-and-url-pattern.png b/docs/srcs/jmeter/setting-port-and-url-pattern.png
new file mode 100644
index 0000000..a29229b
Binary files /dev/null and b/docs/srcs/jmeter/setting-port-and-url-pattern.png differ
diff --git a/docs/srcs/jmeter/site.png b/docs/srcs/jmeter/site.png
new file mode 100644
index 0000000..9c84e82
Binary files /dev/null and b/docs/srcs/jmeter/site.png differ
diff --git a/docs/srcs/jmeter/start-recording-button.png b/docs/srcs/jmeter/start-recording-button.png
new file mode 100644
index 0000000..94be557
Binary files /dev/null and b/docs/srcs/jmeter/start-recording-button.png differ
diff --git a/docs/srcs/jmeter/stop-recording-button.png b/docs/srcs/jmeter/stop-recording-button.png
new file mode 100644
index 0000000..e539997
Binary files /dev/null and b/docs/srcs/jmeter/stop-recording-button.png differ
diff --git a/docs/srcs/jmeter/test-plan.png b/docs/srcs/jmeter/test-plan.png
new file mode 100644
index 0000000..b4f1660
Binary files /dev/null and b/docs/srcs/jmeter/test-plan.png differ
diff --git a/docs/srcs/jmeter/test-script-recorder.png b/docs/srcs/jmeter/test-script-recorder.png
new file mode 100644
index 0000000..3cb9278
Binary files /dev/null and b/docs/srcs/jmeter/test-script-recorder.png differ
diff --git a/docs/srcs/jmeter/thread-group-icon.png b/docs/srcs/jmeter/thread-group-icon.png
new file mode 100644
index 0000000..9c7cd2e
Binary files /dev/null and b/docs/srcs/jmeter/thread-group-icon.png differ
diff --git a/docs/srcs/jmeter/thread-group.png b/docs/srcs/jmeter/thread-group.png
new file mode 100644
index 0000000..8769c76
Binary files /dev/null and b/docs/srcs/jmeter/thread-group.png differ
diff --git a/docs/srcs/jpa/er-diagram.png b/docs/srcs/jpa/er-diagram.png
new file mode 100644
index 0000000..3d47dc4
Binary files /dev/null and b/docs/srcs/jpa/er-diagram.png differ
diff --git a/docs/srcs/jpa/task-er-diagram.png b/docs/srcs/jpa/task-er-diagram.png
new file mode 100644
index 0000000..aa3dbcc
Binary files /dev/null and b/docs/srcs/jpa/task-er-diagram.png differ
diff --git a/docs/srcs/springsecurity/task.png b/docs/srcs/springsecurity/task.png
new file mode 100644
index 0000000..7b8e717
Binary files /dev/null and b/docs/srcs/springsecurity/task.png differ
diff --git a/docs/srcs/thymeleaf/signup.png b/docs/srcs/thymeleaf/signup.png
new file mode 100644
index 0000000..5c0c764
Binary files /dev/null and b/docs/srcs/thymeleaf/signup.png differ
diff --git a/docs/srcs/transactions/er-diagram.png b/docs/srcs/transactions/er-diagram.png
new file mode 100644
index 0000000..92809d0
Binary files /dev/null and b/docs/srcs/transactions/er-diagram.png differ
diff --git a/docs/srcs/transactions/task-chart.png b/docs/srcs/transactions/task-chart.png
new file mode 100644
index 0000000..a92af23
Binary files /dev/null and b/docs/srcs/transactions/task-chart.png differ
diff --git a/settings.gradle b/settings.gradle
index 256101f..b73e5d5 100644
--- a/settings.gradle
+++ b/settings.gradle
@@ -1 +1,3 @@
rootProject.name = 'java-web-dev-tutorial'
+
+include 'a-thymeleaf'
\ No newline at end of file