implementa issue #2

Author: soterocra

.github/skills/issue-to-brief/SKILL.md

@@ -1,13 +1,29 @@
 ---
 name: issue-to-brief
-description: Analisa uma issue do GitHub e transforma em um briefing tecnico acionavel para este projeto Spring Boot. Use quando o pedido mencionar issue, ticket, backlog, bug, feature, requisito ou criterios de aceite vindos do GitHub, especialmente antes de implementar com custom agents. Ajuda a ler a issue via MCP, identificar impacto no codigo, preservar contrato HTTP e preparar handoff para refatoracao e testes.
+description: Analisa uma issue do GitHub e transforma em um briefing tecnico acionavel para este projeto Spring Boot. Use antes de implementar, quando o pedido envolver issue, ticket, backlog, bug, feature, requisito ou criterios de aceite, para mapear impacto no codigo, preservar contrato HTTP e preparar handoff para refactor e testes.
+argument-hint: [issue] [contexto adicional] [restricoes ou contrato a preservar]
 ---
 
-# Skill issue-to-brief
+# Issue To Brief
 
-Conduza a etapa de entendimento e preparacao antes da implementacao.
+Esta skill conduz a etapa de entendimento e preparacao antes da implementacao.
 
-## Fluxo
+## Quando usar esta skill
+
+Use esta skill quando precisar:
+
+- ler uma issue do GitHub e converter em briefing tecnico objetivo
+- separar escopo confirmado de suposicoes antes de codar
+- mapear impacto provavel no backend Spring Boot deste repositorio
+- preparar handoff claro para refactor e para testes
+
+Nao use esta skill para resumir o trabalho ja concluido. Nesse caso, use a skill `pr-summary`.
+
+## Objetivo
+
+Reduzir ambiguidade da issue e deixar a implementacao pronta para seguir com contexto suficiente para os proximos agents.
+
+## Procedimento
 
 1. Ler a issue e, se existirem, comentarios, checklist, labels e criterios de aceite via GitHub MCP.
 2. Resumir o objetivo funcional em linguagem direta.
@@ -17,7 +33,7 @@ Conduza a etapa de entendimento e preparacao antes da implementacao.
 6. Preparar um handoff explicito para o custom agent de refatoracao.
 7. Preparar um handoff explicito para o custom agent de testes.
 
-## Estrutura de saida obrigatoria
+## Saida obrigatoria
 
 Responder com estas secoes, nesta ordem:
 
