Атестаційні завдання K2 ERP/Стоматологія

Атестаційне завдання K2 ERP — Стоматологія — це практична задача для перевірки навичок розробника або впроваджувача K2 ERP у створенні модуля обліку пацієнтів, стоматологів, зубної карти, прийомів, процедур, планів лікування, фінансів, оплат, графіків роботи, документів і звітності для стоматологічної клініки.

Модуль має забезпечувати повний цикл роботи стоматології: пацієнт → запис на прийом → лікар → зубна карта → процедура → план лікування → рахунок → оплата → документ → повторний візит → звіт.

Коротко. Потрібно реалізувати модуль стоматологічної клініки: пацієнти, лікарі, спеціалізації, послуги, зубна карта, прийоми, процедури, плани лікування, матеріали, фінанси, оплати, графіки, кабінети лікаря і пацієнта, нагадування, PDF-документи, звіти й AJAX-інтерактив.

Назва завдання

Модуль обліку пацієнтів, прийомів, процедур, фінансів і графіків роботи для стоматологічної клініки.

Мета завдання

Мета завдання — створити в K2 ERP модуль для автоматизації стоматологічної клініки.

Система повинна дозволяти:

• вести базу пацієнтів;
• створювати електронні медичні картки;
• вести зубну карту пацієнта;
• вести лікарів-стоматологів;
• вести спеціалізації;
• вести послуги та процедури;
• планувати графіки прийомів;
• записувати пацієнтів на прийом;
• додавати кілька процедур у межах одного прийому;
• вказувати зуб або групу зубів для процедури;
• фіксувати стан зуба до і після лікування;
• створювати план лікування на кілька візитів;
• контролювати статуси етапів лікування;
• вести матеріали, якщо потрібно;
• формувати рахунки;
• фіксувати повну або часткову оплату;
• застосовувати знижки;
• формувати медичні висновки, плани лікування і рахунки у PDF;
• надсилати нагадування пацієнтам;
• формувати звіти по прийомах, лікарях, фінансах і процедурах.

Головний принцип. Лікар повинен бачити історію лікування пацієнта по візитах і зубах, адміністратор — розклад і оплати, а керівник — фінансову та операційну картину клініки.

Реальний бізнес-контекст

Стоматологічна клініка приймає пацієнтів на консультації, лікування, профілактику, ортодонтію, хірургію, імплантацію та протезування.

Типові напрями роботи стоматології:

• первинна консультація;
• лікування карієсу;
• пломбування;
• професійна чистка;
• відбілювання;
• видалення зубів;
• імплантація;
• протезування;
• ортодонтія;
• встановлення брекетів;
• лікування каналів;
• рентген або інша діагностика;
• профілактичні огляди.

Клініці потрібно:

• швидко реєструвати пацієнтів;
• планувати графік лікарів;
• вести історію лікування;
• бачити стан кожного зуба;
• формувати план лікування;
• контролювати оплати;
• формувати документи;
• нагадувати пацієнтам про прийоми;
• аналізувати завантаженість лікарів і дохідність процедур.

Основний бізнес-процес

Типовий процес роботи стоматологічної клініки виглядає так:

1. адміністратор створює або знаходить пацієнта;
2. обирає лікаря і послугу;
3. записує пацієнта на вільний час;
4. система перевіряє графік лікаря;
5. пацієнт приходить на прийом;
6. лікар відкриває електронну картку пацієнта;
7. лікар переглядає зубну карту;
8. фіксує стан зуба або групи зубів;
9. додає процедури;
10. створює або оновлює план лікування;
11. завершує прийом;
12. система формує рахунок;
13. пацієнт оплачує повністю або частково;
14. формується PDF-рахунок, план лікування або висновок;
15. система надсилає нагадування про наступний візит;
16. керівник формує звіти.

Основні об’єкти модуля

