SurgiPlan
SurgiPlan SaaS
Официальное руководство пользователя

Единая цифровая экосистема планирования хирургических вмешательств, контроля занятости операционных залов и управления рисками анестезиологической безопасности.

Official User Guide

Unified digital ecosystem for surgical scheduling, operating room workload monitoring, and anesthesia safety risk management.

Պաշտոնական օգտագործողի ուղեցույց

Վիրահատական միջամտությունների պլանավորման, վիրահատարանների ծանրաբեռնվածության վերահսկման և անզգայացման անվտանգության ռիսկերի կառավարման միասնական թվային էկոհամակարգ:

Служба поддержки: support@surgiplan.org
Версия системы: 4.0.0 • 2026 г.
Support Service: support@surgiplan.org
System Version: 4.0.0 • 2026
Աջակցման ծառայություն: support@surgiplan.org
Համակարգի տարբերակ: 4.0.0 • 2026 թ.

Содержание

Настоящее руководство описывает возможности SaaS-платформы SurgiPlan, роли участников процесса и правила планирования операций.

Table of Contents

This guide describes the capabilities of the SurgiPlan SaaS platform, roles of the process participants, and surgery scheduling rules.

Բովանդակություն

Սույն ուղեցույցը նկարագրում է SurgiPlan SaaS հարթակի հնարավորությունները, գործընթացի մասնակիցների դերերը և վիրահատությունների պլանավորման կանոնները:

1. О сервисе и архитектуре платформы

SurgiPlan — это многопользовательская облачная SaaS-платформа, созданная для автоматизации работы операционных блоков, минимизации простоев залов и предотвращения конфликтов планирования.

Ключевые архитектурные особенности:

  • Гибридный режим: Приложение работает как в локальном автономном режиме (сохранение на компьютере), так и в сетевом режиме API с репликацией на выделенный сервер.
  • Защита персональных данных: ФИО пациентов и диагнозы шифруются на стороне клиента с использованием алгоритма AES-256-GCM перед отправкой в базу данных. Доступ к ключу шифрования имеют только авторизованные сотрудники клиники.
  • Безопасность портов: Хранилища данных PostgreSQL и кэши Redis закрыты от внешнего интернета и изолированы внутри виртуальной сети Docker.

Начало работы:

  1. Регистрация клиники и выбор локализации (поддержка RU, EN, HY).
  2. Настройка операционных залов в разделе настроек.
  3. Добавление персонала (хирурги, анестезиологи, ассистенты).

1. About the Service and Platform Architecture

SurgiPlan is a multi-user cloud SaaS platform designed to automate operating room workflows, minimize room downtime, and prevent scheduling conflicts.

Key Architectural Features:

  • Hybrid Mode: The application operates in both local offline mode (stored on the computer) and network API mode with replication to a dedicated server.
  • Personal Data Protection: Patient names (FIO) and diagnoses are encrypted client-side using the AES-256-GCM algorithm before being transmitted to the database. Only authorized clinic staff have access to the encryption key.
  • Port Security: PostgreSQL data stores and Redis caches are closed to the external internet and isolated inside a private Docker virtual network.

Getting Started:

  1. Clinic registration and localization choice (RU, EN, HY support).
  2. Operating rooms setup in the settings section.
  3. Staff enrollment (surgeons, anesthesiologists, assistants).

1. Ծառայության և հարթակի ճարտարապետության մասին

SurgiPlan-ը բազմաօգտատեր ամպային SaaS հարթակ է, որը նախատեսված է վիրահատարանների աշխատանքի ավտոմատացման, դահլիճների պարապուրդի նվազեցման և պլանավորման բախումների կանխարգելման համար:

Ճարտարապետական հիմնական առանձնահատկությունները:

  • Հիբրիդային ռեժիմ: Հավելվածն աշխատում է ինչպես տեղական ինքնավար ռեժիմում (պահպանում համակարգչում), այնպես էլ ցանցային API ռեժիմում՝ հատկացված սերվերում ռեպլիկացիայով:
  • Անձնական տվյալների պաշտպանություն: Հիվանդների ԱԱՀ-ն և ախտորոշումները վերծանվում և կոդավորվում են հաճախորդի կողմից՝ օգտագործելով AES-256-GCM ալգորիթմը նախքան տվյալների բազա ուղարկելը: Կոդավորման բանալուն հասանելիություն ունեն միայն կլինիկայի լիազորված աշխատակիցները:
  • Դիմանկարային անվտանգություն: PostgreSQL տվյալների պահոցները և Redis քեշերը փակ են արտաքին ինտերնետից և մեկուսացված են Docker վիրտուալ ցանցի ներսում:

