Requerimientos

Los siguientes son los requerimientos funcionales del sistema PetMatch. Cada requerimiento describe qué debe hacer el sistema, quién es el usuario funcional responsable y cómo se realiza la operación.

Código	Descripción	Rol	Usuario Funcional
RQ-01	El sistema debe permitir el registro de nuevos usuarios en el sistema. La persona interesada diligencia un formulario con nombre completo, correo electrónico, contraseña, número de teléfono, ubicación y tipo de usuario (adoptante o dador). El sistema valida que el correo no esté registrado previamente, cifra la contraseña y crea la cuenta. Las cuentas de dador quedan pendientes de verificación por parte del administrador.	@Diego	Adoptante, Dador
RQ-02	El sistema debe permitir el inicio de sesión de los usuarios registrados. El usuario ingresa su correo electrónico y contraseña, el sistema valida las credenciales, y si son correctas concede el acceso al sistema según el rol correspondiente.	@Diego	Adoptante, Dador, Administrador
RQ-03	El sistema debe permitir a los usuarios recuperar su contraseña cuando la olvidan. El usuario ingresa su correo electrónico en la opción de recuperación, el sistema envía un enlace o código temporal a ese correo, y con ese enlace el usuario puede establecer una nueva contraseña.	@Diego	Adoptante, Dador
RQ-04	El sistema debe permitir a los usuarios consultar y modificar la información de su perfil. El usuario ingresa a la sección de perfil, visualiza sus datos actuales y puede editar el nombre, teléfono, ubicación y foto de perfil. El sistema valida y guarda los cambios.	@Diego	Adoptante, Dador
RQ-05	El sistema debe permitir a los dadores publicar mascotas disponibles para adopción. El dador ingresa a la sección de publicaciones y diligencia un formulario con el nombre, especie, raza, edad, tamaño, sexo, temperamento, historial de salud, ubicación y una o varias fotos de la mascota. La publicación queda en estado pendiente hasta que el administrador la apruebe.	@Diego	Dador
RQ-06	El sistema debe permitir a los dadores modificar la información de sus mascotas publicadas. El dador selecciona una mascota de su listado, edita los campos que desea actualizar y el sistema guarda los cambios.	@Diego	Dador
RQ-07	El sistema debe permitir a los dadores eliminar sus publicaciones de mascotas. El dador selecciona una mascota de su listado y confirma la eliminación, tras lo cual el sistema retira la publicación del listado público.	@Diego	Dador
RQ-08	El sistema debe permitir a los adoptantes buscar mascotas utilizando una parte del nombre. El adoptante escribe el texto en el campo de búsqueda y el sistema muestra las mascotas cuyo nombre coincide con el criterio ingresado.	@Diego	Adoptante
RQ-09	El sistema debe permitir a los adoptantes filtrar las mascotas disponibles por especie, raza, edad, tamaño o temperamento. El adoptante selecciona los filtros deseados y el sistema muestra únicamente las mascotas que cumplen con los criterios elegidos.	@Diego	Adoptante
RQ-10	El sistema debe permitir a los adoptantes buscar mascotas cercanas a su ubicación. El adoptante activa la opción de búsqueda por geolocalización, el sistema obtiene su ubicación actual y muestra las mascotas ordenadas por cercanía.	@Diego	Adoptante
RQ-11	El sistema debe permitir a los adoptantes consultar el detalle completo de una mascota. El adoptante selecciona una mascota del listado y el sistema muestra toda su información, sus fotos y los datos del dador que la publicó.	@Diego	Adoptante
RQ-12	El sistema debe permitir a los dadores configurar las cuatro etapas del proceso de selección de cada mascota. El dador accede a la configuración de su publicación y, para cada etapa (formulario, revisión de documentos, entrevista y visita domiciliaria), define las preguntas o requisitos correspondientes y el puntaje máximo que otorga esa etapa.	@Diego	Dador
RQ-13	El sistema debe permitir a los adoptantes postularse a una mascota disponible. El adoptante selecciona una mascota, presiona la opción de postulación y el sistema registra la postulación con la fecha, el estado inicial y el candidato queda ubicado en la etapa uno del proceso de selección.	@Diego	Adoptante
RQ-14	El sistema debe permitir a los adoptantes responder el formulario de la etapa uno del proceso de selección. El adoptante visualiza las preguntas configuradas por el dador, ingresa sus respuestas y el sistema calcula el puntaje obtenido y lo suma al total del candidato.	@Diego	Adoptante
RQ-15	El sistema debe permitir a los adoptantes cargar los documentos de la etapa dos del proceso de selección. El adoptante sube los archivos solicitados como cédula, comprobante de residencia y carta laboral, y el sistema los almacena y los pone disponibles para la revisión del dador.	@Diego	Adoptante
RQ-16	El sistema debe permitir el intercambio de mensajes entre el dador y el adoptante mediante un chat integrado, correspondiente a la entrevista de la etapa tres del proceso de selección. Cada usuario escribe y envía mensajes, y el sistema los muestra en tiempo real, guarda el historial y notifica al destinatario cuando llega un mensaje nuevo.	@Diego	Adoptante, Dador
RQ-17	El sistema debe permitir al dador coordinar y registrar la visita domiciliaria correspondiente a la etapa cuatro del proceso de selección. El dador registra la fecha, hora y resultado de la visita, e ingresa el puntaje asignado, el cual el sistema suma al total del candidato.	@Diego	Dador
RQ-18	El sistema debe permitir al dador aprobar o rechazar el avance de un candidato a la siguiente etapa. El dador revisa las respuestas, los documentos o el resultado de la etapa correspondiente y decide si el candidato continúa o queda descartado.	@Diego	Dador
RQ-19	El sistema debe generar el ranking de candidatos de cada publicación ordenado de mayor a menor puntaje. Al concluir cada etapa, el sistema recalcula el puntaje total de los candidatos activos y actualiza sus posiciones en el ranking, el cual queda visible únicamente para el dador.	@Diego	Dador
RQ-20	El sistema debe notificar al candidato ganador al finalizar las cuatro etapas del proceso. El sistema identifica al adoptante con el mayor puntaje, envía la notificación de asignación y marca la mascota como reservada. Si el ganador se retracta o no acepta, el sistema pasa automáticamente al siguiente candidato en el ranking.	@Diego	Adoptante
RQ-21	El sistema debe permitir a los adoptantes consultar el estado de sus postulaciones. El adoptante ingresa a la sección de "Mis postulaciones" y el sistema muestra cada postulación con la mascota asociada, la etapa actual, el puntaje acumulado y el estado (activa, ganadora, descartada).	@Diego	Adoptante
RQ-22	El sistema debe permitir a los adoptantes registrar reportes periódicos de seguimiento post-adopción durante los seis meses siguientes a la adopción. El sistema envía recordatorios al adoptante, quien ingresa la fecha, fotos actualizadas, una descripción del estado de la mascota y las respuestas a un cuestionario de bienestar.	@Diego	Adoptante
RQ-23	El sistema debe permitir a los dadores consultar los reportes de seguimiento de las mascotas que dieron en adopción. El dador ingresa a la sección de "Mascotas dadas en adopción", selecciona una mascota y visualiza el historial de reportes registrados por el adoptante.	@Diego	Dador
RQ-24	El sistema debe permitir a los dadores generar una alerta de bienestar en riesgo cuando detecten señales de alarma en los reportes. El dador selecciona el reporte que le preocupa, describe la razón de la alerta y el sistema la envía al administrador para su revisión.	@Diego	Dador
RQ-25	El sistema debe permitir al administrador verificar y aprobar las cuentas de los dadores. El administrador consulta la lista de cuentas pendientes, revisa la información de cada dador y aprueba, rechaza o solicita información adicional.	@Diego	Administrador
RQ-26	El sistema debe permitir al administrador moderar las publicaciones de mascotas. El administrador revisa cada nueva publicación en estado pendiente y decide aprobarla para el listado público, editarla si contiene errores o eliminarla si incumple las políticas del sistema.	@Diego	Administrador
RQ-27	El sistema debe permitir al administrador buscar y consultar los usuarios registrados. El administrador ingresa un texto de búsqueda por parte del nombre y el sistema muestra los usuarios que coinciden, con la posibilidad de ver el detalle de cada uno.	@Diego	Administrador
RQ-28	El sistema debe permitir al administrador inhabilitar y reactivar cuentas de usuarios. El administrador selecciona un usuario y cambia su estado según sea necesario, tras lo cual el sistema restringe o restablece el acceso del usuario afectado.	@Diego	Administrador
RQ-29	El sistema debe permitir al administrador gestionar los reportes de mal uso y las alertas de bienestar en riesgo. El administrador consulta cada reporte o alerta, revisa la información asociada y decide las acciones a tomar, como advertir al usuario, inhabilitar la cuenta o marcar la mascota para que vuelva al sistema.	@Diego	Administrador
RQ-30	El sistema debe permitir al administrador consultar estadísticas generales de uso, como la cantidad total de mascotas publicadas, adopciones completadas, usuarios activos por rol, postulaciones en curso y adopciones en seguimiento post-adopción. El administrador accede al panel de estadísticas y el sistema muestra la información consolidada.	@Diego	Administrador