Игорь Надеин c78d1e5fea Ключевые изменения
- **EmployeeActionSerializer**
  - Добавлен `history[]` со снапшотами simple-history и diff по полям: `action`, `date`, `comment`, `extra`, `employee_id`.
  - Локализация названий событий через `employees.constants.ACTION_CHOICES`.
  - Поля `action_display`, `date_display` для удобного фронтового рендера.

- **EmployeeSerializer**
  - Возвращает `actions` (массив событий) с историей, **только** если в контексте выставлено `include_action_history=True`.
  - Навыки: чтение — `skills` как список объектов `{id, name}`, запись — через `skills_ids`.
  - Должность: чтение — объект `{id, name}`, запись — через `position_id`.
  - Отделы: добавлен флаг `is_head` (сотрудник — руководитель отдела).

- **EmployeeListSerializer**
  - Те же правки для навыков/должности и `is_head`, без `actions` (для производительности).

- **Views (EmployeeViewSet)**
  - `get_queryset`: префетч `actions` добавляется **только** для `retrieve/me`, иначе не тянем историю.
  - `get_serializer_context`: для `retrieve` и `me` выставляем `include_action_history=True`.
  - Экшен `me`: выборка с `Prefetch("actions", order_by -date)` и передачей `include_action_history=True`.

- **Разное**
  - Используем `ACTION_CHOICES` для «человеческих» названий событий в истории.
  - `HistoryActionMixin` оставлен без изменений; история объектов доступна по `/{basename}/{pk}/history/`.

Почему так
- История кадровых событий бывает тяжёлой → грузим и отдаём её только там, где нужно (`retrieve/me`).
- Явное разделение read/write для навыков и должности упрощает фронту жизнь и убирает двусмысленность.
- `is_head` позволяет фронту не вычислять этот флаг отдельно.

Файлы
- `backend/api/v1/employees/serializers.py`
- `backend/api/v1/employees/views.py`
- (использованы константы из) `backend/employees/constants.py`

Тесты/проверка
1) GET `/api/v1/employees/1/` → поле `actions[]` заполнено, внутри каждого элемента `history[]` со снапшотами и переводами событий.
2) GET `/api/v1/employees/?page=1` → `actions` отсутствуют (по замыслу), навыки и должность приходят в «красивом» виде.
3) GET `/api/v1/employees/me/` → аналогично `retrieve`, с историей.

* UI (templates/employees/employee\_detail.html)

  * Навыки: больше не итерируем по строке, выводим объекты `{id,name}` (`s.name`).
    Защита от пустых списков.
  * Отделы: убрал «аватарки» у элементов списка, оставил иконку у кнопки раздела.
    Роль сотрудника показывается «Название отдела — Роль».
    Для руководителя добавлен понятный бейдж с иконкой `bi-award-fill` + tooltip «Руководитель отдела».
  * Кадровые события: добавлен раздел «Кадровые события» (для аутентифицированных).
    Отрисовывает список всех событий (дата, комментарий, extra), а также историю каждого события (`action.history`) в `<details>`.
    В истории показываем только название события и новые значения полей (без «создано/изменено» и без зачёркнутых старых значений).
    Перевод кодов событий (`hired`, `dismissed`, …) в человекочитаемый вид согласно `employees/constants.py`.
  * Аккордеон: кнопка и выпадающая панель объединены в один блок `.ios-acc` единой ширины.
    Добавлена разделительная линия между заголовком и контентом (`.ios-acc-body { border-top: ... }`).
    Исправлены дёрганья при анимации: убраны внешние отступы у `.collapse`, возврат стандартной скорости Bootstrap (`.35s ease`), `overflow:hidden` на фазе `collapsing`.

* Views (employees/views.py — веб-приложение)

  * В `employee_detail` и `employee_me` дополнительно запрашиваем полную историю кадровых событий:
    `GET v1/employee-actions/?employee=<id>&ordering=-date` и передаём в шаблон `employee_actions`.
    Тем самым отображаем все события, а не только последнее.
  * Шаблон умеет брать события из `employee_actions`, а при отсутствии — из `emp.actions`.

* API (backend/api/v1/employees/serializers.py)

  * `EmployeeActionSerializer`: добавлен `history` (MethodField) с формированием массива изменений из `HistoricalRecords` (без старых значений; только `changes[field].new`, дата/пользователь).
    Добален `action_display` и `date_display` для удобного рендера на фронте.
  * `EmployeeSerializer`: возвращает `departments` через `get_departments()` (id, name, role\_id, role\_name, is\_head) и `skills` как массив объектов `{id,name}`.

* Прочее/фиксы

  * Безопасные проверки на пустые коллекции (контакты, навыки, отделы, события).
  * Устранена ошибка шаблона «Failed lookup…» при попытке обратиться к отсутствующим ключам.
  * Не изменяем скорость анимации: возвращён дефолт Bootstrap; корректное закрытие панелей.

Refs: employees/constants.py (ACTION\_CHOICES), templates/employees/employee\_detail.html, employees/views.py, api/v1/employees/serializers.py
2025-08-27 17:58:46 +03:00

