# Relacionamentos — Módulo Fantasma (NÃO IMPLEMENTADO)

## 1. O que é o módulo

Grupo de módulos focados na interação direta com o público e captação de dados de relacionamento: ouvidorias, formulários de contato, pesquisas de satisfação, canais de atendimento ao cidadão e sistemas de tickets/chat.

**Status:** NÃO IMPLEMENTADO. Apenas esboço conceitual.

## 2. Estrutura de dados

Inexistente. Não há modelos, migrations ou tabelas.

## 3. Dependências

Inexistentes.

## 4. Tabelas

Nenhuma.

## 5. Arquivos

```
V2/Modules/Relacionamentos/
└── README.md        # Apenas esboço conceitual descrevendo o propósito do grupo
```

## 6. Observações/Sugestão

Para implementar seguindo os padrões V2:

1. Possível arquitetura de módulos dentro deste grupo:

   **Ouvidoria:**
   - `V2/Modules/Relacionamentos/Ouvidoria/`
   - Models: `OuvidoriaManifestacao` (tipo: denúncia, sugestão, elogio, solicitação), `OuvidoriaResposta`
   - Tabelas: `v2_ouvidoria_manifestacoes`, `v2_ouvidoria_respostas`
   - Protocolo automático com numeração única
   - Notificação por e-mail ao cidadão (via MailService)
   - Painel CMS com triagem, encaminhamento e resposta
   - Prazo de resposta regressivo (Lei de Acesso à Informação)

   **Formulário de Contato:**
   - `V2/Modules/Relacionamentos/FormContato/`
   - Configurável pelo CMS (campos dinâmicos)
   - Models: `FormContatoMensagem`, `FormContatoConfig`
   - Captcha (reCAPTCHA) para proteção
   - Notificação por e-mail ao setor responsável
   - Exportação CSV

   **Pesquisa de Satisfação:**
   - `V2/Modules/Relacionamentos/PesquisaSatisfacao/`
   - Models: `Pesquisa`, `Pergunta`, `Resposta`, `Voto`
   - Múltiplos tipos de pergunta (estrelas, likert, texto livre)
   - Relatórios gráficos no CMS
   - Widget para incorporar em páginas

2. Estrutura padrão por submódulo:
   ```
   {Modulo}/
   ├── Controllers/{Modulo}CmsController.php
   ├── Controllers/{Modulo}PortalController.php
   ├── Models/{Model}.php
   ├── Services/{Modulo}Service.php
   ├── ModuleProvider.php
   ├── Routes/cms.php, web.php
   ├── Migrations/*.php
   └── Views/cms/*, portal/*
   ```

3. Permissões: `v2_can('Ouvidoria', 'read|write')`, etc.

4. Considerações importantes:
   - Ouvidoria precisa atender requisitos legais (LAI — Lei 12.527/2011)
   - Formulários de contato precisam de proteção anti-spam
   - Dados pessoais coletados devem seguir a LGPD
   - Idealmente usar filas (queue) para notificações por e-mail