---
name: Clientes - Módulo de Gestão
description: Cadastro/edição de clientes com responsável, serviços contratados, contratos e cobranças
type: project
---

## Clientes - Módulo (ATUALIZADO 2026-03-13)

### Estrutura
- Controller: `app/Controllers/Cliente.php`
- Model: `app/Models/ClienteModel.php`
- Views: `app/Views/clientes/index.php` (principal com modais), `create.php`, `edit.php`
- Tabela: `clientes`

### Campo Responsável (ADICIONADO 2026-03-13)
- Coluna: `responsavel VARCHAR(150) DEFAULT NULL` (após `nome`)
- No `allowedFields` do ClienteModel
- Presente em: modal criar, modal editar, dados gerais (visualização), create.php, edit.php
- Controller `store()` e `update()` incluem `responsavel` no array `$data`
- **Cobranças usam nome do responsável** quando preenchido (senão usa nome da empresa)
  - `gerarMensagem()` e `gerarMensagemConsolidada()` no CronCobrancaAutomatica.php
  - Query principal busca `clientes.responsavel as cliente_responsavel`

### Serviços Contratados (lista hardcoded nas views)
- Gestão de Redes Sociais, Marketing Digital, Desenvolvimento Web
- Design Gráfico, Manutenção e Suporte, Consultoria de TI
- PABX Virtual, Gestão de Marketplace, Estúdio de Filmagens, Venda de Equipamentos
- **Aluguel de Impressora** (adicionado 2026-03-13)
- Lista repetida em 3 locais: index.php (modal editar + modal criar), create.php, edit.php

### Cobranças - Textos (ATUALIZADO 2026-03-13)
- Assinatura WhatsApp: `_GoTechBR - Departamento Financeiro_` (era "Cobrança Automática")
- Email: `"Por favor, não responda este email."` (era "email automático")
- Alerta: `"GoTechBR - Departamento Financeiro"` (era "alerta automático do sistema")
- Títulos internos (teste/logs): sem "Automática"
- **Regra do usuário**: NÃO mencionar "automático" em nenhum texto visível ao cliente

### Modais no index.php
- `#dadosClienteModal` (modal-xl): Dados Gerais + Contrato + Arquivos (tabs)
- `#editarClienteModal` (modal-xl): Formulário edição com serviços
- `#criarClienteModal` (modal-xl): Formulário cadastro com serviços
- `#contratoModal`: Cadastro de contrato
- `#editarContratoModal`: Edição de contrato
- `#editarAditivoModal`: Edição de aditivo
- `#novaPastaModal`: Criar pasta de arquivos