adi_dev_workflow 1.1.1 → 1.3.0

package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/without_skill/outputs/response.md

@@ -1,452 +1,452 @@
-# TASK PLAN — Adicionar Telefone ao Usuario v1
-
-## 1. Identificacao
-
-| Campo | Valor |
-|-------|-------|
-| **Feature** | Adicionar Telefone ao Modulo de Usuario |
-| **Versao** | v1 |
-| **Data** | 2026-03-07 |
-| **SPEC_TECH** | docs/feature-telefone-usuario/v1/spec_tech.md |
-| **Branch base** | user-feature |
-
-## 2. Resumo
-
-Adicionar o campo opcional `telefone` na tabela `usuarios` e propagar a mudanca por todas as camadas: migracao SQL, queries SQLC, repository, service, proto e handler gRPC. Inclui validacao opcional (10-15 caracteres quando informado) e testes unitarios.
-
-## 3. Tarefas
-
-### TASK-1: Criar migracao SQL para adicionar coluna telefone
-
-**Camada:** Banco de Dados
-**Arquivo a criar:** `internal/db/migrations/002_add_telefone_usuarios.sql`
-**Descricao:**
-Criar nova migracao com `ALTER TABLE usuarios ADD COLUMN telefone TEXT;`. Conforme regra de imutabilidade, nao editar a migracao 001 existente.
-
-**Conteudo esperado:**
-```sql
-ALTER TABLE usuarios ADD COLUMN telefone TEXT;
-```
-
-**Criterio de aceite:**
-- Arquivo criado em `internal/db/migrations/002_add_telefone_usuarios.sql`
-- Migracao 001 inalterada
-- Coluna `telefone` do tipo `TEXT` (nullable/opcional)
-
-**Dependencias:** Nenhuma
-
----
-
-### TASK-2: Atualizar queries SQLC para incluir telefone
-
-**Camada:** SQLC Queries
-**Arquivo a editar:** `internal/db/sqlc/queries/user.sql`
-**Descricao:**
-Adicionar a coluna `telefone` na query `CreateUser` (INSERT e parametros) e criar uma nova query `UpdateUser` que permita atualizar nome e telefone.
-
-**Alteracoes esperadas:**
-
-Query `CreateUser` atualizada:
-```sql
--- name: CreateUser :one
-INSERT INTO usuarios (id, nome, email, senha_hash, telefone, data_criacao, data_atualizacao)
-VALUES (?, ?, ?, ?, ?, ?, ?)
-RETURNING *;
-```
-
-Nova query `UpdateUser`:
-```sql
--- name: UpdateUser :one
-UPDATE usuarios SET nome = ?, telefone = ?, data_atualizacao = ?
-WHERE id = ?
-RETURNING *;
-```
-
-**Criterio de aceite:**
-- Query `CreateUser` inclui coluna `telefone`
-- Nova query `UpdateUser` criada
-- Executar `make generate` (ou `make sqlc`) apos a edicao para regenerar codigo
-
-**Dependencias:** TASK-1
-
----
-
-### TASK-3: Regenerar codigo SQLC
-
-**Camada:** Codigo Gerado
-**Descricao:**
-Executar `make generate` para que o SQLC regenere os arquivos Go em `internal/db/sqlc/` com a nova coluna `telefone` e a nova query `UpdateUser`.
-
-**Comando:**
-```bash
-make generate
-```
-
-**Criterio de aceite:**
-- Struct `Usuario` gerada inclui campo `Telefone`
-- Struct `CreateUserParams` inclui campo `Telefone`
-- Struct `UpdateUserParams` gerada
-- Funcao `UpdateUser` gerada em queries
-
-**Dependencias:** TASK-1, TASK-2
-
----
-
-### TASK-4: Atualizar modelo e repository do usuario
-
-**Camada:** Repository
-**Arquivo a editar:** `internal/repository/user_repository.go`
-**Descricao:**
-Adicionar campo `Phone` ao modelo `User`. Atualizar o mapeamento na funcao `toUser` para converter `telefone` (banco) para `Phone` (Go). Atualizar `Create` para passar `telefone` nos parametros SQLC. Adicionar metodo `Update` na interface e implementacao.
-
-**Alteracoes esperadas:**
-
-1. Adicionar campo na struct:
-```go
-type User struct {
-    ID           string
-    Name         string
-    Email        string
-    PasswordHash string
-    Phone        string    // novo campo
-    CreatedAt    time.Time
-    UpdatedAt    time.Time
-}
-```
-
-2. Atualizar interface:
-```go
-type UserRepository interface {
-    Create(ctx context.Context, user *User) (*User, error)
-    GetByID(ctx context.Context, id string) (*User, error)
-    Update(ctx context.Context, user *User) (*User, error)  // novo metodo
-}
-```
-
-3. Atualizar `Create` para incluir `Telefone` nos params SQLC
-4. Implementar metodo `Update` usando `r.queries.UpdateUser`
-5. Atualizar funcao `toUser` para mapear `Telefone` -> `Phone`
-
-**Criterio de aceite:**
-- Campo `Phone` presente no modelo `User`
-- Mapeamento `Telefone` <-> `Phone` funcional em `toUser`
-- Metodo `Update` implementado
-- `Create` passa `telefone` para o SQLC
-
-**Dependencias:** TASK-3
-
----
-
-### TASK-5: Atualizar service do usuario
-
-**Camada:** Service
-**Arquivo a editar:** `internal/service/user_service.go`
-**Descricao:**
-Adicionar campo `Phone` ao `CreateUserInput`. Criar struct `UpdateUserInput`. Adicionar metodo `UpdateUser` na interface e implementacao. Implementar validacao: se `phone` informado, deve ter entre 10 e 15 caracteres.
-
-**Alteracoes esperadas:**
-
-1. Atualizar input de criacao:
-```go
-type CreateUserInput struct {
-    Name     string
-    Email    string
-    Password string
-    Phone    string  // novo, opcional
-}
-```
-
-2. Criar input de atualizacao:
-```go
-type UpdateUserInput struct {
-    ID    string
-    Name  string
-    Phone string  // opcional
-}
-```
-
-3. Atualizar interface:
-```go
-type UserService interface {
-    CreateUser(ctx context.Context, input CreateUserInput) (*repository.User, error)
-    GetUser(ctx context.Context, id string) (*repository.User, error)
-    UpdateUser(ctx context.Context, input UpdateUserInput) (*repository.User, error)  // novo
-}
-```
-
-4. Adicionar validacao de telefone (reutilizavel em Create e Update):
-```go
-func validatePhone(phone string) error {
-    if phone != "" && (len(phone) < 10 || len(phone) > 15) {
-        return errors.New("telefone deve ter entre 10 e 15 caracteres")
-    }
-    return nil
-}
-```
-
-5. Chamar `validatePhone` em `CreateUser` e `UpdateUser`
-6. Passar `Phone` para `repository.User` em `CreateUser`
-7. Implementar `UpdateUser` com busca por ID + chamada ao repo
-
-**Criterio de aceite:**
-- Campo `Phone` aceito em `CreateUser`
-- Metodo `UpdateUser` implementado
-- Validacao de telefone (10-15 chars) funcional
-- Telefone vazio e aceito (campo opcional)
-
-**Dependencias:** TASK-4
-
----
-
-### TASK-6: Atualizar definicao Proto
-
-**Camada:** Proto/gRPC
-**Arquivo a editar:** `api/proto/v1/user.proto`
-**Descricao:**
-Adicionar campo `string phone` nas mensagens `CreateUserRequest`, `CreateUserResponse`, `GetUserResponse`. Criar mensagens `UpdateUserRequest` e `UpdateUserResponse`. Adicionar RPC `UpdateUser` ao service.
-
-**Alteracoes esperadas:**
-
-1. Adicionar `string phone = 4;` em `CreateUserRequest`
-2. Adicionar `string phone = 4;` em `CreateUserResponse` (apos `email`, ajustar numeracao de `created_at` para 5)
-3. Adicionar `string phone = 4;` em `GetUserResponse` (apos `email`, ajustar numeracao: `phone=4`, `created_at=5`, `updated_at=6`)
-
-> **ATENCAO:** A numeracao dos campos existentes NAO pode ser alterada sem quebrar compatibilidade. Verificar a numeracao atual antes de definir os novos numeros. Dado que `CreateUserResponse` ja usa campos 1-4 e `GetUserResponse` usa 1-5, o campo `phone` deve usar o proximo numero disponivel em cada mensagem.
-
-Numeracao correta baseada no proto atual:
-- `CreateUserRequest`: `string phone = 4;` (campos existentes: 1=name, 2=email, 3=password)
-- `CreateUserResponse`: `string phone = 5;` (campos existentes: 1=id, 2=name, 3=email, 4=created_at)
-- `GetUserResponse`: `string phone = 6;` (campos existentes: 1=id, 2=name, 3=email, 4=created_at, 5=updated_at)
-
-4. Criar mensagens novas:
-```proto
-message UpdateUserRequest {
-  string id = 1;
-  string name = 2;
-  string phone = 3;
-}
-
-message UpdateUserResponse {
-  string id = 1;
-  string name = 2;
-  string email = 3;
-  string phone = 4;
-  string updated_at = 5;
-}
-```
-
-5. Adicionar ao service:
-```proto
-rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
-```
-
-**Criterio de aceite:**
-- Campo `phone` adicionado nas mensagens existentes com numeracao correta
-- Mensagens `UpdateUserRequest`/`UpdateUserResponse` criadas
-- RPC `UpdateUser` registrado no service
-- Numeracao de campos existentes NAO alterada
-
-**Dependencias:** Nenhuma (pode ser feita em paralelo com TASK-1 a TASK-5)
-
----
-
-### TASK-7: Regenerar codigo Proto
-
-**Camada:** Codigo Gerado
-**Descricao:**
-Executar `make generate` (buf generate) para regenerar o codigo Go em `gen/proto/v1/`.
-
-**Comando:**
-```bash
-make generate
-```
-
-**Criterio de aceite:**
-- Structs Go geradas incluem campo `Phone`
-- Interface `UserServiceServer` inclui metodo `UpdateUser`
-- Compilacao sem erros
-
-**Dependencias:** TASK-6
-
----
-
-### TASK-8: Atualizar handler gRPC do usuario
-
-**Camada:** Handler
-**Arquivo a editar:** `internal/handler/grpc/user_handler.go`
-**Descricao:**
-Atualizar `CreateUser` para passar `Phone` do request para o service input e incluir `phone` na response. Implementar metodo `UpdateUser`. Atualizar `GetUser` para incluir `phone` na response.
-
-**Alteracoes esperadas:**
-
-1. Em `CreateUser`:
-   - Adicionar `Phone: req.GetPhone()` ao `CreateUserInput`
-   - Adicionar `Phone: user.Phone` na response
-
-2. Em `GetUser`:
-   - Adicionar `Phone: user.Phone` na response
-
-3. Novo metodo `UpdateUser`:
-```go
-func (h *UserHandler) UpdateUser(ctx context.Context, req *pb.UpdateUserRequest) (*pb.UpdateUserResponse, error) {
-    input := service.UpdateUserInput{
-        ID:    req.GetId(),
-        Name:  req.GetName(),
-        Phone: req.GetPhone(),
-    }
-    user, err := h.userService.UpdateUser(ctx, input)
-    if err != nil {
-        return nil, mapServiceError(err)
-    }
-    return &pb.UpdateUserResponse{
-        Id:        user.ID,
-        Name:      user.Name,
-        Email:     user.Email,
-        Phone:     user.Phone,
-        UpdatedAt: user.UpdatedAt.Format(time.RFC3339),
-    }, nil
-}
-```
-
-**Criterio de aceite:**
-- `CreateUser` repassa e retorna `phone`
-- `GetUser` retorna `phone`
-- `UpdateUser` implementado e funcional
-- Erros mapeados corretamente
-
-**Dependencias:** TASK-5, TASK-7
-
----
-
-### TASK-9: Configurar UpdateUser como rota protegida
-
-**Camada:** Configuracao
-**Arquivo a verificar:** `configs/config.yaml`
-**Descricao:**
-Verificar que `UpdateUser` NAO esta em `skip_methods` (ou seja, requer autenticacao). Apenas `CreateUser` deve ser publico. Se necessario, nenhuma alteracao e necessaria, apenas confirmar.
-
-**Criterio de aceite:**
-- `UpdateUser` exige autenticacao (Bearer token)
-- Nenhuma rota protegida acidentalmente exposta
-
-**Dependencias:** TASK-8
-
----
-
-### TASK-10: Atualizar testes unitarios do service
-
-**Camada:** Testes
-**Arquivo a editar:** `internal/service/user_service_test.go`
-**Descricao:**
-Atualizar mock do repository para incluir metodo `Update`. Adicionar testes para:
-
-1. `TestCreateUser_WithPhone_Success` — criacao com telefone valido
-2. `TestCreateUser_WithInvalidPhone_TooShort` — telefone com menos de 10 chars
-3. `TestCreateUser_WithInvalidPhone_TooLong` — telefone com mais de 15 chars
-4. `TestCreateUser_WithEmptyPhone_Success` — telefone vazio (opcional)
-5. `TestUpdateUser_Success` — atualizacao com dados validos
-6. `TestUpdateUser_WithPhone_Success` — atualizacao com telefone valido
-7. `TestUpdateUser_InvalidPhone` — telefone invalido na atualizacao
-8. `TestUpdateUser_NotFound` — usuario nao encontrado
-
-**Criterio de aceite:**
-- Mock atualizado com metodo `Update`
-- Todos os cenarios de telefone cobertos (valido, vazio, curto, longo)
-- Testes de `UpdateUser` adicionados
-- Todos os testes passam: `CGO_ENABLED=1 go test ./internal/service/... -v`
-
-**Dependencias:** TASK-5
-
----
-
-### TASK-11: Atualizar testes unitarios do handler
-
-**Camada:** Testes
-**Arquivo a editar:** `internal/handler/grpc/user_handler_test.go`
-**Descricao:**
-Atualizar mock do service para incluir metodo `UpdateUser`. Adicionar testes para:
-
-1. `TestUserHandler_CreateUser_WithPhone` — verifica que phone e repassado e retornado
-2. `TestUserHandler_GetUser_WithPhone` — verifica que phone e retornado
-3. `TestUserHandler_UpdateUser_Success` — atualizacao com sucesso
-4. `TestUserHandler_UpdateUser_NotFound` — usuario nao encontrado
-5. `TestUserHandler_UpdateUser_InvalidPhone` — telefone invalido
-
-**Criterio de aceite:**
-- Mock atualizado com metodo `UpdateUser`
-- Testes de phone no CreateUser e GetUser
-- Testes de UpdateUser cobrindo sucesso e erros
-- Todos os testes passam: `CGO_ENABLED=1 go test ./internal/handler/grpc/... -v`
-
-**Dependencias:** TASK-8
-
----
-
-### TASK-12: Teste de integracao e validacao final
-
-**Camada:** Validacao
-**Descricao:**
-Executar build e suite completa de testes para garantir que tudo funciona junto.
-
-**Comandos:**
-```bash
-make build
-make test
-```
-
-**Criterio de aceite:**
-- Build compila sem erros
-- Todos os testes passam
-- Nenhuma regressao nos testes existentes
-
-**Dependencias:** TASK-10, TASK-11
-
----
-
-## 4. Grafo de Dependencias
-
-```
-TASK-1 (migracao SQL)
-  └─> TASK-2 (queries SQLC)
-        └─> TASK-3 (make generate - SQLC)
-              └─> TASK-4 (repository)
-                    └─> TASK-5 (service)
-                          ├─> TASK-8 (handler) [+ TASK-7]
-                          └─> TASK-10 (testes service)
-
-TASK-6 (proto) [paralelo com TASK-1..5]
-  └─> TASK-7 (make generate - proto)
-        └─> TASK-8 (handler)
-              ├─> TASK-9 (config auth)
-              └─> TASK-11 (testes handler)
-
-TASK-10 + TASK-11
-  └─> TASK-12 (validacao final)
-```
-
-## 5. Ordem de Execucao Sugerida
-
-| Fase | Tasks | Descricao |
-|------|-------|-----------|
-| **Fase 1** | TASK-1, TASK-6 | Migracao SQL + Proto (paralelo) |
-| **Fase 2** | TASK-2 | Queries SQLC |
-| **Fase 3** | TASK-3, TASK-7 | Regenerar codigo (SQLC + Proto) — executar `make generate` uma unica vez |
-| **Fase 4** | TASK-4 | Repository |
-| **Fase 5** | TASK-5 | Service |
-| **Fase 6** | TASK-8, TASK-9 | Handler + Config |
-| **Fase 7** | TASK-10, TASK-11 | Testes (paralelo) |
-| **Fase 8** | TASK-12 | Validacao final |
-
-## 6. Riscos e Observacoes
-
-1. **Numeracao Proto:** A numeracao dos campos proto existentes NAO pode ser alterada. O campo `phone` deve usar o proximo numero livre em cada mensagem. Isso e critico para compatibilidade.
-
-2. **Migracao imutavel:** A migracao 001 NAO deve ser editada. Sempre criar nova migracao (002).
-
-3. **Codigo gerado:** Nunca editar arquivos em `gen/` ou `internal/db/sqlc/*.go`. Sempre editar os fontes (`.proto`, `.sql`) e rodar `make generate`.
-
-4. **Campo opcional:** O campo `telefone` e `TEXT` nullable no SQLite. No Go, o SQLC pode gerar como `sql.NullString` — verificar apos geracao e ajustar mapeamento no repository conforme necessario.
-
-5. **UpdateUser e novo:** O proto atual nao tem `UpdateUser`. E necessario criar o RPC, mensagens e implementar em todas as camadas. A SPEC_TECH menciona "UpdateUser" mas o codebase atual nao possui esse endpoint.
-
-6. **`make generate`:** Os comandos `make generate` das TASK-3 e TASK-7 podem ser executados em uma unica chamada se o Makefile gerar tanto SQLC quanto Proto.
+# TASK PLAN — Adicionar Telefone ao Usuario v1
+
+## 1. Identificacao
+
+| Campo | Valor |
+|-------|-------|
+| **Feature** | Adicionar Telefone ao Modulo de Usuario |
+| **Versao** | v1 |
+| **Data** | 2026-03-07 |
+| **SPEC_TECH** | docs/feature-telefone-usuario/v1/spec_tech.md |
+| **Branch base** | user-feature |
+
+## 2. Resumo
+
+Adicionar o campo opcional `telefone` na tabela `usuarios` e propagar a mudanca por todas as camadas: migracao SQL, queries SQLC, repository, service, proto e handler gRPC. Inclui validacao opcional (10-15 caracteres quando informado) e testes unitarios.
+
+## 3. Tarefas
+
+### TASK-1: Criar migracao SQL para adicionar coluna telefone
+
+**Camada:** Banco de Dados
+**Arquivo a criar:** `internal/db/migrations/002_add_telefone_usuarios.sql`
+**Descricao:**
+Criar nova migracao com `ALTER TABLE usuarios ADD COLUMN telefone TEXT;`. Conforme regra de imutabilidade, nao editar a migracao 001 existente.
+
+**Conteudo esperado:**
+```sql
+ALTER TABLE usuarios ADD COLUMN telefone TEXT;
+```
+
+**Criterio de aceite:**
+- Arquivo criado em `internal/db/migrations/002_add_telefone_usuarios.sql`
+- Migracao 001 inalterada
+- Coluna `telefone` do tipo `TEXT` (nullable/opcional)
+
+**Dependencias:** Nenhuma
+
+---
+
+### TASK-2: Atualizar queries SQLC para incluir telefone
+
+**Camada:** SQLC Queries
+**Arquivo a editar:** `internal/db/sqlc/queries/user.sql`
+**Descricao:**
+Adicionar a coluna `telefone` na query `CreateUser` (INSERT e parametros) e criar uma nova query `UpdateUser` que permita atualizar nome e telefone.
+
+**Alteracoes esperadas:**
+
+Query `CreateUser` atualizada:
+```sql
+-- name: CreateUser :one
+INSERT INTO usuarios (id, nome, email, senha_hash, telefone, data_criacao, data_atualizacao)
+VALUES (?, ?, ?, ?, ?, ?, ?)
+RETURNING *;
+```
+
+Nova query `UpdateUser`:
+```sql
+-- name: UpdateUser :one
+UPDATE usuarios SET nome = ?, telefone = ?, data_atualizacao = ?
+WHERE id = ?
+RETURNING *;
+```
+
+**Criterio de aceite:**
+- Query `CreateUser` inclui coluna `telefone`
+- Nova query `UpdateUser` criada
+- Executar `make generate` (ou `make sqlc`) apos a edicao para regenerar codigo
+
+**Dependencias:** TASK-1
+
+---
+
+### TASK-3: Regenerar codigo SQLC
+
+**Camada:** Codigo Gerado
+**Descricao:**
+Executar `make generate` para que o SQLC regenere os arquivos Go em `internal/db/sqlc/` com a nova coluna `telefone` e a nova query `UpdateUser`.
+
+**Comando:**
+```bash
+make generate
+```
+
+**Criterio de aceite:**
+- Struct `Usuario` gerada inclui campo `Telefone`
+- Struct `CreateUserParams` inclui campo `Telefone`
+- Struct `UpdateUserParams` gerada
+- Funcao `UpdateUser` gerada em queries
+
+**Dependencias:** TASK-1, TASK-2
+
+---
+
+### TASK-4: Atualizar modelo e repository do usuario
+
+**Camada:** Repository
+**Arquivo a editar:** `internal/repository/user_repository.go`
+**Descricao:**
+Adicionar campo `Phone` ao modelo `User`. Atualizar o mapeamento na funcao `toUser` para converter `telefone` (banco) para `Phone` (Go). Atualizar `Create` para passar `telefone` nos parametros SQLC. Adicionar metodo `Update` na interface e implementacao.
+
+**Alteracoes esperadas:**
+
+1. Adicionar campo na struct:
+```go
+type User struct {
+    ID           string
+    Name         string
+    Email        string
+    PasswordHash string
+    Phone        string    // novo campo
+    CreatedAt    time.Time
+    UpdatedAt    time.Time
+}
+```
+
+2. Atualizar interface:
+```go
+type UserRepository interface {
+    Create(ctx context.Context, user *User) (*User, error)
+    GetByID(ctx context.Context, id string) (*User, error)
+    Update(ctx context.Context, user *User) (*User, error)  // novo metodo
+}
+```
+
+3. Atualizar `Create` para incluir `Telefone` nos params SQLC
+4. Implementar metodo `Update` usando `r.queries.UpdateUser`
+5. Atualizar funcao `toUser` para mapear `Telefone` -> `Phone`
+
+**Criterio de aceite:**
+- Campo `Phone` presente no modelo `User`
+- Mapeamento `Telefone` <-> `Phone` funcional em `toUser`
+- Metodo `Update` implementado
+- `Create` passa `telefone` para o SQLC
+
+**Dependencias:** TASK-3
+
+---
+
+### TASK-5: Atualizar service do usuario
+
+**Camada:** Service
+**Arquivo a editar:** `internal/service/user_service.go`
+**Descricao:**
+Adicionar campo `Phone` ao `CreateUserInput`. Criar struct `UpdateUserInput`. Adicionar metodo `UpdateUser` na interface e implementacao. Implementar validacao: se `phone` informado, deve ter entre 10 e 15 caracteres.
+
+**Alteracoes esperadas:**
+
+1. Atualizar input de criacao:
+```go
+type CreateUserInput struct {
+    Name     string
+    Email    string
+    Password string
+    Phone    string  // novo, opcional
+}
+```
+
+2. Criar input de atualizacao:
+```go
+type UpdateUserInput struct {
+    ID    string
+    Name  string
+    Phone string  // opcional
+}
+```
+
+3. Atualizar interface:
+```go
+type UserService interface {
+    CreateUser(ctx context.Context, input CreateUserInput) (*repository.User, error)
+    GetUser(ctx context.Context, id string) (*repository.User, error)
+    UpdateUser(ctx context.Context, input UpdateUserInput) (*repository.User, error)  // novo
+}
+```
+
+4. Adicionar validacao de telefone (reutilizavel em Create e Update):
+```go
+func validatePhone(phone string) error {
+    if phone != "" && (len(phone) < 10 || len(phone) > 15) {
+        return errors.New("telefone deve ter entre 10 e 15 caracteres")
+    }
+    return nil
+}
+```
+
+5. Chamar `validatePhone` em `CreateUser` e `UpdateUser`
+6. Passar `Phone` para `repository.User` em `CreateUser`
+7. Implementar `UpdateUser` com busca por ID + chamada ao repo
+
+**Criterio de aceite:**
+- Campo `Phone` aceito em `CreateUser`
+- Metodo `UpdateUser` implementado
+- Validacao de telefone (10-15 chars) funcional
+- Telefone vazio e aceito (campo opcional)
+
+**Dependencias:** TASK-4
+
+---
+
+### TASK-6: Atualizar definicao Proto
+
+**Camada:** Proto/gRPC
+**Arquivo a editar:** `api/proto/v1/user.proto`
+**Descricao:**
+Adicionar campo `string phone` nas mensagens `CreateUserRequest`, `CreateUserResponse`, `GetUserResponse`. Criar mensagens `UpdateUserRequest` e `UpdateUserResponse`. Adicionar RPC `UpdateUser` ao service.
+
+**Alteracoes esperadas:**
+
+1. Adicionar `string phone = 4;` em `CreateUserRequest`
+2. Adicionar `string phone = 4;` em `CreateUserResponse` (apos `email`, ajustar numeracao de `created_at` para 5)
+3. Adicionar `string phone = 4;` em `GetUserResponse` (apos `email`, ajustar numeracao: `phone=4`, `created_at=5`, `updated_at=6`)
+
+> **ATENCAO:** A numeracao dos campos existentes NAO pode ser alterada sem quebrar compatibilidade. Verificar a numeracao atual antes de definir os novos numeros. Dado que `CreateUserResponse` ja usa campos 1-4 e `GetUserResponse` usa 1-5, o campo `phone` deve usar o proximo numero disponivel em cada mensagem.
+
+Numeracao correta baseada no proto atual:
+- `CreateUserRequest`: `string phone = 4;` (campos existentes: 1=name, 2=email, 3=password)
+- `CreateUserResponse`: `string phone = 5;` (campos existentes: 1=id, 2=name, 3=email, 4=created_at)
+- `GetUserResponse`: `string phone = 6;` (campos existentes: 1=id, 2=name, 3=email, 4=created_at, 5=updated_at)
+
+4. Criar mensagens novas:
+```proto
+message UpdateUserRequest {
+  string id = 1;
+  string name = 2;
+  string phone = 3;
+}
+
+message UpdateUserResponse {
+  string id = 1;
+  string name = 2;
+  string email = 3;
+  string phone = 4;
+  string updated_at = 5;
+}
+```
+
+5. Adicionar ao service:
+```proto
+rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
+```
+
+**Criterio de aceite:**
+- Campo `phone` adicionado nas mensagens existentes com numeracao correta
+- Mensagens `UpdateUserRequest`/`UpdateUserResponse` criadas
+- RPC `UpdateUser` registrado no service
+- Numeracao de campos existentes NAO alterada
+
+**Dependencias:** Nenhuma (pode ser feita em paralelo com TASK-1 a TASK-5)
+
+---
+
+### TASK-7: Regenerar codigo Proto
+
+**Camada:** Codigo Gerado
+**Descricao:**
+Executar `make generate` (buf generate) para regenerar o codigo Go em `gen/proto/v1/`.
+
+**Comando:**
+```bash
+make generate
+```
+
+**Criterio de aceite:**
+- Structs Go geradas incluem campo `Phone`
+- Interface `UserServiceServer` inclui metodo `UpdateUser`
+- Compilacao sem erros
+
+**Dependencias:** TASK-6
+
+---
+
+### TASK-8: Atualizar handler gRPC do usuario
+
+**Camada:** Handler
+**Arquivo a editar:** `internal/handler/grpc/user_handler.go`
+**Descricao:**
+Atualizar `CreateUser` para passar `Phone` do request para o service input e incluir `phone` na response. Implementar metodo `UpdateUser`. Atualizar `GetUser` para incluir `phone` na response.
+
+**Alteracoes esperadas:**
+
+1. Em `CreateUser`:
+   - Adicionar `Phone: req.GetPhone()` ao `CreateUserInput`
+   - Adicionar `Phone: user.Phone` na response
+
+2. Em `GetUser`:
+   - Adicionar `Phone: user.Phone` na response
+
+3. Novo metodo `UpdateUser`:
+```go
+func (h *UserHandler) UpdateUser(ctx context.Context, req *pb.UpdateUserRequest) (*pb.UpdateUserResponse, error) {
+    input := service.UpdateUserInput{
+        ID:    req.GetId(),
+        Name:  req.GetName(),
+        Phone: req.GetPhone(),
+    }
+    user, err := h.userService.UpdateUser(ctx, input)
+    if err != nil {
+        return nil, mapServiceError(err)
+    }
+    return &pb.UpdateUserResponse{
+        Id:        user.ID,
+        Name:      user.Name,
+        Email:     user.Email,
+        Phone:     user.Phone,
+        UpdatedAt: user.UpdatedAt.Format(time.RFC3339),
+    }, nil
+}
+```
+
+**Criterio de aceite:**
+- `CreateUser` repassa e retorna `phone`
+- `GetUser` retorna `phone`
+- `UpdateUser` implementado e funcional
+- Erros mapeados corretamente
+
+**Dependencias:** TASK-5, TASK-7
+
+---
+
+### TASK-9: Configurar UpdateUser como rota protegida
+
+**Camada:** Configuracao
+**Arquivo a verificar:** `configs/config.yaml`
+**Descricao:**
+Verificar que `UpdateUser` NAO esta em `skip_methods` (ou seja, requer autenticacao). Apenas `CreateUser` deve ser publico. Se necessario, nenhuma alteracao e necessaria, apenas confirmar.
+
+**Criterio de aceite:**
+- `UpdateUser` exige autenticacao (Bearer token)
+- Nenhuma rota protegida acidentalmente exposta
+
+**Dependencias:** TASK-8
+
+---
+
+### TASK-10: Atualizar testes unitarios do service
+
+**Camada:** Testes
+**Arquivo a editar:** `internal/service/user_service_test.go`
+**Descricao:**
+Atualizar mock do repository para incluir metodo `Update`. Adicionar testes para:
+
+1. `TestCreateUser_WithPhone_Success` — criacao com telefone valido
+2. `TestCreateUser_WithInvalidPhone_TooShort` — telefone com menos de 10 chars
+3. `TestCreateUser_WithInvalidPhone_TooLong` — telefone com mais de 15 chars
+4. `TestCreateUser_WithEmptyPhone_Success` — telefone vazio (opcional)
+5. `TestUpdateUser_Success` — atualizacao com dados validos
+6. `TestUpdateUser_WithPhone_Success` — atualizacao com telefone valido
+7. `TestUpdateUser_InvalidPhone` — telefone invalido na atualizacao
+8. `TestUpdateUser_NotFound` — usuario nao encontrado
+
+**Criterio de aceite:**
+- Mock atualizado com metodo `Update`
+- Todos os cenarios de telefone cobertos (valido, vazio, curto, longo)
+- Testes de `UpdateUser` adicionados
+- Todos os testes passam: `CGO_ENABLED=1 go test ./internal/service/... -v`
+
+**Dependencias:** TASK-5
+
+---
+
+### TASK-11: Atualizar testes unitarios do handler
+
+**Camada:** Testes
+**Arquivo a editar:** `internal/handler/grpc/user_handler_test.go`
+**Descricao:**
+Atualizar mock do service para incluir metodo `UpdateUser`. Adicionar testes para:
+
+1. `TestUserHandler_CreateUser_WithPhone` — verifica que phone e repassado e retornado
+2. `TestUserHandler_GetUser_WithPhone` — verifica que phone e retornado
+3. `TestUserHandler_UpdateUser_Success` — atualizacao com sucesso
+4. `TestUserHandler_UpdateUser_NotFound` — usuario nao encontrado
+5. `TestUserHandler_UpdateUser_InvalidPhone` — telefone invalido
+
+**Criterio de aceite:**
+- Mock atualizado com metodo `UpdateUser`
+- Testes de phone no CreateUser e GetUser
+- Testes de UpdateUser cobrindo sucesso e erros
+- Todos os testes passam: `CGO_ENABLED=1 go test ./internal/handler/grpc/... -v`
+
+**Dependencias:** TASK-8
+
+---
+
+### TASK-12: Teste de integracao e validacao final
+
+**Camada:** Validacao
+**Descricao:**
+Executar build e suite completa de testes para garantir que tudo funciona junto.
+
+**Comandos:**
+```bash
+make build
+make test
+```
+
+**Criterio de aceite:**
+- Build compila sem erros
+- Todos os testes passam
+- Nenhuma regressao nos testes existentes
+
+**Dependencias:** TASK-10, TASK-11
+
+---
+
+## 4. Grafo de Dependencias
+
+```
+TASK-1 (migracao SQL)
+  └─> TASK-2 (queries SQLC)
+        └─> TASK-3 (make generate - SQLC)
+              └─> TASK-4 (repository)
+                    └─> TASK-5 (service)
+                          ├─> TASK-8 (handler) [+ TASK-7]
+                          └─> TASK-10 (testes service)
+
+TASK-6 (proto) [paralelo com TASK-1..5]
+  └─> TASK-7 (make generate - proto)
+        └─> TASK-8 (handler)
+              ├─> TASK-9 (config auth)
+              └─> TASK-11 (testes handler)
+
+TASK-10 + TASK-11
+  └─> TASK-12 (validacao final)
+```
+
+## 5. Ordem de Execucao Sugerida
+
+| Fase | Tasks | Descricao |
+|------|-------|-----------|
+| **Fase 1** | TASK-1, TASK-6 | Migracao SQL + Proto (paralelo) |
+| **Fase 2** | TASK-2 | Queries SQLC |
+| **Fase 3** | TASK-3, TASK-7 | Regenerar codigo (SQLC + Proto) — executar `make generate` uma unica vez |
+| **Fase 4** | TASK-4 | Repository |
+| **Fase 5** | TASK-5 | Service |
+| **Fase 6** | TASK-8, TASK-9 | Handler + Config |
+| **Fase 7** | TASK-10, TASK-11 | Testes (paralelo) |
+| **Fase 8** | TASK-12 | Validacao final |
+
+## 6. Riscos e Observacoes
+
+1. **Numeracao Proto:** A numeracao dos campos proto existentes NAO pode ser alterada. O campo `phone` deve usar o proximo numero livre em cada mensagem. Isso e critico para compatibilidade.
+
+2. **Migracao imutavel:** A migracao 001 NAO deve ser editada. Sempre criar nova migracao (002).
+
+3. **Codigo gerado:** Nunca editar arquivos em `gen/` ou `internal/db/sqlc/*.go`. Sempre editar os fontes (`.proto`, `.sql`) e rodar `make generate`.
+
+4. **Campo opcional:** O campo `telefone` e `TEXT` nullable no SQLite. No Go, o SQLC pode gerar como `sql.NullString` — verificar apos geracao e ajustar mapeamento no repository conforme necessario.
+
+5. **UpdateUser e novo:** O proto atual nao tem `UpdateUser`. E necessario criar o RPC, mensagens e implementar em todas as camadas. A SPEC_TECH menciona "UpdateUser" mas o codebase atual nao possui esse endpoint.
+
+6. **`make generate`:** Os comandos `make generate` das TASK-3 e TASK-7 podem ser executados em uma unica chamada se o Makefile gerar tanto SQLC quanto Proto.