{"id":22768680,"url":"https://github.com/mairess/employee-system","last_synced_at":"2026-04-11T02:03:10.115Z","repository":{"id":253697301,"uuid":"844249083","full_name":"mairess/employee-system","owner":"mairess","description":"An application for managing employee data, including a feature to change the password.","archived":false,"fork":false,"pushed_at":"2024-11-08T22:19:06.000Z","size":942,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T13:12:35.088Z","etag":null,"topics":["java","jwt","kafka","microservice","nextjs","pagination","postgresql","spring-boot","tailwindcss","testcontainers","typescript"],"latest_commit_sha":null,"homepage":"","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/mairess.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":"2024-08-18T20:32:16.000Z","updated_at":"2024-10-19T13:58:01.000Z","dependencies_parsed_at":"2024-09-15T00:28:24.249Z","dependency_job_id":"d0303c2c-f4bf-4f1e-ac67-cf907bbd4d82","html_url":"https://github.com/mairess/employee-system","commit_stats":null,"previous_names":["mairess/employee-system"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mairess%2Femployee-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mairess%2Femployee-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mairess%2Femployee-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mairess%2Femployee-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mairess","download_url":"https://codeload.github.com/mairess/employee-system/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246308048,"owners_count":20756482,"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":["java","jwt","kafka","microservice","nextjs","pagination","postgresql","spring-boot","tailwindcss","testcontainers","typescript"],"created_at":"2024-12-11T14:12:37.198Z","updated_at":"2026-04-11T02:03:10.073Z","avatar_url":"https://github.com/mairess.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Employee System\n\ncoverage backend\n\n[![codecov](https://codecov.io/gh/mairess/employee-system/graph/badge.svg?token=uhpCCXvCNz)](https://codecov.io/gh/mairess/employee-system)\n\n## Context\n\nThis is a system for managing employees.\n\nTry with admin super power:\n\n```\nusername: vitoria \n\npassword: 123456\n```\n\n## Run with Docker\n\n### Prerequisites\n\n⚠️ Make sure you have [Docker](https://www.docker.com/get-started/) installed on your machine:\n\n\nAlso set up the following env variables for the mail service ([guide here](./docs/set-env-variables-mail-service.md)):\n\n```\nMAIL_HOST=smtp.example.com \n\nMAIL_PORT=123\n\nMAIL_USERNAME=mymail@example.com\n\nMAIL_PASSWORD=asdfASDF123\n\n```\n\n⚠️ The variable `MAIL_PASSWORD` is not your email password, you need to create an app password, set this up [here](https://myaccount.google.com/apppasswords) if using google.\n\n### Steps:\n\n1. Clone repository:\n\n```BASH\ngit clone git@github.com:mairess/employee-system.git\n\ncd employee-system\n```\n\n2. Run application:\n\n```BASH\ndocker compose up -d --build \n```\n\n3. Available routes:\n\n```BASH\nhttp://localhost:8080/swagger-ui/index.html\n```\n\n## Run locally\n\nTo run this project locally, follow these steps:\n\n### Prerequisites\n\nMake sure you have the following installed on your machine:\n\n⚠️ [Java](https://www.oracle.com/java/)\n\n⚠️ [Docker](https://www.docker.com/get-started/)\n\n⚠️ [Apache kafka](https://kafka.apache.org/quickstart)\n\nAlso set up the following env variables for the mail service ([guide here](./docs/set-env-variables-mail-service.md)):\n\n```\nMAIL_HOST=smtp.example.com \n\nMAIL_PORT=123\n\nMAIL_USERNAME=mymail@example.com\n\nMAIL_PASSWORD=asdfASDF123\n\n```\n\n⚠️ The variable `MAIL_PASSWORD` is not your email password, you need to create an app password, set this up [here](https://myaccount.google.com/apppasswords) if using google.\n\n### Steps:\n\n1. Start Kafka with KRaft (Kafka must be running before start the application):\n\n```BASH\n# Generate a Cluster UUID\nKAFKA_CLUSTER_ID=\"$(bin/kafka-storage.sh random-uuid)\"\n\n# Format Log Directories\nbin/kafka-storage.sh format -t $KAFKA_CLUSTER_ID -c config/kraft/server.properties\n\n#Start the Kafka Server\nbin/kafka-server-start.sh config/kraft/server.properties\n```\n\n2. Clone repository:\n\n```BASH\ngit clone git@github.com:mairess/employee-system.git\n\ncd employee-system\n```\n\n3. Start database:\n\n```BASH\ndocker compose up -d database\n```\n\n4. Start backend:\n\n```BASH\ncd backend\n\nmvn clean install\n\nmvn spring-boot:run\n```\n\n5. Start ms-email:\n\n```BASH\n# open another terminal and enter ms-email\n\ncd ms-email\n\nmvn clean install\n\nmvn spring-boot:run\n```\n\n6. Start frontend (just to change password nothing more):\n\n```BASH\n# open another terminal and enter frontend\n\ncd frontend\n\nnpm install\n\nnpm run dev\n```\n\n7. Available routes:\n\n```BASH\nhttp://localhost:8080/swagger-ui/index.html\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmairess%2Femployee-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmairess%2Femployee-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmairess%2Femployee-system/lists"}