Об’єкт	Призначення
Пацієнти	База клієнтів стоматології
Медичні картки	Загальна медична історія пацієнта
Зубна карта	Стан зубів і історія лікування по зубах
Лікарі-стоматологи	Спеціалісти клініки
Спеціалізації	Терапія, хірургія, ортодонтія, протезування
Послуги клініки	Процедури і маніпуляції з цінами
Прийоми	Записи пацієнтів до лікарів
Процедури прийому	Конкретні виконані або заплановані роботи
Плани лікування	Комплексний план робіт на кілька візитів
Матеріали	Пломбувальні матеріали, імпланти, коронки, інше
Рахунки	Нарахування за процедури
Оплати	Фактичні платежі пацієнтів
Документи	Висновки, плани лікування, рахунки, акти
Нагадування	Повідомлення про майбутні прийоми
Звіти	Аналітика по лікарях, процедурах, фінансах і пацієнтах

Довідник «Лікарі-стоматологи»

Лікарі проводять прийоми, створюють медичні записи, виконують процедури та формують плани лікування.

Спеціалізації лікарів

• терапевтична стоматологія;
• хірургічна стоматологія;
• ортодонтія;
• ортопедія;
• імплантологія;
• пародонтологія;
• дитяча стоматологія;
• гігієна;
• рентген-діагностика.

Поля лікаря

Поле	Опис
ПІБ	Повне ім’я лікаря
Спеціалізація	Основний напрям роботи
Телефон	Контактний номер
Email	Електронна адреса
Кабінет	Номер кабінету або робоче місце
Графік роботи	Дні та години прийому
Тривалість стандартного прийому	Наприклад: 30, 45 або 60 хвилин
Сертифікати	Опціонально
Статус	Активний, у відпустці, лікарняний, архівний

Довідник «Послуги клініки»

Послуги клініки — це стоматологічні процедури, які можуть бути додані до прийому або плану лікування.

Приклади послуг

• первинна консультація;
• повторна консультація;
• пломбування зуба;
• лікування карієсу;
• лікування каналів;
• професійна чистка;
• відбілювання;
• видалення зуба;
• імплантація;
• встановлення коронки;
• встановлення брекетів;
• корекція брекетів;
• рентген;
• анестезія;
• тимчасова пломба.

Поля послуги

Поле	Опис
Назва процедури	Назва послуги для прайсу
Категорія послуг	Терапія, хірургія, ортодонтія, протезування тощо
Ціна	Стандартна вартість
Тривалість	Орієнтовний час виконання
Опис	Короткий опис процедури
Потрібен номер зуба	Так або ні
Може входити в план лікування	Так або ні
Статус	Активна або архівна

Довідник «Типи зубів»

Довідник типів зубів використовується для зубної карти.

Поля типу зуба

Поле	Опис
Номер зуба	Номер за стоматологічною схемою
Назва	Центральний різець, премоляр, моляр тощо
Щелепа	Верхня або нижня
Сторона	Ліва або права
Тип	Різець, ікло, премоляр, моляр

База «Пацієнти»

Пацієнти — центральний об’єкт стоматологічної клініки.

Поля пацієнта

Поле	Опис
ПІБ	Повне ім’я пацієнта
Дата народження	Для віку та ідентифікації
Телефон	Основний контакт
Email	Для повідомлень і кабінету
Адреса	Опціонально
Номер медичної картки	Унікальний номер
Алергії	Важлива примітка для лікування
Особливості лікування	Наприклад: страх перед лікуванням, протипоказання
Коментар	Службова примітка
Статус	Активний, архівний, закритий

Електронна картка пацієнта

Картка пацієнта має показувати всю історію взаємодії з клінікою.

У картці пацієнта потрібно бачити

• загальні дані;
• алергії та медичні примітки;
• історію прийомів;
• історію процедур;
• зубну карту;
• плани лікування;
• рахунки;
• оплати;
• борги;
• документи;
• нагадування;
• прикріплені файли.

Зубна карта

Зубна карта — ключова частина стоматологічного модуля.

Що має показувати зубна карта

• номер зуба;
• стан зуба;
• історію процедур по зубу;
• заплановані процедури;
• виконані процедури;
• примітки лікаря;
• дату останнього оновлення;
• лікаря, який вніс зміну.

Стани зуба

