|
Download audit/REFACTOR_LOG.md from Modulo-6/api: direct link, hf CLI and curl.
- Browser
- Download file 10.3 kB
-
https://huggingface.co/spaces/Modulo-6/api/resolve/e886cf091805ea2214cfe91b29d4df9bc2f15a44/audit/REFACTOR_LOG.md
- Command line
-
hf download hf://spaces/Modulo-6/api@e886cf091805ea2214cfe91b29d4df9bc2f15a44/audit/REFACTOR_LOG.md
-
curl -L -o REFACTOR_LOG.md https://huggingface.co/spaces/Modulo-6/api/resolve/e886cf091805ea2214cfe91b29d4df9bc2f15a44/audit/REFACTOR_LOG.md
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"). | |