Աշխատանքի սկիզբը:

  1. Կլինիկայի գրանցում և լեզվի ընտրություն (RU, EN, HY աջակցություն):
  2. Վիրահատարանների կարգավորում կարգավորումների բաժնում:
  3. Անձնակազմի ավելացում (վիրաբույժներ, անեսթեզիոլոգներ, օգնականներ):

2. Ролевая модель доступа и прав (10 Клинических и Административных Ролей)

Платформа использует строгую ролевую модель доступа (RBAC). Это гарантирует медицинскую безопасность, изоляцию врачебной тайны и соблюдение регламентов.

SaaS SuperadminСуперадмин платформы. Управляет подписками всех клиник, ведет тикеты поддержки, настраивает тарифы и DevOps-телеметрию сервера. Zero-Knowledge изоляция: 0 доступа к медицинским операционным данным, календарям и клинической аналитике.

Clinic AdminАдминистратор клиники. Регистрирует сотрудников, создает залы, оплачивает подписку, просматривает аудит действий персонала. Без доступа к медицинским записям.

ExecutiveРуководство клиники. Доступ с текстовым полем «Должность» (Главврач, Директор). 100% Read-Only доступ ко всем отделениям, операциям и аналитике оперблока.

Head of Surgery / ServiceРуководитель службы / Зав. хирургией. Утверждает план своего отделения (`dept_id`), налагает Организационное Вето, назначает И.О. Работает строго в рамках своего отделения.

Head of Anesthesia / ServiceРуководитель службы / Зав. анестезиологией. Налагает Медицинское Вето на операции, управляет числом бригад (жесткий автоблок при превышении), видит аналитику типов операций по отделениям.

SurgeonХирург. Добавляет и ведет свои операции, получает доступ к 💡 Персональному ИИ-Коучу для анализа скорости и задержек, и скачивает официальное Word-портфолио. В залах других отделений видит только 🔒 Забронировано.

AnesthesiologistВрач-Анестезиолог. Просматривает карты пациентов клиники для подготовки к наркозу, ведет анестезиологические записи (Append-Only Notes). Без права на Вето.

Nurse AnesthetistМедсестра-анестезистка. Ведет Чек-лист ВОЗ и отмечают 6 этапов операции в реальном времени.

Operating NurseОперационная медсестра. Read-Only доступ к расписанию для подготовки стерильного инструментария.

Delegated UserИ.О. Заведующего. Временное исполнение обязанностей заведующего на период отпуска.

2. Role-Based Access Control and Permissions (10 Clinical & Administrative Roles)

The platform uses a role-based access control (RBAC) matrix to guarantee medical safety, PHI data isolation, and policy compliance.

SaaS SuperadminPlatform Owner. Manages subscriptions, support tickets, DevOps telemetry. Zero-Knowledge Isolation: Zero access to medical operations, schedules, or clinical metrics.

Clinic AdminClinic Administrator. Enrolls staff, configures OR rooms, manages billing, views audit logs. No medical records editing.

ExecutiveClinic Executive. Higher management role with mandatory "Position" title (CMO, Director). 100% Read-Only access across all departments and analytics.

Head of Surgery / ServiceHead of Surgery / Service. Confirms department daily list, places Administrative Veto, delegates acting head. Restricted strictly to own department scope.

Head of Anesthesia / ServiceHead of Anesthesia / Service. Places Medical Veto, manages anesthesia brigades (strict capacity blocking), views operation breakdown analytics across departments.

SurgeonAttending Surgeon. Schedules surgeries, accesses 💡 Personal AI Surgical Coach for timing benchmarks and downloads personal Word (.doc) portfolio.

AnesthesiologistAnesthesiologist. Views hospital patient records for anesthesia prep, appends anesthesia notes. No veto rights.

