Игорь Надеин
3f0ff230ca
### Backend / API
* **DepartmentViewSet**
* Вернул поведение поиска/сортировки как в старой реализации: `?search=` по имени/описанию/ФИО руководителя; `?ordering=name|id` (по умолчанию `name`).
* Добавил аннотацию **`employees_count`**: считает уникальных активных участников по связям `EmployeeDepartment`, и **прибавляет руководителя**, если он не входит в активные линкы.
* `partial_update`: смена руководителя требует `change_department_head` **только если значение реально меняется**; остальное редактируется по `manage_department`.
* `set_head`:
* `POST /departments/{id}/set_head` — установка нового руководителя (200 + сериализованный отдел).
* `head_id=null|""` — снятие руководителя (204).
* Валидация: **разрешаем** назначение любому существующему и активному (`is_active=True`) пользователю; поле `email_verified` не блокирует назначение.
* `set_member_role`:
* `POST /departments/{id}/set_member_role` — создание/обновление линка участника с отделом.
* Валидирует, что `role_id` принадлежит текущему отделу.
* Возвращает JSON строго в формате, который ждут тесты: `{"employee_id", "role_id", "is_active"}`.
* **DepartmentRoleViewSet**
* Доступ на изменение ролей отделов только при скоуп-праве **`assign_department_role`** (через `AdminOrDeptAllowed`).
* Новые эндпоинты:
* `GET /department-roles/perm_choices/` — отдает справочник прав из `DeptPerm.CHOICES`; при необходимости создаёт записи в БД (id + code + name).
* `GET /department-roles/{id}/perms/` — текущие права роли (id, code, name).
* `POST /department-roles/{id}/set_perms` — полная замена прав по `permission_ids` **или** `permission_codes`.
* Использование константного набора прав **`DeptPerm`**: `MANAGE`, `CHANGE_HEAD`, `ASSIGN_ROLE` (+ `CHOICES`).
* **Сериализаторы**
* `DepartmentSerializer`: `head` — вложенно (кратко), `head_id` — write-only (`PrimaryKeyRelatedField`), `employees_count` — read-only (берётся из аннотации).
* `EmployeeBriefSerializer` — для краткого отображения руководителя и кандидатов.
* **Права**
* Везде применён общий пермишен `AdminOrDeptAllowed(required_code=...)` для скоуп-прав по отделу:
* `manage_department` — редактирование/удаление отдела,
* `change_department_head` — назначение/снятие руководителя,
* `assign_department_role` — операции с ролями и назначениями участникам.
### Frontend / Templates
* **Новый частичный шаблон** `backend/templates/employees/_department_controls.html`
* Разбит на **3 блока**:
1. *Управление отделом* (название/описание) — доступно при `can_manage`.
2. *Роли отдела* — доступно при `can_assign_roles`.
* Кнопка «Создать роль» открывает панель с формой + модал выбора прав.
* Редактирование существующей роли: выпадающий список ролей, изменение названия и прав.
* **Одна кнопка «Сохранить изменения»**: JS сам определяет, что изменилось, и вызывает нужные операции (`op=update` и/или `op=set_perms`) последовательно.
* Отдельно — «Удалить роль».
* Выбор прав выполнен через модальные окна, как в блоке с должностями в `_employee_edit.html`; визуал выбранных прав — «чипсы».
3. *Назначение руководителя* — доступно при `can_change_head` (выпадающий список кандидатов).
* Разметка и стили согласованы с `_employee_edit.html` (карточки, ios-аккордеон, кнопки, модалки). Дополнительный CSS **не** вводился — всё опирается на базовые стили проекта и Bootstrap.
* **`department_detail` (view для фронта)**:
* Сначала грузит отдел, затем роли, сотрудников и посты.
* Собирает `head_choices` и `links` для шаблона.
* Подтягивает `dept_perm_choices` из `GET /api/v1/department-roles/perm_choices/`.
### Тесты
* Полностью переписаны/обновлены:
* `tests/api/v1/employees/test_departments.py`
* Поиск/сортировка по имени.
* `employees_count` считает head, если его нет в активных линках.
* `set_head`: валидирует активность; снятие — 204; изменения head без доп. права — 403; сохранение того же head — 200.
* `set_member_role`: «счастливый путь», запрет чужих ролей, формат ответа.
* `tests/api/v1/employees/test_department_roles.py` и `test_department_roles_extra.py`
* Список с фильтром по отделу, стабильный `ordering`.
* Создание/обновление/удаление с учётом скоуп-прав.
* `perm_choices`, `perms`, `set_perms` (валидаторы ids/codes).
* `tests/api/v1/employees/test_department_head_rights.py`
* Руководитель может править отдел без явных ролей.
* Руководитель может менять head и **теряет** права после снятия.
* Фиксы фикстур:
* `make_user` всегда создаёт пользователя с валидным телефоном, `email` в нижнем регистре, отключена отсылка писем; приводим к активному состоянию, чтобы не мешать правам.
* Убраны ошибки:
* `NameError: User is not defined` → везде используется `get_user_model()`.
* `NoReverseMatch` в шаблоне → корректные URL’ы: `employees:department_edit`, `employees:department_set_head`, `employees:edit_department_role`.
### Прочее
* Повсеместно добавлены докстринги для новых классов и функций (соответствие внутреннему гайдлайну).
* Без миграций данных/схемы.
**Итог:** добавлены управляемые через API роли отделов с выбором прав (скоуп-прав), унифицированы проверки доступа, восстановлено ожидаемое поведение списка/деталей отделов, подготовлены UI-блоки в едином стиле с «должностями», обновлены и позеленели тесты (остальные регрессии устранены).
55 lines
2.1 KiB
Python
55 lines
2.1 KiB
Python
# backend/employees/urls_front.py
|
|
from django.urls import path
|
|
from . import views_front
|
|
|
|
app_name = "employees"
|
|
|
|
urlpatterns = [
|
|
# --- Профиль и сотрудники ---
|
|
path("list/", views_front.employee_list, name="employees_list"),
|
|
path("me/", views_front.employee_profile, name="profile"),
|
|
path("me/edit/", views_front.employee_edit_me, name="employee_edit_me"),
|
|
path("<int:pk>/", views_front.employee_profile, name="employee_detail"),
|
|
path("<int:pk>/edit/", views_front.employee_edit, name="employee_edit"),
|
|
path("create/", views_front.employee_create, name="employee_create"),
|
|
# --- Отделы ---
|
|
path(
|
|
"departments/add/",
|
|
views_front.DepartmentCreateView.as_view(),
|
|
name="department_add",
|
|
),
|
|
path(
|
|
"departments/<int:pk>/roles/edit/",
|
|
views_front.edit_department_role,
|
|
name="edit_department_role",
|
|
),
|
|
path("departments/", views_front.department_list, name="department_list"),
|
|
path(
|
|
"departments/<int:pk>/", views_front.department_detail, name="department_detail"
|
|
),
|
|
path(
|
|
"departments/<int:pk>/edit/",
|
|
views_front.department_edit,
|
|
name="department_edit",
|
|
),
|
|
path(
|
|
"departments/<int:pk>/set-head/",
|
|
views_front.department_set_head,
|
|
name="department_set_head",
|
|
),
|
|
path(
|
|
"<int:emp_id>/departments/<int:dept_id>/set-role/",
|
|
views_front.set_member_role,
|
|
name="set_member_role",
|
|
),
|
|
# --- Навыки ---
|
|
path("<int:pk>/skill/add/", views_front.skill_add, name="skill_add"),
|
|
path("<int:pk>/skill/remove/", views_front.skill_remove, name="skill_remove"),
|
|
|
|
# --- Должности ---
|
|
path("positions/create/", views_front.position_create_front, name="position_create"),
|
|
path("positions/<int:pos_id>/update/", views_front.position_update_front, name="position_update"),
|
|
path("<int:emp_id>/set-position/", views_front.employee_set_position_front, name="employee_set_position"),
|
|
path("me/set-position/", views_front.employee_set_position_me_front, name="employee_set_position_me"),
|
|
]
|