# E-mail para Gerente de TI - Integração do Aplicativo de Chamados de Manutenção

---

**Assunto:** Solicitação de Configuração de Banco de Dados - Aplicativo de Chamados de Manutenção do Grupo Samam

---

Olá Fabio,

Espero que esteja bem.

Desenvolvemos um **aplicativo de gestão de chamados de manutenção** para o Grupo Samam, com o objetivo de otimizar o processo de abertura, acompanhamento e resolução de demandas de manutenção em todas as nossas unidades.

## Sobre o Aplicativo

O sistema foi desenvolvido para funcionar tanto em **dispositivos móveis** (Android e iOS) quanto em **navegadores web** (computadores), permitindo acesso de qualquer lugar.

### Funcionalidades Implementadas

**Para os colaboradores (abertura de chamados):**
- Cadastro de usuário com nome, e-mail, senha, função e unidade de trabalho
- Abertura de chamados de manutenção com seleção de:
  - Unidade/prédio (todas as 11 unidades do Grupo Samam)
  - Categoria do problema (Ar-Condicionado, Elétrica, Telhado, Equipamentos, Hidráulica, Outros)
  - Descrição detalhada do problema
- Acompanhamento em tempo real do status do chamado
- Visualização do histórico de atualizações (timeline)
- Edição de perfil e foto de perfil
- Recuperação de senha

**Para a equipe de manutenção:**
- Painel exclusivo para visualização de todos os chamados pendentes
- Sistema de priorização (Baixa, Média, Alta, Urgente)
- Atualização de status dos chamados (Aberto → Em Análise → Em Execução → Concluído)
- Filtros por unidade e status
- Adição de comentários em cada etapa

### Unidades Cadastradas

1. Samam Fiat Matriz
2. Samam Jeep Matriz
3. Samam Hyundai
4. Samam Honda
5. Samam Omoda/Jaecoo
6. Samam Semi Novos
7. Samam Semi Novos Prêmio
8. Samam Fiat Itabayana
9. Samam Fiat Rio Mar
10. Samam Jeep Rio Mar
11. Samam Locadora

## Requisitos Técnicos para Integração

Para migrar o aplicativo para a infraestrutura do Grupo Samam, precisamos configurar a conexão com um banco de dados próprio. Seguem os requisitos e informações necessárias:

### Requisitos do Servidor de Banco de Dados

| Requisito | Especificação |
|-----------|---------------|
| **Tipo de banco** | MySQL 8.0+ ou MariaDB 10.5+ |
| **Conexão externa** | O servidor deve aceitar conexões de IPs externos (não apenas localhost) |
| **SSL/TLS** | Recomendado para segurança dos dados em trânsito |
| **Charset** | utf8mb4 (para suporte a caracteres especiais e emojis) |
| **Collation** | utf8mb4_unicode_ci |

### Informações Necessárias para Configuração

Para realizar a integração, preciso que você forneça as seguintes credenciais:

| Informação | Descrição | Exemplo |
|------------|-----------|---------|
| **Host** | Endereço do servidor de banco de dados | `db.gruposamam.com.br` ou `192.168.1.100` |
| **Porta** | Porta de conexão MySQL | `3306` (padrão) |
| **Usuário** | Nome de usuário com permissões de leitura/escrita | `app_manutencao` |
| **Senha** | Senha do usuário do banco | (senha segura) |
| **Nome do banco** | Nome do database a ser utilizado | `chamados_manutencao` |
| **SSL obrigatório** | Se a conexão requer SSL | Sim/Não |
| **Certificado SSL** | Se necessário, o certificado CA | (arquivo .pem) |

### Permissões Necessárias no Banco

O usuário do banco de dados precisa ter as seguintes permissões no database designado:

```sql
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP ON chamados_manutencao.* TO 'app_manutencao'@'%';
```

### Estrutura de Tabelas

O aplicativo utiliza 4 tabelas principais:

1. **users** - Usuários do sistema OAuth (interno)
2. **app_users** - Cadastro dos colaboradores do Grupo Samam
3. **maintenance_calls** - Chamados de manutenção
4. **call_history** - Histórico de atualizações dos chamados

As tabelas serão criadas automaticamente na primeira execução após a configuração.

### Estimativa de Uso

| Métrica | Estimativa |
|---------|------------|
| Usuários cadastrados | ~200-500 colaboradores |
| Chamados por mês | ~100-300 chamados |
| Tamanho do banco | ~50-200 MB (primeiro ano) |
| Conexões simultâneas | ~20-50 conexões |

## Próximos Passos

1. **Criar o banco de dados** no servidor MySQL do Grupo Samam
2. **Criar o usuário** com as permissões necessárias
3. **Liberar acesso externo** para o IP do servidor da aplicação
4. **Enviar as credenciais** de forma segura para configuração
5. **Testar a conexão** e migrar os dados existentes

## Considerações de Segurança

- Recomendo utilizar conexão SSL para proteger os dados em trânsito
- A senha dos usuários é armazenada no banco (recomendo implementar hash futuramente)
- O acesso ao banco deve ser restrito apenas aos IPs necessários
- Backups regulares do banco de dados são recomendados

---

Fico à disposição para agendar uma reunião e esclarecer qualquer dúvida técnica sobre a integração.

Atenciosamente,

[Seu Nome]
[Seu Cargo]
Grupo Samam

---

**Anexos sugeridos:**
- Capturas de tela do aplicativo (opcional)
- Diagrama do banco de dados (se necessário)