GenPro360 — Visão Técnica Completa

Stack Tecnológica

⚡

Linguagem

TypeScript 5

JavaScript tipado — mais seguro, menos bugs em produção

padrão enterprise

⚛️

Frontend

React 18 + Vite 5

SPA moderna — rápida, modular, escalável. Sem SSR (não necessário para ERP)

✓ Arquiteto: SPA confirmada

🗺️

Roteamento

TanStack Router v1

File-based routing — type-safe, sem erros de rota

v1 stable

🔄

Data Fetching

TanStack Query v5

Cache inteligente — staleTime 2min, retry 1, sem refetch no foco

🎨

Tailwind + shadcn/ui + Radix UI

Design system consistente — componentes acessíveis, customizáveis

📋

Forms & Validação

React Hook Form + Zod

Forms performáticos + validação tipada com .nullish() em opcionais

RHF + Zod

🦕

Backend / Edge Functions

Supabase Deno

Serverless na edge — service role EXCLUSIVO aqui, nunca no client

✓ Webhooks são Edge Functions

🐘

Banco de Dados

PostgreSQL 15

Supabase autônomo sa-east-1 — RLS multitenancy real por company_id

✓ user_sessions para switchCompany

🔐

Autenticação

Supabase Auth

JWT + RLS — isolamento total por empresa sem refresh de token

JWT + RLS

☁️

Deploy

Cloudflare Pages

CDN global — carregamento rápido no Brasil, SSL automático

✓ Correto para SPA

🤖

CI/CD

GitHub Actions

Deploy automático a cada merge aprovado pelo QA

2000min/mês free

📊

Charts & Notificações

Recharts + Sonner

Gráficos financeiros + toasts elegantes

Sprint 1+

Decisões do Arquiteto (v2.1)

✅ Aprovado em 15/05/2026

SPA Vite 5 confirmado — sem SSR (correto para ERP, SEO irrelevante)
Dados createServerFn removido — operações service role vão para Edge Functions
Auth switchCompany via tabela user_sessions — sem JWT refresh, sem race condition
Webhooks Stripe / NFE.io / Clicksign como Edge Functions dedicadas
Isolamento modules/X nunca importa de modules/Y — isolamento total entre domínios
Repo mmpavao/genpro360 tornado público para acesso do time

Infraestrutura

🐙

GitHub

mmpavao/genpro360
Branch: main · Público
CI/CD via GitHub Actions

Ativo

🗄️

Supabase

Banco + Auth + Storage
Região: sa-east-1 (São Paulo)
Organização: GenPro360 HUB

Ativo

☁️

Cloudflare

DNS + Pages
Domínio: genpro360.com
Zone ID: 2ee81fa2...

Aguardando DNS

🌐

Domínio

genpro360.com
Registrado na Hostoo.io
Nameservers → Cloudflare

Em transferência

📚

Docs

genpro360-docs.pages.dev
Stack overview permanente
PRD no /docs do repo

Ativo

📦

Legado (somente leitura)

mmpavao/genpro360245
v2.4.6 arquivado
Apenas para consulta

Arquivado

Time

👨‍💼

CEO / CTO

Marcio Pavão

Visão do produto, decisões estratégicas, aprovação final de releases

🤖

Agente IA · PM

BASE

Gerencia o time, infra via API, PRD, sprints e comunicação

🏗️

Dev Sênior

Wilson

Coordena o time técnico, revisa PRD e valida arquitetura

📐

Arquiteto IA

Arquiteto

Define estrutura técnica, padrões, plano por sprint em JSON

🎨

Frontend Dev IA

Front-End

React, Vite, TanStack Router — interface e experiência do usuário

⚙️

Backend Dev IA

Back-End

Supabase, Edge Functions, banco de dados, regras de negócio

🧪

QA Tester IA

Testes automatizados, validação, aprovação de merges

🚀

DevOps IA

DevOps

GitHub Actions, Cloudflare deploy, ambientes e monitoramento

Fluxo de Desenvolvimento

📋 Marcio aprova

→

🤖 BASE distribui

→

📐 Arquiteto planeja

→

👨‍💻 DEV codifica

→

📐 Arquiteto revisa

→

🧪 QA valida

→

🚀 Deploy automático

→

✅ Marcio vê rodando

Roadmap de Sprints

Sprint 0 — Fundação

▶ Em execução

F1: Schema SQL (000_foundation.sql) + Auth
F2: Multi-empresa + switchCompany (user_sessions)
F3: AppLayout (sidebar, topbar, mobile nav)
F4: Onboarding + convites de empresa
CI/CD GitHub Actions + deploy Cloudflare

Sprint 1 — Financeiro Core

⏳ Próxima

Contas a pagar e receber
Lançamentos manuais
Categorias e centros de custo
Dashboard financeiro
DRE simplificado + fluxo de caixa

Sprint 2 — CRM & Cadastros

○ Fase 2

Clientes e fornecedores
Pipeline de vendas
Histórico de interações

Sprint 3-5 — Contábil, BPO & Fiscal

○ Fase 3

Módulo contábil completo
Multi-contabilidade (BPO)
NF-e / NFS-e via NFE.io
API pública v1

Custo de Infraestrutura

GitHub

repo público free

Supabase

$0→$25

free agora · pro em produção

Cloudflare Pages

500 builds/mês free

Domínio .com

~$10

por ano (já pago)

Links do Projeto

🐙

Repositório GitHub

github.com/mmpavao/genpro360

📄

PRD v2.1

github.com/.../docs/PRD.md

🌐

Stack Overview (este doc)

genpro360-docs.pages.dev