https://github.com/mihape/hr-admin-platform
Local-first Windows desktop app for invoices, fleet, attendance, utilities/rent settlements, and admin operations.
https://github.com/mihape/hr-admin-platform
electron hr-admin it-support local-first sysadmin windows
Last synced: 23 days ago
JSON representation
Local-first Windows desktop app for invoices, fleet, attendance, utilities/rent settlements, and admin operations.
- Host: GitHub
- URL: https://github.com/mihape/hr-admin-platform
- Owner: mihape
- License: mit
- Created: 2026-06-25T07:07:06.000Z (30 days ago)
- Default Branch: main
- Last Pushed: 2026-06-26T08:18:37.000Z (29 days ago)
- Last Synced: 2026-06-26T08:23:00.978Z (29 days ago)
- Topics: electron, hr-admin, it-support, local-first, sysadmin, windows
- Language: JavaScript
- Size: 505 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# HR Admin Platform
HR Admin Platform is a local-first Windows desktop application for small business administration workflows: invoices, fleet records, attendance sheets, utilities/rent settlements, and basic company settings. The public repository is maintained as a portfolio project focused on Windows deployment, release management, backup/restore planning, and practical IT support handoff.
## Portfolio Context
This project is presented as a practical IT operations portfolio piece for remote Junior System Administrator / IT Support Engineer roles. It shows how an internal business need can be translated into a supportable Windows desktop tool with installer packaging, release assets, checksum verification, local/NAS data storage, backup and restore notes, security boundary documentation, and user-facing instructions.
It is not only a UI project. The repository demonstrates operational habits that matter in IT support: clear release/demo separation, documented installation and update flows, silent deployment research, local data protection trade-offs, issue-driven changes, pull requests, and GitHub Actions validation.
## What This Demonstrates
- Windows desktop packaging with a classic NSIS setup wizard.
- Local-first data handling with optional NAS/shared JSON file mode.
- Release/demo build separation and SHA256 checksums.
- Backup, restore, deployment, security, and workflow documentation.
- Portfolio-style GitHub process: issues, pull requests, milestones, and releases.
- IT support thinking: user handoff, support notes, deployment caveats, and documented limitations.
## Features
- **Invoice administration**: manual entry, CSV import, saved partners, project hints, focus view, filtering, and bulk settlement.
- **Fleet management**: vehicles, refuels, service jobs, cost summaries, and MOT/insurance deadlines.
- **Utilities / rent settlements**: properties, tenants, utility meter readings, monthly balances, and one-off extra items.
- **Attendance sheets**: employee list, weekly sheet preview, A4 print workflow, and CSV export.
- **Settings and backup**: company/user defaults, invoice defaults, local/shared data file mode, backup, and restore.
## Screenshots
The screenshots below use the release build with empty/sanitized data.
| Overview | Invoices | Utilities / Rent |
| --- | --- | --- |
|  |  |  |
## Architecture and Tech Stack
- **Runtime**: Electron desktop app for Windows.
- **Frontend**: static HTML, CSS, and vanilla JavaScript modules.
- **Storage**: local JSON data file through Electron preload/native IPC, with browser localStorage fallback for development.
- **Packaging**: electron-builder with NSIS assisted installer.
- **Build modes**: release mode starts empty; demo mode seeds fictional sample data.
See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details.
## Installation and Deployment
Use the default release installer for a clean public release:
```text
release-assets/HR.Admin.Platform.Setup.0.3.7.exe
```
The installer uses a classic Windows setup wizard and allows choosing the installation directory. A fresh machine starts with an empty local database.
The demo installer is only for internal testing:
```text
release-assets/HR.Admin.Platform.Setup.0.3.7.Demo.exe
```
See [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) for sysadmin-focused deployment, update, uninstall, and backup notes.
## Project Workflow and CI
This repository is maintained with an issue -> branch -> pull request -> release workflow. See [docs/WORKFLOW.md](docs/WORKFLOW.md).
The GitHub Actions workflow is present for Windows installer automation and has successfully built the Windows installer on pull requests. See [docs/CI.md](docs/CI.md).
## Security Notes
This is a local-first desktop app. It does not open network ports, does not include built-in authentication or RBAC, and does not sync to cloud storage by itself. Data can remain in the Windows user profile or be pointed to a NAS/shared JSON file. Data protection depends on Windows/NAS permissions, filesystem protection, and operational backup practices.
See [docs/SECURITY.md](docs/SECURITY.md), [docs/ENCRYPTION_RESEARCH.md](docs/ENCRYPTION_RESEARCH.md), [docs/AUTH_RBAC_ROADMAP.md](docs/AUTH_RBAC_ROADMAP.md), and [SECURITY.md](SECURITY.md).
## Development
Install dependencies:
```bash
npm install
```
Run the Electron app locally:
```bash
npm start
```
Build the empty release installer:
```bash
npm run build:win
```
Build the fictional demo-data installer:
```bash
npm run build:win:demo
```
## Release Assets
The `release-assets` folder is included as a handoff convenience, but installer EXE files are ignored by `.gitignore` so they are not accidentally committed into repository history. Upload installers as GitHub Release assets instead.
- `HR.Admin.Platform.Setup.0.3.7.exe` - default release installer, empty startup.
- `HR.Admin.Platform.Setup.0.3.7.Demo.exe` - demo build with fictional sample data.
- `CHECKSUMS.txt` - SHA256 checksums.
## Hungarian Summary
Ez egy helyi Windows admin alkalmazás számlák, flotta, jelenléti ívek, rezsi/albérlet elszámolások és alap céges beállítások kezelésére.
Portfolio szempontból azt mutatja meg, hogy nemcsak egy üzleti folyamatot lehet digitalizálni, hanem a teljes átadási/üzemeltetési környezetre is lehet figyelni: Windows telepítő, verziózott release, mentés/visszatöltés, NAS-os adatkezelés, dokumentáció, biztonsági korlátok, GitHub issue/PR workflow és release automatizáció.
Részletes magyar használati útmutató: [HASZNALATI_UTMUTATO.md](HASZNALATI_UTMUTATO.md)
## LinkedIn Project Description
Copy-ready LinkedIn project text is available in [docs/LINKEDIN_PROJECT.md](docs/LINKEDIN_PROJECT.md).