Skip to content
kawayanmediaPublic

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenHR PH

An open-source Human Resource Information System and Philippine payroll platform for growing organisations. It brings employee records, attendance, leave and overtime requests, payroll processing, statutory contributions, payslips, and reporting into one workspace..

Status: the project is being prepared for public release. Please read SECURITY.md before deploying it or sharing a fork.

Try it: the hosted demo is at https://openhrph.laravel.cloud. Create an account, confirm the email we send you, and your own sample workspace opens with demo employees and payroll.

What it does

  • People — employee profiles, documents, certificates, training, schedules, compensation, loans, allowances, bonuses, and commissions.
  • Time and attendance — biometric device imports, timesheets, attendance corrections, overtime, undertime, leave, official business, and schedule adjustments.
  • Payroll — payroll groups, period previews, review, approval and locking, payslips, registers, and remittance reports.
  • Statutory compliance — effective-dated tables for the installation's country. The Philippines ships with SSS, PhilHealth, Pag-IBIG, GSIS, BIR withholding tax and minimum-wage tables; other countries are configured through generic statutory components.
  • Multi-company — one installation can serve several companies with tenant-scoped data and per-company settings.
  • Access control — owner accounts, groups, granular permissions, and a separate employee self-service portal.
  • Two admin experiences — a first-party Livewire admin at /app and an optional Filament panel.

Built with

Layer Technology
Backend PHP 8.3+, Laravel 13
Admin UI Livewire 3, Blade, Tailwind CSS 4, Vite 8
Optional admin panel Filament 3
Payroll engine Go 1.24 (MySQL-backed, with a PHP fallback)
Data MySQL 8 (SQLite for tests and the desktop build)
Queues and realtime Database/Redis queues, Laravel Reverb
Desktop NativePHP Desktop 2 (Electron + bundled PHP + SQLite)
Reporting Maatwebsite Excel, FPDF/FPDI, PHPWord

Quick start

Requirements

  • PHP 8.3 or newer with the usual Laravel extensions (bcmath, ctype, curl, dom, fileinfo, gd, intl, mbstring, openssl, pdo_mysql, tokenizer, xml, zip)
  • Composer 2
  • Node.js 22 and npm
  • Go 1.24 (only for the payroll engine)
  • MySQL 8 (SQLite is used only by the automated tests)

Install

git clone https://github.com/kawayanmedia/openhrph.git
cd hris

composer install
cp .env.example .env
php artisan key:generate

# Create and initialise the MySQL database
mysql -u root -p -e 'CREATE DATABASE hris CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;'
php artisan migrate

# Government or Private for the whole installation, and the payroll country
php artisan openhr:install

php artisan admin:create

npm ci
npm run build

# Optional: build the Go payroll engine
make -C payroll-engine build

php artisan serve

Open http://127.0.0.1:8000/app/login and sign in with the account created by admin:create.

The database is created entirely from the migrations in database/migrations. They are guarded with Schema::hasTable and Schema::hasColumn, so the same command also upgrades an existing installation. openhr:install seeds the leave type and compensation catalogues, which are system-wide: one set of shared rows plus an optional sector tag, with per-company overrides.

For the full setup, including the payroll engine, queues, Vite dev server, and demo data, read Local development.

Documentation

Start at the documentation hub.

The same content is published as a searchable site at kawayanmedia.github.io/openhrph, with a light/dark theme and the workspace screenshots. To run it locally:

cd docs-site
npm ci
npm start

The site reads docs/ directly, so there is nothing to keep in sync. See docs-site/README.md for the build and deployment details.

I use OpenHR PH

I build, extend, or operate OpenHR PH

Testing

vendor/bin/pest                    # PHP unit and feature tests (SQLite)
make -C payroll-engine test        # Go payroll engine tests
npm run e2e                        # Playwright browser tests
npm run e2e:dark                   # Playwright dark-mode project

Browser tests run against E2E_BASE_URL (defaults to APP_URL) and use an isolated seeded company. They never touch real payroll data. See Testing.

Deployment

  • Docker — build the application image and run the Compose stack: Docker deployment.
  • AWS — build a golden AMI with Packer and launch it with Terraform: AWS AMI deployment.
  • GCP — build a golden image with Packer and launch it with Terraform: GCP deployment.
  • Azure — build a managed image with Packer and launch it with Terraform: Azure deployment.
  • Laravel Cloud / Vapor — see Laravel Cloud for the managed-hosting path.
  • Desktop app — build a standalone macOS, Windows, or Linux app with NativePHP: Desktop app. It bundles SQLite, runs the parity-locked PHP payroll driver, and updates from GitHub Releases.

The Go payroll binary must exist on the server. The Docker image and the AWS, GCP, and Azure golden images build it automatically; other deployments must add make -C payroll-engine build to their release step. The desktop build does not use it.

Security

Please do not open a public issue for a security problem. Read SECURITY.md for the disclosure process.

Before publishing a fork, review the open-source release checklist. It covers credential rotation, history cleanup, and PII checks.

Contributing

Contributions are welcome. Read CONTRIBUTING.md for the development workflow, coding conventions, and pull-request checklist.

License

Released under the MIT License.

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages