Plataforma de Orquestração

1. Visão Geral do Produto

Uma plataforma SaaS que atua como camada de controle (middleware) entre empresas e a API Oficial do WhatsApp (Meta Cloud API).

2. Arquitetura Técnica

Stack Tecnológica

• Backend: PHP 8+ (Vanilla / Sem Framework).
• Frontend: HTML5, Tailwind CSS (via CDN), JavaScript Vanilla.
• Banco de Dados: MySQL/MariaDB.
• Servidor: Apache (CPanel/Linux).

Estrutura de Pastas

A aplicação segue o padrão Gold Standard de segurança, isolando a lógica da camada pública.

/home/usuario/
├── app/                        # NÚCLEO (Inacessível via URL)
│   ├── config/                 # Credenciais de Banco
│   ├── controllers/            # Lógica de Negócio
│   ├── models/                 # Acesso a Dados
│   ├── services/               # Regras de Negócio
│   ├── helpers/                # Utilitários
│   └── views/                  # Telas HTML/PHP
│
├── public_html/                # PÚBLICO (Landing Page)
│   ├── index.php
│   └── .htaccess
│
└── app.whatsbi.com/            # SUBDOMÍNIO (Aplicação)
    ├── index.php
    └── .htaccess

Componentes Core

• Router Sistema de rotas personalizado e amigável.
• Autoloader Carregamento automático com suporte a case-sensitivity.
• AuthMiddleware Proteção de rotas e sessões.
• PhoneHelper Engine de normalização (DDI 55 + 9º dígito).
• ContactService Lógica de importação CSV com Upsert.

3. Design System

Interface refinada para competir com SaaS globais, focada em energia e conversão.

4. Funcionalidades Implementadas

5. Banco de Dados (Schema)

Estrutura relacional otimizada para o MVP Fase 2.

-- Identidade e Acesso
users (id, name, email, password, created_at)
companies (id, name, active, created_at)
user_company (user_id, company_id, is_primary)

-- Contatos e Compliance
contacts (
    id, company_id, name, phone, phone_e164 (UNIQUE), 
    consent, consent_source, opted_out, valid, created_at
)
contact_imports (
    id, company_id, user_id, file_name, 
    total_rows, imported_rows, skipped_rows, status
)

6. Próximos Passos