CS2031 - Desarrollo Basado en Plataforma
- Nayeli Belen Guerrero Gutierrez
- Julio Cesar Portugal Vilca
- Carlos Renato Guerra Marquina
- Yeimi Adelmar Varela Villarreal
- Introducción
- Identificación del Problema o Necesidad
- Descripción de la Solución
- Modelo de Entidades
- Manejo de Errores y Testing
- Eventos y Asincronía
- Integración con Servicios de Terceros
En entornos urbanos, especialmente en comunidades con alta densidad poblacional, la gestión de incidentes como robos, incendios, choques u otras emergencias presenta desafíos críticos. En el contexto peruano, muchas zonas urbanas no cuentan con mecanismos digitales eficientes para reportar y visualizar incidentes en tiempo real. Además, actualmente existen muchas zonas urbanas del Perú que carecen de plataformas tecnológicas integradas que permitan una comunicación rápida entre los ciudadanos afectados y los servicios de atención correspondientes; como la policía, los bomberos o los centros médicos. Esta brecha tecnológica genera demoras en la atención de emergencias, disminuye la capacidad de respuesta de las autoridades y aumenta la percepción de inseguridad en la población.
Adicionalmente, la escasez de datos organizados sobre los incidentes reportados limita la posibilidad de realizar análisis predictivos o de diseñar políticas de prevención efectivas. La digitalización de estos procesos no solo optimizaría la atención, sino que también permitiría la recolección de información clave para mejorar la seguridad ciudadana y fortalecer la gestión pública a nivel local, regional y nacional.
- Facilitar a los ciudadanos el reporte de emergencias mediante una aplicación y/o plataforma web.
- Visualizar en tiempo real los incidentes en un mapa interactivo.
- Brindar notificaciones a los usuarios cercanos a zonas de riesgo.
- Generar un historial de incidentes con trazabilidad y cambios de estado.
- Garantizar la escalabilidad y seguridad del sistema para su implementación en diferentes regiones del país.
Actualmente, la comunicación de emergencias depende de llamadas telefónicas informales, grupos de WhatsApp, números saturados o reportes tardíos. No existe una plataforma comunitaria moderna que permita alertar, registrar y dar seguimiento a incidentes de manera estructurada y eficiente. Toda esta situación genera múltiples inconvenientes: duplicidad de alertas, pérdida de información crítica, falta de trazabilidad y tiempos de respuesta ineficientes por parte de las autoridades y servicios de emergencia. Además, los ciudadanos no tienen una herramienta integral y confiable que les permita conocer en tiempo real qué incidentes están ocurriendo en su entorno, dificultando la toma de decisiones preventivas y la coordinación vecinal ante eventos peligrosos.
Resolver este problema permite reducir tiempos de respuesta, mejorar la seguridad comunitaria y ofrecer a las autoridades herramientas para priorizar intervenciones. Además, fortalece el tejido social al permitir que los vecinos colaboren activamente en la seguridad de su entorno.
En un país como el nuestro, y más aún en la situación complicada que estamos pasando en términos de violencia e incremento del índice de criminalidad, el hecho de contar con una herramienta de ese tipo no solo optimizaría la capacidad de respuesta, sino que también empoderaría a los ciudadanos, facilitaría la planificación de las autoridades locales y permitiría generar datos valiosos para la prevención y formulación de políticas públicas más eficaces.
- Registro de usuarios con validación segura.
- Reporte de incidentes con prioridad, tipo, ubicación y evidencia (fotos/videos).
- Visualización de incidentes en mapa usando Nominatim.
- Notificaciones automáticas a usuarios cercanos a algún incidente/accidente.
- Historial de estatus y seguimiento de cada incidente.
- Dashboard con métricas y filtros por zona, tipo y estado.
- Backend: Java 21, Spring Boot, Spring Data JPA, Spring Web
- Base de Datos: PostgreSQL
- DTO Mapping: ModelMapper
- Control de Versiones: Git, GitHub
- API Externas: Nominatim
- Herramientas: IntelliJ IDEA, Postman
- Usuario: representa a los ciudadanos. Tiene como PK a (ID,DNI,correo). Asimismo, cuenta con otros atributos como nombre,edad,contraseña,celular, que permiten recopilar caracteristicas importantes en los mismos y se puedan reportar de manera concisa los incidentes. Relaciones: un usuario puede reportar muchos incidentes y muchos usuarios puede recibir una notificacion
- Incidente: contiene la información de una incidencia reportada. Tiene como PK el ID de incidente y otros atributos clave para para describir el suceso y sea identificable. Relaciones: un incidente puede ser reportado por muchos usuarios.
- Reportar: tabla intermedia que se forma al haber una relación many to many entre Usuario e Incidente. Dado que un usuario puede reportar muchos incidentes y un incidente puede ser reportado por muchos usuarios, corroboramos que es ese tipo de relación y se forma dicha tabla intermedia que absorbe las PK del Usuario así como también el PK de Incidente.
- Lugar: es la representación geográfica donde sucedió el incidente. Tiene a ID como PK y tiene atributos como departamento, provincia,distrito,etc. que nos permite dar una ubicación precisa del acontecimiento. Relaciones: en un lugar suceden muchos incidentes.
- Evidencia: Contiene los archivos (fotos, videos u otros documentos) que respaldan un reporte. Tiene ID y Archivo como PK. Relaciones: muchas evidencias puede tener un solo incidente. Es entidad débil ya que no existiría sin un incidente y a la vez es participación total ya que toda evidencia tiene que estar en al menos un incidente.
- Notificación: Representa los mensajes enviados a usuarios sobre incidentes. Tiene como PK a ID e incluye atributos como texto, FechaEnvío, el incidente_id relacionado y el estatus del incidente al momento del envío. Relaciones: una notificacion puede ser recibida por muchos usuarios y muchas notificaciones puede ser generadas por un incidente.
- Recibir: entre usuario y notificacion hay una relación many to many por lo que se crea dicha tabla intermedia.
- HistorialEstatus:Guarda un registro de los cambios de estado de cada incidente, en otras palabras aquí se almacena la evolución del mismo. Tiene como PK A (ID,Incidente_ID) Relaciones: muchos HistorialEstatus pueden estar contenidos en un incidente. Corresponde a una entidad débil con respecto a Incidente ya que la misma no existiría sin Incidente.
Durante el desarrollo del backend, se implementaron diversos niveles de pruebas con el fin de garantizar la calidad, estabilidad y fiabilidad del sistema:
-Pruebas Unitarias: Se diseñaron para validar el comportamiento correcto de métodos individuales en servicios y controladores. Se utilizó JUnit en conjunto con Mockito para simular dependencias y verificar la lógica de negocio.
-Pruebas de Integración: Se realizaron pruebas que validan la interacción entre componentes del sistema, especialmente entre el controlador y las capas de servicio/repositorio.
-Pruebas de API (Postman): Se elaboraron colecciones de pruebas en Postman para verificar el correcto funcionamiento de los endpoints REST expuestos, validando respuestas HTTP, códigos de estado y estructuras JSON.
-Pruebas de Aceptación Manuales: Realizadas para evaluar el sistema desde el punto de vista del usuario final, simulando casos reales de uso como el reporte de incidentes, recepción de notificaciones y cambios de estado.
Las pruebas ejecutadas permitieron detectar y corregir errores relacionados con:
- Validación incorrecta de datos en DTOs.
-Manejo de fechas y timestamps en el historial de incidentes.
-
Errores en el envío de notificaciones duplicadas.
-
Fallos de integración entre entidades relacionadas (por ejemplo, incidentes sin usuario asociado).
-
Asegurar el correcto funcionamiento de la capa de seguridad y autenticación.
-
Se logró una cobertura satisfactoria de las funcionalidades principales, asegurando que el sistema responde adecuadamente ante entradas válidas y maneja con robustez los casos inválidos.
El sistema incorpora un mecanismo global de manejo de excepciones utilizando @RestControllerAdvice, lo que permite capturar y gestionar errores de manera centralizada y consistente. Entre los errores gestionados se incluyen:
StatusHistoryNotFoundException → Se lanza cuando no se encuentra un historial de estado solicitado. Se responde con un código 404 Not Found y el mensaje de error correspondiente.
NotificationNotFoundException → Se produce cuando no se encuentra una notificación solicitada. También se devuelve un 404 Not Found, encapsulando el mensaje de error en un objeto ErrorResponse.
Este enfoque garantiza respuestas claras y estructuradas para los errores más comunes del sistema.
Medidas trascendentales que se deben de tomar en cuenta al momento de desarrollar cualquier aplicación Web y más aún cuando se manejan datos personales y situaciones sensibles como reportes de emergencia. Por ello, el presente proyecto tiene varias medidas para proteger la privacidad, autenticación e integridad de los usuarios, para que puedan reportar cualquier tipo de incidente con absoluta tranquilidad.
-
Autenticación y Autorización: se implementó un sistema de autenticación basado en JSON Web Tokens (JWT),que es una cadena de texto codificada que contiene información sobre un usuario, sus permisos,entre otros. Este token se utiliza para la autenticación y autorización en aplicaciones web, así como para el intercambio seguro de datos entre diferentes sistemas. Tambien hemos usado Spring Security, el mismo que proporciona autenticación, autorización y protección para aplicaciones Java. Con esto podemos restringir el acceso a los endpoints de acuerdo al rol del usuario.
-
Encriptación de contraseñas: usamos el algoritmo BCrypt, que como algoritmo de hashing de contraseñas, evita que las mismas se almacenen en archivos de texto plano.
-
Validación de entrada: usados en AuthController.java y IncidentController.java; es decir, validaciones con @Valid, reduciendo la probabilidad de recibir datos maliciosos
-
Restricción de acceso : evidenciados en el HTTPSecurity
- Protección contra inyección SQL: usando SpringData evitamos ello.
- Manejo de excepciones globales: usando GlobalExceptionHandler, previniendo la divulgación de información sensible.
Con la asincronia logramos que el sistema no se bloquee mientras esperamos que se finalice una tarea, mientras que la creación de eventos nos permite desacoplar los procesos de lógica crítica; generando una mejor escalabilidad, rendimiento y mantenimiento del sistema.
- Uso de Eventos: usamos el patron Publisher-Suscriber, mediantes herramientas que nos da el Spring: usamos ApplicationEventPublisher en la clase IncidentService.java, lo que nos permite emitir eventos cuando se registra un nuevo incidente o se produce un cambio relevante. Estos eventos son escuchados por la clase NotificationListener.java
- Uso de Asincronía: usamos @EnableAsync y @Async, con ello evitamos que los procesos de notificación no bloqueen la respuesta al usuario.
Trabajamos con issues lo cual nos permitió:
-
Implementación de autenticación y seguridad (AuthController, SecurityConfig)
-
Manejo de evidencias (EvidenceController, EvidenceService)
-
Configuración de servicios (AsyncConfig, ModelMapperConfig)
-
Integración de servicios externos (como la geolocalización)
-
Los issues se habrían asignado a miembros del equipo según especialidad y al final se hizo un Pull Request para unificar todo.
No se usó GitHub Actions como tal pero se respetó un flujo que nos permitió:
-
Ejecutar los tests unitarios e integración del proyecto.
-
Verificar que el proyecto compilara correctamente antes de hacer merge.
-
Prevenir fallos en producción al detectar errores en etapas tempranas del desarrollo. Se uso este repositorio: https://github.com/naye-gg/WatchApp_Evidences-Assets , el cual sirve de puente para poder añadir las imágenes en la aplicación.
-
Estas prácticas aseguraron mayor estabilidad en el backend y facilitaron la colaboración distribuida del equipo.
- Nos permitió el desarrollo de un proyecto en el que aplicamos principalmente los conocimientos adquiridos en clases, logrando una solución tecnológica completa para la gestión comunitaria de emergencias en entornos urbanos.
- Implementamos una API REST que permite el registro y visualización de incidentes en tiempo real. Asimismo integramos tecnologías modernas como Spring Boot, PostgreSQL y JWT para garantizar escalabilidad, trazabilidad y seguridad.
- Desacoplamos funcionalidades mediante el uso de eventos asincrónicos, mejorando la eficiencia del sistema y la experiencia del usuario.
-Ahondamos en la comprensión e implementación de conceptos clave de arquitectura en capas, control de acceso y seguridad en APIs REST. -Mejoramos nuestro trabajo colaborativo mediante GitHub, incluyendo la gestión de ramas, issues, y flujos de integración continua. -Aplicamos buenas prácticas de diseño de software, como el uso de DTOs, validaciones, y manejo centralizado de excepciones.
Nuestro trabajo trato de cumplir todos los objetivos planteados para mejorar el bienestar de la ciudadanía en general, pero siempre hay oportunidades de mejora, como por ejemplo se podría:
- Incorporar una interfaz web para usuarios finales, que consuma la API y permita reportar y visualizar incidentes de forma intuitiva.
- Expandir el sistema de estadísticas para incluir modelos predictivos de ocurrencia de incidentes.
- Mejorar el sistema de roles para contemplar perfiles como operadores municipales o servicios de emergencia.
- Documentación oficial de Spring Boot / https://docs.spring.io/spring-boot/index.html
- Documentación oficial de Spring Security / https://spring.io/projects/spring-security
- Documentación oficial de Spring Boot Testing / https://docs.spring.io/spring-boot/reference/testing/index.html
- Mockito Framework Site / https://site.mockito.org/
- Documentación de Nominatim(API que usamos para el mapa) / https://nominatim.org/release-docs/develop/
