Brújula Cripto: Plataforma de Seguridad y Recuperación de Criptoactivos

Brújula Cripto es una solución integral y de nivel de producción diseñada para guiar a los usuarios a través de la complejidad del ecosistema de criptomonedas. La plataforma ofrece un conjunto de herramientas públicas para el diagnóstico, la recuperación y el análisis de activos digitales, junto con un potente panel de administración para la gestión completa del contenido, los usuarios y los servicios.

Filosofía y Arquitectura Central

El proyecto se fundamenta en una arquitectura de software moderna y resiliente, diseñada para la escalabilidad y el mantenimiento a largo plazo:

1. Estructura Centralizada (Monorepo): Todo el ecosistema (frontend, backend, microservicio de IA) reside en un único monorepo gestionado con pnpm workspaces. Esto impone una consistencia de código absoluta y facilita la compartición de lógica y tipos.

2. Tipos Compartidos como Única Fuente de Verdad: Un paquete dedicado (@brujula-cripto/types) centraliza todas las interfaces y modelos de datos (IUser, IArticle, etc.). Esto elimina por completo las inconsistencias entre el cliente y el servidor, garantizando una integración perfecta.

3. Mitigación de Vendor Lock-in (Abstracción de BD): La interacción con la base de datos (Firestore) se realiza a través de una capa de abstracción (Patrón Adaptador + Factory). Esto significa que CERO llamadas directas a Firebase existen en la lógica de negocio, permitiendo una futura migración a otra base de datos (ej. DynamoDB, MongoDB) sin reescribir el código de las funciones.

Características Principales

La plataforma se divide en dos grandes áreas funcionales:

Para Usuarios:

• Herramientas Públicas: Diagnóstico interactivo, recuperación de contraseñas (motor Wasm), rastreador de transacciones y un directorio de servicios profesionales.
• Blog y Guías de Seguridad: Contenido educativo con un potente buscador, paginación y funcionalidades sociales (likes/comentarios) para usuarios registrados.
• Chatbot Especialista "Brújula": Un asistente IA (basado en Google Gemini Pro) con capacidad de análisis de wallets en tiempo real (RAG), respuestas en streaming y una interfaz de usuario avanzada.
• Modelo de Monetización por Horas: Un innovador sistema de pago por uso (usageCreditsInSeconds) que da acceso a las funcionalidades premium, con créditos iniciales al registrarse.
• Soporte Multi-idioma (ES/EN) y temas (claro/oscuro).

Para Administradores:

• Panel de Control Centralizado: Un dashboard con estadísticas y accesos directos.
• Gestión de Contenido Avanzada: Editor de artículos (TipTap) con opciones de generación de contenido y SEO mediante IA (Gemini Pro), y gestión del contenido dinámico de la homepage.
• Moderación y Feedback: Herramientas para moderar comentarios (con asistencia de IA) y gestionar el feedback de los usuarios.
• Gestión de Usuarios: Visualización de usuarios, su estado y su saldo de créditos en formato H:M:S.

Enfoque en Calidad de Producción (Mejoras 2025)

El proyecto va más allá de las funcionalidades, implementando mejoras cruciales para un entorno de producción real:

• CI/CD Automatizado: Pipeline con Google Cloud Build para pruebas y despliegues automáticos.
• Gestión de Costos: Caché con Redis para reducir llamadas a APIs externas.
• Monitorización y Alertas: Integración con Google Cloud Monitoring para métricas de rendimiento.
• Kill Switch Financiero: Una Cloud Function que deshabilita automáticamente las APIs costosas si se supera un umbral de presupuesto para proteger el proyecto financieramente.
• Sistema de Frescura de Contenido: Un scoring automático que evalúa y muestra la actualidad de los artículos del blog.