{"id":24364118,"url":"https://github.com/naimulcsx/proghours","last_synced_at":"2025-04-07T11:09:26.247Z","repository":{"id":39361409,"uuid":"426525458","full_name":"naimulcsx/progHours","owner":"naimulcsx","description":"A gamification-driven platform for problem solvers.","archived":false,"fork":false,"pushed_at":"2025-02-16T03:21:21.000Z","size":21118,"stargazers_count":85,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"development","last_synced_at":"2025-03-31T10:05:06.433Z","etag":null,"topics":["codechef","codeforces","competitive-programming","nestjs","nx","nx-workspace","postgresql","problem-solving","programming","react","typescript"],"latest_commit_sha":null,"homepage":"https://proghours.com","language":"TypeScript","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/naimulcsx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2021-11-10T07:30:07.000Z","updated_at":"2025-03-10T06:56:07.000Z","dependencies_parsed_at":"2024-03-09T03:26:24.697Z","dependency_job_id":"f00e9694-ceab-47a6-a293-7505fd3eeb2d","html_url":"https://github.com/naimulcsx/progHours","commit_stats":null,"previous_names":["proghours/proghours","naimulcsx/proghours"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naimulcsx%2FprogHours","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naimulcsx%2FprogHours/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naimulcsx%2FprogHours/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naimulcsx%2FprogHours/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/naimulcsx","download_url":"https://codeload.github.com/naimulcsx/progHours/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640465,"owners_count":20971557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["codechef","codeforces","competitive-programming","nestjs","nx","nx-workspace","postgresql","problem-solving","programming","react","typescript"],"created_at":"2025-01-18T23:21:01.047Z","updated_at":"2025-04-07T11:09:26.230Z","avatar_url":"https://github.com/naimulcsx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![progHours](./docs/assets/cover.png?)\n\n\u003e _Update: We're excited to announce that the public beta is just around the corner! 🎉 We've completely rebuilt progHours from the ground up._\n\n# progHours\n\n**_A gamification-driven platform for competitive programmers._**\n\n![GitHub Repo stars](https://img.shields.io/github/stars/naimulcsx/proghours?style=social)\n![GitHub issues](https://img.shields.io/github/issues/naimulcsx/progHours)\n\n## What is progHours?\n\nprogHours is an effort to combine problem-solving and gamification techniques to create a platform tailored for competitive programmers. This platform offers valuable analytics to foster user engagement and encourages them to compete with one another. It also helps coaches by offering valuable insights through comprehensive analytics to monitor and assess student progress.\n\n## Motivation and Goals\n\nThis project is experimental and we are working to define and refine our goals. However, we have settled on the following common goals for the project:\n\n- To provide comprehensive analytics on your problem-solving journey.\n- To use gamification techniques, such as leaderboard, points and rewards, to engage students in competitive programming and compete with others.\n- To provide coaches with valuable insights through comprehensive analytics to monitor and assess student progress.\n- To foster a sense of community and shared accomplishment among students.\n- To provide users with the opportunity to showcase their problem-solving skills to the recruiters.\n\n## Online Judge Support\n\nCurrently, we provide support for 14 Online Judges. Users can only track problems from supported online judges. We've created this library called `@proghours/crawler`, which is responsible for collecting problem and submissions data data from supported Online Judges. To learn more about it please explore the details [here](https://github.com/naimulcsx/progHours/tree/development/libs/crawler).\n\n## Tech Stack\n\n- Nx, TypeScript, React, Mantine, TanStack Query, Playwright\n- NestJS, PostgreSQL, Prisma, Redis, BullMQ, Bull Board, Jest\n- Docker, Docker Compose, Pino, Prometheus, Grafana, Loki\n\n## Local development\n\n### Prerequisites\n\n- NodeJS\n- Docker\n\n### Steps\n\n#### Step 1: Clone the Repository\n\nBegin by cloning this repository to your machine.\n\n```\ngit clone git@github.com:naimulcsx/progHours.git\n```\n\n#### Step 2: Install the dependencies\n\nInstall the dependencies.\n\n```bash\nnpm install\n```\n\n#### Step 3: Run necessary components\n\nNavigate to the `progHours` directory and run the components using docker-compose.\n\n```bash\ncd progHours\ndocker-compose -f docker-compose.yml up -d\n```\n\n#### Step 4: Run database migrations\n\nIf you are setting up for the first time, you need to run database migrations\n\n```bash\nnpm run db:migrate\n```\n\n#### Step 5: Launch the project\n\nLaunch the project by running the following command.\n\n```bash\nnpm run dev\n```\n\n### Running E2E Tests\n\nYou can execute the end-to-end (E2E) tests using Playwright by running the following command in your terminal. The tests will run in a headless browser environment, and the test results will be displayed in the console.\n\n```bash\nnx run client:e2e\n```\n\nIf you want to explore, run and debug tests with a time travel experience, you can use the Playwright's UI mode. o open UI mode, run the following command in your terminal:\n\n```bash\nnx run client:e2e --ui\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaimulcsx%2Fproghours","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaimulcsx%2Fproghours","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaimulcsx%2Fproghours/lists"}