@@ -61,7 +77,7 @@ Handoff para test
 - Evidencias esperadas:
 ```
 
-## Heuristicas para este repositorio
+## Como analisar neste repositorio
 
 Ao analisar impacto provavel, considerar primeiro:
 
@@ -74,6 +90,15 @@ Ao analisar impacto provavel, considerar primeiro:
 - `src/main/java/br/com/devsuperior/dev_xp_ai/util`
 - `src/test/java/br/com/devsuperior/dev_xp_ai`
 
+## Como preencher a saida
+
+- Em `Resumo da issue`, priorize objetivo funcional, contexto operacional e criterios de aceite explicitos.
+- Em `Escopo confirmado`, diferencie pedido explicito de extrapolacao tecnica.
+- Em `Impacto provavel no codigo`, cite apenas camadas plausiveis; se uma camada nao parecer afetada, diga isso.
+- Em `Invariantes e restricoes`, trate contrato HTTP observavel como item critico: path, verbo, status, headers e JSON.
+- Em `Pontos em aberto`, registre lacunas reais antes de sugerir implementacao.
+- Nos handoffs, escreva instrucoes que possam ser usadas diretamente pelos agents `refactor` e `test`.
+
 ## Regras
 
 1. Nao comecar implementando.
@@ -97,6 +122,20 @@ Para o `test`:
 - informar cenarios de sucesso e erro
 - cobrar validacao de status, body, headers e cobertura
 
+## Exemplo de uso
+
+Entrada:
+
+```text
+/issue-to-brief issue #456 sobre ajuste de validacao no endpoint de clientes sem mudar o contrato HTTP
+```
+
+Saida esperada:
+
+- briefing com escopo confirmado e lacunas visiveis
+- impacto provavel no codigo deste projeto
+- handoff claro para refactor e para test
+
 ## Resultado esperado
 
 Um bom resultado reduz ambiguidade da issue e deixa a implementacao pronta para seguir, com contexto suficiente para o agent de refatoracao atuar primeiro e o agent de testes atuar em seguida.

.github/skills/pr-summary/SKILL.md

@@ -1,17 +1,28 @@
 ---
 name: pr-summary
-description: Gera um resumo tecnico final de implementacao pronto para demonstracao, comentario de pull request ou fechamento de tarefa. Use quando o trabalho ja tiver sido implementado e testado, especialmente apos usar custom agents de refatoracao e testes. Ajuda a consolidar mudancas, comandos executados, cobertura, riscos, relacao com a issue e proximos passos sem omitir evidencias.
+description: Gera um resumo tecnico final de implementacao para demo, comentario de pull request ou fechamento de tarefa. Use quando a mudanca ja tiver sido implementada e validada e voce precisar consolidar evidencias, testes, cobertura, riscos e relacao com a issue sem inventar fatos.
+argument-hint: [issue ou contexto] [arquivos alterados] [testes/comandos executados]
 ---
 
-# Skill pr-summary
+# PR Summary
 
-Conduza a etapa final de fechamento tecnico depois da implementacao e da validacao.
+Esta skill conduz o fechamento tecnico depois da implementacao e da validacao.
+
+## Quando usar esta skill
+
+Use esta skill quando precisar:
+
+- transformar uma implementacao concluida em um resumo final apresentavel
+- preparar texto para comentario de PR, demo ou encerramento de tarefa
+- consolidar mudancas, testes executados, cobertura, riscos e pendencias com base em evidencia
+
+Nao use esta skill para entender uma issue antes de implementar. Nesse caso, use a skill `issue-to-brief`.
 
 ## Objetivo
 
-Produzir um resumo final consistente, auditavel e facil de apresentar.
+Produzir um resumo final consistente, auditavel e facil de apresentar, preservando a separacao entre fato observado e inferencia.
 
-## Fluxo
+## Procedimento
 
 1. Reunir o contexto da issue original.
 2. Reunir o que foi alterado no codigo de producao.
@@ -21,7 +32,7 @@ Produzir um resumo final consistente, auditavel e facil de apresentar.
 6. Registrar riscos, limitacoes e pendencias.
 7. Fechar com uma relacao explicita entre issue, implementacao e validacao.
 
-## Estrutura de saida obrigatoria
+## Saida obrigatoria
 
 Responder com estas secoes, nesta ordem:
 
@@ -51,6 +62,14 @@ Pronto para PR
 - Relacao com a issue:
 ```
 
+## Como preencher a saida
+
+- Use apenas fatos que estejam visiveis no contexto, no diff, nos arquivos alterados ou nos resultados de comando.
+- Se algum ponto relevante nao estiver disponivel, diga explicitamente que a evidencia nao foi encontrada.
+- Ao mencionar cobertura, informe numeros somente quando houver relatorio ou saida concreta.
+- Ao mencionar contrato HTTP, deixe claro se o contrato foi preservado ou alterado e cite o que mudou.
+- Ao mencionar riscos, prefira riscos observaveis, regressivos ou de rollout, e nao frases genericas.
+
 ## Regras
 
 1. Nao afirmar execucao, cobertura ou sucesso de testes sem evidencia no contexto.
@@ -59,9 +78,23 @@ Pronto para PR
 4. Se a issue tiver criterios de aceite, dizer como cada um foi atendido ou o que ficou pendente.
 5. Se houve mudanca de contrato HTTP, explicitar de forma objetiva e concreta.
 
