Relatório de Modais BI

================================================================================
RELATÓRIO DE CONTEÚDO DOS MODAIS DE INFORMAÇÃO - APLICAÇÃO BI
Data: 2026-02-13
================================================================================

ORGANIZAÇÃO: Painel | Card KPI / Gráfico | Abas
================================================================================


================================================================================
PAINEL: GERAL (BiDashboardGeral)
================================================================================

--- CARD KPI 1: ÁREA TOTAL ---
Título: Área Total de Fôrmas

Seção 1 - O que é?
Conteúdo: Área total de fôrmas necessárias para o projeto, medida em metros quadrados (m²). Este valor representa a soma de todas as superfícies de contato entre a fôrma e o concreto.

Seção 2 - Como é calculado?
Conteúdo: Soma das áreas de todos os materiais (pilares, vigas, lajes, etc.) após aplicação dos filtros selecionados. Cada material contribui com sua métrica principal específica.

Seção 3 - Por que é importante?
Conteúdo: Dimensiona a magnitude do projeto e serve como base para estimativas de mão-de-obra, cronograma e planejamento logístico. É a métrica fundamental para cálculo de produtividade.

Seção 4 - Filtros aplicados
Conteúdo: O valor exibido sempre reflete os filtros ativos (níveis, zonas, etc.). Para ver o total absoluto do projeto, certifique-se de que todos os filtros estejam selecionados.

---

--- CARD KPI 2: COMPRIMENTO GASTALHO ---
Título: Comprimento Gastalho
(Utiliza as mesmas seções de "Área Total de Fôrmas" - referência ao campo "area_total")

---

--- CARD KPI 3: CUSTO TOTAL ---
Título: Custo Total de Insumos

Seção 1 - O que é?
Conteúdo: Custo total de insumos novos necessários para execução das fôrmas, considerando apenas materiais que precisarão ser adquiridos (desconta reaproveitamento).

Seção 2 - Como é calculado?
Conteúdo: Soma de todos os custos de insumos marcados como "Somável" nos dados processados. Inclui chapas, pontaletes, sarrafos, pregos e demais materiais, já descontados os itens reaproveitados.

Seção 3 - Composição
Conteúdo: O custo considera: quantidade de insumos × preço unitário. Os valores são pré-calculados durante o processamento do levantamento técnico e refletem os dados fornecidos no upload.

Seção 4 - Nota importante
Conteúdo: Este é o custo efetivo (após economia). Para ver o custo teórico (sem reaproveitamento), consulte a métrica "Custo Teórico" ou some Custo Total + Economia Total.

---

--- CARD KPI 4: ECONOMIA TOTAL ---
Título: Economia por Reaproveitamento

Seção 1 - O que é?
Conteúdo: Valor economizado através do reaproveitamento de materiais de fôrmas em pavimentos subsequentes. Representa insumos que não precisarão ser adquiridos novamente.

Seção 2 - Como é calculado?
Conteúdo: Soma de todos os custos marcados como "Reaproveitado" nos dados. O sistema identifica automaticamente elementos que podem ser reutilizados com base em regras específicas de cada material.

Seção 3 - Regras de reaproveitamento
Conteúdo: Cada material possui critérios próprios: pilares que não nascem no nível, vigas marcadas para reforma/reaproveitamento, faixas de reescoramento, etc. As regras seguem metodologia BIM validada.

Seção 4 - Percentual economizado
Conteúdo: O percentual indica: (Economia ÷ Custo Teórico) × 100. Quanto maior, mais eficiente é o planejamento de reaproveitamento do projeto.

Seção 5 - Impacto
Conteúdo: Além da redução de custos diretos, o reaproveitamento diminui desperdício, otimiza logística e reduz o impacto ambiental da obra.

---

--- CARD KPI 5: ELEMENTOS TÉCNICOS ---
Título: Total de Elementos

Seção 1 - O que é?
Conteúdo: Número total de elementos estruturais (linhas de dados) considerados nos cálculos. Cada elemento representa uma peça ou segmento individualizado no levantamento.

Seção 2 - O que conta como elemento?
Conteúdo: Pilares, trechos de vigas, painéis de laje, capitéis, gastalhos, fundos e laterais de blocos. Cada registro processado do CSV corresponde a um elemento.

Seção 3 - Para que serve?
Conteúdo: Indica a complexidade e granularidade do levantamento. Auxilia na alocação de equipes, planejamento de etapas e estimativa de tempo de execução.

---

