api / audit /REFACTOR_LOG.md
Mate11
Pirmer commit
5f12c93
|
Raw History Blame Contribute Delete
10.3 kB

Log de Refactorización — Módulo 6

Fecha: 2026-05-03 | Phase 2 — Reorganización estructural


Resumen de cambios

Tipo Cantidad
Archivos creados (nuevos) 31
Archivos modificados 2
Archivos preservados (sin tocar) Todos los de backend/
Archivos eliminados 0

Archivos creados

Núcleo de la aplicación

Archivo creado Origen Razón
app/__init__.py Nuevo Marca app/ como paquete Python
app/main.py backend/main.py Reubicación + mejoras: logging estructurado, CORS con orígenes explícitos, guard de entorno en /auth/token
app/config.py backend/config.py Reubicación + mejoras: SettingsConfigDict (pydantic v2), campos obligatorios sin default, environment, allowed_origins, http_timeout_seconds
app/dependencies.py backend/database.py + backend/auth/jwt_handler.py + backend/auth/dependencies.py Fusión de 3 módulos en dependencias compartidas; agrega db.rollback() ante excepciones, logging en decode_token

Modelos ORM

Archivo creado Origen Razón
app/models/__init__.py backend/models/__init__.py Reubicación con re-exports explícitos
app/models/cama.py backend/models/cama.py Reubicación; actualiza import de Base a app.dependencies
app/models/solicitud.py backend/models/solicitud.py Reubicación; actualiza import de Base
app/models/reserva.py backend/models/reserva.py Reubicación; actualiza import de Base

Schemas Pydantic

Archivo creado Origen Razón
app/schemas/__init__.py Nuevo Marca directorio como paquete
app/schemas/enums.py backend/schemas/enums.py Reubicación sin cambios funcionales
app/schemas/cama.py backend/schemas/cama.py Mejoras: AsignacionCamaRequest.tipo → Literal["INGRESO","TRASLADO"], field_validator en campos de texto, CamaResponse usa enums en lugar de str, agrega DisponibilidadQuirofanosResponse
app/schemas/solicitud.py backend/schemas/solicitud.py Reubicación; actualiza imports al nuevo path
app/schemas/reserva.py backend/schemas/reserva.py Mejoras: model_validator verifica fecha_inicio < fecha_fin en ReservaQuirofanoCreateRequest y CirugiaUrgenteWebhook

Capa de integración (nueva — extraída de external_client.py)

Archivo creado Origen Razón
app/integrations/__init__.py Nuevo Marca directorio como paquete
app/integrations/_base.py backend/services/external_client.py (helpers _post, _get) Centraliza helpers HTTP; agrega logging de warnings en excepciones (elimina swallow silencioso); timeout configurable via settings.http_timeout_seconds
app/integrations/core.py backend/services/external_client.py (función validate_patient) Aísla M10 en módulo dedicado; imports datetime movidos a nivel de módulo
app/integrations/hce.py backend/services/external_client.py (funciones get_patient_contraindicaciones, notify_movimiento) Aísla M1; imports datetime movidos a nivel de módulo; función renombrada a get_contraindicaciones
app/integrations/monitoreo.py backend/services/external_client.py (funciones notify_alta_monitoreo, notify_baja_monitoreo) Aísla M9; funciones renombradas a notify_alta/notify_baja; imports datetime movidos
app/integrations/facturacion.py backend/services/external_client.py (función notify_cama_lista) Aísla M7
app/integrations/turnos.py backend/services/external_client.py (función notify_resultado_quirofano) Aísla M2

Capa CRUD/Repository (nueva — extraída de services)

Archivo creado Origen Razón
app/crud/__init__.py Nuevo Marca directorio como paquete
app/crud/cama.py backend/services/cama_service.py (operaciones ORM) Extrae acceso a BD de la capa de negocio; centraliza db.query, db.add, db.commit, db.refresh; elimina duplicación con solicitud_service
app/crud/solicitud.py backend/services/solicitud_service.py (operaciones ORM) Ídem para solicitudes
app/crud/reserva.py backend/services/cama_service.py y solicitud_service.py (operaciones ORM de reservas) Consolida operaciones de ReservaQuirofano en un solo lugar; elimina import lazy circular

Servicios (refactorizados)

Archivo creado Origen Razón
app/services/__init__.py Nuevo Marca directorio como paquete
app/services/cama_service.py backend/services/cama_service.py Elimina acceso ORM directo → usa crud.cama y crud.reserva; elimina imports and_, or_ no usados; extrae función _verificar_contraindicaciones (elimina duplicación); usa enums en lugar de strings; reemplaza external_client.* con módulos de integración específicos
app/services/solicitud_service.py backend/services/solicitud_service.py Ídem; cancelar_reserva_por_turno ahora usa crud.reserva (elimina import lazy circular); extrae _verificar_contraindicaciones común