+## Exemplo de uso
+
+Entrada:
+
+```text
+/pr-summary issue #123, alteracoes no endpoint de pedidos, testes de integracao executados
+```
+
+Saida esperada:
+
+- resumo final com secoes fixas
+- relacao objetiva entre issue, implementacao e validacao
+- riscos e pendencias explicitados sem exagero
+
 ## Fechamento curto para demonstracao
 
-Quando fizer sentido, terminar com um bloco curto de resumo executivo contendo:
+Quando fizer sentido, termine com um bloco curto de resumo executivo contendo:
 
 - objetivo da issue
 - o que foi implementado

DEMO.md

@@ -110,19 +110,15 @@ Execute os testes relevantes, informe os comandos executados, o resultado e a co
 
 ### Prompt 4: Gerar o fechamento final
 
+Antes faça:
+- altere a branch para `feature/tabela`
+- git add e git commit das mudanças
+- git push
+
 ```text
 Use a skill `pr-summary` #file:.github/skills/pr-summary/SKILL.md  para gerar o fechamento técnico desta execução.
-
-Quero um resumo final com:
-- issue atendida
-- o que foi alterado
-- classes principais afetadas
-- testes criados ou ajustados
-- comandos executados
-- resultado dos testes
-- cobertura JaCoCo
-- riscos e limitações
-- um resumo curto pronto para PR
+O commit e push já foi feito, mapeie a branch atual e seguida para próxima tarefa.
+Faça o PR dessa branch para a main, usando via GitHub MCP, usando o resumo curto gerado e referenciando a issue #2.
 ```
 
 ## O que observar durante a apresentação

…or/dev_xp_ai/entity/DeveloperEntity.java …ai/entity/DeveloperExperienceEntity.javasrc/main/java/br/com/devsuperior/dev_xp_ai/entity/DeveloperEntity.java renamed to src/main/java/br/com/devsuperior/dev_xp_ai/entity/DeveloperExperienceEntity.java src/main/java/br/com/devsuperior/dev_xp_ai/entity/DeveloperEntity.java renamed to src/main/java/br/com/devsuperior/dev_xp_ai/entity/DeveloperExperienceEntity.java

@@ -4,23 +4,14 @@
 import org.springframework.data.relational.core.mapping.Column;
 import org.springframework.data.relational.core.mapping.Table;
 
