{"id":28933913,"url":"https://github.com/abdellahdev01/hahntrack","last_synced_at":"2025-07-14T16:39:42.413Z","repository":{"id":300058579,"uuid":"1005086487","full_name":"ABDELLAHdev01/HahnTrack","owner":"ABDELLAHdev01","description":"HahnTrack is a full-stack CRUD application designed for managing and tracking maintenance tasks for industrial equipment. Built using Java (Spring Boot) and React.js, it enables users to create, update, and monitor tasks related to machinery maintenance across factory floors or municipal infrastructures.","archived":false,"fork":false,"pushed_at":"2025-06-19T17:32:11.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-19T17:42:49.002Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/ABDELLAHdev01.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,"zenodo":null}},"created_at":"2025-06-19T16:37:48.000Z","updated_at":"2025-06-19T17:32:15.000Z","dependencies_parsed_at":"2025-06-19T17:43:27.530Z","dependency_job_id":"9bde91a6-5ea4-493a-a143-38f4064e8c32","html_url":"https://github.com/ABDELLAHdev01/HahnTrack","commit_stats":null,"previous_names":["abdellahdev01/hahntrack"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ABDELLAHdev01/HahnTrack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABDELLAHdev01%2FHahnTrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABDELLAHdev01%2FHahnTrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABDELLAHdev01%2FHahnTrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABDELLAHdev01%2FHahnTrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ABDELLAHdev01","download_url":"https://codeload.github.com/ABDELLAHdev01/HahnTrack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABDELLAHdev01%2FHahnTrack/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265319582,"owners_count":23746364,"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":[],"created_at":"2025-06-22T18:11:51.140Z","updated_at":"2025-07-14T16:39:42.405Z","avatar_url":"https://github.com/ABDELLAHdev01.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HahnTrack\nHahnTrack is a full-stack CRUD application designed for managing and tracking maintenance tasks for industrial equipment. Built using Java (Spring Boot) and React.js, it enables users to create, update, and monitor tasks related to machinery maintenance across factory floors or municipal infrastructures.\n\nThis project was developed as part of an assessment, inspired by Hahn Software’s focus on digital transformation in the mechanical, infrastructure, and public sectors.\n\nThis project consists of a backend Spring Boot API and a frontend application. You can run the app locally or using Docker.\n\n---\n\n## Prerequisites\n\n- Java 17+\n- Maven (for backend)\n- Node.js and npm/yarn (for frontend)\n- Docker \u0026 Docker Compose (for containerized setup)\n\n---\n\n## Running Locally\n\n### Backend\n\n1. Make sure your MySQL server is running locally or accessible.\n2. Configure your `application.properties` or `application.yml` with your local database connection details.\n3. Build and run the backend:\n4. \n```bash\ncd backend\n./mvnw clean install\n./mvnw spring-boot:run\n```\n## Frontend\n\nNavigate to the frontend directory:\n\n```bash\ncd frontend\n\nInstall dependencies:\nnpm install\n# or\nyarn install\n\nRun the frontend dev server:\n\nnpm start\n# or\nyarn start\n```\n\n## Running with Docker\n\n### Prerequisites\n\nMake sure Docker and Docker Compose are installed and running.\n\n### Start the app with Docker Compose\n\nFrom the root project directory, run:\n\n```bash\ndocker-compose up --build\n```\nThis will:\n\n- Build and start the MySQL database container\n- Build and start the backend API container\n- (Optionally) Build and start the frontend container if included in your compose file\n\n### Stop containers\n\n```bash\ndocker-compose down\n```\n\n## Notes\n\n- The backend waits for the database container to be ready before starting.\n- The database credentials and ports are configured in `docker-compose.yml`.\n- You can customize ports and environment variables by editing `docker-compose.yml`.\n- If you want to connect to the MySQL database directly, use port `3306` mapped in the compose file.\n- Make sure to update your local hosts or DNS if you use custom hostnames in the connection strings.\n\n## Troubleshooting\n\nIf the backend fails to connect to the database on startup, check that:\n\n- The MySQL container is running and ready.\n- The connection URL, username, and password in backend config match the Docker setup.\n- For any permission or volume issues, ensure Docker has appropriate access to volumes.\n\nUse logs for debugging:\n\n```bash\ndocker-compose logs backend\ndocker-compose logs db\n```\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdellahdev01%2Fhahntrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdellahdev01%2Fhahntrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdellahdev01%2Fhahntrack/lists"}