Portal de Documentação — Mastelaro¶
Bem-vindo ao portal de documentação do BI Indicadores Financeiros & Análise de Cardápio, desenvolvido pela Sonar para a Mastelaro.
Este espaço concentra a documentação técnica e de uso do relatório Power BI que acompanha os indicadores financeiros (DRE, CMV, CMO, ponto de equilíbrio) e a análise de cardápio (engenharia de cardápio, fichas técnicas, precificação) das unidades Mastelaro.
Como usar esta documentação¶
Use este portal de acordo com o tipo de informação que você precisa:
- Visão geral e contexto: comece por Comece Aqui
- Entender cada aba do relatório: consulte Documentação de Abas
- Consultar o significado de um indicador: veja o Dicionário de Métricas
- Entender de onde vêm os dados: acesse Fontes de Dados e Linhagem
- Dúvidas rápidas de uso: consulte o FAQ
Navegação rápida
Use Ctrl+K ou a barra de busca para encontrar rapidamente uma métrica, uma aba ou um termo específico.
Estado atual do portal¶
O BI da Mastelaro é composto por um único relatório Power BI, com múltiplas abas cobrindo três frentes analíticas:
- Financeiro (DRE): faturamento, custos fixos e variáveis, CMO, CMV real, ponto de equilíbrio.
- CMV x CMO: comparativo de custo primário (mercadoria + mão de obra) contra o faturamento, com controle de estoque (CMV).
- Cardápio: engenharia de cardápio (Matriz de Kasavanas), fichas técnicas de insumos, TOP 10 pratos por margem/CMV e comparação entre preço praticado e preço sugerido.
Todos os dados são importados a partir de planilhas Excel mantidas no SharePoint da Sonar (uma planilha por unidade/loja Mastelaro) — veja o detalhamento em Fontes de Dados e Linhagem.
Acesso Rápido¶
-
Comece Aqui
Entenda o escopo do portal, o contexto do relatório e por onde começar a navegação.
-
Business Intelligence
Catálogo de abas, dicionário de métricas, fontes de dados e FAQ do relatório.
-
Governança & Roadmap
Veja backlog e changelog da documentação.
Contexto Atual¶
| Camada | Contexto atual |
|---|---|
| Portal | Documentação do BI da Mastelaro |
| Relatório documentado | Indicadores Financeiros & Análise de Cardápio |
| Fonte de dados | Planilhas Excel (uma por unidade) em SharePoint Sonar |
| Ferramenta de BI | Power BI (modelo Import) |
| Consumo | Direção e gestão das unidades Mastelaro |
| Plataforma de documentação | MkDocs + Material Theme |
| Mantenedor da documentação | Equipe de Dados Sonar |
Governança da documentação¶
Este portal deve evoluir junto com o relatório: sempre que uma aba, medida ou fonte de dados mudar no Power BI, a documentação correspondente deve ser revisada para manter consistência entre o que é publicado ao cliente e o que está de fato implementado.
Para acompanhamento de mudanças e prioridades, consulte Governança & Roadmap.