🌟 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

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

GET    /api/todos              # Listar todos
POST   /api/todos              # Criar todo
PATCH  /api/todos              # Atualizar todo
DELETE /api/todos?id={id}      # Deletar todo

🔄 Habits

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

GET    /api/tags               # Listar tags
POST   /api/tags               # Criar tag
PATCH  /api/tags               # Atualizar tag
DELETE /api/tags?id={id}       # Deletar tag

📋 Subtasks

# 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

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:

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

# 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

# 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:

# Database
DATABASE_URL="file:./dev.db"

# Next.js
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"

4️⃣ Desenvolvimento

# Iniciar servidor de desenvolvimento
npm run dev

# Aplicação disponível em http://localhost:3000

5️⃣ Build e Deploy

# Build para produção
npm run build

# Iniciar em produção
npm start

🐳 Docker (Opcional)

# Build da imagem
docker build -t task-manager .

# Executar container
docker run -p 3000:3000 task-manager

☁️ Deploy na Vercel

# Instalar Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

🧪 Testes

# 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

Fork o projeto
Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
Commit suas mudanças (git commit -m 'Add some AmazingFeature')
Push para a branch (git push origin feature/AmazingFeature)
Abra um Pull Request

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👨‍💻 Autor

Esbnet - GitHub

⭐ 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:

# 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

Name		Name	Last commit message	Last commit date
Latest commit History 98 Commits
.vscode		.vscode
docs		docs
prisma		prisma
public		public
scripts		scripts
src		src
.dockerignore		.dockerignore
.gitignore		.gitignore
.kilocodemodes		.kilocodemodes
Dockerfile		Dockerfile
README.md		README.md
biome.json		biome.json
components.json		components.json
docker-compose.yml		docker-compose.yml
eslint.config.mjs		eslint.config.mjs
middleware.ts		middleware.ts
next.config.ts		next.config.ts
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

esbnet/orbia-task-manager

Folders and files

Latest commit

History

Repository files navigation