Chía: El Equilibrio Perdido

Plataforma web del videojuego Chía, inspirado en la cultura Muisca. Une una landing en React, una API en Spring Boot con PostgreSQL y un panel administrativo para gestionar donaciones y citas.

El proyecto

Chía: El Equilibrio Perdido es un videojuego de acción inspirado en la cosmovisión de la cultura Muisca, ambientado unos 200 años antes de la llegada de los europeos. Lo desarrollan cinco estudiantes de la Universidad Autónoma de Bucaramanga y fue aprobado en la convocatoria CoCrea 2025, modalidad PAI.

El sistema tiene tres partes: la landing pública, que presenta el juego y explica el beneficio tributario para quien dona; una API REST que guarda las donaciones y las citas; y un panel privado con el que el equipo revisa y decide cada aporte. El sitio está en producción y recibe donaciones.

Mi aporte

Participé como auxiliar de investigación y como programador full stack. Aquí cuento sobre todo el backend, que es la parte que más pesa en el sistema, y cómo se conecta con la interfaz.

En el frontend trabajé sobre la landing en React y TypeScript: las secciones de presentación, el formulario de donación con firma digital, la calculadora del beneficio tributario, la agenda de citas y las pantallas del panel.

Arquitectura

El navegador entra por Nginx, que termina el TLS y reparte el tráfico: las páginas van al contenedor del frontend y las llamadas a la API van al backend. Los tres servicios corren con Docker Compose y solo Nginx queda expuesto a internet.

No publico las credenciales, la infraestructura ni el detalle del esquema de la base de datos, porque el sitio recibe donaciones.

El backend por capas

El backend sigue una arquitectura por capas, con unas 3.000 líneas de Java. Cada petición pasa por el filtro de seguridad, llega a un controlador, que delega en un servicio, y este usa los repositorios para hablar con la base de datos. Ninguna capa se salta a la siguiente.

Base de datos

La persistencia usa PostgreSQL con Spring Data JPA. Por seguridad no publico el detalle del esquema, pero sí cómo se organiza.

Cómo se conecta el frontend con el backend

La interfaz no llama a la red por su cuenta. Todo pasa por un cliente HTTP único, que agrega la sesión y normaliza los errores, y por servicios pequeños que arman cada petición.

Recorrido de una donación

Es el flujo más delicado del sistema, porque junta archivos, datos personales y correos. Va desde el formulario público hasta la decisión del administrador.

Panel administrativo

No muestro capturas del panel, porque contiene datos de donantes.

Despliegue

El sistema se empaqueta en tres contenedores con Docker Compose: frontend, backend y Nginx. Los dos Dockerfiles compilan en dos etapas, con Maven y Java 21 para el backend y Node para el frontend, así la imagen final solo lleva lo necesario para correr.

Otros proyectos

  • InsulinaVR: Prototipo de realidad virtual para Android y Google Cardboard que enseña a adultos con diabetes tipo 2 la técnica de insulinización con lapicero, el…
  • Gestión de usuarios: API REST para administrar usuarios, roles, perfiles, direcciones y teléfonos, con un panel de administración en React. Construida como proyecto de…
  • Sistema de vigilancia: plataforma web y app móvil: Sistema para una empresa de vigilancia, con dos entornos que trabajan juntos: una plataforma web para la operación y una app móvil para los…
  • Cthulhu Jamboree: Combate local 1v1 entre dos peces que cuelgan de un globo. Revienta el globo de tu rival antes de caer al vacío. Hecho en 48 horas para la Global…
  • Renacer Vikingo: RPG 2D en pixel art donde un humilde Karl reconstruye su aldea vikinga tras la invasión de los Cruzados, sube de rango hasta Konungr y devuelve la…
  • HuronTroll: Juego de plataformas 2D en pixel art protagonizado por un hurón. Hecho en 48 horas para la Global Game Jam 2024 bajo el tema «Make Me Laugh».
  • Meditraz: Prototipo académico para registrar y rastrear medicamentos en un entorno clínico: inventario con lote y vencimiento, solicitudes de enfermería,…

Contacto