From e0599b946aabc2da7a2195cb511f658cb5aa5074 Mon Sep 17 00:00:00 2001 From: codex Date: Mon, 16 Nov 2026 17:52:44 +0300 Subject: [PATCH] Refresh employee results from primary filters automatically --- README.md | 2 +- app/static/admin.js | 103 +++++++++++++++++++++++++++++-- app/static/guide.js | 4 +- app/templates/directory.html | 13 ++-- app/templates/guide_content.html | 4 +- app/version.py | 6 +- pyproject.toml | 2 +- tests/test_api.py | 2 +- tests/test_council.py | 2 +- 9 files changed, 115 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 27f7c08..c81feca 100644 --- a/README.md +++ b/README.md @@ -47,7 +47,7 @@ uvicorn app.main:app --reload - «Сотрудники»: поиск, фильтры, сортировка, пагинация и выбор колонок. По умолчанию показаны ФИО, статус, должности, дата последнего обнаружения и внешний профиль. В диалоге колонок доступны наборы «Проверка», «Контакты» и «Все поля»; ранее сохранённый выбор сохраняется. - «Запуски»: история обходов, ошибки и доступный индикатор прогресса. -Поиск по ФИО или ссылке, ППС, сортировка и число строк видны всегда. Остальные условия находятся в «Дополнительных фильтрах». «Применить фильтры» обновляет список и возвращает на первую страницу, «Сбросить» очищает условия. «Скачать XLSX» выгружает все колонки и все строки, найденные с применёнными условиями, в выбранном порядке. Пояснения дат и статусов находятся под фильтрами. +Поиск по ФИО или ссылке срабатывает с четвёртого символа. ППС, сортировка и число строк применяются сразу. Остальные условия находятся в «Дополнительных фильтрах» и применяются кнопкой внутри панели. Изменение условий возвращает на первую страницу, «Сбросить» очищает условия. «Скачать XLSX» выгружает все колонки и все строки, найденные с применёнными условиями, в выбранном порядке. Пояснения дат и статусов находятся под фильтрами. Каталог поддерживает навигацию с клавиатуры и системный диалог колонок с Escape и возвратом фокуса. На узких экранах таблица прокручивается внутри страницы, колонка ФИО закреплена. Используется системный шрифт без внешних загрузок. diff --git a/app/static/admin.js b/app/static/admin.js index 14dc603..8e7f61c 100644 --- a/app/static/admin.js +++ b/app/static/admin.js @@ -78,6 +78,103 @@ }); } + function setupDirectoryFilters() { + const form = document.querySelector("[data-directory-filters]"); + if (!form) return; + const search = form.elements.q; + const summary = document.querySelector("[data-directory-summary]"); + const exportLink = document.querySelector("[data-directory-export]"); + const results = document.querySelector("[data-directory-results]"); + const pagination = document.querySelector("[data-directory-pagination]"); + const fields = ["q", "pps", "sort", "direction", "limit"]; + const readControls = () => { + const data = new FormData(form); + return new URLSearchParams(fields.map((name) => [name, data.get(name) || ""])); + }; + let applied = readControls(); + let appliedSummary = summary.textContent; + let timer; + let pending; + + form.querySelector(".directory__filter-panel").addEventListener("invalid", (event) => { + event.currentTarget.open = true; + }, true); + form.addEventListener("formdata", (event) => { + const text = search.value.trim(); + if (Array.from(text).length >= 4) event.formData.set("q", text); + else event.formData.delete("q"); + }); + + async function refresh() { + const next = readControls(); + if (next.toString() === applied.toString()) { + if (summary.textContent !== appliedSummary) summary.textContent = appliedSummary; + return; + } + // Keep applied additional filters even if their fields have unsubmitted edits. + const url = new URL(window.location.href); + url.searchParams.delete("offset"); + for (const [name, value] of next) { + if (value) url.searchParams.set(name, value); + else url.searchParams.delete(name); + } + const request = new AbortController(); + pending = request; + results.setAttribute("aria-busy", "true"); + try { + const response = await fetch(url, { + signal: AbortSignal.any([request.signal, AbortSignal.timeout(15000)]), + }); + if (!response.ok) throw new Error("directory request failed"); + const page = new DOMParser().parseFromString(await response.text(), "text/html"); + if (request.signal.aborted) return; + const nextSummary = page.querySelector("[data-directory-summary]"); + const nextExport = page.querySelector("[data-directory-export]"); + const nextResults = page.querySelector("[data-directory-results]"); + const nextPagination = page.querySelector("[data-directory-pagination]"); + if (!nextSummary || !nextExport || !nextResults || !nextPagination) throw new Error("directory results missing"); + history.replaceState(history.state, "", url); + results.replaceChildren(...nextResults.childNodes); + pagination.replaceChildren(...nextPagination.childNodes); + applyColumns(readColumns()); + exportLink.setAttribute("href", nextExport.getAttribute("href")); + appliedSummary = nextSummary.textContent; + summary.textContent = appliedSummary; + applied = next; + } catch (_error) { + if (!request.signal.aborted) { + summary.textContent = "Не удалось обновить список. Показаны предыдущие результаты."; + } + } finally { + if (pending === request) { + results.removeAttribute("aria-busy"); + pending = null; + } + } + } + + function schedule(delay = 0) { + clearTimeout(timer); + pending?.abort(); + if (delay) timer = setTimeout(refresh, delay); + else refresh(); + } + + search.addEventListener("input", (event) => { + if (!event.isComposing) schedule(250); + }); + search.addEventListener("compositionend", () => schedule(250)); + search.addEventListener("keydown", (event) => { + if (event.key === "Enter" && !event.isComposing) { + event.preventDefault(); + schedule(); + } + }); + form.querySelector(".directory__toolbar").addEventListener("change", (event) => { + if (event.target !== search) schedule(); + }); + } + function setupProgress() { const panel = document.querySelector("[data-progress-panel]"); if (!panel) return; @@ -148,11 +245,7 @@ }, 4000); } - const directoryFilters = document.querySelector(".directory__filter-panel"); - directoryFilters?.addEventListener("invalid", () => { - directoryFilters.open = true; - }, true); - setupColumns(); + setupDirectoryFilters(); setupProgress(); })(); diff --git a/app/static/guide.js b/app/static/guide.js index 11580ad..32d31a1 100644 --- a/app/static/guide.js +++ b/app/static/guide.js @@ -11,7 +11,7 @@ intro: (councilAccess ? 'Найдите сотрудника, подберите кандидатов в диссовет и проверьте публикации. ' : 'Найдите сотрудника и изучите его профиль. ') + 'Подсказки можно повторить из меню «Как пользоваться».'}, {id: 'employee-search', path: directory, title: 'Найдите сотрудника', region: '.directory__toolbar', tips: [ - ['[name="q"]', 'Введите фамилию, часть ФИО или ссылку на профиль ВШЭ.'], + ['[name="q"]', 'Введите фамилию или ссылку на профиль ВШЭ. Поиск срабатывает с четвёртого символа.'], ['[name="pps"]', 'Оставьте сотрудников профессорско-преподавательского состава.'], ]}, {id: 'employee-filters', path: directory, title: 'Уточните список', region: '.directory__filter-panel', tips: [ @@ -25,7 +25,7 @@ ]}, {id: 'employee-sort', path: directory, title: 'Настройте порядок списка', region: '.directory__toolbar', tips: [ ['[name="sort"]', 'Выберите поле сортировки. Стрелка вниз покажет наибольшие значения или новые даты первыми.'], - ['[name="limit"]', 'Выберите число строк и нажмите «Применить фильтры».'], + ['[name="limit"]', 'Выберите число строк. Список обновится автоматически.'], ]}, {id: 'employee-profile', path: directory, title: 'Откройте карточку сотрудника', region: '.directory__header', tips: [ ['[data-columns-open]', 'Выберите столбцы: например, должности, контакты и число публикаций.'], diff --git a/app/templates/directory.html b/app/templates/directory.html index 0f26bc1..867cb76 100644 --- a/app/templates/directory.html +++ b/app/templates/directory.html @@ -7,19 +7,19 @@

Сотрудники

{% set range_start = page.offset + 1 if page.total else 0 %} {% set range_end = [page.offset + page.employees|length, page.total]|min %} -

Показаны {{ range_start }}–{{ range_end }} из {{ page.total }}

+

Показаны {{ range_start }}–{{ range_end }} из {{ page.total }}

- Скачать XLSX + Скачать XLSX
{% set has_extra_filters = filters.status or filters.has_email or filters.has_academic_degree or filters.started_from or filters.started_to or filters.has_training or filters.training_since_year %} {% set has_filters = filters.q or filters.pps or has_extra_filters %} -
+
- + - Сбросить
@@ -95,7 +94,7 @@

«Год начала» — начало работы в ВШЭ. «Впервые найден» и «Последний раз найден» — даты обнаружения сотрудника в списке источника, а не даты приёма и увольнения. «Требует проверки» означает, что профиль недоступен и увольнение ещё не подтверждено.

-
+
@@ -138,7 +137,7 @@
-
+
{% set prev_offset = filters.offset - filters.limit %} {% set next_offset = filters.offset + filters.limit %} {% if filters.offset > 0 %} diff --git a/app/templates/guide_content.html b/app/templates/guide_content.html index b6ea853..e8fc33c 100644 --- a/app/templates/guide_content.html +++ b/app/templates/guide_content.html @@ -13,12 +13,12 @@

Найдите сотрудника и откройте профиль

-

В разделе «Сотрудники» введите в поле «ФИО или ссылка» фамилию, часть ФИО или ссылку на профиль ВШЭ. Отметьте «ППС», чтобы оставить только профессорско-преподавательский состав. Остальные условия находятся в панели «Дополнительные фильтры».

+

Введите фамилию, часть ФИО или ссылку на профиль ВШЭ. Поиск срабатывает с четвёртого символа. Отметьте «ППС», чтобы оставить профессорско-преподавательский состав. Остальные условия находятся в панели «Дополнительные фильтры» и применяются её кнопкой.

Статус, Email, Учёная степень
Ограничивают список по состоянию сотрудника и наличию сведений в профиле. Звание профессора или доцента не заменяет учёную степень.
Повышение квалификации
Выберите «Есть курсы» или «Нет курсов» по записям в профиле ВШЭ. Например, «Нет курсов» и 2024 покажут сотрудников без записей о курсах за 2024 год и позже. Если указать только год, отобразятся сотрудники с курсами за этот период.
Период обнаружения: От / До
Введите даты первого обнаружения профиля системой. Это не период приёма на работу.
-
Порядок списка
Выберите поле сортировки, направление стрелкой и число строк. «Применить фильтры» обновит список, «Сбросить» вернёт исходные параметры.
+
Порядок списка
Поле сортировки, направление и число строк сразу обновляют список. «Сбросить» вернёт исходные параметры.
Настроить колонки
Позволяет выбрать видимые сведения: должности, контакты, степень, число публикаций, курсов и новостей, даты обнаружения.
Скачать XLSX
В файл попадут все колонки и все сотрудники, найденные с применёнными фильтрами, в выбранном порядке.
diff --git a/app/version.py b/app/version.py index 7875975..7924afd 100644 --- a/app/version.py +++ b/app/version.py @@ -1,3 +1,3 @@ -APP_VERSION = "2.1.2" -FRONTEND_VERSION = "2.1.2" -BACKEND_VERSION = "2.1.2" +APP_VERSION = "2.2.0" +FRONTEND_VERSION = "2.2.0" +BACKEND_VERSION = "2.2.0" diff --git a/pyproject.toml b/pyproject.toml index 1ace9d8..ac965f6 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "miem-workers" -version = "2.1.2" +version = "2.2.0" description = "MIEM employees parser, admin API, and web admin" requires-python = ">=3.11" dependencies = [ diff --git a/tests/test_api.py b/tests/test_api.py index a698838..5e61710 100644 --- a/tests/test_api.py +++ b/tests/test_api.py @@ -22,7 +22,7 @@ def test_health_returns_versions(): response = TestClient(app).get("/api/health") assert response.status_code == 200 - assert response.json()["backend_version"] == "2.1.2" + assert response.json()["backend_version"] == "2.2.0" def test_api_employees_and_stats_require_admin_session(): diff --git a/tests/test_council.py b/tests/test_council.py index 8d2a826..462ad0a 100644 --- a/tests/test_council.py +++ b/tests/test_council.py @@ -230,7 +230,7 @@ def test_public_page_data_minimization_and_safe_links(db_session, export): assert "javascript:" not in fragment.text and "private@example.org" not in fragment.text assert "javascript:" not in response.text and "private@example.org" not in response.text assert "/admin/employees/" not in response.text and "/admin/logout" not in response.text - assert "Backend 2.1.2 · Frontend 2.1.2" in response.text + assert "Backend 2.2.0 · Frontend 2.2.0" in response.text assert "Вход в систему" in response.text assert client.get("/admin/directory", follow_redirects=False).status_code in (302, 303, 401, 403) assert "Сотрудники не найдены" in client.get("/admin/council?q=missing").text