Skip to content

Home

Jump to bottom
danielmi5 edited this page Dec 12, 2025 · 9 revisions

Bienvenido a la wiki de BossFlow

Bossflow es una aplicación web para diseñar diagramas de flujo interactivos orientados a planificar estrategias contra jefes de videojuegos. Cada nodo representa una acción, decisión o efecto, y las conexiones modelan el flujo de la estrategia. Está pensada para jugadores, diseñadores y equipos que quieren documentar tácticas complejas de forma visual.

Este repositorio incluye la aplicación completa (frontend y backend), documentación técnica y guías de uso. La documentación JSDoc de github pages se puede acceder aquí.

Enlaces de las páginas principales de la wiki:

Para quién es esta Wiki

  • Jugadores que quieran planificar y compartir estrategias complejas.
  • Diseñadores de niveles y de jefes que necesitan documentar mecánicas y rutas de decisión.
  • Desarrolladores que contribuyen al proyecto o integran la herramienta en otros sistemas.

Stack MERN

  • MongoDB: base de datos NoSQL que almacena usuarios, diagramas y metadatos.
  • Express: framework minimalista para la API REST del backend.
  • React: biblioteca para construir la interfaz (frontend) y manejar el estado y la navegación.
  • Node.js: runtime que ejecuta el servidor backend.

Guía rápida de uso de la aplicación

  • Crear un diagrama: desde el Dashboard haz clic en "Nuevo Diagrama", arrastra nodos al lienzo y conéctalos.
  • Tipos de nodos: acción, decisión, condición y efectos (ver docs/api/NODE_TYPES.md).
  • Guardar y recuperar: usa los botones de guardar; los diagramas se almacenan en la API y pueden actualizarse con PUT.
  • Imágenes en nodos: se permiten cargas (consultar backend endpoints y docs/ sobre imágenes).
  • Exportar/Importar: JSON para intercambio; opciones para exportar a PNG/PDF están en el frontend.

Estructura de la documentación en ./docs

Enlace a la carpeta ./docs.

Documentos Raíz

  • docs/README.md: índice principal y guía de lectura para navegar la documentación
  • docs/analisis-competencia.md: análisis de aplicaciones similares y competencia
  • docs/estructura-organizativa.md: organización del equipo y roles
  • docs/recursos.md: recursos materiales, herramientas y servicios utilizados
  • docs/financiacion.md: plan de financiación y costes del proyecto
  • docs/presupuesto.md: desglose detallado del presupuesto
  • docs/legislacion.md: marco legal y normativa aplicable
  • docs/documentacion-legislacion.md: documentación legal detallada
  • docs/retrospectiva.md: retrospectivas de sprints y lecciones aprendidas

API (docs/api/)

Especificaciones relacionadas con la estructura de los diagramas:

  • estructura-nodos-json.md: esquema JSON y reglas de validación para los nodos
  • NODE_TYPES.md: tipos de nodos y su semántica

Arquitectura (docs/arquitectura/)

Detalles arquitectónicos del sistema:

  • arquitectura-tecnica.md: diseño general de la arquitectura
  • base-de-datos.md: esquema y modelo de datos MongoDB
  • auth-flujo.md: flujo de autenticación y autorización JWT
  • estrategia-logout.md: implementación del cierre de sesión

Despliegue (docs/despliegue/)

Guías para desplegar la aplicación:

  • DESPLIEGUE.md: guía rápida de despliegue
  • despliegue-vps.md: despliegue en VPS con Docker
  • setup-docker.md: configuración de Docker y Docker Compose

Proyecto (docs/proyecto/)

Información del proyecto y planificación:

  • objetivos-alcance.md: objetivos y alcance del proyecto
  • problema.md: definición del problema a resolver
  • viabilidad-tecnica.md: análisis de viabilidad técnica
  • asignacion.md: asignación de tareas y responsabilidades
  • recursos.md: recursos del proyecto (duplicado, ver raíz)

Historias de Usuario (docs/historias-usuario/)

Historias de usuario y criterios de aceptación:

  • crud-diagramas.md: historias de usuario para el CRUD de diagramas

Sprints (docs/sprints/)

Planificación y seguimiento de sprints:

  • planificacion-sprints.md: planificación general de sprints
  • product-backlog.md: backlog de producto
  • sprint1/, sprint2/, sprint3/...: ceremonias y documentación de cada sprint

UI/UX (docs/ui-ux/)

Recursos de diseño y experiencia de usuario:

  • figma.md: enlaces y notas de diseño en Figma
  • capturas/: capturas de pantalla del diseño

Capturas de aplicación (docs/img-app/)

Capturas de pantalla de la aplicación funcionando

Políticas (docs/politicas/)

Documentos legales y políticas de privacidad

Documentación para profesores (docs/dani/)

Documentación específica para evaluación académica

Integrantes del equipo

Clone this wiki locally