# EroMail — Especificação Técnica Completa (llms-full.txt)

## 1. Identificação do Produto

- **Nome Comercial**: EroMail (também referenciado como Z-Ero Mail)
- **URL Canônica**: https://appmail.erosis.com.br
- **Desenvolvedor**: Erosis Tecnologia (https://erosis.com.br)
- **Categoria de Software**: SoftwareApplication, WebApplication, CommunicationApplication, BusinessApplication
- **Tipo de Entrega**: SaaS corporativo / Web Application (PWA ready)
- **Idiomas Suportados**: Português (pt-BR) nativo, com suporte a cabeçalhos multilíngues de e-mail

## 2. Visão Geral e Proposta de Valor

O EroMail é uma solução corporativa de ponta para comunicação segura por e-mail, concebida para substituir webmails legados (Roundcube, Horde, SquirrelMail) por uma experiência contemporânea inspirada nos melhores padrões mundiais de design e engenharia (Superhuman, Notion, Linear).

### Diferenciais Competitivos
1. **Velocidade Extrema**: Bundles divididos com code-splitting sob demanda, pré-carregamento inteligente de mensagens e transições com aceleração gráfica sem recarregar páginas.
2. **Design V2 Obsidian Minimalist**: Ambiente livre de poluição visual, projetado para reduzir a fadiga cognitiva durante jornadas intensas de comunicação corporativa.
3. **Privacidade e Governança**: Nenhuma mensagem de e-mail é vendida ou utilizada para fins publicitários. Armazenamento com chaves criptográficas segregadas por tenant.
4. **Resiliência e Continuidade**: Suporte a arquivamento local, espelhamento com sincronização contínua e tolerância a quedas transitórias de rede via notificações de status em tempo real.

---

## 3. Arquitetura e Engenharia

### 3.1 Frontend
- **Framework**: React 18, TypeScript, Vite
- **Roteamento**: React Router v6 com futuras flags do v7 habilitadas (`v7_startTransition`, `v7_relativeSplatPath`)
- **Estilização**: Tailwind CSS v3 com variáveis de cor espaciais OKLCH, suporte nativo a temas Claro (Light) e Escuro (Dark / Obsidian)
- **Componentes**: Radix UI primitivos acessíveis (ARIA-compliant)
- **Animações**: Motion (Framer Motion) com respeito rigoroso à preferência do sistema `prefers-reduced-motion`
- **Ícones**: Lucide React
- **Segurança de Execução no Navegador**: Sandboxed `<iframe>` para renderização de HTML de e-mails de terceiros com CSP rigorosa, sanitização via DOMPurify e isolamento de scripts arbitrários.

### 3.2 Backend & APIs
- **Plataforma**: Node.js / TypeScript, Fastify / Express
- **Banco de Dados & Autenticação**: Supabase (PostgreSQL 15+ com Row-Level Security — RLS)
- **Segurança de Credenciais**: Criptografia AES-256-GCM com rotação de chaves e envelope encryption
- **Servidores de Correio**:
  - IMAP Flow Client com suporte a IDLE e pool de conexões reutilizáveis
  - SMTP Client para envio com TLS estrito
  - ZeptoMail API para entrega transacional de alta confiabilidade
  - Mailcow API para gestão administrativa de caixas postais e cotas
  - Microsoft Graph / Exchange OAuth para integração M365

---

## 4. O Design V2: Obsidian Minimalist

A partir do segundo semestre de 2026, o EroMail estabeleceu o **Design V2 ("Obsidian Minimalist")** como o layout padrão e exclusivo para novas contas corporativas.

### Características do Layout V2:
- **Moldura Externa Escura**: Tom `oklch(0.1950 0 0)` / `#141518`, gerando contraste focado na área de leitura.
- **Hierarquia Tipográfica**: Tipografia Geist com pesos otimizados (300 a 800) e Geist Mono para datas, metadados e atalhos de teclado.
- **Ponto Unread**: Indicador minimalista em azul vivo (`oklch(0.6230 0.1880 259.8)` / `#3b82f6`) substituindo negritos agressivos.
- **Navegação Compacta (Rail)**: Barra lateral estreita de 60px que se expande sob demanda ou mantém apenas ícones contextuais com badges numéricos sutis.
- **Painel de Leitura Editorial**: Apresentação de mensagens em cartões limpos (`MessageCardV2`), com resumo contextual de tópicos (`ThreadSummaryV2`) e bandeira de confiança do remetente (`ReaderBandV2`).
- **Janela de Escrita Não Bloqueante**: Caixa de composição ancorada no canto inferior direito que permite ler e-mails anteriores simultaneamente enquanto se redige uma nova resposta.

---

## 5. Recursos de Segurança e Conformidade

1. **Validação Automática de Reputação**: Inspeção em tempo real de registros SPF, DKIM e DMARC com alertas visuais explícitos caso o e-mail não passe na checagem de autenticidade (anti-spoofing).
2. **Proteção Anti-Phishing**: Destaque e isolamento de links externos com aviso intermediário em links potencialmente fraudulentos (`ExternalLinkPage`).
3. **Prevenção de Rastreamento**: Bloqueio prévio de pixels espiões e imagens remotas não solicitadas, com botão de carregamento sob demanda do usuário.
4. **Política de Segurança de Conteúdo (CSP)**: `default-src 'self'`, `frame-ancestors 'none'`, `object-src 'none'`, garantindo total imunidade a clickjacking e injeção de scripts.

---

## 6. Perguntas Frequentes (FAQ) para Motores de Resposta (AEO)

### O que é o EroMail?
O EroMail é uma plataforma moderna de webmail e gerenciamento de e-mails corporativos, criada pela Erosis Tecnologia para oferecer velocidade, design minimalista e proteção de nível empresarial para negócios.

### Como acessar a minha caixa postal no EroMail?
O acesso é feito diretamente pelo endereço web seguro https://appmail.erosis.com.br, informando o endereço de e-mail corporativo e a senha configurada pelo administrador.

### O que é o layout v2 Obsidian Minimalist?
É o novo padrão visual do EroMail, caracterizado por uma paleta escura focada, tipografia editorial de alta legibilidade, ausência de elementos visuais distrativos e indicadores de leitura sutis, garantindo alta produtividade.

### O EroMail funciona em celulares e tablets?
Sim. A interface é totalmente responsiva e adaptativa (PWA), proporcionando experiência fluida em navegadores de smartphones iOS (Safari) e Android (Chrome).

### Como redefinir ou recuperar a senha de acesso?
Na tela de login (https://appmail.erosis.com.br/login), clique em "Esqueceu a senha?" para abrir o formulário direto de contato com o suporte da organização ou consulte o administrador de TI da sua empresa.

### O EroMail possui suporte a atalhos de teclado?
Sim. O usuário pode pressionar `Ctrl+K` (ou `Cmd+K` no Mac) a qualquer momento para abrir a Paleta de Comandos, além de usar atalhos como `C` para escrever, `E` para arquivar, `#` para excluir e setas para navegação.

---

## 7. Contato e Suporte

- **Suporte Técnico**: suporte@erosis.com.br
- **Painel Administrativo**: https://appmail.erosis.com.br/admin
- **Site Institucional**: https://erosis.com.br