manassesbinga/koneta

Plataforma de infraestrutura de dados para Angola. Fornece APIs unificadas para consulta de identidade (BI, NIF). # Koneta - API Gateway Angola Plataforma de infraestrutura de dados para Angola. Fornece APIs unificadas para consulta de identidade (BI, NIF). ## 🚀 Setup Inicial 1. **Instalar Dependências**: ```bash npm install ``` 2. **Configurar Variáveis de Ambiente**: Copie `.env.example` para `.env` e preencha as credenciais do Supabase. 3. **Configurar Banco de Dados**: Use o Supabase CLI para aplicar as migrações: ```bash npx supabase db push ``` 4. **Executar em Desenvolvimento**: ```bash npm run dev ``` ## 🔒 Segurança ### Autenticação de API Todas as rotas em `/api/v1/*` são protegidas. - **Header Recomendado**: `Authorization: Bearer SUA_CHAVE_AQUI` - **Header Legado**: `x-api-key: SUA_CHAVE_AQUI` - A validação é feita no `middleware.ts` antes de atingir o endpoint. ### CORS Configurado para permitir apenas origens autorizadas (ex: `koneta.ao`). ## 📚 Documentação das APIs As rotas de documentação estão integradas na aplicação em `/docs`. ## 📦 Deploy (Produção) O projeto está configurado para deploy na **Vercel**. Certifique-se de configurar as seguintes variáveis de ambiente no painel da Vercel: - `NEXT_PUBLIC_SUPABASE_URL` - `NEXT_PUBLIC_SUPABASE_ANON_KEY` - `SUPABASE_SERVICE_ROLE_KEY` (Essencial para o Middleware validar chaves) - `SMTP_HOST`, `SMTP_USER`, `SMTP_PASS` (Para envio de emails/OTP)