Desenvolvedor Full-Stack Sênior (Next.js/Node) Plataforma 3 em 1 Tr...

1. VISÃO geral do projeto e contexto de negócio

somos a poloni4u cidadania, uma empresa estabelecida na polônia, visando o público brasileiro descendentes de poloneses. Estamos construindo a plataforma digital da nossa marca voltada para o mercado High-Ticket de Cidadania Polonesa e serviços correlatos.

Não buscamos um "site institucional" genérico ou soluções No-Code frágeis. Precisamos construir uma verdadeira máquina de conversão (SaaS-like), desenhada sob medida para qualificar leads de forma autônoma, processar contratos/pagamentos internacionais e entregar uma experiência Premium de Pós-Venda em uma área logada. A equipe interna focará 100% na operação jurídica; a tecnologia deve rodar sem intervenção humana no fluxo feliz e possuir tratamento de falhas (fallbacks).

1. ARQUITETURA E Módulos do sistema

módulo a: front-end institucional e motor de triagem inteligente

ux/ui: design corporativo, de altíssima performance (mobile-first) e otimizado para seo.

Formulário Condicional (O Coração da Triagem, já temos as regras): O formulário não pode ser uma página longa. Deve seguir o padrão Wizard (uma pergunta por tela com barra de progresso) para maximizar a conversão.

Lógica Modular e Parametrizável (O Coração da Triagem): O formulário não pode ser uma página longa. Deve seguir o padrão Wizard (uma pergunta por tela com barra de progresso) para maximizar a conversão. A árvore de decisão de elegibilidade (as ramificações jurídicas que aprovam/reprovam o cliente) deve ser estruturada de forma independente da interface. O desenvolvedor será o responsável por atualizar essas regras sempre que a legislação mudar, através do nosso contrato de manutenção mensal. A arquitetura deve permitir que você ou terceiro contratado faça essas alterações de forma rápida, segura e sem risco de quebrar o sistema central.

Rotas de Saída: Dependendo das respostas, o sistema fará o roteamento automático:

Elegível com documentos -> Agendamento de reunião (Calendly/Meet).

Elegível sem documentos -> Oferta de compra direta de Busca Genealógica.

Não elegível -> Tela de desqualificação e encerramento do funil.

Módulo B: Motor de Automação, Contratos e Checkout

Orquestração Resiliente: Integração fluida entre o formulário, CRM, geração de contratos e gateway de pagamento. Exigimos tratamento de falhas (retry automático e alertas). Se uma API falhar, o cliente não pode ficar num limbo.

Contratos Digitais: Integração via API/Webhooks com Clicksign ou DocuSign. O contrato deve ser gerado e enviado automaticamente com os dados preenchidos na triagem.

Pagamentos Internacionais (Stripe): Integração obrigatória com Stripe conectado à nossa conta corporativa europeia. O checkout deve possuir trava cambial na interface: o cliente brasileiro precisa ver e pagar o valor final em Reais (BRL), enquanto a liquidação ocorre em Euros (eur/pln) no back-end, sem redirecionamentos confusos.

Módulo C: Portal do Cliente e Painel Admin (A Joia da Coroa)

Área Exclusiva (Client Portal): seguro para os clientes contratantes.

Timeline Visual do Processo: O cliente deve visualizar em qual etapa está (ex: Busca > Traduções > Protocolo MUW > Passaporte), reduzindo o suporte via WhatsApp.

Cofre de Documentos Bidirecional: Upload seguro de documentos pelo cliente (com validação de formato) e download de protocolos inseridos pela nossa equipe.

Painel Admin: Interface para nossa equipe gerenciar os leads, atualizar os status dos processos em lote e auditar os pagamentos.

1. stack tecnológico exigido

para garantir a estabilidade e a experiência de "banco digital", exigimos tecnologias modernas:

front-end: (React) com Tailwind CSS.

Back-end & Banco de Dados:, com PostgreSQL ou Supabase (gerenciamento rigoroso de permissões/rls, dada a sensibilidade dos documentos - adequação total à lgpd/).

Integrações: APIs RESTful, Webhooks estruturados (Make/n8n apenas se justificado para facilitar nossa manutenção futura, caso contrário, código nativo).

Infraestrutura: Vercel ou Aws.

1. entregáveis e diretrizes contratuais

propriedade total: o código-fonte será 100% de nossa propriedade e deverá ser versionado desde o dia 1 no github corporativo da holding.

Tracking de Conversão: Implementação de métricas básicas no funil para identificarmos gargalos de desistência.

Documentação Obrigatória: Mapeamento da arquitetura, Dicionário de Dados e vídeo-manuais (Loom) de como operar o painel Admin e alterar regras da t