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

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

Official User Guide

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

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

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

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

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

Основные роли в системе:

AdminАдминистратор клиники. Настраивает операционные залы, регистрирует новых сотрудников, управляет подпиской и лимитами тарифа. Не имеет доступа к редактированию медицинских записей.

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

AnesthesiologistВрач-анестезиолог. Вносит медицинские показания и готовит пациента к наркозу.

Dept HeadЗаведующие отделениями (хирургия/анестезия). Обладают правами наложения медицинского вето на операции и подтверждения суточного оперплана заведующим хирургическим отделением.

2. Role-Based Access Control and Permissions

The platform uses a role-based access control (RBAC) matrix. This ensures that each physician or administrator only sees the functions intended for them.

Main Roles in the System:

AdminClinic Administrator. Configures operating rooms, registers new employees, manages subscription and plan limits. Does not have access to edit medical records.

SurgeonAttending Surgeon. Can schedule surgeries on the grid, specify assistants, fill out safety checklists, and modify records they personally created.

AnesthesiologistAnesthesiologist. Inputs medical observations and prepares patients for anesthesia.

Dept HeadDepartments Heads (Surgery/Anesthesia). Have exclusive rights to enforce a medical veto on procedures and confirm the daily surgical list.

2. Մուտքի դերային մոդել և իրավունքներ

Հարթակն օգտագործում է դերերի վրա հիմնված մուտքի վերահսկման մատրիցա: Սա երաշխավորում է, որ յուրաքանչյուր բժիշկ կամ ադմինիստրատոր տեսնում է միայն իրեն նախատեսված գործառույթները:

Համակարգի հիմնական դերերը:

AdminԿլինիկայի ադմինիստրատոր: Կարգավորում է վիրահատարանները, գրանցում նոր աշխատակիցներին, կառավարում բաժանորդագրությունները և սակագների սահմանաչափերը: Բժշկական գրառումները խմբագրելու հնարավորություն չունի:

SurgeonՎիրահատող վիրաբույժ: Կարող է վիրահատություններ ավելացնել ժամանակացույցի ցանցում, նշել օգնականներին, լրացնել անվտանգության ստուգաթերթերը և փոփոխել իր կողմից ստեղծված գրառումները:

AnesthesiologistԱնեսթեզիոլոգ: Իրավունք ունի անվերապահ բժշկական վետո դնել ցանկացած վիրահատության վրա՝ հիմնվելով հիվանդի առողջական ցուցումների վրա:

Dept HeadԲաժանմունքի վարիչներ (վիրաբուժություն/անզգայացում): Ունեն օրական վիրահատությունների ցուցակը հաստատելու իրավասություն, որից հետո ժամանակացույցը արգելափակվում է շարքային բժիշկների կողմից խմբագրվելուց:

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. Безопасность: Вето и Блокировка листов

SurgiPlan ориентирован на снижение медицинских рисков и предотвращение врачебных ошибок.

1. Наложение медицинского вето:

Если состояние здоровья пациента препятствует проведению операции (плохие анализы, риски анестезии), анестезиолог нажимает кнопку «Veto Cancellation», указывает причину, и операция мгновенно отменяется. При этом на бэкенде:

  • Операция переводится в статус cancelled.
  • Регистрируется причина отмены.
  • Всем сотрудникам клиники автоматически уходит email-уведомление через службу Resend.

2. Утверждение и Блокировка (Lock-in):

В конце дня заведующий отделением нажимает кнопку «Confirm Tomorrow's List». Вся сетка операций на выбранный день блокируется. Любое изменение или удаление операций на этот день запрещается на уровне API (ограничение прав). Подтвержденное расписание автоматически рассылается всем врачам на email.

4. Safety: Veto and Daily List Lock-in

SurgiPlan is focused on reducing medical risks and preventing clinical errors.

1. Enforcing Medical Veto:

If the patient's health condition prevents the surgery (e.g. poor tests, high anesthesia risks), the anesthesiologist clicks the "Veto Cancellation" button, enters the reason, and the surgery is instantly cancelled. On the backend:

  • The operation status changes to cancelled.
  • The cancellation reason is stored.
  • An automatic email notification is sent to all clinic staff via Resend.