Routers (mejorados)

Archivo creado Origen Razón
app/routers/__init__.py Nuevo Marca directorio como paquete
app/routers/camas.py backend/routers/camas.py POST /reservas corregido a require_roles("MEDICO","ADMINISTRATIVO") (bug de autorización); parámetros de fecha tipados como datetime (validación automática); import JSONResponse movido al nivel de módulo; query param estado tipado con EstadoCamaEnum; todos los endpoints tienen responses={4xx:...} en OpenAPI
app/routers/solicitudes.py backend/routers/solicitudes.py Query params estado y tipo tipados con enums para validación automática; errores documentados en OpenAPI
app/routers/webhooks.py backend/routers/webhooks.py Ruta de cancelación de quirófano unificada bajo prefijo /webhooks/; errores documentados; variable is_new muerta eliminada

Tests

Archivo creado Origen Razón
tests/__init__.py Nuevo Marca directorio como paquete
tests/conftest.py Nuevo Fixtures de BD en memoria (SQLite) y TestClient para testing sin PostgreSQL real
tests/test_camas.py Nuevo Estructura base de tests para router de camas
tests/test_solicitudes.py Nuevo Estructura base de tests para solicitudes y webhooks

Infraestructura y documentación

Archivo Tipo Razón
Dockerfile Creado (raíz) Nuevo Dockerfile a nivel raíz; apunta a app.main:app; sin --reload
docker-compose.yml Modificado Elimina campo version: deprecado; build context actualizado a . (raíz); puerto 5432 sin exponer al host; volumen de bind mount actualizado
requirements.txt Creado (raíz) Copia del original con python-multipart comentada (no usada) y notas sobre separación dev/prod
.env.example Creado Template completo con todas las variables; instrucciones de generación de JWT secret; ningún valor real
README.md Modificado Documentación completa: propósito, endpoints, mapa de integraciones, variables de entorno, estructura del proyecto, cómo correr tests

Bugs corregidos durante la refactorización

Bug Archivo original Solución
POST /camas/{id}/reservas usaba get_current_user sin verificar rol — cualquier usuario autenticado podía crear reservas de quirófano backend/routers/camas.py:167 Cambiado a require_roles("MEDICO", "ADMINISTRATIVO") en app/routers/camas.py
Variable is_new = reserva_desplazada is not None or True siempre verdadera, nunca usada backend/routers/webhooks.py:78 Eliminada — la lógica de mensaje se calcula directamente desde reserva_desplazada
Parámetros fecha_desde/fecha_hasta de GET /reservas como str — fechas inválidas generaban 500 backend/routers/camas.py:150-151 Tipados como Optional[datetime] en el router nuevo
Imports datetime dentro de funciones en external_client.py backend/services/external_client.py:72,90,103,125 Movidos a nivel de módulo en cada integrations/*.py
_get_cama_or_404 duplicada en cama_service y solicitud_service Ambos servicios Consolidada en crud/cama.py y usada desde ambos servicios
cancelar_reserva_por_turno en solicitud_service accedía a ReservaQuirofano con import lazy (señal de responsabilidad incorrecta) backend/services/solicitud_service.py:325 Usa crud.reserva.get_by_turno() — sin import lazy
Verificación de contraindicaciones copiada 3 veces cama_service, solicitud_service (×2) Extraída a _verificar_contraindicaciones() en cada servicio

Decisiones de diseño

  1. backend/ preservado: el directorio original no fue eliminado — solo se creó la nueva estructura app/. Para producción, usar el nuevo Dockerfile raíz que solo incluye app/.

  2. dependencies.py unificado: se fusionaron database.py, auth/jwt_handler.py y auth/dependencies.py en un único archivo de dependencias compartidas. Esto elimina el subdirectorio auth/ (cuyo único propósito era autenticación) y centraliza toda la infraestructura transversal.

  3. integrations/ separado por módulo: en lugar de un único external_client.py monolítico, cada módulo externo (M1, M2, M7, M9, M10) tiene su propio archivo. Esto permite: a) mocking independiente por módulo en tests, b) refactoring aislado de cada integración.

  4. Capa crud/ sin HTTPException: los archivos de crud/ no lanzan HTTPException — solo hacen operaciones de BD y devuelven None cuando no encuentran registros. Los servicios son los responsables de interpretar None como 404.

  5. Migraciones no incluidas: el proyecto sigue usando Base.metadata.create_all() en startup. La adopción de Alembic queda pendiente (ver DEPENDENCY_AUDIT.md sección "Dependencias faltantes").