Winbit Rails + React

Plataforma de administración de inversiones con backend Rails API y frontend React.

🏗️ Arquitectura

Backend: Rails 8 API (raíz del proyecto)
- Postgres + Devise + Google OAuth
- RSpec para testing
- Rubocop para linting
- Brakeman para security scanning
Frontend: React + Vite + TypeScript (ui/)
- TailwindCSS para estilos
- Vitest + Testing Library para testing
- ESLint para linting

📋 Requisitos

Ruby 3.2.4 (ver .ruby-version)
Node >= 20.x
Postgres >= 14
Git hooks configurados (se instalan automáticamente con bin/setup)

🚀 Setup Local

1. Clonar y configurar

git clone https://github.com/quequeo/winbit-rails.git
cd winbit-rails

2. Variables de entorno

Crear archivo .env en la raíz (no se commitea):

# Database
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres

# Google OAuth
GOOGLE_CLIENT_ID=tu_client_id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=tu_client_secret

# Rails
RAILS_MASTER_KEY=tu_master_key

# Resend (notificaciones por email)
RESEND_API_KEY=re_xxxxxxxxxxxxx
RESEND_FROM_EMAIL=Winbit <noreply@yourdomain.com>

# Frontend URL (para links en emails y redirects OAuth)
FRONTEND_URL=http://localhost:5173

# CORS (frontend permitido)
CORS_ORIGINS=http://localhost:5173,https://winbit-6579c.web.app

# App Host (para links en emails)
APP_HOST=localhost:3000

3. Backend (Rails)

# Instalar dependencias
bundle install

# Preparar base de datos
bin/rails db:prepare
bin/rails db:seed  # Crea admins y datos demo

# Levantar servidor
bin/rails server -p 3000

API disponible en: http://localhost:3000

4. Frontend (React)

cd ui
npm install
npm run dev

UI disponible en: http://localhost:5173

🔑 Autenticación (Google OAuth)

Setup en Google Cloud Console

Ir a Google Cloud Console
Crear un proyecto o usar uno existente
Habilitar "Google+ API"
Crear credenciales OAuth 2.0
Agregar URIs de redirección autorizadas:
- Local: http://localhost:3000/users/auth/google_oauth2/callback
- Producción: https://winbit-rails-55a941b2fe50.herokuapp.com/users/auth/google_oauth2/callback

Admins autorizados

Solo estos emails pueden acceder (definidos en db/seeds.rb):

winbit.cfds@gmail.com
jaimegarciamendez@gmail.com

Para agregar más admins, crear registro en tabla users con rol ADMIN o SUPERADMIN.

🧪 Testing

Backend (RSpec)

# Ejecutar todos los tests
bundle exec rspec

# Ejecutar tests específicos
bundle exec rspec spec/requests/api/admin/investors_spec.rb

# Con cobertura
COVERAGE=true bundle exec rspec

Cobertura actual: 79.36% (173 tests, 323/407 lines)

Frontend (Vitest)

cd ui

# Ejecutar todos los tests
npm run test

# Con cobertura
npm run test -- --coverage

# Modo watch
npm run test -- --watch

# Solo un archivo
npm run test src/pages/InvestorsPage.test.tsx

Cobertura actual: 85.68% (124 tests)

Métrica	Backend (Rails)	Frontend (React)
Lines	79.36%	85.68%
Branches	N/A	85.03%
Functions	N/A	65.28%
Total Tests	173	124

Coverage por Componente (Frontend)

✅ API Service (api.ts): 100%
✅ Formatters (formatters.ts): 100%
✅ Pages: 84.53% promedio
- DashboardPage: 100%
- EditPortfolioPage: 100%
- LoginPage: 100%
- InvestorsPage: 100%
- PortfoliosPage: 100%
- RequestsPage: 97.34%
- AdminsPage: 98.41%

📧 Sistema de Notificaciones por Email

Winbit utiliza Resend para enviar notificaciones automáticas:

Emails para Inversores:

✅ Depósito creado, aprobado, rechazado
✅ Retiro creado, aprobado, rechazado

Emails para Admins:

💰 Nuevo depósito pendiente
💸 Nuevo retiro pendiente

Configuración:

# Obtener API key en https://resend.com/api-keys
heroku config:set RESEND_API_KEY=re_xxxxxxxxxxxxx -a winbit-rails
heroku config:set RESEND_FROM_EMAIL="Winbit <noreply@yourdomain.com>" -a winbit-rails

Costos:

Free tier: 3,000 emails/mes
Estimado Winbit: ~150-200 emails/mes
Costo real: $0/mes (dentro del free tier)

📖 Documentación completa: Ver EMAILS.md

🛠️ Scripts Útiles

Importar datos de inversores desde spreadsheet

# En Heroku
heroku run rake investors:import -a winbit-rails

