Fluxo funcional de produto

Da criação da conta ao acompanhamento completo da obra.

Este mapa reflete a aplicação atual: autenticação, conta multi-tenant, cadastro de obras, módulos operacionais, controle de licença, uploads e painel administrativo.

Macrofluxo

Sequência principal esperada para operação comercial e uso diário.

Aquisição

Público

Landing

Apresenta proposta, benefício e caminho para entrar ou criar conta.

Acesso

Cadastro

Cria usuário, empresa/conta e vínculo inicial de tenant.

Acesso

Login

Autentica sessão e redireciona usuários internos para o dashboard.

Proteção

Proxy

Rotas internas exigem sessão válida; usuário sem sessão volta ao login.

Home

Dashboard

Mostra leitura geral de obras, métricas, alertas e atalhos.

Operação

Conta

Minha Conta

Edita dados da empresa, contato, cidade, estado e identidade da conta.

Obras

Lista de Obras

Busca, filtra e abre obras vinculadas à conta do usuário.

Obra

Nova Obra

Cadastra dados básicos, cliente, endereço, status, datas e observações.

Obra

Visão Geral

Centraliza resumo executivo, alertas e links rápidos da obra.

Rotina

Módulos

Planejamento, materiais, financeiro, caixa, mão de obra, diário e documentos.

Gestão

Licença

Status da Obra

Controla obra ativa, expirada, renovada, histórica ou cancelada.

Cliente

Portal

Prévia do que o cliente pode acompanhar sem expor controles internos.

Admin

Painel Admin

Visão administrativa de contas, obras, métricas e licenças.

Admin

Contas

Audita e gerencia contas cadastradas na plataforma.

Admin

Obras

Acompanha obras por conta, status operacional e licença.

Módulos da Obra

Cada obra concentra dados operacionais separados por `project_id` e `account_id`.

Visão Geral

Base

Resumo executivo da obra e pontos de decisão rápidos.

Dados cadastrais
Status e alertas
Atalhos de ação

Dashboard

Indicadores

Camada visual para análise de andamento e custo.

Gráficos
KPIs
Leitura consolidada

Planejamento

Execução

Organiza etapas, orçamento por frente e progresso.

Etapas
Desvios
Progresso consolidado

Materiais

Custos

Acompanha itens, compras e custo por etapa.

Itens e status
Filtros rápidos
Leitura de orçamento

Financeiro

Caixa

Mostra entradas, saídas, saldo e visão financeira da obra.

Receitas
Despesas
Saldo operacional

Caixa

Movimento

Fluxo específico para registrar e revisar movimentações.

Lançamentos
Classificação
Histórico

Mão de Obra

Equipe

Controla contratos, medições e avanço por equipe.

Contratos ativos
Medições
Saldo contratual

Diário e Atualizações

Registro

Timeline de execução, fotos, notas e arquivos da obra.

Atualizações
Uploads
Resumo semanal

Documentos

Arquivo

Acervo organizado por categoria, visibilidade e data.

Arquivos
Fotos
Controle de visibilidade

Licença

Comercial

Define se a obra pode ser editada ou apenas consultada.

Ativa
Expirada
Histórica

Portal do Cliente

Cliente

Experiência de acompanhamento externa e controlada.

Prévia pública
Dados selecionados
Transparência sem operação interna

Admin

Restrito

Área administrativa para governança da plataforma.

Métricas
Contas
Obras e licenças

Perfis e jornadas

Como cada público percorre o produto.

Engenheiro / Construtora

Cria conta ou acessa login.
Cadastra obras.
Alimenta módulos operacionais.
Revisa dashboard e portal do cliente.

Equipe de obra

Abre obra atribuída.
Registra diário, materiais e mão de obra.
Anexa fotos e documentos.
Consulta pendências e histórico.

Cliente final

Acessa visão compartilhada.
Consulta evolução, arquivos e fotos.
Acompanha status sem editar dados internos.
Recebe transparência do andamento.

Administrador

Entra no painel admin.
Audita contas e obras.
Gerencia licenças.
Acompanha métricas de uso.

Regras críticas

Decisões funcionais que protegem operação, dados e cobrança.

Multi-tenancy

Todo acesso operacional deve respeitar `account_id` e `project_id`. Uma conta não pode visualizar dados de outra.

Licença por obra

A cobrança e a permissão de edição são controladas por obra, não apenas por usuário ou conta.

Uploads fora do deploy

Arquivos de obra ficam em `/var/www/meucanteiro-public/uploads` e são servidos por Caddy em `/uploads/*`.

Deploy seguro

O código vem de `origin/main`; `.env`, uploads, builds e dependências locais não são versionados.