https://github.com/esbnet/orbia-task-manager
Aplicação qua facilita a administração do tempo *
https://github.com/esbnet/orbia-task-manager
clean-architecture next next-auth prisma react reactqueryv5 shadcn-ui solid solid-principles swagger tailwindcss typescript zod
Last synced: 4 months ago
JSON representation
Aplicação qua facilita a administração do tempo *
- Host: GitHub
- URL: https://github.com/esbnet/orbia-task-manager
- Owner: esbnet
- Created: 2025-05-04T17:51:00.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-10-17T02:32:35.000Z (4 months ago)
- Last Synced: 2025-10-18T05:50:16.535Z (4 months ago)
- Topics: clean-architecture, next, next-auth, prisma, react, reactqueryv5, shadcn-ui, solid, solid-principles, swagger, tailwindcss, typescript, zod
- Language: TypeScript
- Homepage: https://orbia-esbnet.vercel.app
- Size: 2.25 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌟 Orbia - Task Manager com Clean Architecture
> Uma aplicação completa de gerenciamento de tarefas, hábitos e rotina diária implementada com **Clean Architecture** e princípios **SOLID**, demonstrando boas práticas de desenvolvimento de software.
## 🎯 Sobre o Projeto
**Orbia** é uma aplicação **full-stack** de produtividade pessoal que combina gerenciamento de tarefas, tracking de hábitos e organização da rotina diária. Desenvolvida para demonstrar a implementação prática da **Clean Architecture** em um contexto real, oferece uma arquitetura robusta e escalável.
### 🎆 Diferenciais
- **Arquitetura Limpa**: Implementação completa dos princípios SOLID
- **PWA Ready**: Funciona offline e pode ser instalada como app
- **Responsivo**: Interface adaptada para desktop e mobile
- **Analytics**: Dashboard com métricas e insights de produtividade
- **Organização Avançada**: Ferramentas de foco e estimativa de tempo
### ✨ Funcionalidades
#### 📅 **Tarefas Diárias (Daily)**
- ✅ Criar tarefas com repetição (diária, semanal, mensal)
- ✅ Gerenciar subtarefas
- ✅ Marcar como concluída com log de histórico
- ✅ Filtros por data e status
- ✅ Sistema de tags e dificuldade
#### 📝 **Tarefa (Todos)**
- ✅ Criar tarefas pontuais
- ✅ Gerenciar subtarefas
- ✅ Sistema de prioridades
- ✅ Controle de conclusão
- ✅ Organização por tags
#### 🔄 **Hábitos (Habits)**
- ✅ Criar hábitos recorrentes
- ✅ Sistema de reset de progresso (diário, semanal, mensal)
- ✅ Tracking contínuo sem ocultar hábitos
- ✅ Níveis de dificuldade
- ✅ Histórico de períodos e conclusões
- ✅ Métricas de consistência
#### 🏷️ **Sistema de Tags**
- ✅ Criação e gerenciamento de tags
- ✅ Cores personalizadas
- ✅ Associação com tarefas
- ✅ Filtros por categoria
#### 📈 **Analytics & Insights**
- ✅ Dashboard de indicadores
- ✅ Análise de desempenho
- ✅ Relatórios semanais
- ✅ Tracking de tempo
- ✅ Metas e progresso
#### 🎯 **Ferramentas de Organização**
- ✅ Organizador de tarefas
- ✅ Modo foco
- ✅ Estimador de tempo
- ✅ Configurações personalizadas
## 🏗️ Arquitetura
### Clean Architecture Implementada
```
📁 src/
├── 🎯 domain/ # Camada de Domínio
│ ├── entities/ # Entidades de negócio
│ ├── repositories/ # Interfaces dos repositórios
│ └── value-objects/ # Objetos de valor
├── 🔧 application/ # Camada de Aplicação
│ ├── use-cases/ # Casos de uso
│ │ ├── daily/ # Daily tasks
│ │ ├── todo/ # Todos
│ │ ├── habit/ # Hábitos
│ │ └── tag/ # Tags
│ └── dto/ # Data Transfer Objects
├── 🔌 infra/ # Camada de Infraestrutura
│ ├── database/ # Repositórios Prisma
│ ├── repositories/ # Repositórios HTTP
│ └── services/ # Serviços externos
├── 🖥️ app/ # Next.js App Router
│ ├── api/ # API Routes
│ ├── (home)/ # Páginas principais
│ └── auth/ # Autenticação
├── ⚛️ components/ # Componentes React
│ ├── ui/ # Componentes base
│ ├── analytics/ # Dashboards
│ └── organization/ # Ferramentas
├── 🔗 contexts/ # React Context
└── 🎯 hooks/ # Custom Hooks
```
### 🎯 Princípios SOLID Aplicados
- **S** - Single Responsibility: Cada classe tem uma única responsabilidade
- **O** - Open/Closed: Extensível sem modificar código existente
- **L** - Liskov Substitution: Implementações podem ser substituídas
- **I** - Interface Segregation: Interfaces específicas e coesas
- **D** - Dependency Inversion: Dependências abstraídas por interfaces
## 🛠️ Tecnologias
### Frontend
- **Next.js 14** - Framework React com App Router
- **TypeScript** - Tipagem estática e IntelliSense
- **Tailwind CSS** - Estilização utilitária
- **Shadcn/ui** - Componentes acessíveis e customizáveis
- **React Hook Form** - Gerenciamento de formulários
- **TanStack Query** - Gerenciamento de estado servidor
- **Date-fns** - Manipulação de datas
- **Recharts** - Gráficos e visualizações
- **PWA** - Progressive Web App
### Backend
- **Next.js API Routes** - Endpoints serverless
- **Prisma ORM** - Mapeamento objeto-relacional
- **Postgres** - Banco de dados (desenvolvimento)
### Arquitetura
- **Clean Architecture** - Separação de responsabilidades
- **SOLID Principles** - Princípios de design orientado a objetos
- **Repository Pattern** - Abstração de acesso a dados
- **Use Case Pattern** - Lógica de negócio isolada
- **Dependency Injection** - Inversão de controle
## 🔗 API Endpoints
### 📅 Daily Tasks
```http
GET /api/daily # Listar tarefas diárias
POST /api/daily # Criar tarefa diária
PATCH /api/daily # Atualizar tarefa diária
DELETE /api/daily?id={id} # Deletar tarefa diária
```
### 📝 Todos
```http
GET /api/todos # Listar todos
POST /api/todos # Criar todo
PATCH /api/todos # Atualizar todo
DELETE /api/todos?id={id} # Deletar todo
```
### 🔄 Habits
```http
GET /api/habits # Listar hábitos
POST /api/habits # Criar hábito
PATCH /api/habits # Atualizar hábito
DELETE /api/habits?id={id} # Deletar hábito
```
### 🏷️ Tags
```http
GET /api/tags # Listar tags
POST /api/tags # Criar tag
PATCH /api/tags # Atualizar tag
DELETE /api/tags?id={id} # Deletar tag
```
### 📋 Subtasks
```http
# Daily Subtasks
GET /api/daily-subtasks?dailyId={id} # Listar por daily
POST /api/daily-subtasks # Criar subtask
PATCH /api/daily-subtasks # Atualizar subtask
DELETE /api/daily-subtasks?id={id} # Deletar subtask
# Todo Subtasks
GET /api/todo-subtasks?todoId={id} # Listar por todo
POST /api/todo-subtasks # Criar subtask
PATCH /api/todo-subtasks # Atualizar subtask
DELETE /api/todo-subtasks?id={id} # Deletar subtask
```
### 📊 Logs
```http
POST /api/daily-logs # Registrar conclusão de daily
POST /api/todo-logs # Registrar conclusão de todo
POST /api/habit-logs # Registrar conclusão de hábito
```
### 📚 Documentação da API
A documentação completa da API está disponível via Swagger:
```http
GET /docs # Interface Swagger UI
GET /api/docs # Especificação OpenAPI JSON
```
Acesse `http://localhost:3000/docs` para explorar todos os endpoints interativamente.
## 🚀 Setup e Implantação
### Pré-requisitos
- Node.js 18+
- pnpm, npm ou yarn
- Git
### 1️⃣ Clonagem e Instalação
```bash
# Clonar repositório
git clone https://github.com/esbnet/orbia-task-manager.git
cd orbia-task-manager
# Instalar dependências
npm install
```
### 2️⃣ Configuração do Banco
```bash
# Gerar cliente Prisma
npx prisma generate
# Executar migrações
npx prisma db push
# (Opcional) Visualizar banco
npx prisma studio
```
### 3️⃣ Variáveis de Ambiente
Crie um arquivo `.env.local`:
```env
# Database
DATABASE_URL="file:./dev.db"
# Next.js
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"
```
### 4️⃣ Desenvolvimento
```bash
# Iniciar servidor de desenvolvimento
npm run dev
# Aplicação disponível em http://localhost:3000
```
### 5️⃣ Build e Deploy
```bash
# Build para produção
npm run build
# Iniciar em produção
npm start
```
### 🐳 Docker (Opcional)
```bash
# Build da imagem
docker build -t task-manager .
# Executar container
docker run -p 3000:3000 task-manager
```
### ☁️ Deploy na Vercel
```bash
# Instalar Vercel CLI
npm i -g vercel
# Deploy
vercel --prod
```
## 🧪 Testes
```bash
# Executar testes unitários
npm test
# Testes com coverage
npm run test:coverage
# Testes e2e
npm run test:e2e
```
## 📚 Estrutura de Pastas Detalhada
```
src/
├── app/ # Next.js App Router
│ ├── api/ # API Routes
│ ├── globals.css # Estilos globais
│ ├── layout.tsx # Layout principal
│ └── page.tsx # Página inicial
├── components/ # Componentes React
│ ├── ui/ # Componentes base (Shadcn)
│ ├── daily/ # Componentes de Daily
│ ├── todo/ # Componentes de Todo
│ └── habit/ # Componentes de Habit
├── contexts/ # Context API
├── domain/ # Camada de Domínio
├── hooks/ # Custom Hooks
├── infra/ # Infraestrutura
├── lib/ # Utilitários
├── types/ # Definições de tipos
├── use-cases/ # Casos de uso
└── utils/ # Funções utilitárias
```
## 🤝 Contribuição
1. Fork o projeto
2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
4. Push para a branch (`git push origin feature/AmazingFeature`)
5. Abra um Pull Request
## 📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
## 👨💻 Autor
**Esbnet** - [GitHub](https://github.com/esbnet)
---
⭐ **Se este projeto te ajudou, deixe uma estrela!**
=========================
🔧 Configuração Atual:
Desenvolvimento (Local):
Provider: postgresql
Database: postgresql://admin:admin123@localhost:5432/taskmanager
Usa directUrl para melhor performance
Produção (Supabase):
Provider: postgresql
Database: Supabase PostgreSQL na nuvem
Connection pooling otimizado
📋 Scripts disponíveis:
```bash
# Configurar para desenvolvimento (PostgreSQL local)
npm run db:dev
# Configurar para produção (PostgreSQL Supabase)
npm run db:prod
# Push do schema para desenvolvimento
npm run db:push:dev
# Push do schema para produção
npm run db:push:prod
```
🎯 Benefícios:
✅ Consistência: PostgreSQL em ambos ambientes
✅ Recursos avançados: Arrays, JSON, etc. em desenvolvimento
✅ Paridade: Mesmo comportamento local e produção
✅ Alternância fácil: Scripts automatizados