# Local
bin/rails investors:import

Este script actualiza portfolios con datos de capital y retornos.

Linting y Security

# Backend
bundle exec rubocop              # Lint
bundle exec rubocop -a           # Auto-fix
bundle exec brakeman             # Security scan

# Frontend
cd ui
npm run lint                     # ESLint
npm run lint:fix                 # Auto-fix

🔄 Pre-Push Hooks

El proyecto tiene hooks de pre-push configurados que ejecutan automáticamente:

✅ Bundle check
✅ RSpec tests
✅ Rubocop lint
✅ Brakeman security scan
✅ Vitest tests

Si algún check falla, el push es rechazado. Configuración en .githooks/pre-push.

📊 Modelos de Datos

User: Admins del sistema (ADMIN, SUPERADMIN)
Investor: Inversores con portfolios
Portfolio: Balance actual y retornos acumulados
PortfolioHistory: Historial de movimientos
InvestorRequest: Solicitudes de depósito/retiro
Wallet: Configuración de billeteras crypto

🌐 API Endpoints

Public API

GET /api/public/wallets - Billeteras disponibles
GET /api/public/investor/:email - Info de inversor
GET /api/public/investor/:email/history - Historial de movimientos
POST /api/public/requests - Crear solicitud de depósito/retiro

Admin API (requiere autenticación)

Admins: /api/admin/admins (CRUD)
Investors: /api/admin/investors (CRUD + sorting)
Portfolios: /api/admin/portfolios (list, update)
Requests: /api/admin/requests (CRUD + approve/reject)
Dashboard: /api/admin/dashboard (estadísticas)

🚢 Deploy (Heroku)

⚠️ IMPORTANTE: Heroku está configurado para hacer deploy automático desde el branch main de GitHub.

NO es necesario hacer git push heroku main - solo hacer git push origin main y Heroku se encarga del resto.

Configuración inicial (ya realizada)

# Login
heroku login

# Agregar remote (solo para comandos heroku, no para deploy)
git remote add heroku https://git.heroku.com/winbit-rails.git

Buildpacks (en orden)

heroku/nodejs - Para construir UI React
heroku/ruby - Para Rails

Config Vars necesarias

heroku config:set GOOGLE_CLIENT_ID=xxx
heroku config:set GOOGLE_CLIENT_SECRET=xxx
heroku config:set RAILS_MASTER_KEY=xxx
heroku config:set NODE_ENV=production

DATABASE_URL se configura automáticamente al agregar Heroku Postgres.

Comandos útiles

# Ver logs
heroku logs --tail -a winbit-rails

# Ejecutar migraciones
heroku run rails db:migrate -a winbit-rails

# Importar datos
heroku run rake investors:import -a winbit-rails

# Console
heroku run rails console -a winbit-rails

📝 Desarrollo

Agregar un nuevo admin

# En rails console
User.create!(
  email: 'nuevo@ejemplo.com',
  name: 'Nuevo Admin',
  role: 'ADMIN'
)

Crear inversor de prueba

# En rails console
investor = Investor.create!(
  email: 'test@ejemplo.com',
  name: 'Inversor Test',
  status: 'ACTIVE'
)

Portfolio.create!(
  investor: investor,
  current_balance: 10000,
  total_invested: 10000,
  accumulated_return_usd: 0,
  accumulated_return_percent: 0,
  annual_return_usd: 0,
  annual_return_percent: 0
)

🔧 Troubleshooting

Error: "No puedo conectarme a Postgres"

# Verificar que Postgres está corriendo
pg_isready

# Verificar variables de entorno
echo $POSTGRES_HOST

Error: "redirect_uri_mismatch" en Google OAuth

Verificar que las URIs en Google Cloud Console coincidan exactamente:

Local: http://localhost:3000/users/auth/google_oauth2/callback
Producción: https://tu-app.herokuapp.com/users/auth/google_oauth2/callback

Tests fallan en pre-push

# Ejecutar tests manualmente para ver detalles
bundle exec rspec
cd ui && npm run test:run

📄 Licencia

Privado - Winbit

Name		Name	Last commit message	Last commit date
Latest commit History 102 Commits
.githooks		.githooks
.github/workflows		.github/workflows
app		app
bin		bin
config		config
db		db
lib/tasks		lib/tasks
public		public
spec		spec
ui		ui
.gitignore		.gitignore
.rspec		.rspec
.rubocop.yml		.rubocop.yml
.ruby-version		.ruby-version
EMAILS.md		EMAILS.md
Gemfile		Gemfile
Gemfile.lock		Gemfile.lock
Procfile		Procfile
README.md		README.md
Rakefile		Rakefile
config.ru		config.ru
env.example		env.example
package.json		package.json

quequeo/winbit-rails

Folders and files

Latest commit

History

Repository files navigation