--- ABA: GERAL | GRÁFICO 1: CUSTOS POR MATERIAL ---
Título: Custos por Material

Seção 1 - O que mostra?
Conteúdo: Distribuição dos custos entre os diferentes materiais do projeto. Permite identificar rapidamente quais materiais têm maior impacto no orçamento.

Seção 2 - Como interpretar?
Conteúdo: Materiais com barras mais altas demandam maior atenção em termos de planejamento, negociação e controle. A ordem é decrescente por custo.

Seção 3 - Uso prático
Conteúdo: Utilize para priorizar esforços de otimização, comparar cenários de projeto ou justificar decisões técnicas para a equipe de gestão.

---

--- ABA: GERAL | GRÁFICO 2: DISTRIBUIÇÃO DE CUSTOS ---
Título: Distribuição de Custos (Pizza)

Seção 1 - O que mostra?
Conteúdo: Proporção percentual de cada material no custo total. Visualização complementar ao gráfico de barras, focada em composição relativa.

Seção 2 - Leitura
Conteúdo: Cada fatia representa a participação percentual de um material. Fatias maiores indicam materiais que dominam a composição de custos.

---

--- ABA: GERAL | TABELA: CUSTOS E ÁREAS POR MATERIAL ---
(Sem modal específico - utiliza informações dos gráficos acima)

---

--- ABA: INSUMOS_QTY | GRÁFICO: TOP 10 INSUMOS (QUANTIDADE) ---
Título: Quantidades de Insumos

Seção 1 - O que são?
Conteúdo: Quantidades físicas de insumos necessários: chapas (unidades), madeira (metros lineares), pregos (kg). Cada material possui seu conjunto específico de insumos.

Seção 2 - Como usar?
Conteúdo: Utilize para orçamentação detalhada, requisição de compras e planejamento logístico. Os valores já consideram perdas e ajustes técnicos do levantamento.

Seção 3 - Agregação por nível
Conteúdo: Os gráficos e tabelas mostram a distribuição de insumos por pavimento, facilitando a programação de entregas e estoque em obra.

---

--- ABA: INSUMOS_COST | TABELA: CUSTOS DE INSUMOS POR MATERIAL ---
Título: Custos de Insumos

Seção 1 - O que são?
Conteúdo: Valores monetários de cada categoria de insumo. Permitem identificar quais materiais têm maior impacto no custo total do projeto.

Seção 2 - Análise de composição
Conteúdo: Compare os custos entre insumos para priorizar negociações com fornecedores, avaliar alternativas técnicas ou justificar investimentos em reaproveitamento.

Seção 3 - Rastreabilidade
Conteúdo: Todos os valores são rastreáveis até o levantamento original. Os custos unitários foram definidos durante o processamento dos arquivos CSV.

---

--- ABA: REAPROVEITAMENTOS | GRÁFICO 1: ECONOMIA TOTAL POR MATERIAL ---
Título: Reaproveitamento de Fôrmas

Seção 1 - Fundamento
Conteúdo: O reaproveitamento é uma estratégia que consiste em reutilizar painéis, pontaletes e demais componentes de fôrmas em pavimentos subsequentes, reduzindo custos e desperdícios.

Seção 2 - Quando ocorre?
Conteúdo: Pilares que não nascem no nível atual, vigas marcadas para reforma/reaproveitamento, e faixas de reescoramento são os casos mais comuns. Cada material possui regras específicas.

Seção 3 - Regras automáticas
Conteúdo: O sistema aplica automaticamente as regras de reaproveitamento durante o processamento do levantamento, seguindo metodologia BIM validada pela Estruformas.

Seção 4 - Economia real
Conteúdo: A economia calculada é conservadora e considera apenas situações onde o reaproveitamento é tecnicamente viável e já mapeado no levantamento original.

Seção 5 - Visualização
Conteúdo: Os gráficos de reaproveitamento mostram a distribuição da economia por nível e material, permitindo identificar oportunidades e validar o planejamento.

---

--- ABA: REAPROVEITAMENTOS | GRÁFICO 2: INSUMOS REAPROVEITADOS - QUANTIDADES ---
(Utiliza conteúdo "Quantidades de Insumos" com contexto de reaproveitamento)

---

--- ABA: REAPROVEITAMENTOS | GRÁFICO 3: CUSTOS EVITADOS - ECONOMIA (R$) ---
(Utiliza conteúdo "Custos de Insumos" com foco em economia)

---