Стан	Опис
Здоровий	Проблем не зафіксовано
Карієс	Потребує лікування
Пломба	Зуб уже лікувався
Коронка	Встановлена коронка
Імплант	Встановлений імплант
Видалений	Зуб відсутній
Канали проліковані	Проведене ендодонтичне лікування
Потребує лікування	Потрібна процедура
Під спостереженням	Потрібен контроль

База «Прийоми і процедури»

Прийом — це запис пацієнта до стоматолога на конкретний час.

Колонки журналу прийомів

Колонка	Опис
Пацієнт	Хто записаний
Лікар	Хто приймає
Дата і час	Коли відбувається прийом
Послуга	Основна послуга
Кабінет	Де відбувається прийом
Статус прийому	Заплановано, виконано, скасовано
Статус оплати	Очікує оплату, частково оплачено, оплачено

Поля прийому

Поле	Опис
Пацієнт	Кому надається послуга
Лікар	Хто проводить прийом
Дата	Дата прийому
Час початку	Початок прийому
Час завершення	Кінець прийому
Кабінет	Місце прийому
Коментар адміністратора	Службова примітка
Коментар лікаря	Медична або робоча примітка
Статус	Поточний стан прийому

Статуси прийому

Статус	Значення
Заплановано	Пацієнта записано
Підтверджено	Пацієнт підтвердив візит
Очікує	Пацієнт прийшов і очікує
На прийомі	Прийом триває
Виконано	Прийом завершено
Скасовано	Прийом скасовано
Не прийшов	Пацієнт не з’явився

Процедури в межах прийому

Один прийом може містити кілька процедур.

Поля процедури прийому

Поле	Опис
Прийом	До якого прийому належить процедура
Послуга	Яка процедура виконана
Зуб	Номер зуба, якщо застосовується
Стан до процедури	Що було до лікування
Стан після процедури	Що стало після лікування
Кількість	Кількість процедур або одиниць
Ціна	Ціна процедури
Знижка	Якщо застосовується
Сума	Підсумкова вартість
Примітка лікаря	Опис лікування

План лікування

План лікування дозволяє планувати роботи на кілька візитів.

Поля плану лікування

Поле	Опис
Пацієнт	Для кого створено план
Лікар	Хто створив план
Дата створення	Коли створено
Назва плану	Наприклад: Лікування верхньої щелепи
Загальна сума	Орієнтовна вартість
Статус	Чернетка, погоджено, в роботі, завершено, скасовано
Коментар	Загальна примітка

Етапи плану лікування

Поле	Опис
План лікування	До якого плану належить етап
Номер етапу	Порядок виконання
Послуга	Запланована процедура
Зуб	Номер зуба або зона
Орієнтовна дата	Планова дата
Орієнтовна ціна	Вартість етапу
Статус	Заплановано, виконано, перенесено, скасовано

Матеріали, опціонально

Стоматологія може вести облік матеріалів.

Приклади матеріалів

• пломбувальний матеріал;
• анестезія;
• імплант;
• коронка;
• брекет-система;
• цемент;
• рукавички;
• одноразові матеріали.

Поля матеріалу

Поле	Опис
Назва матеріалу	Назва для обліку
Категорія	Пломбувальні, імпланти, витратні тощо
Одиниця виміру	шт., мл, г, набір
Ціна закупівлі	Собівартість
Залишок	Кількість на складі
Мінімальний залишок	Для попередження

Списання матеріалів

Матеріали можуть списуватися під час виконання процедури.

Поля списання

Поле	Опис
Прийом	До якого прийому списання
Процедура	До якої процедури
Матеріал	Що списано
Кількість	Скільки використано
Лікар	Хто використав
Дата	Коли списано

Фінанси і оплати

Модуль має підтримувати облік оплат за візити, процедури і плани лікування.

Варіанти оплати

• повна оплата;
• часткова оплата;
• передоплата;
• оплата за етап лікування;
• оплата за весь план лікування;
• знижка для постійного пацієнта;
• корпоративна або страхова оплата, опціонально.

Поля рахунку