Nurse AnesthetistNurse Anesthetist. Fills out WHO checklist and logs 6 real-time surgery timestamps.

Operating NurseOR Nurse. Read-Only schedule view for room and instrument preparation.

Delegated UserActing Department Head. Temporary delegation of department head rights during vacation.

2. Մուտքի դերային մոդել և իրավունքներ (10 Կլինիկական և Վարչական Դերեր)

Հարթակն օգտագործում է դերերի վրա հիմնված մուտքի վերահսկման մատրիցա (RBAC)՝ երաշխավորելով բժշկական անվտանգությունն ու տվյալների պաշտպանությունը:

SaaS SuperadminSaaS Սուպերադմին: Կառավարում է բաժանորդագրությունները, DevOps սերվերային տվյալները: Zero-Knowledge իզոլացիա՝ զրոյական հասանելիություն կլինիկական գրաֆիկներին և բժշկական տվյալներին:

Clinic AdminԿլինիկայի ադմինիստրատոր: Գրանցում է անձնակազմը, կառավարում դահլիճներն ու վճարումները:

ExecutiveԿլինիկայի Ղեկավարություն: Պաշտոնի նշումով (Գլխավոր Բժիշկ, Տնօրեն): 100% Read-Only հասանելիություն բոլոր բաժանմունքներին և վերլուծությանը:

Head of Surgery / ServiceԾառայության Ղեկավար / Վիրաբուժության Վարիչ: Հաստատում է բաժանմունքի պլանը, դնում կազմակերպչական վետո: Աշխատում է միայն իր բաժանմունքի շրջանակներում:

Head of Anesthesia / ServiceԾառայության Ղեկավար / Անեսթեզիոլոգիայի Վարիչ: Դնում է Բժշկական Վետո, կառավարում է բրիգադների լիմիտները, դիտում է վերլուծությունը:

SurgeonՎիրաբույժ: Ավելացնում է վիրահատություններ, տեղաշարժում է միայն իր գրառումները:

AnesthesiologistԱնեսթեզիոլոգ: Դիտում է բոլոր հիվանդների քարտերը անզգայացման նախապատրաստման համար:

Nurse AnesthetistԱնզգայացնող բուժքույր: Լրացնում է ԱՀԿ ստուգաթերթը և ֆիքսում 6 իրական ժամանակի փուլերը:

Operating NurseՎիրահատարանի բուժքույր: Միայն դիտման ռեժիմ՝ գործիքների նախապատրաստման համար:

Delegated UserՓոխարինող Ժ.Պ.: Ժամանակավոր փոխարինում արձակուրդի ընթացքում:

3. Интерактивная сетка планирования

Интерактивный календарь позволяет распределять операции по залам в формате сетки времени с шагом в 15 минут.

Основные elements расписания:

  • Анестезиологическая подготовка (Prep Time): Окрашена оранжевым пунктиром перед началом операции (по умолчанию 20 минут). Резервирует время для ввода пациента в наркоз.
  • Сама операция: Основной блок с информацией о пациенте (дешифрованное ФИО), диагнозе, типе процедуры и ведущем хирурге.
  • Период пробуждения (Wake Up Time): Окрашен зеленым пунктиром после операции (по умолчанию 15 минут) для безопасного вывода из наркоза.

Интеллектуальный контроль наложений:

Система автоматически проверяет наложение временных интервалов. Одному хирургу или в один операционный зал невозможно поставить две параллельные процедуры. Нарушение интервалов блокируется формой сохранения с выводом предупреждения.

3. Interactive Scheduling Grid

The interactive calendar allows distributing surgeries across OR rooms in a timeline format with 15-minute intervals.

Main Schedule Elements:

  • Anesthesia Preparation (Prep Time): Indicated by an orange dashed border before the surgery begins (default is 20 minutes). Reserves time for administering anesthesia.
  • The Surgery: The main block containing patient information (decrypted name), diagnosis, procedure type, and the lead surgeon.
  • Recovery Period (Wake Up Time): Indicated by a green dashed border after the surgery (default is 15 minutes) for safe recovery from anesthesia.

Smart Conflict Checking:

The system automatically checks for overlapping time intervals. It is impossible to schedule two parallel procedures for the same surgeon or in the same operating room. Overlapping intervals are blocked upon saving with an alert message.

