# Navegação do Portal Gestão Ativa

## Visão Geral

### O que é o Portal Gestão Ativa?
O Portal Gestão Ativa é a plataforma de Business Intelligence da BCI Global. Permite acompanhar KPIs, dashboards, relatórios e indicadores de todas as filiais da rede Al Sultan.

### Como acessar o portal?
Acesse https://alsultan.tech com seu email e senha cadastrados.

### Esqueci minha senha, o que fazer?
Na tela de login, clique em "Esqueci minha senha" e siga as instruções enviadas por email.

---

## Menu Principal (Sidebar)

### Como funciona o menu lateral?
O menu lateral (sidebar) organiza todas as funcionalidades do portal em seções.

### Quais são as seções do menu?

1. **Seletor de Filial** - Primeiro passo obrigatório
2. **Menu da Filial** - Atalhos rápidos após selecionar
3. **Gestão** - Indicadores, Alertas, Dashboards, OKRs, Relatórios
4. **Ferramentas** - Editor PDF, Upload de Documentos
5. **Suporte** - Chat com Anna, Abrir Chamado
6. **Administração** - Apenas para admins

---

## Seletor de Filial

### Por que preciso selecionar uma filial?
O portal mostra dados específicos da filial selecionada. É o primeiro passo para navegar.

### Como selecionar uma filial?
No menu lateral, clique no dropdown "Selecione a Unidade" e escolha a filial desejada.

### Posso ver todas as filiais juntas?
Sim, selecione "Todas as Filiais" para ver a visão consolidada. Disponível apenas para gestão BCI.

### Sou gerente de filial, por que não vejo outras unidades?
Gerentes de filial têm acesso restrito apenas à própria unidade por segurança (Row-Level Security).

### Quais filiais estão disponíveis?
- Juvevê (Curitiba/PR)
- Água Verde (Curitiba/PR)
- SJP (São José dos Pinhais/PR)
- Bairro Alto (Curitiba/PR)
- Ecoville (Curitiba/PR)
- Ponta Grossa (Ponta Grossa/PR)
- Bonfiglioli (São Paulo/SP)

---

## Menu Contextual da Filial

### O que aparece após selecionar uma filial?
Após selecionar a filial, aparecem atalhos rápidos no menu:

- **Indicadores**: KPIs da unidade selecionada
- **Resultado Mensal**: DRE da filial
- **Fluxo de Caixa**: DFC da filial
- **Estoque**: Posição de estoque atual
- **Vendas Hoje**: Performance do dia

### Posso voltar para a visão geral?
Sim, clique em "Ver Todas as Unidades" para sair da visão específica.

---

## Seção Gestão

### O que tem na seção Gestão?

**Indicadores por Filial** (`/indicadores`)
- Cards de KPIs de todas as unidades
- Comparativo visual entre filiais
- Status com cores (verde, amarelo, vermelho)

**Alertas** (`/alertas`)
- Notificações de KPIs fora da meta
- Disponível apenas para gestão BCI e admins
- Filtro por tipo e severidade

**Painel Principal** (`/dashboards`)
- Todos os dashboards Metabase
- Categorias: KPIs, Financeiro, Fluxo de Caixa, Operacional, Franquias

**OKRs** (`/gestao/okrs`)
- Objetivos e metas do trimestre
- Progresso de cada key result
- Status: On Track, At Risk, Behind

**Relatórios** (`/relatorios`)
- Exportação de relatórios em PDF e Excel
- Filtro por período e filial

---

## Seção Ferramentas

### O que tem na seção Ferramentas?

**Editor de PDF** (`/editor-pdf`)
- Visualizar e editar documentos PDF
- Combinar, dividir e reorganizar páginas

**Enviar Documentos** (`/upload`)
- Upload de arquivos para o Google Drive
- Categorias: Financeiro, Contratos, Operacional, Relatórios
- Arrastar e soltar ou clicar para selecionar

### Como fazer upload de documentos?
1. Vá em Ferramentas → Enviar Documentos
2. Selecione a categoria do documento
3. Arraste o arquivo ou clique para selecionar
4. Aguarde o upload completar
5. O documento será organizado automaticamente no Drive

### Quais tipos de arquivo posso enviar?
PDF, Excel, Word, imagens (JPG, PNG), e outros documentos comuns.

---

## Seção Suporte

### Como falar com o suporte?

**Chat com Anna**
- Clique em "Falar com Suporte" no menu
- Ou use o botão flutuante no canto inferior direito
- Anna responde 24/7 sobre o portal e KPIs

**Abrir Chamado**
- Para problemas técnicos ou solicitações específicas
- Clique em "Abrir Chamado" no menu
- Preencha o formulário com detalhes

### A Anna pode me ajudar com o quê?
- Explicar onde encontrar informações no portal
- Esclarecer dúvidas sobre KPIs e indicadores
- Explicar termos financeiros (DRE, DFC, CMV)
- Orientar sobre navegação e funcionalidades

---

## Seção Administração

### Quem tem acesso à Administração?
Apenas super administradores (Shay e Vini) e admins BCI.

### O que tem na Administração?

**Histórico de Acessos**
- Log de quem acessou o portal
- Data, hora e páginas visitadas

**Gerenciar Usuários**
- Criar, editar e desativar usuários
- Definir níveis de acesso

**Andamento do Projeto**
- Status de implementação
- Documentação técnica

---

## Dashboard Principal

### O que aparece na tela inicial?
A tela inicial (Dashboard) mostra:

1. **Big Numbers**: Faturamento, Prime Cost, Fluxo de Caixa, Alertas
2. **Relatórios e Análises**: Cards com links rápidos
3. **Indicadores da Operação**: KPIs principais
4. **Documentos**: Acesso rápido a categorias de documentos
5. **Info Cards**: Filiais conectadas, sincronização, suporte

### O que são os Big Numbers?
São os 4 indicadores principais em destaque:
- Faturamento do Mês
- Prime Cost atual
- Fluxo de Caixa
- Quantidade de Alertas

### O que significa o tour de onboarding?
Na primeira vez que acessa, o portal oferece um tour guiado explicando cada seção.

---

## Sincronização de Dados

### Com que frequência os dados são atualizados?
- **Vendas**: 3 vezes ao dia (07h, 12h30, 22h30)
- **Financeiro**: 1 vez ao dia (06h30)
- **Estoque**: 1 vez ao dia (07h30)

### De onde vêm os dados?
Os dados são sincronizados automaticamente do Cloudfy (ERP) para o portal.

### Posso forçar uma atualização?
Não manualmente. Os dados são atualizados nos horários definidos.

### Vi um dado errado, o que fazer?
Abra um chamado informando o dado incorreto. A equipe verificará a origem no Cloudfy.