--- ABA: REAPROVEITAMENTOS | TABELA: ECONOMIA POR MATERIAL ---
(Utiliza conteúdo "Reaproveitamento de Fôrmas")

---

--- ABA: REAPROVEITAMENTOS | TABELA: INSUMOS REAPROVEITADOS - DETALHAMENTO ---
(Utiliza conteúdo "Quantidades de Insumos" e "Custos de Insumos")

---

--- ABA: DADOS | TABELA: RESUMO CONSOLIDADO POR MATERIAL ---
Título: Dados Brutos Filtrados

Seção 1 - O que são?
Conteúdo: Visualização direta dos registros processados do levantamento técnico, após aplicação dos filtros. Cada linha representa um elemento estrutural individual.

Seção 2 - Estrutura
Conteúdo: As colunas incluem dados originais do CSV (nível, projeção, dimensões) e colunas derivadas pelo sistema (valores somáveis, valores reaproveitados, ajustes).

Seção 3 - Finalidade
Conteúdo: Permite auditoria técnica, validação de cálculos e rastreabilidade completa dos resultados. Útil para engenheiros que precisam verificar detalhes específicos.

Seção 4 - Limitação de exibição
Conteúdo: Por questões de performance, são exibidas apenas as 20 primeiras linhas e 10 primeiras colunas. O dataset completo permanece disponível para cálculos.

---

--- ABA: EXPORTAR ---
(Sem modais de informação específicas)

---


================================================================================
PAINEL: MATERIAL (BiDashboardMaterial) - REFERÊNCIAS
================================================================================

As abas e gráficos no painel de material individual utilizam:

--- CARD KPI 1: ÁREA DO MATERIAL ---
Título: Área do Material

Seção 1 - O que é?
Conteúdo: Área específica deste material após aplicação dos filtros. Para pilares e vigas, representa área de contato. Para lajes, área de painel. Para gastalhos, comprimento linear convertido.

Seção 2 - Unidade de medida
Conteúdo: A maioria dos materiais usa m² (metros quadrados). Gastalhos utilizam ml (metros lineares). A conversão é feita automaticamente pelo sistema.

---

--- CARD KPI 2: CUSTO DO MATERIAL ---
Título: Custo do Material

Seção 1 - O que é?
Conteúdo: Custo total de insumos para este material específico, já descontado o reaproveitamento. Representa o valor efetivo a ser investido.

Seção 2 - Composição
Conteúdo: Soma dos custos de todos os insumos marcados como "Somável" para este material: chapas, madeira, pregos, etc.

---

--- CARD KPI 3: ECONOMIA DO MATERIAL ---
Título: Economia do Material

Seção 1 - O que é?
Conteúdo: Valor economizado através do reaproveitamento específico deste material. Alguns materiais têm maior potencial de reaproveitamento que outros.

Seção 2 - Interpretação
Conteúdo: Se zero, significa que este material não possui reaproveitamento detectado nas regras atuais ou nos filtros aplicados. Isso é esperado para materiais como painéis de laje novos.

---

--- GRÁFICO: DISTRIBUIÇÃO POR NÍVEL ---
Título: Distribuição por Nível

Seção 1 - O que mostra?
Conteúdo: Valores do material distribuídos por pavimento. Permite identificar variações de complexidade, tipologia ou quantidade entre andares.

Seção 2 - Análise
Conteúdo: Picos podem indicar pavimentos tipo, térreos ou coberturas com geometria diferenciada. Útil para planejamento de etapas e nivelamento de recursos.

---

--- TABELA: DETALHAMENTO POR NÍVEL ---
(Sem modal específico)

---

--- ABA: GERAL MATERIAL ---
(Utiliza mesmos conceitos do painel geral)

---


================================================================================
NOTAS GERAIS
================================================================================

1. Todos os modais exibem a seguinte nota rodapé:
   "Nota: Todos os valores exibidos refletem os filtros atualmente aplicados no sistema."

2. Os modais são acessados através de ícones de informação (ⓘ) localizados nos:
   - Cards KPI (5 cards na visão geral)
   - Títulos dos gráficos
   - Cabeçalhos de tabelas

3. Os conteúdos utilizam linguagem técnica porém acessível, com foco em:
   - Explicação conceitual
   - Metodologia de cálculo
   - Aplicação prática
   - Interpretação de resultados

4. Organização dos conteúdos em secções com subtítulos facilita leitura e compreensão.

================================================================================
FIM DO RELATÓRIO
================================================================================