docs(clinical): review revised specification and backtranslate PCL-5
CI / ruff · pytest (pull_request) Successful in 38s

Refs #52
This commit is contained in:
Pavel Eliseev
2026-10-03 17:38:54 +03:00
parent 57b5ad1eb2
commit fe5b6fe103
9 changed files with 520 additions and 28 deletions
+36 -26
View File
@@ -1,10 +1,21 @@
# Опросник: пакет проверки от 3 октября 2026
Статус: **подготовлено для проверки, не утверждено для пациентов**. Задача #52;
клиническое согласование остаётся в #8. Независимый обратный перевод, согласование
клиническое согласование остаётся в #8. Независимый человеческий обратный перевод, согласование
врачом и проверка линий звонками не выполнены. В `review-status.json` все эти
статусы оставлены незавершёнными.
## Обновление: PDF на 19 страницах
Получена дополненная версия от 3 октября. [Разбор изменений](revision-2026-10-03-v2/REVIEW.md)
и [машинный обратный перевод](revision-2026-10-03-v2/backtranslation-ai.md) сохранены
отдельно. TSQ заменил симптомные вопросы PC-PTSD-5; добавлены дневник и расписания.
**Код пока следует предыдущей версии, новая спецификация ещё не реализована.**
Текст TSQ в новом PDF отсутствует: перечислены только темы. Перевод выполнен тем
же ИИ по выбору пользователя; независимая человеческая проверка остаётся pending.
Описания реализованных правил и ссылки на страницы ниже относятся к исходному
14-страничному PDF, если явно не указана новая версия.
## Что реализовано
`app/core/questionnaire.py` содержит детерминированные правила первичного опроса:
@@ -112,45 +123,44 @@ q6 за всю жизнь всем; при положительном q6 уто
контакта» нельзя получить простой заменой заголовка Recent. Статус лицензии и
применимость к коммерческому продукту подтверждаются отдельно.
## Независимый обратный перевод
## Обратный перевод и независимая проверка
Передать переводчику **только** `backtranslation-blind.tsv` и следующие указания:
Для новой версии подготовлено 32 единицы: 28 PCL-5 и 4 из сохранённого блока
травмы. Русский текст сверён с PDF с.3 и 5–7. Машинный перевод выполнен в том же
чате без дополнительного агента по прямому выбору пользователя. Его нельзя
обозначать как слепую независимую проверку. Результат и последующая сверка
с оригиналом разделены в `revision-2026-10-03-v2/`.
1. Нужен независимый переводчик со свободным английским, не автор исходного
русского текста. Перевести каждую из 38 единиц буквально по смыслу, включая
инструкции, фильтр, вопросы и варианты ответа. Не искать и не подглядывать
в английский оригинал. Сохранить ID и порядок строк.
2. Заполнить `english_backtranslation`, сомнения в `translator_comment`, имя и
дату. Не «улучшать» русские формулировки. Неясный смысл отмечать явно.
3. Вернуть файл координатору. Если оригинал уже знаком переводчику, это указать:
такую работу нельзя считать слепой независимой проверкой.
Независимому человеку передать **только**
`revision-2026-10-03-v2/backtranslation-blind.tsv`:
Координатор и врач используют `translation-reconciliation.tsv` после получения
обратного перевода. Сопоставить смысл, отрицания, интенсивность, временной период,
привязку к событию и примеры с [PC-PTSD-5 VA](https://www.ptsd.va.gov/professional/assessment/screens/pc-ptsd.asp)
и [PCL-5 VA](https://www.ptsd.va.gov/professional/assessment/adult-sr/ptsd-checklist.asp).
По каждой строке записать расхождение, тяжесть, согласованный русский текст,
врача и дату решения. Не заполнять английские поля машинным переводом под видом
независимой работы. Одна обратная проверка не доказывает психометрическую валидацию.
1. Переводчик со свободным английским не должен быть автором исходного русского
текста. Перевести все 32 единицы, не читая английский оригинал и машинный результат.
2. Сохранить ID и порядок. Заполнить перевод, сомнения, имя и дату; русский текст
не исправлять. Если оригинал уже знаком, явно указать это ограничение.
3. Координатор и врач затем заполняют согласованный русский текст, решение,
подпись и дату в `revision-2026-10-03-v2/translation-reconciliation.tsv`.
Машинные замечания в нём являются предложениями для проверки.
Транскрипция взята из приложенного `questionnaires-mvp-source.pdf`, с.3–7;
нормализованы только переносы и межсловные пробелы. SHA-256 оригинала записан в
`review-status.json`. В репозитории текущие PC-PTSD-5/PCL-5 отличаются от PDF;
после согласования переносить именно утверждённую версию и зафиксировать diff.
Английские оригиналы не включены в слепой файл.
Исходные файлы `backtranslation-blind.tsv` и `translation-reconciliation.tsv`
в этой папке сохраняются как пакет прежней версии на 38 единиц. Пять симптомных
пунктов PC-PTSD-5 и его инструкция больше не входят в актуальный пакет.
Ни машинный, ни один человеческий обратный перевод сам по себе не доказывает
психометрическую валидность. Клинические данные переводчикам не передаются.
## Решения врача — поля намеренно не заполнены
| ID | Решение, которое нужно зафиксировать | Статус |
|---|---|---|
| C01 | Любой «Да» останавливает обычный опрос или разрешено продолжение после низкого риска? Различить обычный опрос, уточнение риска и кризисную помощь. PDF с.1 против с.11, скриншот поддерживает остановку. | pending |
| C01 | Любой «Да» останавливает обычный опрос или разрешено продолжение после низкого риска? Различить обычный опрос, уточнение риска и кризисную помощь. Новый PDF с.1 против с.12; в старом с.1 против с.11. Скриншот поддерживает остановку. | pending |
| C02 | С какой зоны RUS-AUDIT-S дополнять полную форму? Не переносить порог AUDIT-C ≥3/≥4. | pending |
| C03 | Самозаполнение полного RUS-AUDIT, таблица стандартных порций, порядок дополнения и повторные замеры. | pending |
| C04 | PC-PTSD-5 ≥3 и PCL-5 ≥31 для этой популяции; в текущем репозитории PCL-5 ≥33. | pending |
| C04 | Новая спецификация: TSQ ≥6 вместо PC-PTSD-5 ≥3; получить приложение Г1, согласовать применение и PCL-5 ≥31 для популяции. Код пока использует PC-PTSD-5. | pending |
| C05 | Привязка PHQ-9/PCL-5 к специалистам, сроки срочной помощи, параллельные маршруты и состав флагов. | pending |
| C06 | Официальный русский C-SSRS: версия, возраст/популяция, применение Recent и Since Last Contact. | pending |
| C07 | Как отвечает живой дежурный, что делать при недоступности, когда подтверждать уведомление врачу. | pending |
| C08 | Повторы, ухудшение, разные периоды оценки и выход из кризисного режима. | pending |
| C08 | Повторы, ухудшение, разные периоды оценки и выход из кризисного режима; расписание после смены лекарств 7/14/28 дней и далее 4 недели. | pending |
| C09 | Дневник: якоря ответов, направление показателей, пропуски, окно среднего, ночные флаги, приверженность и сроки реакции. См. разбор новой версии. | pending |
Форма решения: ID; выбранный вариант; обоснование; ФИО/роль врача; дата с часовым
поясом; версия политики; ссылка на подписанный протокол; проверенные сценарии.