From b301ebe21cb7fe35809524a5b7c5455d4903c846 Mon Sep 17 00:00:00 2001 From: Vladimir Valekzhanin Date: Thu, 15 Oct 2026 13:23:38 +0300 Subject: [PATCH] =?UTF-8?q?feat:=20=D1=81=D0=BE=D1=81=D1=82=D0=B0=D0=B2?= =?UTF-8?q?=D0=B8=D1=82=D1=8C=20=D0=B3=D0=BB=D0=BE=D1=81=D1=81=D0=B0=D1=80?= =?UTF-8?q?=D0=B8=D0=B9=20=D0=BF=D1=80=D0=B5=D0=B4=D0=BC=D0=B5=D1=82=D0=BD?= =?UTF-8?q?=D0=BE=D0=B9=20=D0=BE=D0=B1=D0=BB=D0=B0=D1=81=D1=82=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- GLOSSARY.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 GLOSSARY.md diff --git a/GLOSSARY.md b/GLOSSARY.md new file mode 100644 index 0000000..496665f --- /dev/null +++ b/GLOSSARY.md @@ -0,0 +1,57 @@ +# Десктоп-клиент + +Клиентское JavaFX-приложение для управления ресурсами и пользователями через HTTP API бэкенда. + +## Пользователи и доступ + +**Пользователь**: +Учётная запись человека в системе: email, имя, фамилия, роль и флаг активности. +_Avoid_: Клиент, профиль, аккаунт + +**Роль**: +Уровень доступа учётной записи: `USER`, `MODER` или `ADMIN`. Старшая роль включает все права младших (`USER < MODER < ADMIN`). +_Avoid_: Права, привилегия + +**Гость**: +Неаутентифицированный посетитель без сессии; доступна только страница входа. +_Avoid_: Аноним, незалогиненный пользователь + +**Создание пользователя**: +Создание учётной записи администратором через форму пользователя. Саморегистрации в системе нет. +_Avoid_: Регистрация (кроме имён существующих классов `RegisterData`, `RegisterRequest`) + +**Блокировка**: +Отключение входа для учётной записи (`enabled=false`): заблокированный пользователь не может аутентифицироваться, запись при этом сохраняется. Новые пользователи всегда создаются активными. +_Avoid_: Деактивация, отключение, удаление + +**Удаление пользователя**: +Безвозвратное удаление учётной записи из системы. В отличие от блокировки, запись исчезает полностью. +_Avoid_: Блокировка, деактивация + +## Ресурсы и файлы + +**Ресурс**: +Смысловая единица хранения: метаданные (`title`, `description`, даты) плюс прикреплённые файлы. +_Avoid_: Документ + +**Файл**: +Вложение ресурса: метаданные (`name`, `contentType`, `size`) плюс байты, хранящиеся на сервере. +_Avoid_: Вложение, документ + +**Скачивание**: +Сохранение одного файла ресурса в локальный каталог. +_Avoid_: Экспорт (в значении одного файла) + +**Экспорт**: +Выгрузка данных наружу: XLSX-таблицы пользователей или ресурсов, либо архив файлов ресурса. +_Avoid_: Скачивание (в значении выгрузки) + +## Сервисы и ошибки + +**Сервисная ошибка**: +Сообщение для пользователя со статусом ответа; статус `0` означает отсутствие связи с сервером. Контроллер показывает её текст напрямую. +_Avoid_: Ошибка API (деталь транспортного уровня, не термин) + +**Проверка ввода**: +Клиентская проверка полей формы до вызова сервиса. Её сообщения — не сервисные ошибки. +_Avoid_: Валидация сервера, сервисная ошибка (в значении проверки полей)