docs folder with steps

This commit is contained in:
Константин Лебединский
2026-03-21 16:06:24 +05:00
commit b42a3c3d55
14 changed files with 910 additions and 0 deletions
+49
View File
@@ -0,0 +1,49 @@
# Шаг 4: Управление пользователями и подразделениями
## Цель
Реализовать CRUD операции для сотрудников и справочника подразделений.
---
## Задачи
### 4.1. Управление подразделениями
| Эндпоинт | Метод | Описание |
|----------|-------|----------|
| `/api/departments` | GET | Список подразделений |
| `/api/departments` | POST | Создать подразделение |
| `/api/departments/:id` | PUT | Редактировать |
| `/api/departments/:id` | DELETE | Деактивировать |
### 4.2. Управление пользователями
| Эндпоинт | Метод | Описание |
|----------|-------|----------|
| `/api/users` | GET | Список сотрудников |
| `/api/users` | POST | Создать сотрудника |
| `/api/users/:id` | GET | Карточка сотрудника |
| `/api/users/:id` | PUT | Редактировать |
| `/api/users/:id` | DELETE | Деактивировать |
### 4.3. Фильтрация
- GET `/api/users` поддерживает фильтры:
- `department_id` — по подразделению
- `role` — по роли
- `is_active` — по статусу
### 4.4. Права доступа
- **HR:** полный доступ ко всем пользователям
- **Manager:** только своё подразделение
- Создание пользователей — только администратор (ручной ввод)
---
## Результат
- Админка для управления сотрудниками
- Справочник подразделений
- Назначение ролей сотрудникам