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 for details.

Installation and Deployment

Use the default release installer for a clean public release:

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:

release-assets/HR.Admin.Platform.Setup.0.3.7.Demo.exe

See 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.

The GitHub Actions workflow is present for Windows installer automation and has successfully built the Windows installer on pull requests. See 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/ENCRYPTION_RESEARCH.md, docs/AUTH_RBAC_ROADMAP.md, and SECURITY.md.

Development

Install dependencies:

npm install

Run the Electron app locally:

npm start

Build the empty release installer:

npm run build:win

Build the fictional demo-data installer:

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