{"id":51153058,"url":"https://github.com/mihape/hr-admin-platform","last_synced_at":"2026-06-26T08:01:11.033Z","repository":{"id":367282134,"uuid":"1279986100","full_name":"mihape/hr-admin-platform","owner":"mihape","description":"Local-first Windows desktop app for invoices, fleet, attendance, utilities/rent settlements, and admin operations.","archived":false,"fork":false,"pushed_at":"2026-06-25T09:19:03.000Z","size":407,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T11:09:10.732Z","etag":null,"topics":["electron","hr-admin","it-support","local-first","sysadmin","windows"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mihape.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-25T07:07:06.000Z","updated_at":"2026-06-25T09:19:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mihape/hr-admin-platform","commit_stats":null,"previous_names":["mihape/hr-admin-platform"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mihape/hr-admin-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihape%2Fhr-admin-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihape%2Fhr-admin-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihape%2Fhr-admin-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihape%2Fhr-admin-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mihape","download_url":"https://codeload.github.com/mihape/hr-admin-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihape%2Fhr-admin-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34808043,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron","hr-admin","it-support","local-first","sysadmin","windows"],"created_at":"2026-06-26T08:00:41.372Z","updated_at":"2026-06-26T08:01:11.013Z","avatar_url":"https://github.com/mihape.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HR Admin Platform\n\n![Windows](https://img.shields.io/badge/platform-Windows-0078D4)\n![Electron](https://img.shields.io/badge/runtime-Electron-47848F)\n![Local first](https://img.shields.io/badge/storage-local--first-0F766E)\n![Build](https://img.shields.io/badge/release-NSIS%20installer-2F855A)\n\nHR 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.\n\n## Portfolio Context\n\nThis project is presented as a practical IT operations portfolio piece for remote Junior System Administrator / IT Support Engineer roles. It focuses on the full lifecycle around an internal business tool: packaging, Windows deployment, release assets, local data storage, backup/restore, security boundaries, and user-facing documentation.\n\nIt is not only a UI project. The repository demonstrates how an internal desktop app can be prepared for handoff: assisted installer builds, release/demo modes, checksum generation, deployment notes, security limitations, and GitHub Actions automation.\n\n## Features\n\n- **Invoice administration**: manual entry, CSV import, saved partners, project hints, focus view, filtering, and bulk settlement.\n- **Fleet management**: vehicles, refuels, service jobs, cost summaries, and MOT/insurance deadlines.\n- **Utilities / rent settlements**: properties, tenants, utility meter readings, monthly balances, and one-off extra items.\n- **Attendance sheets**: employee list, weekly sheet preview, A4 print workflow, and CSV export.\n- **Settings and backup**: company/user defaults, invoice defaults, local/shared data file mode, backup, and restore.\n\n## Screenshots\n\nThe screenshots below use the release build with empty/sanitized data.\n\n![Overview](docs/screenshots/overview.png)\n\n![Invoices](docs/screenshots/invoices.png)\n\n![Utilities](docs/screenshots/utilities.png)\n\n## Architecture and Tech Stack\n\n- **Runtime**: Electron desktop app for Windows.\n- **Frontend**: static HTML, CSS, and vanilla JavaScript modules.\n- **Storage**: local JSON data file through Electron preload/native IPC, with browser localStorage fallback for development.\n- **Packaging**: electron-builder with NSIS assisted installer.\n- **Build modes**: release mode starts empty; demo mode seeds fictional sample data.\n\nSee [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details.\n\n## Installation and Deployment\n\nUse the default release installer for a clean public release:\n\n```text\nrelease-assets/HR Admin Platform Setup 0.3.2.exe\n```\n\nThe installer uses a classic Windows setup wizard and allows choosing the installation directory. A fresh machine starts with an empty local database.\n\nThe demo installer is only for internal testing:\n\n```text\nrelease-assets/HR Admin Platform Setup 0.3.2 Demo.exe\n```\n\nSee [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) for sysadmin-focused deployment, update, uninstall, and backup notes.\n\n## Security Notes\n\nThis 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.\n\nSee [docs/SECURITY.md](docs/SECURITY.md) and [SECURITY.md](SECURITY.md).\n\n## Development\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nRun the Electron app locally:\n\n```bash\nnpm start\n```\n\nBuild the empty release installer:\n\n```bash\nnpm run build:win\n```\n\nBuild the fictional demo-data installer:\n\n```bash\nnpm run build:win:demo\n```\n\n## Release Assets\n\nThe `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.\n\n- `HR Admin Platform Setup 0.3.2.exe` - default release installer, empty startup.\n- `HR Admin Platform Setup 0.3.2 Demo.exe` - demo build with fictional sample data.\n- `CHECKSUMS.txt` - SHA256 checksums.\n\n## Hungarian Summary\n\nEz 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.\n\nPortfolio 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: telepítő, verziókezelés, mentés, dokumentáció, biztonsági korlátok és release automatizáció.\n\nRészletes magyar használati útmutató: [HASZNALATI_UTMUTATO.md](HASZNALATI_UTMUTATO.md)\n\n## LinkedIn Project Description\n\n```text\nHR Admin Platform - Local-first Windows desktop app for internal business administration.\n\nBuilt and packaged an Electron-based Windows application covering invoice tracking, fleet records, attendance sheets, and utilities/rent settlements. The project focuses on IT operations readiness: assisted NSIS installer, release/demo build modes, local or NAS-hosted JSON data storage, backup/restore flow, deployment documentation, security notes, and GitHub Actions release automation.\n\nPortfolio relevance: demonstrates business alignment, Windows desktop deployment, local data handling, release management, and documentation practices for Junior System Administrator / IT Support Engineer roles.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmihape%2Fhr-admin-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmihape%2Fhr-admin-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmihape%2Fhr-admin-platform/lists"}