Skip to content

Sarahbomfimm/Dashboard-Hotel-Qualidade

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📊 Dashboard de Controle de Qualidade Hoteleiro

Dashboard interativo e responsivo para análise e controle de qualidade de dados hoteleiros do Pajuçara Praia Hotel. Sistema completo de visualização de KPIs, gráficos dinâmicos, filtros avançados e gestão de dados através de importação de planilhas.

Dashboard Preview Version License


🎯 Visão Geral

Sistema desenvolvido para gestão hoteleira com foco em análise de dados, permitindo importação de planilhas Excel/CSV, visualização de métricas em tempo real, filtragem avançada por múltiplos critérios e exportação de relatórios personalizados.


✨ Funcionalidades Principais

📂 Gestão de Dados

  • Importação de Arquivos

    • Suporte para Excel (.xlsx, .xls) e CSV
    • Detecção automática de categorias e departamentos
    • Validação de dados em tempo real
    • Armazenamento local persistente (LocalStorage)
    • Feedback visual durante importação
  • Exclusão de Dados

    • Modal de confirmação customizado
    • Limpeza completa do armazenamento local
    • Resetagem de filtros e visualizações
    • Proteção contra exclusão acidental

📊 Indicadores de Performance (KPIs)

Métricas principais exibidas em tempo real:

  1. Avaliação Média

    • Média geral de avaliações (0-5 estrelas)
    • Indicador de tendência (↑ ou ↓)
    • Comparação com período anterior
  2. Taxa de Ocupação

    • Percentual de ocupação do hotel
    • Tendência de crescimento/decréscimo
    • Visualização em porcentagem
  3. Receita Total

    • Soma total de receitas (R$)
    • Formatação monetária brasileira
    • Indicador de tendência financeira
  4. Total de Hóspedes

    • Contagem total de hóspedes
    • Análise de variação
    • Tendência de ocupação

📈 Visualizações Gráficas

1. Gráfico de Linha - Tendência de Ocupação

  • Acompanhamento temporal da taxa de ocupação
  • Eixo temporal com datas formatadas
  • Interpolação suave de dados
  • Gradiente visual atrativo

2. Gráfico de Barras - Receita por Mês

  • Análise de receita mensal
  • Comparação entre períodos
  • Cores temáticas personalizadas
  • Valores formatados em moeda

3. Gráfico de Pizza - Distribuição por Categoria

  • Visualização proporcional de categorias
  • Legendas interativas
  • Percentuais calculados automaticamente
  • Paleta de cores harmoniosa

4. Gráfico de Barras Horizontais - Avaliação por Departamento

  • Ranking de departamentos
  • Média de avaliações (0-5)
  • Ordenação por desempenho
  • Identificação visual rápida

🔍 Sistema de Filtros Avançados

Filtros Principais

  • Mês: Seleção de mês específico ou todos
  • Departamento: Filtro por departamento do hotel
  • Categoria: Segmentação por tipo de serviço
  • Busca por Nome: Pesquisa textual em tempo real

Calendário Interativo

  • Visualização Mensal: Grid completo de dias do mês
  • Navegação: Mês anterior/próximo e botão "Hoje"
  • Seleção de Data: Clique para filtrar dados do dia específico
  • Sincronização: Selects de mês/ano atualizam o calendário
  • Feedback Visual:
    • Dia atual marcado
    • Dia selecionado destacado
    • Informações de uso integradas

Recursos do Calendário

  • Atualização automática da data no header
  • Filtro instantâneo de dados da tabela
  • Fechamento automático após seleção
  • Resetagem de outros filtros ao selecionar dia
  • Interface intuitiva com tooltips

📋 Tabela de Dados

  • Paginação: 10 registros por página
  • Navegação: Botões Anterior/Próxima
  • Informações: Contador de página atual
  • Colunas Exibidas:
    • Data
    • Mês
    • Categoria
    • Departamento
    • Hóspede
    • Avaliação (estrelas visuais)
    • Ocupação (%)
    • Receita (R$)
    • Observações

📤 Exportação de Dados

  • Formato Excel: Exportação em .xlsx
  • Formato CSV: Exportação em .csv
  • Formato JSON: Exportação em .json
  • Formato PDF: Relatório completo com KPIs, gráficos e tabelas
  • Dados Filtrados: Exporta apenas os dados filtrados atualmente
  • Nome Automático: dados_hotel_[timestamp].[formato]
  • Formatação Preservada: Mantém estrutura original
  • Bibliotecas: SheetJS (xlsx), jsPDF, html2canvas

📄 Exportação para PDF

  • Geração automática de relatórios profissionais
  • Inclui todos os KPIs principais
  • Gráficos capturados como imagens
  • Tabela de dados detalhados (primeiros 50 registros)
  • Cabeçalho com data de geração
  • Download automático ao concluir

🎨 Temas Personalizáveis

Sistema completo de temas com 6 opções de cores:

  1. Padrão - Roxo e azul (cores originais)
  2. Oceano - Azul marinho e ciano
  3. Pôr do Sol - Laranja e vermelho
  4. Floresta - Verde escuro e claro
  5. Roxo Real - Roxo escuro e violeta
  6. Coral - Vermelho coral e laranja

Recursos dos Temas:

  • Seletor visual com preview das cores
  • Aplicação instantânea sem recarregar
  • Persistência da escolha (salva no navegador)
  • Atualização automática de todos os componentes
  • Gradientes harmonizados para cada tema

📊 Comparação de Períodos

Ferramenta avançada para análise comparativa:

  • Seleção Dual: Escolha dois períodos (mês/ano) diferentes
  • Métricas Comparadas:
    • Total de registros
    • Avaliação média
    • Taxa de ocupação
    • Receita total
    • Total de hóspedes
  • Percentual de Variação: Cálculo automático da diferença percentual
  • Indicadores Visuais: Verde para crescimento, vermelho para queda
  • Interface Intuitiva: Modal dedicado com resultados claros

🔔 Sistema de Notificações

Feedback visual elegante para todas as ações:

  • Tipos de Notificação:

    • Sucesso (verde) - Ações concluídas
    • Erro (vermelho) - Falhas e problemas
    • ⚠️ Aviso (amarelo) - Alertas importantes
    • ℹ️ Informação (azul) - Mensagens gerais
  • Características:

    • Animação suave de entrada/saída
    • Auto-fechamento após 5 segundos
    • Fechamento manual com clique
    • Posicionamento inteligente (canto superior direito)
    • Empilhamento de múltiplas notificações
    • Ícones contextuais para cada tipo

🖨️ Modo de Impressão

Layout otimizado para impressão de relatórios:

  • Estilos Especiais: CSS @media print dedicado
  • Ocultação Inteligente: Remove botões e elementos interativos
  • Layout Limpo: Foco nos dados essenciais
  • Quebra de Página: Evita corte de elementos importantes
  • Cores Ajustadas: Preto e branco para economia de tinta
  • Ativação Rápida: Botão "Imprimir" no sidebar

🌗 Tema Claro/Escuro

  • Alternância de Tema: Botão de toggle no header
  • Persistência: Preferência salva no navegador
  • Transições Suaves: Animações em todas as mudanças
  • Cores Adaptativas:
    • Tema Escuro: Fundo escuro, texto claro
    • Tema Claro: Fundo claro, texto escuro
  • Ícone Dinâmico: Lua (escuro) / Sol (claro)

📱 Design Responsivo

  • Mobile First: Otimizado para dispositivos móveis
  • Breakpoints:
    • Desktop: >1024px
    • Tablet: 768px - 1024px
    • Mobile: <768px
  • Header Adaptativo: Navegação por setas em mobile
  • Cards Empilháveis: Grid responsivo de KPIs
  • Gráficos Redimensionáveis: Ajuste automático
  • Tabela Scrollável: Overflow horizontal em telas pequenas

📅 Header Dinâmico

  • Data Atual: Atualização automática (formato extenso)
  • Relógio: Atualização em tempo real
  • Total de Registros: Contador dinâmico
  • Receita Total: Soma geral formatada
  • Navegação Mobile: Setas para alternar estatísticas
  • Seletor de Data: Acesso rápido ao calendário

🛠️ Tecnologias Utilizadas

Front-end

  • HTML5: Estrutura semântica
  • CSS3: Estilização avançada com variáveis CSS
  • JavaScript (ES6+): Lógica de aplicação

Bibliotecas

  • Chart.js: Visualização de gráficos
  • SheetJS (xlsx): Importação/Exportação Excel
  • Font Awesome: Ícones vetoriais
  • Google Fonts (Poppins): Tipografia moderna

Recursos CSS

  • CSS Variables (Custom Properties)
  • Flexbox & Grid Layout
  • Gradientes lineares
  • Transições e animações
  • Media Queries responsivas

📁 Estrutura do Projeto

Dashboard/
│
├── index.html          # Estrutura HTML principal
├── style.css           # Estilos e temas
├── script.js           # Lógica JavaScript
└── README.md           # Documentação (este arquivo)

Organização do Código

index.html

  • Header com estatísticas dinâmicas
  • Modal de seleção de data (calendário)
  • Modal de confirmação de exclusão
  • Cards de KPIs
  • Seção de filtros
  • Área de gráficos (4 canvas)
  • Tabela de dados com paginação
  • Rodapé informativo

style.css

  • Reset e variáveis globais
  • Tema claro e escuro
  • Componentes modulares
  • Animações e transições
  • Media queries responsivas
  • Estilos de gráficos e tabelas

script.js

  • Variáveis globais e inicialização
  • Gestão de dados (CRUD)
  • Cálculo de KPIs
  • Renderização de gráficos
  • Sistema de filtros
  • Paginação de tabela
  • Calendário interativo
  • Importação/Exportação
  • Tema e navegação

🚀 Como Usar

1. Instalação

Nenhuma instalação necessária! Basta abrir o arquivo index.html em qualquer navegador moderno.

# Clone ou baixe os arquivos
# Abra index.html no navegador

2. Importar Dados

  1. Clique no botão "Importar Planilha"
  2. Selecione um arquivo Excel (.xlsx, .xls) ou CSV
  3. Aguarde o processamento e confirmação
  4. Os dados serão exibidos automaticamente

Formato Esperado da Planilha:

  • Colunas: Data, Mês, Categoria, Departamento, Hóspede, Avaliação, Ocupação (%), Receita (R$), Observações
  • Primeira linha: Cabeçalhos
  • Datas: Formato reconhecível (DD/MM/YYYY, YYYY-MM-DD, etc.)

3. Filtrar Dados

Filtros Principais:

  • Selecione Mês, Departamento ou Categoria nos dropdowns
  • Digite um nome no campo de Busca
  • Clique em Aplicar Filtros

Calendário:

  1. Clique na data do header
  2. Navegue pelos meses usando as setas
  3. Selecione mês/ano nos dropdowns para mudar o calendário
  4. Clique em um dia para filtrar dados daquela data específica
  5. Modal fecha automaticamente após seleção

4. Visualizar Dados

  • KPIs: Visualização instantânea no topo
  • Gráficos: 4 visualizações diferentes
  • Tabela: Navegue usando paginação
  • Tendências: Indicadores ↑/↓ nos KPIs

5. Exportar Dados

  1. Aplique os filtros desejados
  2. Clique no botão "Exportar para Excel"
  3. Arquivo será baixado automaticamente

6. Alternar Tema

  • Clique no ícone de lua/sol no header
  • Tema alternará entre claro e escuro
  • Preferência é salva automaticamente

7. Limpar Dados

  1. Clique no botão "Limpar Dados"
  2. Confirme a ação no modal
  3. Todos os dados serão removidos

8. Exportar para PDF

  1. Navegue até a seção "Exportar" no sidebar
  2. Clique no botão "PDF"
  3. Aguarde a geração (notificação aparecerá)
  4. PDF será baixado automaticamente com:
    • Todos os KPIs principais
    • Gráficos capturados
    • Tabela de dados detalhados

9. Comparar Períodos

  1. Clique no botão "Comparar" no sidebar
  2. Selecione o Período 1: Escolha mês e ano
  3. Selecione o Período 2: Escolha outro mês e ano
  4. Clique em "Comparar"
  5. Veja os resultados:
    • Métricas lado a lado
    • Percentual de variação
    • Indicadores visuais de crescimento/queda

10. Trocar Tema

  1. Clique no botão "Temas" no sidebar
  2. Modal será aberto com 6 opções
  3. Clique no tema desejado:
    • Padrão - Roxo e azul
    • Oceano - Azul marinho
    • Pôr do Sol - Laranja e vermelho
    • Floresta - Verde
    • Roxo Real - Roxo intenso
    • Coral - Coral e laranja
  4. Tema aplicado instantaneamente
  5. Sua escolha é salva automaticamente

11. Imprimir Dashboard

  1. Clique no botão "Imprimir" no sidebar
  2. Visualização de impressão será aberta
  3. Ajuste configurações da impressora
  4. Imprima ou salve como PDF
  5. Layout otimizado automaticamente (sem botões, limpo)

🎨 Personalização

Alterar Cores

Edite as variáveis CSS em style.css:

:root {
  --primary-color: #667eea;
  --primary-gradient-start: #667eea;
  --primary-gradient-end: #764ba2;
  --gradient-1: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
  /* ... */
}

Adicionar Novos Filtros

No script.js, edite a função applyFilters():

function applyFilters() {
  // Adicione novas condições de filtro aqui
}

Modificar KPIs

Edite a função calculateKPIs() em script.js:

function calculateKPIs() {
  // Adicione novos cálculos aqui
}

📊 Recursos de Dados

LocalStorage

Dados são salvos automaticamente no navegador usando LocalStorage:

  • Chave: hotelDashboardData
  • Formato: JSON Array
  • Persistência: Até limpeza manual ou do cache
  • Limite: ~5MB (varia por navegador)

Formatos Suportados

Excel

  • .xlsx (Office Open XML)
  • .xls (Excel Binary)

CSV

  • Separadores: vírgula, ponto-e-vírgula
  • Codificação: UTF-8, Latin1

🔒 Segurança e Privacidade

  • Processamento Local: Todos os dados são processados no navegador
  • Sem Backend: Nenhum dado é enviado para servidores externos
  • LocalStorage: Dados armazenados apenas no dispositivo do usuário
  • Confirmações: Modais de confirmação para ações destrutivas
  • Validação: Verificação de dados durante importação

🌐 Compatibilidade de Navegadores

Navegador Versão Mínima Suporte
Chrome 90+ ✅ Total
Firefox 88+ ✅ Total
Safari 14+ ✅ Total
Edge 90+ ✅ Total
Opera 76+ ✅ Total

Requisitos:

  • JavaScript habilitado
  • LocalStorage disponível
  • Canvas support (para gráficos)

📝 Estrutura de Dados Esperada

Exemplo de Registro

{
  data: "2025-12-12",
  mes: "Dezembro",
  categoria: "Premium",
  departamento: "Recepção",
  hospede: "João Silva",
  avaliacao: 4.5,
  ocupacao: 85,
  receita: 1250.00,
  observacoes: "Check-in rápido"
}

Campos Obrigatórios

  • data: Data do registro
  • mes: Nome do mês
  • categoria: Categoria do serviço
  • departamento: Departamento responsável
  • hospede: Nome do hóspede
  • avaliacao: Nota de 0 a 5
  • ocupacao: Percentual (0-100)
  • receita: Valor monetário
  • observacoes: Texto livre (opcional)

🐛 Solução de Problemas

Dados não carregam

  1. Verifique o formato da planilha
  2. Certifique-se que há cabeçalhos na primeira linha
  3. Verifique o console do navegador (F12)

Gráficos não aparecem

  1. Verifique se há dados importados
  2. Limpe o cache do navegador
  3. Recarregue a página (Ctrl+F5)

Filtros não funcionam

  1. Verifique se há dados carregados
  2. Clique em "Resetar Filtros"
  3. Reimporte os dados se necessário

LocalStorage cheio

  1. Clique em "Limpar Dados"
  2. Importe uma planilha menor
  3. Limpe o cache do navegador

🔄 Recursos Recém-Implementados

✅ Concluído

  • Exportação para PDF - Gere relatórios completos em PDF com gráficos e tabelas
  • Gráficos adicionais - Visualizações aprimoradas para melhor análise de dados
  • Comparação entre períodos - Compare métricas de dois meses diferentes lado a lado
  • Modo de impressão - Layout otimizado para impressão de relatórios
  • Temas personalizáveis - 6 temas de cores diferentes (Padrão, Oceano, Pôr do Sol, Floresta, Roxo Real, Coral)
  • Sistema de notificações - Alertas visuais elegantes para todas as ações do usuário

Em Desenvolvimento

  • Internacionalização (i18n) - Suporte multi-idiomas
  • Dashboard personalizado - Widgets customizáveis pelo usuário
  • Exportação agendada - Relatórios automáticos periódicos

👨‍💻 Desenvolvimento

Requisitos para Desenvolvimento

  • Editor de código (VS Code, Sublime, etc.)
  • Navegador com DevTools
  • Conhecimento em HTML, CSS, JavaScript

Estrutura de Funções Principais

// Gestão de Dados
loadDataFromStorage()
saveDataToStorage()
importFile()
clearLoadedData()

// Cálculos e KPIs
calculateKPIs()
calculateTrend()

// Visualizações
renderCharts()
renderTable()
renderCalendar()

// Filtros
applyFilters()
applyDateFilter()
selectDate()

// Navegação
changePage()
navigateStats()
toggleDatePicker()
toggleTheme()

📞 Suporte

Para dúvidas, sugestões ou reportar problemas:


🙏 Agradecimentos

Desenvolvido para Pajuçara Praia Hotel com foco em excelência na gestão de dados hoteleiros e análise de qualidade de serviços.


Dashboard de Controle de Qualidade Hoteleiro v1.0.0
Transformando dados em decisões inteligentes 🎯


📸 Screenshots

Dashboard Principal

Interface principal com KPIs, gráficos e tabela de dados em tema escuro.

Calendário Interativo

Modal de seleção de data com navegação mensal e seleção de dia específico.

Tema Claro

Visualização completa do dashboard em modo claro.

Mobile Responsivo

Interface adaptada para dispositivos móveis com navegação otimizada.


Última atualização: Dezembro 2025
Versão: 1.0.0
Status: ✅ Estável e em Produção

About

Dashboard interativo para controle de qualidade hoteleiro.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors