# Pix Estático - Contexto Completo e Documentação Técnica para Modelos de Linguagem e Agentes

Bem-vindo à documentação expandida de Pix Estático. Este documento fornece contexto exaustivo sobre funcionalidades, formatos de entrada, regras de validação e arquitetura.

## 1. Visão Geral do Sistema
Pix Estático é um gerador de BR Code (Padrão EMV QRCPS-MPM do Banco Central do Brasil) estático para pagamentos instantâneos no Brasil. Funciona integralmente no lado do cliente (client-side), sem dependência de banco de dados centralizado para chaves ou transações.

## 2. Ações e Fluxos Interativos
- **Gerar Código PIX**: O usuário (ou agente de navegação) submete os parâmetros necessários (`pixKey`, `merchantName`, `merchantCity`) e opcionais (`amount`, `description`).
- **Copiar Código Copia e Cola**: Copia a cadeia textual do Payload EMV para a área de transferência.
- **Exportar QR Code**: Gera arquivo PNG para impressão em balcões ou exibição digital.
- **Salvar / Favoritar**: Mantém no histórico local (`LocalStorage`) cobranças frequentes para reuso rápido.

## 3. Especificação dos Parâmetros de Entrada
| Parâmetro | Tipo | Obrigatório | Limites / Formato | Descrição |
| :--- | :--- | :--- | :--- | :--- |
| `pixKey` | `string` | Sim | 1 a 77 caracteres | CPF (11 dígitos), CNPJ (14 dígitos), E-mail, Celular (+55...), ou UUID |
| `merchantName` | `string` | Sim | Máx 25 caracteres | Nome completo do titular da conta |
| `merchantCity` | `string` | Sim | Máx 15 caracteres | Nome da cidade onde a conta bancária está sediada |
| `amount` | `number` / `cents` | Não | Formato decimal BRL (ex: 50.00) | Valor em Reais. Se omitido, o pagador define o valor |
| `description` | `string` | Não | Máx 25 caracteres | Mensagem complementar ou descrição do pedido |
| `transactionId` | `string` | Não | Máx 25 caracteres (padrão `***`) | Código TXID de identificação da transação |

## 4. Estrutura do Payload EMV (BR Code)
O Payload gerado contém as seguintes tags EMV TLV:
- `00` Payload Format Indicator: `01`
- `26` Merchant Account Information (GUI `br.gov.bcb.pix`, chave e descrição opcional)
- `52` Merchant Category Code: `0000`
- `53` Transaction Currency: `986` (BRL)
- `54` Transaction Amount (se fornecido)
- `58` Country Code: `BR`
- `59` Merchant Name (normalizado sem acentos)
- `60` Merchant City (normalizado sem acentos)
- `62` Additional Data Field Template (TXID tag `05`)
- `63` CRC16-CCITT (Polinômio 0x1021)