From 82d46aef718c6cd346c08b2840960c244fd3900e Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 16:48:37 +0300
Subject: [PATCH 01/10] feat(resource): add resource details page (read-only)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Read-only страница №3: метаданные ресурса + таблица файлов со скачиванием, кнопка Назад.

Подготовка: Navigator.goTo с Consumer-колбэком, List<FileInfo> в Resource, hasRole по иерархии USER<MODER<ADMIN.
---
 .../ResourceDetailsController.java            | 129 ++++++++++++++++++
 .../entities/Resource.java                    |   2 +
 .../navigation/Navigator.java                 |   6 +
 .../services/impl/AuthServiceImpl.java        |  12 +-
 .../services/impl/ResourceServiceImpl.java    |   9 +-
 src/main/resources/fxml/ResourceDetails.fxml  |  63 +++++++++
 6 files changed, 219 insertions(+), 2 deletions(-)
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
 create mode 100644 src/main/resources/fxml/ResourceDetails.fxml

diff --git a/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java b/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
new file mode 100644
index 0000000..1f2b2b4
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
@@ -0,0 +1,129 @@
+package com.DesktopApplicationClientJava.controllers;
+
+import com.DesktopApplicationClientJava.controllers.utils.Controller;
+import com.DesktopApplicationClientJava.entities.FileInfo;
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import java.io.File;
+import java.nio.file.Path;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+import java.util.UUID;
+import java.util.function.Consumer;
+import javafx.event.ActionEvent;
+import javafx.fxml.FXML;
+import javafx.scene.control.Button;
+import javafx.scene.control.Label;
+import javafx.scene.control.TableCell;
+import javafx.scene.control.TableColumn;
+import javafx.scene.control.TableView;
+import javafx.scene.control.cell.PropertyValueFactory;
+import javafx.stage.DirectoryChooser;
+import javafx.stage.Window;
+
+public class ResourceDetailsController extends Controller {
+
+  static final DateTimeFormatter DATE_TIME_FORMAT = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm");
+
+  @FXML private Label titleLabel;
+  @FXML private Label descriptionLabel;
+  @FXML private Label createdLabel;
+  @FXML private Label updatedLabel;
+  @FXML private Label uuidLabel;
+  @FXML private Label errorLabel;
+  @FXML private Label statusLabel;
+  @FXML private TableView<FileInfo> filesTable;
+  @FXML private TableColumn<FileInfo, String> nameColumn;
+  @FXML private TableColumn<FileInfo, Long> sizeColumn;
+  @FXML private TableColumn<FileInfo, String> contentTypeColumn;
+  @FXML private TableColumn<FileInfo, Void> downloadColumn;
+  @FXML private Button backButton;
+
+  private UUID resourceId;
+
+  @FXML
+  private void initialize() {
+    hideError();
+    nameColumn.setCellValueFactory(new PropertyValueFactory<>("name"));
+    sizeColumn.setCellValueFactory(new PropertyValueFactory<>("size"));
+    contentTypeColumn.setCellValueFactory(new PropertyValueFactory<>("contentType"));
+    downloadColumn.setCellFactory(col -> new DownloadCell(this::onDownload));
+  }
+
+  public void setResourceId(UUID resourceId) {
+    this.resourceId = resourceId;
+  }
+
+  public void load() {
+    hideError();
+    try {
+      showResource(services.getResourceService().getById(resourceId));
+    } catch (ServiceException e) {
+      showError(e.getMessage());
+    }
+  }
+
+  @FXML
+  private void onBack(ActionEvent event) {
+    navigator.goTo("/fxml/ResourceList.fxml");
+  }
+
+  private void onDownload(FileInfo file) {
+    File dir = chooseDirectory(backButton.getScene().getWindow());
+    if (dir == null) {
+      return;
+    }
+    try {
+      Path saved = services.getFileService().downloadFile(resourceId, file.getUuid(), dir.toPath());
+      statusLabel.setText("Сохранено: " + saved.getFileName());
+    } catch (ServiceException e) {
+      showError(e.getMessage());
+    }
+  }
+
+  protected File chooseDirectory(Window owner) {
+    return new DirectoryChooser().showDialog(owner);
+  }
+
+  private void showResource(Resource resource) {
+    titleLabel.setText(resource.getTitle());
+    descriptionLabel.setText(resource.getDescription());
+    createdLabel.setText(formatDateTime(resource.getCreatedAt()));
+    updatedLabel.setText(formatDateTime(resource.getUpdatedAt()));
+    uuidLabel.setText(resource.getUuid() == null ? "" : resource.getUuid().toString());
+    List<FileInfo> files = resource.getFiles() == null ? List.of() : resource.getFiles();
+    filesTable.getItems().setAll(files);
+  }
+
+  private static String formatDateTime(LocalDateTime value) {
+    return value == null ? "" : DATE_TIME_FORMAT.format(value);
+  }
+
+  private void showError(String message) {
+    errorLabel.setText(message);
+    errorLabel.setVisible(true);
+    errorLabel.setManaged(true);
+  }
+
+  private void hideError() {
+    errorLabel.setText("");
+    errorLabel.setVisible(false);
+    errorLabel.setManaged(false);
+  }
+
+  private static final class DownloadCell extends TableCell<FileInfo, Void> {
+    private final Button button = new Button("Скачать");
+
+    DownloadCell(Consumer<FileInfo> onDownload) {
+      button.getStyleClass().setAll("btn", "btn-default");
+      button.setOnAction(event -> onDownload.accept(getTableView().getItems().get(getIndex())));
+    }
+
+    @Override
+    protected void updateItem(Void item, boolean empty) {
+      super.updateItem(item, empty);
+      setGraphic(empty ? null : button);
+    }
+  }
+}
diff --git a/src/main/java/com/DesktopApplicationClientJava/entities/Resource.java b/src/main/java/com/DesktopApplicationClientJava/entities/Resource.java
index 8606d49..44d5411 100644
--- a/src/main/java/com/DesktopApplicationClientJava/entities/Resource.java
+++ b/src/main/java/com/DesktopApplicationClientJava/entities/Resource.java
@@ -1,6 +1,7 @@
 package com.DesktopApplicationClientJava.entities;
 
 import java.time.LocalDateTime;
+import java.util.List;
 import java.util.UUID;
 import lombok.AllArgsConstructor;
 import lombok.Getter;
@@ -17,4 +18,5 @@ public class Resource {
   private String description;
   private LocalDateTime createdAt;
   private LocalDateTime updatedAt;
+  private List<FileInfo> files;
 }
diff --git a/src/main/java/com/DesktopApplicationClientJava/navigation/Navigator.java b/src/main/java/com/DesktopApplicationClientJava/navigation/Navigator.java
index 1ddcfb3..87d0a59 100644
--- a/src/main/java/com/DesktopApplicationClientJava/navigation/Navigator.java
+++ b/src/main/java/com/DesktopApplicationClientJava/navigation/Navigator.java
@@ -5,6 +5,7 @@
 import com.DesktopApplicationClientJava.session.SessionAware;
 import com.DesktopApplicationClientJava.utils.ControllerWiring;
 import java.io.IOException;
+import java.util.function.Consumer;
 import javafx.fxml.FXMLLoader;
 import javafx.scene.Parent;
 import javafx.stage.Stage;
