chernegasergiy/clinical-management-platform

A Clinic Management Platform

dev-main 2026-01-08 12:27 UTC

Requires

• chernegasergiy/nk-025-2021-parser: ^0.1.0
• chernegasergiy/nk-026-2021-parser: ^0.1.0
• chillerlan/php-qrcode: ^5.0
• dompdf/dompdf: ^3.1
• league/oauth2-client: ^2.8
• league/oauth2-facebook: ^2.2
• league/oauth2-github: ^3.1
• league/oauth2-google: ^4.0
• maennchen/zipstream-php: ^3.1
• phpoffice/phpspreadsheet: ^5.2
• robmorgan/phinx: ^0.16.10
• spomky-labs/otphp: ^11.3
• symfony/yaml: ^7.3
• twig/twig: ^3.22
• vlucas/phpdotenv: ^5.6

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^10.5
• squizlabs/php_codesniffer: ^4.0

MIT

• Serhii Cherneha
• Andrii Hevko
• Maksym Reminskyi

README

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

Огляд

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

Технологічний стек

• Бекенд: PHP 8.2+
• Шаблонізатор: Twig
• Фронтенд: Semantic UI, Vanilla JS
• База даних: MySQL/MariaDB, з підтримкою SQLite для розробки
• Веб-сервер: Nginx + PHP-FPM

Швидкий старт

Детальні інструкції з розгортання будуть додані в docs/deployment.md.

1. Клонуйте репозиторій:

   git clone https://github.com/your-username/clinic-management-platform.git
   cd clinic-management-platform/www

2. Встановіть залежності:

   composer install

3. Налаштуйте середовище:

   • Скопіюйте .env.example у .env.
   • Вкажіть параметри підключення до вашої бази даних.

4. Запустіть міграції та наповнення даними:

   composer db:migrate
   composer db:seed

5. Налаштуйте веб-сервер, щоб він вказував на директорію public/ як на кореневу.

6. Запустіть локальний сервер (для розробки):

   php -S localhost:8000 -t public

Як запустити перевірки якості коду

Для забезпечення якості коду проєкт використовує такі інструменти:

• PHPStan — статичний аналіз для виявлення помилок у PHP-коді
• PHPCS — перевірка стилю коду за стандартом PSR-12
• PHPUnit — запуск Unit та Integration тестів

Встановлення залежностей

composer install

Запуск перевірок

Всі команди виконуються з директорії www/:

# Статичний аналіз PHPStan
composer stan

# Перевірка стилю коду PHPCS
composer cs-check

# Автоматичне виправлення стилів PHPCS
composer cs

# Запуск PHPUnit тестів
composer test

Запуск окремих інструментів

# PHPStan
vendor/bin/phpstan analyse

# PHPCS
vendor/bin/phpcs --standard=PSR12 --ignore=vendor/ public/ src/

# PHPCBF (автоматичне виправлення)
vendor/bin/phpcbf --standard=PSR12 --ignore=vendor/ public/ src/

# PHPUnit
vendor/bin/phpunit

Перевірка в CI

GitHub Actions автоматично запускає всі перевірки при кожному push до гілок main, epic/**, feature/**, fix/** та при Pull Requests до main. Статус перевірок відображається у бейджах на початку цього файлу.