Skip to main content

🌐 Visión General del Ecosistema Yana

Yana es un ecosistema modular y extensible diseñado para administrar comunidades en Discord de forma profesional, automatizada y escalable.

🔄 Componentes principales​

Yana está dividido en cinco componentes principales:

1. 🎙️ Yana Bot (yana-bot)​

El corazón operativo dentro de Discord. Este bot permite:

  • Responder comandos con Slash (/)
  • Asignar roles automáticamente por sede, cohorte o clan
  • Gestionar usuarios, canales, permisos y moderación masiva
  • Detectar y reenviar mensajes especiales (menciones a roles)
  • Integrarse con otras APIs del ecosistema

2. 🧠 Yana Core (yana-core)​

El backend centralizado, desarrollado en NestJS, que maneja:

  • Toda la lógica de negocio
  • Acceso a base de datos (usuarios, clanes, sedes, historial)
  • API REST y WebSockets para yana-desk y yana-bot
  • Validación de usuarios antes de ingresar al servidor

3. 🖥️ Yana Desk (yana-desk)​

La interfaz gráfica de administración, creada con Vite + React:

  • Permite ver estadísticas, programar mensajes, gestionar usuarios
  • Configurar nuevas cohortes, clanes y sedes desde un panel amigable
  • Visualizar rankings, logs y actividad por persona/sede/clan
  • Filtrar, buscar y actuar sin necesidad de acceder a Discord

4. 📦 Yana Infrastructure (yana-infrastructure)​

Define y ejecuta la infraestructura completa del proyecto:

  • Contenedores Docker orquestados con docker-compose
  • GHCR como registro de imágenes de cada servicio
  • Proxy inverso con Nginx Proxy Manager
  • Automatización del despliegue vía GitHub Actions

5. 📚 Yana Docs (yana-docs)​

Este sitio de documentación, creado con Docusaurus, que explica:

  • La visión del proyecto
  • Cómo contribuir o desplegarlo
  • Uso interno para el equipo y externo para potenciales aliados

🧬 ¿Por qué modular?​

Separar el proyecto en módulos permite:

  • 🔁 Escalar por partes: cada servicio puede crecer o cambiar sin afectar a los demás.
  • 🧪 Probar individualmente cada componente.
  • 🤝 Permitir colaboración distribuida en equipos separados (frontend, bot, backend, devops).

🛠️ Flujo de interacción​

    Usuario en Discord
          ⬇
       yana-bot
          ⬇
      yana-core (API)
          ⬇
      PostgreSQL + lógica
          ⬆
     yana-desk (admin UI)
          ⬇
   DevOps + Deploy automático
          ⬆
  yana-infrastructure + GitHub