-@Table("tb_developer")
-public class DeveloperEntity {
+@Table("tb_developer_experience")
+public class DeveloperExperienceEntity {
 
     @Id
     private Long id;
 
-    @Column("full_name")
-    private String fullName;
-
-    @Column("email")
-    private String email;
-
-    @Column("nickname")
-    private String nickname;
-
-    @Column("uf")
-    private String uf;
+    @Column("user_id")
+    private Long userId;
 
     @Column("years_of_experience")
     private Integer yearsOfExperience;
@@ -34,17 +25,13 @@ public class DeveloperEntity {
     @Column("skills")
     private String skills;
 
-    public DeveloperEntity() {
+    public DeveloperExperienceEntity() {
     }
 
-    public DeveloperEntity(Long id, String fullName, String email, String nickname,
-                           String uf, Integer yearsOfExperience, String primaryLanguage,
-                           Boolean interestedInAi, String skills) {
+    public DeveloperExperienceEntity(Long id, Long userId, Integer yearsOfExperience,
+                                     String primaryLanguage, Boolean interestedInAi, String skills) {
         this.id = id;
-        this.fullName = fullName;
-        this.email = email;
-        this.nickname = nickname;
-        this.uf = uf;
+        this.userId = userId;
         this.yearsOfExperience = yearsOfExperience;
         this.primaryLanguage = primaryLanguage;
         this.interestedInAi = interestedInAi;
@@ -54,17 +41,8 @@ public DeveloperEntity(Long id, String fullName, String email, String nickname,
     public Long getId() { return id; }
     public void setId(Long id) { this.id = id; }
 
-    public String getFullName() { return fullName; }
-    public void setFullName(String fullName) { this.fullName = fullName; }
-
-    public String getEmail() { return email; }
-    public void setEmail(String email) { this.email = email; }
-
-    public String getNickname() { return nickname; }
-    public void setNickname(String nickname) { this.nickname = nickname; }
-
-    public String getUf() { return uf; }
-    public void setUf(String uf) { this.uf = uf; }
+    public Long getUserId() { return userId; }
+    public void setUserId(Long userId) { this.userId = userId; }
 
     public Integer getYearsOfExperience() { return yearsOfExperience; }
     public void setYearsOfExperience(Integer yearsOfExperience) { this.yearsOfExperience = yearsOfExperience; }

src/main/java/br/com/devsuperior/dev_xp_ai/entity/DeveloperUserEntity.java

@@ -0,0 +1,52 @@
+package br.com.devsuperior.dev_xp_ai.entity;
+
+import org.springframework.data.annotation.Id;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+@Table("tb_developer")
+public class DeveloperUserEntity {
+
+    @Id
+    private Long id;
+
+    @Column("full_name")
+    private String fullName;
+
+    @Column("email")
+    private String email;
+
+    @Column("nickname")
+    private String nickname;
+
+    @Column("uf")
+    private String uf;
+
+    public DeveloperUserEntity() {
+    }
+
+    public DeveloperUserEntity(Long id, String fullName, String email, String nickname, String uf) {
+        this.id = id;
+        this.fullName = fullName;
+        this.email = email;
+        this.nickname = nickname;
+        this.uf = uf;
+    }
+
+    public Long getId() { return id; }
+    public void setId(Long id) { this.id = id; }
+
+    public String getFullName() { return fullName; }
+    public void setFullName(String fullName) { this.fullName = fullName; }
+
+    public String getEmail() { return email; }
+    public void setEmail(String email) { this.email = email; }
+
+    public String getNickname() { return nickname; }
+    public void setNickname(String nickname) { this.nickname = nickname; }
+
+    public String getUf() { return uf; }
+    public void setUf(String uf) { this.uf = uf; }
+}
+
+

src/main/java/br/com/devsuperior/dev_xp_ai/repository/DeveloperExperienceRepository.java

@@ -0,0 +1,27 @@
+package br.com.devsuperior.dev_xp_ai.repository;
+
+import br.com.devsuperior.dev_xp_ai.entity.DeveloperExperienceEntity;
+import org.springframework.data.jdbc.repository.query.Query;
+import org.springframework.data.repository.CrudRepository;
+import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface DeveloperExperienceRepository extends CrudRepository<DeveloperExperienceEntity, Long> {
+
+    Optional<DeveloperExperienceEntity> findByUserId(Long userId);
+
+    @Query("""
+            SELECT e.* FROM tb_developer_experience e
+            INNER JOIN tb_developer u ON u.id = e.user_id
+            WHERE (:uf IS NULL OR u.uf = :uf)
+              AND (:language IS NULL OR LOWER(e.primary_language) = LOWER(:language))
+            ORDER BY u.id
+            """)
+    List<DeveloperExperienceEntity> findAllByFilters(@Param("uf") String uf, @Param("language") String language);
+}
+
+

src/main/java/br/com/devsuperior/dev_xp_ai/repository/DeveloperRepository.java

@@ -0,0 +1,14 @@
+package br.com.devsuperior.dev_xp_ai.repository;
+
+import br.com.devsuperior.dev_xp_ai.entity.DeveloperUserEntity;
+import org.springframework.data.repository.CrudRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface DeveloperUserRepository extends CrudRepository<DeveloperUserEntity, Long> {
+
+    boolean existsByEmailIgnoreCase(String email);
+
+    boolean existsByNicknameIgnoreCase(String nickname);
+}
+