3. Ինտերակտիվ պլանավորման ցանց

Ինտերակտիվ օրացույցը թույլ է տալիս բաշխել վիրահատությունները ըստ դահլիճների՝ 15 րոպեանոց քայլով ժամանակային ցանցի ձևաչափով:

Չվացուցակի հիմնական տարրերը:

  • Անզգայացման նախապատրաստում (Prep Time): Նշվում է նարնջագույն կետագծով վիրահատությունից առաջ (լռելյայն՝ 20 րոպե): Ժամանակ է ամրագրում հիվանդին նարկոզի ենթարկելու համար:
  • Բուն վիրահատությունը: Հիմնական բլոկը՝ հիվանդի տվյալներով (ԱԱՀ), ախտորոշումով, միջամտության տեսակով և առաջատար վիրաբույժով:
  • Արթնացման ժամանակահատված (Wake Up Time): Նշվում է կանաչ կետագծով վիրահատությունից հետո (լռելյայն՝ 15 րոպե)՝ նարկոզից անվտանգ դուրս գալու համար:

Խելացի բախումների վերահսկողություն:

Համակարգն ավտոմատ կերպով ստուգում է ժամանակային միջակայքերի համընկնումները: Մեկ վիրաբույժի կամ նույն վիրահատարանի համար անհնար է երկու զուգահեռ միջամտություն նշանակել: Համընկնումների դեպքում պահպանումն արգելափակվում է նախազգուշացման ցուցադրմամբ:

4. Безопасность: Вето, Автозамок 18:00 и Чек-лист ВОЗ

SurgiPlan ориентирован на снижение медицинских рисков, предотвращение накладок и соблюдение регламентов безопасности.

1. Организационное и Медицинское Вето:

При неготовности пациента Заведующий хирургией налагает Организационное Вето. При выявлении анестезиологических противопоказаний Заведующий анестезиологией налагает Медицинское Вето. Операция отменяется, а персонал получает авто-уведомление.

2. Автономный автозамок в 18:00 по местному часовому поясу клиники:

Серверный фоновый демон вычисляет местное время клиники (например, Asia/Yerevan для Армении, Europe/Moscow для РФ). Ровно в 18:00 по местному часовому поясу клиники все неутвержденные планы на завтра автоматически фиксируются (is_confirmed = true), генерируются PDF-файлы расписаний отделений и сводный Master Schedule PDF для анестезиологии и руководства с автоматической отправкой по Email.

3. Электронный Чек-лист хирургической безопасности ВОЗ (WHO Checklist):

Интерактивное заполнение 3 фаз (Sign In до индукции, Time Out перед разрезом, Sign Out до ушивания) с электронной подписью бригады и печатью официального протокола ВОЗ в PDF на 3 языках (HY / RU / EN).

4. Safety: Veto, 18:00 Auto-Lock & WHO Checklist

SurgiPlan focuses on reducing clinical risks, preventing scheduling conflicts, and enforcing safety compliance.

1. Organizational & Medical Veto:

The Head of Surgery enforces Organizational Veto (missing consent/tests). The Head of Anesthesiology enforces Medical Veto (anesthesia contraindications). Cancelled slots are instantly freed and logged.

2. Autonomous 18:00 Auto-Lock in the Clinic's Local Timezone:

The background scheduler tracks each clinic's local timezone (e.g. Asia/Yerevan, Europe/Moscow). Exactly at 18:00 in the clinic's local timezone, unconfirmed plans for tomorrow are automatically locked (is_confirmed = true), generating department and Master Schedule PDFs dispatched via Resend API.

3. Digital WHO Surgical Safety Checklist:

Interactive 3-phase checklist (Sign In, Time Out, Sign Out) with electronic brigade signing and official 3-language PDF protocol export (HY / RU / EN).

4. Անվտանգություն: Վետո, 18:00 Ավտո-Բլոկավորում և ԱՀԿ Ստուգաթերթ

SurgiPlan-ն ուղղված է բժշկական ռիսկերի նվազեցմանը, խաչումների կանխարգելմանը և կանոնակարգերի պահպանմանը:

1. Կազմակերպչական և Բժշկական Վետո:

