docs: release v1.0.0 with official readme and release notes

Author: naicolas-dev

README.md

@@ -1,71 +1,72 @@
-# Dev CLT Timer
+# DevCLT Timer v1.0 🚀
 
-Cronômetro de jornada de trabalho para devs CLT. Controle de trabalho, pausa, hora extra e relatórios semanais/mensais.
+O **DevCLT Timer** é a ferramenta definitiva para desenvolvedores CLT que precisam controlar sua jornada de trabalho com precisão, sem abrir mão da produtividade.
 
-## Stack
+Com uma interface moderna e discreta, ele gerencia seus horários de trabalho, pausas e horas extras, garantindo que você mantenha o foco no código via **Atalhos Globais** e notificações inteligentes.
 
-- **C# / .NET 8 + WPF (MVVM)**
-- **SQLite** para persistência local (`%APPDATA%\DevCLTTimer\devclt.db`)
-- **Toast Notifications** (Windows 10+)
-- **System Tray** com menu dinâmico
+![DevCLT Timer Screenshot](https://via.placeholder.com/800x450?text=Preview+DevCLT+Timer) <!-- Substituir por screenshot real -->
 
-## Arquitetura
+---
 
-```
-src/
-├── DevCLT.Core/            # Motor de estado, modelos, interfaces (net8.0, cross-platform)
-├── DevCLT.Infrastructure/  # SQLite repository, queries de relatório (net8.0)
-└── DevCLT.WindowsApp/      # WPF, Views/ViewModels, Tray, Toast (net8.0-windows10.0.17763.0)
-tests/
-└── DevCLT.Tests/           # Testes unitários (xUnit + Moq)
-```
+## ✨ Funcionalidades Principais
 
-## Como rodar (desenvolvimento)
+### ⏱️ Controle de Jornada
+- **Timer Inteligente**: Contagem regressiva para jornada e pausas, e progressiva para horas extras.
+- **Estados de Trabalho**: Alterne facilmente entre *Trabalhando*, *Em Pausa* e *Hora Extra*.
+- **Notificações**: Receba alertas (Toasts) quando o tempo de pausa acabar ou quando atingir marcos de hora extra.
 
-```bash
-dotnet build DevCLTTimer.sln
-dotnet run --project src/DevCLT.WindowsApp/DevCLT.WindowsApp.csproj
-```
+### ⌨️ Produtividade Máxima
+- **Atalhos Globais (Hotkeys)**: Controle o timer de qualquer lugar do Windows, mesmo com o app minimizado.
+  - Padrão:
+    - **Ctrl+Alt+I**: Iniciar/Retomar Trabalho
+    - **Ctrl+Alt+P**: Iniciar Pausa
+    - **Ctrl+Alt+X**: Hora Extra
+- **System Tray**: O app pode ser minimizado para a bandeja do sistema, rodando em segundo plano sem ocupar espaço na barra de tarefas.
 
-Ou abra `DevCLTTimer.sln` no Visual Studio / Rider e pressione F5.
+### 📊 Histórico e Relatórios
+- **Visão Completa**: Acompanhe seu desempenho por **Semana**, **Mês** e **Ano**.
+- **Painel Anual**: Visualize o acumulado de horas trabalhadas e extras ao longo do ano.
+- **Exportação CSV**: Exporte seus dados de qualquer visualização para planilha (Excel/Google Sheets) para relatórios de horas.
 
-## Como publicar (.exe)
+### 🎨 Design e UX
+- **Modo Escuro**: Tema *Floresta Noturna* para conforto visual.
+- **Interface Moderna**: Desenvolvido em WPF com estilos customizados e bordas arredondadas (Windows 11 style).
+- **Sem Perda de Dados**: Persistência local segura com SQLite. Se fechar o app, ele recupera o estado exato ao reabrir.
 
-```bash
-dotnet publish src/DevCLT.WindowsApp/DevCLT.WindowsApp.csproj -c Release
-```
+---
 
-O executável single-file self-contained será gerado em:
-```
-src/DevCLT.WindowsApp/bin/Release/net8.0-windows10.0.17763.0/win-x64/publish/DevCLTTimer.exe
-```
+## 🛠️ Configuração
 
-## Funcionalidades MVP
+Acesse a tela de **Settings** (ícone de engrenagem) para:
+- **Personalizar Atalhos**: Grave suas próprias combinações de teclas para as ações globais.
+- **Ativar/Desativar Hotkeys**: Controle total sobre quando os atalhos devem funcionar.
 
-- ✅ Tela de Setup: horas trabalho, pausa, intervalo notificação hora extra
-- ✅ Timer Working: countdown + botão "Iniciar pausa" + "Encerrar jornada" (confirm)
-- ✅ Timer Break: countdown; ao acabar → toast + modal com "Retomar trabalho"
-- ✅ Jornada concluída: modal com "Concluir" / "Iniciar hora extra"
-- ✅ Hora extra: conta pra cima, notifica a cada X min configurável
-- ✅ Persistência SQLite: sessions, segments (work/break/overtime)
-- ✅ Histórico: visão Semana/Mês (ISO week seg-dom)
-- ✅ Recovery: card ao reabrir se sessão ativa ("Retomar" / "Descartar")
-- ✅ Empty state no histórico
-- ✅ System Tray: menu dinâmico baseado no estado
-- ✅ Close → minimize to tray com jornada ativa
-- ✅ Design system: Light theme (Argila/Sálvia), tokens, componentes WPF
-- ✅ TimerRing circular (2px) com warning color
+---
 
-## V1
+## 🚀 Como Usar
 
-- [x] Dark theme (Floresta Noturna)
-- [x] Title Bar Personalizada
-- [x] Satoshi font embarcada
-- [x] Tray tooltip e Menu de Contexto com tempo restante
-- [x] Painel anual
-- [x] Export CSV
-- [x] Hotkeys
+1. **Abra o App**: O timer inicia pronto para começar.
+2. **Inicie a Jornada**: Clique em Play ou use `Ctrl+Alt+I`.
+3. **Pausas**: Precisa de um café? Use `Ctrl+Alt+P`. O tempo de pausa é descontado corretamente.
+4. **Fim do Dia**: Ao atingir a meta, você pode encerrar ou entrar em **Hora Extra** (`Ctrl+Alt+X`).
+5. **Acompanhe**: Veja o histórico na aba de calendário para garantir que suas horas estão em dia.
 
-## V2
+---
 
-- [ ] Port para Linux (Avalonia)
+## 📦 Instalação
+
+Baixe a versão mais recente na aba [Releases do GitHub](#).
+O executável é *portable* (não requer instalação) e auto-contido.
+
+---
+
+## 💻 Tech Stack
+
+- **.NET 8**: Performance e modernidade.
+- **WPF**: Interface nativa Windows rica e responsiva.
+- **SQLite**: Banco de dados local robusto e leve.
+- **MVVM**: Arquitetura limpa e testável.
+
+---
+
+Desenvolvido para a comunidade Dev. <3

RELEASE_NOTES.md

@@ -0,0 +1,39 @@
+# Release Notes - DevCLT Timer v1.0.0 🚀
+
+Estamos orgulhosos de anunciar a versão oficial 1.0.0 do **DevCLT Timer**! Esta versão consolida todas as funcionalidades essenciais para o controle de ponto do desenvolvedor moderno, trazendo estabilidade, design refinado e novas ferramentas de produtividade.
+
+## 🌟 Destaques da Versão
+
+### ⌨️ Atalhos Globais (Global Hotkeys)
+Controle sua jornada sem tirar as mãos do teclado! Agora você pode iniciar, pausar e entrar em hora extra de qualquer lugar do Windows.
+- **Configurável**: Personalize as teclas de atalho na nova tela de Configurações.
+- **Padrões**: `Ctrl+Alt+I` (Início), `Ctrl+Alt+P` (Pausa), `Ctrl+Alt+X` (Hora Extra).
+
+### 📊 Histórico Expandido & Exportação CSV
+- **Painel Anual**: Nova visualização macro para acompanhar o saldo de horas do ano inteiro.
+- **Exportação de Dados**: Exporte seus relatórios (Semanal, Mensal ou Anual) para **CSV** com um clique, facilitando o envio de planilhas de horas.
+
+### ⚙️ Nova Tela de Configurações
+- Gerencie o comportamento do aplicativo.
+- Grave atalhos personalizados com detecção inteligente de conflitos.
+- Ative ou desative os atalhos globais rapidamente.
+
+### 🎨 Interface Refinada
+- **Visual Polido**: Melhorias no tema escuro, tipografia e espaçamentos.
+- **System Tray**: Menu de contexto da bandeja aprimorado para controle rápido.
+- **Bordas Arredondadas**: Ajustes visuais para melhor integração com Windows 11.
+
+## 📋 Lista Completa de Funcionalidades
+- ✅ Cronômetro preciso para Trabalho, Pausa e Hora Extra.
+- ✅ Persistência automática (nunca perca seu tempo registrado).
+- ✅ Notificações Toast nativas do Windows.
+- ✅ Banco de dados local SQLite (privacidade total).
+- ✅ Modo "Mini" na bandeja do sistema.
+
+## 🐞 Correções e Melhorias
+- Otimização da engine de tempo para maior precisão.
+- Correção na restauração da janela ao clicar no ícone da bandeja.
+- Melhorias de performance na carga do histórico.
+
+---
+*Baixe agora e assuma o controle do seu tempo!*