{"id":51153058,"url":"https://github.com/mihape/hr-admin-platform","last_synced_at":"2026-07-02T12:00:47.411Z","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-26T08:18:37.000Z","size":517,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-26T08:23:00.978Z","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-26T08:18:41.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":4,"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":35045926,"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-07-02T02:00:06.368Z","response_time":173,"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-07-02T12:00:47.396Z","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. The public repository is maintained as a portfolio project focused on Windows deployment, release management, backup/restore planning, and practical IT support handoff.\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 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.\n\nIt 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.\n\n## What This Demonstrates\n\n- Windows desktop packaging with a classic NSIS setup wizard.\n- Local-first data handling with optional NAS/shared JSON file mode.\n- Release/demo build separation and SHA256 checksums.\n- Backup, restore, deployment, security, and workflow documentation.\n- Portfolio-style GitHub process: issues, pull requests, milestones, and releases.\n- IT support thinking: user handoff, support notes, deployment caveats, and documented limitations.\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 | Invoices | Utilities / Rent |\n| --- | --- | --- |\n| ![Overview dashboard](docs/screenshots/overview.png) | ![Invoice management](docs/screenshots/invoices.png) | ![Utilities and rent settlements](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.7.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.7.Demo.exe\n```\n\nSee [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) for sysadmin-focused deployment, update, uninstall, and backup notes.\n\n## Project Workflow and CI\n\nThis repository is maintained with an issue -\u003e branch -\u003e pull request -\u003e release workflow. See [docs/WORKFLOW.md](docs/WORKFLOW.md).\n\nThe 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).\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), [docs/ENCRYPTION_RESEARCH.md](docs/ENCRYPTION_RESEARCH.md), [docs/AUTH_RBAC_ROADMAP.md](docs/AUTH_RBAC_ROADMAP.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.7.exe` - default release installer, empty startup.\n- `HR.Admin.Platform.Setup.0.3.7.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: 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ó.\n\nRészletes magyar használati útmutató: [HASZNALATI_UTMUTATO.md](HASZNALATI_UTMUTATO.md)\n\n## LinkedIn Project Description\n\nCopy-ready LinkedIn project text is available in [docs/LINKEDIN_PROJECT.md](docs/LINKEDIN_PROJECT.md).\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"}