Árvore orçamentária

Como o orçamento é estruturado em árvore e os 3 estados de gasto que aparecem em todos os relatórios

A estrutura

O orçamento de cada empreendimento é uma árvore que reflete a estrutura física da obra:

Empreendimento
├── Bloco A
│   ├── Pavimento Térreo
│   │   ├── Unidade 101
│   │   │   ├── Sala
│   │   │   ├── Quarto
│   │   │   └── Cozinha
│   │   └── Unidade 102 (...)
│   ├── Pavimento 1 (...)
│   └── Coberturas
├── Bloco B (...)
├── Áreas Comuns
│   ├── Hall
│   └── Salão de festas
└── Infraestrutura
    ├── Fundação
    └── Drenagem

Cada nó é categorizado por tipo: PROJETO, BLOCO, PAVIMENTO, UNIDADE, COMODO, AREA_COMUM, INFRAESTRUTURA, CUSTOM.

Itens orçamentários

Em qualquer nó folha (ou customizado) ficam pendurados itens orçamentários — cada item é:

Composição (uma "receita": ex. 1m² de alvenaria = X tijolos + Y cimento + Z h pedreiro), OU
Insumo direto (ex. 50 sacos de cimento Votoran)

Cada item carrega:

Quantidade prevista
Preço unitário (com BDI opcional)
Valor total

Os 3 estados do gasto

Toda compra atravessa 3 estados visíveis em paralelo nos relatórios:

Estado	Quando	Coluna
Previsto	No baseline congelado do orçamento	`valor_total` (item)
Comprometido	RC aprovada (parcial) ou PC emitido (total)	`valor_comprometido`
Realizado	NF lançada + recebimento OK + 3-way match concluído	`valor_realizado`
Pago	Baixa financeira via conciliação	(em accounts_payable)

Reportes orçamentários sempre mostram as 4 colunas: Previsto | Comprometido | Realizado | Pago | Saldo.

Baseline congelado

O orçamento começa em modo "rascunho". Quando o diretor congela o baseline (Empreendimento → Orçamento → Congelar baseline):

Itens ficam imutáveis sem aprovação
Qualquer RC que extrapole o saldo do nó dispara alteração de orçamento (entity_type alteracao_orcamento na alçada)

Isso evita o "vazamento" típico de incorporadoras: gastos que extrapolam o orçamento sem ninguém aprovar formalmente.

Rollup automático

A plataforma calcula custo agregado em cada nó-pai automaticamente via triggers PostgreSQL. Você vê o custo total do Bloco A somando todos os pavimentos > unidades > cômodos sem fazer query manual.

custo_rollup e custo_rollup_com_bdi ficam denormalizados em cada nó para queries rápidas.

Templates

Para acelerar setup de novos empreendimentos, há templates de:

Estrutura de blocos (ex: "Torre padrão BP" com 20 pavimentos × 4 unidades)
Composições (recipes reutilizáveis)
Orçamentos completos (clonar de empreendimento similar)

Settings → Cadastros → Templates de Orçamento.

Composições e insumos

Catálogo central de insumos (705 padrões já carregados, com códigos SINAPI) e composições (240 padrões — alvenaria, contrapiso, instalação elétrica, etc.).

Você pode:

Importar adicionais via Insumos → Importar
Criar composições próprias por copia + ajuste
Manter histórico de preços (cada mudança gera nova versão sem apagar)

Insumos → Catálogo para gerenciar.

Vinculação ao cronograma

Cada tarefa do cronograma (tarefas_cronograma) é vinculada a 1 ou N itens orçamentários. Isso permite:

Auto-requisição: alguns dias antes da tarefa começar, sistema sugere RC
Reportes físico × financeiro consistentes (% executado vs % gasto)
Rastreabilidade: cada gasto é localizável no cronograma

On this page