Поле	Опис
Номер рахунку	Унікальний номер
Пацієнт	Кому виставлено рахунок
Прийом	До якого прийому прив’язано
План лікування	Якщо рахунок за планом
Послуги	Перелік процедур
Сума	Загальна сума
Знижка	Сума або відсоток знижки
До оплати	Підсумкова сума
Оплачено	Скільки сплачено
Борг	Залишок
Статус	Очікує оплату, частково оплачено, оплачено, скасовано

Способи оплати

• готівка;
• банківська картка;
• банківський переказ;
• онлайн-оплата;
• страхова компанія, опціонально.

Графіки роботи

Система повинна підтримувати графіки лікарів.

У графіку потрібно бачити

• лікаря;
• робочі дні;
• години роботи;
• кабінет;
• вільні слоти;
• зайняті слоти;
• перерви;
• відпустки;
• лікарняні;
• перенесення прийомів.

Нагадування

Система має нагадувати пацієнтам і персоналу про важливі події.

Події для нагадувань

• прийом завтра;
• прийом сьогодні;
• прийом скасовано;
• прийом перенесено;
• потрібно підтвердити візит;
• наступний етап лікування;
• профілактичний огляд через 6 місяців;
• неоплачений рахунок;
• борг за планом лікування.

Особистий кабінет лікаря

Лікар у кабінеті має бачити:

• свої прийоми на сьогодні;
• прийоми за період;
• картки своїх пацієнтів;
• зубну карту пацієнта;
• історію процедур;
• плани лікування;
• форму додавання процедури;
• медичні примітки;
• можливість сформувати план лікування.

Особистий кабінет пацієнта

Пацієнт у кабінеті може бачити:

• майбутні прийоми;
• історію візитів;
• план лікування;
• рахунки;
• оплати;
• документи;
• рекомендації лікаря;
• нагадування;
• можливість підтвердити або скасувати прийом, якщо дозволено.

Документи

Система має формувати PDF-документи.

Приклади документів

• план лікування;
• рахунок за візит;
• акт наданих послуг;
• медичний висновок;
• рекомендації після процедури;
• згода на лікування, опціонально;
• фінансовий звіт.

Звіт «Прийоми за період»

У звіті потрібно відображати:

• дату;
• пацієнта;
• лікаря;
• статус прийому;
• суму;
• статус оплати.

Звіт «Процедури за період»

У звіті потрібно відображати:

• процедуру;
• кількість виконань;
• суму доходу;
• лікаря;
• категорію послуги.

Звіт «Завантаженість лікарів»

У звіті потрібно відображати:

• лікаря;
• кількість прийомів;
• кількість годин;
• кількість скасувань;
• кількість неявок;
• дохід по лікарю.

Звіт «Фінансові надходження»

У звіті потрібно відображати:

• дату;
• пацієнта;
• рахунок;
• суму;
• оплачено;
• борг;
• спосіб оплати.

Звіт «Борги пацієнтів»

У звіті потрібно відображати:

• пацієнта;
• рахунок;
• суму;
• оплачено;
• борг;
• дату останньої оплати.

Звіт «Плани лікування»

У звіті потрібно відображати:

• пацієнта;
• лікаря;
• загальну суму плану;
• виконані етапи;
• невиконані етапи;
• статус плану.

Звіт «Матеріали»

Якщо реалізовано склад матеріалів, у звіті потрібно відображати:

• матеріал;
• залишок;
• списано за період;
• мінімальний залишок;
• потребу в закупівлі.

AJAX-інтерактив

Інтерфейс має працювати швидко й без перезавантаження сторінок.

Через AJAX мають працювати:

• пошук пацієнтів;
• створення пацієнта;
• пошук лікарів;
• пошук процедур;
• запис на прийом;
• перевірка вільного часу;
• зміна статусу прийому;
• додавання процедури;
• оновлення зубної карти;
• створення плану лікування;
• додавання етапу лікування;
• формування рахунку;
• фіксація оплати;
• фільтрація звітів;
• оновлення календаря.

Логування змін

Модуль повинен фіксувати важливі дії.

Журнал змін має зберігати:

