{"id":27598100,"url":"https://github.com/gusmaomatheus/car-repair-api","last_synced_at":"2026-05-19T04:02:25.189Z","repository":{"id":288969635,"uuid":"968974160","full_name":"gusmaomatheus/car-repair-api","owner":"gusmaomatheus","description":"Developed as a practical assessment for the PRW3 subject.","archived":false,"fork":false,"pushed_at":"2025-04-20T19:15:31.000Z","size":68,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-20T19:30:35.511Z","etag":null,"topics":["dto","h2","hibernate","java","java-21","jpa","restfull-api","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/gusmaomatheus.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-04-19T05:19:57.000Z","updated_at":"2025-04-20T19:15:35.000Z","dependencies_parsed_at":"2025-04-22T01:46:56.266Z","dependency_job_id":null,"html_url":"https://github.com/gusmaomatheus/car-repair-api","commit_stats":null,"previous_names":["gusmaomatheus/car-repair-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusmaomatheus%2Fcar-repair-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusmaomatheus%2Fcar-repair-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusmaomatheus%2Fcar-repair-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gusmaomatheus%2Fcar-repair-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gusmaomatheus","download_url":"https://codeload.github.com/gusmaomatheus/car-repair-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250255700,"owners_count":21400410,"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":["dto","h2","hibernate","java","java-21","jpa","restfull-api","spring"],"created_at":"2025-04-22T14:10:53.118Z","updated_at":"2026-05-19T04:02:25.182Z","avatar_url":"https://github.com/gusmaomatheus.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚗 API de Consertos de Carros\n\nEste é um projeto de **API RESTful** desenvolvido em **Java** com **Spring**, que implementa um CRUD completo para gerenciar **consertos de carros**.\n\n## 🚀 Tecnologias Utilizadas\n\n- **Java 21**\n- **Spring Web**\n- **Spring JPA**\n- **Spring Validation**\n- **Spring Security**\n- **JWT Auth**\n- **Flyway**\n- **H2 Database (em arquivo)**\n- **Maven**\n\n___\n\n## 📌 Objetivo do Projeto\n\nEsta aplicação tem como finalidade permitir o cadastro, listagem, atualização e exclusão de registros relacionados a consertos de veículos. A estrutura do projeto foi pensada para aplicar boas práticas de desenvolvimento backend utilizando **Spring** e **JPA**.\n\n\u003e ℹ️ *Este projeto foi desenvolvido como parte de uma avaliação da disciplina de Programação Web na faculdade. Algumas funcionalidades têm foco didático e podem não refletir a complexidade de um sistema real.*\n\n___\n\n## 🧩 Arquitetura e Boas Práticas\n\n- Utilização do **padrão DTO (Data Transfer Object)** para separação entre as camadas de domínio e apresentação.\n- Aplicação dos princípios **SOLID** para garantir um código mais limpo, coeso e de fácil manutenção.\n- Migrations controladas com o **Flyway**, garantindo versionamento do banco de dados desde a criação das tabelas.\n\n___\n\n## 🛠️ Como Executar\n\nPara executar o projeto é necessário ter [java 21](https://www.oracle.com/br/java/technologies/downloads/#java21) e [maven](https://maven.apache.org/download.cgi) instalados.\n\n1. Clone o repositório:\n   ```sh\n   git clone git@github.com:gusmaomatheus/car-repair-api.git\n   cd car-repair-api\n   ```\n\n2. Compile e execute o projeto com Maven:\n   ```sh\n   mvn clean install\n   ./mvnw spring-boot:run\n   ```\n___\n\n## 📄 Acessando a aplicação:\n\n- Utilizar o seguinte corpo na requisição `POST api/auth`:\n```\n{\n  // Login padrão, utilizar ele. \n  \"login\": \"usuario\",\n  \"senha\": \"senha\"\n}\n```\n\n## 📫 Endpoints Principais\n\nA API segue os princípios REST e expõe os seguintes endpoints:\n\n- `POST api/auth` — Login (TODOS os endpoints abaixo necessitam que o usuário esteja logado).\n- `GET api/conserto` — Lista todos os consertos de maneira detalhada.\n- `GET api/conserto/resumo` — Lista todos os consertos de maneira resumida (apenas os consertos ativos).\n- `GET api/conserto/{id}` — Detalha um conserto específico.\n- `POST api/conserto` — Cadastra um novo conserto.\n- `PATCH api/conserto/{id}` — Atualiza algumas das informações de um conserto.\n- `DELETE api/conserto/inativar/{id}` — Inativa um conserto cadastrado.\n\n\n#### 📄 JSON's de exemplo para as requisições:\n\n- `POST api/conserto`\n  ```json\n  {\n      \"dataEntrada\": \"19/04/2025\", // obrigatório\n      \"dataSaida\": \"20/04/2025\", // obrigatório\n      \"dadosMecanico\": {\n        \"nome\": \"Mecanico 1\", // obrigatório\n        \"anosDeExperiencia\": 5\n      },\n      \"dadosVeiculo\": {\n        \"marca\": \"bmw\", // obrigatório\n        \"modelo\": \"320i\", // obrigatório\n        \"ano\": \"2025\", // obrigatório\n        \"cor\": \"Vermelho\"\n      }\n  }\n  ```\n\n- `PATCH api/conserto/{id}`\n  ```json\n   {\n      \"dataSaida\": \"20/04/2025\",\n      \"nomeMecanico\": \"Mecanico\",\n      \"anosDeExperiencia\": 0\n   }\n  ```  \n___\n\n## 📝 Licença\nEste projeto tem finalidade educacional e não possui licença de uso específica.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgusmaomatheus%2Fcar-repair-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgusmaomatheus%2Fcar-repair-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgusmaomatheus%2Fcar-repair-api/lists"}