Integração: migrar Endereços para API real

[tarcisiopgs]

Contexto

O hook useAddresses() busca de /mocks/adresses.json (com typo no nome). A página de endereços lê addresses.enderecos.lista — um shape que não corresponde ao retorno real da API (GET /address retorna { addresses: [{ _id, cep, endereco, bairro, estado, complemento, active }] }). Parte da migração descrita em #63.

Decisão de design

Substituir o fetch mock pelo Kubb hook getAddress() e criar adapter que traduz o shape da API pro shape esperado pelos componentes. O mapeamento principal: _id → id, endereco → rua, active → principal, adicionar cidade (a API atual não retorna — pode precisar de ajuste no backend).

O que fazer

• Substituir useAddresses() → getAddress() (Kubb)
• Criar adapter toAddressProps(): _id → id, endereco → rua, active → principal
• Verificar se a API retorna cidade — se não, abrir issue de backend
• Conectar usePutActiveAddress pra marcar endereço como ativo
• Remover mock: public/mocks/adresses.json
• Atualizar a página de endereços pra ler o novo shape

Fora de escopo

• CRUD completo de endereços (criar, editar, deletar)
• Integração com ViaCEP na listagem (já existe no cadastro)

Comportamento esperado

1. Página de endereços carrega lista da API real
2. Endereço principal é destacado (campo active)
3. Usuário pode marcar outro endereço como ativo

Critérios de aceite

• Lista de endereços vem da API real
• Adapter traduz shape corretamente
• Marcar endereço como ativo funciona
• Mock removido

Arquivos relevantes

• src/features/addresses/hooks/useAddresses.ts
• src/app/(public)/address/page.tsx
• src/kubb/hooks/useGetAddress.ts
• src/kubb/hooks/usePutActiveAddress.ts

Parte de #63.

[ryannardelli]

@tarcisiopgs
Abrir algumas issues referentes a essa atividade, da qual estou enfrentando problemas e sugerir um extra. Foram abertas referentes ao back-end, se puder olhar e passar o feedback, agradeço

[MateusFelS]

@ryannardelli no backend tá retornando corretamente, porém no frontend deu esse erro da imagem

[ryannardelli]

@MateusFelS Abrir um PR para resolver isso e já está para revisão

[tarcisiopgs]

olha, dei uma conferida no estado real do código e acho que tem ponto da checklist marcado como done que ainda não tá fechado de verdade. voltei o card pra A fazer.

o que tá ok:

• useAddresses() já tá usando o Kubb (useGetAddress)
• toAddressProps existe e tá mapeando _id/endereco/active certinho
• usePutActiveAddress conectado e invalidando a query no sucesso
• mock adresses.json foi embora

o que ainda tá pendente:

cidade e type não vêm da API. o body da issue já alertava que a API não retorna cidade e que isso ia precisar de ajuste no backend. o adapter hoje cai no ?? "", então a página renderiza Rua - Bairro, - Estado (com o espaço vazio no meio). e o type (Casa/Outro) tem o mesmo problema — não vem do backend, mas a página usa pra escolher o ícone (HouseIcon vs LocationIcon) e mostrar como h5. hoje isso sai vazio na UI. precisa: (1) abrir issue de backend pra incluir cidade e type no GET /address, (2) enquanto não vier, esconder esses pedaços ou colocar placeholder.

adapter redefine ApiAddress à mão. o Kubb já gera o tipo do response do /address. ideal o adapter consumir o tipo gerado direto pra não dessincronizar quando o backend mudar.

fix do auth (PR #223) é parte do trabalho mas não fecha essa issue. ele resolveu o 401 que tava bloqueando o GET /address, mas a parte de "verificar cidade no backend" ficou pendente.

resumindo: a integração funciona pro caminho feliz, mas a UI tá renderizando campos vazios em produção e o adapter tá com tipo manual. quando esses dois forem resolvidos, marca como done de novo.

[ryannardelli]

@tarcisiopgs
Ajuste realizado conforme sugerido. PR (#225)

[MateusFelS]

tudo certo agora