136 lines
6.3 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{% load static %}
<style>
/* Компактный бейдж уведомлений вплотную к колоколу */
.bell-wrapper{ position: relative; line-height: 1; display: inline-block; }
.bell-dot{
position: absolute; top: -2px; right: -2px;
width: 9px; height: 9px; border-radius: 999px;
background: var(--bs-danger); color: #fff;
font-size: 7px; line-height: 9px; font-weight: 700;
display: flex; align-items: center; justify-content: center;
box-shadow: 0 0 0 1px rgba(255,255,255,.65);
}
/* Кнопка «гамбургера» — без круга/рамки */
.menu-toggle{
padding: 0; border: 0; background: transparent; line-height: 1; color: #fff;
}
.menu-toggle:focus{ outline: none; box-shadow: none; }
/* Спрятать стрелочку у dropdown-аватара */
.dropdown-toggle.no-caret::after{ display: none !important; }
</style>
<nav class="navbar navbar-expand bg-primary app-navbar" data-bs-theme="dark">
<div class="container-fluid align-items-center">
{% if user.is_authenticated %}
<!-- Моб. меню (иконка без подложки) -->
<button class="menu-toggle d-lg-none me-2" type="button"
data-bs-toggle="offcanvas" data-bs-target="#sidebar" aria-controls="sidebar"
aria-label="Открыть меню">
<i class="bi-list fs-4"></i>
</button>
{% endif %}
<a class="navbar-brand fw-semibold me-3" href="/">EUSRR</a>
{% if user.is_authenticated %}
<!-- Группа: поиск + колокол -->
<div class="d-flex align-items-center ms-4">
<!-- Поиск компактный рядом с логотипом -->
<form class="d-flex align-items-center me-3" role="search"
action="{% url 'search:search' %}" method="get" autocomplete="off">
<div class="position-relative">
<i class="bi-search position-absolute top-50 start-0 translate-middle-y ms-2 opacity-75"></i>
<input
class="form-control form-control-sm rounded-pill ps-5 pe-4 bg-white bg-opacity-10 border-0 text-white shadow-sm"
type="search" name="q" placeholder="Поиск…" aria-label="Поиск"
style="width: clamp(160px, 28vw, 300px);">
</div>
</form>
<!-- Уведомления: только иконка + плотный бейдж -->
<div class="dropdown">
<button class="btn btn-link text-white p-0" data-bs-toggle="dropdown"
aria-expanded="false" title="Уведомления" aria-label="Уведомления">
<span class="bell-wrapper">
<i class="bi-bell fs-5"></i>
{% if not user.telegram or not user.whatsapp or not user.wechat %}
<span class="bell-dot">!</span>
{% endif %}
</span>
</button>
<ul class="dropdown-menu dropdown-menu-end rounded-3 shadow-sm" style="min-width:260px;">
<li class="small text-muted px-3 py-2">Мессенджеры</li>
<li class="px-3 py-1">
{% if user.telegram %}
<span class="text-success"><i class="bi-telegram"></i> Telegram привязан</span>
{% else %}
<a href="{{ tg_link|default:'#' }}" class="text-danger d-block" rel="noopener">
<i class="bi-telegram"></i> Привязать Telegram
</a>
{% endif %}
</li>
<li class="px-3 py-1">
{% if user.whatsapp %}
<span class="text-success"><i class="bi-whatsapp"></i> WhatsApp привязан</span>
{% else %}
<a href="https://wa.me/?text=Привязка+WhatsApp" class="text-danger d-block" rel="noopener">
<i class="bi-whatsapp"></i> Привязать WhatsApp
</a>
{% endif %}
</li>
<li class="px-3 py-1">
{% if user.wechat %}
<span class="text-success"><i class="bi-wechat"></i> WeChat привязан</span>
{% else %}
<span class="text-danger d-block"><i class="bi-wechat"></i> Привязать WeChat (вручную)</span>
{% endif %}
</li>
<li><hr class="dropdown-divider"></li>
<li class="small text-muted px-3 py-2">Уведомления (скоро)</li>
</ul>
</div>
</div>
{% endif %}
<div class="ms-auto d-flex align-items-center">
{% if user.is_authenticated %}
<div class="dropdown">
<a href="#" class="d-flex align-items-center text-white text-decoration-none dropdown-toggle no-caret"
id="userDropdown" data-bs-toggle="dropdown" aria-expanded="false" style="min-width:40px;">
{% if user.avatar %}
<img src="{{ user.avatar.url }}" alt="Аватар {{ user.get_short_name }}" width="36" height="36"
class="rounded-circle shadow-sm object-fit-cover">
{% else %}
<span class="bg-secondary text-white rounded-circle d-inline-flex align-items-center justify-content-center"
style="width:36px;height:36px;font-size:1.2rem;">
{{ user.get_short_name|slice:":1"|upper }}
</span>
{% endif %}
</a>
<ul class="dropdown-menu dropdown-menu-end rounded-3 shadow-sm" aria-labelledby="userDropdown">
<li class="px-3 py-2 text-muted small">
{{ user.get_short_name }}<br>
<span class="text-secondary">{{ user.email }}</span>
</li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="{% url 'employees:profile' %}">
<i class="bi-person me-2"></i>Профиль</a></li>
<li>
<a class="dropdown-item" href="{% url 'auth_front:logout' %}">
<i class="bi-box-arrow-right me-2"></i>Выйти
</a>
</li>
</ul>
</div>
{% else %}
<a class="btn btn-outline-light rounded-pill me-2" href="{% url 'auth_front:login' %}">Войти</a>
<a class="btn btn-light rounded-pill" href="{% url 'auth_front:register' %}">Регистрация</a>
{% endif %}
</div>
</div>
</nav>