• хто створив пацієнта;
• хто відкрив картку пацієнта;
• хто змінив дані пацієнта;
• хто створив прийом;
• хто скасував прийом;
• хто змінив статус прийому;
• хто додав процедуру;
• хто змінив зубну карту;
• хто створив план лікування;
• хто змінив етап плану лікування;
• хто сформував рахунок;
• хто зафіксував оплату;
• хто застосував знижку;
• хто сформував PDF-документ;
• дату й час дії;
• старе та нове значення, якщо це можливо.

Права доступу

Модуль має підтримувати рольову модель.

Роль	Можливості
Адміністратор рецепції	Створює пацієнтів, записує на прийом, працює з графіком і базовими даними
Лікар-стоматолог	Бачить свої прийоми, картки пацієнтів, зубну карту, процедури і плани лікування
Старший лікар	Має розширений доступ до медичних карток, планів лікування і звітів
Касир / бухгалтер	Створює рахунки, фіксує оплати, бачить фінанси без зайвих медичних деталей
Пацієнт	Бачить свої прийоми, рахунки, документи і плани лікування, якщо кабінет реалізовано
Адміністратор системи	Налаштовує довідники, права, шаблони документів і службові параметри

Захист персональних і медичних даних

Система має обмежувати доступ до медичної інформації.

Вимоги до безпеки

• рольовий доступ;
• обмеження перегляду карток пацієнтів;
• логування відкриття картки;
• логування змін зубної карти;
• заборона доступу до чужих пацієнтів без прав;
• окремі права для рецепції, лікаря, касира і керівника;
• контроль експорту медичних даних;
• захист прикріплених файлів.

Технічні вимоги

Параметр	Опис
Бекенд	K2 Cloud ERP на Python або PHP
База даних	PostgreSQL або MySQL
Фронтенд	HTML5, JavaScript
AJAX	Fetch API або Axios
UI-компоненти	DataTables для таблиць пацієнтів, прийомів і фінансів; Select2 для пошуку пацієнтів, лікарів і процедур
Календар	FullCalendar для розкладу прийомів
Зубна карта	Таблична або графічна схема зубів, опціонально
Файли	Завантаження знімків, документів, планів лікування
Друк	PDF-висновки, плани лікування, рахунки, акти
Експорт	Excel або PDF для звітів
Безпека	Рольовий доступ, журнал дій, обмеження доступу до медичних даних

Рекомендовані сутності бази даних

Для реалізації задачі доцільно передбачити такі сутності:

• пацієнти;
• медичні картки;
• лікарі;
• спеціалізації;
• послуги клініки;
• типи зубів;
• зубна карта;
• прийоми;
• процедури прийому;
• плани лікування;
• етапи лікування;
• матеріали;
• списання матеріалів;
• рахунки;
• позиції рахунків;
• оплати;
• документи;
• нагадування;
• графіки лікарів;
• журнал змін;
• права доступу;
• звіти.

Практичне завдання

У межах атестації потрібно продемонструвати робочий сценарій.

Мінімальний сценарій:

1. створити лікаря-стоматолога;
2. створити послуги клініки;
3. створити типи зубів;
4. створити пацієнта;
5. створити електронну картку пацієнта;
6. відкрити зубну карту пацієнта;
7. налаштувати графік лікаря;
8. записати пацієнта на прийом;
9. перевірити відображення прийому в календарі;
10. змінити статус прийому на «На прийомі»;
11. додати процедуру до прийому;
12. вказати номер зуба;
13. змінити стан зуба після процедури;
14. створити план лікування;
15. додати кілька етапів лікування;
16. завершити прийом;
17. сформувати рахунок;
18. застосувати знижку, якщо реалізовано;
19. зафіксувати часткову оплату;
20. перевірити борг;
21. зафіксувати повну оплату;
22. сформувати PDF-план лікування;
23. сформувати звіт прийомів;
24. сформувати фінансовий звіт;
25. перевірити журнал змін і права доступу.

Критерії оцінювання

