{"id":22678415,"url":"https://github.com/web2solutions/payroll-service","last_synced_at":"2026-04-21T05:30:52.064Z","repository":{"id":214367255,"uuid":"736321344","full_name":"web2solutions/payroll-service","owner":"web2solutions","description":"Simple payroll service","archived":false,"fork":false,"pushed_at":"2024-05-02T16:07:13.000Z","size":3414,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-29T13:12:31.601Z","etag":null,"topics":["concurrency","javascript","nodejs","payroll","redis","sequelize","transaction"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/web2solutions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-27T15:33:21.000Z","updated_at":"2023-12-27T15:34:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"835b53b3-310b-4b89-be74-a368192006d8","html_url":"https://github.com/web2solutions/payroll-service","commit_stats":null,"previous_names":["web2solutions/payroll-service"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/web2solutions/payroll-service","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web2solutions%2Fpayroll-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web2solutions%2Fpayroll-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web2solutions%2Fpayroll-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web2solutions%2Fpayroll-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/web2solutions","download_url":"https://codeload.github.com/web2solutions/payroll-service/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/web2solutions%2Fpayroll-service/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32078677,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T02:38:07.213Z","status":"ssl_error","status_checked_at":"2026-04-21T02:38:06.559Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["concurrency","javascript","nodejs","payroll","redis","sequelize","transaction"],"created_at":"2024-12-09T18:15:14.279Z","updated_at":"2026-04-21T05:30:52.047Z","avatar_url":"https://github.com/web2solutions.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Payroll](./frontend/public/img/payrollb.png \"Payroll\")\n\n# Simple Payroll Service\n\nThis project is as POC and is organized as a monorepo that coordinates a [backend](./backend) and a [frontend](./frontend) project.\n\nThe main purpose is to mitigate a locking mechanism for concurrent requests to vertical scaled node.js application.\n\nThe [backend](./backend) is a REST API with some different end points and the [frontend](./frontend) is consuming that API.\n\n\n`Project status:` in progress\n\n## Tech debits\n\n[Tech debits](./TECH-DEBITS.md) \n\n## Application stacks\n\n### Backend\n\n- Javascript\n- Express\n- Express Parser\n- Sequelize\n- SQLite\n- Redis\n\n### Frontend\n\n- React\n- Context API\n- fetch API\n- Bootstrap css\n\n### Project tooling\n\n- Git\n- Eslint\n- Husky\n- Commitizen\n- npm\n- Docker\n- Jest\n- Supertest\n\n\n\n## Testing\n\nDue the time limitation, actually only the [backend](./backend) have a [test suite](./backend/test/integration/).\n\nRather than to write unit tests to cover the application, I decided to implement integration tests.\n\nTo test the backend application you need to navigate to it folder through your terminal in prior.\n\n```bash\n    $   cd backend\n```\n\n***`Note1:`  Do not start the API to test it.***\n\n***`Note2:`  Delete the file `/backend/database.sqlite3`, if it exists, before running the tests .***\n\nNow you can run the test suite:\n\n```bash\n    $   npm test\n```\n\n\n## How to run the application?\n\nIf you don't have Docker then you can manual run it.\n\n### Manually running the applications\n\nIt is recommended to have at least the version `18` of `Node.js`.\n\nYou will need to have [Redis](https://redis.io/docs/install/install-redis/) installed to manual run the application\n\n#### Install\n\nTo get able to reach the frontend application and see it running integrated with the backend, you need to install it prior.\n\n```bash\n    $   npm run install:all\n```\n\n***Please do not run `npm install` because it will not install both projects.***\n\n#### Run the applications.\n\nThis project offers a command that concurrently starts both applications.\n\n```bash\n    $   npm start\n```\n\nNow you can reach it through your preferred browser by accessing `http://localhost:3000/`.\n\n\n### Running the applications with Docker\n\n\n1. install the tooling\n\n\n```bash\n    $   npm install\n```\n\n2. \n\n```bash\n    $   npm run docker\n```\n\nOnce the containers are started, you can reach it through your preferred browser by accessing `http://localhost:3000/`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb2solutions%2Fpayroll-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweb2solutions%2Fpayroll-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb2solutions%2Fpayroll-service/lists"}