2. Confirmation and Lock-in:

At the end of the day, the department head clicks the "Confirm Tomorrow's List" button. The entire surgery schedule for the selected day becomes locked. Any modification or deletion of surgeries for that day is forbidden at the API level (RBAC restriction). The confirmed list is automatically emailed to all doctors.

4. Անվտանգություն: Վետո և ցուցակների արգելափակում

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

1. Բժշկական վետոյի կիրառում:

Եթե հիվանդի առողջական վիճակը խոչընդոտում է վիրահատությանը (վատ անալիզներ, անզգայացման ռիսկեր), անեսթեզիոլոգը սեղմում է «Veto Cancellation» կոճակը, նշում պատճառը, և վիրահատությունն անմիջապես չեղարկվում է: Ընդ որում բեքենդում:

  • Վիրահատության կարգավիճակը փոխվում է cancelled-ի:
  • Գրանցվում է չեղարկման պատճառը:
  • Կլինիկայի բոլոր աշխատակիցներին ավտոմատ կերպով ուղարկվում է էլեկտրոնային նամակ Resend ծառայության միջոցով:

2. Հաստատում և արգելափակում (Lock-in):

Օրվա վերջում բաժանմունքի վարիչը սեղմում է «Confirm Tomorrow's List» կոճակը: Ընտրված օրվա բոլոր վիրահատությունները արգելափակվում են: Ցանկացած փոփոխություն կամ ջնջում տվյալ օրվա համար արգելվում է API մակարդակով (իրավունքների սահմանափակում): Հաստատված օրակարգը ավտոմատ կերպով ուղարկվում է բոլոր բժիշկներին էլ. փոստով:

5. Аналитика и Тарифные лимиты

Раздел аналитики позволяет оптимизировать загрузку залов и сбалансировать нагрузку на персонал.

Аналитические графики:

  • Daily Surgical Volume: Динамика объема операций по дням.
  • Operating Room Utilization: Утилизация залов (какой зал наиболее востребован).
  • Diagnosis Distribution: Структура хирургических нозологий.
  • Surgeons Workload: Сравнение количества операций у хирургов клиники.
  • Staff / Assistant Load: Занятость ассистентов.

5. Analytics and Plan Limits

The analytics section helps optimize operating room utilization and balance staff workload.

Analytical Charts:

  • Daily Surgical Volume: Surgery volume dynamics by day.
  • Operating Room Utilization: Room utilization (which room is most in demand).
  • Diagnosis Distribution: Distribution of surgical diagnoses.
  • Surgeons Workload: Comparison of surgery counts among clinic surgeons.
  • Staff / Assistant Load: Assistant workload status.

5. Վերլուծություն և սակագնային սահմանաչափեր

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

Վերլուծական գծապատկերներ:

  • Daily Surgical Volume: Վիրահատությունների ծավալի դինամիկան ըստ օրերի:
  • Operating Room Utilization: Դահլիճների օգտագործումը (որ դահլիճն է առավել պահանջված):
  • Diagnosis Distribution: Վիրահատական ախտորոշումների կառուցվածքը:
  • Surgeons Workload: Կլինիկայի վիրաբույժների վիրահատությունների քանակի համեմատությունը:
  • Staff / Assistant Load: Օգնականների զբաղվածությունը:
Тариф Цена / мес Макс. залов Макс. хирургов
Plan Price / mo Max Rooms Max Surgeons
Սակագին Գին / ամիս Առավել. դահլիճներ Առավել. վիրաբույժներ
Free $0 1 зал 3 хирурга
Basic $49 3 зала 10 хирургов
Pro $149 10 залов 50 хирургов
Premium $299 99 залов 999 хирургов
Free $0 1 room 3 surgeons
Basic $49 3 rooms 10 surgeons
Pro $149 10 rooms 50 surgeons
Premium $299 99 rooms 999 surgeons
Free $0 1 դահլիճ 3 վիրաբույժ
Basic $49 3 դահլիճ 10 վիրաբույժ
Pro $149 10 դահլիճ 50 վիրաբույժ
Premium $299 99 դահլիճ 999 վիրաբույժ