Պացիենտի անպատրաստության դեպքում Վիրաբուժության Վարիչը դնում է Կազմակերպչական Վետո, իսկ հակացուցումների դեպքում Անեսթեզիոլոգիայի Վարիչը դնում է Բժշկական Վետո:

2. 18:00 Տեղական Ժամանակով Ավտո-Արգելափակում:

Ֆոնային պլանավորիչը հաշվարկում է կլինիկայի տեղական ժամային գոտին (Asia/Yerevan Հայաստանի համար, Europe/Moscow ՌԴ-ի համար): Տեղական ժամանակով 18:00-ին բոլոր չհաստատված պլանները ավտոմատ արգելափակվում են (is_confirmed = true), ստեղծվում են PDF ֆայլեր և էլ. փոստով ուղարկվում բժիշկներին ու ղեկավարությանը:

3. ԱՀԿ Վիրահատական Անվտանգության Ստուգաթերթ:

3 փուլերի (Sign In, Time Out, Sign Out) ինտերակտիվ լրացում՝ էլեկտրոնային ստորագրությամբ և 3 լեզվով PDF արտահանմամբ (HY / RU / EN):

5. ИИ-Аналитика, Персональный ИИ-Коуч и Отчеты Word

Раздел аналитики позволяет оптимизировать загрузку залов, выявлять задержки и совершенствовать технику хирургов.

💡 Персональный ИИ-Коуч хирурга:

  • Индивидуальный разбор: анализ скорости, динамики по лапароскопическим и открытым операциям за любой период.
  • Хронометраж вызова (Call-to-Incision): сопоставление времени выхода в зал со средними нормативами отделения.
  • Word-портфолио хирурга (.doc): скачивание официального персонального портфолио в 1 клик.

Управленческие Word-отчеты и графики:

  • Operating Room Utilization: полезная загрузка залов и хронометраж оборота.
  • Естественно-языковые ИИ-запросы: комплексные ответы ИИ для Зав. хирургией, Зав. анестезиологией и Главного врача.

5. AI Analytics, Personal AI Coach & Word Reports

The analytics dashboard provides real-time operational oversight, delay detection, and surgeon performance coaching.

💡 Personal AI Surgical Coach:

  • Personalized Breakdown: speed progression across laparoscopic and open surgeries.
  • Call-to-Incision Chronometry: arrival speed measured against department benchmarks.
  • Downloadable Word Portfolio (.doc): one-click download of personal surgical performance report.

Executive Word Reports & Operational Analytics:

  • OR Utilization Rate: room efficiency and turnover interval optimization.
  • Natural Language AI Inquiries: customized strategic analysis for Head of Surgery, Head of Anesthesia, and Directors.

5. AI Վերլուծություն, Անհատական AI Քոուչ և Word Զեկույցներ

Վերլուծության բաժինը թույլ է տալիս օպտիմալացնել դահլիճների ծանրաբեռնվածությունը և բարելավել վիրաբույժների աշխատանքը:

💡 Վիրաբույժի Անհատական AI Քոուչ:

  • Անհատական վերլուծություն: արագության և տևողության դինամիկան ըստ վիրահատության տեսակների:
  • Կանչից մինչև կտրվածք թայմինգ (Call-to-Incision): համեմատություն բաժանմունքի միջին նորմատիվների հետ:
  • Անձնական Word Պորտֆոլիո (.doc): պաշտոնական անհատական պորտֆոլիոյի ներբեռնում 1 սեղմումով:

Կառավարչական Word հաշվետվություններ:

  • Վիրասրահների ծանրաբեռնվածություն (OR Utilization): օգտակար ժամանակի և սանմաքրման օպտիմալացում:
  • AI Հարցումներ բնական լեզվով: ռազմավարական վերլուծություն վարիչների և ղեկավարության համար:
