chernegasergiy/clinical-management-platform

A Clinic Management Platform

dev-main 2026-01-31 14:59 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/config: ^7.0
• symfony/console: ^7.4
• symfony/contracts: ^3.0
• symfony/event-dispatcher: ^7.4
• symfony/finder: ^7.0
• symfony/http-foundation: ^7.4
• symfony/intl: ^7.4
• symfony/process: ^7.4
• symfony/translation: ^7.0
• symfony/twig-bridge: ^7.0
• symfony/validator: ^7.4
• 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

A robust, three-tier healthcare information system designed to automate key workflows in modern medical centers. This platform is built with a modular architecture, prioritizing scalability, security, and compliance with national regulatory requirements.

Overview

The platform provides a comprehensive suite of tools for healthcare providers, covering the full patient service cycle from initial appointment booking to the maintenance of detailed electronic medical records (EMR). Built with a modular three-tier architecture, the system integrates resource management, staff scheduling, and automated reporting into a single workspace, ensuring scalability and compliance with national regulatory standards. Currently, the project is undergoing a strategic transition to a Symfony-based component architecture to further enhance its flexibility and long-term maintainability.

Technology Stack

• Backend: PHP 8.2+
• Templating Engine: Twig
• Frontend: Semantic UI, Vanilla JS
• Database: MySQL/MariaDB, with SQLite support for development
• Web Server: Nginx + PHP-FPM

Quick Start

Detailed deployment instructions will be added to docs/deployment.md.

1. Clone the repository:

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

2. Install dependencies:

   composer install

3. Configure the environment:

   • Copy .env.example to .env.
   • Specify the connection parameters for your database.

4. Run migrations and data seeding:

   composer db:migrate
   composer db:seed

5. Configure the web server to point to the public/ directory as the root.

6. Start the local server (for development):

   php -S localhost:8000 -t public

How to Run Code Quality Checks

To ensure code quality, the project uses the following tools:

• PHPStan — static analysis to detect errors in PHP code
• PHPCS — code style checking according to PSR-12 standard
• PHPUnit — running Unit and Integration tests

Installing Dependencies

composer install

Running Checks

All commands are executed from the www/ directory:

# Static analysis with PHPStan
composer stan

# Code style check with PHPCS
composer cs-check

# Automatic style fixes with PHPCS
composer cs

# Running PHPUnit tests
composer test

Running Individual Tools

# PHPStan
vendor/bin/phpstan analyse

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

# PHPCBF (automatic fixes)
vendor/bin/phpcbf --standard=PSR12 --ignore=vendor/ public/ src/

# PHPUnit
vendor/bin/phpunit

CI Checks

GitHub Actions automatically runs all checks on every push to branches main, epic/**, feature/**, fix/** and on Pull Requests to main. The status of checks is displayed in the badges at the beginning of this file.