PRD · MVP v1.0 · novembro de 2026
Sistema pro& Premium — documento de requisitos do produto
O que o MVP faz, para quem, como se mede o sucesso e quais são as regras. Cada requisito aponta para a tela que já existe no código inicial.
01
Visão e problema
Problema. Empreiteiras gerais respondem solidariamente pelos subempreiteiros. Hoje o controle de CND, FGTS, ASO, NR e seguros vive em planilhas, WhatsApp e e-mail: documentos vencem sem aviso, ninguém sabe quem pode entrar na obra e não há prova de diligência.
Solução. Um sistema que gera o checklist certo para cada empresa em cada obra, cobra o subempreiteiro pelo celular, exige conferência humana, bloqueia quem está irregular e guarda uma trilha que não pode ser alterada.
Para quem (MVP). Empreiteiras de 5 a 80 funcionários, com 2 a 20 obras/ano e 10 a 150 subempreiteiros. Usuários: gestor de obras, segurança do trabalho, diretor e jurídico; do outro lado, o dono da subempreiteira.
02
Objetivos e métricas do MVP
| Objetivo | Métrica | Meta em 90 dias |
|---|---|---|
| Ativação rápida | Tempo até a 1ª cobrança enviada | < 15 min (mediana) |
| Uso real | Empreiteiras com ≥ 1 obra e ≥ 5 subs | 70% das contas em trial |
| Adesão do sub | Pendências resolvidas pelo portal em 7 dias | ≥ 60% |
| Prevenção | Obras iniciadas com 0 bloqueados | ≥ 85% |
| Negócio | Conversão trial → pago | ≥ 20% |
| Qualidade | Lembretes não enviados por falha | 0 |
03
Escopo do MVP
Dentro
- • Conta, empresa e papéis
- • Obras e subempreiteiros
- • Checklist por especialidade
- • Matriz com semáforo e bloqueio
- • Portal sem senha
- • Conferência humana
- • Cobrança e alerta pré-obra
- • Trilha de auditoria + CSV
Fora (depois do MVP)
- • Leitura automática de documento (OCR)
- • Consulta automática a órgãos (Receita, Caixa, TST)
- • Integração com ERP e agenda
- • API pública e SSO
- • Aplicativo nativo
- • Portal único do subempreiteiro entre empreiteiras
04
Requisitos funcionais
| ID | Requisito | Descrição | Prioridade | Tela |
|---|---|---|---|---|
| RF-01 | Conta e empresa | Cadastro com nome, empreiteira e CNPJ; cria a empresa e o primeiro usuário como administrador. Trial de 14 dias. | P0 | /entrar |
| RF-02 | Obras | Cadastrar obra com nome, endereço, responsável, início e fim. Situação planejada/ativa/pausada/concluída. | P0 | /obras |
| RF-03 | Subempreiteiros | Cadastro com razão social, CNPJ (validado pelos dígitos e único por empresa), especialidade e contatos. | P0 | /subempreiteiros |
| RF-04 | Checklist por especialidade | Ao vincular um subempreiteiro a uma obra, gerar as exigências a partir do modelo da especialidade (base fiscal/trabalhista/SST + itens técnicos). | P0 | /obras/:id |
| RF-05 | Status do documento | Ausente → Em análise → Válido / Vencendo (≤ 15 dias) / Vencido / Reprovado. Calculado a partir da última versão. | P0 | Matriz |
| RF-06 | Liberação na obra | Bloqueado se alguma exigência obrigatória com regra “bloqueia” não está válida/vencendo; Alerta se só pendências de alerta; Liberado caso contrário. | P0 | Matriz |
| RF-07 | Liberação por exceção | Admin ou gestor libera um bloqueado com justificativa (mín. 15 caracteres). Fica na trilha com nome e data. | P0 | Matriz |
| RF-08 | Alerta pré-obra (14 dias) | Obras com início em até 14 dias e empresa bloqueada aparecem em destaque no Radar, com “Cobrar todos”. | P0 | /radar |
| RF-09 | Portal do subempreiteiro | Link único sem senha; lista o que falta, envio por foto ou arquivo, validade informada, motivo de reprovação visível. | P0 | /portal/:token |
| RF-10 | Conferência humana | Fila de documentos em análise; ver arquivo, confirmar validade, aprovar ou reprovar com motivo de lista + comentário. | P0 | /conferencia |
| RF-11 | Cobrança | Cobrar uma empresa ou em lote; registra canal, nível e quantidade de itens. Envio real por e-mail e WhatsApp. | P0 | Ficha / Matriz |
| RF-12 | Trilha de auditoria | Todo envio, decisão, cobrança e exceção vira evento imutável, encadeado por hash; exportação CSV. | P0 | /auditoria |
| RF-13 | Lembretes automáticos | Rotina diária: 30, 15, 7, 3, 1 dia antes e no vencimento; no máximo 1 mensagem/dia por empresa e canal. | P1 | Rotina |
| RF-14 | Escalonamento | Nível 2 (responsável interno) após 3 dias úteis sem resposta; nível 3 (gestor da obra) após 5 ou se faltar ≤ 3 dias. | P1 | Rotina |
| RF-15 | Importar planilha | Importar subempreiteiros de CSV/XLSX com prévia e correção de erros antes de gravar. | P1 | /subempreiteiros |
| RF-16 | Relatório “Pronto para obra” | PDF por obra com situação de cada empresa e data/hora de emissão. | P1 | Matriz |
P0 = obrigatório para lançar o beta. P1 = até o fim das 12 semanas.
05
Histórias de usuário e critérios de aceite
Como gestor de obras, quero ver em uma tela quem está bloqueado em cada obra, para não descobrir no dia em que a equipe chega.
- ✓ Radar mostra % de conformidade, liberados, bloqueados e vencendo
- ✓ Obra com início ≤ 14 dias e bloqueio aparece em faixa vermelha
- ✓ Clique leva à matriz da obra filtrável
Como técnica de segurança, quero conferir documentos enviados e reprovar com motivo, para o subempreiteiro saber exatamente o que corrigir.
- ✓ Reprovar exige motivo de lista
- ✓ Status vira Reprovado e a empresa volta a ficar bloqueada
- ✓ Motivo aparece no portal do subempreiteiro
- ✓ Evento gravado na trilha
Como subempreiteiro, quero enviar o documento pelo celular, sem criar conta, para resolver em menos de 3 minutos.
- ✓ Link abre direto a lista de pendências
- ✓ Botões de câmera e de arquivo
- ✓ Após envio, item muda para Em análise
- ✓ Link inválido mostra mensagem clara
Como diretor, quero liberar um bloqueado em caso excepcional, para não parar a obra quando a pendência é burocrática.
- ✓ Só admin/gestor vê o botão
- ✓ Justificativa obrigatória (≥ 15 caracteres)
- ✓ Selo “por exceção” na matriz
- ✓ Evento com nome, data e motivo na trilha
Como jurídico, quero exportar a trilha completa, para provar diligência em fiscalização ou processo.
- ✓ Exporta CSV com data, ator, ação e detalhe
- ✓ Nenhuma tela permite editar ou apagar eventos
- ✓ Banco recusa alteração de evento
06
Requisitos não funcionais
| Tema | Requisito |
|---|---|
| Segurança | Separação por empreiteira no banco (cada registro tem a empresa e as regras de acesso filtram por ela). Senhas nunca guardadas pelo app. Links do portal com token aleatório, expiração de 60 dias e revogação. |
| LGPD | Base legal: execução de contrato e obrigação legal. CPF de colaborador só quando o documento exige. Exclusão anonimiza dados pessoais e mantém o evento. |
| Desempenho | Radar abre em < 2 s com 300 subempreiteiros. Portal abre em < 3 s em 3G. |
| Disponibilidade | 99,5% no mês. Backup diário com retenção de 30 dias. |
| Acessibilidade | Contraste AA, navegação por teclado, cor nunca é a única pista (selos têm texto). |
| Auditoria | Eventos só de inserção, encadeados por hash; arquivos com hash SHA-256 no envio. |
07
Matriz de permissões
| Ação | Admin | Gestor | Engenheiro | Segurança | Financeiro | Jurídico |
|---|---|---|---|---|---|---|
| Ver Radar e obras | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Cadastrar obra e subempreiteiro | ✓ | ✓ | ✓ | — | — | — |
| Conferir (aprovar/reprovar) | ✓ | ✓ | — | ✓ | — | — |
| Cobrar | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| Liberar por exceção | ✓ | ✓ | — | — | — | — |
| Exportar trilha | ✓ | ✓ | — | — | ✓ | ✓ |
| Usuários e plano | ✓ | — | — | — | — | — |
08
Dados e estados
Entidades do MVP: empreiteiras, perfis, obras, subempreiteiros, vínculos (sub × obra), exigências (documento exigido por vínculo), documentos (versões), links do portal, notificações e eventos de auditoria. O script do banco está pronto no código, com as regras de acesso por empresa.
| Status | Quando | Efeito na liberação |
|---|---|---|
| Ausente | nenhuma versão enviada | bloqueia* |
| Em análise | última versão sem decisão | bloqueia* |
| Reprovado | última versão reprovada | bloqueia* |
| Válido | aprovado e validade > hoje + 15 | libera |
| Vencendo | aprovado e validade em até 15 dias | libera + avisa |
| Vencido | validade < hoje | bloqueia* |
* só quando a exigência é obrigatória e a regra é “bloqueia”; com regra “alerta”, a empresa fica Com alerta.
09
Entrega e lançamento
| Período | Entrega | Situação |
|---|---|---|
| Semana 1–2 | Conta, empresa, papéis, separação de dados; casca do sistema | Pronto no código: telas e banco |
| Semana 3–4 | Obras, subempreiteiros, checklist por especialidade | Pronto no código: telas |
| Semana 5–6 | Portal, envio com versões, conferência | Pronto no código: telas |
| Semana 7–8 | Matriz, liberação, exceção, alerta pré-obra | Pronto no código: telas |
| Semana 9–10 | E-mail/WhatsApp reais, lembretes, escalonamento, PDF | A fazer |
| Semana 11–12 | Pagamento, onboarding guiado, beta com 10 empreiteiras | A fazer |
10
Questões em aberto
- Qual provedor de WhatsApp oficial (custo por conversa define o limite por plano)?
- Validade padrão quando o documento não traz data: usar a do tipo ou exigir do revisor?
- Documentos por colaborador (ASO, NR) entram no MVP ou no P1?
- O subempreiteiro que atende várias empreiteiras terá um portal único no futuro?
- Qual gateway de pagamento (Pix recorrente e nota fiscal)?