====== Usuários e Permissões ======

O Ello Dash utiliza um sistema de controle de acesso que define quais empresas e quais relatórios cada usuário pode visualizar. O gerenciamento é feito pelo painel administrativo do sistema.

===== Acessando o painel administrativo =====

O gerenciamento de usuários é feito pelo **Painel Administrativo**, acessível em:
**dash.ellotecnologia.com/admin**

Apenas usuários com privilégios de administrador têm acesso a essa área.

===== Como criar um usuário =====

  - Acesse o Painel Administrativo
  - Navegue até **"Usuários"**
  - Clique em **"Adicionar usuário"**
  - Preencha o **nome de usuário** e a **senha inicial**
  - Clique em **"Salvar e continuar editando"** para configurar empresas e permissões

===== Associando o usuário a empresas =====

Após criar o usuário, vincule-o às empresas que ele poderá acessar:

  - Na tela de edição do usuário, localize o campo **"Empresas"**
  - Selecione todas as empresas às quais o usuário terá acesso
  - No campo **"Empresa padrão"**, escolha qual empresa será exibida automaticamente ao fazer login
  - Clique em **"Salvar"**

Um usuário sem empresa associada consegue fazer login, mas não verá nenhum dado no painel.

===== Definindo permissões de gráficos =====

Cada relatório/gráfico do Ello Dash pode ser liberado ou bloqueado individualmente por usuário. As permissões disponíveis são:

^ Permissão ^ Relatório correspondente ^
| Vendas por Caixa | Meios de Pagamento |
| Vendas por Vendedor | Por Vendedor |
| Vendas por Período | Vendas por Período |
| Ranking de Produtos | Ranking de Produtos |
| Resumo de Notas | Resumo de Notas Fiscais |
| Contas a Receber | Contas a Receber |
| Contas a Pagar por Período | Contas a Pagar por Período |
| Pagamentos Realizados | Pagamentos Realizados |
| Despesas por Período | Despesas por Tipo |
| Contas Financeiras | Contas Financeiras |
| Notas de Entrada | Notas de Entrada |

Para definir as permissões:
  - Na tela de edição do usuário, localize a seção **"Permissões do usuário"**
  - Marque as permissões que deseja conceder
  - Clique em **"Salvar"**

Um usuário sem nenhuma permissão de gráfico consegue fazer login, mas não verá nenhum relatório.

===== Relação entre usuário, empresa e relatórios =====

<uml>
left to right direction
skinparam usecase {
  BackgroundColor #ffffff
  BorderColor #cccccc
  ArrowColor #f5740b
}
skinparam actorStyle awesome

actor "Usuário" as U

rectangle "Empresa A" {
  usecase "Vendas por Período" as VP
  usecase "Contas a Receber" as CR
  usecase "Ranking de Produtos" as RP
}

rectangle "Empresa B" {
  usecase "Meios de Pagamento" as MP
  usecase "Contas Financeiras" as CF
}

U --> "Empresa A"
U --> "Empresa B"
U --> VP
U --> CR
U --> RP
U --> MP
U --> CF
</uml>

Um usuário pode ter acesso a múltiplas empresas. As permissões de gráfico são definidas por usuário e valem para todas as empresas às quais ele tem acesso.

===== Boas práticas =====

  * Crie usuários individuais para cada pessoa — evite compartilhar credenciais entre funcionários
  * Conceda apenas as permissões necessárias para a função de cada usuário
  * Defina a empresa padrão como aquela que o usuário acessa com mais frequência
  * Ao desligar um funcionário, desative ou remova o usuário correspondente