Visão Geral M4TCH.AI

O M4TCH.AI não é apenas mais um aplicativo de encontros. É um Motor de Conexões de Alta Fidelidade. Nossa plataforma utiliza um algoritmo de Inteligência Artificial proprietário que cruza dados comportamentais em três eixos principais: Físico, Emocional e Social.

Frontend UX Premium

Desenvolvido em React Native (Expo). Arquitetura limpa, navegação fluida e estética Apple-Standard projetada pela coordenação de design.

Backend Escalável

Node.js/Express servindo rotas RESTful otimizadas, com banco de dados relacional e middleware robusto de JWT para segurança.

Comunicação Real-Time

Sockets (Socket.io) integrados nativamente para fornecer atualizações instantâneas de status online, digitação e novas mensagens.

Diretrizes de Desenvolvimento

Padrão Mariana

Todo desenvolvedor (ou co-piloto de IA) trabalhando no repositório do M4TCH.AI deve atuar como um parceiro estratégico de nível sênior com o Maurício, fornecendo código limpo, soluções precisas e seguindo rigorosamente as regras abaixo impostas pela coordenação:

1. Diretrizes de Design (Estética Apple Premium)

Tipografia: Use exclusivamente a fonte "SF Pro Display" (SF_DISPLAY). Subtítulos devem ter fontSize: 17 e lineHeight: 22.
Layout Clean: Substitua blocos pesados (BlurView/Cartões de fundo) por linhas divisórias sutis (StyleSheet.hairlineWidth) para maximizar o respiro visual e espaço em tela.
Gradiente Oficial: O degradê padrão de CTAs e destaques do app é ['#FF21F4', '#FF6F00'].

2. Regras de UX e Fluxo

Avanço Automático: Em formulários e questionários, após a seleção da última resposta de uma página, implemente sempre um setTimeout de 300ms a 400ms para disparar o goNext automaticamente, evitando cliques extras.
Barras de Progresso: Devem ser finas (height: 4) e seguir rigorosamente as cores do tema do app.

3. Técnico e Arquitetura

Tema Dinâmico: Use sempre o AppContext para definir cores. Nunca use cores estáticas (ex: #FFF) sem validar o tema (light/dark) do usuário através do objeto C derivado do THEME.
Tipagem Estrita: Siga rigorosamente as interfaces e tipagens definidas no arquivo types.ts.
Integrações de API: O app consome e atualiza o perfil em tempo real nos endpoints GET /api/profile/get-profile/${userId} e PUT /api/profile/update-json.
Validação de Imports: Ao criar ou refatorar telas, valide sempre se os imports de componentes chaves (LinearGradient, Ionicons, AppContext) estão presentes.

Setup Local

Backend (Node.js)

git clone [repo-backend]
cd backend
npm install
npm run dev

Frontend (Expo)

git clone [repo-frontend]
cd frontend
npm install
npx expo start