Тариф Цена / мес Макс. залов Макс. хирургов
Plan Price / mo Max Rooms Max Surgeons
Սակագին Գին / ամիս Առավել. դահլիճներ Առավել. վիրաբույժներ
Free (Пробный) $0 1 зал 3 хирурга
Starter (Базовый) $149 / мес ($119 при оплате за год) 3 зала 15 хирургов
Pro (Профессиональный) $349 / мес ($279 при оплате за год) 8 залов 50 хирургов
Enterprise / Premium $790 / мес ($630 при оплате за год) Безлимитно (до 99) Безлимитно (до 999)
Free (Trial) $0 1 room 3 surgeons
Starter (Basic) $149 / mo ($119 annual) 3 rooms 15 surgeons
Pro (Professional) $349 / mo ($279 annual) 8 rooms 50 surgeons
Enterprise / Premium $790 / mo ($630 annual) Unlimited (up to 99) Unlimited (up to 999)
Free (Փորձնական) $0 1 դահլիճ 3 վիրաբույժ
Starter (Բազային) $149 / ամիս ($119 տարեկան) 3 դահլիճ 15 վիրաբույժ
Pro (Պրոֆեսիոնալ) $349 / ամիս ($279 տարեկան) 8 դահլիճ 50 վիրաբույժ
Enterprise / Premium $790 / ամիս ($630 տարեկան) Անսահմանափակ (մինչև 99) Անսահմանափակ (մինչև 999)

6. Пошаговые алгоритмы и FAQ (Часто задаваемые вопросы)

📌 1. Пошаговые алгоритмы действий:

  • Как добавить операцию: Нажмите «+ Добавить операцию», введите ФИО пациента, диагноз, выберите оперзал, время и хирурга. Нажмите «Сохранить». Система автоматически рассчитает +20 мин на наркоз и +15 мин на пробуждение.
  • Как делегировать права И.О. Заведующего: Зайдите в раздел «Персонал», нажмите «👥 Делегировать права (И.О.)», выберите врача и период отпуска.
  • Как сменить временный пароль Test1234!: Экран смены откроется при первом входе автоматически. Пароль должен быть от 8 символов с буквами разного регистра, цифрой и спецсимволом.
  • Как Суперадминистратору написать клинике: В разделе «💬 Чат» используйте панель ввода внизу экрана. Выберите клинику или вариант «📢 Все клиники сети».

❓ 2. Вопросы и ответы (Troubleshooting):

Вопрос: Почему я вижу «🔒 Забронировано (Другое отделение)» вместо имени пациента?

Ответ: Это защита врачебной тайны. Хирурги видят ПДн пациентов только своего отделения.

Вопрос: Что делать при ошибке «Достигнут лимит анестезиологических бригад»?

Ответ: Сдвиньте время операции или обратитесь к Зав. анестезиологией для увеличения лимита бригад.

6. Step-by-Step UI Guides & FAQ

📌 1. Step-by-Step UI Guides:

  • How to Schedule a Surgery: Click "+ Add Surgery", enter patient FIO, diagnosis, select OR room, start time, and surgeon. Click "Save". +20 min prep and +15 min recovery buffers are calculated automatically.
  • How to Delegate Acting Head Rights: Go to "Staff", click "👥 Delegate Rights", select a doctor and vacation dates.
  • How to Change Temporary Password Test1234!: The modal opens automatically on first login. Requires 8+ chars, upper/lower case, digit, and symbol.
  • How Superadmin Messages Clinics: In "💬 Chat", use the bottom input bar to send direct or broadcast messages to all network clinics.

❓ 2. Troubleshooting & FAQ:

Q: Why do I see "🔒 Booked (Other Dept)" instead of patient name?

A: This is privacy protection. Surgeons view patient PHI only within their own department.

6. Քայլ առ քայլ ուղեցույցներ և FAQ

📌 1. Քայլ առ քայլ ուղեցույցներ:

  • Ինչպես ավելացնել վիրահատություն: Սեղմեք «+ Ավելացնել», լրացրեք տվյալները և սեղմեք «Պահպանել»: +20 ր նարկոզի և +15 ր արթնացման բուֆերները հաշվարկվում են ավտոմատ:
  • Ինչպես փոխարինել Ժ.Պ. իրավունքները: «Անձնակազմ» բաժնում սեղմեք «👥 Փոխանցել լիազորությունները», ընտրեք բժշկին և ամսաթվերը:
  • Ինչպես փոխել Test1234! գաղտնաբառը: Փոփոխման պատուհանը կբացվի առաջին մուտքի ժամանակ ավտոմատ: