Skip to content

JsCodeDevlopment/syncable

Repository files navigation

Syncable - Gestão de Ponto & Payroll Dashboard

Plataforma moderna, intuitiva e responsiva desenvolvida com Next.js 15, focada na gestão completa de ponto eletrônico, controle de jornadas, pausas e geração de relatórios detalhados para profissionais e empresas.

Banner do Syncable

🚀 Funcionalidades e Módulos Atualizados

  • 🌓 Interface Premium Elevada: Design moderno com suporte nativo a temas Claro/Escuro via Tailwind CSS e micro-animações para feedback de usuário.
  • ⏱️ Registro de Ponto Inteligente: Dashboard interativo para registro instantâneo de entrada, saída e controle de intervalos com cronômetro reativo.
  • 📊 Estatísticas de Alta Fidelidade: Cards premium com métricas consolidadas (Total Trabalhado, Pausas, Combinado) e gráficos dinâmicos com Recharts.
  • 📄 Novo Workflow de Relatórios:
    • Geração via Modal: Interface focada que substitui formulários estáticos por um fluxo intuitivo de geração.
    • Atalhos Rápidos: Botões para seleção instantânea de logs Diários, Semanais ou Mensais.
    • Filtros Dinâmicos: Escolha entre Visão Resumida, Detalhada ou Apenas Entradas.
  • 🔗 Compartilhamento Avançado:
    • Geração de links públicos temporários com data de expiração.
    • Controle de privacidade: Opção de exibir ou ocultar Insights de Produtividade no link compartilhado.
  • 📥 Exportação de Dados Otimizada:
    • Excel/CSV Master: Arquivo formatado com separadores de sessão, banners personalizados e suporte total a acentos (UTF-8 BOM) para compatibilidade perfeita com Excel.
    • PDF Digital (Beta): Visualização de impressão estruturada para salvamento em PDF.

🏗️ Estrutura do Projeto

app/
├── (auth)/                         # Fluxos de autenticação (Login e Registro)
├── dashboard/                      # Métricas premium e widget de tracker
├── reports/                        # Módulo de geração e exportação (Novo Modal Workflow)
├── shared-report/                  # Visualização pública anônima dinâmica
├── actions/                        # Core de negócios (Server Actions)
│   ├── time-entries.ts             # Lógica de punch-in/out e intervalos
│   ├── reports.ts                  # Engine de processamento e segurança de links
│   └── dashboard-summary.ts        # Agregador de métricas premium
├── components/                     # Componentes de interface (UI & UX)
│   ├── time-tracker.tsx            # Widget interativo com cronômetro
│   ├── report-insights.tsx         # Cards de produtividade e benchmarks
│   └── ui/                         # Base atômica Shadcn UI + Radix

🧠 Arquitetura e Decisões de Design

Sincronização e Performance

O Syncable utiliza Next.js Server Actions para interagir diretamente com o banco de dados Neon Serverless (PostgreSQL).

  • Cold Starts Zero: Resposta instantânea graças ao driver @neondatabase/serverless.
  • Relatórios On-the-fly: O processamento de dados para exportação ocorre em tempo de execução, garantindo que o CSV reflita o estado exato do banco.

Fluxo de Geração de Relatórios (Shared Link)

flowchart LR
    A[Usuário Gera Relatório] --> B[Modal de Exportação]
    B --> C{Tipo de Ação?}
    C -->|Download| D[Geração de CSV UTF-8 BOM]
    C -->|Share| E[Server Action: createSharedReport]
    E --> F[Inserção com Token e Expiração]
    F --> G[Link Público Gerado]
    G --> H[Visualização Exclusiva do Destinatário]
Loading

Segurança e Privacidade

Cada link de compartilhamento é protegido por um UUID único e pode ser configurado com:

  1. Duração Limitada: Expiração automática em 1, 7, 30 ou 90 dias.
  2. Toggle de Insights: O usuário decide se o destinatário verá as análises de produtividade ou apenas a tabela de horas bruta.

🛠️ Tecnologias Utilizadas

👨‍💻 Desenvolvedor

Foto Nome Cargo
Jonatas Silva Senior Software Engineer / CTO & Tech Lead

📄 Licença

Este projeto é privado e de uso restrito da Syncable Corporation.


Built with ❤️ by Jonatas Silva

About

Syncable é uma plataforma moderna e intuitiva para gestão de ponto eletrônico. Com recursos avançados de registro de horas e geração de relatórios, a aplicação oferece uma solução completa para empresas e profissionais que precisam controlar suas jornadas de trabalho de forma eficiente.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors