Forge Radar

Aplicação privada da MatbForge para organizar projetos de validação, segmentos, empresas potenciais, pesquisas, evidências, score de potencial e próximos passos. O primeiro projeto é criado para o Reloop, mas o modelo suporta outros produtos.

Recursos

• projetos e metas de validação;
• segmentos comparáveis;
• cadastro de empresas e contatos profissionais;
• pipeline até o compromisso de pagamento;
• pesquisas de descoberta, demonstração, piloto e fechamento;
• evidências, citações, objeções, satisfação e intenção de pagamento;
• score transparente de 0 a 100;
• exportação CSV e backup JSON;
• login por e-mail/senha e allowlist;
• Supabase Postgres com Row Level Security;
• implantação em Vercel ou Docker.

Stack

Next.js 16, React 19, TypeScript, Supabase Auth/Postgres e @supabase/ssr.

Implantar na Vercel

1. Supabase

1. Crie um projeto.
2. No SQL Editor, execute todo o arquivo supabase/migrations/202608040001_initial_schema.sql.
3. Em Authentication > Users, crie manualmente seu usuário.
4. Em Authentication > General Configuration, desative Allow new users to sign up.
5. Copie a Project URL e a Publishable key (sb_publishable_...).

Não use nem exponha uma service_role key; o Forge Radar não precisa dela.

2. GitHub e Vercel

1. Crie um repositório privado chamado forge-radar e envie estes arquivos.
2. Importe o repositório na Vercel.
3. Cadastre em Production e Preview:

NEXT_PUBLIC_SUPABASE_URL=https://seu-projeto.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_sua_chave
ALLOWED_EMAILS=seu-email@exemplo.com

4. Clique em Deploy. A Vercel detecta o Next.js; mantenha os comandos padrão.

Desenvolvimento local

Requer Node.js 22.13+ e npm.

cp .env.example .env.local
npm ci
npm run dev

Validação completa:

npm run check

Docker opcional

docker build \
  --build-arg NEXT_PUBLIC_SUPABASE_URL=https://seu-projeto.supabase.co \
  --build-arg NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=sb_publishable_sua_chave \
  -t forge-radar .

docker run --rm -p 3000:3000 \
  -e ALLOWED_EMAILS=seu-email@exemplo.com \
  forge-radar

As variáveis NEXT_PUBLIC_* são públicas por definição. A proteção vem da autenticação, allowlist e RLS. Nunca inclua service_role no frontend ou repositório.

Estrutura

app/                   Interface, login e APIs autenticadas
lib/supabase/          Clientes Supabase de navegador e servidor
lib/server/            Validação, mapeamento e inicialização
supabase/migrations/   Esquema, índices, constraints e RLS
docs/                  Produto, arquitetura, segurança e operação
tests/                 Testes de regras e guardas do esquema

Segurança

• cada requisição confirma a identidade no servidor;
• ALLOWED_EMAILS limita quem entra;
• consultas filtram owner_id e o Postgres repete a proteção com RLS;
• visitantes anônimos não têm permissão nas tabelas;
• nenhuma chave administrativa é usada.

Leia Segurança e privacidade antes de cadastrar dados reais.

Documentação

• Arquitetura
• Modelo de dados
• Implantação
• Produto
• Score
• Pesquisa remota
• Segurança e privacidade
• Validação e formalização

Repositório privado/interno, sem licença open source.