# Passaporta — plano do MVP

## Produto
Plataforma web para criar passaportes digitais de produtos e serviços. Cada registro possui uma página pública multilíngue, acessível por URL e QR Code futuramente, com informações, documentos, garantia, histórico e contato.

## Escopo da primeira versão
- PHP 8.1+ sem framework obrigatório, MariaDB 10.4+ e PDO.
- Login administrativo por sessão.
- Cadastro de registros do tipo produto ou serviço.
- Slug público e página pública responsiva.
- Configuração administrativa de endpoint, token, modelo e prompt-base de IA.
- Geração opcional de descrição com endpoint compatível com OpenAI Chat Completions.
- Estrutura preparada para múltiplas organizações, usuários e planos.
- Compatibilidade com upload do conteúdo do projeto para cPanel.

## Segurança
Tokens de IA são armazenados criptografados quando APP_KEY estiver configurada. Senhas usam password_hash. Consultas usam PDO preparado. Rotas administrativas exigem sessão e token CSRF.

## Estrutura
- `public/index.php`: front controller e rotas.
- `app/bootstrap.php`: configuração, conexão, sessão e helpers.
- `config/config.example.php`: configuração de ambiente.
- `database/schema.sql`: banco e usuário inicial de instalação.
- `public/assets/`: CSS e JS.
- `storage/`: arquivos locais não públicos.

## Design
Alternativas: utilitário editorial (0,04), painel SaaS colorido (0,07), arquivo técnico premium (0,03). Escolhido: **arquivo técnico premium**.

Princípios: clareza, confiança, ritmo editorial e destaque para evidências. Paleta: azul petróleo para confiança, areia clara para fundo e laranja queimado para ações. Layout: barra lateral administrativa e páginas públicas com coluna de leitura. Elementos de assinatura: selo “verificado”, linha do tempo e cartões de evidência. Tipografia: Inter para interface e Source Serif 4 para títulos públicos. Voz: direta, útil e sem promessas jurídicas. Posicionamento: “A história útil de cada produto ou serviço, em um só link.”

## Próximas fases
1. MVP atual.
2. QR Code, anexos e histórico de manutenção.
3. Multiusuário, branding e traduções assistidas.
4. Assinaturas, limites por plano e webhooks.
5. Integrações com WooCommerce, Shopify, WordPress e sistemas de ordem de serviço.