Skip to content

Feature/rooms filter#192

Open
asmulever wants to merge 3 commits intooscarchapp:mainfrom
asmulever:feature/rooms-filter
Open

Feature/rooms filter#192
asmulever wants to merge 3 commits intooscarchapp:mainfrom
asmulever:feature/rooms-filter

Conversation

@asmulever
Copy link

Resumen

Este PR mejora la vista de Habitaciones incorporando un filtro por nombre que permite ubicar rápidamente habitaciones por coincidencia parcial, con una experiencia más clara para operación diaria.

Qué cambia

  • Se agrega filtro por nombre en la pantalla de habitaciones.
  • Se mejora la presentación de controles de búsqueda para una interacción más intuitiva.
  • Se incorpora feedback explícito de resultados:
    • total de habitaciones cuando no hay filtro,
    • cantidad de coincidencias cuando hay búsqueda,
    • estado vacío cuando no hay resultados.
  • Se preserva el flujo existente de navegación y detalle de habitación.

Valor funcional

  • Reduce tiempo de búsqueda en operación.
  • Mejora la trazabilidad visual de resultados.
  • Disminuye fricción para recepcionistas y usuarios administrativos.

Archivos relevantes

  • pms/views.py
  • pms/templates/rooms.html
  • pms/statics/css/style.css
  • pms/tests.py
  • docs/pr-1-rooms-filter.md

Validación / pruebas

  • Pruebas unitarias y de integración de la vista de habitaciones cubriendo:
    • listado completo sin filtro,
    • filtro por coincidencia parcial,
    • respuesta sin coincidencias.
  • Resultado esperado: comportamiento consistente sin impacto en módulos no relacionados.

Información para Deploy

  • No requiere migraciones de base de datos.
  • No agrega variables de entorno nuevas.
  • No introduce dependencias externas.
  • Riesgo bajo de despliegue (cambio acotado a vista/template/estilos/tests).

Documentación

Existe documentación detallada para PM/Arquitectura y Deploy en:

  • docs/pr-1-rooms-filter.md

…rtura de pruebas

Contexto de negocio:

- Se implementa el requerimiento PR 1 del challenge: filtrar la seccion Habitaciones por coincidencia parcial del campo name.

Alcance funcional entregado:

- Se agrega RoomFilterForm para encapsular validacion y mantener la vista desacoplada de la capa de presentacion.

- RoomsView incorpora lectura de query params y filtro name__icontains, preservando el listado completo cuando no hay criterio.

- Se agrega metadata de resultados para mejorar feedback al usuario (conteo total y conteo filtrado).

Mejoras de interfaz (orientadas a usabilidad):

- Nueva cabecera visual en Habitaciones con mensaje de accion claro.

- Barra de busqueda prominente con icono, CTA principal y accion de limpiar filtro.

- Grid responsivo de tarjetas para lectura rapida en desktop y mobile.

- Estado vacio explicito para evitar ambiguedad cuando no hay coincidencias.

Calidad y verificacion:

- Se incorporan tests automatizados de vista para: sin filtro, filtro parcial y sin resultados.

- Validado con python manage.py test pms.tests.RoomsFilterTests.
- Agrega label explicativo para el campo de búsqueda

- Ordena y jerarquiza el panel de controles para una lectura más clara

- Introduce chip visual para el resumen de resultados

- Mantiene intacta la lógica funcional del filtro
- Describe objetivo, alcance y decisiones funcionales

- Enumera archivos modificados y pruebas ejecutadas

- Resume impacto esperado en operación y UX
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant