convez.ai
PluginFinanceiroAvançado
gustavograciano

CryptoDash – Dashboard de Portfolio Cripto com IA

gustavograciano/cryptodash

Monitore holdings cripto com sinais técnicos e resumos IA gerados automaticamente

Ver no GitHub
InicialPluginScore · de 0 a 100

Dashboard pessoal single-user para gerenciamento de portfolio de criptomoedas construído com .NET 8 e React 18. Integra análise técnica (RSI, MA200, Fear & Greed), DCA inteligente com sugestões de aporte, digest diário via Claude, e 6 jobs Quartz para coleta contínua de dados de mercado. Implementa Clean Architecture rigorosa com autenticação JWT, persistência PostgreSQL e deploy containerizado.

Instalação

$npx convez-ai gustavograciano/cryptodash

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar alocação e desempenho de portfolio cripto em tempo real
  • Receber recomendações de DCA (Dollar Cost Averaging) baseadas em análise técnica
  • Obter digest diário de notícias cripto sintetizadas por Claude
  • Visualizar indicadores técnicos (RSI, MA200, volatilidade, drawdown) por moeda

Veredito

Projeto técnico robusto com arquitetura profissional (Clean Architecture, SOLID), stack moderno (.NET 8 + React 18) e automação real via Quartz. Ideal como portfolio piece ou base para aprender full-stack com foco em domínios financeiros; não substitui plataformas custodiais reais, mas prototipa bem a ideia de dashboard inteligente para cripto.

README

A tradução para o português deste README ainda está na fila.

CryptoDash

Dashboard pessoal de portfolio de criptomoedas. Reúne em uma única tela: estado do portfolio, contexto de mercado, sinais técnicos objetivos e resumo de notícias gerado por IA.

Single-user, projeto pessoal/portfólio. Não executa ordens. Não armazena chaves de exchange. Não dá conselho de investimento.

Stack

  • Backend: .NET 8 Web API · EF Core 8 · PostgreSQL 16 · Quartz.NET · Refit · Serilog · BCrypt + JWT
  • Frontend: React 18 · TypeScript · Vite 6 · Tailwind 3 · TanStack Query 5 · Zustand · Recharts
  • Integrações: CoinGecko, Alternative.me (Fear & Greed), CryptoPanic, Anthropic Claude
  • Deploy: Docker Compose · Nginx + Let's Encrypt · backup pg_dump automático

Arquitetura (Clean Architecture)

CryptoDash.sln
├── src/
│   ├── CryptoDash.Domain/          (entidades, enums)
│   ├── CryptoDash.Application/     (DTOs, services, abstrações)
│   ├── CryptoDash.Infrastructure/  (EF Core, Refit, Quartz jobs)
│   └── CryptoDash.Api/             (controllers, JWT, Program.cs)
└── frontend/                       (React + Vite + Tailwind)

Regras: Api → Application → Domain, Infrastructure → Application + Domain. Domain não depende de nada.

Funcionalidades

SprintEntregue
1 — FoundationAuth JWT, CRUD de transações manuais, holdings recalculadas (avg cost), preços ao vivo via CoinGecko (Quartz a cada 15 min), dashboard com Holdings + Allocation Donut + Deviation Table
2 — MarketOHLCV diário (retenção 2 anos), Fear & Greed, BTC dominance, MA200, RSI semanal Wilder, volatilidade anualizada 30d, distância de máximas 90d/365d, gráfico histórico modal 30/90/1y
3 — DCA + IAPlano de aporte mensal, algoritmo greedy proporcional ao gap, sugestão de distribuição, fluxo "executei → cria transactions", news cache CryptoPanic, digest IA diário (Claude com fallback determinístico)
4 — PolishPWA manifest + service worker, Dockerfile multi-stage, Nginx reverse proxy + HTTPS, backup pg_dump diário com retenção 7 dias

📖 Manual com prints

Veja o Manual de uso com screenshots de todas as telas, fluxos e modais. Útil pra entender o produto sem precisar rodar.

Dashboard

Setup local

# pré-requisitos: docker 24+, dotnet 8 SDK, node 20 LTS
cp .env.example .env
docker compose up -d
# api: http://localhost:5000   frontend: http://localhost:5173

Login seedado: gustavo@cryptodash.local / ChangeMe@123 (ou o que estiver em .env).

Deploy produção

cp .env.production.example .env.production
# editar .env.production com secrets reais
docker compose --env-file .env.production -f docker-compose.prod.yml up -d --build

Antes de subir, gere certificados Let's Encrypt em deploy/letsencrypt/live/<seu-domínio>/ (use certbot no host) e ajuste server_name em deploy/nginx/nginx.conf.

Endpoints principais

POST /api/v1/auth/login
GET  /api/v1/portfolio/summary
GET  /api/v1/portfolio/holdings
POST /api/v1/portfolio/transactions
GET  /api/v1/portfolio/rebalance-suggestion
GET  /api/v1/market/overview
GET  /api/v1/market/coins/{symbol}/history?range=30d|90d|1y
GET  /api/v1/market/coins/{symbol}/indicators
GET  /api/v1/aports/next
POST /api/v1/aports/execute
GET  /api/v1/news/digest/today

Jobs Quartz

JobCronDescrição
PriceSnapshotJoba cada 15 minpreços CoinGecko
PriceHistoryJob1h da manhãOHLCV diário (retenção 2 anos)
MarketIndicatorsJob2hFear & Greed + BTC dominance
NewsFetchJoba cada 2hCryptoPanic
AIDigestJob7hdigest Claude (idempotente)
AportReminderJob9hlog se hoje é dia de aporte

Segurança

  • Secrets nunca commitados (.env* no .gitignore).
  • JWT key mínimo 32 chars (openssl rand -hex 32).
  • BCrypt work factor 12 para senhas.
  • HTTPS obrigatório em produção (Let's Encrypt).
  • CORS restrito ao domínio público.
  • Sem PII além de email do user.

Limitações conhecidas

  • P&L é estimado: preços CoinGecko podem divergir do que o Itaú íon executou.
  • Sem backtest, sem alertas, sem multi-user (escopo v1).
  • Custo Claude limitado a 1 digest/dia (~centavos/mês).

Licença

Projeto pessoal / portfólio. Use à vontade como referência.

Ver o original no GitHub

Bom para

Relacionados