🚀 Crypto IA - Sistema Inteligente de Análisis de Criptomonedas

Sistema basado en IA para detectar proyectos fraudulentos en el ecosistema cripto y proporcionar recomendaciones interpretadas para ayudar a usuarios latinoamericanos a tomar decisiones financieras más seguras.

📋 Tabla de Contenidos

• Características
• Tecnologías
• Instalación
• Uso
• Estructura del Proyecto
• Roadmap
• Contribuir

✨ Características

Implementadas ✅

• Búsqueda de Criptomonedas: Busca cualquier cripto por nombre o símbolo
• Análisis Básico de Riesgo: Scoring automático (0-100) evaluando 6 factores clave
• Gráficos de Precio: Visualización histórica con múltiples timeframes
• Datos en Tiempo Real: Integración con CoinGecko API
• Historial de Búsquedas: Guarda tus últimas 10 búsquedas localmente
• Dashboard Interactivo: Estadísticas del mercado global y tendencias
• Sistema de Autenticación: Login, registro y verificación de email

En Desarrollo 🚧

• Análisis Avanzado On-Chain: Análisis de contratos inteligentes
• Detección de Patrones de Fraude: IA para identificar rug pulls, honeypots, pump & dump
• Módulo Educativo: Tutoriales interactivos sobre blockchain y criptomonedas
• Alertas Personalizadas: Notificaciones de proyectos sospechosos

🛠️ Tecnologías

Frontend

• React 18 - Framework UI
• Vite - Build tool y dev server
• React Router - Navegación
• Tailwind CSS - Estilos
• Recharts - Visualización de datos
• Lucide React - Iconos
• Axios - HTTP client

Backend

• Node.js - Runtime
• Express - Framework web
• MongoDB - Base de datos
• Mongoose - ODM
• JWT - Autenticación
• Bcrypt - Encriptación de contraseñas

APIs Externas

• CoinGecko API - Datos de criptomonedas
• Etherscan API (próximamente) - Análisis on-chain

📦 Instalación

Requisitos Previos

• Node.js >= 18.0.0
• MongoDB >= 5.0
• npm o yarn

Paso 1: Clonar el repositorio

git clone https://github.com/tu-usuario/crypto-ia.git
cd crypto-ia

Paso 2: Instalar dependencias del Backend

cd backend
npm install

Paso 3: Configurar variables de entorno del Backend

# Crear archivo .env en /backend
cp .env.example .env

# Editar .env con tus configuraciones
PORT=5000
MONGODB_URI=mongodb://localhost:27017/crypto-ia
JWT_SECRET=tu_secret_key_super_segura
NODE_ENV=development
FRONTEND_URL=http://localhost:5173

Paso 4: Iniciar el Backend

npm run dev

Paso 5: Instalar dependencias del Frontend

# En otra terminal
cd frontend
npm install

Paso 6: Configurar variables de entorno del Frontend

# Crear archivo .env en /frontend
VITE_API_URL=http://localhost:5000/api

Paso 7: Iniciar el Frontend

npm run dev

La aplicación estará disponible en http://localhost:5173

🎯 Uso

1. Registro e Inicio de Sesión

1. Accede a http://localhost:5173
2. Regístrate con email y contraseña
3. Verifica tu email (por ahora en consola del backend)
4. Inicia sesión

2. Analizar una Criptomoneda

1. Ve a "Análisis Básico"
2. Busca la criptomoneda que quieres analizar
3. Haz clic en el resultado
4. Revisa el gráfico de precios
5. Haz clic en "Analizar Riesgos" para ver el scoring

3. Ver Tendencias del Mercado

1. En el Dashboard verás las criptos en tendencia
2. Haz clic en cualquiera para ver su análisis

📁 Estructura del Proyecto

