Caderno técnico • v1.2
OpenAPIVoltar ao produto
ENTREGÁVEL 01

Arquitetura técnica

Base modular, multiplataforma e preparada para crescimento, preservando um único domínio de negócio.

Stack recomendada para o MVP

TypeScript de ponta a ponta: Next.js no portal/admin, React Native + Expo no mobile e Supabase Pro no núcleo seguro (PostgreSQL, autenticação, arquivos e funções). Um serviço NestJS pode ser extraído depois, sem reescrever os contratos.

CANAIS
App mobileReact Native + ExpoPortal e adminNext.js responsivo
HTTPS / JWT / MFA
PLATAFORMA
API modularEdge Functions + RESTRotinas segurasJobs agendados + webhooks
Políticas RLS e eventos
DADOS E SERVIÇOS
PostgreSQLDados relacionaisObject storageDocumentos privadosNotificaçõesFCM + e-mail

Monorepo

apps/webapps/mobilesupabase/functionspackages/contractspackages/ui

Contratos OpenAPI geram clientes tipados para web e mobile.

Cloud definida para o MVP

Vercel Pro hospeda portal e painel; Supabase Pro hospeda banco, login, arquivos privados, backups e funções.

Uma API NestJS em Railway Pro entra apenas quando filas ou integrações exigirem servidor dedicado.

Princípios estruturais

Modular monolith no MVPAPI versionada /v1RLS em todas as tabelas privadasIdempotência em pagamentosRBAC + escopo por recursoObservabilidade desde o início