Критерій	Бали	Що перевіряється
Реалізація бази пацієнтів, лікарів і процедур	20	Пацієнти, картки, лікарі, спеціалізації, послуги, зубна карта
Управління прийомами і планами лікування	20	Календар, статуси прийомів, процедури, зуби, плани лікування, етапи
Фінансовий облік оплат	20	Рахунки, процедури в рахунку, знижки, часткові оплати, повні оплати, борги
Генерація документів і нагадування	20	PDF-плани лікування, рахунки, висновки, нагадування про прийоми
Інтерактивність через AJAX і зручність користування	20	AJAX-пошук, швидкий запис, оновлення зубної карти, календар, фільтри, кабінети
Разом	100	Максимальна оцінка

Шкала оцінювання

Бали	Рівень	Опис
90–100	Відмінно	Модуль повністю працює: пацієнти, лікарі, послуги, зубна карта, прийоми, плани лікування, фінанси, документи і звіти реалізовані коректно
75–89	Добре	Основна логіка працює, є незначні недоліки, які не руйнують процес роботи стоматології
60–74	Зараховано	Базовий сценарій працює, але частина функцій реалізована неповно або потребує доопрацювання
0–59	Не зараховано	Відсутня критична логіка: пацієнти, лікарі, прийоми, зубна карта, процедури, оплати або плани лікування

Критичні помилки

Критичними помилками вважаються ситуації, коли:

• неможливо створити пацієнта;
• неможливо створити лікаря;
• неможливо створити послугу;
• неможливо записати пацієнта на прийом;
• прийом не прив’язується до пацієнта;
• прийом не прив’язується до лікаря;
• система допускає накладку прийомів у одного лікаря без попередження;
• неможливо додати процедуру до прийому;
• процедура не прив’язується до зуба, якщо це обов’язково;
• зубна карта не оновлюється після лікування;
• неможливо створити план лікування;
• неможливо сформувати рахунок;
• часткова оплата не змінює борг;
• повна оплата не змінює статус рахунку;
• користувач без прав бачить медичну картку або зубну карту;
• звіти не відповідають фактичним прийомам, процедурам і оплатам;
• зміни прийомів, зубної карти, рахунків і оплат не логуються.

Умова складання. Завдання не може бути зараховане, якщо система не дозволяє пройти базовий цикл стоматології: пацієнт → лікар → запис → зубна карта → процедура → план лікування → рахунок → оплата → документ → звіт.

Очікуваний результат

У результаті виконання атестаційного завдання має бути створений модуль стоматологічної клініки в K2 ERP.

Модуль має підтримувати пацієнтів, медичні картки, лікарів, спеціалізації, послуги, типи зубів, зубну карту, прийоми, процедури, плани лікування, матеріали, рахунки, оплати, документи, нагадування, графіки лікарів, кабінет лікаря, кабінет пацієнта, звіти, AJAX-інтерактив, журнал змін і рольовий доступ до медичних даних.

Примітка

ERP для стоматології є важливим інструментом для підвищення якості обслуговування пацієнтів, оптимізації роботи лікарів, контролю фінансів і зменшення ручної паперової роботи.

Особливо важливими є зубна карта, історія процедур по кожному зубу, плани лікування на кілька візитів і прозорий облік оплат.

Коротко

Питання	Відповідь
Що потрібно створити?	Модуль стоматологічної клініки
Які довідники потрібні?	Пацієнти, лікарі, послуги, спеціалізації, типи зубів
Який головний процес?	Запис пацієнта, процедура, зубна карта, план лікування, рахунок і оплата
Що потрібно контролювати?	Графік лікарів, прийоми, зуби, процедури, плани лікування, оплати
Які документи потрібні?	План лікування, рахунок, висновок, акт, рекомендації
Які звіти потрібні?	Прийоми, процедури, лікарі, фінанси, борги, плани лікування
Що є критичною вимогою?	Зубна карта має оновлюватися після процедур і бути доступною тільки користувачам із правами
Що бажано додати?	Графічну схему зубів, склад матеріалів, кабінет пацієнта, SMS-нагадування

Див. також

• K2 ERP
• K2 ERP
• Атестаційні завдання K2 ERP
• Медичний заклад
• CRM
• Каса
• Рахунок на оплату
• Особистий кабінет
• Документообіг
• Розклад
• Права доступу
• AJAX