{"id":28598153,"url":"https://github.com/ranieeery/busca-cep","last_synced_at":"2026-04-13T13:01:39.461Z","repository":{"id":158451146,"uuid":"625038571","full_name":"Ranieeery/Busca-CEP","owner":"Ranieeery","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-18T02:18:15.000Z","size":2923,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-24T17:36:55.724Z","etag":null,"topics":["docker","java","junit","lombok","maven","mysql","spring"],"latest_commit_sha":null,"homepage":"","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/Ranieeery.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":"2023-04-07T22:37:51.000Z","updated_at":"2025-02-20T22:17:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"71e5f52c-2d1c-4b0b-9a53-c83fc073a6f9","html_url":"https://github.com/Ranieeery/Busca-CEP","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Ranieeery/Busca-CEP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ranieeery%2FBusca-CEP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ranieeery%2FBusca-CEP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ranieeery%2FBusca-CEP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ranieeery%2FBusca-CEP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ranieeery","download_url":"https://codeload.github.com/Ranieeery/Busca-CEP/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ranieeery%2FBusca-CEP/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31753551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T09:16:15.125Z","status":"ssl_error","status_checked_at":"2026-04-13T09:16:05.023Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["docker","java","junit","lombok","maven","mysql","spring"],"created_at":"2025-06-11T11:42:35.485Z","updated_at":"2026-04-13T13:01:39.432Z","avatar_url":"https://github.com/Ranieeery.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Busca CEP API\n\nA Spring Boot application that manages a database of Brazilian postal codes (CEPs) and provides a REST API for querying them. Currently focused on the state of Minas Gerais with approximately 80,000 postal codes, with plans to expand to cover all Brazilian states (approximately 890,000 postal codes).\n\n## Features\n\n- REST API for querying Brazilian postal codes (CEPs)\n- MySQL database integration\n- JUnit test coverage\n- Status endpoint for monitoring setup progress\n- Initial focus on Minas Gerais state postal codes\n\n## Technology Stack\n\n- Java 17\n- Spring Boot 3\n- MySQL Database\n- Spring Data JPA\n- Lombok\n- Maven\n- JUnit for testing\n\n## Prerequisites\n\n- Java 17 or higher\n- MySQL Server\n- Maven\n\n## Installation\n\n1. Install dependencies:\n\n```bash\nmvn clean install\n```\n\n2. Configure the MySQL database:\n\n```sql\nCREATE DATABASE correios;\n```\n\n3. Run the application:\n\n```bash\nmvn spring-boot:run\n```\n\n## Usage\n\n1. Start the Spring Boot application\n\n2. The initial setup will take approximately 1 minute to complete\n\n3. Check the application status at: `http://localhost:8080/status`\n\n4. Once setup is complete, you can query postal codes via the API\n\nNote: Attempting to query before setup completion will return a 503 error.\n\n## API Documentation\n\nThe API documentation is available through Swagger UI at:\n\n- `http://localhost:8080/swagger-ui.html`\n\nYou can also access the OpenAPI specification at:\n\n- `http://localhost:8080/v3/api-docs`\n\nThese endpoints provide interactive documentation for all available API endpoints, request/response models, and testing capabilities.\n\n## Testing\n\nRun the unit tests using:\n\n```bash\nmvn test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Franieeery%2Fbusca-cep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Franieeery%2Fbusca-cep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Franieeery%2Fbusca-cep/lists"}