AR 15 M4
52b46bc53e
Спринт 6c — терминология и сверка документации с реальным кодом:
- Словарь терминов в static/docs.html: «маршрутизатор» вместо «роутер»,
«защитное условие» вместо «guard», «пошаговая ветка» вместо «многошаговая».
Разделены концепты «намерение» (intent) и «ветка» (branch) с пометкой,
что в коде они хранятся как одна сущность 1:1.
- Песочница: «Решение маршрутизатора» виден всегда (зелёный/жёлтый),
счётчик переключений «N из 3» отдельной плашкой, бейджи под словарь.
- Настройки: «Условия перехода» → «Защитные условия (guards, JSON)».
- GRAPH_ARCHITECTURE_v4.md: имена полей thread_state и слоты приведены
к реальной БД (db/models/thread_state.py) и таксономии промптов шагов
(prompts/intents/new_booking/steps/). Ссылки на *_v2 примеры. На v3
поставлена шапка «устарело».
- 4 примера переписаны как *_v2: реальные current_intent_code/
current_step_code/slots_json, реальные allowed_next без двойных переходов,
реальная таксономия слотов name/reason/specialist/preferred_time/confirmed.
Удалены вымышленные CRM tool calls и слоты, которых нет в коде.
- static/example.html — параметризованная страница с навигацией между
4 примерами; роут GET /api/docs/examples/{name} в main.py отдаёт
markdown без дублирования файлов.
- Редактирование документов в Отладке: GET/PUT /documents/{id}/raw,
textarea с переразметкой и обновлением Chroma при сохранении.
Спринт 7, часть A — мульти-RAG через подписку ветка↔документы:
- Миграция: таблица intent_documents (M:N), модель IntentDocument,
индекс по document_id для обратного поиска.
- API: GET/PUT /intents/{code}/documents и GET/PUT /documents/{id}/intents
с PUT-семантикой «полный список», атомарно. Сервис
services/intent_document_service.py.
- Retrieval-фильтр в chat_service: подтягивает document_ids активной
ветки и передаёт в vectorstore.query(). Дефолт пустой подписки —
document_ids=[] (= 0 чанков), не «вся коллекция»: пустая подписка
означает «ветка не настроена», подмешивать случайное хуже, чем
ничего. vectorstore.query() различает None (нет фильтра) и [] (0).
- UI Настроек: блок «Документы базы знаний» в правом сайдбаре,
всегда видим независимо от вкладки, сортировка по имени, счётчик
«N из M», PUT при сохранении.
- UI Отладки: третья кнопка «привязка» рядом с «удалить» —
раскрывашка со списком веток (галочки), быстрая привязка прямо
на странице загрузки.
- Песочница: блок «Срез RAG» с подпиской/найдено, ворнинг при пустой
подписке. Поле rag_subscription в QueryResponse и ChatResponse.
- Системный промпт страницы Отладки переехал в обычную ветку _debug
(«Страница отладки»). Удалён prompts/system_prompt.md и логика
DEFAULT_SYSTEM_PROMPT в llm_client. routers/query.py подтягивает
активный конфиг ветки _debug и её подписки. Дефолт пустой подписки
для _debug — None (вся коллекция), не [] как для пациентских — чтобы
Отладка работала «из коробки». На странице Отладки info-bar показывает
активную версию и счётчик подписок, ссылка → Настройки.
- Тест-блок «Тест-вопрос» в центре Настроек: расширил /query
параметрами intent_code (default _debug), system_prompt (override
для теста черновика из textarea), disable_rag (для _router).
Редактор промпта обёрнут в <details open> — можно свернуть до
одной строки. Под ним — три колонки результата (RAG / промпт /
ответ). Для _router показывается подсказка про отсутствие RAG.
Документы:
- data/datasets/*.md — наработки по 6 веткам (рабочие материалы оператора).
- docs/BRANCH_MAP_AND_PROMPTS_v1.md, docs/OPTIMIZATION_CONVERSION_v1.md,
docs/guides/state_machine_and_slots.md.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
206 lines
21 KiB
Markdown
206 lines
21 KiB
Markdown
---
|
||
intent: general_info
|
||
title: Общая справка по клинике (датасет для общей ветки)
|
||
purpose: Источник для РАГа в ветке general_info — общие вопросы пациентов: адреса, как добраться, парковка, контакты, направления, врачи, базовые правила.
|
||
sources:
|
||
- Ya_wiki_kugn/out/yandex-wiki-catalog/homepage/sluzhba-administratorov/obshhaja-informacija/kak-dobratsja-do-kliniki.md
|
||
- Ya_wiki_kugn/out/yandex-wiki-catalog/homepage/sluzhba-administratorov/obshhaja-informacija/istorija-kliniki.md
|
||
- Ya_wiki_kugn/out/yandex-wiki-catalog/homepage/sluzhba-administratorov/rekvizity-kliniki.md
|
||
- Ya_wiki_kugn/out/yandex-wiki-catalog/homepage/udalennyjj-kontakt-centr/obshhaja-informacija/kontakty-kliniki.md
|
||
- Ya_wiki_kugn/out/yandex-wiki-catalog/homepage/udalennyjj-kontakt-centr/obshhaja-informacija/preimushhestva-nashejj-kliniki.md
|
||
- Ya_wiki_kugn/out/yandex-wiki-catalog/homepage/udalennyjj-kontakt-centr/organizacionnye-voprosy/klinika-doktora-pirogova/obshhaja-informacija-klinika-doktora-pirogova.md
|
||
- Ya_wiki_kugn/vrachi-kliniki-svodnyj-spisok.md
|
||
- Ya_wiki_kugn/skripty-vozrazhenija-chavo-obshhijj-spravochnik.md
|
||
note: Файл собран вручную из выгрузки Yandex Wiki. После запуска подписки на вики этот файл заменит автоматически обновляемый источник.
|
||
---
|
||
|
||
# Общая справка по клинике
|
||
|
||
## О клинике коротко
|
||
|
||
ООО «Клиника ухо, горло, нос имени профессора Е. Н. Оленевой» — специализированная сеть в Перми и Краснокамске. Создана в 2000 году как Скорая ЛОР помощь, с 2007 года работает в статусе специализированной ЛОР клиники, с 2008 года носит имя профессора Е. Н. Оленевой. В 2016 году в составе сети открылось направление «Клиника лечения кашля и аллергии».
|
||
|
||
В сеть входят три филиала: ЛОР-клиника на Клары Цеткин, Клиника лечения кашля и аллергии на Газеты Звезда, Клиника доктора Пирогова в Краснокамске.
|
||
|
||
## Адреса филиалов
|
||
|
||
- Клиника ухо, горло, нос — г. Пермь, ул. Клары Цеткин, 9.
|
||
- Клиника лечения кашля и аллергии — г. Пермь, ул. Газеты Звезда, 31а.
|
||
- Клиника доктора Пирогова — г. Краснокамск, ул. Карла Маркса, 14а.
|
||
|
||
## Телефоны для пациентов
|
||
|
||
- Клиника ухо, горло, нос (К. Цеткин, 9) — 8 (342) 207-03-03.
|
||
- Клиника лечения кашля и аллергии (Г. Звезда, 31а) — 8 (342) 200-02-03.
|
||
- Клиника доктора Пирогова (Краснокамск) — 8 (342) 207-03-00.
|
||
- Линия «Операции» — 8 (342) 207-03-01.
|
||
- Линия «ЛОРДЕНТ» — 8 (342) 287-16-94.
|
||
|
||
## Электронные адреса для пациентов
|
||
|
||
- Общий адрес клиники (указан на сайте): clinic-lor@mail.ru
|
||
- Адрес для отправки анализов пациентам: test@oclinica.ru
|
||
- Адрес клиники Пирогова: info@docpirogov.ru
|
||
|
||
## Сайты
|
||
|
||
- Сеть клиник: https://www.oclinica.ru, https://perm.oclinica.ru/lor
|
||
- Клиника лечения кашля и аллергии: https://perm.oclinica.ru/allergo
|
||
- Клиника доктора Пирогова: https://docpirogov.ru/
|
||
|
||
## Как добраться: Клары Цеткин, 9
|
||
|
||
Автобусы №№ 4, 8, 11, 13, 27, 31, 45, 50, 62, 71, 823. Трамваи № 5 и № 8.
|
||
|
||
Высадиться можно на остановке «Строительный факультет» (если ехать автобусами 8, 31, 50, 62, 71 или трамваями 5, 8) или на остановке «Куйбышева» (если ехать автобусами 4, 11, 13, 27, 823). Далее нужно дойти до улицы Клары Цеткин и пройти в арку дома, после чего повернуть к зданию № 9. Расстояние пешего пути — около 450 метров.
|
||
|
||
## Как добраться: Газеты Звезда, 31а
|
||
|
||
Автобусы №№ 3, 30, 32, 50, 55, 67, 77, 78.
|
||
|
||
Выйти на остановке «улица Газеты Звезда». Пройти между домами 25 и 27 на ул. Пушкина во двор, через шлагбаум. Вход в клинику находится с левой стороны.
|
||
|
||
Альтернативный маршрут: выйти на остановке «Октябрьская площадь», пройти по «компросу» направо до перекрёстка, повернуть налево и далее во двор между домами 25 и 27.
|
||
|
||
## Как добраться: Краснокамск, Карла Маркса, 14а (Клиника доктора Пирогова)
|
||
|
||
Ориентиры: рядом поликлиника №1, школа №10 и музыкальная школа. Здание стоит на месте бывшей «Лабдиагностики», вход с другой стороны — со двора.
|
||
|
||
Ближайшие остановки автобусов: «Карла Маркса», «Поликлиника». От автовокзала: автобусы 206, 100, 195 до остановки «Карла Маркса», далее пешком по улице Карла Маркса около 5 минут.
|
||
|
||
## Парковка
|
||
|
||
Закрытой парковки для посетителей у клиник на Клары Цеткин и Газеты Звезда нет. Платные городские парковки расположены вдоль улиц Пушкина, Газеты Звезда и Луначарского.
|
||
|
||
## Режим работы
|
||
|
||
- Клиника доктора Пирогова (Краснокамск): понедельник–пятница, с 8:00 до 14:00. Суббота и воскресенье — выходные.
|
||
- Режим работы филиалов на Клары Цеткин и Газеты Звезда в выгрузке вики не указан явно — при вопросе пациента уточнить у оператора.
|
||
|
||
## Направления приёма
|
||
|
||
В клиниках сети ведут приём специалисты по следующим направлениям:
|
||
|
||
- Оториноларингология (ЛОР), включая детский ЛОР.
|
||
- Аллергология-иммунология.
|
||
- Пульмонология.
|
||
- Отоневрология.
|
||
- Сурдология и сурдоакустика (подбор слуховых аппаратов).
|
||
- Фониатрия.
|
||
- Семейный врач (общая практика) — в Клинике доктора Пирогова.
|
||
- Анестезиология (для операций).
|
||
|
||
В клинике проводится диагностика (эндоскопия ЛОР-органов, тимпанометрия, спирография и др.) и лечебные процедуры (промывание носа, удаление серных пробок и др.). Операции выполняются эндоскопическим методом, под общим наркозом препаратом «Севоран».
|
||
|
||
## Преимущества клиники (формулировки для пациентов)
|
||
|
||
- В клинике принимают высококвалифицированные специалисты, есть кандидаты медицинских наук.
|
||
- В каждом ЛОР-кабинете установлен эндоскоп — врач проводит диагностику прямо на приёме и сразу расшифровывает результат.
|
||
- Лечебные процедуры (промывание носа, удаление серных пробок и т. п.) врач может выполнить на этом же приёме.
|
||
- Операции проводятся эндоскопическим методом: точная диагностика, минимальная травматичность, быстрое восстановление, низкий процент осложнений. В большинстве случаев пациент возвращается домой в день операции.
|
||
- Используется современный наркоз газом «Севоран» — без головокружения, тошноты и дезориентации после пробуждения.
|
||
- Удобное расположение в центре Перми, комфортная обстановка.
|
||
|
||
## Список врачей по специальностям
|
||
|
||
### Отоларингологи
|
||
|
||
Акутина А. В., Анфилатов А. В., Верещагина Л. В., Волкова Н. Г., Гашеева И. В., Генеральчук Л. В., Головач С. В., Давлятшина О. А., Долгих Е. П., Зыкин О. В., Иванова А. А., Коротаева В. А., Лебединская Е. А., Лобанова И. Ю., Макарова Л. Г., Осадчий А. П., Семерикова Н. А., Синдяев А. В., Суднева А. Р., Сушков М. Г. (заведующий ЛОР-отделением №2, К. Цеткин), Терво С. О., Уткина Н. П., Хмелёва М. А., Шайдурова В. Н., Шевырина Н. Г., Юрков В. С.
|
||
|
||
### Аллергологи-иммунологи
|
||
|
||
Антонова Е. В., Скорюпина Л. А., Суслонова Ю. В. (заведующая отделением аллергологии и пульмонологии, Г. Звезда 31а), Чепикова Е. Н. (в декрете).
|
||
|
||
### Пульмонологи
|
||
|
||
Абыденков А. В.
|
||
|
||
### Отоневролог
|
||
|
||
Ворончихина Н. В.
|
||
|
||
### Сурдоакустик
|
||
|
||
Торсунова Н. С.
|
||
|
||
### Анестезиолог
|
||
|
||
Зайцев К. Ю.
|
||
|
||
## Что взять с собой на приём
|
||
|
||
- Взрослому пациенту — паспорт.
|
||
- Если на приём приходит ребёнок: паспорт законного представителя и свидетельство о рождении ребёнка (если ребёнок не вписан в паспорт).
|
||
- Если ребёнка приводит не законный представитель (бабушка, дедушка, знакомая), сопровождающему нужны: его паспорт, доверенность от законного представителя, копия свидетельства о рождении ребёнка и копия паспорта законного представителя. Форма доверенности опубликована на сайте клиники.
|
||
- Если у пациента уже есть результаты ранее сделанных анализов или исследований — желательно взять их с собой. Перед первичным приёмом ЛОРа специально сдавать анализы не нужно.
|
||
- Подойти к клинике рекомендуется за 5 минут до назначенного времени для оформления медицинской документации.
|
||
|
||
## Дети на приёме
|
||
|
||
Несовершеннолетние пациенты до 15 лет могут находиться в клинике только в сопровождении родителей, близких родственников, опекунов или иных законных представителей. С 15 лет, если по объективным причинам прийти с родителями невозможно, пациент со своим паспортом может сам подписать договор. Подростки 16–17 лет (например, иногородние студенты) могут обращаться в клинику самостоятельно.
|
||
|
||
## Что в клинике не делают (часто спрашивают)
|
||
|
||
В клинике не проводятся: абляция (криодеструкция миндалин), барофункция уха и придаточных пазух, бронхоскопия, кардиореспираторный мониторинг (КРМ), КСВП (коротколатентные слуховые вызванные потенциалы), риноманометрия, электрофорез. Не лечатся гемангиомы (ими занимаются сосудистые хирурги), назальная ликворея, сиалоаденит.
|
||
|
||
## Правила поведения в клинике (краткая выжимка для пациентов)
|
||
|
||
- В клинике запрещено курение, фото- и видеосъёмка без разрешения, нахождение в состоянии алкогольного или наркотического опьянения, проход с животными.
|
||
- В медицинских кабинетах со специальным санитарным режимом необходимо снять верхнюю одежду и надеть сменную обувь.
|
||
- При входе в кабинет мобильный телефон рекомендуется отключить.
|
||
- В общественных местах клиники может вестись видеонаблюдение.
|
||
|
||
## Юридические реквизиты
|
||
|
||
ООО «Клиника ухо, горло, нос имени профессора Е. Н. Оленевой» (ООО «Клиника ухо, горло, нос»). Зарегистрировано 26 мая 2011 г., ИФНС по Свердловскому району г. Перми. ОГРН 1115904009077, ИНН 5904250275, КПП 590401001. Юридический и фактический адрес: 614010, г. Пермь, ул. Клары Цеткин, 9. Обособленное подразделение: 614000, г. Пермь, ул. Газеты Звезда, 31а. Генеральный директор — Разорвин Алексей Михайлович, действует на основании Устава.
|
||
|
||
---
|
||
|
||
# Анализ материалов вики и предложения по дополнению
|
||
|
||
Раздел носит технический характер — это рабочие пометки для последующего наполнения. В РАГ-ответы пациенту он не должен попадать (рекомендуется при индексировании отрезать всё, что после этой строки, либо хранить раздел в отдельном файле — см. ниже).
|
||
|
||
## Что уверенно покрыто из выгрузки
|
||
|
||
- Адреса всех трёх филиалов.
|
||
- Телефонные линии для пациентов.
|
||
- Транспорт и пеший маршрут до Цеткин и Газеты Звезда.
|
||
- Парковка в Перми.
|
||
- Режим работы только клиники Пирогова.
|
||
- Список врачей по специальностям (из сводного файла `vrachi-kliniki-svodnyj-spisok.md`).
|
||
- История клиники, имени Оленевой.
|
||
- Юридические реквизиты.
|
||
- Список процедур, которые в клинике не проводятся.
|
||
|
||
## Что в выгрузке отсутствует или скудно — стоит дополнить вручную в вики
|
||
|
||
- **Режим работы Цеткин и Газеты Звезда.** Вообще не нашёлся в выгрузке. Это самый частый вопрос пациента в ветке `general_info` — нужно явно прописать рабочие часы каждой клиники, включая обед, выходные и работу в праздничные дни.
|
||
- **Wi-Fi.** Системный промпт ветки явно ожидает ответ на вопрос «есть ли Wi-Fi». В вики этого нет.
|
||
- **Доступная среда / маломобильные пациенты.** В выгрузке есть алгоритм действий администратора при обращении маломобильных, но нет короткой пациент-ориентированной заметки: есть ли пандус, лифт, как лучше подъехать.
|
||
- **Детский приём.** Понятно, что детей принимают, но нет короткой страницы «детский ЛОР»: с какого возраста, кто из врачей принимает детей, что взять с собой кроме базовых документов.
|
||
- **Подготовка к приёму по специальностям.** Для аллерголога, отоневролога, сурдолога есть нюансы (отмена антигистаминных перед аллерго-тестом и т. п.). Сейчас всё разбросано по скриптам записи — стоит свести в одну страницу «Подготовка к приёму».
|
||
- **Ориентиры и фото входа.** Для Цеткин и Газеты Звезда нет фотографий входа и подробных ориентиров — для Пирогова есть. Для патчат-сценария «не могу найти вход» это полезно.
|
||
- **Платежи и ДМС в общем виде.** Какие способы оплаты принимаются (карта, наличные, СБП), кратко про ДМС-партнёров. Детально это уйдёт в ветку `price_question`, но в общей справке нужна одна-две фразы.
|
||
- **Время приёма по умолчанию.** Сколько обычно длится первичный приём ЛОРа, аллерголога. Пациенты часто спрашивают «во сколько успею».
|
||
- **Отмена и перенос.** Короткое правило «как отменить запись» (полноценно — в ветке `reschedule`, но ссылка-минимум полезна и в общей).
|
||
- **Документы по итогам приёма.** Заключение, выписка, больничный, справка ФНС — что выдают и в какой форме. Сейчас это в отдельных подразделах вики, для общей ветки нужна короткая сводка.
|
||
|
||
## Что НЕ должно попадать в датасет общей ветки (но есть в вики)
|
||
|
||
При следующих итерациях нужно явно отфильтровать при автообновлении:
|
||
|
||
- Внутренние добавочные номера сотрудников и врачей (из `kontakty-kliniki.md`) — это служебная информация для администраторов, пациенту озвучивать нельзя.
|
||
- Логины и пароли почтовых ящиков и сервисов (из `akkaunty.md`) — это явная утечка, такие страницы вообще не должны попадать в РАГ.
|
||
- Цены, скидки, ДМС — отдельная ветка `price_question`, в общей не должны звучать.
|
||
- Скрипты записи и работы с возражениями — это контент для веток `new_booking` и `escalate_human`.
|
||
|
||
## Предложение по структуре подписки
|
||
|
||
Когда мультиагент будет подписан на живую вики, имеет смысл хранить датасеты не одним файлом, а блоком файлов под каждую ветку, например: `data/datasets/general_info/*.md`. Тогда:
|
||
|
||
- Каждый файл = одна страница вики (адрес, режим, врачи, преимущества и т. д.).
|
||
- При обновлении страницы в вики обновляется ровно один файл, индекс пересобирается локально.
|
||
- Чувствительные страницы (пароли, добавочные) можно явно занести в чёрный список фильтра подписки.
|
||
|
||
Текущий единый файл — временный формат для тестирования первой версии РАГа в ветке `general_info`.
|