@@ -22,6 +23,10 @@ public Navigator(Stage stage, Session session, ServiceRegistry services) {
   }
 
   public void goTo(String fxmlFile) {
+    goTo(fxmlFile, controller -> {});
+  }
+
+  public void goTo(String fxmlFile, Consumer<Object> withController) {
     var url = Navigator.class.getResource(fxmlFile);
     if (url == null) {
       throw new IllegalArgumentException("FXML not found on classpath: " + fxmlFile);
@@ -49,6 +54,7 @@ public void goTo(String fxmlFile) {
       if (controller instanceof NavigatorAware na) {
         na.setNavigator(this);
       }
+      withController.accept(controller);
 
       stage.getScene().setRoot(root);
     } catch (IOException e) {
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/impl/AuthServiceImpl.java b/src/main/java/com/DesktopApplicationClientJava/services/impl/AuthServiceImpl.java
index 382de28..6538915 100644
--- a/src/main/java/com/DesktopApplicationClientJava/services/impl/AuthServiceImpl.java
+++ b/src/main/java/com/DesktopApplicationClientJava/services/impl/AuthServiceImpl.java
@@ -55,7 +55,9 @@ public User getCurrentUser() {
   @Override
   public boolean hasRole(Role required) {
     User current = session.getCurrentUser();
-    return current != null && current.getRole() == required;
+    return current != null
+        && current.getRole() != null
+        && level(current.getRole()) >= level(required);
   }
 
   @Override
@@ -72,4 +74,12 @@ private User toEntity(UserDto dto) {
     return new User(
         dto.uuid(), dto.email(), dto.role(), dto.firstName(), dto.lastName(), dto.enabled());
   }
+
+  private static int level(Role role) {
+    return switch (role) {
+      case USER -> 0;
+      case MODER -> 1;
+      case ADMIN -> 2;
+    };
+  }
 }
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/impl/ResourceServiceImpl.java b/src/main/java/com/DesktopApplicationClientJava/services/impl/ResourceServiceImpl.java
index 25d3725..b2473cf 100644
--- a/src/main/java/com/DesktopApplicationClientJava/services/impl/ResourceServiceImpl.java
+++ b/src/main/java/com/DesktopApplicationClientJava/services/impl/ResourceServiceImpl.java
@@ -6,6 +6,7 @@
 import com.DesktopApplicationClientJava.Api.Dto.request.Resource.ResourceFilterRequest;
 import com.DesktopApplicationClientJava.Api.Dto.request.Resource.UpdateResourceRequest;
 import com.DesktopApplicationClientJava.Api.Dto.response.ResourceDto;
+import com.DesktopApplicationClientJava.entities.FileInfo;
 import com.DesktopApplicationClientJava.entities.Resource;
 import com.DesktopApplicationClientJava.services.ResourceService;
 import com.DesktopApplicationClientJava.services.ServiceException;
@@ -83,7 +84,13 @@ public void delete(UUID resourceId) {
   }
 
   private Resource toEntity(ResourceDto dto) {
+    List<FileInfo> files =
+        dto.files() == null
+            ? List.of()
+            : dto.files().stream()
+                .map(f -> new FileInfo(f.uuid(), f.name(), f.contentType(), f.size()))
+                .toList();
     return new Resource(
-        dto.uuid(), dto.title(), dto.description(), dto.createdAt(), dto.updatedAt());
+        dto.uuid(), dto.title(), dto.description(), dto.createdAt(), dto.updatedAt(), files);
   }
 }
diff --git a/src/main/resources/fxml/ResourceDetails.fxml b/src/main/resources/fxml/ResourceDetails.fxml
new file mode 100644
index 0000000..395b680
--- /dev/null
+++ b/src/main/resources/fxml/ResourceDetails.fxml
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<?import javafx.geometry.Insets?>
+<?import javafx.scene.control.Button?>
+<?import javafx.scene.control.Label?>
+<?import javafx.scene.control.TableColumn?>
+<?import javafx.scene.control.TableView?>
+<?import javafx.scene.layout.HBox?>
+<?import javafx.scene.layout.VBox?>
+
+<VBox xmlns:fx="http://javafx.com/fxml/1" fx:id="root" alignment="CENTER"
+    fx:controller="com.DesktopApplicationClientJava.controllers.ResourceDetailsController">
+    <padding>
+        <Insets top="20" right="20" bottom="20" left="20" />
+    </padding>
+
+    <VBox styleClass="panel, panel-primary" maxWidth="640">
+        <VBox styleClass="panel-heading">
+            <Label fx:id="titleLabel" styleClass="panel-title" text="..." />
+        </VBox>
+
+        <VBox styleClass="panel-body" spacing="8">
+            <padding>
+                <Insets top="12" right="12" bottom="12" left="12" />
+            </padding>
+
+            <Label fx:id="descriptionLabel" wrapText="true" />
+
+            <HBox spacing="8">
+                <Label text="Создан:" styleClass="lbl" />
+                <Label fx:id="createdLabel" />
+            </HBox>
+
+            <HBox spacing="8">
+                <Label text="Изменён:" styleClass="lbl" />
+                <Label fx:id="updatedLabel" />
+            </HBox>
+
+            <HBox spacing="8">
+                <Label text="UUID:" styleClass="lbl" />
+                <Label fx:id="uuidLabel" style="-fx-font-family: monospace; -fx-font-size: 11;" />
+            </HBox>
+
+            <Label fx:id="errorLabel" styleClass="alert, alert-danger" visible="false"
+                managed="false" wrapText="true" maxWidth="Infinity" />
+
+            <TableView fx:id="filesTable" prefHeight="200" maxWidth="Infinity">
+                <columns>
+                    <TableColumn fx:id="nameColumn" text="Имя" prefWidth="240" />
+                    <TableColumn fx:id="sizeColumn" text="Размер" prefWidth="100" />
+                    <TableColumn fx:id="contentTypeColumn" text="Тип" prefWidth="160" />
+                    <TableColumn fx:id="downloadColumn" text="" prefWidth="110" sortable="false" />
+                </columns>
+            </TableView>
+
+            <HBox spacing="8">
+                <Button fx:id="backButton" text="Назад" onAction="#onBack"
+                    styleClass="btn, btn-default" />
+                <Label fx:id="statusLabel" styleClass="lbl" />
+            </HBox>
+        </VBox>
+    </VBox>
+</VBox>

From be0be2318c1453d7f7ec05f0d9fba13f043ba9bc Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 16:50:56 +0300
Subject: [PATCH 02/10] test(resource): cover resource details flow
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Unit (TestFX + моки): метаданные + 2 файла, 404 в errorLabel, скачивание (статус/ошибка/отмена диалога), Назад; иерархия hasRole USER<MODER<ADMIN.

Интеграционные (@Tag integration, без моков): 404 на случайном UUID, create/getById/delete под admin.

Дока: №3 помечена готовой, зафиксированы решения про Navigator-параметр и hasRole-иерархию.
---
 ...20\260\320\275\320\270\321\206\321\213.md" |   7 +-
 src/test/java/services/AuthServiceTest.java   |  70 +++++++
 .../ui/ResourceDetailsControllerTest.java     | 192 ++++++++++++++++++
 .../ui/ResourceDetailsIntegrationTest.java    |  83 ++++++++
 4 files changed, 351 insertions(+), 1 deletion(-)
 create mode 100644 src/test/java/services/AuthServiceTest.java
 create mode 100644 src/test/java/ui/ResourceDetailsControllerTest.java
 create mode 100644 src/test/java/ui/ResourceDetailsIntegrationTest.java

diff --git "a/docs/\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213.md" "b/docs/\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213.md"
index 46d9969..5f78fe3 100644
--- "a/docs/\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213.md"
+++ "b/docs/\321\201\321\202\321\200\320\260\320\275\320\270\321\206\321\213.md"
@@ -19,7 +19,7 @@ UI не ходит в HTTP напрямую. Контроллер вызывае
 | --- | -------------------------------------------- | ------------------------------------ | ----------------- | --------------------------------------------------------------------------------------------------------------- | ------------- |
 | 1   | Вход (email + пароль)                        | `/fxml/LoginForm.fxml`               | гость (публичная) | Аутентификация через `AuthService`, после успеха → №2                                                           | @vladcheck     |
 | 2   | Список ресурсов и сортировка (главная)       | `/fxml/ResourceList.fxml`            | `USER`            | Поиск/фильтр/сортировка, пагинация `offset/count` через `ResourceService.search`                                | @miyagi18      |
-| 3   | Просмотр метаданных документа                | `/fxml/ResourceDetails.fxml` (новая) | `USER`            | Только чтение: `ResourceService.getById` → `title, description, createdAt, updatedAt, uuid`                     | @vladcheck     |
+| 3   | Просмотр метаданных документа                | `/fxml/ResourceDetails.fxml` | `USER`            | Только чтение: `ResourceService.getById` → `title, description, createdAt, updatedAt, uuid`                     | @vladcheck     |
 | 4   | Форма ресурса (создание/редактирование)      | `/fxml/ResourceForm.fxml` (новая)    | `MODER`           | `create/update` через `ResourceService`; удаление — действием из №2/№3 с подтверждением, без отдельной страницы | @miyagi18      |
 | 5   | Список пользователей                         | `/fxml/UserList.fxml` (новая)        | `ADMIN`           | Поиск/фильтр через `UsersService.search` + `UserFilter`; удаление действием из списка                           | @deatheh       |
 | 6   | Форма пользователя (создание/редактирование) | `/fxml/UserForm.fxml` (новая)        | `ADMIN`           | `create` через `RegisterData`, `update` через `UpdateUserData`, `getById` для предзаполнения                    | @deatheh       |
@@ -58,6 +58,11 @@ UI не ходит в HTTP напрямую. Контроллер вызывае
 * №1: ✅ готово — `LoginFormController` только email + пароль, вызов `AuthService`.
 * №2: ✅ переименование `Search.fxml → ResourceList.fxml` готово; наполнить список:
   `ResourceService.search` + пагинация, фильтры `ResourceFilter(title, description)`.
+* №3: ✅ готово — `ResourceDetailsController` (read-only): метаданные + таблица файлов
+  со скачиванием (`FileService.downloadFile`), вход из №2 — `Navigator.goTo(path, c -> ...)`
+  с `setResourceId(uuid)` + `load()`.
+* Роли: `AuthServiceImpl.hasRole` сравнивает по уровню (`USER=0 < MODER=1 < ADMIN=2`),
+  поэтому `isModerator()` возвращает true и для `ADMIN` — соответствует RBAC выше.
 * SoC: списки (№2, №5) не содержат логики форм; формы (№4, №6) работают в двух режимах `create/edit` по наличию `uuid`, валидация через существующие `validation/*Validator`.
 * Кнопки create/edit/delete рендерятся по роли из `Session.getCurrentUser().role`, а не отдельными страницами.
 
diff --git a/src/test/java/services/AuthServiceTest.java b/src/test/java/services/AuthServiceTest.java
new file mode 100644
index 0000000..9fb580d
--- /dev/null
+++ b/src/test/java/services/AuthServiceTest.java
@@ -0,0 +1,70 @@
+package services;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.mock;
+
+import com.DesktopApplicationClientJava.Api.ApiClient;
+import com.DesktopApplicationClientJava.entities.Role;
+import com.DesktopApplicationClientJava.entities.User;
+import com.DesktopApplicationClientJava.services.AuthService;
+import com.DesktopApplicationClientJava.services.impl.AuthServiceImpl;
+import com.DesktopApplicationClientJava.session.Session;
+import java.util.UUID;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+class AuthServiceTest {
+
+  private Session session;
+  private AuthService authService;
+
+  @BeforeEach
+  void setUp() {
+    session = new Session();
+    authService = new AuthServiceImpl(mock(ApiClient.class), session);
+  }
+
+  @Test
+  void guestHasNoRoles() {
+    assertFalse(authService.hasRole(Role.USER));
+    assertFalse(authService.hasRole(Role.MODER));
+    assertFalse(authService.hasRole(Role.ADMIN));
+  }
+
+  @Test
+  void userHasOnlyUserRole() {
+    loginAs(Role.USER);
+
+    assertTrue(authService.hasRole(Role.USER));
+    assertFalse(authService.hasRole(Role.MODER));
+    assertFalse(authService.hasRole(Role.ADMIN));
+  }
+
+  @Test
+  void moderHasUserAndModerRolesButIsNotAdmin() {
+    loginAs(Role.MODER);
+
+    assertTrue(authService.hasRole(Role.USER));
+    assertTrue(authService.hasRole(Role.MODER));
+    assertFalse(authService.hasRole(Role.ADMIN));
+    assertTrue(authService.isModerator());
+    assertFalse(authService.isAdmin());
+  }
+
+  @Test
+  void adminHasAllRoles() {
+    loginAs(Role.ADMIN);
+
+    assertTrue(authService.hasRole(Role.USER));
+    assertTrue(authService.hasRole(Role.MODER));
+    assertTrue(authService.hasRole(Role.ADMIN));
+    assertTrue(authService.isModerator());
+    assertTrue(authService.isAdmin());
+  }
+
+  private void loginAs(Role role) {
+    session.setCurrentUser(
+        new User(UUID.randomUUID(), "user@example.com", role, "Имя", "Фамилия", true));
+  }
+}
diff --git a/src/test/java/ui/ResourceDetailsControllerTest.java b/src/test/java/ui/ResourceDetailsControllerTest.java
new file mode 100644
index 0000000..0aa92ad
--- /dev/null
+++ b/src/test/java/ui/ResourceDetailsControllerTest.java
@@ -0,0 +1,192 @@
+package ui;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+import static org.mockito.Mockito.when;
+
+import com.DesktopApplicationClientJava.controllers.ResourceDetailsController;
+import com.DesktopApplicationClientJava.entities.FileInfo;
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.navigation.Navigator;
+import com.DesktopApplicationClientJava.services.FileService;
+import com.DesktopApplicationClientJava.services.ResourceService;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import com.DesktopApplicationClientJava.services.ServiceRegistry;
+import com.DesktopApplicationClientJava.session.Session;
+import com.DesktopApplicationClientJava.utils.ControllerWiring;
+import java.io.File;
+import java.nio.file.Path;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.UUID;
+import javafx.fxml.FXMLLoader;
+import javafx.scene.Parent;
+import javafx.scene.Scene;
+import javafx.scene.control.Label;
+import javafx.scene.control.TableView;
+import javafx.stage.Stage;
+import javafx.stage.Window;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.junit.jupiter.api.io.TempDir;
+import org.testfx.api.FxRobot;
+import org.testfx.framework.junit5.ApplicationExtension;
+import org.testfx.framework.junit5.Start;
+
+@ExtendWith(ApplicationExtension.class)
+class ResourceDetailsControllerTest {
+
+  private static final UUID RESOURCE_ID = UUID.randomUUID();
+  private static final UUID FILE_ID_1 = UUID.randomUUID();
+  private static final UUID FILE_ID_2 = UUID.randomUUID();
+
+  private ResourceService resourceService;
+  private FileService fileService;
+  private Navigator navigator;
+  private TestableResourceDetailsController controller;
+
+  static class TestableResourceDetailsController extends ResourceDetailsController {
+    private File directory;
+
+    void setDirectory(File directory) {
+      this.directory = directory;
+    }
+
+    @Override
+    protected File chooseDirectory(Window owner) {
+      return directory;
+    }
+  }
+
+  @Start
+  void start(Stage stage) throws Exception {
+    resourceService = mock(ResourceService.class);
+    fileService = mock(FileService.class);
+    ServiceRegistry services = mock(ServiceRegistry.class);
+    when(services.getResourceService()).thenReturn(resourceService);
+    when(services.getFileService()).thenReturn(fileService);
+    navigator = mock(Navigator.class);
+
+    controller = new TestableResourceDetailsController();
+    FXMLLoader loader = new FXMLLoader(getClass().getResource("/fxml/ResourceDetails.fxml"));
+    loader.setControllerFactory(clazz -> controller);
+    ControllerWiring.wire(controller, navigator, new Session(), services);
+    Parent root = loader.load();
+    stage.setScene(new Scene(root));
+    stage.show();
+  }
+
+  @Test
+  void successfulLoadShowsMetadataAndFiles(FxRobot robot) {
+    when(resourceService.getById(RESOURCE_ID)).thenReturn(resourceWithFiles());
+    loadPage(robot);
+
+    assertEquals("Годовой отчёт", textOf(robot, "#titleLabel"));
+    assertEquals("Описание ресурса", textOf(robot, "#descriptionLabel"));
+    assertEquals("06.05.2024 07:08", textOf(robot, "#createdLabel"));
+    assertEquals("07.05.2024 09:10", textOf(robot, "#updatedLabel"));
+    assertEquals(RESOURCE_ID.toString(), textOf(robot, "#uuidLabel"));
+
+    TableView<FileInfo> table = filesTable(robot);
+    assertEquals(2, table.getItems().size());
+    assertEquals("report.pdf", table.getItems().get(0).getName());
+    assertEquals("photo.png", table.getItems().get(1).getName());
+    assertFalse(robot.lookup("#errorLabel").queryAs(Label.class).isVisible());
+  }
+
+  @Test
+  void resourceNotFoundShowsErrorAndLeavesTableEmpty(FxRobot robot) {
+    when(resourceService.getById(RESOURCE_ID)).thenThrow(new ServiceException("Ресурс не найден"));
+    loadPage(robot);
+
+    Label error = robot.lookup("#errorLabel").queryAs(Label.class);
+    assertTrue(error.isVisible());
+    assertEquals("Ресурс не найден", error.getText());
+    assertTrue(filesTable(robot).getItems().isEmpty());
+    verifyNoInteractions(navigator);
+  }
+
+  @Test
+  void downloadSavesFileAndShowsStatus(FxRobot robot, @TempDir Path tempDir) {
+    when(resourceService.getById(RESOURCE_ID)).thenReturn(resourceWithFiles());
+    loadPage(robot);
+
+    controller.setDirectory(tempDir.toFile());
+    Path saved = tempDir.resolve("report.pdf");
+    when(fileService.downloadFile(eq(RESOURCE_ID), eq(FILE_ID_1), any())).thenReturn(saved);
+
+    robot.clickOn("Скачать");
+
+    verify(fileService).downloadFile(RESOURCE_ID, FILE_ID_1, tempDir);
+    assertEquals("Сохранено: report.pdf", textOf(robot, "#statusLabel"));
+  }
+
+  @Test
+  void downloadErrorShowsInErrorLabel(FxRobot robot, @TempDir Path tempDir) {
+    when(resourceService.getById(RESOURCE_ID)).thenReturn(resourceWithFiles());
+    loadPage(robot);
+
+    controller.setDirectory(tempDir.toFile());
+    when(fileService.downloadFile(eq(RESOURCE_ID), eq(FILE_ID_1), any()))
+        .thenThrow(new ServiceException("Файл недоступен"));
+
+    robot.clickOn("Скачать");
+
+    Label error = robot.lookup("#errorLabel").queryAs(Label.class);
+    assertTrue(error.isVisible());
+    assertEquals("Файл недоступен", error.getText());
+  }
+
+  @Test
+  void cancelledDirectoryChooserDoesNotCallDownload(FxRobot robot) {
+    when(resourceService.getById(RESOURCE_ID)).thenReturn(resourceWithFiles());
+    loadPage(robot);
+
+    controller.setDirectory(null);
+    robot.clickOn("Скачать");
+
+    verifyNoInteractions(fileService);
+  }
+
+  @Test
+  void backNavigatesToResourceList(FxRobot robot) {
+    robot.clickOn("#backButton");
+
+    verify(navigator).goTo("/fxml/ResourceList.fxml");
+  }
+
+  private void loadPage(FxRobot robot) {
+    robot.interact(
+        () -> {
+          controller.setResourceId(RESOURCE_ID);
+          controller.load();
+        });
+  }
+
+  private Resource resourceWithFiles() {
+    FileInfo first = new FileInfo(FILE_ID_1, "report.pdf", "application/pdf", 12345L);
+    FileInfo second = new FileInfo(FILE_ID_2, "photo.png", "image/png", 678L);
+    return new Resource(
+        RESOURCE_ID,
+        "Годовой отчёт",
+        "Описание ресурса",
+        LocalDateTime.of(2024, 5, 6, 7, 8),
+        LocalDateTime.of(2024, 5, 7, 9, 10),
+        List.of(first, second));
+  }
+
+  private static String textOf(FxRobot robot, String query) {
+    return robot.lookup(query).queryAs(Label.class).getText();
+  }
+
+  @SuppressWarnings("unchecked")
+  private static TableView<FileInfo> filesTable(FxRobot robot) {
+    return robot.lookup("#filesTable").queryAs(TableView.class);
+  }
+}
diff --git a/src/test/java/ui/ResourceDetailsIntegrationTest.java b/src/test/java/ui/ResourceDetailsIntegrationTest.java
new file mode 100644
index 0000000..9ad08ee
--- /dev/null
+++ b/src/test/java/ui/ResourceDetailsIntegrationTest.java
@@ -0,0 +1,83 @@
+package ui;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assumptions.assumeTrue;
+
+import com.DesktopApplicationClientJava.Api.ApiClient;
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.services.AuthService;
+import com.DesktopApplicationClientJava.services.ResourceService;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import com.DesktopApplicationClientJava.services.impl.AuthServiceImpl;
+import com.DesktopApplicationClientJava.services.impl.ResourceServiceImpl;
+import com.DesktopApplicationClientJava.session.Session;
+import java.io.IOException;
+import java.net.InetSocketAddress;
+import java.net.Socket;
+import java.util.UUID;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Tag;
+import org.junit.jupiter.api.Test;
+
+/**
+ * Integration test for the resource details flow: real services with a real {@link ApiClient}, no
+ * mocks. Requires a running backend at {@code localhost:8080}; otherwise tests are aborted.
+ *
+ * <p>Excluded from the default build and CI (see surefire {@code excludedGroups} in pom.xml). Run
+ * explicitly: {@code mvn test -Dgroups=integration -DexcludedGroups=}
+ */
+@Tag("integration")
+class ResourceDetailsIntegrationTest {
+
+  // Seed admin of the local dev backend. Password only from the environment (see
+  // .env.example); the test is skipped when it is not set. No secrets in source.
+  private static final String ADMIN_EMAIL =
+      System.getenv().getOrDefault("IT_ADMIN_EMAIL", "admin@example.com");
+  private static final String ADMIN_PASSWORD = System.getenv("IT_ADMIN_PASSWORD");
+
+  private AuthService authService;
+  private ResourceService resourceService;
+
+  @BeforeEach
+  void setUp() {
+    assumeTrue(isBackendUp(), "Backend is not running at localhost:8080, skipping");
+    Session session = new Session();
+    ApiClient apiClient = new ApiClient(session);
+    authService = new AuthServiceImpl(apiClient, session);
+    resourceService = new ResourceServiceImpl(apiClient);
+  }
+
+  @Test
+  void unknownIdThrowsServiceException() {
+    assertThrows(ServiceException.class, () -> resourceService.getById(UUID.randomUUID()));
+  }
+
+  @Test
+  void createdResourceRoundTrip() {
+    assumeTrue(
+        ADMIN_PASSWORD != null && !ADMIN_PASSWORD.isBlank(),
+        "IT_ADMIN_PASSWORD is not set, skipping");
+    authService.login(ADMIN_EMAIL, ADMIN_PASSWORD);
+    String title = "IT ResourceDetails " + UUID.randomUUID();
+    Resource created = resourceService.create(title, "created by integration test");
+    try {
+      Resource fetched = resourceService.getById(created.getUuid());
+      assertEquals(created.getUuid(), fetched.getUuid());
+      assertEquals(title, fetched.getTitle());
+      assertNotNull(fetched.getFiles());
+    } finally {
+      resourceService.delete(created.getUuid());
+    }
+  }
+
+  private static boolean isBackendUp() {
+    try (Socket socket = new Socket()) {
+      socket.connect(new InetSocketAddress("localhost", 8080), 2000);
+      return true;
+    } catch (IOException e) {
+      return false;
+    }
+  }
+}

From 5a9193f1bf5071f6e64ab85a848a4d4eadaa73dc Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 16:55:13 +0300
Subject: [PATCH 03/10] fix(api): tolerate unknown JSON properties from backend
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Бэкенд возвращает firstname/lastname вместо firstName/lastName — строгий ObjectMapper ронял getMe в IOException (маскировался под ошибку соединения). Любой успешный логин против живого API падал.
---
 .../java/com/DesktopApplicationClientJava/Api/ApiClient.java    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java b/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java
index 83425e8..97669bb 100644
--- a/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java
+++ b/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java
@@ -14,6 +14,7 @@
 import com.DesktopApplicationClientJava.Api.Dto.response.ResourceDto;
 import com.DesktopApplicationClientJava.Api.Dto.response.UserDto;
 import com.DesktopApplicationClientJava.session.Session;
+import com.fasterxml.jackson.databind.DeserializationFeature;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
 import java.io.ByteArrayOutputStream;
@@ -49,6 +50,7 @@ public ApiClient(Session session) {
             .build();
     this.objectMapper = new ObjectMapper();
     this.objectMapper.registerModule(new JavaTimeModule());
+    this.objectMapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
   }
 
   // ======================== AUTH ========================

From 4b05546d0351690f91a5fe807203294dd785e4f5 Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 16:56:38 +0300
Subject: [PATCH 04/10] chore(api): mark lenient ObjectMapper as temporary
 FIXME
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

FAIL_ON_UNKNOWN_PROPERTIES — временный костыль под firstname/lastname бэкенда. Убрать, когда бэкенд перейдёт на camelCase.
---
 .../java/com/DesktopApplicationClientJava/Api/ApiClient.java    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java b/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java
index 97669bb..a2c7692 100644
--- a/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java
+++ b/src/main/java/com/DesktopApplicationClientJava/Api/ApiClient.java
@@ -50,6 +50,8 @@ public ApiClient(Session session) {
             .build();
     this.objectMapper = new ObjectMapper();
     this.objectMapper.registerModule(new JavaTimeModule());
+    // FIXME: temporary — backend returns firstname/lastname instead of firstName/lastName.
+    // Remove once backend uses camelCase; then unknown properties should fail fast again.
     this.objectMapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
   }
 

From 857c22c46dcb9cee98c25fced48c4474e03051d6 Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 17:28:17 +0300
Subject: [PATCH 05/10] test(it): shared base for integration tests with dotenv
 credentials
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Интеграционные тесты тащили дублирующийся сетап (проверка бэкенда, сервисы, креды) и захардкоженный пароль сид-админа, на который ругнулся GitGuardian.

- Общая база ui.integration.IntegrationTestCase: .env через dotenv-java (JUnit/Surefire сами .env не читают, путь приходит из surefire dotenv.path), проверка живого бэкенда, инициализация сервисов.

- Пароль только из окружения или .env (IT_ADMIN_PASSWORD); без него тест скипается через assumeTrue. Секретов в исходниках больше нет, переменные IT_* задокументированы в .env.example.

- Тесты переехали в ui/integration/, @Tag("integration") наследуется от базы.
---
 .env.example                                  |  6 ++
 pom.xml                                       | 11 +++
 src/test/java/ui/LoginIntegrationTest.java    | 52 ------------
 .../ui/ResourceDetailsIntegrationTest.java    | 83 -------------------
 .../ui/integration/IntegrationTestCase.java   | 67 +++++++++++++++
 .../ui/integration/LoginIntegrationTest.java  | 24 ++++++
 .../ResourceDetailsIntegrationTest.java       | 44 ++++++++++
 7 files changed, 152 insertions(+), 135 deletions(-)
 delete mode 100644 src/test/java/ui/LoginIntegrationTest.java
 delete mode 100644 src/test/java/ui/ResourceDetailsIntegrationTest.java
 create mode 100644 src/test/java/ui/integration/IntegrationTestCase.java
 create mode 100644 src/test/java/ui/integration/LoginIntegrationTest.java
 create mode 100644 src/test/java/ui/integration/ResourceDetailsIntegrationTest.java

diff --git a/.env.example b/.env.example
index 85b7177..ebf119e 100644
--- a/.env.example
+++ b/.env.example
@@ -17,3 +17,9 @@ MINIO_ROOT_PASSWORD=changeme-minio-root
 MINIO_BUCKET_NAME=local-bucket
 MINIO_ACCESS_TOKEN=changeme-access
 MINIO_SECRET_KEY=changeme-secret
+
+# --- Integration tests (mvn test -Dgroups=integration -DexcludedGroups=) ---
+# Seed admin of the local dev backend; used by *IntegrationTest (skipped if unset).
+# Never commit real values here.
+IT_ADMIN_EMAIL=admin@example.com
+IT_ADMIN_PASSWORD=changeme
diff --git a/pom.xml b/pom.xml
index 9c44ee1..f37843e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -73,6 +73,12 @@
             <version>2.2</version>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>io.github.cdimascio</groupId>
+            <artifactId>dotenv-java</artifactId>
+            <version>3.2.0</version>
+            <scope>test</scope>
+        </dependency>
         <dependency>
             <groupId>org.openjfx</groupId>
             <artifactId>javafx-controls</artifactId>
@@ -146,6 +152,11 @@
                         Run them explicitly:
                         mvn test -Dgroups=integration -DexcludedGroups= -->
                     <excludedGroups>${excludedGroups}</excludedGroups>
+                    <!-- Path to the local .env file for integration tests (java-dotenv).
+                        Missing file is fine: tests skip via assumeTrue. -->
+                    <systemPropertyVariables>
+                        <dotenv.path>${project.basedir}/.env</dotenv.path>
+                    </systemPropertyVariables>
                 </configuration>
             </plugin>
             <plugin>
diff --git a/src/test/java/ui/LoginIntegrationTest.java b/src/test/java/ui/LoginIntegrationTest.java
deleted file mode 100644
index 152e18f..0000000
--- a/src/test/java/ui/LoginIntegrationTest.java
+++ /dev/null
@@ -1,52 +0,0 @@
-package ui;
-
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assumptions.assumeTrue;
-
-import com.DesktopApplicationClientJava.Api.ApiClient;
-import com.DesktopApplicationClientJava.services.AuthService;
-import com.DesktopApplicationClientJava.services.ServiceException;
-import com.DesktopApplicationClientJava.services.impl.AuthServiceImpl;
-import com.DesktopApplicationClientJava.session.Session;
-import java.io.IOException;
-import java.net.InetSocketAddress;
-import java.net.Socket;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Tag;
-import org.junit.jupiter.api.Test;
-
-/**
- * Integration test for the login flow: real {@link AuthService} with a real {@link ApiClient}, no
- * mocks. Requires a running backend at {@code localhost:8080}; otherwise tests are aborted.
- *
- * <p>Excluded from the default build and CI (see surefire {@code excludedGroups} in pom.xml). Run
- * explicitly: {@code mvn test -Dgroups=integration -DexcludedGroups=}
- */
-@Tag("integration")
-class LoginIntegrationTest {
-
-  private AuthService authService;
-
-  @BeforeEach
-  void setUp() {
-    assumeTrue(isBackendUp(), "Backend is not running at localhost:8080, skipping");
-    Session session = new Session();
-    authService = new AuthServiceImpl(new ApiClient(session), session);
-  }
-
-  @Test
-  void invalidCredentialsAreRejectedByRealApi() {
-    assertThrows(
-        ServiceException.class,
-        () -> authService.login("no-such-user@example.com", "wrong-password-123"));
-  }
-
-  private static boolean isBackendUp() {
-    try (Socket socket = new Socket()) {
-      socket.connect(new InetSocketAddress("localhost", 8080), 2000);
-      return true;
-    } catch (IOException e) {
-      return false;
-    }
-  }
-}
diff --git a/src/test/java/ui/ResourceDetailsIntegrationTest.java b/src/test/java/ui/ResourceDetailsIntegrationTest.java
deleted file mode 100644
index 9ad08ee..0000000
--- a/src/test/java/ui/ResourceDetailsIntegrationTest.java
+++ /dev/null
@@ -1,83 +0,0 @@
-package ui;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assumptions.assumeTrue;
-
-import com.DesktopApplicationClientJava.Api.ApiClient;
-import com.DesktopApplicationClientJava.entities.Resource;
-import com.DesktopApplicationClientJava.services.AuthService;
-import com.DesktopApplicationClientJava.services.ResourceService;
-import com.DesktopApplicationClientJava.services.ServiceException;
-import com.DesktopApplicationClientJava.services.impl.AuthServiceImpl;
-import com.DesktopApplicationClientJava.services.impl.ResourceServiceImpl;
-import com.DesktopApplicationClientJava.session.Session;
-import java.io.IOException;
-import java.net.InetSocketAddress;
-import java.net.Socket;
-import java.util.UUID;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Tag;
-import org.junit.jupiter.api.Test;
-
-/**
- * Integration test for the resource details flow: real services with a real {@link ApiClient}, no
- * mocks. Requires a running backend at {@code localhost:8080}; otherwise tests are aborted.
- *
- * <p>Excluded from the default build and CI (see surefire {@code excludedGroups} in pom.xml). Run
- * explicitly: {@code mvn test -Dgroups=integration -DexcludedGroups=}
- */
-@Tag("integration")
-class ResourceDetailsIntegrationTest {
-
-  // Seed admin of the local dev backend. Password only from the environment (see
-  // .env.example); the test is skipped when it is not set. No secrets in source.
-  private static final String ADMIN_EMAIL =
-      System.getenv().getOrDefault("IT_ADMIN_EMAIL", "admin@example.com");
-  private static final String ADMIN_PASSWORD = System.getenv("IT_ADMIN_PASSWORD");
-
-  private AuthService authService;
-  private ResourceService resourceService;
-
-  @BeforeEach
-  void setUp() {
-    assumeTrue(isBackendUp(), "Backend is not running at localhost:8080, skipping");
-    Session session = new Session();
-    ApiClient apiClient = new ApiClient(session);
-    authService = new AuthServiceImpl(apiClient, session);
-    resourceService = new ResourceServiceImpl(apiClient);
-  }
-
-  @Test
-  void unknownIdThrowsServiceException() {
-    assertThrows(ServiceException.class, () -> resourceService.getById(UUID.randomUUID()));
-  }
-
-  @Test
-  void createdResourceRoundTrip() {
-    assumeTrue(
-        ADMIN_PASSWORD != null && !ADMIN_PASSWORD.isBlank(),
-        "IT_ADMIN_PASSWORD is not set, skipping");
-    authService.login(ADMIN_EMAIL, ADMIN_PASSWORD);
-    String title = "IT ResourceDetails " + UUID.randomUUID();
-    Resource created = resourceService.create(title, "created by integration test");
-    try {
-      Resource fetched = resourceService.getById(created.getUuid());
-      assertEquals(created.getUuid(), fetched.getUuid());
-      assertEquals(title, fetched.getTitle());
-      assertNotNull(fetched.getFiles());
-    } finally {
-      resourceService.delete(created.getUuid());
-    }
-  }
-
-  private static boolean isBackendUp() {
-    try (Socket socket = new Socket()) {
-      socket.connect(new InetSocketAddress("localhost", 8080), 2000);
-      return true;
-    } catch (IOException e) {
-      return false;
-    }
-  }
-}
diff --git a/src/test/java/ui/integration/IntegrationTestCase.java b/src/test/java/ui/integration/IntegrationTestCase.java
new file mode 100644
index 0000000..c3f0a22
--- /dev/null
+++ b/src/test/java/ui/integration/IntegrationTestCase.java
@@ -0,0 +1,67 @@
+package ui.integration;
+
+import static org.junit.jupiter.api.Assumptions.assumeTrue;
+
+import com.DesktopApplicationClientJava.Api.ApiClient;
+import com.DesktopApplicationClientJava.services.AuthService;
+import com.DesktopApplicationClientJava.services.ResourceService;
+import com.DesktopApplicationClientJava.services.impl.AuthServiceImpl;
+import com.DesktopApplicationClientJava.services.impl.ResourceServiceImpl;
+import com.DesktopApplicationClientJava.session.Session;
+import io.github.cdimascio.dotenv.Dotenv;
+import java.io.IOException;
+import java.net.InetSocketAddress;
+import java.net.Socket;
+import java.nio.file.Path;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Tag;
+
+@Tag("integration")
+public abstract class IntegrationTestCase {
+  static int timeoutMs = 1000;
+
+  protected static Dotenv dotenv;
+  protected static String adminEmail;
+  protected static String adminPassword;
+
+  protected AuthService authService;
+  protected ResourceService resourceService;
+
+  @BeforeAll
+  static void loadEnv() {
+    Path dotenvPath = Path.of(System.getProperty("dotenv.path", ".env")).toAbsolutePath();
+    dotenv =
+        Dotenv.configure()
+            .directory(dotenvPath.getParent().toString())
+            .filename(dotenvPath.getFileName().toString())
+            .ignoreIfMissing()
+            .load();
+
+    adminEmail = var("IT_ADMIN_EMAIL", "admin@example.com");
+    adminPassword = var("IT_ADMIN_PASSWORD", null);
+  }
+
+  @BeforeEach
+  void setUpServices() {
+    assumeTrue(isBackendUp(), "Backend is not running at localhost:8080, skipping");
+    Session session = new Session();
+    ApiClient apiClient = new ApiClient(session);
+    authService = new AuthServiceImpl(apiClient, session);
+    resourceService = new ResourceServiceImpl(apiClient);
+  }
+
+  protected static String var(String key, String fallback) {
+    return dotenv.get(key, fallback);
+  }
+
+  protected static boolean isBackendUp() {
+    try (Socket socket = new Socket()) {
+      socket.connect(
+          new InetSocketAddress("localhost", Integer.parseInt(var("port", "8080"))), timeoutMs);
+      return true;
+    } catch (IOException e) {
+      return false;
+    }
+  }
+}
diff --git a/src/test/java/ui/integration/LoginIntegrationTest.java b/src/test/java/ui/integration/LoginIntegrationTest.java
new file mode 100644
index 0000000..280963a
--- /dev/null
+++ b/src/test/java/ui/integration/LoginIntegrationTest.java
@@ -0,0 +1,24 @@
+package ui.integration;
+
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+import com.DesktopApplicationClientJava.services.ServiceException;
+import org.junit.jupiter.api.Test;
+
+/**
+ * Integration test for the login flow: real AuthService with a real ApiClient, no mocks. Requires a
+ * running backend at {@code localhost:8080}; otherwise tests are aborted.
+ *
+ * <p>Excluded from the default build and CI (see surefire {@code excludedGroups} in pom.xml). Run
+ * explicitly: {@code mvn test -Dgroups=integration -DexcludedGroups=} ({@code @Tag} inherited from
+ * IntegrationTestCase).
+ */
+class LoginIntegrationTest extends IntegrationTestCase {
+
+  @Test
+  void invalidCredentialsAreRejectedByRealApi() {
+    assertThrows(
+        ServiceException.class,
+        () -> authService.login("no-such-user@example.com", "wrong-password-123"));
+  }
+}
diff --git a/src/test/java/ui/integration/ResourceDetailsIntegrationTest.java b/src/test/java/ui/integration/ResourceDetailsIntegrationTest.java
new file mode 100644
index 0000000..8080b51
--- /dev/null
+++ b/src/test/java/ui/integration/ResourceDetailsIntegrationTest.java
@@ -0,0 +1,44 @@
+package ui.integration;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assumptions.assumeTrue;
+
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import java.util.UUID;
+import org.junit.jupiter.api.Test;
+
+/**
+ * Integration test for the resource details flow: real services with a real ApiClient, no mocks.
+ * Requires a running backend at {@code localhost:8080}; otherwise tests are aborted.
+ *
+ * <p>Excluded from the default build and CI (see surefire {@code excludedGroups} in pom.xml). Run
+ * explicitly: {@code mvn test -Dgroups=integration -DexcludedGroups=} ({@code @Tag} inherited from
+ * IntegrationTestCase).
+ */
+class ResourceDetailsIntegrationTest extends IntegrationTestCase {
+  @Test
+  void unknownIdThrowsServiceException() {
+    assertThrows(ServiceException.class, () -> resourceService.getById(UUID.randomUUID()));
+  }
+
+  @Test
+  void createdResourceRoundTrip() {
+    assumeTrue(
+        adminPassword != null && !adminPassword.isBlank(),
+        "IT_ADMIN_PASSWORD is not set, skipping");
+    authService.login(adminEmail, adminPassword);
+    String title = "IT ResourceDetails " + UUID.randomUUID();
+    Resource created = resourceService.create(title, "created by integration test");
+    try {
+      Resource fetched = resourceService.getById(created.getUuid());
+      assertEquals(created.getUuid(), fetched.getUuid());
+      assertEquals(title, fetched.getTitle());
+      assertNotNull(fetched.getFiles());
+    } finally {
+      resourceService.delete(created.getUuid());
+    }
+  }
+}

From 0f5f72b7e5f0f3bb1d555bfcbc056d746ac9f36a Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 17:45:07 +0300
Subject: [PATCH 06/10] feat(app): read initial page from environment
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

INITIAL_PAGE_PATH берётся из окружения с дефолтом /fxml/LoginForm.fxml — удобно стартовать сразу с нужной страницы для ручной проверки UI (например /fxml/ResourceDetails.fxml).

Переменная задокументирована в .env.example.
---
 .env.example                                                | 4 ++++
 src/main/java/com/DesktopApplicationClientJava/Program.java | 3 ++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/.env.example b/.env.example
index ebf119e..e72ec6f 100644
--- a/.env.example
+++ b/.env.example
@@ -18,6 +18,10 @@ MINIO_BUCKET_NAME=local-bucket
 MINIO_ACCESS_TOKEN=changeme-access
 MINIO_SECRET_KEY=changeme-secret
 
+# --- App ---
+# First page on startup (handy for manual UI checks, e.g. /fxml/ResourceDetails.fxml).
+INITIAL_PAGE_PATH=/fxml/LoginForm.fxml
+
 # --- Integration tests (mvn test -Dgroups=integration -DexcludedGroups=) ---
 # Seed admin of the local dev backend; used by *IntegrationTest (skipped if unset).
 # Never commit real values here.
diff --git a/src/main/java/com/DesktopApplicationClientJava/Program.java b/src/main/java/com/DesktopApplicationClientJava/Program.java
index b6750a0..91594e5 100644
--- a/src/main/java/com/DesktopApplicationClientJava/Program.java
+++ b/src/main/java/com/DesktopApplicationClientJava/Program.java
@@ -14,7 +14,8 @@
 import org.kordamp.bootstrapfx.BootstrapFX;
 
 public class Program extends Application {
-  private static final String INITIAL_PAGE_PATH = "/fxml/LoginForm.fxml";
+  private static final String INITIAL_PAGE_PATH =
+      System.getenv().getOrDefault("INITIAL_PAGE_PATH", "/fxml/LoginForm.fxml");
   private static final double WINDOW_WIDTH = 800.0;
   private static final double WINDOW_HEIGHT = 600.0;
 

From 01005b27f9efa4eb2e346bf17d0af1f8020254ad Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 18:08:38 +0300
Subject: [PATCH 07/10] feat(mock): in-memory mock backend behind
 MOCK_DATA=true
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Запуск UI без бэкенда: MOCK_DATA=true собирает ServiceRegistry.mock() вместо ApiClient-версии, окно помечается [MOCK].

- Новый пакет services.mock: MockStore с сидами, MockAuthService (роль по сиду или префиксу email), MockResourceService/MockUsersService (in-memory CRUD + фильтры), MockFileService (скачивание пишет реальный файл-плейсхолдер), MockExportService.

- Контракт MockService с default-хуком doIfInitialPage(); детали без id в мок-режиме сами открывают первый сид (иначе страница пуста).

- Покрыто MockServicesTest (10) и MockFlowTest (mock→UI, 3); MOCK_DATA задокументирована в .env.example.
---
 .env.example                                  |   2 +
 .../DesktopApplicationClientJava/Program.java |  13 +-
 .../ResourceDetailsController.java            |  23 ++++
 .../services/ServiceRegistry.java             |  55 +++++---
 .../services/mock/MockAuthService.java        |  94 +++++++++++++
 .../services/mock/MockExportService.java      |  39 ++++++
 .../services/mock/MockFileService.java        |  82 +++++++++++
 .../services/mock/MockResourceService.java    |  78 +++++++++++
 .../services/mock/MockService.java            |  14 ++
 .../services/mock/MockStore.java              |  96 +++++++++++++
 .../services/mock/MockUsersService.java       |  94 +++++++++++++
 .../java/services/mock/MockServicesTest.java  | 130 ++++++++++++++++++
 src/test/java/ui/MockFlowTest.java            |  97 +++++++++++++
 13 files changed, 794 insertions(+), 23 deletions(-)
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/services/mock/MockAuthService.java
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/services/mock/MockExportService.java
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/services/mock/MockFileService.java
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/services/mock/MockResourceService.java
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/services/mock/MockService.java
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/services/mock/MockStore.java
 create mode 100644 src/main/java/com/DesktopApplicationClientJava/services/mock/MockUsersService.java
 create mode 100644 src/test/java/services/mock/MockServicesTest.java
 create mode 100644 src/test/java/ui/MockFlowTest.java

diff --git a/.env.example b/.env.example
index e72ec6f..53bf5f9 100644
--- a/.env.example
+++ b/.env.example
@@ -21,6 +21,8 @@ MINIO_SECRET_KEY=changeme-secret
 # --- App ---
 # First page on startup (handy for manual UI checks, e.g. /fxml/ResourceDetails.fxml).
 INITIAL_PAGE_PATH=/fxml/LoginForm.fxml
+# Run without a backend, on in-memory mock data (for UI testing). Window title gets [MOCK].
+MOCK_DATA=false
 
 # --- Integration tests (mvn test -Dgroups=integration -DexcludedGroups=) ---
 # Seed admin of the local dev backend; used by *IntegrationTest (skipped if unset).
diff --git a/src/main/java/com/DesktopApplicationClientJava/Program.java b/src/main/java/com/DesktopApplicationClientJava/Program.java
index 91594e5..9a02450 100644
--- a/src/main/java/com/DesktopApplicationClientJava/Program.java
+++ b/src/main/java/com/DesktopApplicationClientJava/Program.java
@@ -16,12 +16,14 @@
 public class Program extends Application {
   private static final String INITIAL_PAGE_PATH =
       System.getenv().getOrDefault("INITIAL_PAGE_PATH", "/fxml/LoginForm.fxml");
+  private static final boolean MOCK_DATA =
+      Boolean.parseBoolean(System.getenv().getOrDefault("MOCK_DATA", "false"));
   private static final double WINDOW_WIDTH = 800.0;
   private static final double WINDOW_HEIGHT = 600.0;
 
   private final Session session = new Session();
   private final ApiClient apiClient = new ApiClient(session);
-  private final ServiceRegistry services = new ServiceRegistry(apiClient, session);
+  private final ServiceRegistry services = createServices();
 
   public static void main(String[] args) {
     launch(args);
@@ -49,13 +51,20 @@ public void start(Stage stage) throws IOException {
     loadStyleSheet(scene, "/styles.css");
 
     stage.setScene(scene);
-    stage.setTitle("JavaFX Application");
+    stage.setTitle("JavaFX Application" + (MOCK_DATA ? " [MOCK]" : ""));
     stage.setWidth(WINDOW_WIDTH);
     stage.setHeight(WINDOW_HEIGHT);
     stage.centerOnScreen();
     stage.show();
   }
 
+  private ServiceRegistry createServices() {
+    if (MOCK_DATA) {
+      return ServiceRegistry.mock(session);
+    }
+    return new ServiceRegistry(apiClient, session);
+  }
+
   private void loadStyleSheet(Scene scene, String path) {
     var url = getClass().getResource(path);
     if (url != null) {
diff --git a/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java b/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
index 1f2b2b4..22bcc8c 100644
--- a/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
+++ b/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
@@ -4,6 +4,8 @@
 import com.DesktopApplicationClientJava.entities.FileInfo;
 import com.DesktopApplicationClientJava.entities.Resource;
 import com.DesktopApplicationClientJava.services.ServiceException;
+import com.DesktopApplicationClientJava.services.filter.ResourceFilter;
+import com.DesktopApplicationClientJava.services.mock.MockService;
 import java.io.File;
 import java.nio.file.Path;
 import java.time.LocalDateTime;
@@ -49,6 +51,7 @@ private void initialize() {
     sizeColumn.setCellValueFactory(new PropertyValueFactory<>("size"));
     contentTypeColumn.setCellValueFactory(new PropertyValueFactory<>("contentType"));
     downloadColumn.setCellFactory(col -> new DownloadCell(this::onDownload));
+    autoSelectFirstInMockMode();
   }
 
   public void setResourceId(UUID resourceId) {
@@ -86,6 +89,26 @@ protected File chooseDirectory(Window owner) {
     return new DirectoryChooser().showDialog(owner);
   }
 
+  /**
+   * Dev-only fallback: when the page is opened without an id (e.g. straight via INITIAL_PAGE_PATH)
+   * against a mock service, show the first seeded resource so the UI is clickable without the
+   * resource list. Never triggers against the real backend.
+   */
+  private void autoSelectFirstInMockMode() {
+    if (resourceId != null || !(services.getResourceService() instanceof MockService mock)) {
+      return;
+    }
+    mock.doIfInitialPage();
+    services.getResourceService().search(ResourceFilter.empty(), 0, 1).stream()
+        .map(Resource::getUuid)
+        .findFirst()
+        .ifPresent(
+            id -> {
+              setResourceId(id);
+              load();
+            });
+  }
+
   private void showResource(Resource resource) {
     titleLabel.setText(resource.getTitle());
     descriptionLabel.setText(resource.getDescription());
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java b/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java
index e5d2d7c..091096e 100644
--- a/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java
+++ b/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java
@@ -2,8 +2,16 @@
 
 import com.DesktopApplicationClientJava.Api.ApiClient;
 import com.DesktopApplicationClientJava.services.impl.*;
+import com.DesktopApplicationClientJava.services.mock.MockAuthService;
+import com.DesktopApplicationClientJava.services.mock.MockExportService;
+import com.DesktopApplicationClientJava.services.mock.MockFileService;
+import com.DesktopApplicationClientJava.services.mock.MockResourceService;
+import com.DesktopApplicationClientJava.services.mock.MockStore;
+import com.DesktopApplicationClientJava.services.mock.MockUsersService;
 import com.DesktopApplicationClientJava.session.Session;
+import lombok.Getter;
 
+@Getter
 public class ServiceRegistry {
   private final AuthService authService;
   private final UsersService usersService;
@@ -12,30 +20,35 @@ public class ServiceRegistry {
   private final ExportService exportService;
 
   public ServiceRegistry(ApiClient apiClient, Session session) {
-    this.authService = new AuthServiceImpl(apiClient, session);
-    this.usersService = new UsersServiceImpl(apiClient);
-    this.resourceService = new ResourceServiceImpl(apiClient);
-    this.fileService = new FileServiceImpl(apiClient);
-    this.exportService = new ExportServiceImpl(apiClient);
+    this(
+        new AuthServiceImpl(apiClient, session),
+        new UsersServiceImpl(apiClient),
+        new ResourceServiceImpl(apiClient),
+        new FileServiceImpl(apiClient),
+        new ExportServiceImpl(apiClient));
   }
 
-  public AuthService getAuthService() {
-    return authService;
+  public ServiceRegistry(
+      AuthService authService,
+      UsersService usersService,
+      ResourceService resourceService,
+      FileService fileService,
+      ExportService exportService) {
+    this.authService = authService;
+    this.usersService = usersService;
+    this.resourceService = resourceService;
+    this.fileService = fileService;
+    this.exportService = exportService;
   }
 
-  public ExportService getExportService() {
-    return exportService;
-  }
-
-  public FileService getFileService() {
-    return fileService;
-  }
-
-  public ResourceService getResourceService() {
-    return resourceService;
-  }
-
-  public UsersService getUsersService() {
-    return usersService;
+  /** In-memory services for UI testing without a backend (see MOCK_DATA in Program). */
+  public static ServiceRegistry mock(Session session) {
+    MockStore store = new MockStore();
+    return new ServiceRegistry(
+        new MockAuthService(store, session),
+        new MockUsersService(store),
+        new MockResourceService(store),
+        new MockFileService(store),
+        new MockExportService());
   }
 }
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/mock/MockAuthService.java b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockAuthService.java
new file mode 100644
index 0000000..549a8a1
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockAuthService.java
@@ -0,0 +1,94 @@
+package com.DesktopApplicationClientJava.services.mock;
+
+import com.DesktopApplicationClientJava.entities.Role;
+import com.DesktopApplicationClientJava.entities.User;
+import com.DesktopApplicationClientJava.services.AuthService;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import com.DesktopApplicationClientJava.session.Session;
+import java.util.UUID;
+
+/**
+ * In-memory {@link AuthService}. Accepts any non-blank credentials; the role comes from the seeded
+ * user when the email matches, otherwise from the email prefix ({@code admin*} → ADMIN, {@code
+ * moder*} → MODER, anything else → USER).
+ */
+public class MockAuthService implements AuthService, MockService {
+
+  private final MockStore store;
+  private final Session session;
+
+  public MockAuthService(MockStore store, Session session) {
+    this.store = store;
+    this.session = session;
+  }
+
+  @Override
+  public User login(String email, String password) {
+    if (email == null || email.isBlank() || password == null || password.isBlank()) {
+      throw new ServiceException("Неверный логин или пароль", 401);
+    }
+    User user = findByEmail(email);
+    if (user == null) {
+      user = new User(UUID.randomUUID(), email.trim(), roleByEmail(email), "Мок", "", true);
+    }
+    session.setCurrentUser(user);
+    return user;
+  }
+
+  @Override
+  public void logout() {
+    session.clear();
+  }
+
+  @Override
+  public User getCurrentUser() {
+    return session.getCurrentUser();
+  }
+
+  @Override
+  public boolean hasRole(Role required) {
+    User current = session.getCurrentUser();
+    return current != null
+        && current.getRole() != null
+        && level(current.getRole()) >= level(required);
+  }
+
+  @Override
+  public boolean isAdmin() {
+    return hasRole(Role.ADMIN);
+  }
+
+  @Override
+  public boolean isModerator() {
+    return hasRole(Role.MODER);
+  }
+
+  private User findByEmail(String email) {
+    String normalized = email.trim();
+    return store.getUsers().values().stream()
+        .filter(user -> user.getEmail().equalsIgnoreCase(normalized))
+        .findFirst()
+        .orElse(null);
+  }
+
+  private static Role roleByEmail(String email) {
+    String local = email.trim().toLowerCase();
+    int at = local.indexOf('@');
+    String prefix = at < 0 ? local : local.substring(0, at);
+    if (prefix.startsWith("admin")) {
+      return Role.ADMIN;
+    }
+    if (prefix.startsWith("moder")) {
+      return Role.MODER;
+    }
+    return Role.USER;
+  }
+
+  private static int level(Role role) {
+    return switch (role) {
+      case USER -> 0;
+      case MODER -> 1;
+      case ADMIN -> 2;
+    };
+  }
+}
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/mock/MockExportService.java b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockExportService.java
new file mode 100644
index 0000000..3f937eb
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockExportService.java
@@ -0,0 +1,39 @@
+package com.DesktopApplicationClientJava.services.mock;
+
+import com.DesktopApplicationClientJava.services.ExportService;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.UUID;
+
+/** In-memory {@link ExportService}. Writes small placeholder files. */
+public class MockExportService implements ExportService, MockService {
+
+  @Override
+  public Path exportUsers(Path destinationDir) {
+    return write(destinationDir, "export-users.txt", "mock users export\n");
+  }
+
+  @Override
+  public Path exportResources(Path destinationDir) {
+    return write(destinationDir, "export-resources.txt", "mock resources export\n");
+  }
+
+  @Override
+  public Path exportResourceFiles(UUID resourceUuid, Path destinationDir) {
+    return write(destinationDir, "export-resource-" + resourceUuid + ".txt", "mock files export\n");
+  }
+
+  private static Path write(Path destinationDir, String fileName, String content) {
+    try {
+      Files.createDirectories(destinationDir);
+      Path saved = destinationDir.resolve(fileName);
+      Files.write(saved, content.getBytes(StandardCharsets.UTF_8));
+      return saved;
+    } catch (IOException e) {
+      throw new ServiceException("Ошибка записи файла");
+    }
+  }
+}
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/mock/MockFileService.java b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockFileService.java
new file mode 100644
index 0000000..baadbd8
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockFileService.java
@@ -0,0 +1,82 @@
+package com.DesktopApplicationClientJava.services.mock;
+
+import com.DesktopApplicationClientJava.entities.FileInfo;
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.services.FileService;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.UUID;
+
+/** In-memory {@link FileService}. Downloads produce a real file with placeholder content. */
+public class MockFileService implements FileService, MockService {
+
+  private final MockStore store;
+
+  public MockFileService(MockStore store) {
+    this.store = store;
+  }
+
+  @Override
+  public FileInfo uploadFile(UUID resourceId, Path file) {
+    Resource resource = findResource(resourceId);
+    try {
+      byte[] bytes = Files.readAllBytes(file);
+      String contentType = Files.probeContentType(file);
+      FileInfo info =
+          new FileInfo(
+              UUID.randomUUID(),
+              file.getFileName().toString(),
+              contentType == null ? "application/octet-stream" : contentType,
+              (long) bytes.length);
+      resource.getFiles().add(info);
+      store.getFileBytes().put(info.getUuid(), bytes);
+      return info;
+    } catch (IOException e) {
+      throw new ServiceException("Ошибка чтения файла");
+    }
+  }
+
+  @Override
+  public Path downloadFile(UUID resourceId, UUID fileId, Path destinationDir) {
+    Resource resource = findResource(resourceId);
+    FileInfo info =
+        resource.getFiles().stream()
+            .filter(file -> file.getUuid().equals(fileId))
+            .findFirst()
+            .orElseThrow(() -> new ServiceException("Файл не найден", 404));
+    byte[] bytes =
+        store
+            .getFileBytes()
+            .getOrDefault(
+                fileId, ("mock content of " + info.getName()).getBytes(StandardCharsets.UTF_8));
+    try {
+      Files.createDirectories(destinationDir);
+      Path saved = destinationDir.resolve(info.getName());
+      Files.write(saved, bytes);
+      return saved;
+    } catch (IOException e) {
+      throw new ServiceException("Ошибка записи файла");
+    }
+  }
+
+  @Override
+  public void deleteFile(UUID resourceId, UUID fileId) {
+    Resource resource = findResource(resourceId);
+    boolean removed = resource.getFiles().removeIf(file -> file.getUuid().equals(fileId));
+    if (!removed) {
+      throw new ServiceException("Файл не найден", 404);
+    }
+    store.getFileBytes().remove(fileId);
+  }
+
+  private Resource findResource(UUID resourceId) {
+    Resource resource = store.getResources().get(resourceId);
+    if (resource == null) {
+      throw new ServiceException("Ресурс не найден", 404);
+    }
+    return resource;
+  }
+}
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/mock/MockResourceService.java b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockResourceService.java
new file mode 100644
index 0000000..7689d38
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockResourceService.java
@@ -0,0 +1,78 @@
+package com.DesktopApplicationClientJava.services.mock;
+
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.services.ResourceService;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import com.DesktopApplicationClientJava.services.filter.ResourceFilter;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+
+/** In-memory {@link ResourceService} over {@link MockStore}. */
+public class MockResourceService implements ResourceService, MockService {
+
+  private final MockStore store;
+
+  public MockResourceService(MockStore store) {
+    this.store = store;
+  }
+
+  @Override
+  public List<Resource> search(ResourceFilter filter, long offset, long count) {
+    return store.getResources().values().stream()
+        .filter(resource -> matches(resource, filter))
+        .skip(Math.max(0, offset))
+        .limit(count <= 0 ? Long.MAX_VALUE : count)
+        .toList();
+  }
+
+  @Override
+  public Resource create(String title, String description) {
+    LocalDateTime now = LocalDateTime.now();
+    Resource resource =
+        new Resource(UUID.randomUUID(), title, description, now, now, new ArrayList<>());
+    store.getResources().put(resource.getUuid(), resource);
+    return resource;
+  }
+
+  @Override
+  public Resource getById(UUID resourceId) {
+    Resource resource = store.getResources().get(resourceId);
+    if (resource == null) {
+      throw new ServiceException("Ресурс не найден", 404);
+    }
+    return resource;
+  }
+
+  @Override
+  public Resource update(UUID resourceId, String title, String description) {
+    Resource resource = getById(resourceId);
+    resource.setTitle(title);
+    resource.setDescription(description);
+    resource.setUpdatedAt(LocalDateTime.now());
+    return resource;
+  }
+
+  @Override
+  public void delete(UUID resourceId) {
+    if (store.getResources().remove(resourceId) == null) {
+      throw new ServiceException("Ресурс не найден", 404);
+    }
+  }
+
+  private static boolean matches(Resource resource, ResourceFilter filter) {
+    if (filter == null) {
+      return true;
+    }
+    return contains(resource.getTitle(), filter.getTitle())
+        && contains(resource.getDescription(), filter.getDescription());
+  }
+
+  private static boolean contains(String value, String query) {
+    if (query == null || query.isBlank()) {
+      return true;
+    }
+    return value != null && value.toLowerCase().contains(query.toLowerCase());
+  }
+}
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/mock/MockService.java b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockService.java
new file mode 100644
index 0000000..be2fca6
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockService.java
@@ -0,0 +1,14 @@
+package com.DesktopApplicationClientJava.services.mock;
+
+/**
+ * Contract for in-memory demo services (see MOCK_DATA in Program).
+ *
+ * <p>UI may check for this interface to enable demo conveniences that must never trigger against
+ * the real backend. Override {@link #doIfInitialPage()} when a mock needs to prepare demo state on
+ * page init.
+ */
+public interface MockService {
+
+  /** Demo hook, no-op by default. */
+  default void doIfInitialPage() {}
+}
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/mock/MockStore.java b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockStore.java
new file mode 100644
index 0000000..3f205f6
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockStore.java
@@ -0,0 +1,96 @@
+package com.DesktopApplicationClientJava.services.mock;
+
+import com.DesktopApplicationClientJava.entities.FileInfo;
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.entities.Role;
+import com.DesktopApplicationClientJava.entities.User;
+import java.nio.charset.StandardCharsets;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+import lombok.Getter;
+
+/**
+ * In-memory data for mock services. Used only when the app runs with {@code MOCK_DATA=true}, for UI
+ * testing without a backend.
+ */
+@Getter
+public class MockStore {
+  private final Map<UUID, User> users = new LinkedHashMap<>();
+  private final Map<UUID, Resource> resources = new LinkedHashMap<>();
+  private final Map<UUID, byte[]> fileBytes = new LinkedHashMap<>();
+
+  public MockStore() {
+    seedUsers();
+    seedResources();
+  }
+
+  private void seedUsers() {
+    users.put(
+        UUID.fromString("11111111-1111-1111-1111-111111111111"),
+        new User(
+            UUID.fromString("11111111-1111-1111-1111-111111111111"),
+            "admin@example.com",
+            Role.ADMIN,
+            "Админ",
+            "Моковый",
+            true));
+    users.put(
+        UUID.fromString("22222222-2222-2222-2222-222222222222"),
+        new User(
+            UUID.fromString("22222222-2222-2222-2222-222222222222"),
+            "moder@example.com",
+            Role.MODER,
+            "Модер",
+            "Моковый",
+            true));
+    users.put(
+        UUID.fromString("33333333-3333-3333-3333-333333333333"),
+        new User(
+            UUID.fromString("33333333-3333-3333-3333-333333333333"),
+            "user@example.com",
+            Role.USER,
+            "Юзер",
+            "Моковый",
+            true));
+  }
+
+  private void seedResources() {
+    UUID resourceId = UUID.fromString("aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa");
+    FileInfo report =
+        new FileInfo(
+            UUID.fromString("bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"),
+            "report.pdf",
+            "application/pdf",
+            25L);
+    FileInfo data =
+        new FileInfo(
+            UUID.fromString("cccccccc-cccc-cccc-cccc-cccccccccccc"), "data.csv", "text/csv", 18L);
+    fileBytes.put(
+        report.getUuid(), "mock pdf content, not a real pdf".getBytes(StandardCharsets.UTF_8));
+    fileBytes.put(data.getUuid(), "id;name\n1;mock\n".getBytes(StandardCharsets.UTF_8));
+    resources.put(
+        resourceId,
+        new Resource(
+            resourceId,
+            "Годовой отчёт (мок)",
+            "Демонстрационный ресурс для проверки UI без бэкенда",
+            LocalDateTime.of(2024, 5, 6, 7, 8),
+            LocalDateTime.of(2024, 5, 7, 9, 10),
+            new ArrayList<>(List.of(report, data))));
+
+    UUID emptyId = UUID.fromString("dddddddd-dddd-dddd-dddd-dddddddddddd");
+    resources.put(
+        emptyId,
+        new Resource(
+            emptyId,
+            "Пустой ресурс (мок)",
+            "Ресурс без файлов",
+            LocalDateTime.of(2024, 6, 1, 12, 0),
+            LocalDateTime.of(2024, 6, 1, 12, 0),
+            new ArrayList<>()));
+  }
+}
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/mock/MockUsersService.java b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockUsersService.java
new file mode 100644
index 0000000..189177b
--- /dev/null
+++ b/src/main/java/com/DesktopApplicationClientJava/services/mock/MockUsersService.java
@@ -0,0 +1,94 @@
+package com.DesktopApplicationClientJava.services.mock;
+
+import com.DesktopApplicationClientJava.entities.User;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import com.DesktopApplicationClientJava.services.UsersService;
+import com.DesktopApplicationClientJava.services.data.RegisterData;
+import com.DesktopApplicationClientJava.services.data.UpdateUserData;
+import com.DesktopApplicationClientJava.services.filter.UserFilter;
+import java.util.List;
+import java.util.UUID;
+
+/** In-memory {@link UsersService} over {@link MockStore}. */
+public class MockUsersService implements UsersService, MockService {
+
+  private final MockStore store;
+
+  public MockUsersService(MockStore store) {
+    this.store = store;
+  }
+
+  @Override
+  public List<User> search(UserFilter filter, long offset, long count) {
+    return store.getUsers().values().stream()
+        .filter(user -> matches(user, filter))
+        .skip(Math.max(0, offset))
+        .limit(count <= 0 ? Long.MAX_VALUE : count)
+        .toList();
+  }
+
+  @Override
+  public User getById(UUID uuid) {
+    User user = store.getUsers().get(uuid);
+    if (user == null) {
+      throw new ServiceException("Пользователь не найден", 404);
+    }
+    return user;
+  }
+
+  @Override
+  public User create(RegisterData data) {
+    boolean duplicate =
+        store.getUsers().values().stream()
+            .anyMatch(user -> user.getEmail().equalsIgnoreCase(data.getEmail()));
+    if (duplicate) {
+      throw new ServiceException("Пользователь уже существует", 409);
+    }
+    User user =
+        new User(
+            UUID.randomUUID(),
+            data.getEmail(),
+            data.getRole(),
+            data.getFirstName(),
+            data.getLastName(),
+            true);
+    store.getUsers().put(user.getUuid(), user);
+    return user;
+  }
+
+  @Override
+  public User update(UUID uuid, UpdateUserData data) {
+    User user = getById(uuid);
+    user.setEmail(data.getEmail());
+    user.setRole(data.getRole());
+    user.setFirstName(data.getFirstName());
+    user.setLastName(data.getLastName());
+    user.setEnabled(data.getEnabled());
+    return user;
+  }
+
+  @Override
+  public void delete(UUID uuid) {
+    if (store.getUsers().remove(uuid) == null) {
+      throw new ServiceException("Пользователь не найден", 404);
+    }
+  }
+
+  private static boolean matches(User user, UserFilter filter) {
+    if (filter == null) {
+      return true;
+    }
+    return contains(user.getEmail(), filter.getEmail())
+        && (filter.getRole() == null || filter.getRole() == user.getRole())
+        && contains(user.getFirstName(), filter.getFirstName())
+        && contains(user.getLastName(), filter.getLastName())
+        && (filter.getEnabled() == null || filter.getEnabled().equals(user.getEnabled()));
+  }
+
+  private static boolean contains(String value, String query) {
+    if (query == null || query.isBlank()) {
+      return true;
+    }
+    return value != null && value.toLowerCase().contains(query.toLowerCase());
+  }
+}
diff --git a/src/test/java/services/mock/MockServicesTest.java b/src/test/java/services/mock/MockServicesTest.java
new file mode 100644
index 0000000..34519e1
--- /dev/null
+++ b/src/test/java/services/mock/MockServicesTest.java
@@ -0,0 +1,130 @@
+package services.mock;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import com.DesktopApplicationClientJava.entities.FileInfo;
+import com.DesktopApplicationClientJava.entities.Resource;
+import com.DesktopApplicationClientJava.entities.Role;
+import com.DesktopApplicationClientJava.entities.User;
+import com.DesktopApplicationClientJava.services.ServiceException;
+import com.DesktopApplicationClientJava.services.filter.ResourceFilter;
+import com.DesktopApplicationClientJava.services.filter.UserFilter;
+import com.DesktopApplicationClientJava.services.mock.MockAuthService;
+import com.DesktopApplicationClientJava.services.mock.MockFileService;
+import com.DesktopApplicationClientJava.services.mock.MockResourceService;
+import com.DesktopApplicationClientJava.services.mock.MockStore;
+import com.DesktopApplicationClientJava.services.mock.MockUsersService;
+import com.DesktopApplicationClientJava.session.Session;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.UUID;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+class MockServicesTest {
+
+  private Session session;
+  private MockAuthService authService;
+  private MockResourceService resourceService;
+  private MockFileService fileService;
+  private MockUsersService usersService;
+
+  @BeforeEach
+  void setUp() {
+    MockStore store = new MockStore();
+    session = new Session();
+    authService = new MockAuthService(store, session);
+    resourceService = new MockResourceService(store);
+    fileService = new MockFileService(store);
+    usersService = new MockUsersService(store);
+  }
+
+  @Test
+  void seededAdminKeepsAdminRole() {
+    User user = authService.login("admin@example.com", "whatever");
+
+    assertEquals(Role.ADMIN, user.getRole());
+    assertTrue(authService.isAdmin());
+    assertTrue(authService.isModerator());
+  }
+
+  @Test
+  void unknownEmailGetsRoleByPrefix() {
+    assertEquals(Role.MODER, authService.login("moder-ivan@example.com", "x").getRole());
+    assertEquals(Role.USER, authService.login("someone@example.com", "x").getRole());
+  }
+
+  @Test
+  void blankCredentialsAreRejected() {
+    assertThrows(ServiceException.class, () -> authService.login("", "x"));
+    assertThrows(ServiceException.class, () -> authService.login("a@b.c", ""));
+  }
+
+  @Test
+  void logoutClearsSession() {
+    authService.login("user@example.com", "x");
+    authService.logout();
+
+    assertNull(authService.getCurrentUser());
+  }
+
+  @Test
+  void seededResourceHasFiles() {
+    List<Resource> found = resourceService.search(new ResourceFilter("отчёт", null), 0, 10);
+
+    assertEquals(1, found.size());
+    assertEquals(2, found.get(0).getFiles().size());
+  }
+
+  @Test
+  void unknownResourceThrows404() {
+    ServiceException e =
+        assertThrows(ServiceException.class, () -> resourceService.getById(UUID.randomUUID()));
+    assertEquals(404, e.getStatus());
+  }
+
+  @Test
+  void createAndDeleteRoundTrip() {
+    Resource created = resourceService.create("Временный", "удалится");
+    resourceService.delete(created.getUuid());
+
+    assertThrows(ServiceException.class, () -> resourceService.getById(created.getUuid()));
+  }
+
+  @Test
+  void downloadWritesFileWithOriginalName(@TempDir Path tempDir) throws Exception {
+    Resource resource = resourceService.search(ResourceFilter.empty(), 0, 10).get(0);
+    FileInfo file = resource.getFiles().get(0);
+
+    Path saved = fileService.downloadFile(resource.getUuid(), file.getUuid(), tempDir);
+
+    assertEquals(file.getName(), saved.getFileName().toString());
+    assertTrue(Files.size(saved) > 0);
+  }
+
+  @Test
+  void downloadUnknownFileThrows404(@TempDir Path tempDir) {
+    Resource resource = resourceService.search(ResourceFilter.empty(), 0, 10).get(0);
+
+    ServiceException e =
+        assertThrows(
+            ServiceException.class,
+            () -> fileService.downloadFile(resource.getUuid(), UUID.randomUUID(), tempDir));
+    assertEquals(404, e.getStatus());
+  }
+
+  @Test
+  void usersSearchFindsSeededAdmin() {
+    List<User> found = usersService.search(new UserFilter("admin@", null, null, null, null), 0, 10);
+
+    assertEquals(1, found.size());
+    assertEquals(Role.ADMIN, found.get(0).getRole());
+    assertNotNull(usersService.getById(found.get(0).getUuid()));
+  }
+}
diff --git a/src/test/java/ui/MockFlowTest.java b/src/test/java/ui/MockFlowTest.java
new file mode 100644
index 0000000..55d112d
--- /dev/null
+++ b/src/test/java/ui/MockFlowTest.java
@@ -0,0 +1,97 @@
+package ui;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+
+import com.DesktopApplicationClientJava.controllers.ResourceDetailsController;
+import com.DesktopApplicationClientJava.entities.FileInfo;
+import com.DesktopApplicationClientJava.navigation.Navigator;
+import com.DesktopApplicationClientJava.services.ServiceRegistry;
+import com.DesktopApplicationClientJava.session.Session;
+import com.DesktopApplicationClientJava.utils.ControllerWiring;
+import java.util.UUID;
+import javafx.fxml.FXMLLoader;
+import javafx.scene.Parent;
+import javafx.scene.Scene;
+import javafx.scene.control.Label;
+import javafx.scene.control.TableView;
+import javafx.stage.Stage;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.testfx.api.FxRobot;
+import org.testfx.framework.junit5.ApplicationExtension;
+import org.testfx.framework.junit5.Start;
+
+/**
+ * Mock-backed UI flow: real pages wired to real in-memory mock services (no Mockito on services, no
+ * backend). Proves that MOCK_DATA mode renders actual data.
+ */
+@ExtendWith(ApplicationExtension.class)
+class MockFlowTest {
+
+  private static final UUID SEEDED_RESOURCE_ID =
+      UUID.fromString("aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa");
+
+  private ResourceDetailsController controller;
+
+  @Start
+  void start(Stage stage) throws Exception {
+    Navigator navigator = mockNavigator();
+    ServiceRegistry services = ServiceRegistry.mock(new Session());
+
+    FXMLLoader loader = new FXMLLoader(getClass().getResource("/fxml/ResourceDetails.fxml"));
+    loader.setControllerFactory(
+        clazz -> {
+          try {
+            Object created = clazz.getDeclaredConstructor().newInstance();
+            ControllerWiring.wire(created, navigator, new Session(), services);
+            return created;
+          } catch (Exception e) {
+            throw new RuntimeException("Cannot create controller: " + clazz, e);
+          }
+        });
+    Parent root = loader.load();
+    controller = loader.getController();
+    stage.setScene(new Scene(root));
+    stage.show();
+  }
+
+  @Test
+  void mockLoginPutsUserIntoSession() {
+    Session session = new Session();
+    ServiceRegistry registry = ServiceRegistry.mock(session);
+
+    registry.getAuthService().login("admin@example.com", "any-password");
+
+    assertEquals("admin@example.com", session.getCurrentUser().getEmail());
+  }
+
+  @Test
+  @SuppressWarnings("unchecked")
+  void detailsPageRendersSeededMockResource(FxRobot robot) {
+    robot.interact(
+        () -> {
+          controller.setResourceId(SEEDED_RESOURCE_ID);
+          controller.load();
+        });
+
+    assertEquals("Годовой отчёт (мок)", robot.lookup("#titleLabel").queryAs(Label.class).getText());
+    TableView<FileInfo> table = robot.lookup("#filesTable").queryAs(TableView.class);
+    assertEquals(2, table.getItems().size());
+    assertFalse(robot.lookup("#errorLabel").queryAs(Label.class).isVisible());
+  }
+
+  @Test
+  @SuppressWarnings("unchecked")
+  void detailsPageAutoSelectsFirstSeedWithoutId(FxRobot robot) {
+    robot.interact(() -> controller.load());
+
+    assertEquals("Годовой отчёт (мок)", robot.lookup("#titleLabel").queryAs(Label.class).getText());
+    TableView<FileInfo> table = robot.lookup("#filesTable").queryAs(TableView.class);
+    assertEquals(2, table.getItems().size());
+  }
+
+  private static Navigator mockNavigator() {
+    return org.mockito.Mockito.mock(Navigator.class);
+  }
+}

From 4d64957f02fd0c32fcc51ea60348da9c0b54eeb9 Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 18:12:26 +0300
Subject: [PATCH 08/10] chore(vscode): recommend Lombok extension
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

VS Code без Lombok-плагина не видит сгенерированные геттеры (Maven собирает через annotationProcessorPaths, падает только подсветка). Файл подскажет установить vscjava.vscode-lombok при открытии репо.
---
 .vscode/extensions.json | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 .vscode/extensions.json

diff --git a/.vscode/extensions.json b/.vscode/extensions.json
new file mode 100644
index 0000000..301782b
--- /dev/null
+++ b/.vscode/extensions.json
@@ -0,0 +1,3 @@
+{
+  "recommendations": ["vscjava.vscode-lombok"]
+}

From ed0df9c022c0ee332d650eb4d5ddbaa877247fec Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 18:17:32 +0300
Subject: [PATCH 09/10] chore(lombok): replace boilerplate accessors with
 annotations
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Session/Controller → @Getter/@Setter, ServiceRegistry → @AllArgsConstructor, ServiceException/ApiException → @Getter. Вычисляемый getStatus() и конструкторы с super() оставлены вручную — Lombok их не генерирует.

Минус 54 строки, поведение не менялось (verify + IT зелёные).
---
 .../Api/ApiException.java                     |  6 ++--
 .../ResourceDetailsController.java            |  7 ++--
 .../controllers/utils/Controller.java         | 17 ++--------
 .../services/ServiceException.java            |  7 ++--
 .../services/ServiceRegistry.java             | 15 ++-------
 .../session/Session.java                      | 32 +++----------------
 6 files changed, 15 insertions(+), 69 deletions(-)

diff --git a/src/main/java/com/DesktopApplicationClientJava/Api/ApiException.java b/src/main/java/com/DesktopApplicationClientJava/Api/ApiException.java
index 06ba69f..156910f 100644
--- a/src/main/java/com/DesktopApplicationClientJava/Api/ApiException.java
+++ b/src/main/java/com/DesktopApplicationClientJava/Api/ApiException.java
@@ -1,7 +1,9 @@
 package com.DesktopApplicationClientJava.Api;
 
 import com.DesktopApplicationClientJava.Api.Dto.error.ErrorResponse;
+import lombok.Getter;
 
+@Getter
 public class ApiException extends RuntimeException {
   private final ErrorResponse errorResponse;
 
@@ -10,10 +12,6 @@ public ApiException(ErrorResponse errorResponse) {
     this.errorResponse = errorResponse;
   }
 
-  public ErrorResponse getErrorResponse() {
-    return errorResponse;
-  }
-
   public int getStatus() {
     return errorResponse.status();
   }
diff --git a/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java b/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
index 22bcc8c..7d7f92c 100644
--- a/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
+++ b/src/main/java/com/DesktopApplicationClientJava/controllers/ResourceDetailsController.java
@@ -23,6 +23,7 @@
 import javafx.scene.control.cell.PropertyValueFactory;
 import javafx.stage.DirectoryChooser;
 import javafx.stage.Window;
+import lombok.Setter;
 
 public class ResourceDetailsController extends Controller {
 
@@ -42,7 +43,7 @@ public class ResourceDetailsController extends Controller {
   @FXML private TableColumn<FileInfo, Void> downloadColumn;
   @FXML private Button backButton;
 
-  private UUID resourceId;
+  @Setter private UUID resourceId;
 
   @FXML
   private void initialize() {
@@ -54,10 +55,6 @@ private void initialize() {
     autoSelectFirstInMockMode();
   }
 
-  public void setResourceId(UUID resourceId) {
-    this.resourceId = resourceId;
-  }
-
   public void load() {
     hideError();
     try {
diff --git a/src/main/java/com/DesktopApplicationClientJava/controllers/utils/Controller.java b/src/main/java/com/DesktopApplicationClientJava/controllers/utils/Controller.java
index e16b9c7..2e25530 100644
--- a/src/main/java/com/DesktopApplicationClientJava/controllers/utils/Controller.java
+++ b/src/main/java/com/DesktopApplicationClientJava/controllers/utils/Controller.java
@@ -6,25 +6,12 @@
 import com.DesktopApplicationClientJava.services.ServicesAware;
 import com.DesktopApplicationClientJava.session.Session;
 import com.DesktopApplicationClientJava.session.SessionAware;
+import lombok.Setter;
 
+@Setter
 public abstract class Controller implements SessionAware, NavigatorAware, ServicesAware {
 
   protected Session session;
   protected Navigator navigator;
   protected ServiceRegistry services;
-
-  @Override
-  public void setSession(Session session) {
-    this.session = session;
-  }
-
-  @Override
-  public void setNavigator(Navigator navigator) {
-    this.navigator = navigator;
-  }
-
-  @Override
-  public void setServices(ServiceRegistry services) {
-    this.services = services;
-  }
 }
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/ServiceException.java b/src/main/java/com/DesktopApplicationClientJava/services/ServiceException.java
index 07b5c3d..0445287 100644
--- a/src/main/java/com/DesktopApplicationClientJava/services/ServiceException.java
+++ b/src/main/java/com/DesktopApplicationClientJava/services/ServiceException.java
@@ -1,5 +1,8 @@
 package com.DesktopApplicationClientJava.services;
 
+import lombok.Getter;
+
+@Getter
 public class ServiceException extends RuntimeException {
   private final int status;
 
@@ -11,8 +14,4 @@ public ServiceException(String message, int status) {
   public ServiceException(String message) {
     this(message, 0);
   }
-
-  public int getStatus() {
-    return status;
-  }
 }
diff --git a/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java b/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java
index 091096e..a9fc536 100644
--- a/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java
+++ b/src/main/java/com/DesktopApplicationClientJava/services/ServiceRegistry.java
@@ -9,9 +9,11 @@
 import com.DesktopApplicationClientJava.services.mock.MockStore;
 import com.DesktopApplicationClientJava.services.mock.MockUsersService;
 import com.DesktopApplicationClientJava.session.Session;
+import lombok.AllArgsConstructor;
 import lombok.Getter;
 
 @Getter
+@AllArgsConstructor
 public class ServiceRegistry {
   private final AuthService authService;
   private final UsersService usersService;
@@ -28,19 +30,6 @@ public ServiceRegistry(ApiClient apiClient, Session session) {
         new ExportServiceImpl(apiClient));
   }
 
-  public ServiceRegistry(
-      AuthService authService,
-      UsersService usersService,
-      ResourceService resourceService,
-      FileService fileService,
-      ExportService exportService) {
-    this.authService = authService;
-    this.usersService = usersService;
-    this.resourceService = resourceService;
-    this.fileService = fileService;
-    this.exportService = exportService;
-  }
-
   /** In-memory services for UI testing without a backend (see MOCK_DATA in Program). */
   public static ServiceRegistry mock(Session session) {
     MockStore store = new MockStore();
diff --git a/src/main/java/com/DesktopApplicationClientJava/session/Session.java b/src/main/java/com/DesktopApplicationClientJava/session/Session.java
index cea4c73..19ffa97 100644
--- a/src/main/java/com/DesktopApplicationClientJava/session/Session.java
+++ b/src/main/java/com/DesktopApplicationClientJava/session/Session.java
@@ -1,8 +1,12 @@
 package com.DesktopApplicationClientJava.session;
 
 import com.DesktopApplicationClientJava.entities.User;
+import lombok.Getter;
 import lombok.NoArgsConstructor;
+import lombok.Setter;
 
+@Getter
+@Setter
 @NoArgsConstructor
 public class Session {
 
@@ -10,34 +14,6 @@ public class Session {
   private String accessToken;
   private String refreshToken;
 
-  // ===== user =====
-
-  public User getCurrentUser() {
-    return currentUser;
-  }
-
-  public void setCurrentUser(User user) {
-    this.currentUser = user;
-  }
-
-  // ===== tokens =====
-
-  public String getAccessToken() {
-    return accessToken;
-  }
-
-  public void setAccessToken(String accessToken) {
-    this.accessToken = accessToken;
-  }
-
-  public String getRefreshToken() {
-    return refreshToken;
-  }
-
-  public void setRefreshToken(String refreshToken) {
-    this.refreshToken = refreshToken;
-  }
-
   // ===== helpers =====
 
   public boolean isLoggedIn() {

From 537b2596f51132e203b20c97de9b8ad02e658e72 Mon Sep 17 00:00:00 2001
From: Vladimir Valekzhanin <valdemarcheck@yandex.ru>
Date: Tue, 6 Oct 2026 18:21:44 +0300
Subject: [PATCH 10/10] docs: document mock mode and env variables
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Два режима запуска рядом (реальный бэкенд / MOCK_DATA без бэкенда), таблица переменных .env и кто их читает. Убран устаревший совет править INITIAL_PAGE_PATH в коде.
---
 README.md | 33 +++++++++++++++++++++++++++++----
 1 file changed, 29 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 1f22d8a..af9c318 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,9 @@ git pull --rebase
 
 ## Запуск
 
-Требования: JDK 25, Maven, запущенный бэкенд (иначе вход покажет ошибку соединения).
+Требования: JDK 25, Maven.
+
+### С реальным бэкендом
 
 ```bash
 # 1. Инфраструктура бэкенда (из корня этого репозитория):
@@ -20,9 +22,32 @@ docker compose up -d postgres redis
 mvn javafx:run
 ```
 
-Откроется окно 800×600 со страницы входа (`LoginForm.fxml` — она же `INITIAL_PAGE_PATH`
-в `Program.java`). Для проверки вёрстки отдельной страницы можно временно подменить
-`INITIAL_PAGE_PATH` на нужный FXML.
+### Без бэкенда (мок-данные для проверки UI)
+
+```bash
+MOCK_DATA=true mvn javafx:run
+```
+
+Приложение стартует на in-memory данных (`services/mock`, окно помечено `[MOCK]`):
+вход — любой непустой email/пароль, роль по префиксу email (`admin*` → ADMIN,
+`moder*` → MODER, иначе USER). Засижены 3 пользователя и 2 ресурса с файлами,
+скачивание пишет реальный файл-плейсхолдер.
+
+### Переменные окружения (.env)
+
+| Переменная | Дефолт | Назначение |
+| ---------- | ------ | ---------- |
+| `INITIAL_PAGE_PATH` | `/fxml/LoginForm.fxml` | Стартовая страница (удобно открывать страницу напрямую для проверки вёрстки) |
+| `MOCK_DATA` | `false` | `true` — работать на моках без бэкенда |
+| `IT_ADMIN_EMAIL` / `IT_ADMIN_PASSWORD` | — | Сид-админ локального бэкенда для интеграционных тестов (тесты сами читают `.env`; без пароля скипаются) |
+| `POSTGRES_*`, `REDIS_PASSWORD`, `APP_PORT` | см. `.env.example` | Инфраструктура и бэкенд |
+| `MINIO_*` | см. `.env.example` | Только с `docker compose --profile files up -d` |
+
+Свои значения — в `.env` (скопировать из `.env.example`): приложение читает
+переменные из окружения (`set -a && source .env && set +a` перед запуском),
+интеграционные тесты подхватывают `.env` сами.
+
+Откроется окно 800×600 со стартовой страницы (по умолчанию вход, `LoginForm.fxml`).
 
 ## Git hooks