⚡ Data4Build
Plataforma de Inteligência para o Mercado de Construção Civil
DOCUMENTAÇÃO TÉCNICA COMPLETA
Backend · Regras de Negócio · Entidades · Funções · Fluxos
Versão 1.0 · Gerado em 17 de novembro de 2026
📋 Sumário
- 1.Visão Geral da Plataforma
- 2.Arquitetura e Stack Tecnológico
- 3.Entidades do Banco de Dados
- 4.Regras de Negócio — Planos e Assinaturas
- 5.Regras de Negócio — Score de Match
- 6.Regras de Negócio — SuperMatch
- 7.Fluxo de Onboarding
- 8.Fluxo de Pagamento (Stripe)
- 9.Funções Backend (Edge Functions)
- 10.Automações e Tarefas Agendadas
- 11.Sistema de Emails
- 12.Importação de Obras (Fontes de Dados)
- 13.Secrets e Variáveis de Ambiente
- 14.Segurança e Controles de Acesso
- 15.Glossário
1. Visão Geral da Plataforma
O Data4Build é uma plataforma SaaS B2B que conecta fornecedores de materiais e serviços da construção civil a obras em andamento no Brasil. A plataforma coleta, estrutura e enriquece dados de obras de múltiplas fontes públicas, aplica algoritmos de compatibilidade e entrega oportunidades qualificadas para fornecedores cadastrados.
Personas
| Persona | Descrição | Acesso |
|---|
| Fornecedor | Empresa fornecedora de materiais/serviços para construção civil | App principal (mobile-first) |
| Admin | Gestor interno da plataforma Data4Build | Painel admin interno |
| Visitante | Sem conta — acessa landing page | Landing page pública |
URLs Principais
| URL | Página |
|---|
/Landing | Landing page pública |
/Onboarding | Cadastro de novo fornecedor |
/ClientLogin | Login do fornecedor |
/Home | Dashboard principal do fornecedor |
/Oportunidades | Lista de obras compatíveis |
/Pipeline | Gestão do pipeline de vendas |
/Radar | Radar de obras em mapa |
/Notificacoes | Central de alertas |
/SupplierAccount | Perfil e assinatura |
/Checkout | Inicialização do checkout Stripe |
/TrialExpirado | Tela de trial expirado |
/AdminDashboard | Painel admin (role = admin) |
2. Arquitetura e Stack Tecnológico
| Camada | Tecnologia | Detalhes |
|---|
| Frontend | React 18 + Vite | SPA, Tailwind CSS, shadcn/ui, framer-motion |
| Backend / BaaS | Base44 Platform | Banco de dados NoSQL, autenticação, SDK |
| Edge Functions | Deno Deploy | Funções serverless em JS/TS |
| Pagamentos | Stripe | Checkout Sessions + Webhooks |
| Email | Resend + Base44 SendEmail | Transacional e sequências de onboarding |
| Mapas | react-leaflet + Nominatim | OpenStreetMap para geocoding e exibição |
| PDF | jsPDF | Geração de orçamentos em backend |
| Dados externos | ObrasGov API, PNCP, CNO | Fontes públicas de obras |
Autenticação
O app é público (não requer login Base44). A autenticação do fornecedor é gerenciada via localStorage:
localStorage.supplier_id — ID do registro Supplier no bancolocalStorage.supplier_token — Token gerado no login (base64 legacy)
⚠️ Importante — App Público
Por ser app público, todas as Edge Functions que operam sobre dados de fornecedor devem usar base44.asServiceRole ao invés de base44.auth.me(). A autenticação por auth.me() retorna null em contexto público.
3. Entidades do Banco de Dados
3.1 Supplier (Fornecedor)
Entidade principal. Representa um fornecedor cadastrado na plataforma.
| Campo | Tipo | Descrição | Valores |
|---|
company_name | string | Nome da empresa | Obrigatório |
email | email | Email principal de contato | Obrigatório |
whatsapp | string | WhatsApp para contato | Obrigatório |
cnpj | string | CNPJ da empresa | Opcional |
materials | array | Categorias de materiais fornecidos | Ver enum abaixo |
location | string | Cidade/região de atuação | Texto livre |
latitude / longitude | number | Coordenadas geográficas | Decimal |
service_radius | number | Raio de atuação em km | 10, 30, 50, 100, 150 |
plan | string | Plano de assinatura atual | trial / starter / premium |
trial_expires_at | datetime | Data de expiração do trial | ISO 8601 |
onboarding_completed | boolean | Onboarding foi concluído | true/false |
username | string | Username único para login | Único |
password_hash | string | Senha (armazenada como texto — ver aviso) | Sensitivo |
🚨 Pendência de Segurança — password_hash
Atualmente o campo password_hash armazena a senha em texto puro. A função authenticateSupplier compara diretamente supplier.password_hash !== password. Antes do Go Live em produção, implementar bcrypt para hash de senhas.
Enum: materials
| Valor | Rótulo |
|---|
estrutura_aco | Estrutura / Aço |
cimento_concreto | Cimento / Concreto |
eletrica | Elétrica |
hidraulica | Hidráulica |
iluminacao | Iluminação |
revestimentos | Revestimentos |
pisos | Pisos |
esquadrias | Esquadrias |
impermeabilizacao | Impermeabilização |
outros | Outros |
3.2 Construction (Obra)
| Campo | Tipo | Descrição |
|---|
name | string | Nome da obra |
company | string | Nome da construtora |
city | string | Cidade |
address | string | Endereço completo |
contact_name / contact_role / contact_phone | string | Dados do contato de compras |
latitude / longitude | number | Coordenadas geocodificadas |
phase | enum | Fase da obra: fundacao, estrutura, alvenaria, instalacoes, acabamento, entregue |
status | enum | em_andamento, planejada, finalizada |
materials_needed | array | Materiais demandados pela obra (mesmo enum do Supplier) |
units / area_m2 | number | Unidades e área |
source | enum | manual, obrasgov, cno, pncp, csv |
external_id | string | ID único da fonte externa (evita duplicatas) |
score | number | Score de match calculado (0–100) |
pipeline_status | enum | none → contato_iniciado → orcamento_enviado → negocio_fechado |
supermatch_active | boolean | SuperMatch ativo no momento |
supermatch_expires_at | datetime | Expiração do SuperMatch |
views_count / phone_clicks / whatsapp_clicks | number | Métricas de engajamento |
contact_feedback_valid / invalid | number | Votos de validação do contato |
valor_empenhado / valor_pago | number | Dados financeiros (Portal Transparência) |
data_quality_score | number | Score de qualidade dos dados (0–100) |
address_verified / email_valid / phone_valid | boolean | Flags de validação |
3.3 Notification (Notificação)
| Campo | Tipo | Descrição |
|---|
title | string | Título da notificação |
body | string | Corpo da mensagem |
type | enum | supermatch_activated, supermatch_expiring, supermatch_expired, reminder, pipeline_update |
construction_id / construction_name | string | Obra relacionada |
read | boolean | Lida ou não |
created_by | string | Email do fornecedor dono da notificação |
3.4 SuperMatchHistory
| Campo | Tipo | Descrição |
|---|
construction_id / construction_name | string | Obra referenciada |
activated_at / expires_at | datetime | Janela de ativação |
pipeline_status_at_close | enum | Status do pipeline quando o SuperMatch foi encerrado |
reminder_at / reminder_set | datetime/bool | Dados do lembrete |
score | number | Score no momento da ativação |
3.5 AppConfig
| Campo | Default | Descrição |
|---|
suspicious_contact_threshold | 2 | Votos negativos para marcar contato suspeito |
supermatch_duration_hours | 24 | Duração do SuperMatch em horas |
4. Regras de Negócio — Planos e Assinaturas
4.1 Planos Disponíveis
| Plano | Valor | Obras Visíveis | SuperMatch | Duração |
|---|
| Trial | Grátis | Até 2 | Não | 7 dias a partir do cadastro |
| Starter | 12x R$ 1.290/mês | Até 10 | 1 por mês | Contrato anual (12 meses) |
| Premium | 12x R$ 2.490/mês | Ilimitadas | Ilimitado | Contrato anual (12 meses) |
4.2 Regras de Acesso por Plano (trialUtils)
// isTrialActive(supplier) → boolean
// Planos pagos (starter/premium) sempre retornam true.
// Plan 'trial': retorna true apenas se trial_expires_at > agora.
// isTrialExpired(supplier) → boolean
// Planos pagos NUNCA expiram (retorna false).
// Plan 'trial': sem data OU data passada = true.
// getVisibleLimit(supplier) → number
// premium → Infinity
// starter → 10
// trial → 2
// canSeeSuperMatch(supplier) → boolean
// Apenas plan === 'premium'
4.3 Ciclo de Vida da Assinatura
- 1. Fornecedor se cadastra no Onboarding → conta criada com
plan: "trial" e trial_expires_at = agora + 7 dias. - 2. Se escolher plano pago no Onboarding → redirecionado para
/Checkout?plan=starter|premium. - 3. Checkout inicializa via
createCheckout → gera URL do Stripe Checkout. - 4. Após pagamento aprovado → Stripe dispara webhook
checkout.session.completed. - 5.
stripeWebhook atualiza Supplier.plan para o plano pago e zera trial_expires_at. - 6. Quando assinatura é cancelada → Stripe dispara
customer.subscription.deleted. - 7.
stripeWebhook rebaixa Supplier.plan para "trial".
4.4 Price IDs Stripe (Test Mode)
| Plano | Price ID | Valor |
|---|
| Starter | price_1T7z1oPt4BGSaQVcBcPCZHW6 | R$ 1.290/mês |
| Premium | price_1T7z1oPt4BGSaQVcKEabIL0E | R$ 2.490/mês |
5. Regras de Negócio — Score de Match
O score de compatibilidade entre um fornecedor e uma obra é calculado em dois eixos, totalizando 0 a 100 pontos:
5.1 Materiais (até 50 pts)
// Intersecção entre supplier.materials e construction.materials_needed
const matches = supplierMats.filter(m => constructionMats.includes(m)).length;
score += Math.round((matches / Math.max(supplierMats.length, constructionMats.length)) * 50);
5.2 Distância (até 50 pts)
// Fórmula de Haversine para distância em km
// Se distância < service_radius:
score += Math.round(50 * (1 - dist / radius));
// Se sem geolocalização: +20 pts (benefício médio)
// Se fora do raio: 0 pts
5.3 Interpretação do Score
| Faixa | Classificação | Cor |
|---|
| 85–100 | Excelente | Verde |
| 70–84 | Bom | Verde claro |
| 50–69 | Regular | Amarelo |
| 0–49 | Baixo | Cinza |
6. Regras de Negócio — SuperMatch
O SuperMatch é uma funcionalidade exclusiva do plano Premium que permite ao fornecedor acessar dados completos de contato e informações privilegiadas de uma obra específica por um período limitado.
| Regra | Detalhe |
|---|
| Acesso | Apenas plano Premium |
| Duração padrão | 24 horas (configurável em AppConfig) |
| Histórico | Registrado em SuperMatchHistory |
| Notificação | Cria registro em Notification ao ativar |
| Expiração | construction.supermatch_expires_at controla acesso |
| Pipeline | Ao encerrar, registra pipeline_status_at_close |
| Lembrete | Pode configurar lembrete via reminder_at |
7. Fluxo de Onboarding
7.1 Etapas do Wizard
| Step | Componente | Dados coletados |
|---|
| 1 — Dados Básicos | StepOne | company_name, email, whatsapp, username, password |
| 2 — Materiais | StepTwo | materials (multi-select) |
| 3 — Localização | StepThree | location, latitude, longitude, service_radius |
| 4 — Plano | StepPlan | plan (trial / starter / premium) |
7.2 Regras Críticas do Onboarding
🚨 REGRA FUNDAMENTAL
O Supplier SEMPRE é criado com plan: "trial", independente do plano selecionado no Step 4. A ativação do plano pago ocorre exclusivamente via webhook do Stripe após confirmação de pagamento.
// Onboarding.jsx — mutationFn
const supplier = await base44.entities.Supplier.create({
...formData,
plan: 'trial', // SEMPRE trial no cadastro
trial_expires_at: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
});
// Após criar, salva supplier_id no localStorage
localStorage.setItem('supplier_id', supplier.id);
// Se plano pago → redireciona para /Checkout?plan=starter|premium
if (formData.plan !== 'trial') {
window.location.href = createPageUrl('Checkout?plan=' + formData.plan);
}
7.3 Persistência
Durante o wizard, os dados são salvos em sessionStorage['onboarding_data'] para sobreviver a reloads. Após a criação da conta, o sessionStorage é limpo.
8. Fluxo de Pagamento (Stripe)
8.1 Diagrama do Fluxo
Frontend (/Checkout) → createCheckout [Edge Fn]
→ Stripe API: criar Checkout Session
→ Retorna URL do Stripe Checkout
Frontend → redireciona para URL Stripe
Usuário paga → Stripe processa
Stripe → POST stripeWebhook [Edge Fn]
→ Verifica assinatura HMAC
→ evento checkout.session.completed
→ Atualiza Supplier.plan para plano pago
→ Cria Notification de boas-vindas
Stripe → Redireciona para /Home?upgraded=true&plan=X
Home → exibe banner de confirmação
8.2 Proteção contra iframe
// SupplierAccount.jsx — handleCheckout()
if (window.self !== window.top) {
alert('O checkout só funciona no app publicado.');
return;
}
// Checkout.jsx também verifica:
if (window !== window.top) {
setError('Acesse app.data4build.com para assinar.');
return;
}
8.3 Metadata obrigatória na Session Stripe
metadata: {
base44_app_id: Deno.env.get("BASE44_APP_ID"), // rastreamento Base44
supplier_id: resolvedSupplierId,
supplier_email: customerEmail,
plan: 'starter' | 'premium',
billing: 'annual' | 'monthly',
},
subscription_data: {
metadata: {
supplier_id, supplier_email, plan, billing
}
}
8.4 Eventos Stripe Monitorados
| Evento | Ação |
|---|
checkout.session.completed | Atualiza Supplier.plan → plano pago, limpa trial_expires_at, cria Notification |
customer.subscription.deleted | Rebaixa Supplier.plan → "trial" |
9. Funções Backend (Edge Functions)
Todas as funções são Deno Deploy handlers. Importam o SDK via npm:@base44/sdk@0.8.20.
9.1 createCheckout
| Campo | Valor |
|---|
| Arquivo | functions/createCheckout.js |
| Autenticação | Opcional (app público). Tenta auth, mas aceita sem ela. |
| Entrada | plan, billing, supplier_id, supplier_email, success_url, cancel_url |
| Saída | { url: string } — URL do Stripe Checkout |
| Dependência | Stripe SDK (npm:stripe@14.21.0), STRIPE_SECRET_KEY |
9.2 stripeWebhook
| Campo | Valor |
|---|
| Arquivo | functions/stripeWebhook.js |
| Autenticação | Verificação HMAC via stripe.webhooks.constructEventAsync() |
| Entrada | Payload raw do Stripe + header stripe-signature |
| Eventos tratados | checkout.session.completed, customer.subscription.deleted |
| Dependências | STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET |
⚠️ Deno Async: Usa constructEventAsync() (não constructEvent()). Deno usa Web Crypto API assíncrona — a versão síncrona lança erro.
9.3 getSupplier
| Campo | Valor |
|---|
| Arquivo | functions/getSupplier.js |
| Autenticação | Nenhuma (app público). Usa asServiceRole. |
| Entrada | { supplier_id: string } |
| Saída | Dados do Supplier sem o campo password_hash |
| Uso | TrialGuard, SupplierAccount, Home — em vez de chamar entities diretamente (que falharia em app público) |
9.4 authenticateSupplier
| Campo | Valor |
|---|
| Arquivo | functions/authenticateSupplier.js |
| Entrada | { username: string, password: string } |
| Saída | { success, token, supplierId, company_name } |
| Segurança | ⚠️ Senha comparada em texto puro. Pendente bcrypt. |
| Token | Base64 simples: btoa(supplierId + ':' + timestamp). Pendente JWT. |
9.5 sendWelcomeEmail
| Campo | Valor |
|---|
| Arquivo | functions/sendWelcomeEmail.js |
| Entrada | { email: string, supplier_name: string } |
| Provider | Base44 SendEmail integration (usa RESEND por baixo) |
| Disparado por | Onboarding ao criar conta |
9.6 emailAutomations
| Campo | Valor |
|---|
| Arquivo | functions/emailAutomations.js |
| Autenticação | Requer user.role === 'admin' |
| Entrada | { type: "welcome"|"day3"|"day6"|"churn48h"|"all" } |
| Rate limit | Delay de 600ms entre envios (limite Resend 2 req/s) |
| Filtro | Apenas suppliers com plan === "trial" |
Sequência de Emails por Tipo
| Tipo | Critério | Assunto |
|---|
welcome | Dia 0 (criação) | Bem-vindo à Data4Build! 🚀 |
day3 | 3 dias após cadastro | Você já explorou as oportunidades da sua região? |
day6 | 6 dias após cadastro | ⏰ Seu teste gratuito termina amanhã |
churn48h | Trial expira em <48h | ⚠️ Menos de 48h para seu acesso expirar |
9.7 notifyNewMatches
| Campo | Valor |
|---|
| Arquivo | functions/notifyNewMatches.js |
| Entrada | Opcional: { construction_ids: string[] }. Sem entrada → últimas 25h. |
| Threshold | Notifica supplier apenas se score ≥ 50% |
| Ações | Cria Notification no banco + envia email HTML estilizado |
| Agendamento | Recomendado: diário às 8h |
9.8 notifyPipelineUpdate
| Campo | Valor |
|---|
| Arquivo | functions/notifyPipelineUpdate.js |
| Trigger | Automation de entidade (Construction update) |
| Aciona quando | pipeline_status muda para orcamento_enviado ou negocio_fechado |
| Ação | POST para PIPELINE_WEBHOOK_URL (se configurada) |
9.9 generateQuotePDF
| Campo | Valor |
|---|
| Arquivo | functions/generateQuotePDF.js |
| Entrada | { constructionId: string, supplierId?: string } |
| Saída | Binário PDF (Content-Type: application/pdf) |
| Conteúdo | Header, dados da obra, materiais, resumo financeiro, footer com data |
| Dependência | npm:jspdf@2.5.1 |
9.10 importObrasGov
| Campo | Valor |
|---|
| Arquivo | functions/importObrasGov.js |
| Autenticação | Sessão admin assinada (JWT 8h) via _admin_token + isAdminAuthorized() |
| API Externa | https://api.obrasgov.gestao.gov.br/obrasgov/api |
| Parâmetros | uf, municipio, tipo, page, size, dry_run |
| Dedup | Verifica external_id antes de inserir |
| Geocoding | Nominatim (OpenStreetMap) para lat/lon por cidade |
| Rate limit | Retry automático com delay 5s em HTTP 429 |
9.11 importObrasGovScheduled
Versão automática do importObrasGov. Itera por todas as 27 UFs brasileiras, até 3 páginas por UF (150 obras/UF). Executa como tarefa agendada semanal.
9.12 importCNO
Importa dados do CNO (Cadastro Nacional de Obras). Atualmente usa dados de exemplo estruturados. Limitações: sem contatos (LGPD), sem fase de obra, geolocalização ~30% incompleta.
9.13 importPNCP
Importa licitações do PNCP (Portal Nacional de Contratações Públicas). Cruza com obras CNO existentes pela cidade e materiais. Cria obras novas se não houver match.
10. Automações e Tarefas Agendadas
| Nome | Tipo | Função | Frequência |
|---|
| Importação Semanal ObrasGov | Scheduled | importObrasGovScheduled | Semanal (recomendado: seg 3h) |
| Notificar Novos Matches | Scheduled | notifyNewMatches | Diário (recomendado: 8h) |
| Pipeline Update Webhook | Entity (Construction) | notifyPipelineUpdate | A cada update em Construction |
| Email Day 3 Trial | Scheduled / Manual | emailAutomations | Diário (type: day3) |
| Email Day 6 Trial | Scheduled / Manual | emailAutomations | Diário (type: day6) |
| Email Churn 48h | Scheduled / Manual | emailAutomations | Diário (type: churn48h) |
11. Sistema de Emails
11.1 Providers
| Provider | Uso |
|---|
| Base44 SendEmail (Resend internamente) | Emails de boas-vindas, notificações de match |
| Resend direto via API REST | Sequência de onboarding (emailAutomations) |
11.2 Emails Disparados
| Email | Quando | Função |
|---|
| Boas-vindas HTML | Ao criar conta | sendWelcomeEmail |
| Novos matches | Diariamente (novas obras) | notifyNewMatches |
| Engajamento dia 3 | 3 dias após cadastro (trial) | emailAutomations |
| Urgência dia 6 | 6 dias após cadastro (trial) | emailAutomations |
| Anti-churn 48h | Trial expira em <48h | emailAutomations |
12. Importação de Obras — Fontes de Dados
12.1 ObrasGov (Principal)
| Item | Detalhe |
|---|
| API Base | https://api.obrasgov.gestao.gov.br/obrasgov/api |
| Endpoint obras | /projeto-investimento?situacao=Em+Execução&uf=SP&page=0&size=50 |
| Endpoint % execução | /execucao-fisica?idUnico=X&page=0&size=1 |
| Dedup | Campo external_id com idUnico da API |
| Geocoding | Nominatim por cidade+UF |
| Rate limit | HTTP 429 → retry automático com delay 5s |
Mapeamento de Fase (% execução física)
| % Execução | Fase mapeada |
|---|
| ≥95% ou "concluída" | entregue |
| 75–94% | acabamento |
| 50–74% | instalacoes |
| 30–49% | alvenaria |
| 10–29% | estrutura |
| 0–9% | fundacao |
12.2 CNO — Cadastro Nacional de Obras
Dados distribuídos como CSV pelo Portal de Dados Abertos. Atualmente função usa dados estruturados de exemplo. Limitações: sem contatos (LGPD), fase sempre "fundação", geolocalização incompleta (~30%).
12.3 PNCP — Portal Nacional de Contratações Públicas
Licitações públicas. Função faz cruzamento com obras CNO existentes por cidade e materiais. Se não houver match, cria nova Construction com source: "pncp".
13. Secrets e Variáveis de Ambiente
| Secret | Uso | Status |
|---|
STRIPE_SECRET_KEY | Criar Checkout Sessions e verificar webhooks | ✅ Configurado |
STRIPE_PUBLISHABLE_KEY | Frontend Stripe.js (não usado atualmente) | ✅ Configurado |
STRIPE_WEBHOOK_SECRET | Validar assinatura HMAC do webhook | ✅ Configurado |
RESEND_API_KEY | emailAutomations (sequência de onboarding) | ✅ Configurado |
TRANSPARENCIA_API_KEY | Portal da Transparência (dados financeiros) | ✅ Configurado |
BASE44_APP_ID | ID do app (pré-populado pelo Base44) | ✅ Automático |
PIPELINE_WEBHOOK_URL | URL para receber webhooks de pipeline update | ⚠️ Opcional (não obrigatório) |
14. Segurança e Controles de Acesso
14.1 Controle de Acesso Frontend
| Componente | Proteção |
|---|
AuthGuard | Verifica localStorage.supplier_id. Sem ID → redireciona para Landing. |
TrialGuard | Chama getSupplier (serviceRole) e verifica isTrialExpired(). Se expirado → redireciona para /TrialExpirado. |
AdminGuard | Verifica user.role === "admin" via Base44 auth. |
14.2 Controle de Acesso Backend
| Função | Controle |
|---|
| emailAutomations | Requer user.role === "admin" |
| importObrasGov | Requer sessão admin assinada (isAdminAuthorized) |
| stripeWebhook | Verificação HMAC Stripe obrigatória |
| getSupplier | Retorna dados sem password_hash |
14.3 Pendências de Segurança (Pré Go-Live)
- 🔴 Senhas em texto puro:
authenticateSupplier compara sem hash. Implementar bcrypt antes de go-live em produção. - 🔴 Token de sessão fraco: Token é Base64 simples. Implementar JWT com expiração.
- 🟢 Admin token hardcoded: resolvido — todas as funções admin usam sessão assinada (
isAdminAuthorized) ou token interno de rotina. - 🟡 Rate limiting: Sem proteção de rate limit nas Edge Functions públicas.
15. Glossário
| Termo | Definição |
|---|
| Supplier | Fornecedor de materiais ou serviços cadastrado na plataforma |
| Construction | Obra de construção civil cadastrada no sistema |
| Score | Pontuação 0-100 de compatibilidade entre Supplier e Construction |
| SuperMatch | Acesso privilegiado Premium a dados completos de uma obra por 24h |
| Pipeline | Funil de vendas do fornecedor com etapas de progresso |
| Trial | Período de teste gratuito de 7 dias após o cadastro |
| TrialGuard | Componente React que bloqueia acesso quando o trial expira |
| AuthGuard | Componente React que bloqueia acesso sem autenticação |
| ObrasGov | API pública do governo com obras federais em execução |
| CNO | Cadastro Nacional de Obras — base LGPD do governo |
| PNCP | Portal Nacional de Contratações Públicas — licitações abertas |
| Nominatim | Serviço de geocoding do OpenStreetMap (gratuito) |
| asServiceRole | Permissão elevada do SDK Base44 para operações admin sem auth de usuário |
| external_id | ID da fonte externa (ObrasGov, CNO) para evitar duplicatas |
| data_quality_score | Score 0-100 da completude dos dados de uma obra |
⚡ Data4Build — Documentação Técnica
Versão 1.0 · Gerado em 17 de novembro de 2026 · Confidencial
Para atualizar este documento, acesse /Documentacao no app e use o botão de impressão para gerar PDF.