{"id":49915115,"url":"https://github.com/j-adenilson/cadastro-java-springboot","last_synced_at":"2026-05-16T15:43:14.294Z","repository":{"id":328566607,"uuid":"1112695494","full_name":"j-adenilson/cadastro-java-springboot","owner":"j-adenilson","description":"Projeto cadastro de funcionários em Java com Spring Boot","archived":false,"fork":false,"pushed_at":"2026-03-11T00:10:54.000Z","size":60,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-11T04:42:10.867Z","etag":null,"topics":["api","api-rest","docker","docker-compose","flyway","h2-database","java","jpa-hibernate","maven","spring-data-jpa","springboot","sql","swagger"],"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/j-adenilson.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-09T01:22:48.000Z","updated_at":"2026-03-11T00:11:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/j-adenilson/cadastro-java-springboot","commit_stats":null,"previous_names":["j-adenilson/cadastro-java-springboot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/j-adenilson/cadastro-java-springboot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-adenilson%2Fcadastro-java-springboot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-adenilson%2Fcadastro-java-springboot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-adenilson%2Fcadastro-java-springboot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-adenilson%2Fcadastro-java-springboot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j-adenilson","download_url":"https://codeload.github.com/j-adenilson/cadastro-java-springboot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j-adenilson%2Fcadastro-java-springboot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33108364,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["api","api-rest","docker","docker-compose","flyway","h2-database","java","jpa-hibernate","maven","spring-data-jpa","springboot","sql","swagger"],"created_at":"2026-05-16T15:43:13.624Z","updated_at":"2026-05-16T15:43:14.286Z","avatar_url":"https://github.com/j-adenilson.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cadastro de Funcionários\n\nAplicação de exemplo para cadastro e gestão de departamentos e funcionários desenvolvida em Java com Spring Boot. O projeto utiliza arquitetura MVC, com camadas de controllers, serviços e repositórios, além de mapeamentos DTO para separar domínio e apresentação.\n\n## 📦 Tecnologias\n\n- **Linguagem:** Java 17\n- **Framework:** Spring Boot 3.5.8\n- **Camadas:** Spring MVC (controllers, services, repositories)\n- **Persistência:** Spring Data JPA\n- **Banco de dados:** H2 (desenvolvimento/in-memory) e PostgreSQL (runtime)\n- **Migrações:** Flyway\n- **Template Engine:** Thymeleaf\n- **API Documentation:** springdoc-openapi (Swagger UI)\n- **Lombok:** redução de boilerplate (getters/setters, constructors)\n- **Build:** Maven (`mvnw` wrapper incluído)\n\n## 🏗️ Arquitetura e Estrutura de Código\n\nO pacote base é `com.cadastro.CadastroDeFuncionarios`. A organização segue a convenção de camadas:\n\n```\ncom.cadastro.CadastroDeFuncionarios\n├─ Departamentos\n│  ├─ DepartamentosController.java         (API REST)\n│  ├─ DepartamentosControllerUi.java       (UI com Thymeleaf)\n│  ├─ DepartamentosService.java            (lógica de negócio)\n│  ├─ DepartamentosRepository.java         (interface JPA)\n│  ├─ DepartamentosModel.java              (entidade/JPA)\n│  ├─ DepartamentosDTO.java                (objeto de transferência)\n│  └─ DepartamentosMapper.java             (mapstruct ou manual mapeamento)\n├─ Funcionarios\n│  ├─ FuncionariosController.java\n│  ├─ FuncionariosControllerUi.java\n│  ├─ FuncionariosService.java\n│  ├─ FuncionariosRepository.java\n│  ├─ FuncionariosModel.java\n│  ├─ FuncionariosDTO.java\n│  └─ FuncionariosMapper.java\n└─ CadastroDeFuncionariosApplication.java   (ponto de entrada)\n```\n\n- **Controllers**: expõem endpoints REST e páginas Thymeleaf\n- **Services**: regras comerciais e orquestração entre repositórios\n- **Repositories**: abstraem acesso ao BD com Spring Data JPA\n- **Models**: entidades mapeadas para tabelas\n- **DTOs/Mappers**: decouple dos modelos de domínio para transferência de dados\n\n## 🚀 Configuração e Execução\n\n1. **Pré-requisitos**\n   - Java 17 instalado\n   - Docker (opcional, para PostgreSQL)\n\n2. **Banco de dados**\n   - O projeto usa H2 em memória por padrão (configuração em `application.properties`).\n   - Para PostgreSQL, ajuste as propriedades `spring.datasource.url`, `username` e `password`.\n   - As migrações Flyway ficam em `src/main/resources/db/migrations`.\n\n3. **Build \u0026 Run**\n   ```bash\n   ./mvnw clean package\n   java -jar target/cadastroDeFuncionarios-0.0.1-SNAPSHOT.jar\n   ```\n\n4. **Acesso**\n   - Interface web: `http://localhost:8080` (páginas Thymeleaf para listar/cadastrar/editar)\n   - API Swagger: `http://localhost:8080/swagger-ui.html` ou `/swagger-ui/index.html`\n\n## 🛠️ Tools adicionais\n\n- **Flyway**: executa migrações SQL automaticamente na inicialização\n- **Lombok**: anotação `@Data`, `@Builder` etc., certifique-se de instalar plugin no IDE\n\n## 📁 Recursos do projeto\n\n- `docker-compose.yml`: configura serviço PostgreSQL (opcional)\n- `src/main/resources/static/css/style.css`: estilos básicos\n- Templates HTML em `templates/`\n- Migrações SQL em `resources/db/migrations`\n\n## 🧪 Testes\n\nO único teste de exemplo está em `src/test/java/com/cadastro/CadastroDeFuncionarios/CadastroDeFuncionariosApplicationTests.java`.\n\n## 📌 Notas\n\n- Arquitetura simples voltada para aprendizado e prototipagem.\n- Pode ser estendido com autenticação, validações mais robustas e camadas de DTO adicionais.\n\n---\n\n*Projeto criado e mantido por [José Adenilson]*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj-adenilson%2Fcadastro-java-springboot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj-adenilson%2Fcadastro-java-springboot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj-adenilson%2Fcadastro-java-springboot/lists"}