Adicionar Contatos

Contatos.md

@@ -0,0 +1,34 @@
+# Contatos e Agenda
+
+Base tecnica:
+
+- Controller: `src/modules/admin/customer-contacts.controller.ts`
+- Service: `src/modules/admin/customer-contacts.service.ts`
+- Prefixo: `/contacts`
+
+## Responsabilidade
+
+Gerencia agenda e perfil de contatos usados no chat e na abertura ativa.
+
+## Endpoints
+
+| Metodo | Rota | Descricao |
+|---|---|---|
+| GET | `/contacts` | Lista agenda |
+| GET | `/contacts/:chatId` | Busca contato por chat/WhatsApp |
+| PUT | `/contacts/:chatId` | Cria ou atualiza contato |
+
+## Campos principais
+
+- `chat_id`: identificador WhatsApp, geralmente `5511999999999@c.us`.
+- `phone`: numero WhatsApp.
+- `call_sms_phone`: numero para ligacao/SMS.
+- `email`: email do contato.
+- `name`: nome.
+- `company`: campo historico usado como etiqueta de identificacao.
+- `note`: observacao.
+- `user_id`: usuario que salvou/atualizou.
+
+## Code review
+
+O nome tecnico `company` permaneceu por compatibilidade, mas na interface o conceito virou `Etiqueta de identificacao`.