crypto-ia/
├── frontend/
│   ├── src/
│   │   ├── assets/          # Imágenes y recursos
│   │   ├── components/      # Componentes reutilizables
│   │   │   ├── auth/        # Componentes de autenticación
│   │   │   ├── crypto/      # Componentes de análisis cripto
│   │   │   ├── dashboard/   # Componentes del dashboard
│   │   │   └── ui/          # Componentes UI genéricos
│   │   ├── hooks/           # Custom hooks
│   │   ├── pages/           # Páginas completas
│   │   ├── services/        # APIs y servicios
│   │   ├── utils/           # Utilidades
│   │   ├── App.jsx          # Componente principal
│   │   └── main.jsx         # Punto de entrada
│   ├── public/              # Archivos estáticos
│   └── package.json
│
├── backend/
│   ├── src/
│   │   ├── config/          # Configuraciones
│   │   ├── controllers/     # Controladores
│   │   ├── middleware/      # Middlewares
│   │   ├── models/          # Modelos de MongoDB
│   │   ├── routes/          # Rutas de la API
│   │   ├── services/        # Lógica de negocio
│   │   └── utils/           # Utilidades
│   ├── server.js            # Punto de entrada
│   └── package.json
│
└── README.md

🗺️ Roadmap

Fase 1: Fundamentos ✅ (Completado)

• Sistema de autenticación
• Integración con CoinGecko API
• Búsqueda y visualización de criptomonedas
• Gráficos de precio
• Análisis básico de riesgo

Fase 2: Análisis Avanzado 🚧 (En Progreso)

• Integración con Etherscan API
• Análisis de contratos inteligentes
• Detección de honeypots
• Análisis de distribución de holders
• Detección de rug pulls

Fase 3: IA y Machine Learning 📅 (Próximamente)

• Entrenamiento de modelo de ML
• Detección automática de patrones de fraude
• Sistema de scoring avanzado con IA
• Predicción de riesgos

Fase 4: Educación y Comunidad 📅 (Futuro)

• Módulo educativo interactivo
• Tutoriales en video
• Blog de noticias cripto
• Foro de comunidad

🎓 Algoritmo de Scoring Básico

El sistema evalúa 6 factores clave:

1. Market Cap (25 pts): Evalúa el tamaño del proyecto

   • $10B = 25 pts (Muy establecido)

   • $1B-$10B = 18 pts (Consolidado)
   • $100M-$1B = 10 pts (Medio)
   • < $100M = 3 pts (Alto riesgo)

2. Volumen vs Market Cap (20 pts): Detecta manipulación

   • Ratio 5-50% = 20 pts (Saludable)
   • Ratio > 50% = 10 pts (Posible manipulación)
   • Ratio < 5% = 8 pts (Baja liquidez)

3. Edad del Proyecto (15 pts): Confiabilidad temporal

   • 3 años = 15 pts

   • 1-3 años = 10 pts
   • < 1 año = 5 pts

4. Ranking (15 pts): Posición en el mercado

   • Top 20 = 15 pts
   • Top 100 = 10 pts
   • Top 500 = 5 pts

   • 500 = 2 pts

5. Desarrollo Activo (15 pts): Commits en GitHub

   • 50 commits/mes = 15 pts

   • 10-50 commits/mes = 10 pts
   • 1-10 commits/mes = 5 pts
   • 0 commits = 0 pts

6. Comunidad (10 pts): Seguidores en redes

   • 500K = 10 pts

   • 50K-500K = 7 pts
   • 5K-50K = 4 pts
   • < 5K = 1 pt

Interpretación del Score:

• 80-100: Riesgo MUY BAJO ✅
• 60-79: Riesgo BAJO ℹ️
• 40-59: Riesgo MEDIO ⚠️
• 20-39: Riesgo ALTO ⚠️
• 0-19: Riesgo CRÍTICO ❌

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📄 Licencia

Este proyecto es parte de un trabajo académico para la Universidad Privada Franz Tamayo.

👨‍💻 Autor

Alejandro Danner Jamanca Alvarez

• Carrera: Ingeniería de Sistemas
• Asignatura: Proyecto Integrador Intermedio II
• Semestre: Sexto

⚠️ Disclaimer

Este sistema NO constituye asesoría financiera. Los mercados de criptomonedas son altamente volátiles y riesgosos. El análisis proporcionado es únicamente educativo y preventivo. Siempre realiza tu propia investigación (DYOR) antes de invertir y nunca inviertas más de lo que puedes permitirte perder.

📞 Soporte

Si encuentras algún bug o tienes sugerencias:

• Abre un Issue en GitHub
• Contacta al desarrollador

---

Hecho con ❤️ en Bolivia 🇧🇴