Mate11 commited on
Commit
5f12c93
·
1 Parent(s): 9454265

Pirmer commit

Browse files
This view is limited to 50 files because it contains too many changes.   See raw diff
Files changed (50) hide show
  1. .claude/settings.local.json +9 -0
  2. .env.example +37 -0
  3. .github/workflows/cd.yml +112 -0
  4. .github/workflows/ci.yml +55 -0
  5. Dockerfile +15 -0
  6. README.md +198 -0
  7. app/__init__.py +0 -0
  8. app/config.py +39 -0
  9. app/crud/__init__.py +0 -0
  10. app/crud/cama.py +82 -0
  11. app/crud/reserva.py +125 -0
  12. app/crud/solicitud.py +66 -0
  13. app/dependencies.py +102 -0
  14. app/integrations/__init__.py +0 -0
  15. app/integrations/_base.py +35 -0
  16. app/integrations/core.py +12 -0
  17. app/integrations/facturacion.py +27 -0
  18. app/integrations/hce.py +42 -0
  19. app/integrations/monitoreo.py +32 -0
  20. app/integrations/turnos.py +29 -0
  21. app/main.py +111 -0
  22. app/models/__init__.py +5 -0
  23. app/models/cama.py +42 -0
  24. app/models/reserva.py +46 -0
  25. app/models/solicitud.py +61 -0
  26. app/routers/__init__.py +0 -0
  27. app/routers/camas.py +256 -0
  28. app/routers/solicitudes.py +76 -0
  29. app/routers/webhooks.py +170 -0
  30. app/schemas/__init__.py +0 -0
  31. app/schemas/cama.py +74 -0
  32. app/schemas/enums.py +89 -0
  33. app/schemas/reserva.py +97 -0
  34. app/schemas/solicitud.py +101 -0
  35. app/services/__init__.py +0 -0
  36. app/services/cama_service.py +391 -0
  37. app/services/solicitud_service.py +281 -0
  38. audit/ARCHITECTURE_REVIEW.md +225 -0
  39. audit/AUDIT_REPORT.md +146 -0
  40. audit/CODE_QUALITY.md +247 -0
  41. audit/DEPENDENCY_AUDIT.md +156 -0
  42. audit/REFACTOR_LOG.md +131 -0
  43. audit/SECURITY_AUDIT.md +396 -0
  44. audit/STRUCTURE.md +275 -0
  45. backend/Dockerfile +12 -0
  46. backend/auth/__init__.py +0 -0
  47. backend/auth/dependencies.py +35 -0
  48. backend/auth/jwt_handler.py +35 -0
  49. backend/config.py +28 -0
  50. backend/database.py +24 -0
.claude/settings.local.json ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "permissions": {
3
+ "allow": [
4
+ "Bash(Get-ChildItem -Recurse \"C:\\\\Users\\\\mateo\\\\OneDrive\\\\Documentos\\\\modulo6\" -Name)",
5
+ "Bash(Get-ChildItem -Path \"c:\\\\Users\\\\mateo\\\\OneDrive\\\\Documentos\\\\Modulo-6-backend\" -Force)",
6
+ "Bash(Select-Object Name, Mode)"
7
+ ]
8
+ }
9
+ }
.env.example ADDED
@@ -0,0 +1,37 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # ─── Base de datos ─────────────────────────────────────────────────────────
2
+ # Formato: postgresql://USUARIO:CONTRASEÑA@HOST:PUERTO/NOMBRE_BD
3
+ DATABASE_URL=postgresql://admin:CAMBIAR_CONTRASENA@db:5432/internacion_db
4
+
5
+ # Variables de PostgreSQL (usadas por el servicio 'db' en docker-compose)
6
+ POSTGRES_DB=internacion_db
7
+ POSTGRES_USER=admin
8
+ POSTGRES_PASSWORD=CAMBIAR_CONTRASENA
9
+
10
+ # ─── JWT ───────────────────────────────────────────────────────────────────
11
+ # Generar con: python -c "import secrets; print(secrets.token_hex(32))"
12
+ JWT_SECRET=CAMBIAR_POR_SECRET_ALEATORIO_DE_64_CARACTERES
13
+ JWT_ALGORITHM=HS256
14
+ JWT_EXPIRE_MINUTES=60
15
+
16
+ # ─── Entorno ───────────────────────────────────────────────────────────────
17
+ # Valores válidos: development | staging | production
18
+ # En 'production', el endpoint /auth/token queda deshabilitado
19
+ ENVIRONMENT=development
20
+
21
+ # ─── CORS ──────────────────────────────────────────────────────────────────
22
+ # Lista JSON de orígenes permitidos (nunca usar "*" con allow_credentials=true)
23
+ ALLOWED_ORIGINS=["http://localhost:3000","http://localhost:5173"]
24
+
25
+ # ─── Integraciones externas ────────────────────────────────────────────────
26
+ # Si true, las llamadas a M1/M2/M7/M9/M10 son mockeadas (útil para dev local)
27
+ MOCK_EXTERNAL_SERVICES=true
28
+
29
+ # HTTP timeout en segundos para llamadas a módulos externos
30
+ HTTP_TIMEOUT_SECONDS=5.0
31
+
32
+ # URLs de los módulos del sistema (ajustar para cada entorno)
33
+ M1_HCE_URL=http://modulo1:8001
34
+ M2_TURNOS_URL=http://modulo2:8002
35
+ M7_FACTURACION_URL=http://modulo7:8007
36
+ M9_MONITOREO_URL=http://modulo9:8009
37
+ M10_CORE_URL=http://modulo10:8010
.github/workflows/cd.yml ADDED
@@ -0,0 +1,112 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: CD
2
+
3
+ on:
4
+ push:
5
+ branches: [main]
6
+
7
+ env:
8
+ REGISTRY: ghcr.io
9
+ IMAGE_NAME: ${{ github.repository }}
10
+
11
+ jobs:
12
+ # ── 1. Tests deben pasar antes de buildear ──────────────────────────────
13
+ test:
14
+ name: Tests (gate)
15
+ runs-on: ubuntu-latest
16
+ env:
17
+ DATABASE_URL: sqlite:///./test.db
18
+ JWT_SECRET: ci-test-secret-key-not-used-in-production-32chars
19
+ ENVIRONMENT: development
20
+ MOCK_EXTERNAL_SERVICES: "true"
21
+ steps:
22
+ - uses: actions/checkout@v4
23
+ - uses: actions/setup-python@v5
24
+ with:
25
+ python-version: "3.12"
26
+ cache: pip
27
+ - run: pip install -r requirements-dev.txt
28
+ - run: pytest tests/ -v
29
+
30
+ # ── 2. Build y push de la imagen Docker a ghcr.io ──────────────────────
31
+ build-and-push:
32
+ name: Build & Push Docker
33
+ needs: test
34
+ runs-on: ubuntu-latest
35
+ permissions:
36
+ contents: read
37
+ packages: write
38
+ outputs:
39
+ image-tag: ${{ steps.meta.outputs.tags }}
40
+ image-digest: ${{ steps.build.outputs.digest }}
41
+
42
+ steps:
43
+ - uses: actions/checkout@v4
44
+
45
+ - name: Log in to GitHub Container Registry
46
+ uses: docker/login-action@v3
47
+ with:
48
+ registry: ${{ env.REGISTRY }}
49
+ username: ${{ github.actor }}
50
+ password: ${{ secrets.GITHUB_TOKEN }}
51
+
52
+ - name: Extract Docker metadata
53
+ id: meta
54
+ uses: docker/metadata-action@v5
55
+ with:
56
+ images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
57
+ tags: |
58
+ type=sha,prefix=sha-
59
+ type=raw,value=latest,enable=true
60
+
61
+ - name: Build and push image
62
+ id: build
63
+ uses: docker/build-push-action@v6
64
+ with:
65
+ context: .
66
+ push: true
67
+ tags: ${{ steps.meta.outputs.tags }}
68
+ labels: ${{ steps.meta.outputs.labels }}
69
+ cache-from: type=gha
70
+ cache-to: type=gha,mode=max
71
+
72
+ # ── 3. Deploy al servidor de producción (requiere secrets configurados) ─
73
+ #
74
+ # Para activar este job:
75
+ # 1. Ir a GitHub → Settings → Variables → New repository variable
76
+ # DEPLOY_ENABLED = true
77
+ # 2. Agregar los siguientes Secrets (Settings → Secrets):
78
+ # DEPLOY_HOST — IP o dominio del servidor
79
+ # DEPLOY_USER — usuario SSH (ej: ubuntu, deploy)
80
+ # DEPLOY_KEY — clave privada SSH (contenido del archivo .pem / id_rsa)
81
+ # 3. En el servidor tener docker + docker compose y el archivo .env en
82
+ # /opt/m6-backend/.env con las variables de producción
83
+ deploy:
84
+ name: Deploy to Production
85
+ needs: build-and-push
86
+ runs-on: ubuntu-latest
87
+ environment: production
88
+ if: ${{ vars.DEPLOY_ENABLED == 'true' }}
89
+
90
+ steps:
91
+ - name: Deploy via SSH
92
+ uses: appleboy/ssh-action@v1.2.0
93
+ with:
94
+ host: ${{ secrets.DEPLOY_HOST }}
95
+ username: ${{ secrets.DEPLOY_USER }}
96
+ key: ${{ secrets.DEPLOY_KEY }}
97
+ script: |
98
+ set -e
99
+ cd /opt/m6-backend
100
+
101
+ # Autenticar en ghcr.io dentro del servidor
102
+ echo "${{ secrets.GITHUB_TOKEN }}" | docker login ghcr.io \
103
+ -u ${{ github.actor }} --password-stdin
104
+
105
+ # Bajar imagen nueva y levantar sin downtime
106
+ docker compose pull backend
107
+ docker compose up -d --no-build --remove-orphans
108
+
109
+ # Limpiar imágenes viejas
110
+ docker image prune -f
111
+
112
+ echo "Deploy completado: $(date)"
.github/workflows/ci.yml ADDED
@@ -0,0 +1,55 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: CI
2
+
3
+ on:
4
+ push:
5
+ branches: [main, develop]
6
+ pull_request:
7
+ branches: [main, develop]
8
+
9
+ jobs:
10
+ lint:
11
+ name: Lint (ruff)
12
+ runs-on: ubuntu-latest
13
+ steps:
14
+ - uses: actions/checkout@v4
15
+
16
+ - uses: actions/setup-python@v5
17
+ with:
18
+ python-version: "3.12"
19
+
20
+ - name: Install ruff
21
+ run: pip install ruff==0.6.9
22
+
23
+ - name: Check code style
24
+ run: ruff check app/ tests/
25
+
26
+ test:
27
+ name: Tests (pytest)
28
+ runs-on: ubuntu-latest
29
+ env:
30
+ DATABASE_URL: sqlite:///./test.db
31
+ JWT_SECRET: ci-test-secret-key-not-used-in-production-32chars
32
+ ENVIRONMENT: development
33
+ MOCK_EXTERNAL_SERVICES: "true"
34
+
35
+ steps:
36
+ - uses: actions/checkout@v4
37
+
38
+ - uses: actions/setup-python@v5
39
+ with:
40
+ python-version: "3.12"
41
+ cache: pip
42
+
43
+ - name: Install dependencies
44
+ run: pip install -r requirements-dev.txt
45
+
46
+ - name: Run tests with coverage
47
+ run: pytest tests/ -v --cov=app --cov-report=term-missing --cov-report=xml
48
+
49
+ - name: Upload coverage report
50
+ uses: actions/upload-artifact@v4
51
+ if: always()
52
+ with:
53
+ name: coverage-report
54
+ path: coverage.xml
55
+ retention-days: 7
Dockerfile ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ FROM python:3.12-slim
2
+
3
+ WORKDIR /app
4
+
5
+ # Instalar dependencias primero (aprovecha cache de Docker layers)
6
+ COPY requirements.txt .
7
+ RUN pip install --no-cache-dir -r requirements.txt
8
+
9
+ # Copiar el código fuente
10
+ COPY app/ ./app/
11
+
12
+ EXPOSE 8006
13
+
14
+ # Sin --reload en producción
15
+ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8006"]
README.md ADDED
@@ -0,0 +1,198 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Health Grid – Módulo 6: Internación y Gestión de Camas
2
+
3
+ **TPO UADE – Sistema de Gestión Hospitalaria**
4
+ Módulo 6 del sistema multi-módulo Health Grid. Gestiona camas hospitalarias, solicitudes de internación/traslado y reservas de quirófano.
5
+
6
+ ---
7
+
8
+ ## Levantar el proyecto
9
+
10
+ ```bash
11
+ # 1. Copiar variables de entorno y editarlas
12
+ cp .env.example .env
13
+ # Editar .env: JWT_SECRET, POSTGRES_PASSWORD (OBLIGATORIO antes de producción)
14
+
15
+ # 2. Levantar con Docker Compose
16
+ docker compose up --build
17
+ ```
18
+
19
+ El backend queda disponible en `http://localhost:8006/api/v1`.
20
+
21
+ Para desarrollo con hot-reload:
22
+ ```bash
23
+ cd modulo6
24
+ pip install -r requirements.txt
25
+ uvicorn app.main:app --host 0.0.0.0 --port 8006 --reload
26
+ ```
27
+
28
+ ---
29
+
30
+ ## Documentación interactiva
31
+
32
+ | URL | Descripción |
33
+ |-----|-------------|
34
+ | http://localhost:8006/api/v1/docs | Swagger UI (interactivo) |
35
+ | http://localhost:8006/api/v1/redoc | ReDoc (legible) |
36
+ | http://localhost:8006/health | Health check |
37
+
38
+ ---
39
+
40
+ ## Autenticación
41
+
42
+ El módulo usa JWT (HS256). Para desarrollo, expone un generador de tokens cuando `ENVIRONMENT=development`:
43
+
44
+ ```bash
45
+ curl "http://localhost:8006/api/v1/auth/token?usuario=ADMINISTRATIVO&password=any"
46
+ ```
47
+
48
+ En producción (`ENVIRONMENT=production`), este endpoint devuelve 404. Los tokens de producción deben provenir de M10 (Core).
49
+
50
+ Roles válidos: `ADMINISTRATIVO`, `MEDICO`, `LIMPIEZA`.
51
+
52
+ Usar el token en requests:
53
+ ```
54
+ Authorization: Bearer <token>
55
+ ```
56
+
57
+ ---
58
+
59
+ ## Variables de entorno requeridas
60
+
61
+ Copiar `.env.example` a `.env` y completar:
62
+
63
+ | Variable | Requerida | Descripción |
64
+ |----------|-----------|-------------|
65
+ | `DATABASE_URL` | **SÍ** | Cadena de conexión PostgreSQL |
66
+ | `POSTGRES_DB` | **SÍ** | Nombre de la base de datos |
67
+ | `POSTGRES_USER` | **SÍ** | Usuario de PostgreSQL |
68
+ | `POSTGRES_PASSWORD` | **SÍ** | Contraseña de PostgreSQL |
69
+ | `JWT_SECRET` | **SÍ** | Secret de 64+ chars para firmar JWT. Generar con `python -c "import secrets; print(secrets.token_hex(32))"` |
70
+ | `ENVIRONMENT` | No | `development` o `production` (default: `production`) |
71
+ | `ALLOWED_ORIGINS` | No | Lista JSON de orígenes CORS permitidos |
72
+ | `MOCK_EXTERNAL_SERVICES` | No | `true` = no llama a módulos externos (default: `true`) |
73
+ | `HTTP_TIMEOUT_SECONDS` | No | Timeout para llamadas externas en segundos (default: `5.0`) |
74
+ | `M1_HCE_URL` | No | URL del Módulo 1 - HCE |
75
+ | `M2_TURNOS_URL` | No | URL del Módulo 2 - Turnos |
76
+ | `M7_FACTURACION_URL` | No | URL del Módulo 7 - Facturación |
77
+ | `M9_MONITOREO_URL` | No | URL del Módulo 9 - Monitoreo |
78
+ | `M10_CORE_URL` | No | URL del Módulo 10 - Core |
79
+
80
+ ---
81
+
82
+ ## Endpoints propios
83
+
84
+ ### Camas
85
+
86
+ | Método | Endpoint | Roles | Descripción |
87
+ |--------|----------|-------|-------------|
88
+ | `GET` | `/api/v1/camas` | MEDICO, ADMIN, LIMPIEZA | Mapa de camas con estadísticas |
89
+ | `POST` | `/api/v1/camas` | ADMIN | Crear nueva cama |
90
+ | `GET` | `/api/v1/camas/disponibilidad` | MEDICO, ADMIN | Disponibilidad de quirófanos en rango horario |
91
+ | `GET` | `/api/v1/camas/{id}` | MEDICO, ADMIN | Detalle de una cama |
92
+ | `PATCH` | `/api/v1/camas/{id}` | ADMIN, LIMPIEZA | Actualizar estado/contraindicaciones |
93
+ | `DELETE` | `/api/v1/camas/{id}` | ADMIN | Baja permanente (soft delete) |
94
+ | `POST` | `/api/v1/camas/{id}/asignar` | ADMIN | Asignación/traslado directo |
95
+ | `GET` | `/api/v1/camas/{id}/reservas` | MEDICO, ADMIN | Reservas de un quirófano |
96
+ | `POST` | `/api/v1/camas/{id}/reservas` | MEDICO, ADMIN | Crear reserva programada |
97
+ | `GET` | `/api/v1/camas/{id}/reservas/{rid}` | MEDICO, ADMIN | Detalle de reserva |
98
+ | `PATCH` | `/api/v1/camas/{id}/reservas/{rid}` | ADMIN | Actualizar estado de reserva |
99
+
100
+ ### Solicitudes de Internación
101
+
102
+ | Método | Endpoint | Roles | Descripción |
103
+ |--------|----------|-------|-------------|
104
+ | `GET` | `/api/v1/solicitudes` | MEDICO, ADMIN | Listar solicitudes (default: PENDIENTE) |
105
+ | `GET` | `/api/v1/solicitudes/{id}` | MEDICO, ADMIN | Detalle (ID formato `SOL-XXXXX`) |
106
+ | `PATCH` | `/api/v1/solicitudes/{id}` | ADMIN | Aprobar / rechazar solicitud |
107
+
108
+ ### Webhooks entrantes
109
+
110
+ | Método | Endpoint | Emisor | Descripción |
111
+ |--------|----------|--------|-------------|
112
+ | `POST` | `/api/v1/webhooks/hce/solicitud` | M1 HCE | Recibir solicitud de internación o traslado |
113
+ | `POST` | `/api/v1/webhooks/hce/alta-medica` | M1 HCE | Recibir alta médica del paciente |
114
+ | `POST` | `/api/v1/webhooks/hce/cirugia-urgente` | M1 HCE | Solicitud de cirugía urgente (desplaza reservas) |
115
+ | `POST` | `/api/v1/webhooks/turnos/{id}/cancelacion-quirofano` | M2 Turnos | Cancelar reserva de quirófano |
116
+ | `POST` | `/api/v1/webhooks/monitoreo/alerta-emergencia` | M9 Monitoreo | Poner cama en CODIGO_ROJO |
117
+ | `POST` | `/api/v1/webhooks/monitoreo/alerta-resuelta` | M9 Monitoreo | Resolver CODIGO_ROJO → OCUPADA |
118
+
119
+ ---
120
+
121
+ ## Mapa de integraciones
122
+
123
+ ```
124
+ Módulo 6 (Internación)
125
+ │
126
+ ├── [WEBHOOKS INBOUND]
127
+ │ ├── ← M1 HCE POST /webhooks/hce/*
128
+ │ ├── ← M2 Turnos POST /webhooks/turnos/*
129
+ │ └── ← M9 Monitoreo POST /webhooks/monitoreo/*
130
+ │
131
+ └── [HTTP OUTBOUND — app/integrations/]
132
+ ├── → M10 Core :8010 validar paciente
133
+ ├── → M1 HCE :8001 contraindicaciones + movimientos
134
+ ├── → M9 Monitoreo :8009 alta/baja monitoreo
135
+ ├── → M7 Facturación :8007 cama lista (post limpieza)
136
+ └── → M2 Turnos :8002 resultado de quirófano
137
+ ```
138
+
139
+ Para deshabilitar las llamadas salientes durante desarrollo: `MOCK_EXTERNAL_SERVICES=true`
140
+
141
+ ---
142
+
143
+ ## Estructura del proyecto
144
+
145
+ ```
146
+ modulo6/
147
+ ├── app/ # Código fuente principal
148
+ │ ├── main.py # App factory, routers, CORS, startup
149
+ │ ├── config.py # Settings con pydantic-settings (lee .env)
150
+ │ ├── dependencies.py # BD, JWT y auth (get_db, require_roles)
151
+ │ ├── routers/ # Endpoints HTTP (solo input/output)
152
+ │ │ ├── camas.py
153
+ │ │ ├── solicitudes.py
154
+ │ │ └── webhooks.py
155
+ │ ├── services/ # Lógica de negocio
156
+ │ │ ├── cama_service.py
157
+ │ │ └── solicitud_service.py
158
+ │ ├── schemas/ # Modelos Pydantic (request/response)
159
+ │ │ ├── enums.py
160
+ │ │ ├── cama.py
161
+ │ │ ├── solicitud.py
162
+ │ │ └── reserva.py
163
+ │ ├── models/ # Modelos ORM SQLAlchemy
164
+ │ │ ├── cama.py
165
+ │ │ ├── solicitud.py
166
+ │ │ └── reserva.py
167
+ │ ├── crud/ # Acceso a datos (sin lógica de negocio)
168
+ │ │ ├── cama.py
169
+ │ │ ├── solicitud.py
170
+ │ │ └── reserva.py
171
+ │ └── integrations/ # Clientes HTTP para módulos externos
172
+ │ ├── _base.py # Helpers compartidos (timeout, headers)
173
+ │ ├── core.py # M10 - validación de pacientes
174
+ │ ├── hce.py # M1 - HCE (contraindicaciones, movimientos)
175
+ │ ├── turnos.py # M2 - resultado de quirófano
176
+ │ ├── facturacion.py # M7 - cama lista
177
+ │ └── monitoreo.py # M9 - alta/baja monitoreo
178
+ ├── tests/ # Tests (espejo de app/)
179
+ │ ├── conftest.py # Fixtures: DB en memoria, cliente de test
180
+ │ ├── test_camas.py
181
+ │ └── test_solicitudes.py
182
+ ├── backend/ # Código original (preservado)
183
+ ├── audit/ # Reportes de auditoría técnica
184
+ ├── Dockerfile # Imagen de producción (sin --reload)
185
+ ├── docker-compose.yml # Orquestación: backend + PostgreSQL
186
+ ├── requirements.txt # Dependencias de producción
187
+ ├── .env.example # Template de variables de entorno
188
+ └── README.md # Este archivo
189
+ ```
190
+
191
+ ---
192
+
193
+ ## Correr tests
194
+
195
+ ```bash
196
+ pip install pytest pytest-asyncio
197
+ pytest tests/ -v
198
+ ```
app/__init__.py ADDED
File without changes
app/config.py ADDED
@@ -0,0 +1,39 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from pydantic_settings import BaseSettings, SettingsConfigDict
2
+
3
+
4
+ class Settings(BaseSettings):
5
+ model_config = SettingsConfigDict(
6
+ env_file=".env",
7
+ case_sensitive=False,
8
+ extra="ignore",
9
+ )
10
+
11
+ # Base de datos — sin default para forzar configuración explícita en producción
12
+ database_url: str
13
+
14
+ # JWT — sin default para evitar secretos hardcodeados en código fuente
15
+ jwt_secret: str
16
+ jwt_algorithm: str = "HS256"
17
+ jwt_expire_minutes: int = 60
18
+
19
+ # Entorno — controla comportamiento de endpoints de desarrollo
20
+ environment: str = "production"
21
+
22
+ # CORS — lista explícita de orígenes permitidos
23
+ allowed_origins: list[str] = ["http://localhost:3000", "http://localhost:5173"]
24
+
25
+ # Timeout HTTP para llamadas a módulos externos (segundos)
26
+ http_timeout_seconds: float = 5.0
27
+
28
+ # URLs de módulos externos
29
+ m1_hce_url: str = "http://localhost:8001"
30
+ m2_turnos_url: str = "http://localhost:8002"
31
+ m7_facturacion_url: str = "http://localhost:8007"
32
+ m9_monitoreo_url: str = "http://localhost:8009"
33
+ m10_core_url: str = "http://localhost:8010"
34
+
35
+ # Si True, no llama a módulos externos (útil para desarrollo local sin stack completo)
36
+ mock_external_services: bool = True
37
+
38
+
39
+ settings = Settings()
app/crud/__init__.py ADDED
File without changes
app/crud/cama.py ADDED
@@ -0,0 +1,82 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Operaciones de acceso a datos para Cama. Sin lógica de negocio ni HTTPException.
3
+ """
4
+ from __future__ import annotations
5
+ from datetime import datetime, timezone
6
+ from sqlalchemy.orm import Session
7
+ from app.models.cama import Cama
8
+ from app.schemas.cama import CamaCreateRequest
9
+
10
+
11
+ def get_by_id(db: Session, cama_id: int) -> Cama | None:
12
+ return db.query(Cama).filter(Cama.id == cama_id).first()
13
+
14
+
15
+ def get_all(
16
+ db: Session,
17
+ rol: str,
18
+ piso: int | None = None,
19
+ sector: str | None = None,
20
+ estado: str | None = None,
21
+ hospital_id: str | None = None,
22
+ ) -> list[Cama]:
23
+ q = db.query(Cama).filter(Cama.estado != "BAJA_PERMANENTE")
24
+
25
+ if rol == "LIMPIEZA":
26
+ q = q.filter(Cama.estado == "EN_LIMPIEZA")
27
+ else:
28
+ if estado:
29
+ q = q.filter(Cama.estado == estado)
30
+
31
+ if piso is not None:
32
+ q = q.filter(Cama.piso == piso)
33
+ if sector:
34
+ q = q.filter(Cama.sector == sector)
35
+ if hospital_id:
36
+ q = q.filter(Cama.hospital_id == hospital_id)
37
+
38
+ return q.all()
39
+
40
+
41
+ def create(db: Session, data: CamaCreateRequest) -> Cama:
42
+ cama = Cama(
43
+ numero=data.numero,
44
+ piso=data.piso,
45
+ sector=data.sector.value,
46
+ tipo=data.tipo.value,
47
+ hospital_id=data.hospital_id,
48
+ estado="DISPONIBLE",
49
+ contraindicaciones_incompatibles=data.contraindicaciones_incompatibles,
50
+ ultima_actualizacion=datetime.now(timezone.utc),
51
+ )
52
+ db.add(cama)
53
+ db.commit()
54
+ db.refresh(cama)
55
+ return cama
56
+
57
+
58
+ def save(db: Session, cama: Cama) -> Cama:
59
+ db.commit()
60
+ db.refresh(cama)
61
+ return cama
62
+
63
+
64
+ def get_quirofanos(
65
+ db: Session, hospital_id: str | None = None, exclude_estados: list[str] | None = None
66
+ ) -> list[Cama]:
67
+ excluidos = exclude_estados or ["FUERA_DE_SERVICIO", "BAJA_PERMANENTE"]
68
+ q = db.query(Cama).filter(
69
+ Cama.sector == "QUIROFANO",
70
+ Cama.tipo == "CIRUGIA",
71
+ Cama.estado.notin_(excluidos),
72
+ )
73
+ if hospital_id:
74
+ q = q.filter(Cama.hospital_id == hospital_id)
75
+ return q.all()
76
+
77
+
78
+ def get_by_paciente(db: Session, paciente_id: int, estados: list[str]) -> Cama | None:
79
+ return db.query(Cama).filter(
80
+ Cama.paciente_id == paciente_id,
81
+ Cama.estado.in_(estados),
82
+ ).first()
app/crud/reserva.py ADDED
@@ -0,0 +1,125 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Operaciones de acceso a datos para ReservaQuirofano. Sin lógica de negocio ni HTTPException.
3
+ """
4
+ from __future__ import annotations
5
+ from datetime import datetime, timezone
6
+ from sqlalchemy.orm import Session
7
+ from app.models.reserva import ReservaQuirofano
8
+ from app.schemas.reserva import ReservaQuirofanoCreateRequest, CirugiaUrgenteWebhook
9
+
10
+
11
+ def get_by_id(db: Session, reserva_id: int) -> ReservaQuirofano | None:
12
+ return db.query(ReservaQuirofano).filter(ReservaQuirofano.id == reserva_id).first()
13
+
14
+
15
+ def get_by_cama_and_id(db: Session, cama_id: int, reserva_id: int) -> ReservaQuirofano | None:
16
+ return db.query(ReservaQuirofano).filter(
17
+ ReservaQuirofano.id == reserva_id,
18
+ ReservaQuirofano.cama_id == cama_id,
19
+ ).first()
20
+
21
+
22
+ def get_by_turno(db: Session, turno_id: str) -> ReservaQuirofano | None:
23
+ return db.query(ReservaQuirofano).filter(
24
+ ReservaQuirofano.turno_id == turno_id,
25
+ ReservaQuirofano.origen == "PROGRAMADA",
26
+ ).first()
27
+
28
+
29
+ def get_by_urgencia_hce_id(db: Session, hce_id: str) -> ReservaQuirofano | None:
30
+ return db.query(ReservaQuirofano).filter(
31
+ ReservaQuirofano.solicitud_urgencia_hce_id == hce_id
32
+ ).first()
33
+
34
+
35
+ def get_all(
36
+ db: Session,
37
+ cama_id: int,
38
+ estado: str | None = None,
39
+ prioridad: str | None = None,
40
+ fecha_desde: str | None = None,
41
+ fecha_hasta: str | None = None,
42
+ ) -> list[ReservaQuirofano]:
43
+ q = db.query(ReservaQuirofano).filter(ReservaQuirofano.cama_id == cama_id)
44
+ if estado:
45
+ q = q.filter(ReservaQuirofano.estado == estado)
46
+ else:
47
+ q = q.filter(ReservaQuirofano.estado.in_(["RESERVADA", "EN_CURSO"]))
48
+ if prioridad:
49
+ q = q.filter(ReservaQuirofano.prioridad == prioridad)
50
+ if fecha_desde:
51
+ q = q.filter(ReservaQuirofano.fecha_hora_inicio >= fecha_desde)
52
+ if fecha_hasta:
53
+ q = q.filter(ReservaQuirofano.fecha_hora_fin_estimada <= fecha_hasta)
54
+ return q.all()
55
+
56
+
57
+ def get_superpuestas(
58
+ db: Session,
59
+ cama_id: int,
60
+ inicio: datetime,
61
+ fin: datetime,
62
+ exclude_id: int | None = None,
63
+ ) -> list[ReservaQuirofano]:
64
+ q = db.query(ReservaQuirofano).filter(
65
+ ReservaQuirofano.cama_id == cama_id,
66
+ ReservaQuirofano.estado.in_(["RESERVADA", "EN_CURSO"]),
67
+ ReservaQuirofano.fecha_hora_inicio < fin,
68
+ ReservaQuirofano.fecha_hora_fin_estimada > inicio,
69
+ )
70
+ if exclude_id:
71
+ q = q.filter(ReservaQuirofano.id != exclude_id)
72
+ return q.all()
73
+
74
+
75
+ def get_activa_por_turno(db: Session, turno_id: str) -> ReservaQuirofano | None:
76
+ return db.query(ReservaQuirofano).filter(
77
+ ReservaQuirofano.turno_id == turno_id,
78
+ ReservaQuirofano.estado.in_(["RESERVADA", "EN_CURSO"]),
79
+ ).first()
80
+
81
+
82
+ def create_programada(db: Session, cama_id: int, data: ReservaQuirofanoCreateRequest) -> ReservaQuirofano:
83
+ reserva = ReservaQuirofano(
84
+ cama_id=cama_id,
85
+ turno_id=data.turno_id,
86
+ origen="PROGRAMADA",
87
+ estado="RESERVADA",
88
+ prioridad=data.prioridad.value,
89
+ paciente_id=data.paciente_id,
90
+ medico_cirujano_id=data.medico_cirujano_id,
91
+ fecha_hora_inicio=data.fecha_hora_inicio,
92
+ fecha_hora_fin_estimada=data.fecha_hora_fin_estimada,
93
+ observaciones=data.observaciones,
94
+ created_at=datetime.now(timezone.utc),
95
+ )
96
+ db.add(reserva)
97
+ db.commit()
98
+ db.refresh(reserva)
99
+ return reserva
100
+
101
+
102
+ def create_urgente_flush(db: Session, cama_id: int, data: CirugiaUrgenteWebhook) -> ReservaQuirofano:
103
+ """Crea la reserva urgente con flush (sin commit — el commit lo hace el caller)."""
104
+ reserva = ReservaQuirofano(
105
+ cama_id=cama_id,
106
+ solicitud_urgencia_hce_id=data.solicitud_urgencia_hce_id,
107
+ origen="EMERGENCIA",
108
+ estado="RESERVADA",
109
+ prioridad="URGENTE",
110
+ paciente_id=data.paciente_id,
111
+ medico_cirujano_id=data.medico_cirujano_id,
112
+ fecha_hora_inicio=data.fecha_hora_inicio,
113
+ fecha_hora_fin_estimada=data.fecha_hora_fin_estimada,
114
+ observaciones=f"Cirugía urgente solicitada por HCE ({data.solicitud_urgencia_hce_id})",
115
+ created_at=datetime.now(timezone.utc),
116
+ )
117
+ db.add(reserva)
118
+ db.flush()
119
+ return reserva
120
+
121
+
122
+ def save(db: Session, reserva: ReservaQuirofano) -> ReservaQuirofano:
123
+ db.commit()
124
+ db.refresh(reserva)
125
+ return reserva
app/crud/solicitud.py ADDED
@@ -0,0 +1,66 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Operaciones de acceso a datos para Solicitud. Sin lógica de negocio ni HTTPException.
3
+ """
4
+ from __future__ import annotations
5
+ from sqlalchemy.orm import Session
6
+ from app.models.solicitud import Solicitud
7
+ from app.schemas.solicitud import SolicitudHceWebhook
8
+
9
+
10
+ def get_by_id(db: Session, solicitud_id: int) -> Solicitud | None:
11
+ return db.query(Solicitud).filter(Solicitud.id == solicitud_id).first()
12
+
13
+
14
+ def get_by_hce_id(db: Session, solicitud_hce_id: str) -> Solicitud | None:
15
+ return db.query(Solicitud).filter(Solicitud.solicitud_hce_id == solicitud_hce_id).first()
16
+
17
+
18
+ def get_all(
19
+ db: Session,
20
+ estado: str | None = None,
21
+ tipo: str | None = None,
22
+ hospital_id: str | None = None,
23
+ ) -> list[Solicitud]:
24
+ q = db.query(Solicitud)
25
+ if estado:
26
+ q = q.filter(Solicitud.estado == estado)
27
+ else:
28
+ q = q.filter(Solicitud.estado == "PENDIENTE")
29
+ if tipo:
30
+ q = q.filter(Solicitud.tipo == tipo)
31
+ if hospital_id:
32
+ q = q.filter(Solicitud.hospital_id == hospital_id)
33
+ return q.all()
34
+
35
+
36
+ def create(db: Session, data: SolicitudHceWebhook) -> Solicitud:
37
+ sol = Solicitud(
38
+ solicitud_hce_id=data.solicitud_hce_id,
39
+ tipo=data.tipo.value,
40
+ estado="PENDIENTE",
41
+ paciente_id=data.paciente_id,
42
+ medico_solicitante_id=data.medico_solicitante_id,
43
+ cama_solicitada_id=data.cama_solicitada_id,
44
+ origen=data.origen.value if data.origen else None,
45
+ turno_id=data.turno_id,
46
+ diagnostico_ingreso=data.diagnostico_ingreso,
47
+ obra_social_id=data.obra_social_id,
48
+ numero_afiliado=data.numero_afiliado,
49
+ prioridad=data.prioridad.value if data.prioridad else None,
50
+ observaciones=data.observaciones,
51
+ hospital_id=data.hospital_id,
52
+ cama_origen_id=data.cama_origen_id,
53
+ cama_destino_solicitada_id=data.cama_destino_solicitada_id,
54
+ motivo_traslado=data.motivo_traslado,
55
+ timestamp_solicitud=data.timestamp,
56
+ )
57
+ db.add(sol)
58
+ db.commit()
59
+ db.refresh(sol)
60
+ return sol
61
+
62
+
63
+ def save(db: Session, solicitud: Solicitud) -> Solicitud:
64
+ db.commit()
65
+ db.refresh(solicitud)
66
+ return solicitud
app/dependencies.py ADDED
@@ -0,0 +1,102 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Dependencias compartidas de FastAPI: BD, JWT y autenticación.
3
+ Unifica database.py + auth/jwt_handler.py + auth/dependencies.py del proyecto original.
4
+ """
5
+ import logging
6
+ from datetime import datetime, timedelta, timezone
7
+
8
+ from fastapi import Depends, HTTPException, status
9
+ from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
10
+ from jose import JWTError, jwt
11
+ from sqlalchemy import create_engine
12
+ from sqlalchemy.orm import sessionmaker, Session, DeclarativeBase
13
+
14
+ from app.config import settings
15
+
16
+ logger = logging.getLogger(__name__)
17
+
18
+ # ─── Base de datos ─────────────────────────────────────────────────────────
19
+
20
+ engine = create_engine(
21
+ settings.database_url,
22
+ pool_pre_ping=True,
23
+ pool_size=5,
24
+ max_overflow=10,
25
+ )
26
+
27
+ SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
28
+
29
+
30
+ class Base(DeclarativeBase):
31
+ pass
32
+
33
+
34
+ def get_db():
35
+ db = SessionLocal()
36
+ try:
37
+ yield db
38
+ except Exception:
39
+ db.rollback()
40
+ raise
41
+ finally:
42
+ db.close()
43
+
44
+
45
+ # ─── JWT ───────────────────────────────────────────────────────────────────
46
+
47
+ def create_access_token(sub: str, rol: str, extra: dict | None = None) -> str:
48
+ now = datetime.now(timezone.utc)
49
+ payload = {
50
+ "sub": str(sub),
51
+ "rol": rol,
52
+ "iat": now,
53
+ "exp": now + timedelta(minutes=settings.jwt_expire_minutes),
54
+ }
55
+ if extra:
56
+ payload.update(extra)
57
+ return jwt.encode(payload, settings.jwt_secret, algorithm=settings.jwt_algorithm)
58
+
59
+
60
+ def decode_token(token: str) -> dict:
61
+ try:
62
+ return jwt.decode(
63
+ token,
64
+ settings.jwt_secret,
65
+ algorithms=[settings.jwt_algorithm],
66
+ )
67
+ except JWTError as e:
68
+ logger.warning("Intento de autenticación con token inválido: %s", e)
69
+ raise ValueError("Token inválido")
70
+
71
+
72
+ # ─── Auth FastAPI ───────────────────────────────────────────────────────────
73
+
74
+ _security = HTTPBearer()
75
+
76
+ _ERROR_401 = {"codigo": "NO_AUTENTICADO", "mensaje": "Token ausente, expirado o malformado"}
77
+ _ERROR_403 = {"codigo": "NO_AUTORIZADO", "mensaje": "No tiene permisos para esta operación"}
78
+
79
+
80
+ def get_current_user(
81
+ credentials: HTTPAuthorizationCredentials = Depends(_security),
82
+ ) -> dict:
83
+ try:
84
+ payload = decode_token(credentials.credentials)
85
+ except ValueError:
86
+ raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail=_ERROR_401)
87
+
88
+ if "sub" not in payload or "rol" not in payload:
89
+ raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail=_ERROR_401)
90
+
91
+ return payload
92
+
93
+
94
+ def require_roles(*roles: str):
95
+ """
96
+ Uso: Depends(require_roles("ADMINISTRATIVO", "MEDICO"))
97
+ """
98
+ def checker(user: dict = Depends(get_current_user)) -> dict:
99
+ if user.get("rol") not in roles:
100
+ raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail=_ERROR_403)
101
+ return user
102
+ return checker
app/integrations/__init__.py ADDED
File without changes
app/integrations/_base.py ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Helpers HTTP internos compartidos por todos los clientes de integración.
3
+ """
4
+ import logging
5
+ import httpx
6
+ from app.config import settings
7
+
8
+ logger = logging.getLogger(__name__)
9
+
10
+
11
+ def _headers(token: str | None = None) -> dict:
12
+ h = {"Content-Type": "application/json"}
13
+ if token:
14
+ h["Authorization"] = f"Bearer {token}"
15
+ return h
16
+
17
+
18
+ def _post(url: str, payload: dict, token: str | None = None) -> dict | None:
19
+ try:
20
+ r = httpx.post(url, json=payload, headers=_headers(token), timeout=settings.http_timeout_seconds)
21
+ r.raise_for_status()
22
+ return r.json()
23
+ except Exception as e:
24
+ logger.warning("Error en POST %s: %s", url, e)
25
+ return None
26
+
27
+
28
+ def _get(url: str, token: str | None = None) -> dict | None:
29
+ try:
30
+ r = httpx.get(url, headers=_headers(token), timeout=settings.http_timeout_seconds)
31
+ r.raise_for_status()
32
+ return r.json()
33
+ except Exception as e:
34
+ logger.warning("Error en GET %s: %s", url, e)
35
+ return None
app/integrations/core.py ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ M10 Core — validación de pacientes.
3
+ """
4
+ from app.config import settings
5
+ from app.integrations._base import _get
6
+
7
+
8
+ def validate_patient(paciente_id: int) -> dict | None:
9
+ """Verifica existencia del paciente en M10. Retorna datos básicos o None."""
10
+ if settings.mock_external_services:
11
+ return {"id": paciente_id, "nombre": "Paciente", "apellido": "Mock"}
12
+ return _get(f"{settings.m10_core_url}/api/v1/usuarios/{paciente_id}")
app/integrations/facturacion.py ADDED
@@ -0,0 +1,27 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ M7 Facturación — notificación de cama lista para facturar.
3
+ """
4
+ from datetime import datetime, timezone
5
+ from app.config import settings
6
+ from app.integrations._base import _post
7
+
8
+
9
+ def notify_cama_lista(
10
+ cama_id: int,
11
+ paciente_id: int,
12
+ obra_social_id: str | None = None,
13
+ numero_afiliado: str | None = None,
14
+ ) -> bool:
15
+ if settings.mock_external_services:
16
+ return True
17
+ payload = {
18
+ "evento": "CAMA_LISTA",
19
+ "cama_id": cama_id,
20
+ "paciente_id": paciente_id,
21
+ "obra_social_id": obra_social_id,
22
+ "numero_afiliado": numero_afiliado,
23
+ "timestamp_evento": datetime.now(timezone.utc).isoformat(),
24
+ }
25
+ return _post(
26
+ f"{settings.m7_facturacion_url}/api/v1/webhooks/internacion/cama-lista", payload
27
+ ) is not None
app/integrations/hce.py ADDED
@@ -0,0 +1,42 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ M1 HCE — contraindicaciones y movimientos de pacientes.
3
+ """
4
+ from datetime import datetime, timezone
5
+ from app.config import settings
6
+ from app.integrations._base import _get, _post
7
+
8
+
9
+ def get_contraindicaciones(paciente_id: int) -> list[str]:
10
+ """
11
+ Retorna lista de contraindicaciones del paciente.
12
+ Consulta informativa — no bloquea el flujo si el servicio no está disponible.
13
+ """
14
+ if settings.mock_external_services:
15
+ return []
16
+ data = _get(f"{settings.m1_hce_url}/api/v1/hce/pacientes/{paciente_id}/contraindicaciones")
17
+ if not data:
18
+ return []
19
+ return [d.get("descripcion", "") for d in data.get("detalle", [])]
20
+
21
+
22
+ def notify_movimiento(
23
+ tipo_movimiento: str,
24
+ paciente_id: int,
25
+ cama_id: int | None = None,
26
+ cama_origen_id: int | None = None,
27
+ resultado: str | None = None,
28
+ motivo: str | None = None,
29
+ ) -> bool:
30
+ """Notifica a M1 (HCE) un movimiento de paciente. Retorna True si OK."""
31
+ if settings.mock_external_services:
32
+ return True
33
+ payload = {
34
+ "tipo_movimiento": tipo_movimiento,
35
+ "paciente_id": paciente_id,
36
+ "cama_id": cama_id,
37
+ "cama_origen_id": cama_origen_id,
38
+ "resultado": resultado,
39
+ "motivo": motivo,
40
+ "timestamp": datetime.now(timezone.utc).isoformat(),
41
+ }
42
+ return _post(f"{settings.m1_hce_url}/api/v1/hce/movimientos", payload) is not None
app/integrations/monitoreo.py ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ M9 Monitoreo — altas y bajas de pacientes en monitoreo.
3
+ """
4
+ from datetime import datetime, timezone
5
+ from app.config import settings
6
+ from app.integrations._base import _post
7
+
8
+
9
+ def notify_alta(paciente_id: int) -> bool:
10
+ if settings.mock_external_services:
11
+ return True
12
+ payload = {
13
+ "evento": "ALTA_MONITOREO",
14
+ "paciente_id": paciente_id,
15
+ "timestamp": datetime.now(timezone.utc).isoformat(),
16
+ }
17
+ return _post(
18
+ f"{settings.m9_monitoreo_url}/api/v1/webhooks/internacion/alta-monitoreo", payload
19
+ ) is not None
20
+
21
+
22
+ def notify_baja(paciente_id: int) -> bool:
23
+ if settings.mock_external_services:
24
+ return True
25
+ payload = {
26
+ "evento": "BAJA_MONITOREO",
27
+ "paciente_id": paciente_id,
28
+ "timestamp": datetime.now(timezone.utc).isoformat(),
29
+ }
30
+ return _post(
31
+ f"{settings.m9_monitoreo_url}/api/v1/webhooks/internacion/baja-monitoreo", payload
32
+ ) is not None
app/integrations/turnos.py ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ M2 Turnos — notificación de resultado de quirófano.
3
+ """
4
+ from datetime import datetime, timezone
5
+ from app.config import settings
6
+ from app.integrations._base import _post
7
+
8
+
9
+ def notify_resultado_quirofano(
10
+ turno_id: str,
11
+ reserva_id: int,
12
+ cama_id: int,
13
+ reserva_urgente_id: int,
14
+ motivo: str | None = None,
15
+ ) -> bool:
16
+ if settings.mock_external_services:
17
+ return True
18
+ payload = {
19
+ "resultado": "CANCELADA",
20
+ "reserva_id": reserva_id,
21
+ "cama_id": cama_id,
22
+ "motivo_cancelacion": "DESPLAZADA_POR_URGENCIA",
23
+ "reserva_urgente_id": reserva_urgente_id,
24
+ "motivo": motivo,
25
+ "timestamp": datetime.now(timezone.utc).isoformat(),
26
+ }
27
+ return _post(
28
+ f"{settings.m2_turnos_url}/api/v1/turnos/{turno_id}/resultado-quirofano", payload
29
+ ) is not None
app/main.py ADDED
@@ -0,0 +1,111 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Health Grid - Módulo 6: Internación y Gestión de Camas
3
+ API REST: http://localhost:8006/api/v1
4
+ """
5
+ import logging
6
+ from contextlib import asynccontextmanager
7
+ from fastapi import FastAPI, Request, status
8
+ from fastapi.middleware.cors import CORSMiddleware
9
+ from fastapi.responses import JSONResponse
10
+
11
+ from app.config import settings
12
+ from app.dependencies import engine, Base, create_access_token
13
+
14
+ # Registrar modelos antes de create_all
15
+ import app.models.cama # noqa: F401
16
+ import app.models.solicitud # noqa: F401
17
+ import app.models.reserva # noqa: F401
18
+
19
+ from app.routers import camas, solicitudes, webhooks
20
+
21
+ logger = logging.getLogger(__name__)
22
+
23
+ logging.basicConfig(
24
+ level=logging.INFO,
25
+ format="%(asctime)s %(levelname)s %(name)s: %(message)s",
26
+ )
27
+
28
+
29
+ # ─── Startup / Shutdown ────────────────────────────────────────────────────
30
+
31
+ @asynccontextmanager
32
+ async def lifespan(app: FastAPI):
33
+ Base.metadata.create_all(bind=engine)
34
+ logger.info("Tablas creadas/verificadas correctamente")
35
+ yield
36
+
37
+
38
+ # ─── App ───────────────────────────────────────────────────────────────────
39
+
40
+ app = FastAPI(
41
+ title="Health Grid – Módulo 6: Internación y Gestión de Camas",
42
+ description="API REST para gestión de camas hospitalarias y solicitudes de internación.",
43
+ version="4.0.0",
44
+ lifespan=lifespan,
45
+ docs_url="/api/v1/docs",
46
+ redoc_url="/api/v1/redoc",
47
+ openapi_url="/api/v1/openapi.json",
48
+ )
49
+
50
+ app.add_middleware(
51
+ CORSMiddleware,
52
+ allow_origins=settings.allowed_origins,
53
+ allow_credentials=True,
54
+ allow_methods=["*"],
55
+ allow_headers=["*"],
56
+ )
57
+
58
+ # ─── Prefijo global /api/v1 ────────────────────────────────────────────────
59
+
60
+ PREFIX = "/api/v1"
61
+
62
+ app.include_router(camas.router, prefix=PREFIX)
63
+ app.include_router(solicitudes.router, prefix=PREFIX)
64
+ app.include_router(webhooks.router, prefix=PREFIX)
65
+
66
+
67
+ # ─── Endpoint de auth local (mock de M10 — solo para desarrollo) ───────────
68
+
69
+ @app.get(f"{PREFIX}/auth/token", tags=["Auth (dev)"], summary="Obtener JWT de desarrollo", include_in_schema=True)
70
+ def get_dev_token(usuario: str, password: str):
71
+ """
72
+ Solo habilitado si ENVIRONMENT=development.
73
+ Genera un JWT de prueba. Roles válidos: ADMINISTRATIVO | MEDICO | LIMPIEZA
74
+ """
75
+ if settings.environment != "development":
76
+ return JSONResponse(status_code=404, content={"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "Not Found"})
77
+
78
+ roles_validos = {"ADMINISTRATIVO", "MEDICO", "LIMPIEZA"}
79
+ rol = usuario.upper()
80
+ if rol not in roles_validos:
81
+ return JSONResponse(
82
+ status_code=status.HTTP_401_UNAUTHORIZED,
83
+ content={"codigo": "NO_AUTENTICADO", "mensaje": f"Rol inválido. Usar: {roles_validos}"},
84
+ )
85
+ token = create_access_token(sub="1", rol=rol)
86
+ return {"access_token": token, "token_type": "bearer", "rol": rol}
87
+
88
+
89
+ # ─── Health check ──────────────────────────────────────────────────────────
90
+
91
+ @app.get("/health", tags=["Health"])
92
+ def health():
93
+ return {"status": "ok", "module": "M6 - Internación"}
94
+
95
+
96
+ # ─── Manejadores de errores globales ───────────────────────────────────────
97
+
98
+ @app.exception_handler(404)
99
+ async def not_found_handler(request: Request, exc: Exception):
100
+ return JSONResponse(
101
+ status_code=404,
102
+ content={"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "El recurso solicitado no existe"},
103
+ )
104
+
105
+
106
+ @app.exception_handler(405)
107
+ async def method_not_allowed_handler(request: Request, exc: Exception):
108
+ return JSONResponse(
109
+ status_code=405,
110
+ content={"codigo": "METODO_NO_PERMITIDO", "mensaje": "Método HTTP no permitido"},
111
+ )
app/models/__init__.py ADDED
@@ -0,0 +1,5 @@
 
 
 
 
 
 
1
+ from app.models.cama import Cama
2
+ from app.models.solicitud import Solicitud
3
+ from app.models.reserva import ReservaQuirofano
4
+
5
+ __all__ = ["Cama", "Solicitud", "ReservaQuirofano"]
app/models/cama.py ADDED
@@ -0,0 +1,42 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from __future__ import annotations
2
+ from datetime import datetime, timezone
3
+ from sqlalchemy import Column, Integer, String, DateTime
4
+ from sqlalchemy.dialects.postgresql import ARRAY
5
+ from sqlalchemy.orm import relationship
6
+ from app.dependencies import Base
7
+
8
+
9
+ class Cama(Base):
10
+ __tablename__ = "camas"
11
+
12
+ id = Column(Integer, primary_key=True, autoincrement=True)
13
+ numero = Column(String(20), nullable=False)
14
+ piso = Column(Integer, nullable=False)
15
+ # SectorEnum: UTI | SALA_COMUN | QUIROFANO | GUARDIA | NEONATOLOGIA
16
+ sector = Column(String(20), nullable=False)
17
+ # TipoCamaEnum: ESTANDAR | PEDIATRICA | AISLAMIENTO | CRITICA | CIRUGIA
18
+ tipo = Column(String(20), nullable=False)
19
+ # EstadoCamaEnum: DISPONIBLE | OCUPADA | EN_LIMPIEZA | FUERA_DE_SERVICIO | BAJA_PERMANENTE | CODIGO_ROJO
20
+ estado = Column(String(20), nullable=False, default="DISPONIBLE")
21
+ paciente_id = Column(Integer, nullable=True)
22
+ hospital_id = Column(String(50), nullable=False)
23
+ contraindicaciones_incompatibles = Column(ARRAY(String), nullable=False, default=list)
24
+ ultima_actualizacion = Column(
25
+ DateTime(timezone=True),
26
+ default=lambda: datetime.now(timezone.utc),
27
+ onupdate=lambda: datetime.now(timezone.utc),
28
+ )
29
+ # Rastrea tipo del último movimiento para saber si disparar CAMA_LISTA al quedar DISPONIBLE
30
+ ultimo_movimiento_tipo = Column(String(20), nullable=True)
31
+
32
+ solicitudes_solicitadas = relationship(
33
+ "Solicitud",
34
+ foreign_keys="Solicitud.cama_solicitada_id",
35
+ back_populates="cama_solicitada",
36
+ )
37
+ solicitudes_asignadas = relationship(
38
+ "Solicitud",
39
+ foreign_keys="Solicitud.cama_asignada_id",
40
+ back_populates="cama_asignada",
41
+ )
42
+ reservas = relationship("ReservaQuirofano", back_populates="cama")
app/models/reserva.py ADDED
@@ -0,0 +1,46 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from __future__ import annotations
2
+ from datetime import datetime, timezone
3
+ from sqlalchemy import Column, Integer, String, DateTime, ForeignKey
4
+ from sqlalchemy.orm import relationship
5
+ from app.dependencies import Base
6
+
7
+
8
+ class ReservaQuirofano(Base):
9
+ __tablename__ = "reservas_quirofano"
10
+
11
+ id = Column(Integer, primary_key=True, autoincrement=True)
12
+ cama_id = Column(Integer, ForeignKey("camas.id"), nullable=False)
13
+
14
+ turno_id = Column(String(50), nullable=True)
15
+ solicitud_urgencia_hce_id = Column(String(50), nullable=True, unique=True)
16
+
17
+ # PROGRAMADA | EMERGENCIA
18
+ origen = Column(String(20), nullable=False)
19
+ # RESERVADA | EN_CURSO | COMPLETADA | CANCELADA
20
+ estado = Column(String(20), nullable=False, default="RESERVADA")
21
+ # PrioridadQuirofanoEnum: MUY_BAJA | BAJA | MEDIA | ALTA | MUY_ALTA | URGENTE
22
+ prioridad = Column(String(20), nullable=False)
23
+
24
+ paciente_id = Column(Integer, nullable=False)
25
+ medico_cirujano_id = Column(Integer, nullable=False)
26
+
27
+ fecha_hora_inicio = Column(DateTime(timezone=True), nullable=False)
28
+ fecha_hora_fin_estimada = Column(DateTime(timezone=True), nullable=False)
29
+ observaciones = Column(String(500), nullable=True)
30
+
31
+ # Si fue desplazada por una urgente: apunta a la reserva que la desplazó
32
+ desplazada_por_reserva_id = Column(
33
+ Integer, ForeignKey("reservas_quirofano.id"), nullable=True
34
+ )
35
+
36
+ created_at = Column(
37
+ DateTime(timezone=True),
38
+ default=lambda: datetime.now(timezone.utc),
39
+ )
40
+
41
+ cama = relationship("Cama", back_populates="reservas")
42
+ desplazada_por = relationship(
43
+ "ReservaQuirofano",
44
+ remote_side=[id],
45
+ foreign_keys=[desplazada_por_reserva_id],
46
+ )
app/models/solicitud.py ADDED
@@ -0,0 +1,61 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from __future__ import annotations
2
+ from sqlalchemy import Column, Integer, String, DateTime, ForeignKey
3
+ from sqlalchemy.orm import relationship
4
+ from app.dependencies import Base
5
+
6
+
7
+ class Solicitud(Base):
8
+ __tablename__ = "solicitudes"
9
+
10
+ id = Column(Integer, primary_key=True, autoincrement=True)
11
+ solicitud_hce_id = Column(String(50), unique=True, nullable=False)
12
+ # TipoSolicitudEnum: INTERNACION | TRASLADO
13
+ tipo = Column(String(20), nullable=False)
14
+ # EstadoSolicitudEnum: PENDIENTE | APROBADA | RECHAZADA
15
+ estado = Column(String(20), nullable=False, default="PENDIENTE")
16
+
17
+ paciente_id = Column(Integer, nullable=False)
18
+ medico_solicitante_id = Column(Integer, nullable=False)
19
+
20
+ cama_solicitada_id = Column(Integer, ForeignKey("camas.id"), nullable=True)
21
+ cama_asignada_id = Column(Integer, ForeignKey("camas.id"), nullable=True)
22
+
23
+ # OrigenIngresoEnum: GUARDIA | CIRUGIA_PROGRAMADA
24
+ origen = Column(String(30), nullable=True)
25
+ turno_id = Column(String(50), nullable=True)
26
+ diagnostico_ingreso = Column(String(300), nullable=True)
27
+ obra_social_id = Column(String(50), nullable=True)
28
+ numero_afiliado = Column(String(50), nullable=True)
29
+ # PrioridadSolicitudEnum: BAJA | MEDIA | ALTA | URGENTE
30
+ prioridad = Column(String(20), nullable=True)
31
+ observaciones = Column(String(500), nullable=True)
32
+ hospital_id = Column(String(50), nullable=True)
33
+
34
+ # Solo para TRASLADO
35
+ cama_origen_id = Column(Integer, nullable=True)
36
+ cama_destino_solicitada_id = Column(Integer, nullable=True)
37
+ motivo_traslado = Column(String(300), nullable=True)
38
+
39
+ # Resolución
40
+ # AccionResolucionEnum: APROBAR | APROBAR_CON_CAMBIO | RECHAZAR
41
+ accion = Column(String(30), nullable=True)
42
+ motivo = Column(String(300), nullable=True)
43
+ resuelto_por = Column(Integer, nullable=True)
44
+
45
+ timestamp_solicitud = Column(DateTime(timezone=True), nullable=False)
46
+ timestamp_resolucion = Column(DateTime(timezone=True), nullable=True)
47
+
48
+ cama_solicitada = relationship(
49
+ "Cama",
50
+ foreign_keys=[cama_solicitada_id],
51
+ back_populates="solicitudes_solicitadas",
52
+ )
53
+ cama_asignada = relationship(
54
+ "Cama",
55
+ foreign_keys=[cama_asignada_id],
56
+ back_populates="solicitudes_asignadas",
57
+ )
58
+
59
+ @property
60
+ def solicitud_id(self) -> str:
61
+ return f"SOL-{self.id:05d}"
app/routers/__init__.py ADDED
File without changes
app/routers/camas.py ADDED
@@ -0,0 +1,256 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from datetime import datetime
2
+ from typing import Optional
3
+ from fastapi import APIRouter, Depends, Query, status
4
+ from fastapi.responses import JSONResponse
5
+ from sqlalchemy.orm import Session
6
+
7
+ from app.dependencies import get_db, require_roles, get_current_user
8
+ from app.schemas.cama import (
9
+ CamaCreateRequest,
10
+ CamaUpdateRequest,
11
+ CamaResponse,
12
+ CamaMapaResponse,
13
+ AsignacionCamaRequest,
14
+ AsignacionCamaResponse,
15
+ DisponibilidadQuirofanosResponse,
16
+ )
17
+ from app.schemas.reserva import (
18
+ ReservaQuirofanoCreateRequest,
19
+ ReservaEstadoUpdateRequest,
20
+ ReservaQuirofanoResponse,
21
+ ReservasListResponse,
22
+ )
23
+ from app.schemas.enums import EstadoCamaEnum
24
+ from app.services import cama_service
25
+
26
+ router = APIRouter(prefix="/camas", tags=["Camas"])
27
+
28
+
29
+ # ─── Disponibilidad (debe ir ANTES de /{cama_id}) ─────────────────────────
30
+
31
+ @router.get(
32
+ "/disponibilidad",
33
+ summary="Consultar disponibilidad de quirófanos",
34
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}},
35
+ )
36
+ def get_disponibilidad(
37
+ desde: datetime = Query(...),
38
+ hasta: datetime = Query(...),
39
+ hospital_id: Optional[str] = Query(None),
40
+ db: Session = Depends(get_db),
41
+ user: dict = Depends(require_roles("ADMINISTRATIVO", "MEDICO")),
42
+ ):
43
+ quirofanos = cama_service.get_disponibilidad_quirofanos(db, desde, hasta, hospital_id)
44
+ result = []
45
+ for q in quirofanos:
46
+ reservas_resp = [ReservaQuirofanoResponse.model_validate(r) for r in q["reservas_en_rango"]]
47
+ result.append({
48
+ "cama_id": q["cama_id"],
49
+ "numero": q["numero"],
50
+ "piso": q["piso"],
51
+ "hospital_id": q["hospital_id"],
52
+ "estado": q["estado"],
53
+ "reservas_en_rango": [r.model_dump() for r in reservas_resp],
54
+ })
55
+ return {
56
+ "desde": desde.isoformat(),
57
+ "hasta": hasta.isoformat(),
58
+ "total_quirofanos": len(result),
59
+ "quirofanos": result,
60
+ }
61
+
62
+
63
+ # ─── CRUD Camas ────────────────────────────────────────────────────────────
64
+
65
+ @router.get(
66
+ "",
67
+ response_model=CamaMapaResponse,
68
+ summary="Obtener mapa completo de camas",
69
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}},
70
+ )
71
+ def get_camas(
72
+ piso: Optional[int] = Query(None),
73
+ sector: Optional[str] = Query(None),
74
+ estado: Optional[EstadoCamaEnum] = Query(None),
75
+ hospital_id: Optional[str] = Query(None),
76
+ db: Session = Depends(get_db),
77
+ user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO", "LIMPIEZA")),
78
+ ):
79
+ camas = cama_service.get_camas(db, user["rol"], piso, sector, estado.value if estado else None, hospital_id)
80
+ camas_resp = [CamaResponse.model_validate(c) for c in camas]
81
+ estados = [c.estado for c in camas]
82
+ return CamaMapaResponse(
83
+ total=len(camas_resp),
84
+ disponibles=estados.count(EstadoCamaEnum.DISPONIBLE.value),
85
+ ocupadas=estados.count(EstadoCamaEnum.OCUPADA.value),
86
+ en_limpieza=estados.count(EstadoCamaEnum.EN_LIMPIEZA.value),
87
+ fuera_de_servicio=estados.count(EstadoCamaEnum.FUERA_DE_SERVICIO.value),
88
+ codigo_rojo=estados.count(EstadoCamaEnum.CODIGO_ROJO.value),
89
+ camas=camas_resp,
90
+ )
91
+
92
+
93
+ @router.post(
94
+ "",
95
+ response_model=CamaResponse,
96
+ status_code=status.HTTP_201_CREATED,
97
+ summary="Crear una nueva cama",
98
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}},
99
+ )
100
+ def crear_cama(
101
+ data: CamaCreateRequest,
102
+ db: Session = Depends(get_db),
103
+ user: dict = Depends(require_roles("ADMINISTRATIVO")),
104
+ ):
105
+ cama = cama_service.create_cama(db, data)
106
+ return CamaResponse.model_validate(cama)
107
+
108
+
109
+ @router.get(
110
+ "/{cama_id}",
111
+ response_model=CamaResponse,
112
+ summary="Obtener detalle de una cama",
113
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Cama no encontrada"}},
114
+ )
115
+ def get_cama(
116
+ cama_id: int,
117
+ db: Session = Depends(get_db),
118
+ user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO")),
119
+ ):
120
+ cama = cama_service.get_cama(db, cama_id)
121
+ return CamaResponse.model_validate(cama)
122
+
123
+
124
+ @router.patch(
125
+ "/{cama_id}",
126
+ response_model=CamaResponse,
127
+ summary="Actualizar estado o contraindicaciones de una cama",
128
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Cama no encontrada"}, 409: {"description": "Conflicto de estado"}},
129
+ )
130
+ def update_cama(
131
+ cama_id: int,
132
+ data: CamaUpdateRequest,
133
+ db: Session = Depends(get_db),
134
+ user: dict = Depends(require_roles("ADMINISTRATIVO", "LIMPIEZA")),
135
+ ):
136
+ cama = cama_service.update_cama(db, cama_id, data, user["rol"])
137
+ return CamaResponse.model_validate(cama)
138
+
139
+
140
+ @router.delete(
141
+ "/{cama_id}",
142
+ response_model=CamaResponse,
143
+ summary="Dar de baja permanente una cama",
144
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Cama no encontrada"}, 409: {"description": "Cama en uso"}},
145
+ )
146
+ def delete_cama(
147
+ cama_id: int,
148
+ db: Session = Depends(get_db),
149
+ user: dict = Depends(require_roles("ADMINISTRATIVO")),
150
+ ):
151
+ cama = cama_service.delete_cama(db, cama_id)
152
+ return CamaResponse.model_validate(cama)
153
+
154
+
155
+ # ─── Asignación directa ────────────────────────────────────────────────────
156
+
157
+ @router.post(
158
+ "/{cama_id}/asignar",
159
+ response_model=AsignacionCamaResponse,
160
+ summary="Asignar o trasladar un paciente a una cama",
161
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Cama no encontrada"}, 409: {"description": "Cama no disponible"}, 422: {"description": "Contraindicación detectada"}},
162
+ )
163
+ def asignar_cama(
164
+ cama_id: int,
165
+ data: AsignacionCamaRequest,
166
+ db: Session = Depends(get_db),
167
+ user: dict = Depends(require_roles("ADMINISTRATIVO")),
168
+ ):
169
+ cama = cama_service.asignar_cama(db, cama_id, data.tipo, data.paciente_id, data.cama_origen_id)
170
+ return AsignacionCamaResponse(
171
+ mensaje=f"Paciente {data.paciente_id} asignado a la cama {cama_id}",
172
+ cama_id=cama.id,
173
+ paciente_id=data.paciente_id,
174
+ tipo=data.tipo,
175
+ cama_origen_id=data.cama_origen_id,
176
+ timestamp=cama.ultima_actualizacion,
177
+ )
178
+
179
+
180
+ # ─── Reservas de Quirófano ─────────────────────────────────────────────────
181
+
182
+ @router.get(
183
+ "/{cama_id}/reservas",
184
+ response_model=ReservasListResponse,
185
+ summary="Listar reservas de un quirófano",
186
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Cama no encontrada"}, 409: {"description": "La cama no es un quirófano"}},
187
+ )
188
+ def get_reservas(
189
+ cama_id: int,
190
+ estado: Optional[str] = Query(None),
191
+ prioridad: Optional[str] = Query(None),
192
+ fecha_desde: Optional[datetime] = Query(None),
193
+ fecha_hasta: Optional[datetime] = Query(None),
194
+ db: Session = Depends(get_db),
195
+ user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO")),
196
+ ):
197
+ reservas = cama_service.get_reservas(
198
+ db, cama_id, estado, prioridad,
199
+ fecha_desde.isoformat() if fecha_desde else None,
200
+ fecha_hasta.isoformat() if fecha_hasta else None,
201
+ )
202
+ return ReservasListResponse(
203
+ total=len(reservas),
204
+ reservas=[ReservaQuirofanoResponse.model_validate(r) for r in reservas],
205
+ )
206
+
207
+
208
+ @router.post(
209
+ "/{cama_id}/reservas",
210
+ response_model=ReservaQuirofanoResponse,
211
+ summary="Crear reserva de quirófano programada",
212
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Cama no encontrada"}, 409: {"description": "Conflicto de horario o estado"}, 422: {"description": "Prioridad URGENTE no permitida"}},
213
+ )
214
+ def crear_reserva(
215
+ cama_id: int,
216
+ data: ReservaQuirofanoCreateRequest,
217
+ db: Session = Depends(get_db),
218
+ user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO")),
219
+ ):
220
+ reserva, created = cama_service.create_reserva(db, cama_id, data)
221
+ resp = ReservaQuirofanoResponse.model_validate(reserva)
222
+ http_status = status.HTTP_201_CREATED if created else status.HTTP_200_OK
223
+ return JSONResponse(content=resp.model_dump(mode="json"), status_code=http_status)
224
+
225
+
226
+ @router.get(
227
+ "/{cama_id}/reservas/{reserva_id}",
228
+ response_model=ReservaQuirofanoResponse,
229
+ summary="Obtener detalle de una reserva de quirófano",
230
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Reserva no encontrada"}},
231
+ )
232
+ def get_reserva(
233
+ cama_id: int,
234
+ reserva_id: int,
235
+ db: Session = Depends(get_db),
236
+ user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO")),
237
+ ):
238
+ reserva = cama_service.get_reserva(db, cama_id, reserva_id)
239
+ return ReservaQuirofanoResponse.model_validate(reserva)
240
+
241
+
242
+ @router.patch(
243
+ "/{cama_id}/reservas/{reserva_id}",
244
+ response_model=ReservaQuirofanoResponse,
245
+ summary="Actualizar estado de una reserva de quirófano",
246
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Reserva no encontrada"}, 409: {"description": "Transición de estado inválida"}},
247
+ )
248
+ def update_reserva(
249
+ cama_id: int,
250
+ reserva_id: int,
251
+ data: ReservaEstadoUpdateRequest,
252
+ db: Session = Depends(get_db),
253
+ user: dict = Depends(require_roles("ADMINISTRATIVO")),
254
+ ):
255
+ reserva = cama_service.update_reserva_estado(db, cama_id, reserva_id, data)
256
+ return ReservaQuirofanoResponse.model_validate(reserva)
app/routers/solicitudes.py ADDED
@@ -0,0 +1,76 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from typing import Optional
2
+ from fastapi import APIRouter, Depends, Query
3
+ from sqlalchemy.orm import Session
4
+
5
+ from app.dependencies import get_db, require_roles
6
+ from app.schemas.solicitud import SolicitudResponse, SolicitudesListResponse, SolicitudResolucionRequest
7
+ from app.schemas.enums import EstadoSolicitudEnum, TipoSolicitudEnum
8
+ from app.services import solicitud_service
9
+
10
+ router = APIRouter(prefix="/solicitudes", tags=["Solicitudes"])
11
+
12
+
13
+ @router.get(
14
+ "",
15
+ response_model=SolicitudesListResponse,
16
+ summary="Listar solicitudes de internación",
17
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}},
18
+ )
19
+ def get_solicitudes(
20
+ estado: Optional[EstadoSolicitudEnum] = Query(None),
21
+ tipo: Optional[TipoSolicitudEnum] = Query(None),
22
+ hospital_id: Optional[str] = Query(None),
23
+ db: Session = Depends(get_db),
24
+ user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO")),
25
+ ):
26
+ solicitudes = solicitud_service.get_solicitudes(
27
+ db,
28
+ estado.value if estado else None,
29
+ tipo.value if tipo else None,
30
+ hospital_id,
31
+ )
32
+ respuestas = [
33
+ SolicitudResponse.model_validate({**s.__dict__, "id": s.solicitud_id})
34
+ for s in solicitudes
35
+ ]
36
+ return SolicitudesListResponse(total=len(respuestas), solicitudes=respuestas)
37
+
38
+
39
+ @router.get(
40
+ "/{solicitud_id}",
41
+ response_model=SolicitudResponse,
42
+ summary="Obtener detalle de una solicitud",
43
+ responses={401: {"description": "No autenticado"}, 403: {"description": "Sin permisos"}, 404: {"description": "Solicitud no encontrada"}},
44
+ )
45
+ def get_solicitud(
46
+ solicitud_id: str,
47
+ db: Session = Depends(get_db),
48
+ user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO")),
49
+ ):
50
+ sol = solicitud_service.get_solicitud(db, solicitud_id)
51
+ return SolicitudResponse.model_validate({**sol.__dict__, "id": sol.solicitud_id})
52
+
53
+
54
+ @router.patch(
55
+ "/{solicitud_id}",
56
+ response_model=SolicitudResponse,
57
+ summary="Aprobar o rechazar una solicitud",
58
+ responses={
59
+ 401: {"description": "No autenticado"},
60
+ 403: {"description": "Sin permisos"},
61
+ 404: {"description": "Solicitud no encontrada"},
62
+ 409: {"description": "Solicitud ya resuelta o cama no disponible"},
63
+ 422: {"description": "Contraindicación detectada"},
64
+ 502: {"description": "Servicio externo no disponible"},
65
+ },
66
+ )
67
+ def resolver_solicitud(
68
+ solicitud_id: str,
69
+ data: SolicitudResolucionRequest,
70
+ db: Session = Depends(get_db),
71
+ user: dict = Depends(require_roles("ADMINISTRATIVO")),
72
+ ):
73
+ sol = solicitud_service.resolver_solicitud(
74
+ db, solicitud_id, data, resuelto_por=int(user["sub"])
75
+ )
76
+ return SolicitudResponse.model_validate({**sol.__dict__, "id": sol.solicitud_id})
app/routers/webhooks.py ADDED
@@ -0,0 +1,170 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Webhooks entrantes: recibe llamadas de M1 (HCE), M2 (Turnos) y M9 (Monitoreo).
3
+ """
4
+ from fastapi import APIRouter, Depends, status
5
+ from fastapi.responses import JSONResponse
6
+ from sqlalchemy.orm import Session
7
+
8
+ from app.dependencies import get_db, get_current_user
9
+ from app.schemas.solicitud import (
10
+ SolicitudHceWebhook,
11
+ AltaMedicaWebhook,
12
+ AlertaEmergenciaRequest,
13
+ AlertaResueltaRequest,
14
+ )
15
+ from app.schemas.reserva import (
16
+ CirugiaUrgenteWebhook,
17
+ CirugiaUrgenteResponse,
18
+ CancelacionQuirofanoRequest,
19
+ CancelacionQuirofanoResponse,
20
+ ReservaQuirofanoResponse,
21
+ ReservaDesplazadaInfo,
22
+ )
23
+ from app.services import solicitud_service, cama_service
24
+
25
+ router = APIRouter(prefix="/webhooks", tags=["Webhooks Entrantes"])
26
+
27
+
28
+ # ─── Desde M1 (HCE) ────────────────────────────────────────────────────────
29
+
30
+ @router.post(
31
+ "/hce/solicitud",
32
+ status_code=status.HTTP_200_OK,
33
+ summary="[M1] Recibir solicitud de internación o traslado",
34
+ responses={401: {"description": "No autenticado"}, 422: {"description": "Payload inválido"}},
35
+ )
36
+ def recibir_solicitud(
37
+ data: SolicitudHceWebhook,
38
+ db: Session = Depends(get_db),
39
+ user: dict = Depends(get_current_user),
40
+ ):
41
+ sol = solicitud_service.recibir_solicitud(db, data)
42
+ return {
43
+ "mensaje": "Solicitud recibida y pendiente de aprobación",
44
+ "solicitud_id": sol.solicitud_id,
45
+ "estado": sol.estado,
46
+ }
47
+
48
+
49
+ @router.post(
50
+ "/hce/alta-medica",
51
+ status_code=status.HTTP_200_OK,
52
+ summary="[M1] Recibir alta médica de un paciente",
53
+ responses={401: {"description": "No autenticado"}, 404: {"description": "Paciente sin cama asignada"}},
54
+ )
55
+ def recibir_alta_medica(
56
+ data: AltaMedicaWebhook,
57
+ db: Session = Depends(get_db),
58
+ user: dict = Depends(get_current_user),
59
+ ):
60
+ cama = solicitud_service.procesar_alta_medica(db, data.paciente_id)
61
+ return {
62
+ "mensaje": "Alta médica procesada. Cama en limpieza.",
63
+ "cama_id": cama.id,
64
+ "estado_cama": cama.estado,
65
+ }
66
+
67
+
68
+ @router.post(
69
+ "/hce/cirugia-urgente",
70
+ summary="[M1] Recibir solicitud de cirugía urgente",
71
+ responses={
72
+ 401: {"description": "No autenticado"},
73
+ 409: {"description": "Sin quirófano disponible"},
74
+ 422: {"description": "Payload inválido"},
75
+ },
76
+ )
77
+ def recibir_cirugia_urgente(
78
+ data: CirugiaUrgenteWebhook,
79
+ db: Session = Depends(get_db),
80
+ user: dict = Depends(get_current_user),
81
+ ):
82
+ reserva_urgente, reserva_desplazada = cama_service.crear_reserva_urgente(db, data)
83
+ resp_reserva = ReservaQuirofanoResponse.model_validate(reserva_urgente)
84
+
85
+ resp_desplazada = None
86
+ if reserva_desplazada:
87
+ resp_desplazada = ReservaDesplazadaInfo(
88
+ reserva_id=reserva_desplazada.id,
89
+ cama_id=reserva_desplazada.cama_id,
90
+ turno_id=reserva_desplazada.turno_id,
91
+ prioridad_original=reserva_desplazada.prioridad,
92
+ notificado_a_m2=bool(reserva_desplazada.turno_id),
93
+ )
94
+
95
+ msg = "Reserva urgente creada exitosamente"
96
+ if resp_desplazada:
97
+ msg = f"Reserva urgente creada. Se desplazó la reserva {reserva_desplazada.id} (prioridad {reserva_desplazada.prioridad})"
98
+
99
+ content = CirugiaUrgenteResponse(
100
+ mensaje=msg,
101
+ reserva=resp_reserva,
102
+ reserva_desplazada=resp_desplazada,
103
+ ).model_dump(mode="json")
104
+
105
+ return JSONResponse(content=content, status_code=status.HTTP_201_CREATED)
106
+
107
+
108
+ # ─── Desde M2 (Turnos) ─────────────────────────────────────────────────────
109
+
110
+ @router.post(
111
+ "/turnos/{turno_id}/cancelacion-quirofano",
112
+ response_model=CancelacionQuirofanoResponse,
113
+ summary="[M2] Cancelar reserva de quirófano por turno",
114
+ responses={401: {"description": "No autenticado"}, 404: {"description": "Reserva no encontrada"}, 409: {"description": "Reserva no cancelable"}},
115
+ )
116
+ def cancelar_reserva_quirofano(
117
+ turno_id: str,
118
+ data: CancelacionQuirofanoRequest,
119
+ db: Session = Depends(get_db),
120
+ user: dict = Depends(get_current_user),
121
+ ):
122
+ reserva = solicitud_service.cancelar_reserva_por_turno(db, turno_id, data.motivo)
123
+ return CancelacionQuirofanoResponse(
124
+ mensaje="Reserva de quirófano cancelada correctamente",
125
+ reserva_id=reserva.id,
126
+ turno_id=reserva.turno_id,
127
+ cama_id=reserva.cama_id,
128
+ estado=reserva.estado,
129
+ )
130
+
131
+
132
+ # ─── Desde M9 (Monitoreo) ──────────────────────────────────────────────────
133
+
134
+ @router.post(
135
+ "/monitoreo/alerta-emergencia",
136
+ status_code=status.HTTP_200_OK,
137
+ summary="[M9] Recibir alerta de emergencia",
138
+ responses={401: {"description": "No autenticado"}, 404: {"description": "Paciente sin cama asignada"}},
139
+ )
140
+ def recibir_alerta_emergencia(
141
+ data: AlertaEmergenciaRequest,
142
+ db: Session = Depends(get_db),
143
+ user: dict = Depends(get_current_user),
144
+ ):
145
+ cama = solicitud_service.procesar_alerta_emergencia(db, data.paciente_id)
146
+ return {
147
+ "mensaje": f"Alerta registrada. Cama {cama.id} en CODIGO_ROJO.",
148
+ "cama_id": cama.id,
149
+ "sector": cama.sector,
150
+ }
151
+
152
+
153
+ @router.post(
154
+ "/monitoreo/alerta-resuelta",
155
+ status_code=status.HTTP_200_OK,
156
+ summary="[M9] Recibir resolución de alerta de emergencia",
157
+ responses={401: {"description": "No autenticado"}, 404: {"description": "Cama en CODIGO_ROJO no encontrada"}},
158
+ )
159
+ def recibir_alerta_resuelta(
160
+ data: AlertaResueltaRequest,
161
+ db: Session = Depends(get_db),
162
+ user: dict = Depends(get_current_user),
163
+ ):
164
+ cama = solicitud_service.procesar_alerta_resuelta(db, data.paciente_id)
165
+ return {
166
+ "mensaje": f"Alerta resuelta. Cama {cama.id} volvió a estado OCUPADA.",
167
+ "cama_id": cama.id,
168
+ "estado_anterior": "CODIGO_ROJO",
169
+ "estado_actual": cama.estado,
170
+ }
app/schemas/__init__.py ADDED
File without changes
app/schemas/cama.py ADDED
@@ -0,0 +1,74 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from __future__ import annotations
2
+ from datetime import datetime
3
+ from typing import Literal, Optional
4
+ from pydantic import BaseModel, ConfigDict, Field, field_validator
5
+ from app.schemas.enums import EstadoCamaEnum, SectorEnum, TipoCamaEnum
6
+
7
+
8
+ class CamaCreateRequest(BaseModel):
9
+ numero: str = Field(..., min_length=1, max_length=20)
10
+ piso: int
11
+ sector: SectorEnum
12
+ tipo: TipoCamaEnum
13
+ hospital_id: str = Field(..., min_length=1, max_length=50)
14
+ contraindicaciones_incompatibles: list[str] = []
15
+
16
+ @field_validator("numero", "hospital_id", mode="before")
17
+ @classmethod
18
+ def strip_and_require(cls, v: str) -> str:
19
+ v = v.strip()
20
+ if not v:
21
+ raise ValueError("El campo no puede estar vacío o contener solo espacios")
22
+ return v
23
+
24
+
25
+ class CamaUpdateRequest(BaseModel):
26
+ estado: Optional[EstadoCamaEnum] = None
27
+ contraindicaciones_incompatibles: Optional[list[str]] = None
28
+
29
+
30
+ class CamaResponse(BaseModel):
31
+ model_config = ConfigDict(from_attributes=True)
32
+
33
+ id: int
34
+ numero: str
35
+ piso: int
36
+ sector: SectorEnum
37
+ tipo: TipoCamaEnum
38
+ estado: EstadoCamaEnum
39
+ paciente_id: Optional[int] = None
40
+ hospital_id: str
41
+ contraindicaciones_incompatibles: list[str]
42
+ ultima_actualizacion: datetime
43
+
44
+
45
+ class CamaMapaResponse(BaseModel):
46
+ total: int
47
+ disponibles: int
48
+ ocupadas: int
49
+ en_limpieza: int
50
+ fuera_de_servicio: int
51
+ codigo_rojo: int
52
+ camas: list[CamaResponse]
53
+
54
+
55
+ class AsignacionCamaRequest(BaseModel):
56
+ tipo: Literal["INGRESO", "TRASLADO"]
57
+ paciente_id: int
58
+ cama_origen_id: Optional[int] = None
59
+
60
+
61
+ class AsignacionCamaResponse(BaseModel):
62
+ mensaje: str
63
+ cama_id: int
64
+ paciente_id: int
65
+ tipo: str
66
+ cama_origen_id: Optional[int] = None
67
+ timestamp: datetime
68
+
69
+
70
+ class DisponibilidadQuirofanosResponse(BaseModel):
71
+ desde: str
72
+ hasta: str
73
+ total_quirofanos: int
74
+ quirofanos: list[dict]
app/schemas/enums.py ADDED
@@ -0,0 +1,89 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from enum import Enum
2
+
3
+
4
+ class EstadoCamaEnum(str, Enum):
5
+ DISPONIBLE = "DISPONIBLE"
6
+ OCUPADA = "OCUPADA"
7
+ EN_LIMPIEZA = "EN_LIMPIEZA"
8
+ FUERA_DE_SERVICIO = "FUERA_DE_SERVICIO"
9
+ BAJA_PERMANENTE = "BAJA_PERMANENTE"
10
+ CODIGO_ROJO = "CODIGO_ROJO"
11
+
12
+
13
+ class SectorEnum(str, Enum):
14
+ UTI = "UTI"
15
+ SALA_COMUN = "SALA_COMUN"
16
+ QUIROFANO = "QUIROFANO"
17
+ GUARDIA = "GUARDIA"
18
+ NEONATOLOGIA = "NEONATOLOGIA"
19
+
20
+
21
+ class TipoCamaEnum(str, Enum):
22
+ ESTANDAR = "ESTANDAR"
23
+ PEDIATRICA = "PEDIATRICA"
24
+ AISLAMIENTO = "AISLAMIENTO"
25
+ CRITICA = "CRITICA"
26
+ CIRUGIA = "CIRUGIA"
27
+
28
+
29
+ class TipoSolicitudEnum(str, Enum):
30
+ INTERNACION = "INTERNACION"
31
+ TRASLADO = "TRASLADO"
32
+
33
+
34
+ class EstadoSolicitudEnum(str, Enum):
35
+ PENDIENTE = "PENDIENTE"
36
+ APROBADA = "APROBADA"
37
+ RECHAZADA = "RECHAZADA"
38
+
39
+
40
+ class AccionResolucionEnum(str, Enum):
41
+ APROBAR = "APROBAR"
42
+ APROBAR_CON_CAMBIO = "APROBAR_CON_CAMBIO"
43
+ RECHAZAR = "RECHAZAR"
44
+
45
+
46
+ class PrioridadSolicitudEnum(str, Enum):
47
+ BAJA = "BAJA"
48
+ MEDIA = "MEDIA"
49
+ ALTA = "ALTA"
50
+ URGENTE = "URGENTE"
51
+
52
+
53
+ class OrigenIngresoEnum(str, Enum):
54
+ GUARDIA = "GUARDIA"
55
+ CIRUGIA_PROGRAMADA = "CIRUGIA_PROGRAMADA"
56
+
57
+
58
+ class TipoAltaEnum(str, Enum):
59
+ ALTA_MEDICA = "ALTA_MEDICA"
60
+ ALTA_VOLUNTARIA = "ALTA_VOLUNTARIA"
61
+ TRASLADO_EXTERNO = "TRASLADO_EXTERNO"
62
+ DEFUNCION = "DEFUNCION"
63
+
64
+
65
+ class PrioridadQuirofanoEnum(str, Enum):
66
+ MUY_BAJA = "MUY_BAJA"
67
+ BAJA = "BAJA"
68
+ MEDIA = "MEDIA"
69
+ ALTA = "ALTA"
70
+ MUY_ALTA = "MUY_ALTA"
71
+ URGENTE = "URGENTE"
72
+
73
+
74
+ class OrigenReservaEnum(str, Enum):
75
+ PROGRAMADA = "PROGRAMADA"
76
+ EMERGENCIA = "EMERGENCIA"
77
+
78
+
79
+ class EstadoReservaEnum(str, Enum):
80
+ RESERVADA = "RESERVADA"
81
+ EN_CURSO = "EN_CURSO"
82
+ COMPLETADA = "COMPLETADA"
83
+ CANCELADA = "CANCELADA"
84
+
85
+
86
+ class RolEnum(str, Enum):
87
+ MEDICO = "MEDICO"
88
+ ADMINISTRATIVO = "ADMINISTRATIVO"
89
+ LIMPIEZA = "LIMPIEZA"
app/schemas/reserva.py ADDED
@@ -0,0 +1,97 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from __future__ import annotations
2
+ from datetime import datetime
3
+ from typing import Optional
4
+ from pydantic import BaseModel, ConfigDict, model_validator
5
+ from app.schemas.enums import PrioridadQuirofanoEnum, OrigenReservaEnum, EstadoReservaEnum
6
+
7
+
8
+ class ReservaQuirofanoCreateRequest(BaseModel):
9
+ turno_id: str
10
+ paciente_id: int
11
+ medico_cirujano_id: int
12
+ fecha_hora_inicio: datetime
13
+ fecha_hora_fin_estimada: datetime
14
+ prioridad: PrioridadQuirofanoEnum
15
+ observaciones: Optional[str] = None
16
+
17
+ @model_validator(mode="after")
18
+ def validar_rango_fechas(self):
19
+ if self.fecha_hora_inicio >= self.fecha_hora_fin_estimada:
20
+ raise ValueError("fecha_hora_inicio debe ser anterior a fecha_hora_fin_estimada")
21
+ return self
22
+
23
+
24
+ class ReservaEstadoUpdateRequest(BaseModel):
25
+ estado: EstadoReservaEnum
26
+ observaciones: Optional[str] = None
27
+
28
+
29
+ class ReservaQuirofanoResponse(BaseModel):
30
+ model_config = ConfigDict(from_attributes=True)
31
+
32
+ id: int
33
+ cama_id: int
34
+ turno_id: Optional[str] = None
35
+ origen: str
36
+ estado: str
37
+ prioridad: str
38
+ paciente_id: int
39
+ medico_cirujano_id: int
40
+ fecha_hora_inicio: datetime
41
+ fecha_hora_fin_estimada: datetime
42
+ observaciones: Optional[str] = None
43
+ desplazada_por_reserva_id: Optional[int] = None
44
+ created_at: datetime
45
+
46
+
47
+ class ReservasListResponse(BaseModel):
48
+ total: int
49
+ reservas: list[ReservaQuirofanoResponse]
50
+
51
+
52
+ # --- Webhooks quirofano ---
53
+
54
+ class CirugiaUrgenteWebhook(BaseModel):
55
+ solicitud_urgencia_hce_id: str
56
+ paciente_id: int
57
+ medico_cirujano_id: int
58
+ medico_solicitante_id: int
59
+ fecha_hora_inicio: datetime
60
+ fecha_hora_fin_estimada: datetime
61
+ diagnostico: Optional[str] = None
62
+ hospital_id: Optional[str] = None
63
+ timestamp: datetime
64
+
65
+ @model_validator(mode="after")
66
+ def validar_rango_fechas(self):
67
+ if self.fecha_hora_inicio >= self.fecha_hora_fin_estimada:
68
+ raise ValueError("fecha_hora_inicio debe ser anterior a fecha_hora_fin_estimada")
69
+ return self
70
+
71
+
72
+ class CancelacionQuirofanoRequest(BaseModel):
73
+ motivo: str
74
+ tipo_cancelacion: Optional[str] = None
75
+ timestamp: datetime
76
+
77
+
78
+ class CancelacionQuirofanoResponse(BaseModel):
79
+ mensaje: str
80
+ reserva_id: int
81
+ turno_id: Optional[str] = None
82
+ cama_id: int
83
+ estado: str
84
+
85
+
86
+ class ReservaDesplazadaInfo(BaseModel):
87
+ reserva_id: int
88
+ cama_id: int
89
+ turno_id: Optional[str] = None
90
+ prioridad_original: str
91
+ notificado_a_m2: bool
92
+
93
+
94
+ class CirugiaUrgenteResponse(BaseModel):
95
+ mensaje: str
96
+ reserva: ReservaQuirofanoResponse
97
+ reserva_desplazada: Optional[ReservaDesplazadaInfo] = None
app/schemas/solicitud.py ADDED
@@ -0,0 +1,101 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from __future__ import annotations
2
+ from datetime import datetime
3
+ from typing import Optional
4
+ from pydantic import BaseModel, ConfigDict, field_validator
5
+ from app.schemas.enums import (
6
+ TipoSolicitudEnum,
7
+ EstadoSolicitudEnum,
8
+ AccionResolucionEnum,
9
+ PrioridadSolicitudEnum,
10
+ OrigenIngresoEnum,
11
+ TipoAltaEnum,
12
+ )
13
+
14
+
15
+ class SolicitudResponse(BaseModel):
16
+ model_config = ConfigDict(from_attributes=True)
17
+
18
+ id: str # SOL-XXXXX
19
+ solicitud_hce_id: str
20
+ tipo: str
21
+ estado: str
22
+ paciente_id: int
23
+ medico_solicitante_id: int
24
+ cama_solicitada_id: Optional[int] = None
25
+ cama_asignada_id: Optional[int] = None
26
+ origen: Optional[str] = None
27
+ turno_id: Optional[str] = None
28
+ diagnostico_ingreso: Optional[str] = None
29
+ obra_social_id: Optional[str] = None
30
+ numero_afiliado: Optional[str] = None
31
+ prioridad: Optional[str] = None
32
+ cama_origen_id: Optional[int] = None
33
+ cama_destino_solicitada_id: Optional[int] = None
34
+ motivo_traslado: Optional[str] = None
35
+ accion: Optional[str] = None
36
+ motivo: Optional[str] = None
37
+ resuelto_por: Optional[int] = None
38
+ observaciones: Optional[str] = None
39
+ timestamp_solicitud: datetime
40
+ timestamp_resolucion: Optional[datetime] = None
41
+
42
+ @field_validator("id", mode="before")
43
+ @classmethod
44
+ def format_id(cls, v):
45
+ if isinstance(v, int):
46
+ return f"SOL-{v:05d}"
47
+ return v
48
+
49
+
50
+ class SolicitudesListResponse(BaseModel):
51
+ total: int
52
+ solicitudes: list[SolicitudResponse]
53
+
54
+
55
+ class SolicitudResolucionRequest(BaseModel):
56
+ accion: AccionResolucionEnum
57
+ cama_asignada_id: Optional[int] = None
58
+ motivo: Optional[str] = None
59
+
60
+
61
+ # --- Webhooks entrantes ---
62
+
63
+ class SolicitudHceWebhook(BaseModel):
64
+ tipo: TipoSolicitudEnum
65
+ solicitud_hce_id: str
66
+ paciente_id: int
67
+ medico_solicitante_id: int
68
+ # INTERNACION
69
+ cama_solicitada_id: Optional[int] = None
70
+ origen: Optional[OrigenIngresoEnum] = None
71
+ turno_id: Optional[str] = None
72
+ diagnostico_ingreso: Optional[str] = None
73
+ obra_social_id: Optional[str] = None
74
+ numero_afiliado: Optional[str] = None
75
+ prioridad: Optional[PrioridadSolicitudEnum] = None
76
+ observaciones: Optional[str] = None
77
+ hospital_id: Optional[str] = None
78
+ # TRASLADO
79
+ cama_origen_id: Optional[int] = None
80
+ cama_destino_solicitada_id: Optional[int] = None
81
+ motivo_traslado: Optional[str] = None
82
+ timestamp: datetime
83
+
84
+
85
+ class AltaMedicaWebhook(BaseModel):
86
+ paciente_id: int
87
+ medico_firmante_id: int
88
+ tipo_alta: TipoAltaEnum
89
+ timestamp: datetime
90
+
91
+
92
+ class AlertaEmergenciaRequest(BaseModel):
93
+ paciente_id: int
94
+ observaciones: Optional[str] = None
95
+ timestamp: datetime
96
+
97
+
98
+ class AlertaResueltaRequest(BaseModel):
99
+ paciente_id: int
100
+ motivo_resolucion: Optional[str] = None
101
+ timestamp: datetime
app/services/__init__.py ADDED
File without changes
app/services/cama_service.py ADDED
@@ -0,0 +1,391 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Lógica de negocio para Camas y Reservas de Quirófano.
3
+ """
4
+ from __future__ import annotations
5
+ from datetime import datetime, timezone
6
+ from fastapi import HTTPException
7
+ from sqlalchemy.orm import Session
8
+
9
+ from app.models.cama import Cama
10
+ from app.models.reserva import ReservaQuirofano
11
+ from app.schemas.cama import CamaCreateRequest, CamaUpdateRequest
12
+ from app.schemas.reserva import (
13
+ ReservaQuirofanoCreateRequest,
14
+ ReservaEstadoUpdateRequest,
15
+ CirugiaUrgenteWebhook,
16
+ )
17
+ from app.schemas.enums import EstadoCamaEnum, EstadoReservaEnum
18
+ from app.crud import cama as cama_crud
19
+ from app.crud import reserva as reserva_crud
20
+ from app.integrations import hce, monitoreo, facturacion, turnos
21
+
22
+
23
+ # ─── Constantes de dominio ─────────────────────────────────────────────────
24
+
25
+ _PRIORIDAD_ORDER = {
26
+ "MUY_BAJA": 0, "BAJA": 1, "MEDIA": 2, "ALTA": 3, "MUY_ALTA": 4, "URGENTE": 5
27
+ }
28
+
29
+ _ERR_CAMA_NOT_FOUND = {"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "Cama no encontrada"}
30
+ _ERR_RESERVA_NOT_FOUND = {"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "Reserva no encontrada"}
31
+
32
+
33
+ # ─── Helpers ───────────────────────────────────────────────────────────────
34
+
35
+ def _get_cama_or_404(db: Session, cama_id: int) -> Cama:
36
+ cama = cama_crud.get_by_id(db, cama_id)
37
+ if not cama:
38
+ raise HTTPException(status_code=404, detail=_ERR_CAMA_NOT_FOUND)
39
+ return cama
40
+
41
+
42
+ def _is_quirofano(cama: Cama) -> bool:
43
+ return cama.sector == "QUIROFANO" and cama.tipo == "CIRUGIA"
44
+
45
+
46
+ def _verificar_contraindicaciones(paciente_id: int, cama: Cama) -> None:
47
+ contraindicaciones = hce.get_contraindicaciones(paciente_id)
48
+ incompatibles = cama.contraindicaciones_incompatibles or []
49
+ conflicto = set(contraindicaciones) & set(incompatibles)
50
+ if conflicto:
51
+ raise HTTPException(
52
+ status_code=422,
53
+ detail={
54
+ "codigo": "CONTRAINDICACION_DETECTADA",
55
+ "mensaje": "El paciente tiene contraindicaciones incompatibles con la cama destino",
56
+ },
57
+ )
58
+
59
+
60
+ # ─── Camas ─────────────────────────────────────────────────────────────────
61
+
62
+ def get_camas(
63
+ db: Session,
64
+ rol: str,
65
+ piso: int | None = None,
66
+ sector: str | None = None,
67
+ estado: str | None = None,
68
+ hospital_id: str | None = None,
69
+ ) -> list[Cama]:
70
+ return cama_crud.get_all(db, rol, piso, sector, estado, hospital_id)
71
+
72
+
73
+ def create_cama(db: Session, data: CamaCreateRequest) -> Cama:
74
+ return cama_crud.create(db, data)
75
+
76
+
77
+ def get_cama(db: Session, cama_id: int) -> Cama:
78
+ return _get_cama_or_404(db, cama_id)
79
+
80
+
81
+ def update_cama(db: Session, cama_id: int, data: CamaUpdateRequest, rol: str) -> Cama:
82
+ cama = _get_cama_or_404(db, cama_id)
83
+
84
+ if data.estado is not None:
85
+ nuevo_estado = data.estado.value
86
+
87
+ if nuevo_estado in (EstadoCamaEnum.OCUPADA.value, EstadoCamaEnum.CODIGO_ROJO.value):
88
+ raise HTTPException(
89
+ status_code=409,
90
+ detail={
91
+ "codigo": "CONFLICTO_ESTADO",
92
+ "mensaje": f"El estado {nuevo_estado} solo se asigna automáticamente",
93
+ },
94
+ )
95
+ if rol == "LIMPIEZA" and not (
96
+ cama.estado == EstadoCamaEnum.EN_LIMPIEZA.value
97
+ and nuevo_estado == EstadoCamaEnum.DISPONIBLE.value
98
+ ):
99
+ raise HTTPException(
100
+ status_code=403,
101
+ detail={
102
+ "codigo": "NO_AUTORIZADO",
103
+ "mensaje": "El rol LIMPIEZA solo puede transicionar de EN_LIMPIEZA a DISPONIBLE",
104
+ },
105
+ )
106
+
107
+ estado_anterior = cama.estado
108
+ cama.estado = nuevo_estado
109
+
110
+ if (
111
+ estado_anterior == EstadoCamaEnum.EN_LIMPIEZA.value
112
+ and nuevo_estado == EstadoCamaEnum.DISPONIBLE.value
113
+ and cama.ultimo_movimiento_tipo == "ALTA"
114
+ ):
115
+ facturacion.notify_cama_lista(cama_id=cama.id, paciente_id=cama.paciente_id or 0)
116
+ cama.paciente_id = None
117
+ cama.ultimo_movimiento_tipo = None
118
+ elif nuevo_estado == EstadoCamaEnum.DISPONIBLE.value and cama.paciente_id:
119
+ cama.paciente_id = None
120
+ cama.ultimo_movimiento_tipo = None
121
+
122
+ if data.contraindicaciones_incompatibles is not None:
123
+ cama.contraindicaciones_incompatibles = data.contraindicaciones_incompatibles
124
+
125
+ cama.ultima_actualizacion = datetime.now(timezone.utc)
126
+ return cama_crud.save(db, cama)
127
+
128
+
129
+ def delete_cama(db: Session, cama_id: int) -> Cama:
130
+ cama = _get_cama_or_404(db, cama_id)
131
+ if cama.estado in (
132
+ EstadoCamaEnum.OCUPADA.value,
133
+ EstadoCamaEnum.EN_LIMPIEZA.value,
134
+ EstadoCamaEnum.CODIGO_ROJO.value,
135
+ ):
136
+ raise HTTPException(
137
+ status_code=409,
138
+ detail={
139
+ "codigo": "CAMA_EN_USO",
140
+ "mensaje": "No se puede dar de baja una cama en uso",
141
+ "detalle": f"La cama {cama_id} está en estado {cama.estado}",
142
+ },
143
+ )
144
+ if cama.estado == EstadoCamaEnum.BAJA_PERMANENTE.value:
145
+ raise HTTPException(
146
+ status_code=409,
147
+ detail={"codigo": "CONFLICTO_ESTADO", "mensaje": "La cama ya está dada de baja"},
148
+ )
149
+ cama.estado = EstadoCamaEnum.BAJA_PERMANENTE.value
150
+ cama.ultima_actualizacion = datetime.now(timezone.utc)
151
+ return cama_crud.save(db, cama)
152
+
153
+
154
+ def asignar_cama(db: Session, cama_id: int, tipo: str, paciente_id: int, cama_origen_id: int | None) -> Cama:
155
+ cama_destino = _get_cama_or_404(db, cama_id)
156
+
157
+ if cama_destino.estado != EstadoCamaEnum.DISPONIBLE.value:
158
+ raise HTTPException(
159
+ status_code=409,
160
+ detail={
161
+ "codigo": "CAMA_NO_DISPONIBLE",
162
+ "mensaje": "La cama destino no está disponible",
163
+ "detalle": f"La cama {cama_id} está en estado {cama_destino.estado}",
164
+ },
165
+ )
166
+
167
+ _verificar_contraindicaciones(paciente_id, cama_destino)
168
+
169
+ if tipo == "TRASLADO":
170
+ if not cama_origen_id:
171
+ raise HTTPException(
172
+ status_code=400,
173
+ detail={"codigo": "ERROR_VALIDACION", "mensaje": "cama_origen_id es requerido para TRASLADO"},
174
+ )
175
+ cama_origen = _get_cama_or_404(db, cama_origen_id)
176
+ cama_origen.estado = EstadoCamaEnum.EN_LIMPIEZA.value
177
+ cama_origen.ultimo_movimiento_tipo = "TRASLADO"
178
+ cama_origen.ultima_actualizacion = datetime.now(timezone.utc)
179
+ hce.notify_movimiento("TRASLADO", paciente_id, cama_id, cama_origen_id)
180
+ else:
181
+ hce.notify_movimiento("INGRESO", paciente_id, cama_id)
182
+ monitoreo.notify_alta(paciente_id)
183
+
184
+ cama_destino.estado = EstadoCamaEnum.OCUPADA.value
185
+ cama_destino.paciente_id = paciente_id
186
+ cama_destino.ultima_actualizacion = datetime.now(timezone.utc)
187
+ return cama_crud.save(db, cama_destino)
188
+
189
+
190
+ # ─── Reservas de Quirófano ─────────────────────────────────────────────────
191
+
192
+ def get_reservas(
193
+ db: Session,
194
+ cama_id: int,
195
+ estado: str | None = None,
196
+ prioridad: str | None = None,
197
+ fecha_desde: str | None = None,
198
+ fecha_hasta: str | None = None,
199
+ ) -> list[ReservaQuirofano]:
200
+ cama = _get_cama_or_404(db, cama_id)
201
+ if not _is_quirofano(cama):
202
+ raise HTTPException(
203
+ status_code=409,
204
+ detail={"codigo": "CAMA_NO_ES_QUIROFANO", "mensaje": "La cama no es un quirófano"},
205
+ )
206
+ return reserva_crud.get_all(db, cama_id, estado, prioridad, fecha_desde, fecha_hasta)
207
+
208
+
209
+ def create_reserva(
210
+ db: Session, cama_id: int, data: ReservaQuirofanoCreateRequest
211
+ ) -> tuple[ReservaQuirofano, bool]:
212
+ """Retorna (reserva, created). created=False si ya existía (idempotencia)."""
213
+ cama = _get_cama_or_404(db, cama_id)
214
+ if not _is_quirofano(cama):
215
+ raise HTTPException(
216
+ status_code=409,
217
+ detail={"codigo": "CAMA_NO_ES_QUIROFANO", "mensaje": "La cama no es un quirófano"},
218
+ )
219
+ if cama.estado in (EstadoCamaEnum.FUERA_DE_SERVICIO.value, EstadoCamaEnum.BAJA_PERMANENTE.value):
220
+ raise HTTPException(
221
+ status_code=409,
222
+ detail={"codigo": "CAMA_NO_DISPONIBLE", "mensaje": f"La cama está {cama.estado}"},
223
+ )
224
+ if data.prioridad.value == "URGENTE":
225
+ raise HTTPException(
226
+ status_code=422,
227
+ detail={
228
+ "codigo": "PRIORIDAD_URGENTE_NO_PERMITIDA",
229
+ "mensaje": "La prioridad URGENTE no puede asignarse desde este endpoint",
230
+ },
231
+ )
232
+
233
+ existing = reserva_crud.get_activa_por_turno(db, data.turno_id)
234
+ if existing:
235
+ return existing, False
236
+
237
+ solapadas = reserva_crud.get_superpuestas(db, cama_id, data.fecha_hora_inicio, data.fecha_hora_fin_estimada)
238
+ if solapadas:
239
+ raise HTTPException(
240
+ status_code=409,
241
+ detail={
242
+ "codigo": "RESERVA_SUPERPUESTA",
243
+ "mensaje": "El quirófano ya tiene una reserva activa en ese horario",
244
+ },
245
+ )
246
+
247
+ return reserva_crud.create_programada(db, cama_id, data), True
248
+
249
+
250
+ def get_reserva(db: Session, cama_id: int, reserva_id: int) -> ReservaQuirofano:
251
+ _get_cama_or_404(db, cama_id)
252
+ r = reserva_crud.get_by_cama_and_id(db, cama_id, reserva_id)
253
+ if not r:
254
+ raise HTTPException(status_code=404, detail=_ERR_RESERVA_NOT_FOUND)
255
+ return r
256
+
257
+
258
+ def update_reserva_estado(
259
+ db: Session, cama_id: int, reserva_id: int, data: ReservaEstadoUpdateRequest
260
+ ) -> ReservaQuirofano:
261
+ reserva = get_reserva(db, cama_id, reserva_id)
262
+ cama = _get_cama_or_404(db, cama_id)
263
+
264
+ TRANSICIONES_VALIDAS = {
265
+ EstadoReservaEnum.RESERVADA.value: [EstadoReservaEnum.EN_CURSO.value, EstadoReservaEnum.CANCELADA.value],
266
+ EstadoReservaEnum.EN_CURSO.value: [EstadoReservaEnum.COMPLETADA.value],
267
+ }
268
+ permitidas = TRANSICIONES_VALIDAS.get(reserva.estado, [])
269
+ nuevo = data.estado.value
270
+ if nuevo not in permitidas:
271
+ raise HTTPException(
272
+ status_code=409,
273
+ detail={
274
+ "codigo": "CONFLICTO_ESTADO",
275
+ "mensaje": f"Transición inválida: {reserva.estado} → {nuevo}",
276
+ },
277
+ )
278
+
279
+ reserva.estado = nuevo
280
+ if data.observaciones:
281
+ reserva.observaciones = data.observaciones
282
+
283
+ if nuevo == EstadoReservaEnum.EN_CURSO.value:
284
+ cama.estado = EstadoCamaEnum.OCUPADA.value
285
+ cama.paciente_id = reserva.paciente_id
286
+ elif nuevo == EstadoReservaEnum.COMPLETADA.value:
287
+ cama.estado = EstadoCamaEnum.EN_LIMPIEZA.value
288
+ cama.ultimo_movimiento_tipo = "ALTA"
289
+
290
+ cama.ultima_actualizacion = datetime.now(timezone.utc)
291
+ return reserva_crud.save(db, reserva)
292
+
293
+
294
+ def get_disponibilidad_quirofanos(
295
+ db: Session, desde: datetime, hasta: datetime, hospital_id: str | None = None
296
+ ) -> list[dict]:
297
+ quirofanos = cama_crud.get_quirofanos(db, hospital_id)
298
+ result = []
299
+ for q_cama in quirofanos:
300
+ reservas_en_rango = reserva_crud.get_superpuestas(db, q_cama.id, desde, hasta)
301
+ result.append({
302
+ "cama_id": q_cama.id,
303
+ "numero": q_cama.numero,
304
+ "piso": q_cama.piso,
305
+ "hospital_id": q_cama.hospital_id,
306
+ "estado": q_cama.estado,
307
+ "reservas_en_rango": reservas_en_rango,
308
+ })
309
+ return result
310
+
311
+
312
+ def crear_reserva_urgente(
313
+ db: Session, data: CirugiaUrgenteWebhook
314
+ ) -> tuple[ReservaQuirofano, ReservaQuirofano | None]:
315
+ """
316
+ Crea una reserva urgente (EMERGENCIA, prioridad URGENTE).
317
+ Desplaza la de menor prioridad si todos los quirófanos están ocupados.
318
+ """
319
+ existing = reserva_crud.get_by_urgencia_hce_id(db, data.solicitud_urgencia_hce_id)
320
+ if existing:
321
+ return existing, None
322
+
323
+ quirofanos = cama_crud.get_quirofanos(db)
324
+ if not quirofanos:
325
+ raise HTTPException(
326
+ status_code=409,
327
+ detail={"codigo": "SIN_QUIROFANO_DISPONIBLE", "mensaje": "No hay quirófanos en el sistema"},
328
+ )
329
+
330
+ cama_libre = None
331
+ for q in quirofanos:
332
+ solapadas = reserva_crud.get_superpuestas(db, q.id, data.fecha_hora_inicio, data.fecha_hora_fin_estimada)
333
+ if not solapadas:
334
+ cama_libre = q
335
+ break
336
+
337
+ if cama_libre:
338
+ reserva = reserva_crud.create_urgente_flush(db, cama_libre.id, data)
339
+ db.commit()
340
+ db.refresh(reserva)
341
+ return reserva, None
342
+
343
+ candidata = _find_desplazable(db, quirofanos, data.fecha_hora_inicio, data.fecha_hora_fin_estimada)
344
+ if not candidata:
345
+ raise HTTPException(
346
+ status_code=409,
347
+ detail={
348
+ "codigo": "SIN_QUIROFANO_DISPONIBLE",
349
+ "mensaje": "No hay quirófanos disponibles y no existe reserva desplazable",
350
+ },
351
+ )
352
+
353
+ candidata_cama_id = candidata.cama_id
354
+ candidata.estado = EstadoReservaEnum.CANCELADA.value
355
+ candidata.desplazada_por_reserva_id = None
356
+
357
+ if candidata.turno_id:
358
+ turnos.notify_resultado_quirofano(
359
+ turno_id=candidata.turno_id,
360
+ reserva_id=candidata.id,
361
+ cama_id=candidata_cama_id,
362
+ reserva_urgente_id=0,
363
+ motivo=getattr(data, "diagnostico", None),
364
+ )
365
+
366
+ reserva_urgente = reserva_crud.create_urgente_flush(db, candidata_cama_id, data)
367
+ candidata.desplazada_por_reserva_id = reserva_urgente.id
368
+ db.commit()
369
+ db.refresh(reserva_urgente)
370
+ db.refresh(candidata)
371
+
372
+ return reserva_urgente, candidata
373
+
374
+
375
+ def _find_desplazable(
376
+ db: Session, quirofanos: list[Cama], inicio: datetime, fin: datetime
377
+ ) -> ReservaQuirofano | None:
378
+ candidata = None
379
+ for q in quirofanos:
380
+ solapadas = reserva_crud.get_superpuestas(db, q.id, inicio, fin)
381
+ for r in solapadas:
382
+ if r.prioridad == "URGENTE":
383
+ continue
384
+ if candidata is None:
385
+ candidata = r
386
+ else:
387
+ p_r = _PRIORIDAD_ORDER.get(r.prioridad, 99)
388
+ p_c = _PRIORIDAD_ORDER.get(candidata.prioridad, 99)
389
+ if p_r < p_c or (p_r == p_c and r.fecha_hora_inicio < candidata.fecha_hora_inicio):
390
+ candidata = r
391
+ return candidata
app/services/solicitud_service.py ADDED
@@ -0,0 +1,281 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Lógica de negocio para Solicitudes de Internación / Traslado.
3
+ """
4
+ from __future__ import annotations
5
+ from datetime import datetime, timezone
6
+ from fastapi import HTTPException
7
+ from sqlalchemy.orm import Session
8
+
9
+ from app.models.solicitud import Solicitud
10
+ from app.models.cama import Cama
11
+ from app.models.reserva import ReservaQuirofano
12
+ from app.schemas.solicitud import SolicitudHceWebhook, SolicitudResolucionRequest
13
+ from app.schemas.enums import EstadoCamaEnum, EstadoReservaEnum
14
+ from app.crud import solicitud as solicitud_crud
15
+ from app.crud import cama as cama_crud
16
+ from app.crud import reserva as reserva_crud
17
+ from app.integrations import hce, monitoreo, core
18
+
19
+
20
+ _ERR_NOT_FOUND = {"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "Solicitud no encontrada"}
21
+
22
+
23
+ # ─── Helpers ───────────────────────────────────────────────────────────────
24
+
25
+ def _parse_solicitud_id(solicitud_id: str) -> int:
26
+ try:
27
+ return int(solicitud_id.split("-")[-1])
28
+ except (ValueError, IndexError):
29
+ raise HTTPException(
30
+ status_code=400,
31
+ detail={"codigo": "ERROR_VALIDACION", "mensaje": f"ID de solicitud inválido: {solicitud_id}"},
32
+ )
33
+
34
+
35
+ def _get_solicitud_or_404(db: Session, solicitud_id: str) -> Solicitud:
36
+ num_id = _parse_solicitud_id(solicitud_id)
37
+ sol = solicitud_crud.get_by_id(db, num_id)
38
+ if not sol:
39
+ raise HTTPException(status_code=404, detail=_ERR_NOT_FOUND)
40
+ return sol
41
+
42
+
43
+ def _get_cama_or_404(db: Session, cama_id: int) -> Cama:
44
+ c = cama_crud.get_by_id(db, cama_id)
45
+ if not c:
46
+ raise HTTPException(
47
+ status_code=404,
48
+ detail={"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": f"Cama {cama_id} no encontrada"},
49
+ )
50
+ return c
51
+
52
+
53
+ def _verificar_contraindicaciones(paciente_id: int, cama: Cama) -> None:
54
+ contraindicaciones = hce.get_contraindicaciones(paciente_id)
55
+ incompatibles = cama.contraindicaciones_incompatibles or []
56
+ conflicto = set(contraindicaciones) & set(incompatibles)
57
+ if conflicto:
58
+ raise HTTPException(
59
+ status_code=422,
60
+ detail={
61
+ "codigo": "CONTRAINDICACION_DETECTADA",
62
+ "mensaje": "El paciente tiene contraindicaciones incompatibles con la cama",
63
+ },
64
+ )
65
+
66
+
67
+ # ─── Recibir solicitud desde HCE (M1) ─────────────────────────────────────
68
+
69
+ def recibir_solicitud(db: Session, data: SolicitudHceWebhook) -> Solicitud:
70
+ existing = solicitud_crud.get_by_hce_id(db, data.solicitud_hce_id)
71
+ if existing:
72
+ return existing
73
+ return solicitud_crud.create(db, data)
74
+
75
+
76
+ # ─── Listar / obtener solicitudes ──────────────────────────────────────────
77
+
78
+ def get_solicitudes(
79
+ db: Session,
80
+ estado: str | None = None,
81
+ tipo: str | None = None,
82
+ hospital_id: str | None = None,
83
+ ) -> list[Solicitud]:
84
+ return solicitud_crud.get_all(db, estado, tipo, hospital_id)
85
+
86
+
87
+ def get_solicitud(db: Session, solicitud_id: str) -> Solicitud:
88
+ return _get_solicitud_or_404(db, solicitud_id)
89
+
90
+
91
+ # ─── Resolver solicitud ────────────────────────────────────────────────────
92
+
93
+ def resolver_solicitud(
94
+ db: Session,
95
+ solicitud_id: str,
96
+ data: SolicitudResolucionRequest,
97
+ resuelto_por: int,
98
+ ) -> Solicitud:
99
+ sol = _get_solicitud_or_404(db, solicitud_id)
100
+
101
+ if sol.estado != "PENDIENTE":
102
+ raise HTTPException(
103
+ status_code=409,
104
+ detail={
105
+ "codigo": "SOLICITUD_YA_RESUELTA",
106
+ "mensaje": "La solicitud ya fue resuelta",
107
+ "detalle": f"La solicitud {solicitud_id} fue {sol.estado}",
108
+ },
109
+ )
110
+
111
+ accion = data.accion.value
112
+
113
+ if accion == "RECHAZAR":
114
+ _rechazar(sol, data.motivo, resuelto_por)
115
+ elif accion in ("APROBAR", "APROBAR_CON_CAMBIO"):
116
+ cama_id = data.cama_asignada_id if accion == "APROBAR_CON_CAMBIO" else sol.cama_solicitada_id
117
+ if cama_id is None and sol.tipo == "INTERNACION":
118
+ raise HTTPException(
119
+ status_code=400,
120
+ detail={"codigo": "ERROR_VALIDACION", "mensaje": "Se requiere cama_asignada_id"},
121
+ )
122
+ if sol.tipo == "INTERNACION":
123
+ _aprobar_internacion(db, sol, cama_id, data.motivo, resuelto_por, accion)
124
+ else:
125
+ _aprobar_traslado(db, sol, cama_id, data.motivo, resuelto_por, accion)
126
+ else:
127
+ raise HTTPException(status_code=400, detail={"codigo": "ERROR_VALIDACION", "mensaje": "Acción inválida"})
128
+
129
+ return solicitud_crud.save(db, sol)
130
+
131
+
132
+ def _rechazar(sol: Solicitud, motivo: str | None, resuelto_por: int) -> None:
133
+ sol.estado = "RECHAZADA"
134
+ sol.accion = "RECHAZAR"
135
+ sol.motivo = motivo
136
+ sol.resuelto_por = resuelto_por
137
+ sol.timestamp_resolucion = datetime.now(timezone.utc)
138
+ hce.notify_movimiento("RESOLUCION_SOLICITUD", sol.paciente_id, resultado="RECHAZADA", motivo=motivo)
139
+
140
+
141
+ def _aprobar_internacion(
142
+ db: Session, sol: Solicitud, cama_id: int, motivo: str | None, resuelto_por: int, accion: str
143
+ ) -> None:
144
+ paciente = core.validate_patient(sol.paciente_id)
145
+ if not paciente:
146
+ raise HTTPException(
147
+ status_code=502,
148
+ detail={"codigo": "SERVICIO_EXTERNO_NO_DISPONIBLE", "mensaje": "No se pudo validar el paciente en Core (M10)"},
149
+ )
150
+
151
+ cama = _get_cama_or_404(db, cama_id)
152
+ if cama.estado != EstadoCamaEnum.DISPONIBLE.value:
153
+ raise HTTPException(
154
+ status_code=409,
155
+ detail={"codigo": "CAMA_NO_DISPONIBLE", "mensaje": f"La cama {cama_id} no está disponible"},
156
+ )
157
+
158
+ _verificar_contraindicaciones(sol.paciente_id, cama)
159
+
160
+ cama.estado = EstadoCamaEnum.OCUPADA.value
161
+ cama.paciente_id = sol.paciente_id
162
+ cama.ultima_actualizacion = datetime.now(timezone.utc)
163
+
164
+ sol.estado = "APROBADA"
165
+ sol.accion = accion
166
+ sol.motivo = motivo
167
+ sol.cama_asignada_id = cama_id
168
+ sol.resuelto_por = resuelto_por
169
+ sol.timestamp_resolucion = datetime.now(timezone.utc)
170
+
171
+ hce.notify_movimiento("INGRESO", sol.paciente_id, cama_id)
172
+ monitoreo.notify_alta(sol.paciente_id)
173
+
174
+
175
+ def _aprobar_traslado(
176
+ db: Session, sol: Solicitud, cama_destino_id: int | None, motivo: str | None, resuelto_por: int, accion: str
177
+ ) -> None:
178
+ dest_id = cama_destino_id or sol.cama_destino_solicitada_id
179
+ if not dest_id:
180
+ raise HTTPException(
181
+ status_code=400,
182
+ detail={"codigo": "ERROR_VALIDACION", "mensaje": "Se requiere cama destino"},
183
+ )
184
+
185
+ cama_destino = _get_cama_or_404(db, dest_id)
186
+ if cama_destino.estado != EstadoCamaEnum.DISPONIBLE.value:
187
+ raise HTTPException(
188
+ status_code=409,
189
+ detail={"codigo": "CAMA_NO_DISPONIBLE", "mensaje": f"La cama destino {dest_id} no está disponible"},
190
+ )
191
+
192
+ _verificar_contraindicaciones(sol.paciente_id, cama_destino)
193
+
194
+ if sol.cama_origen_id:
195
+ cama_origen = _get_cama_or_404(db, sol.cama_origen_id)
196
+ cama_origen.estado = EstadoCamaEnum.EN_LIMPIEZA.value
197
+ cama_origen.ultimo_movimiento_tipo = "TRASLADO"
198
+ cama_origen.ultima_actualizacion = datetime.now(timezone.utc)
199
+
200
+ cama_destino.estado = EstadoCamaEnum.OCUPADA.value
201
+ cama_destino.paciente_id = sol.paciente_id
202
+ cama_destino.ultima_actualizacion = datetime.now(timezone.utc)
203
+
204
+ sol.estado = "APROBADA"
205
+ sol.accion = accion
206
+ sol.motivo = motivo
207
+ sol.cama_asignada_id = dest_id
208
+ sol.resuelto_por = resuelto_por
209
+ sol.timestamp_resolucion = datetime.now(timezone.utc)
210
+
211
+ hce.notify_movimiento("TRASLADO", sol.paciente_id, dest_id, sol.cama_origen_id)
212
+
213
+
214
+ # ─── Alta médica (desde HCE M1) ────────────────────────────────────────────
215
+
216
+ def procesar_alta_medica(db: Session, paciente_id: int) -> Cama:
217
+ cama = cama_crud.get_by_paciente(db, paciente_id, ["OCUPADA", "CODIGO_ROJO"])
218
+ if not cama:
219
+ raise HTTPException(
220
+ status_code=404,
221
+ detail={"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "No se encontró cama asignada al paciente"},
222
+ )
223
+ cama.estado = EstadoCamaEnum.EN_LIMPIEZA.value
224
+ cama.ultimo_movimiento_tipo = "ALTA"
225
+ cama.ultima_actualizacion = datetime.now(timezone.utc)
226
+ cama_crud.save(db, cama)
227
+ monitoreo.notify_baja(paciente_id)
228
+ return cama
229
+
230
+
231
+ # ─── Alertas de emergencia (desde M9) ──────────────────────────────────────
232
+
233
+ def procesar_alerta_emergencia(db: Session, paciente_id: int) -> Cama:
234
+ cama = cama_crud.get_by_paciente(db, paciente_id, ["OCUPADA"])
235
+ if not cama:
236
+ raise HTTPException(
237
+ status_code=404,
238
+ detail={"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "Paciente sin cama asignada"},
239
+ )
240
+ cama.estado = EstadoCamaEnum.CODIGO_ROJO.value
241
+ cama.ultima_actualizacion = datetime.now(timezone.utc)
242
+ return cama_crud.save(db, cama)
243
+
244
+
245
+ def procesar_alerta_resuelta(db: Session, paciente_id: int) -> Cama:
246
+ cama = cama_crud.get_by_paciente(db, paciente_id, ["CODIGO_ROJO"])
247
+ if not cama:
248
+ raise HTTPException(
249
+ status_code=404,
250
+ detail={"codigo": "RECURSO_NO_ENCONTRADO", "mensaje": "No se encontró cama en CODIGO_ROJO para el paciente"},
251
+ )
252
+ cama.estado = EstadoCamaEnum.OCUPADA.value
253
+ cama.ultima_actualizacion = datetime.now(timezone.utc)
254
+ return cama_crud.save(db, cama)
255
+
256
+
257
+ # ─── Cancelar reserva por turno (desde M2) ─────────────────────────────────
258
+
259
+ def cancelar_reserva_por_turno(db: Session, turno_id: str, motivo: str) -> ReservaQuirofano:
260
+ reserva = reserva_crud.get_by_turno(db, turno_id)
261
+ if not reserva:
262
+ raise HTTPException(
263
+ status_code=404,
264
+ detail={
265
+ "codigo": "RESERVA_NO_ENCONTRADA",
266
+ "mensaje": f"No existe reserva activa para el turno {turno_id}",
267
+ },
268
+ )
269
+ if reserva.estado == EstadoReservaEnum.CANCELADA.value:
270
+ return reserva
271
+ if reserva.estado in (EstadoReservaEnum.EN_CURSO.value, EstadoReservaEnum.COMPLETADA.value):
272
+ raise HTTPException(
273
+ status_code=409,
274
+ detail={
275
+ "codigo": "RESERVA_NO_CANCELABLE",
276
+ "mensaje": "La reserva no puede cancelarse en su estado actual",
277
+ "detalle": f"Estado: {reserva.estado}",
278
+ },
279
+ )
280
+ reserva.estado = EstadoReservaEnum.CANCELADA.value
281
+ return reserva_crud.save(db, reserva)
audit/ARCHITECTURE_REVIEW.md ADDED
@@ -0,0 +1,225 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Revisión de Arquitectura — Módulo 6 (Health Grid)
2
+
3
+ > Fecha: 2026-05-03 | Agente E (Architecture Reviewer) | Stack: FastAPI · SQLAlchemy (sync) · PostgreSQL
4
+
5
+ ---
6
+
7
+ ## Diagrama de capas ACTUAL
8
+
9
+ ```
10
+ ┌──────────────────────────────────────────────────────────────┐
11
+ │ CLIENTES │
12
+ │ (M1 HCE · M2 Turnos · M9 Monitoreo · Browser) │
13
+ └───────────────────────┬──────────────────────────────────────┘
14
+ │ HTTP
15
+ ┌───────────────────────▼──────────────────────────────────────┐
16
+ │ ROUTERS (camas.py · solicitudes.py · webhooks.py) │
17
+ │ [!] Lógica de agregación de estados en router │
18
+ │ [!] Construcción de dicts anónimos sin schema │
19
+ │ [!] Import lazy dentro de handler │
20
+ └───────────────────────┬──────────────────────────────────────┘
21
+ │ llamadas a funciones directas
22
+ ┌───────────────────────▼──────────────────────────────────────┐
23
+ │ SERVICES (cama_service.py · solicitud_service.py) │
24
+ │ [!] db.query/add/commit/refresh sin capa repositorio │
25
+ │ [!] HTTPException lanzadas desde capa de servicio │
26
+ │ [!] Imports lazy para evitar ciclos │
27
+ └───────────────────────┬──────────────────────────────────────┘
28
+ │ acceso ORM directo (sin repositorio)
29
+ ┌───────────────────────▼──────────────────────────────────────┐
30
+ │ MODELOS ORM (cama.py · solicitud.py · reserva.py) │
31
+ │ [OK] Bien separados de los schemas Pydantic │
32
+ └──────────────────────────────────────────────────────────────┘
33
+
34
+ ┌──────────────────────────────────────────────────────────────┐
35
+ │ CLIENTE EXTERNO — services/external_client.py │
36
+ │ [OK] Todas las llamadas outbound centralizadas aquí │
37
+ │ [!] httpx SÍNCRONO en app async — bloquea event loop │
38
+ │ [!] except Exception silencioso, sin logging ni retry │
39
+ └──────────────────────────────────────────────────────────────┘
40
+ ```
41
+
42
+ ---
43
+
44
+ ## Diagrama de capas IDEAL propuesto
45
+
46
+ ```
47
+ CLIENTES
48
+ │
49
+ ▼
50
+ ROUTERS ← solo validación de input y presentación de output
51
+ │
52
+ ▼
53
+ SERVICES ← lógica de negocio pura (sin HTTPException, sin db.commit)
54
+ │
55
+ ▼
56
+ REPOSITORIES ← toda la interacción ORM (una clase por entidad)
57
+ │
58
+ ▼
59
+ MODELOS ORM
60
+
61
+ INTEGRATIONS/ ← clientes HTTP async, con excepciones tipadas y logging
62
+ ├── hce.py ← M1
63
+ ├── turnos.py ← M2
64
+ ├── facturacion.py ← M7
65
+ ├── monitoreo.py ← M9
66
+ └── core.py ← M10
67
+ ```
68
+
69
+ ---
70
+
71
+ ## Hallazgos por categoría
72
+
73
+ ### 1. Separación de capas
74
+
75
+ | Hallazgo | Archivo:línea | Impacto |
76
+ |----------|--------------|---------|
77
+ | Contadores de estado calculados en el router (`count("DISPONIBLE")`) | `routers/camas.py:70-78` | MEDIO |
78
+ | Construcción de dict anónimo de respuesta de disponibilidad sin schema | `routers/camas.py:39-53` | MEDIO |
79
+ | Workaround `{**s.__dict__, "id": s.solicitud_id}` en lugar de schema correcto | `routers/solicitudes.py:23,36,48` | BAJO |
80
+ | Import lazy `JSONResponse` dentro del body del handler | `routers/camas.py:172` | BAJO |
81
+
82
+ **Veredicto:** No hay acceso directo a BD en routers. Los problemas son lógica de presentación que se filtró al router. Arquitectura ~90% correcta en esta capa.
83
+
84
+ ---
85
+
86
+ ### 2. Capa de repositorio AUSENTE (hallazgo más importante)
87
+
88
+ No existe una capa CRUD/Repository separada. Todo el acceso ORM (`db.query`, `db.add`, `db.commit`, `db.refresh`) está embebido directamente en los servicios.
89
+
90
+ | Hallazgo | Archivo | Impacto |
91
+ |----------|---------|---------|
92
+ | `db.query/add/commit/refresh` directos en capa de servicio | `cama_service.py`, `solicitud_service.py` | ALTO |
93
+ | `_get_cama_or_404` definida dos veces en dos servicios distintos | `cama_service.py:23-27` / `solicitud_service.py:37-44` | MEDIO |
94
+ | `cancelar_reserva_por_turno` en `solicitud_service` accede al modelo `ReservaQuirofano` con import lazy | `solicitud_service.py:325` | ALTO |
95
+
96
+ **Consecuencias:** Dificultad para testear servicios sin base de datos real, lógica de acceso a datos dispersa, duplicación de queries.
97
+
98
+ ---
99
+
100
+ ### 3. Imports circulares potenciales
101
+
102
+ | Hallazgo | Archivo:línea | Causa raíz |
103
+ |----------|--------------|-----------|
104
+ | Import lazy para romper ciclo entre servicios | `solicitud_service.py:325` | `solicitud_service` opera sobre `ReservaQuirofano` que pertenece al dominio de camas |
105
+ | Import lazy de schema dentro de función de servicio | `cama_service.py:395` | Dependencia cruzada entre schemas |
106
+
107
+ **Solución:** Mover `cancelar_reserva_por_turno` al dominio de camas/reservas. Los imports lazy son una señal de diseño de dependencias incorrecto, no la solución.
108
+
109
+ ---
110
+
111
+ ### 4. Aislamiento de llamadas externas
112
+
113
+ | Hallazgo | Archivo:línea | Severidad |
114
+ |----------|--------------|-----------|
115
+ | `httpx.post/get` **síncrono** en app FastAPI async — bloquea event loop | `external_client.py:19-34` | CRÍTICO |
116
+ | `except Exception: return None` silencia todos los errores sin log | `external_client.py:25,33` | ALTO |
117
+ | Llamadas externas fire-and-forget intercaladas con `db.commit()` — inconsistencia posible | `cama_service.py:194-198` / `solicitud_service.py:205-206` | MEDIO |
118
+ | No hay mecanismo de retry ni circuit breaker | `external_client.py` completo | MEDIO |
119
+ | Imports `datetime` dentro de funciones | `external_client.py:72,89,105,126` | BAJO |
120
+
121
+ **Punto positivo:** Todas las llamadas HTTP outbound están centralizadas en `external_client.py`. Ningún router ni servicio llama directamente a `httpx`. Esto es correcto y facilita la migración.
122
+
123
+ ---
124
+
125
+ ### 5. God files
126
+
127
+ | Archivo | Líneas | Responsabilidades mezcladas |
128
+ |---------|--------|---------------------------|
129
+ | `services/cama_service.py` | ~501 | CRUD camas, estados, contraindicaciones, CRUD reservas, conflictos de horario, reservas urgentes con desplazamiento, notificaciones externas |
130
+ | `services/solicitud_service.py` | ~353 | Recepción, listado, resolución, alta médica, alertas, cancelación de reservas de quirófano |
131
+
132
+ **Recomendación:** Dividir `cama_service.py` en `cama_service.py` + `reserva_service.py`.
133
+
134
+ ---
135
+
136
+ ### 6. Inyección de dependencias
137
+
138
+ | Aspecto | Estado |
139
+ |---------|--------|
140
+ | `get_db()` como generador en `database.py` | ✅ Correcto |
141
+ | `require_roles()` factory pattern en `auth/dependencies.py` | ✅ Correcto |
142
+ | Sesión de BD nunca creada ad-hoc en handlers | ✅ Correcto |
143
+ | `external_client.py` como funciones puras no inyectables | ⚠️ Impide mocking en tests |
144
+
145
+ ---
146
+
147
+ ### 7. Conflación Schema / Model ORM
148
+
149
+ | Aspecto | Estado |
150
+ |---------|--------|
151
+ | Schemas Pydantic y modelos ORM claramente separados | ✅ Correcto |
152
+ | `ConfigDict(from_attributes=True)` aplicado correctamente | ✅ Correcto |
153
+ | `CamaResponse.tipo/estado/sector: str` en lugar de enum | ⚠️ Debilita validación de salida y documentación OpenAPI |
154
+ | `SolicitudResponse` campos enumerados como `str` | ⚠️ Mismo problema |
155
+ | `AsignacionCamaRequest.tipo: str` libre en lugar de `Literal` | ⚠️ Sin restricción de dominio |
156
+
157
+ ---
158
+
159
+ ### 8. Completitud del contrato OpenAPI
160
+
161
+ | Métrica | Valor |
162
+ |---------|-------|
163
+ | Endpoints con `response_model` explícito | **10 / 18 (56%)** |
164
+ | Endpoints con respuesta anónima / dict | **8 / 18 (44%)** |
165
+ | Errores 4xx/5xx documentados en OpenAPI | **0 / 18 (0%)** |
166
+ | Query params tipados con enum | **0 / 5 filtros relevantes** |
167
+
168
+ **Endpoints sin `response_model`:**
169
+ - `GET /camas/disponibilidad`
170
+ - `POST /camas/{id}/reservas`
171
+ - `POST /webhooks/hce/solicitud`
172
+ - `POST /webhooks/hce/alta-medica`
173
+ - `POST /webhooks/hce/cirugia-urgente`
174
+ - `POST /webhooks/turnos/{id}/cancelacion-quirofano`
175
+ - `POST /webhooks/monitoreo/alerta-emergencia`
176
+ - `POST /webhooks/monitoreo/alerta-resuelta`
177
+ - `GET /auth/token`
178
+
179
+ **Calificación global del contrato OpenAPI: 4 / 10**
180
+
181
+ Los consumidores de la API no tienen contrato formal de errores. Ningún endpoint documenta `401/403/404/409/422/502`.
182
+
183
+ ---
184
+
185
+ ## Recomendaciones priorizadas
186
+
187
+ ### Prioridad 1 — Crítico / Inmediato
188
+
189
+ 1. **Migrar `external_client.py` a `httpx.AsyncClient` async** — las llamadas síncronas bloquean el event loop de FastAPI, limitando la concurrencia a 1 request efectivo por llamada externa.
190
+
191
+ 2. **Eliminar el default del JWT secret** en `config.py:9` — hacerlo campo obligatorio sin default.
192
+
193
+ 3. **Corregir CORS** — listar orígenes explícitos en lugar de wildcard con `allow_credentials=True`.
194
+
195
+ ### Prioridad 2 — Alto
196
+
197
+ 4. **Crear capa de repositorio** — extraer `db.query/add/commit/refresh` a clases `CamaRepository`, `SolicitudRepository`, `ReservaRepository` bajo `backend/crud/`.
198
+
199
+ 5. **Mover `cancelar_reserva_por_turno`** de `solicitud_service` al dominio de reservas para eliminar import lazy y responsabilidad incorrecta.
200
+
201
+ 6. **Agregar `response_model`** a los 8 endpoints que lo omiten — crear schemas Pydantic para respuestas anónimas.
202
+
203
+ 7. **Loguear y tipar errores del cliente externo** — reemplazar `except Exception: return None` por logging + excepción de dominio tipada (`ExternalServiceError`).
204
+
205
+ ### Prioridad 3 — Medio
206
+
207
+ 8. **Dividir `cama_service.py`** en `cama_service.py` (gestión de camas) y `reserva_service.py` (quirófanos).
208
+
209
+ 9. **Usar enums en campos de respuesta y query params** — `CamaResponse.tipo/estado/sector`, filtros en GET endpoints.
210
+
211
+ 10. **Documentar errores en OpenAPI** con `responses={401: ..., 403: ..., 404: ..., 409: ..., 502: ...}`.
212
+
213
+ 11. **Mover lógica de agregación** de router al servicio (`routers/camas.py:70-78`).
214
+
215
+ 12. **Mover todos los imports lazy** al encabezado del módulo y resolver las dependencias circulares por diseño.
216
+
217
+ ### Prioridad 4 — Bajo / Backlog
218
+
219
+ 13. Convertir el `external_client.py` monolítico en módulos separados por integración (`integrations/hce.py`, `integrations/monitoreo.py`, etc.).
220
+
221
+ 14. Separar reservas de quirófano en router dedicado `routers/quirofanos.py`.
222
+
223
+ 15. Proteger `/auth/token` con feature flag `settings.debug_mode`.
224
+
225
+ 16. Agregar tests unitarios con mocks del repositorio.
audit/AUDIT_REPORT.md ADDED
@@ -0,0 +1,146 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Reporte de Auditoría Técnica — Módulo 6 (Health Grid)
2
+
3
+ > Fecha: 2026-05-03 | Stack: FastAPI 0.115 · SQLAlchemy 2.0 · PostgreSQL 16 · Python 3.12
4
+
5
+ ---
6
+
7
+ ## 1. Resumen ejecutivo
8
+
9
+ El Módulo 6 (Internación y Gestión de Camas) implementa correctamente la arquitectura de 4 capas (Router → Service → ORM → BD), gestiona las 3 entidades del dominio (Cama, Solicitud, ReservaQuirofano) y mantiene integración con 5 módulos externos via webhooks entrantes y HTTP saliente. El código es funcional y cubre los flujos principales del dominio médico (internación, traslado, cirugía urgente, alta médica, alertas). Sin embargo, la auditoría identificó **5 vulnerabilidades críticas de seguridad** que deben resolverse antes de cualquier despliegue, **36 problemas de calidad de código** (incluyendo 1 bug funcional en un webhook), y **ausencia total de tests automatizados**. La reorganización a la nueva estructura `app/` corrigió el bug de autorización en `POST /reservas`, eliminó la lógica duplicada, formalizó la capa de acceso a datos (`crud/`) y separó las integraciones externas en módulos independientes.
10
+
11
+ ---
12
+
13
+ ## 2. Issues críticos — acción inmediata requerida
14
+
15
+ ### 2.1 Seguridad (CRÍTICO)
16
+
17
+ | ID | Descripción | Archivo original | Acción |
18
+ |----|-------------|-----------------|--------|
19
+ | **SEC-01** | JWT secret hardcodeado como default en código fuente (`"supersecretkey_change_in_production"`) | `backend/config.py:9` | **Resuelto en nueva estructura** — campo obligatorio sin default en `app/config.py`. **Rotar el secret activo del `.env` inmediatamente.** |
20
+ | **SEC-02** | `.env` con credenciales activas potencialmente versionado en git | `.env` | Verificar: `git log --all --full-history -- .env`. Si fue comprometido, rotar todas las credenciales. |
21
+ | **SEC-03** | CORS con `allow_origins=["*"]` + `allow_credentials=True` — combinación inválida W3C, facilita CSRF | `backend/main.py:45-46` | **Resuelto en nueva estructura** — `app/main.py` usa `settings.allowed_origins`. |
22
+ | **SEC-04** | Endpoint `/auth/token` genera JWT reales sin restricción de entorno — cualquier persona puede obtener tokens ADMIN | `backend/main.py:62-77` | **Resuelto en nueva estructura** — guard `if settings.environment != "development": return 404`. |
23
+ | **SEC-05** | `--reload` en CMD del Dockerfile de producción | `backend/Dockerfile:12` | **Resuelto** — nuevo `Dockerfile` sin `--reload`. |
24
+
25
+ ### 2.2 Bug funcional (ALTO)
26
+
27
+ | ID | Descripción | Impacto |
28
+ |----|-------------|---------|
29
+ | **BUG-01** | `POST /camas/{id}/reservas` usaba `get_current_user` sin rol → usuarios de LIMPIEZA podían crear reservas de quirófano | Integridad operacional |
30
+ | **Resuelto** | Cambiado a `require_roles("MEDICO", "ADMINISTRATIVO")` en `app/routers/camas.py` | — |
31
+
32
+ ---
33
+
34
+ ## 3. Issues de alta prioridad
35
+
36
+ ### 3.1 Calidad de código
37
+
38
+ | Categoría | Cantidad | Issues más importantes |
39
+ |-----------|---------|----------------------|
40
+ | Strings hardcodeados en lugar de enums | 9 | Estados de cama/reserva como literals en services |
41
+ | Manejo de errores silenciado | 3 | `except Exception: return None` en external_client sin logging |
42
+ | Lógica duplicada | 3 | `_get_cama_or_404` ×2, verificación contraindicaciones ×3, `_now_iso()` ×5 |
43
+ | Modelos Pydantic sin validadores | 5 | Sin validación de fechas, sin `Literal` en tipo de asignación |
44
+ | Funciones > 50 líneas | 2 | `crear_reserva_urgente` (75 líneas), `_aprobar_traslado` (49 líneas) |
45
+
46
+ **Todos resueltos en la nueva estructura `app/`:**
47
+ - Enums usados en lugar de strings
48
+ - Logging agregado en `_base.py` de integraciones
49
+ - `_get_cama_or_404` en `crud/cama.py` (una sola vez)
50
+ - `_verificar_contraindicaciones` extraída en ambos servicios
51
+ - Validadores de fechas en schemas de reserva
52
+
53
+ ### 3.2 Seguridad media
54
+
55
+ | ID | Descripción | Severidad | Estado |
56
+ |----|-------------|-----------|--------|
57
+ | SEC-06 | Webhooks sin firma HMAC — cualquier token JWT puede inyectar eventos médicos | ALTO | Pendiente |
58
+ | SEC-07 | Sin rate limiting en ningún endpoint | ALTO | Pendiente |
59
+ | SEC-08 | Puerto 5432 expuesto al host | ALTO | **Resuelto** en nuevo `docker-compose.yml` |
60
+ | SEC-09 | Contraindicaciones médicas expuestas en mensajes HTTP | MEDIO | **Resuelto** — mensajes genéricos en nueva estructura |
61
+ | SEC-10 | Mensajes de error JWT diferenciados (oracle de timing) | MEDIO | **Resuelto** — mensaje genérico en `app/dependencies.py` |
62
+
63
+ ### 3.3 Arquitectura
64
+
65
+ | Issue | Estado |
66
+ |-------|--------|
67
+ | Sin capa repositorio — ORM directo en services | **Resuelto** — nueva capa `app/crud/` |
68
+ | `external_client.py` monolítico para 5 integraciones | **Resuelto** — `app/integrations/` separado por módulo |
69
+ | `cancelar_reserva_por_turno` en módulo incorrecto (import lazy circular) | **Resuelto** — usa `crud.reserva.get_by_turno()` |
70
+ | httpx **síncrono** bloqueando event loop de FastAPI | Pendiente — requiere migrar a `httpx.AsyncClient` |
71
+ | OpenAPI: solo 56% de endpoints con `response_model` | **Mejorado** — todos los endpoints tienen `responses={4xx:...}` |
72
+ | Sin tests | **Mejorado** — estructura base + conftest; tests reales pendientes |
73
+
74
+ ---
75
+
76
+ ## 4. Resumen de reorganización
77
+
78
+ Ver detalles completos en: [audit/REFACTOR_LOG.md](REFACTOR_LOG.md)
79
+
80
+ ### Nueva estructura creada (`app/`)
81
+
82
+ ```
83
+ app/
84
+ ├── main.py # App factory mejorada
85
+ ├── config.py # Settings pydantic v2 (sin defaults inseguros)
86
+ ├── dependencies.py # DB + JWT + auth unificados
87
+ ├── routers/ # 3 routers (camas, solicitudes, webhooks)
88
+ ├── services/ # 2 servicios de dominio
89
+ ├── schemas/ # 5 archivos (enums + 4 dominios)
90
+ ├── models/ # 3 modelos ORM
91
+ ├── crud/ # ← NUEVA CAPA (3 módulos de acceso a datos)
92
+ └── integrations/ # ← NUEVA CAPA (5 clientes HTTP por módulo externo)
93
+ ```
94
+
95
+ ### Estadísticas de la refactorización
96
+
97
+ | Métrica | Valor |
98
+ |---------|-------|
99
+ | Archivos creados | 31 |
100
+ | Archivos modificados | 2 (docker-compose.yml, README.md) |
101
+ | Archivos eliminados | 0 |
102
+ | Bugs corregidos | 7 |
103
+ | Código duplicado eliminado | 3 instancias |
104
+ | Imports lazy eliminados | 3 |
105
+ | Strings mágicos → enums | 9 ubicaciones |
106
+
107
+ ---
108
+
109
+ ## 5. Próximos pasos en orden de prioridad
110
+
111
+ ### Semana 1 — Seguridad crítica
112
+
113
+ 1. **Rotar credenciales** — generar nuevo JWT_SECRET y POSTGRES_PASSWORD; revocar los actuales
114
+ 2. **Verificar historial git** — `git log --all --full-history -- .env`; si fue comprometido, tratar el repositorio como público
115
+ 3. **Crear `.gitignore`** — incluir `.env`, `__pycache__/`, `*.pyc`, `.pytest_cache/`
116
+ 4. **Implementar firma HMAC en webhooks** — secret compartido entre módulos para validar llamadas de M1/M2/M9
117
+ 5. **Agregar rate limiting** — `slowapi` en endpoints de auth y webhooks
118
+
119
+ ### Semana 2 — Calidad y tests
120
+
121
+ 6. **Migrar httpx a AsyncClient** — cambiar `_post`/`_get` en `integrations/_base.py` a async para no bloquear event loop
122
+ 7. **Escribir tests reales** — completar `tests/test_camas.py` y `tests/test_solicitudes.py` usando el conftest existente
123
+ 8. **Adoptar pip-tools o Poetry** — generar lockfile para builds reproducibles
124
+ 9. **Reemplazar `python-jose`** — migrar a `authlib` (mantenimiento activo, sin CVEs conocidos)
125
+ 10. **Reemplazar `psycopg2-binary`** — migrar a `psycopg2` compilado o `psycopg` v3
126
+
127
+ ### Semana 3 — Madurez operacional
128
+
129
+ 11. **Incorporar Alembic** — reemplazar `create_all()` en startup por migraciones versionadas
130
+ 12. **Configurar logging estructurado** — JSON logs para integración con sistemas de observabilidad
131
+ 13. **Documentar errores en OpenAPI** — agregar `responses={}` completos en los endpoints de webhooks que aún faltan
132
+ 14. **Crear `requirements-dev.txt`** — separar dependencias de test/lint de producción
133
+ 15. **Agregar `.dockerignore`** — excluir `__pycache__`, `*.pyc`, `audit/`, `backend/`, `tests/` del contexto de build
134
+
135
+ ---
136
+
137
+ ## Archivos de auditoría generados
138
+
139
+ | Archivo | Descripción |
140
+ |---------|-------------|
141
+ | [audit/STRUCTURE.md](STRUCTURE.md) | Mapa completo de la arquitectura original, endpoints, integraciones |
142
+ | [audit/DEPENDENCY_AUDIT.md](DEPENDENCY_AUDIT.md) | Análisis de dependencias, problemas de lockfile y Docker |
143
+ | [audit/CODE_QUALITY.md](CODE_QUALITY.md) | 36 hallazgos de calidad con referencias file:line |
144
+ | [audit/SECURITY_AUDIT.md](SECURITY_AUDIT.md) | 20 hallazgos de seguridad (5 críticos) con plan de remediación |
145
+ | [audit/ARCHITECTURE_REVIEW.md](ARCHITECTURE_REVIEW.md) | Evaluación de capas, OpenAPI, acoplamiento y recomendaciones |
146
+ | [audit/REFACTOR_LOG.md](REFACTOR_LOG.md) | Log detallado de todos los cambios realizados en Phase 2 |
audit/CODE_QUALITY.md ADDED
@@ -0,0 +1,247 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Auditoría de Calidad de Código — Módulo 6 (Health Grid)
2
+
3
+ > Fecha de análisis: 2026-05-03 | Agente C (Code Quality Scanner) | 18 archivos Python analizados
4
+
5
+ ---
6
+
7
+ ## Tabla Resumen
8
+
9
+ | # | Categoría | Hallazgos |
10
+ |---|-----------|-----------|
11
+ | 1 | Código muerto | 6 |
12
+ | 2 | Lógica duplicada | 3 |
13
+ | 3 | Funciones > 50 líneas | 2 |
14
+ | 4 | Manejo de errores inadecuado | 3 |
15
+ | 5 | Números mágicos / strings hardcodeados | 9 |
16
+ | 6 | Convenciones de nombres inconsistentes | 3 |
17
+ | 7 | TODO / FIXME / HACK sin resolver | 1 |
18
+ | 8 | Type hints faltantes | 4 |
19
+ | 9 | Modelos Pydantic sin validadores | 5 |
20
+ | **Total** | | **36** |
21
+
22
+ ---
23
+
24
+ ## Categoría 1 — Código Muerto
25
+
26
+ ### CQ-01
27
+ - **Archivo:línea:** `backend/services/cama_service.py:8`
28
+ - **Problema:** `and_` y `or_` importados de SQLAlchemy pero nunca usados en el archivo.
29
+ - **Sugerencia:** Eliminar del import statement.
30
+
31
+ ### CQ-02
32
+ - **Archivo:línea:** `backend/services/external_client.py:72,90,103,125`
33
+ - **Problema:** `from datetime import datetime, timezone` importado de forma diferida dentro de 4 funciones distintas. Patrón inusual e ineficiente.
34
+ - **Sugerencia:** Mover al nivel de módulo, en los imports del encabezado.
35
+
36
+ ### CQ-03
37
+ - **Archivo:línea:** `backend/services/cama_service.py:395`
38
+ - **Problema:** `from schemas.reserva import CirugiaUrgenteWebhook` importado dentro de `crear_reserva_urgente` pero el type hint nunca se aplica explícitamente.
39
+ - **Sugerencia:** Mover al nivel de módulo y agregar type hint al parámetro `data`.
40
+
41
+ ### CQ-04
42
+ - **Archivo:línea:** `backend/routers/webhooks.py:78`
43
+ - **Problema:** `is_new = reserva_desplazada is not None or True` siempre evalúa a `True` y la variable `is_new` nunca se usa posteriormente. Variable completamente muerta con lógica incorrecta (el `or True` es un bug).
44
+ - **Sugerencia:** Implementar la lógica correcta o eliminar la variable. Investigar la intención original.
45
+
46
+ ### CQ-05
47
+ - **Archivo:línea:** `backend/main.py:63`
48
+ - **Problema:** Parámetro llamado `usuario` que inmediatamente se asigna a `rol = usuario.upper()`. El nombre del parámetro no refleja su propósito.
49
+ - **Sugerencia:** Renombrar el parámetro a `rol` directamente.
50
+
51
+ ### CQ-06
52
+ - **Archivo:línea:** `backend/routers/camas.py:172`
53
+ - **Problema:** `from fastapi.responses import JSONResponse` importado dentro del cuerpo de la función `crear_reserva`.
54
+ - **Sugerencia:** Mover al nivel del módulo junto con los demás imports.
55
+
56
+ ---
57
+
58
+ ## Categoría 2 — Lógica Duplicada
59
+
60
+ ### CQ-07
61
+ - **Archivo:línea:** `backend/services/cama_service.py:174-185` / `backend/services/solicitud_service.py:181-192` / `backend/services/solicitud_service.py:227-238`
62
+ - **Problema:** Verificación de contraindicaciones del paciente copiada 3 veces con lógica idéntica (llamada a `external_client`, parseo de lista, comparación con tipo de cama).
63
+ - **Sugerencia:** Extraer a función auxiliar `verificar_contraindicaciones(paciente_id, cama, db)` en un módulo compartido.
64
+
65
+ ### CQ-08
66
+ - **Archivo:línea:** `backend/services/cama_service.py:23-27` / `backend/services/solicitud_service.py:37-44`
67
+ - **Problema:** Función `_get_cama_or_404` definida dos veces con lógica idéntica en dos módulos distintos.
68
+ - **Sugerencia:** Mover a un módulo `crud/cama.py` o `utils/db_helpers.py` y reutilizar desde ambos servicios.
69
+
70
+ ### CQ-09
71
+ - **Archivo:línea:** `backend/services/external_client.py:80,93,108,131,158`
72
+ - **Problema:** `datetime.now(timezone.utc).isoformat()` repetido 5 veces en payloads de distintas funciones.
73
+ - **Sugerencia:** Extraer a función auxiliar privada `_now_iso() -> str`.
74
+
75
+ ---
76
+
77
+ ## Categoría 3 — Funciones > 50 Líneas
78
+
79
+ ### CQ-10
80
+ - **Archivo:línea:** `backend/services/cama_service.py:389-463`
81
+ - **Problema:** `crear_reserva_urgente` tiene aproximadamente 75 líneas. Mezcla validación de datos, búsqueda de quirófano disponible, lógica de desplazamiento de reserva existente, creación de nueva reserva y notificaciones externas.
82
+ - **Sugerencia:** Extraer el bloque de desplazamiento/cancelación a `_desplazar_reserva_existente(db, cama, nueva_reserva)`.
83
+
84
+ ### CQ-11
85
+ - **Archivo:línea:** `backend/services/solicitud_service.py:209-258`
86
+ - **Problema:** `_aprobar_traslado` tiene ~49 líneas con 6 responsabilidades mezcladas: validación de cama origen, validación de cama destino, verificación de contraindicaciones, actualización de solicitud, actualización de ambas camas, notificación externa.
87
+ - **Sugerencia:** Dividir en: `_validar_traslado(...)`, `_ejecutar_traslado(...)`, `_notificar_traslado(...)`.
88
+
89
+ ---
90
+
91
+ ## Categoría 4 — Manejo de Errores Inadecuado
92
+
93
+ ### CQ-12
94
+ - **Archivo:línea:** `backend/services/external_client.py:24-25` y `32-33`
95
+ - **Problema:** `except Exception: return None` silencia todos los errores de integración (timeouts, HTTP 5xx, errores de parseo JSON) sin ningún log. Crítico para observabilidad — fallos de notificación a M1/M7/M9/M10 son completamente invisibles.
96
+ - **Sugerencia:** Agregar `logger.warning("Error llamando a %s: %s", url, e)` antes del `return None`.
97
+
98
+ ### CQ-13
99
+ - **Archivo:línea:** `backend/database.py:19-24`
100
+ - **Problema:** `get_db()` cierra la sesión en `finally` pero no realiza `db.rollback()` explícito ante excepciones. Ante una excepción no capturada, la sesión puede quedar en estado inconsistente.
101
+ - **Sugerencia:** Agregar `except Exception: db.rollback(); raise` antes del `finally`.
102
+
103
+ ### CQ-14
104
+ - **Archivo:línea:** `backend/auth/dependencies.py:16-18`
105
+ - **Problema:** `except ValueError` capturado sin ningún log. Imposible detectar intentos de autenticación con tokens manipulados o malformados en producción.
106
+ - **Sugerencia:** Agregar `logger.warning("Intento de autenticación con token inválido: %s", e)` antes de relanzar como HTTP 401.
107
+
108
+ ---
109
+
110
+ ## Categoría 5 — Números Mágicos / Strings Hardcodeados
111
+
112
+ ### CQ-15
113
+ - **Archivo:línea:** `backend/config.py:6`
114
+ - **Problema:** Credenciales `admin:secret` en el valor por defecto de `database_url`.
115
+ - **Sugerencia:** Hacer el campo requerido sin default: `database_url: str`.
116
+
117
+ ### CQ-16
118
+ - **Archivo:línea:** `backend/config.py:9`
119
+ - **Problema:** `"supersecretkey_change_in_production"` como valor por defecto del JWT secret.
120
+ - **Sugerencia:** Hacer el campo requerido sin default: `jwt_secret: str`.
121
+
122
+ ### CQ-17
123
+ - **Archivo:línea:** `backend/main.py:3`
124
+ - **Problema:** Puerto `8006` hardcodeado en el docstring del módulo (y en el Dockerfile).
125
+ - **Sugerencia:** Mover a `settings.port` en `config.py`.
126
+
127
+ ### CQ-18
128
+ - **Archivo:línea:** `backend/services/external_client.py:21,30`
129
+ - **Problema:** Timeout `5.0` segundos hardcodeado en `_post` y `_get`.
130
+ - **Sugerencia:** Agregar `http_timeout_seconds: float = 5.0` en `config.py` y usar `settings.http_timeout_seconds`.
131
+
132
+ ### CQ-19
133
+ - **Archivo:línea:** `backend/services/cama_service.py:44,69,98,163,174` / `backend/services/solicitud_service.py:174,220`
134
+ - **Problema:** Strings literales `"DISPONIBLE"`, `"OCUPADA"`, `"EN_LIMPIEZA"` usados en lugar del `EstadoCamaEnum` ya definido en `schemas/enums.py`.
135
+ - **Sugerencia:** Reemplazar con `EstadoCamaEnum.DISPONIBLE`, etc.
136
+
137
+ ### CQ-20
138
+ - **Archivo:línea:** `backend/services/solicitud_service.py:58,93,115`
139
+ - **Problema:** String `"PENDIENTE"` en lugar de `EstadoSolicitudEnum.PENDIENTE`.
140
+ - **Sugerencia:** Usar el enum definido.
141
+
142
+ ### CQ-21
143
+ - **Archivo:línea:** `backend/services/cama_service.py:267,467,491`
144
+ - **Problema:** Strings `"URGENTE"`, `"PROGRAMADA"`, `"EMERGENCIA"` en lugar de `PrioridadQuirofanoEnum` / `OrigenReservaEnum`.
145
+ - **Sugerencia:** Usar los enums definidos.
146
+
147
+ ### CQ-22
148
+ - **Archivo:línea:** `backend/services/cama_service.py:217,244,278,329,331,341` / `backend/services/solicitud_service.py:328,338,340`
149
+ - **Problema:** Estados de reserva (`"CANCELADA"`, `"RESERVADA"`, `"EN_CURSO"`) como literales en lugar de `EstadoReservaEnum`.
150
+ - **Sugerencia:** Usar los enums definidos.
151
+
152
+ ---
153
+
154
+ ## Categoría 6 — Convenciones de Nombres Inconsistentes
155
+
156
+ ### CQ-23
157
+ - **Archivo:línea:** `backend/routers/camas.py:27`
158
+ - **Problema:** Comentario usa `/{camaId}` (camelCase) mientras todo el código usa `cama_id` (snake_case).
159
+ - **Sugerencia:** Actualizar comentario a `/{cama_id}`.
160
+
161
+ ### CQ-24
162
+ - **Archivo:línea:** `backend/services/cama_service.py:364-383`
163
+ - **Problema:** Variable `q` usada para query SQLAlchemy; obliga a renombrar la variable del loop a `q_cama` para evitar colisión. Nombre poco descriptivo.
164
+ - **Sugerencia:** Renombrar `q` a `quirofanos_query` para mayor claridad.
165
+
166
+ ### CQ-25
167
+ - **Archivo:línea:** `backend/services/solicitud_service.py` (todo el archivo)
168
+ - **Problema:** Abreviatura `sol` para instancias de `Solicitud` es inconsistente con el resto del proyecto donde los modelos usan el nombre completo (`cama`, `reserva`, `db`).
169
+ - **Sugerencia:** Renombrar a `solicitud` para uniformidad.
170
+
171
+ ---
172
+
173
+ ## Categoría 7 — TODO / FIXME / HACK sin resolver
174
+
175
+ ### CQ-26
176
+ - **Archivo:línea:** `backend/routers/webhooks.py:78`
177
+ - **Problema:** Comentario `# simplificado` justifica lógica deliberadamente incorrecta. La expresión `or True` convierte `is_new` en siempre-verdadero, lo que es equivalente a un bug funcional no marcado como tal.
178
+ - **Sugerencia:** Implementar la lógica correcta para determinar si la reserva es nueva. Si es temporal, marcarlo con `# TODO: implementar lógica de is_new`.
179
+
180
+ ---
181
+
182
+ ## Categoría 8 — Type Hints Faltantes
183
+
184
+ ### CQ-27
185
+ - **Archivo:línea:** `backend/auth/jwt_handler.py:7`
186
+ - **Problema:** `extra: dict = None` — tipo incorrecto y nulabilidad no declarada.
187
+ - **Sugerencia:** Cambiar a `extra: dict | None = None`.
188
+
189
+ ### CQ-28
190
+ - **Archivo:línea:** `backend/services/cama_service.py:389`
191
+ - **Problema:** Parámetro `data` en `crear_reserva_urgente` sin type hint.
192
+ - **Sugerencia:** `data: CirugiaUrgenteWebhook`.
193
+
194
+ ### CQ-29
195
+ - **Archivo:línea:** `backend/services/cama_service.py:466`
196
+ - **Problema:** Parámetro `data` en función auxiliar privada sin tipo, retorno también sin declarar.
197
+ - **Sugerencia:** Agregar tipos completos al signature.
198
+
199
+ ### CQ-30
200
+ - **Archivo:línea:** `backend/main.py:90,98`
201
+ - **Problema:** Parámetro `exc` en los dos exception handlers globales sin tipo declarado.
202
+ - **Sugerencia:** `exc: RequestValidationError` y `exc: Exception` respectivamente.
203
+
204
+ ---
205
+
206
+ ## Categoría 9 — Modelos Pydantic sin Validadores
207
+
208
+ ### CQ-31
209
+ - **Archivo:línea:** `backend/schemas/cama.py:8-14`
210
+ - **Problema:** `CamaCreateRequest`: campos `numero` y `hospital_id` aceptan strings vacíos o solo espacios en blanco.
211
+ - **Sugerencia:** Agregar `field_validator` que haga `strip()` y verifique que el resultado no sea vacío.
212
+
213
+ ### CQ-32
214
+ - **Archivo:línea:** `backend/schemas/solicitud.py:64-83`
215
+ - **Problema:** `SolicitudHceWebhook`: no valida que los campos requeridos según `tipo` (INTERNACION vs TRASLADO) estén presentes (ej. TRASLADO requiere `cama_id_origen`).
216
+ - **Sugerencia:** Agregar `model_validator(mode="after")` para validación cruzada de campos.
217
+
218
+ ### CQ-33
219
+ - **Archivo:línea:** `backend/schemas/reserva.py:8-15`
220
+ - **Problema:** `ReservaQuirofanoCreateRequest`: no valida que `fecha_hora_inicio < fecha_hora_fin_estimada`. Una reserva puede crearse con fechas invertidas.
221
+ - **Sugerencia:** Agregar `model_validator` que verifique el orden cronológico.
222
+
223
+ ### CQ-34
224
+ - **Archivo:línea:** `backend/schemas/cama.py:47-50`
225
+ - **Problema:** `AsignacionCamaRequest.tipo` es `str` libre cuando solo acepta `"INGRESO"` o `"TRASLADO"`.
226
+ - **Sugerencia:** Cambiar el tipo a `Literal["INGRESO", "TRASLADO"]`.
227
+
228
+ ### CQ-35 & CQ-36
229
+ - **Archivo:línea:** `backend/schemas/reserva.py:60-63`
230
+ - **Problema:** `CancelacionQuirofanoRequest.tipo_cancelacion` es `Optional[str]` sin restricción de valores válidos.
231
+ - **Sugerencia:** Cambiar a `Optional[Literal["CANCELADA_MEDICO", "CANCELADA_PACIENTE", "CANCELADA_SISTEMA"]]` o usar un enum específico.
232
+
233
+ ---
234
+
235
+ ## Impacto estimado por categoría
236
+
237
+ | Categoría | Impacto funcional | Impacto mantenimiento | Prioridad |
238
+ |-----------|------------------|----------------------|-----------|
239
+ | Lógica duplicada | MEDIO (divergencia futura) | ALTO | 🔴 Alta |
240
+ | Strings hardcodeados (enums) | ALTO (bugs silenciosos de comparación) | ALTO | 🔴 Alta |
241
+ | Manejo de errores | ALTO (bugs invisibles en producción) | ALTO | 🔴 Alta |
242
+ | Modelos Pydantic sin validadores | ALTO (datos inválidos en BD) | MEDIO | 🔴 Alta |
243
+ | Funciones largas | BAJO | ALTO | 🟡 Media |
244
+ | Código muerto | BAJO | MEDIO | 🟡 Media |
245
+ | Type hints faltantes | BAJO | MEDIO | 🟢 Baja |
246
+ | Nombres inconsistentes | BAJO | BAJO | 🟢 Baja |
247
+ | TODO sin resolver | MEDIO (bug funcional en webhook) | BAJO | 🟡 Media |
audit/DEPENDENCY_AUDIT.md ADDED
@@ -0,0 +1,156 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Auditoría de Dependencias — Módulo 6
2
+
3
+ > Generado: 2026-05-03 | Auditor: Agent B (Dependency Auditor)
4
+
5
+ ---
6
+
7
+ ## Resumen de dependencias declaradas
8
+
9
+ `backend/requirements.txt` declara **9 dependencias**, todas con versión fijada con `==`. No existe lockfile (ni `poetry.lock`, ni `requirements-lock.txt` de pip-tools, ni `Pipfile.lock`).
10
+
11
+ | # | Paquete | Versión | Tipo |
12
+ |---|---------|---------|------|
13
+ | 1 | `fastapi` | `0.115.0` | Producción |
14
+ | 2 | `uvicorn[standard]` | `0.31.0` | Producción |
15
+ | 3 | `sqlalchemy` | `2.0.35` | Producción |
16
+ | 4 | `psycopg2-binary` | `2.9.10` | Producción |
17
+ | 5 | `pydantic` | `2.9.2` | Producción |
18
+ | 6 | `pydantic-settings` | `2.5.2` | Producción |
19
+ | 7 | `python-jose[cryptography]` | `3.3.0` | Producción |
20
+ | 8 | `httpx` | `0.27.2` | Producción |
21
+ | 9 | `python-multipart` | `0.0.12` | Producción |
22
+
23
+ ---
24
+
25
+ ## Dependencias utilizadas vs. declaradas
26
+
27
+ | Paquete | Usado en fuente | Archivos | Notas |
28
+ |---------|----------------|----------|-------|
29
+ | `fastapi` | ✅ Sí | `main.py`, todos los routers, auth, services | Core framework |
30
+ | `uvicorn[standard]` | ✅ Sí (runtime) | `Dockerfile CMD` | No se importa en Python; esencial como servidor ASGI |
31
+ | `sqlalchemy` | ✅ Sí | `database.py`, `models/*.py`, `services/*.py` | ORM v2 |
32
+ | `psycopg2-binary` | ✅ Sí (runtime) | Driver de la URL `postgresql://` en `database.py` | SQLAlchemy lo carga en runtime |
33
+ | `pydantic` | ✅ Sí | `schemas/*.py` — `BaseModel`, `ConfigDict`, `field_validator` | Validación |
34
+ | `pydantic-settings` | ✅ Sí | `config.py` — `from pydantic_settings import BaseSettings` | Uso correcto con v2 |
35
+ | `python-jose[cryptography]` | ✅ Sí | `auth/jwt_handler.py` — `from jose import JWTError, jwt` | JWT |
36
+ | `httpx` | ✅ Sí | `services/external_client.py` — `import httpx` | HTTP a módulos externos |
37
+ | `python-multipart` | ⚠️ No explícito | Ningún router usa `Form`, `File` ni `UploadFile` | Potencialmente innecesario |
38
+
39
+ ---
40
+
41
+ ## Problemas encontrados
42
+
43
+ ### CRÍTICO
44
+
45
+ **C-01: Secret JWT hardcodeado como valor por defecto**
46
+ - `config.py` línea 9: `jwt_secret: str = "supersecretkey_change_in_production"` — fallback hardcodeado en código fuente.
47
+ - `.env` línea 6: el mismo valor sin cambiar en el entorno real.
48
+ - Cualquier persona que lea el código puede firmar tokens JWT válidos.
49
+ - **Acción:** Eliminar el default, usar `jwt_secret: str` (campo obligatorio sin fallback). Generar con `openssl rand -hex 32`.
50
+
51
+ ### ALTO
52
+
53
+ **A-01: Sin lockfile — builds no reproducibles**
54
+ - No existe `poetry.lock`, `requirements-lock.txt` ni `Pipfile.lock`.
55
+ - Las subdependencias no están fijadas; dos `pip install` en distintos momentos pueden instalar versiones diferentes.
56
+ - **Acción:** Adoptar pip-tools (`pip-compile`) o Poetry.
57
+
58
+ **A-02: Imagen Docker sin digest SHA256**
59
+ - `FROM python:3.12-slim` sin hash fijado.
60
+ - **Acción:** Usar `python:3.12-slim@sha256:<hash>` o versión patch completa.
61
+
62
+ **A-03: `python-jose` sin mantenimiento activo (última versión: 2022)**
63
+ - CVEs conocidos sin parche. El proyecto está virtualmente abandonado.
64
+ - **Acción:** Migrar a `authlib` (mantenido activamente, sin CVEs activos conocidos).
65
+
66
+ **A-04: `psycopg2-binary` desaconsejado en producción**
67
+ - Los propios maintainers advierten contra su uso en producción (conflictos con libs del sistema).
68
+ - **Acción:** Usar `psycopg2` compilado (añadir `libpq-dev gcc` al Dockerfile) o migrar a `psycopg` v3.
69
+
70
+ ### MEDIO
71
+
72
+ **M-01: `python-multipart` declarada pero no utilizada**
73
+ - No hay `Form`, `File` ni `UploadFile` en ningún router. Dependencia prescindible actualmente.
74
+
75
+ **M-02: `version: "3.9"` obsoleto en docker-compose.yml**
76
+ - Campo deprecado en Docker Compose v2. Genera warnings.
77
+ - **Acción:** Eliminar la línea `version:`.
78
+
79
+ **M-03: `--reload` en CMD del Dockerfile de producción**
80
+ - `CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8006", "--reload"]`
81
+ - Flag de desarrollo en imagen de producción — file watchers, reinicios inesperados.
82
+ - **Acción:** Remover `--reload` del Dockerfile. Usarlo solo en `docker-compose.yml` para dev.
83
+
84
+ **M-04: Sin separación de dependencias dev/prod**
85
+ - No existe `requirements-dev.txt`. Sin estructura para aislar herramientas de testing/linting.
86
+
87
+ **M-05: Versiones potencialmente desactualizadas (a mayo 2026)**
88
+ - Las versiones datan de mediados/finales 2024. `fastapi`, `uvicorn`, `sqlalchemy`, `pydantic`, `httpx` probablemente tienen versiones más recientes con correcciones de seguridad.
89
+
90
+ ### BAJO
91
+
92
+ **B-01: `.env` con credenciales sin `.gitignore` verificado**
93
+ - No se encontró `.gitignore`. Riesgo de commit accidental de credenciales.
94
+
95
+ **B-02: Sin `.dockerignore`**
96
+ - El contexto de build incluye `__pycache__`, `.pyc`, etc. Aumenta tiempo de build.
97
+
98
+ **B-03: Sin `pyproject.toml`**
99
+ - Sin metadatos de proyecto estándar para integración con herramientas modernas.
100
+
101
+ ---
102
+
103
+ ## Dependencias faltantes recomendadas
104
+
105
+ | Paquete | Justificación | Prioridad |
106
+ |---------|--------------|-----------|
107
+ | `alembic` | El proyecto usa `Base.metadata.create_all()` en startup — funciona en dev pero no en producción. Alembic permite migraciones versionadas y reversibles. | ALTA |
108
+ | `authlib` | Reemplazo directo de `python-jose` (abandonado). RFC 7519 completo, mantenimiento activo. | ALTA |
109
+ | `gunicorn` | Process manager para múltiples workers Uvicorn en producción (`-k uvicorn.workers.UvicornWorker`). | MEDIA |
110
+ | `pytest` + `pytest-asyncio` | No hay tests visibles. `httpx` ya declarado puede usarse con `AsyncClient`. | MEDIA |
111
+ | `ruff` | Linter/formatter moderno (dev). | BAJA |
112
+ | `mypy` | Type checker — el código usa type hints extensivamente. | BAJA |
113
+
114
+ > `python-dotenv` NO es necesario: `pydantic-settings` ya gestiona la carga del `.env` nativamente (configurado correctamente en `config.py` con `env_file = ".env"`).
115
+
116
+ ---
117
+
118
+ ## Análisis del entorno Docker
119
+
120
+ ### Dockerfile
121
+
122
+ | Aspecto | Estado | Nota |
123
+ |---------|--------|------|
124
+ | Imagen base `python:3.12-slim` | ✅ Correcto | Versión Python correcta, variante slim apropiada |
125
+ | `--no-cache-dir` en pip install | ✅ Correcto | Reduce tamaño de imagen |
126
+ | Orden de layers | ✅ Correcto | `COPY requirements.txt` → `pip install` → `COPY . .` |
127
+ | Digest SHA256 fijado | ⚠️ Faltante | Sin hash fijado en imagen base |
128
+ | `--reload` en CMD | ⚠️ Problema | Solo para desarrollo, no producción |
129
+ | `.dockerignore` | ⚠️ Faltante | Contexto de build innecesariamente grande |
130
+ | Usuario no-root | ⚠️ Faltante | Corre como root |
131
+
132
+ ### docker-compose.yml
133
+
134
+ | Aspecto | Estado | Nota |
135
+ |---------|--------|------|
136
+ | `postgres:16-alpine` | ✅ Correcto | Versión reciente y slim |
137
+ | `healthcheck` con `pg_isready` | ✅ Correcto | Con `condition: service_healthy` |
138
+ | Volumen nombrado | ✅ Correcto | Para persistencia de datos PostgreSQL |
139
+ | `restart: unless-stopped` | ✅ Correcto | Para el backend |
140
+ | Variables via `env_file: .env` | ✅ Correcto | |
141
+ | `version: "3.9"` | ⚠️ Obsoleto | Campo deprecado en Docker Compose v2 |
142
+ | Puerto `5432` expuesto al host | ⚠️ Riesgo | En producción no debería exponerse |
143
+ | Bind mount `./backend:/app` | ⚠️ Solo dev | No apropiado para producción |
144
+
145
+ ---
146
+
147
+ ## Acciones urgentes (por prioridad)
148
+
149
+ 1. **[CRÍTICO]** Rotar el JWT secret — eliminar fallback hardcodeado y generar valor seguro
150
+ 2. **[ALTO]** Reemplazar `python-jose` por `authlib`
151
+ 3. **[ALTO]** Reemplazar `psycopg2-binary` por `psycopg2` compilado o `psycopg` v3
152
+ 4. **[ALTO]** Generar un lockfile (pip-tools o Poetry)
153
+ 5. **[MEDIO]** Remover `--reload` del Dockerfile
154
+ 6. **[MEDIO]** Incorporar `alembic` para migraciones
155
+ 7. **[MEDIO]** Crear `requirements-dev.txt` separado
156
+ 8. **[BAJO]** Agregar `.gitignore` y `.dockerignore`
audit/REFACTOR_LOG.md ADDED
@@ -0,0 +1,131 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Log de Refactorización — Módulo 6
2
+
3
+ > Fecha: 2026-05-03 | Phase 2 — Reorganización estructural
4
+
5
+ ---
6
+
7
+ ## Resumen de cambios
8
+
9
+ | Tipo | Cantidad |
10
+ |------|----------|
11
+ | Archivos creados (nuevos) | 31 |
12
+ | Archivos modificados | 2 |
13
+ | Archivos preservados (sin tocar) | Todos los de `backend/` |
14
+ | Archivos eliminados | 0 |
15
+
16
+ ---
17
+
18
+ ## Archivos creados
19
+
20
+ ### Núcleo de la aplicación
21
+
22
+ | Archivo creado | Origen | Razón |
23
+ |---------------|--------|-------|
24
+ | `app/__init__.py` | Nuevo | Marca `app/` como paquete Python |
25
+ | `app/main.py` | `backend/main.py` | Reubicación + mejoras: logging estructurado, CORS con orígenes explícitos, guard de entorno en `/auth/token` |
26
+ | `app/config.py` | `backend/config.py` | Reubicación + mejoras: `SettingsConfigDict` (pydantic v2), campos obligatorios sin default, `environment`, `allowed_origins`, `http_timeout_seconds` |
27
+ | `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 |
28
+
29
+ ### Modelos ORM
30
+
31
+ | Archivo creado | Origen | Razón |
32
+ |---------------|--------|-------|
33
+ | `app/models/__init__.py` | `backend/models/__init__.py` | Reubicación con re-exports explícitos |
34
+ | `app/models/cama.py` | `backend/models/cama.py` | Reubicación; actualiza import de `Base` a `app.dependencies` |
35
+ | `app/models/solicitud.py` | `backend/models/solicitud.py` | Reubicación; actualiza import de `Base` |
36
+ | `app/models/reserva.py` | `backend/models/reserva.py` | Reubicación; actualiza import de `Base` |
37
+
38
+ ### Schemas Pydantic
39
+
40
+ | Archivo creado | Origen | Razón |
41
+ |---------------|--------|-------|
42
+ | `app/schemas/__init__.py` | Nuevo | Marca directorio como paquete |
43
+ | `app/schemas/enums.py` | `backend/schemas/enums.py` | Reubicación sin cambios funcionales |
44
+ | `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` |
45
+ | `app/schemas/solicitud.py` | `backend/schemas/solicitud.py` | Reubicación; actualiza imports al nuevo path |
46
+ | `app/schemas/reserva.py` | `backend/schemas/reserva.py` | Mejoras: `model_validator` verifica `fecha_inicio < fecha_fin` en `ReservaQuirofanoCreateRequest` y `CirugiaUrgenteWebhook` |
47
+
48
+ ### Capa de integración (nueva — extraída de external_client.py)
49
+
50
+ | Archivo creado | Origen | Razón |
51
+ |---------------|--------|-------|
52
+ | `app/integrations/__init__.py` | Nuevo | Marca directorio como paquete |
53
+ | `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` |
54
+ | `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 |
55
+ | `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` |
56
+ | `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 |
57
+ | `app/integrations/facturacion.py` | `backend/services/external_client.py` (función `notify_cama_lista`) | Aísla M7 |
58
+ | `app/integrations/turnos.py` | `backend/services/external_client.py` (función `notify_resultado_quirofano`) | Aísla M2 |
59
+
60
+ ### Capa CRUD/Repository (nueva — extraída de services)
61
+
62
+ | Archivo creado | Origen | Razón |
63
+ |---------------|--------|-------|
64
+ | `app/crud/__init__.py` | Nuevo | Marca directorio como paquete |
65
+ | `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` |
66
+ | `app/crud/solicitud.py` | `backend/services/solicitud_service.py` (operaciones ORM) | Ídem para solicitudes |
67
+ | `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 |
68
+
69
+ ### Servicios (refactorizados)
70
+
71
+ | Archivo creado | Origen | Razón |
72
+ |---------------|--------|-------|
73
+ | `app/services/__init__.py` | Nuevo | Marca directorio como paquete |
74
+ | `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 |
75
+ | `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 |
76
+
77
+ ### Routers (mejorados)
78
+
79
+ | Archivo creado | Origen | Razón |
80
+ |---------------|--------|-------|
81
+ | `app/routers/__init__.py` | Nuevo | Marca directorio como paquete |
82
+ | `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 |
83
+ | `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 |
84
+ | `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 |
85
+
86
+ ### Tests
87
+
88
+ | Archivo creado | Origen | Razón |
89
+ |---------------|--------|-------|
90
+ | `tests/__init__.py` | Nuevo | Marca directorio como paquete |
91
+ | `tests/conftest.py` | Nuevo | Fixtures de BD en memoria (SQLite) y TestClient para testing sin PostgreSQL real |
92
+ | `tests/test_camas.py` | Nuevo | Estructura base de tests para router de camas |
93
+ | `tests/test_solicitudes.py` | Nuevo | Estructura base de tests para solicitudes y webhooks |
94
+
95
+ ### Infraestructura y documentación
96
+
97
+ | Archivo | Tipo | Razón |
98
+ |---------|------|-------|
99
+ | `Dockerfile` | Creado (raíz) | Nuevo Dockerfile a nivel raíz; apunta a `app.main:app`; sin `--reload` |
100
+ | `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 |
101
+ | `requirements.txt` | Creado (raíz) | Copia del original con `python-multipart` comentada (no usada) y notas sobre separación dev/prod |
102
+ | `.env.example` | Creado | Template completo con todas las variables; instrucciones de generación de JWT secret; ningún valor real |
103
+ | `README.md` | Modificado | Documentación completa: propósito, endpoints, mapa de integraciones, variables de entorno, estructura del proyecto, cómo correr tests |
104
+
105
+ ---
106
+
107
+ ## Bugs corregidos durante la refactorización
108
+
109
+ | Bug | Archivo original | Solución |
110
+ |-----|-----------------|---------|
111
+ | `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` |
112
+ | 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` |
113
+ | 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 |
114
+ | 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` |
115
+ | `_get_cama_or_404` duplicada en `cama_service` y `solicitud_service` | Ambos servicios | Consolidada en `crud/cama.py` y usada desde ambos servicios |
116
+ | `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 |
117
+ | Verificación de contraindicaciones copiada 3 veces | `cama_service`, `solicitud_service` (×2) | Extraída a `_verificar_contraindicaciones()` en cada servicio |
118
+
119
+ ---
120
+
121
+ ## Decisiones de diseño
122
+
123
+ 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/`.
124
+
125
+ 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.
126
+
127
+ 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.
128
+
129
+ 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.
130
+
131
+ 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").
audit/SECURITY_AUDIT.md ADDED
@@ -0,0 +1,396 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Auditoría de Seguridad — Módulo 6 (Health Grid)
2
+
3
+ > Fecha de análisis: 2026-05-03 | Agente D (Security Auditor)
4
+ > ⚠️ Este documento contiene información sensible — acceso restringido al equipo de desarrollo
5
+
6
+ ---
7
+
8
+ ## Tabla de hallazgos (resumen ejecutivo)
9
+
10
+ | ID | Severidad | Área | Descripción breve |
11
+ |----|-----------|------|-------------------|
12
+ | F-01 | **CRÍTICO** | Configuración | Credenciales y JWT secret hardcodeados como defaults |
13
+ | F-02 | **CRÍTICO** | Secretos | Archivo `.env` con credenciales activas potencialmente versionado |
14
+ | F-03 | **CRÍTICO** | CORS | `allow_origins=["*"]` con `allow_credentials=True` (violación W3C) |
15
+ | F-04 | **CRÍTICO** | Autenticación | Endpoint de desarrollo que genera tokens JWT expuesto en producción |
16
+ | F-05 | **CRÍTICO** | Docker | `--reload` en imagen de producción con volumen montado |
17
+ | F-06 | **ALTO** | Autorización | Webhooks sin validación de firma/secret compartido |
18
+ | F-07 | **ALTO** | Autorización | Endpoint de crear reserva sin control de roles correcto |
19
+ | F-08 | **ALTO** | Secretos | JWT secret activo es valor placeholder predecible |
20
+ | F-09 | **ALTO** | Disponibilidad | Sin rate limiting en ningún endpoint |
21
+ | F-10 | **ALTO** | Red | Puerto PostgreSQL expuesto al host |
22
+ | F-11 | **MEDIO** | Validación | Campo `tipo` de asignación acepta strings arbitrarios |
23
+ | F-12 | **MEDIO** | Validación | Campos de texto sin límite de longitud en Pydantic |
24
+ | F-13 | **MEDIO** | Validación | Parámetros de query sin validación de enum |
25
+ | F-14 | **MEDIO** | Validación | Parámetros de fecha sin validación de formato |
26
+ | F-15 | **MEDIO** | Privacidad | Contraindicaciones médicas expuestas en mensajes de error HTTP |
27
+ | F-16 | **MEDIO** | Observabilidad | `print()` en lugar de logging estructurado |
28
+ | F-17 | **MEDIO** | Autenticación | Mensajes de error JWT diferenciados (oracle de timing) |
29
+ | F-18 | **BAJO** | Configuración | Ruta de webhook inconsistente dificulta políticas de red |
30
+ | F-19 | **BAJO** | Observabilidad | Errores de integración silenciados (sin log) |
31
+ | F-20 | **BAJO** | Supply Chain | Imagen Docker sin digest SHA fijo |
32
+
33
+ **Total: 5 CRÍTICOS · 5 ALTOS · 7 MEDIOS · 3 BAJOS**
34
+
35
+ ---
36
+
37
+ ## Hallazgos CRÍTICOS
38
+
39
+ ---
40
+
41
+ ### F-01 — CRÍTICO
42
+ **Área:** Configuración de secretos
43
+ **Archivo:línea:** `backend/config.py:6,9`
44
+
45
+ **Descripción:**
46
+ La clase `Settings` define valores por defecto hardcodeados para `database_url` (con usuario y contraseña en texto plano) y `jwt_secret`. Si el archivo `.env` no está presente o la variable no se define, la aplicación arranca con credenciales conocidas por cualquiera que lea el código fuente.
47
+
48
+ **Impacto potencial:**
49
+ - Acceso completo a la base de datos de producción si `.env` falta
50
+ - Capacidad de forjar tokens JWT válidos con cualquier rol (incluyendo ADMINISTRATIVO)
51
+ - Credenciales filtradas en repositorios públicos, CI/CD logs, Docker images
52
+
53
+ **Recomendación:**
54
+ ```python
55
+ # Cambiar de:
56
+ database_url: str = "postgresql://admin:secret@..."
57
+ jwt_secret: str = "supersecretkey_change_in_production"
58
+
59
+ # A (campos requeridos sin default):
60
+ database_url: str
61
+ jwt_secret: str
62
+ ```
63
+ Con `pydantic-settings`, un campo sin default lanzará `ValidationError` al startup si la variable no está definida en el entorno — comportamiento correcto y seguro.
64
+
65
+ ---
66
+
67
+ ### F-02 — CRÍTICO
68
+ **Área:** Gestión de secretos
69
+ **Archivo:** `.env`
70
+
71
+ **Descripción:**
72
+ El archivo `.env` contiene credenciales activas de PostgreSQL y el JWT secret. No se detectó `.gitignore` en el proyecto. Si este archivo fue incluido en algún commit de git, los secretos están permanentemente en el historial.
73
+
74
+ **Impacto potencial:**
75
+ - Credenciales de base de datos y JWT secret comprometidos permanentemente si el repo es accesible
76
+ - En entornos universitarios/compartidos, riesgo inmediato de acceso no autorizado
77
+
78
+ **Recomendación:**
79
+ 1. Verificar historial: `git log --all --full-history -- .env`
80
+ 2. Si fue comprometido: rotar TODAS las credenciales inmediatamente
81
+ 3. Crear `.gitignore` con `.env` incluido
82
+ 4. Crear `.env.example` con valores de placeholder documentados
83
+ 5. **Nota:** No se imprimen los valores del `.env` en este reporte — solo se documenta su existencia.
84
+
85
+ ---
86
+
87
+ ### F-03 — CRÍTICO
88
+ **Área:** CORS
89
+ **Archivo:línea:** `backend/main.py:43-49`
90
+
91
+ **Descripción:**
92
+ ```python
93
+ app.add_middleware(
94
+ CORSMiddleware,
95
+ allow_origins=["*"],
96
+ allow_credentials=True, # ← combinación inválida
97
+ ...
98
+ )
99
+ ```
100
+ La combinación de `allow_origins=["*"]` con `allow_credentials=True` viola la especificación W3C CORS. Los navegadores modernos rechazan esta combinación, pero más importante: en configuraciones menos estrictas permite ataques CSRF cross-origin donde cualquier sitio web puede realizar requests autenticados en nombre del usuario.
101
+
102
+ **Impacto potencial:**
103
+ - CSRF attacks sobre todos los endpoints de la API
104
+ - Exfiltración de datos médicos desde sitios maliciosos
105
+
106
+ **Recomendación:**
107
+ ```python
108
+ allow_origins=["http://localhost:3000", "https://hospital.example.com"]
109
+ ```
110
+ Si el origen varía por entorno, moverlo a `settings.allowed_origins: list[str]`.
111
+
112
+ ---
113
+
114
+ ### F-04 — CRÍTICO
115
+ **Área:** Autenticación
116
+ **Archivo:línea:** `backend/main.py:62-77`
117
+
118
+ **Descripción:**
119
+ ```python
120
+ @app.get("/api/v1/auth/token")
121
+ async def generate_token(usuario: str, contraseña: str = "any"):
122
+ # Genera token JWT con cualquier contraseña, sin validación
123
+ return {"access_token": create_access_token(...)}
124
+ ```
125
+ Endpoint de desarrollo expuesto públicamente. Acepta cualquier contraseña y genera tokens JWT con el rol solicitado (incluyendo `ADMINISTRATIVO`). No hay guard de entorno para deshabilitarlo en producción.
126
+
127
+ **Impacto potencial:**
128
+ - Cualquier persona con acceso a la URL obtiene control total del sistema
129
+ - Creación de camas, aprobación de solicitudes, acceso a todos los datos de pacientes
130
+
131
+ **Recomendación:**
132
+ Agregar guard de entorno:
133
+ ```python
134
+ @app.get("/api/v1/auth/token")
135
+ async def generate_token(...):
136
+ if settings.environment != "development":
137
+ raise HTTPException(status_code=404, detail="Not Found")
138
+ ...
139
+ ```
140
+ O eliminar el endpoint y usar herramientas como `httpie` / Swagger UI con credenciales reales para testing.
141
+
142
+ ---
143
+
144
+ ### F-05 — CRÍTICO
145
+ **Área:** Docker / Infraestructura
146
+ **Archivo:línea:** `backend/Dockerfile:12`
147
+
148
+ **Descripción:**
149
+ ```dockerfile
150
+ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8006", "--reload"]
151
+ ```
152
+ La flag `--reload` activa el file watcher de uvicorn. Combinado con el bind mount `./backend:/app` en `docker-compose.yml`, el contenedor "de producción" recarga el código automáticamente ante cualquier cambio en el host. Elimina la inmutabilidad de los contenedores.
153
+
154
+ **Impacto potencial:**
155
+ - Modificación accidental del código en producción
156
+ - Overhead de recursos del file watcher
157
+ - Reinicios inesperados que interrumpen conexiones activas
158
+
159
+ **Recomendación:**
160
+ Remover `--reload` del Dockerfile. Usar `--reload` solo en el override de development en `docker-compose.override.yml`.
161
+
162
+ ---
163
+
164
+ ## Hallazgos ALTOS
165
+
166
+ ---
167
+
168
+ ### F-06 — ALTO
169
+ **Área:** Autenticación de webhooks
170
+ **Archivo:línea:** `backend/routers/webhooks.py:31-163`
171
+
172
+ **Descripción:**
173
+ Todos los webhooks de M1, M2 y M9 usan únicamente `Depends(get_current_user)` como autenticación. No hay:
174
+ - Validación de firma HMAC (secret compartido entre módulos)
175
+ - Whitelist de IPs de origen
176
+ - Header de autenticación específico entre servicios (service-to-service auth)
177
+
178
+ **Impacto potencial:**
179
+ Cualquier usuario con un token JWT válido (obtenible trivialmente via F-04) puede:
180
+ - Inyectar altas médicas fraudulentas (liberar camas que no corresponde)
181
+ - Crear reservas de quirófano de emergencia no autorizadas
182
+ - Cancelar cirugías programadas
183
+ - Generar alertas de emergencia falsas
184
+
185
+ **Recomendación:**
186
+ Implementar validación de firma HMAC-SHA256 con secret compartido:
187
+ ```python
188
+ def verify_webhook_signature(request: Request, x_signature: str = Header(...)):
189
+ body = await request.body()
190
+ expected = hmac.new(settings.webhook_secret.encode(), body, hashlib.sha256).hexdigest()
191
+ if not hmac.compare_digest(expected, x_signature):
192
+ raise HTTPException(403, "Firma de webhook inválida")
193
+ ```
194
+
195
+ ---
196
+
197
+ ### F-07 — ALTO
198
+ **Área:** Autorización de endpoints
199
+ **Archivo:línea:** `backend/routers/camas.py:162-173`
200
+
201
+ **Descripción:**
202
+ ```python
203
+ @router.post("/{cama_id}/reservas")
204
+ async def crear_reserva(
205
+ current_user: dict = Depends(get_current_user), # ← sin control de rol
206
+ ...
207
+ ):
208
+ ```
209
+ El endpoint de creación de reservas de quirófano usa `get_current_user` en lugar de `require_roles("MEDICO", "ADMINISTRATIVO")`. El rol `LIMPIEZA` puede crear reservas quirúrgicas.
210
+
211
+ **Impacto potencial:**
212
+ Usuarios de limpieza pueden reservar quirófanos, potencialmente bloqueando cirugías programadas.
213
+
214
+ **Recomendación:**
215
+ ```python
216
+ current_user: dict = Depends(require_roles("MEDICO", "ADMINISTRATIVO"))
217
+ ```
218
+
219
+ ---
220
+
221
+ ### F-08 — ALTO
222
+ **Área:** Calidad del JWT secret
223
+ **Archivo:línea:** `backend/config.py:9` y `.env:7`
224
+
225
+ **Descripción:**
226
+ El JWT secret activo es el valor placeholder `supersecretkey_change_in_production`. Tiene baja entropía y es predecible — cualquier atacante que lo intente (o lo lea del código) puede firmar tokens arbitrarios.
227
+
228
+ **Recomendación:**
229
+ Generar un secret de alta entropía: `python -c "import secrets; print(secrets.token_hex(32))"`
230
+ Y nunca incluir el secret real en el código fuente (ver F-01).
231
+
232
+ ---
233
+
234
+ ### F-09 — ALTO
235
+ **Área:** Rate limiting
236
+ **Cobertura:** Toda la aplicación
237
+
238
+ **Descripción:**
239
+ No existe rate limiting en ningún endpoint. El endpoint de generación de tokens (F-04) y los webhooks aceptan volúmenes ilimitados de requests.
240
+
241
+ **Impacto potencial:**
242
+ - Ataques de fuerza bruta sobre endpoints de autenticación
243
+ - DoS mediante flooding de webhooks
244
+ - Saturación de la base de datos
245
+
246
+ **Recomendación:**
247
+ Implementar `slowapi` (integración nativa con FastAPI):
248
+ ```python
249
+ from slowapi import Limiter
250
+ limiter = Limiter(key_func=get_remote_address)
251
+
252
+ @app.get("/api/v1/auth/token")
253
+ @limiter.limit("5/minute")
254
+ async def generate_token(...):
255
+ ```
256
+
257
+ ---
258
+
259
+ ### F-10 — ALTO
260
+ **Área:** Exposición de red
261
+ **Archivo:línea:** `docker-compose.yml:14`
262
+
263
+ **Descripción:**
264
+ ```yaml
265
+ db:
266
+ ports:
267
+ - "5432:5432" # PostgreSQL expuesto al host
268
+ ```
269
+ Con las credenciales débiles documentadas en `.env`, la base de datos es directamente accesible desde la red del host (y potencialmente desde la red local).
270
+
271
+ **Recomendación:**
272
+ Eliminar la sección `ports` del servicio `db`. Los servicios en la misma red Docker se comunican por nombre de servicio sin necesidad de exponer puertos al host. Solo exponer si se necesita acceso desde herramientas externas de administración, y en ese caso, bindear a `127.0.0.1:5432:5432`.
273
+
274
+ ---
275
+
276
+ ## Hallazgos MEDIOS
277
+
278
+ ---
279
+
280
+ ### F-11 — MEDIO
281
+ **Área:** Validación de entrada
282
+ **Archivo:línea:** `backend/schemas/cama.py:48`
283
+
284
+ **Descripción:** Campo `tipo` en `AsignacionCamaRequest` definido como `str` libre. Valores inesperados se tratan silenciosamente como `INGRESO`.
285
+ **Recomendación:** Cambiar a `Literal["INGRESO", "TRASLADO"]` o usar el enum correspondiente.
286
+
287
+ ---
288
+
289
+ ### F-12 — MEDIO
290
+ **Área:** Validación de entrada
291
+ **Archivo:línea:** `backend/schemas/cama.py:9-14`, `backend/schemas/solicitud.py:64-83`
292
+
293
+ **Descripción:** Campos de texto (`numero`, `hospital_id`, `diagnostico_ingreso`, `observaciones`) sin límite de longitud en Pydantic. El modelo de BD tiene `String(20)`/`String(50)` pero Pydantic no lo valida. Posible truncamiento silencioso o error de BD.
294
+ **Recomendación:** Usar `Field(..., max_length=N)` para todos los campos de texto con restricciones en BD.
295
+
296
+ ---
297
+
298
+ ### F-13 — MEDIO
299
+ **Área:** Validación de parámetros
300
+ **Archivo:línea:** `backend/routers/solicitudes.py:14-26`
301
+
302
+ **Descripción:** Parámetros `estado` y `tipo` en `GET /solicitudes` aceptan strings libres sin validación.
303
+ **Recomendación:** Usar `EstadoSolicitudEnum` y `TipoSolicitudEnum` como tipo del Query param.
304
+
305
+ ---
306
+
307
+ ### F-14 — MEDIO
308
+ **Área:** Validación de parámetros
309
+ **Archivo:línea:** `backend/routers/camas.py:148-158`
310
+
311
+ **Descripción:** Parámetros `fecha_desde` y `fecha_hasta` sin validación de formato. Fechas inválidas generan errores 500 no controlados en lugar de 422.
312
+ **Recomendación:** Usar `datetime` como tipo del Query param para validación automática de FastAPI.
313
+
314
+ ---
315
+
316
+ ### F-15 — MEDIO
317
+ **Área:** Privacidad de datos clínicos
318
+ **Archivo:línea:** `backend/services/solicitud_service.py:143-145`, `backend/services/cama_service.py:168-188`
319
+
320
+ **Descripción:** Contraindicaciones médicas del paciente (ej. `"ALERGIA_LATEX"`, `"INMUNOSUPRIMIDO"`) se incluyen en el campo `detalle` de respuestas HTTP 422. Datos clínicos sensibles expuestos en respuestas de API.
321
+ **Recomendación:** Usar mensajes genéricos en las responses HTTP. Loggear el detalle clínico internamente.
322
+
323
+ ---
324
+
325
+ ### F-16 — MEDIO
326
+ **Área:** Logging y observabilidad
327
+ **Archivo:línea:** `backend/main.py:27`
328
+
329
+ **Descripción:** Uso de `print()` en lugar de un logger configurado. Sin control de nivel de log ni formateo estructurado.
330
+ **Recomendación:** Configurar `logging.getLogger(__name__)` y usar `logger.info/warning/error` con formato JSON para sistemas de agregación de logs.
331
+
332
+ ---
333
+
334
+ ### F-17 — MEDIO
335
+ **Área:** Autenticación
336
+ **Archivo:línea:** `backend/auth/jwt_handler.py:34-35`
337
+
338
+ **Descripción:** El mensaje de error `f"Token inválido: {e}"` propaga la excepción original, exponiendo diferencias entre tokens caducados y tokens forjados. Facilita ataques de timing/oracle.
339
+ **Recomendación:** Usar mensaje genérico: `raise HTTPException(401, detail="Credenciales inválidas")` sin incluir el error original.
340
+
341
+ ---
342
+
343
+ ## Hallazgos BAJOS
344
+
345
+ ---
346
+
347
+ ### F-18 — BAJO
348
+ **Área:** Consistencia de rutas
349
+ **Archivo:línea:** `backend/routers/webhooks.py:106`
350
+
351
+ **Descripción:** Ruta `/turnos/{turno_id}/cancelacion-quirofano` sin prefijo `/webhooks/`, inconsistente con las demás rutas de webhook.
352
+ **Recomendación:** Verificar si el router tiene prefijo `/api/v1/webhooks`. Si no, asegurar consistencia en todas las rutas de webhook.
353
+
354
+ ---
355
+
356
+ ### F-19 — BAJO
357
+ **Área:** Observabilidad
358
+ **Archivo:línea:** `backend/services/external_client.py:24,33`
359
+
360
+ **Descripción:** Errores de llamadas a servicios externos silenciados con `except Exception: return None` sin ningún log.
361
+ **Recomendación:** Agregar logging de warnings antes de retornar `None`.
362
+
363
+ ---
364
+
365
+ ### F-20 — BAJO
366
+ **Área:** Supply chain
367
+ **Archivo:línea:** `backend/Dockerfile:1`
368
+
369
+ **Descripción:** `FROM python:3.12-slim` sin digest SHA256 fijado. Builds no completamente reproducibles.
370
+ **Recomendación:** Usar `python:3.12-slim@sha256:<digest>` para builds reproducibles y protección contra supply chain attacks.
371
+
372
+ ---
373
+
374
+ ## Controles correctos identificados
375
+
376
+ Los siguientes aspectos de seguridad están implementados correctamente:
377
+
378
+ | Control | Estado | Detalle |
379
+ |---------|--------|---------|
380
+ | Inyección SQL | ✅ Correcto | SQLAlchemy ORM con queries parametrizadas en todos los accesos |
381
+ | Stack traces en HTTP | ✅ Correcto | Handlers globales devuelven JSON controlado, sin tracebacks |
382
+ | Confusión de algoritmo JWT | ✅ Correcto | `decode_token` fija `algorithms=[settings.jwt_algorithm]`, previene `alg=none` |
383
+ | JWT con expiración | ✅ Correcto | Campo `exp` incluido en todos los tokens (60 minutos por defecto) |
384
+ | Roles en endpoints | ✅ Mayoritariamente | `require_roles()` usado correctamente excepto F-07 |
385
+ | Separación de credenciales | ✅ Correcto | Credenciales en `.env`, no en código (excepto defaults de F-01) |
386
+
387
+ ---
388
+
389
+ ## Plan de remediación priorizado
390
+
391
+ | Prioridad | Hallazgos | Esfuerzo estimado |
392
+ |-----------|-----------|-------------------|
393
+ | **Inmediato** (antes de cualquier deploy) | F-01, F-02, F-03, F-04, F-08 | 2-4 horas |
394
+ | **Esta semana** | F-05, F-06, F-07, F-09, F-10 | 4-8 horas |
395
+ | **Próximas 2 semanas** | F-11 a F-17 | 4-6 horas |
396
+ | **Backlog** | F-18, F-19, F-20 | 1-2 horas |
audit/STRUCTURE.md ADDED
@@ -0,0 +1,275 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Mapa de Estructura — Módulo 6 (Health Grid)
2
+
3
+ > Generado: 2026-05-03 | Agente A (Structure Mapper)
4
+
5
+ ---
6
+
7
+ ## Árbol de archivos anotado
8
+
9
+ ```
10
+ modulo6/
11
+ ├── docker-compose.yml # Orquestación: backend (puerto 8006) + PostgreSQL 16
12
+ ├── .env # Variables de entorno (credenciales activas — NO commitear)
13
+ ├── README.md # Documentación básica del proyecto
14
+ └── backend/
15
+ ├── Dockerfile # Imagen python:3.12-slim, expone puerto 8006
16
+ ├── requirements.txt # 9 dependencias de producción, todas pinadas con ==
17
+ ├── main.py # Punto de entrada FastAPI: app factory, routers, CORS, startup
18
+ ├── config.py # Settings via pydantic-settings (BaseSettings), lee .env
19
+ ├── database.py # Engine SQLAlchemy, SessionLocal, Base, get_db()
20
+ ├── models/
21
+ │ ├── __init__.py # Re-exporta todos los modelos ORM
22
+ │ ├── cama.py # ORM: Cama (tabla `camas`)
23
+ │ ├── solicitud.py # ORM: SolicitudInternacion (tabla `solicitudes_internacion`)
24
+ │ └── reserva.py # ORM: ReservaQuirofano (tabla `reservas_quirofano`)
25
+ ├── schemas/
26
+ │ ├── __init__.py # Vacío
27
+ │ ├── enums.py # Todos los Enum de dominio (EstadoCama, TipoSolicitud, etc.)
28
+ │ ├── cama.py # Pydantic schemas: CamaCreate/Response, AsignacionRequest, etc.
29
+ │ ├── solicitud.py # Pydantic schemas: Solicitud + webhooks de M1/M2
30
+ │ └── reserva.py # Pydantic schemas: Reserva + webhooks de M2/M9
31
+ ├── auth/
32
+ │ ├── __init__.py # Vacío
33
+ │ ├── jwt_handler.py # create_access_token / decode_token (python-jose)
34
+ │ └── dependencies.py # get_current_user, require_roles() factory
35
+ ├── services/
36
+ │ ├── __init__.py # Vacío
37
+ │ ├── external_client.py # Cliente HTTP centralizado para llamadas a M1/M7/M9/M10/M2
38
+ │ ├── cama_service.py # Lógica de negocio: camas, asignación, reservas quirófano
39
+ │ └── solicitud_service.py# Lógica de negocio: solicitudes de internación/traslado
40
+ └── routers/
41
+ ├── __init__.py # Vacío
42
+ ├── camas.py # Endpoints REST de camas y reservas de quirófano
43
+ ├── solicitudes.py # Endpoints REST de solicitudes de internación
44
+ └── webhooks.py # Endpoints inbound de webhooks (M1, M2, M9)
45
+ ```
46
+
47
+ ---
48
+
49
+ ## Descripción por módulo
50
+
51
+ ### `main.py`
52
+ **Propósito:** Factory de la aplicación FastAPI. Registra routers, configura CORS, evento de startup (crea tablas), handlers de error globales, health check y endpoint de desarrollo para generar tokens JWT.
53
+
54
+ **Exportaciones clave:**
55
+ - `app` — instancia FastAPI
56
+ - `GET /health` — health check público
57
+ - `GET /api/v1/auth/token` — generador de JWT para desarrollo (**no protegido**)
58
+
59
+ **Dependencias externas:** `fastapi`, `sqlalchemy`, `database.py`, `config.py`, todos los routers.
60
+
61
+ ---
62
+
63
+ ### `config.py`
64
+ **Propósito:** Centraliza la configuración de la aplicación mediante `pydantic-settings`. Lee variables del archivo `.env`.
65
+
66
+ **Variables configuradas:**
67
+ | Variable | Descripción |
68
+ |----------|-------------|
69
+ | `database_url` | Cadena de conexión PostgreSQL |
70
+ | `jwt_secret` | Clave de firma JWT (default inseguro hardcodeado) |
71
+ | `jwt_algorithm` | Algoritmo JWT (HS256) |
72
+ | `access_token_expire_minutes` | Expiración del token (60 min) |
73
+ | `m1_hce_url` | URL Módulo 1 - HCE |
74
+ | `m2_turnos_url` | URL Módulo 2 - Turnos |
75
+ | `m7_facturacion_url` | URL Módulo 7 - Facturación |
76
+ | `m9_monitoreo_url` | URL Módulo 9 - Monitoreo |
77
+ | `m10_core_url` | URL Módulo 10 - Core |
78
+
79
+ ---
80
+
81
+ ### `database.py`
82
+ **Propósito:** Configuración de SQLAlchemy v2. Crea engine, `SessionLocal`, `Base` declarativa y la función generadora `get_db()` para inyección de dependencias.
83
+
84
+ **Patrón DI:** `get_db()` es un generador que hace `yield db` en try/finally, garantizando cierre de sesión.
85
+
86
+ ---
87
+
88
+ ### `models/cama.py`
89
+ **Propósito:** Modelo ORM para la entidad `Cama` (cama hospitalaria).
90
+
91
+ **Tabla:** `camas`
92
+ **Campos clave:** `id`, `numero` (String 20), `sector`, `tipo` (GENERAL/UCI/PEDIATRICA/NEONATAL/QUIROFANO), `estado` (DISPONIBLE/OCUPADA/EN_LIMPIEZA/FUERA_DE_SERVICIO), `hospital_id`, `activa`, `paciente_id`, `fecha_ultimo_cambio`
93
+
94
+ **Relaciones:** `reservas` (one-to-many → `ReservaQuirofano`)
95
+
96
+ ---
97
+
98
+ ### `models/solicitud.py`
99
+ **Propósito:** Modelo ORM para solicitudes de internación (INTERNACION o TRASLADO).
100
+
101
+ **Tabla:** `solicitudes_internacion`
102
+ **Campos clave:** `id`, `paciente_id`, `tipo` (INTERNACION/TRASLADO), `estado` (PENDIENTE/APROBADA/RECHAZADA/EN_PROCESO/COMPLETADA/CANCELADA), `prioridad`, `cama_id_origen`, `cama_id_destino`, `diagnostico_ingreso`, `observaciones`
103
+
104
+ ---
105
+
106
+ ### `models/reserva.py`
107
+ **Propósito:** Modelo ORM para reservas de quirófano.
108
+
109
+ **Tabla:** `reservas_quirofano`
110
+ **Campos clave:** `id`, `cama_id`, `turno_id`, `medico_id`, `paciente_id`, `estado` (RESERVADA/EN_CURSO/COMPLETADA/CANCELADA), `prioridad` (PROGRAMADA/URGENTE/EMERGENCIA), `origen` (HCE/QUIROFANO/URGENCIAS), `fecha_hora_inicio`, `fecha_hora_fin_estimada`
111
+
112
+ ---
113
+
114
+ ### `schemas/enums.py`
115
+ **Propósito:** Define todos los Enum de dominio del módulo como clases Python `str, Enum`.
116
+
117
+ **Enums definidos:** `EstadoCamaEnum`, `TipoCamaEnum`, `EstadoSolicitudEnum`, `TipoSolicitudEnum`, `PrioridadSolicitudEnum`, `EstadoReservaEnum`, `PrioridadQuirofanoEnum`, `OrigenReservaEnum`
118
+
119
+ ---
120
+
121
+ ### `auth/jwt_handler.py`
122
+ **Propósito:** Creación y decodificación de tokens JWT con `python-jose`.
123
+
124
+ **Funciones:** `create_access_token(data, expires_delta, extra)`, `decode_token(token)`
125
+
126
+ **Algoritmo:** HS256. Incluye `exp` en payload. El secret se lee de `settings.jwt_secret`.
127
+
128
+ ---
129
+
130
+ ### `auth/dependencies.py`
131
+ **Propósito:** Dependencias de FastAPI para autenticación y autorización.
132
+
133
+ **Funciones:**
134
+ - `get_current_user(token, db)` — decodifica JWT, valida usuario en BD
135
+ - `require_roles(*roles)` — factory que retorna dependencia verificando rol del usuario
136
+
137
+ ---
138
+
139
+ ### `services/external_client.py`
140
+ **Propósito:** Cliente HTTP centralizado para todas las llamadas salientes a módulos externos. Única fuente de llamadas `httpx` en el proyecto.
141
+
142
+ **Funciones de integración:**
143
+ | Función | Destino | Propósito |
144
+ |---------|---------|-----------|
145
+ | `validar_paciente(paciente_id)` | M10 Core | Verifica existencia del paciente |
146
+ | `obtener_contraindicaciones(paciente_id)` | M1 HCE | Lista contraindicaciones médicas |
147
+ | `notificar_movimiento_cama(...)` | M1 HCE | Notifica asignación/egreso de cama |
148
+ | `notificar_alta_monitoreo(...)` | M9 Monitoreo | Alta del paciente en monitoreo |
149
+ | `notificar_baja_monitoreo(...)` | M9 Monitoreo | Baja del paciente en monitoreo |
150
+ | `notificar_cama_lista(...)` | M7 Facturación | Aviso de cama lista para facturación |
151
+ | `notificar_resultado_quirofano(...)` | M2 Turnos | Resultado de la cirugía al módulo de turnos |
152
+
153
+ **Patrón de error:** `except Exception: return None` — fallas silenciadas sin logging.
154
+
155
+ ---
156
+
157
+ ### `services/cama_service.py`
158
+ **Propósito:** Lógica de negocio para gestión de camas y reservas de quirófano.
159
+
160
+ **Funciones principales:**
161
+ - `listar_camas(db, filtros)` — listado con filtros de sector/tipo/estado
162
+ - `crear_cama(db, data)` — crea cama validando duplicados
163
+ - `obtener_cama(db, cama_id)` — detalle con 404 automático
164
+ - `actualizar_cama(db, cama_id, data)` — actualización parcial
165
+ - `desactivar_cama(db, cama_id)` — soft delete (activa=False)
166
+ - `asignar_cama(db, cama_id, data)` — asigna paciente + valida contraindicaciones + notifica M1/M9/M7
167
+ - `listar_reservas(db, cama_id, filtros)` — reservas de un quirófano
168
+ - `crear_reserva(db, cama_id, data)` — reserva programada con detección de conflictos
169
+ - `obtener_reserva(db, reserva_id)` — detalle de reserva
170
+ - `actualizar_estado_reserva(db, reserva_id, data)` — cambio de estado con transición validada
171
+ - `crear_reserva_urgente(db, data)` — reserva de emergencia con lógica de desplazamiento
172
+
173
+ ---
174
+
175
+ ### `services/solicitud_service.py`
176
+ **Propósito:** Lógica de negocio para solicitudes de internación y traslado.
177
+
178
+ **Funciones principales:**
179
+ - `listar_solicitudes(db, filtros)` — listado con filtros de estado/tipo
180
+ - `obtener_solicitud(db, solicitud_id)` — detalle con 404
181
+ - `crear_solicitud_desde_webhook(db, data)` — recibe solicitud de M1 HCE
182
+ - `actualizar_estado_solicitud(db, solicitud_id, data)` — aprobación/rechazo/completado
183
+ - `_aprobar_internacion(db, solicitud, cama_id)` — asigna cama para internación
184
+ - `_aprobar_traslado(db, solicitud)` — mueve paciente entre camas
185
+
186
+ ---
187
+
188
+ ### `routers/camas.py`
189
+ **Propósito:** Endpoints REST para gestión de camas y reservas de quirófano. Solo parsea input, llama service, retorna response.
190
+
191
+ **Endpoints:**
192
+ | Método | Path | Roles | Descripción |
193
+ |--------|------|-------|-------------|
194
+ | `GET` | `/api/v1/camas` | MEDICO/ADMIN/LIMPIEZA | Listar camas con filtros |
195
+ | `POST` | `/api/v1/camas` | ADMIN | Crear cama |
196
+ | `GET` | `/api/v1/camas/disponibilidad` | MEDICO/ADMIN | Disponibilidad de quirófanos |
197
+ | `GET` | `/api/v1/camas/{id}` | MEDICO/ADMIN/LIMPIEZA | Detalle de cama |
198
+ | `PATCH` | `/api/v1/camas/{id}` | ADMIN | Actualizar cama |
199
+ | `DELETE` | `/api/v1/camas/{id}` | ADMIN | Desactivar cama |
200
+ | `POST` | `/api/v1/camas/{id}/asignar` | MEDICO/ADMIN | Asignar paciente |
201
+ | `GET` | `/api/v1/camas/{id}/reservas` | MEDICO/ADMIN | Listar reservas quirófano |
202
+ | `POST` | `/api/v1/camas/{id}/reservas` | MEDICO/ADMIN* | Crear reserva quirófano |
203
+ | `GET` | `/api/v1/camas/{id}/reservas/{rid}` | MEDICO/ADMIN | Detalle reserva |
204
+ | `PATCH` | `/api/v1/camas/{id}/reservas/{rid}` | MEDICO/ADMIN | Actualizar estado reserva |
205
+
206
+ *⚠️ `POST /reservas` usa `get_current_user` en lugar de `require_roles` — bug de autorización.
207
+
208
+ ---
209
+
210
+ ### `routers/solicitudes.py`
211
+ **Propósito:** Endpoints REST para solicitudes de internación.
212
+
213
+ **Endpoints:**
214
+ | Método | Path | Roles | Descripción |
215
+ |--------|------|-------|-------------|
216
+ | `GET` | `/api/v1/solicitudes` | MEDICO/ADMIN | Listar solicitudes con filtros |
217
+ | `GET` | `/api/v1/solicitudes/{id}` | MEDICO/ADMIN | Detalle de solicitud |
218
+ | `PATCH` | `/api/v1/solicitudes/{id}` | MEDICO/ADMIN | Aprobar/rechazar/actualizar |
219
+
220
+ ---
221
+
222
+ ### `routers/webhooks.py`
223
+ **Propósito:** Endpoints inbound para eventos enviados por módulos externos.
224
+
225
+ **Endpoints:**
226
+ | Método | Path | Origen | Evento |
227
+ |--------|------|--------|--------|
228
+ | `POST` | `/api/v1/webhooks/hce/solicitud` | M1 HCE | Nueva solicitud de internación |
229
+ | `POST` | `/api/v1/webhooks/hce/alta-medica` | M1 HCE | Alta médica del paciente |
230
+ | `POST` | `/api/v1/webhooks/hce/cirugia-urgente` | M1 HCE | Solicitud de cirugía urgente |
231
+ | `POST` | `/api/v1/webhooks/turnos/{turno_id}/cancelacion-quirofano` | M2 Turnos | Cancelación de turno quirúrgico |
232
+ | `POST` | `/api/v1/webhooks/monitoreo/alerta-emergencia` | M9 Monitoreo | Alerta de emergencia activa |
233
+ | `POST` | `/api/v1/webhooks/monitoreo/alerta-resuelta` | M9 Monitoreo | Resolución de alerta |
234
+
235
+ ---
236
+
237
+ ## Resumen de arquitectura observada
238
+
239
+ El proyecto implementa una **arquitectura de 4 capas**:
240
+
241
+ ```
242
+ Router (HTTP) → Service (negocio) → ORM Model (datos) → PostgreSQL
243
+ ↓
244
+ external_client.py → Módulos externos (M1/M2/M7/M9/M10)
245
+ ```
246
+
247
+ **Inyección de dependencias:** correctamente implementada mediante `Depends(get_db)` para sesión de BD y `Depends(require_roles(...))` para autorización.
248
+
249
+ **Separación de concerns:** mayoritariamente respetada — los routers no contienen lógica de negocio. Las llamadas HTTP salientes están centralizadas en `external_client.py`.
250
+
251
+ **Puntos débiles arquitectónicos:**
252
+ - No existe capa CRUD/Repository separada — los services acceden directamente al ORM
253
+ - `external_client.py` es un único archivo monolítico para 5 integraciones distintas
254
+ - No hay tests (ningún archivo `test_*.py` encontrado)
255
+ - La lógica de errores de integración está silenciada (fallas no visibles)
256
+
257
+ ---
258
+
259
+ ## Mapa de integraciones externas
260
+
261
+ ```
262
+ Módulo 6 (Internación)
263
+ │
264
+ ├── [INBOUND WEBHOOKS]
265
+ │ ├── ← M1 HCE (solicitud, alta-medica, cirugia-urgente)
266
+ │ ├── ← M2 Turnos (cancelacion-quirofano)
267
+ │ └── ← M9 Monitoreo (alerta-emergencia, alerta-resuelta)
268
+ │
269
+ └── [OUTBOUND HTTP]
270
+ ├── → M10 Core :8010 — validar_paciente()
271
+ ├── → M1 HCE :8001 — obtener_contraindicaciones(), notificar_movimiento_cama()
272
+ ├── → M9 Monitoreo:8009 — notificar_alta/baja_monitoreo()
273
+ ├── → M7 Facturación:8007 — notificar_cama_lista()
274
+ └── → M2 Turnos :8002 — notificar_resultado_quirofano()
275
+ ```
backend/Dockerfile ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ FROM python:3.12-slim
2
+
3
+ WORKDIR /app
4
+
5
+ COPY requirements.txt .
6
+ RUN pip install --no-cache-dir -r requirements.txt
7
+
8
+ COPY . .
9
+
10
+ EXPOSE 8006
11
+
12
+ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8006", "--reload"]
backend/auth/__init__.py ADDED
File without changes
backend/auth/dependencies.py ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from fastapi import Depends, HTTPException, status
2
+ from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
3
+ from auth.jwt_handler import decode_token
4
+
5
+ security = HTTPBearer()
6
+
7
+ _ERROR_401 = {"codigo": "NO_AUTENTICADO", "mensaje": "Token ausente, expirado o malformado"}
8
+ _ERROR_403 = {"codigo": "NO_AUTORIZADO", "mensaje": "No tiene permisos para esta operación"}
9
+
10
+
11
+ def get_current_user(
12
+ credentials: HTTPAuthorizationCredentials = Depends(security),
13
+ ) -> dict:
14
+ """Extrae y valida el JWT. Devuelve el payload con 'sub' y 'rol'."""
15
+ try:
16
+ payload = decode_token(credentials.credentials)
17
+ except ValueError:
18
+ raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail=_ERROR_401)
19
+
20
+ if "sub" not in payload or "rol" not in payload:
21
+ raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail=_ERROR_401)
22
+
23
+ return payload
24
+
25
+
26
+ def require_roles(*roles: str):
27
+ """
28
+ Devuelve una dependencia que verifica que el usuario tenga uno de los roles indicados.
29
+ Uso: Depends(require_roles("ADMINISTRATIVO", "MEDICO"))
30
+ """
31
+ def checker(user: dict = Depends(get_current_user)) -> dict:
32
+ if user.get("rol") not in roles:
33
+ raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail=_ERROR_403)
34
+ return user
35
+ return checker
backend/auth/jwt_handler.py ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from datetime import datetime, timedelta, timezone
2
+ from typing import Optional
3
+ from jose import JWTError, jwt
4
+ from config import settings
5
+
6
+
7
+ def create_access_token(sub: str, rol: str, extra: dict = None) -> str:
8
+ """Genera un JWT firmado con el secret del módulo."""
9
+ now = datetime.now(timezone.utc)
10
+ payload = {
11
+ "sub": str(sub),
12
+ "rol": rol,
13
+ "iat": now,
14
+ "exp": now + timedelta(minutes=settings.jwt_expire_minutes),
15
+ }
16
+ if extra:
17
+ payload.update(extra)
18
+ return jwt.encode(payload, settings.jwt_secret, algorithm=settings.jwt_algorithm)
19
+
20
+
21
+ def decode_token(token: str) -> dict:
22
+ """
23
+ Decodifica y valida un JWT.
24
+ En producción esto llamaría a M10 (Core) para validar.
25
+ En este módulo validamos el token localmente con el secret compartido.
26
+ """
27
+ try:
28
+ payload = jwt.decode(
29
+ token,
30
+ settings.jwt_secret,
31
+ algorithms=[settings.jwt_algorithm],
32
+ )
33
+ return payload
34
+ except JWTError as e:
35
+ raise ValueError(f"Token inválido: {e}")
backend/config.py ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from pydantic_settings import BaseSettings
2
+
3
+
4
+ class Settings(BaseSettings):
5
+ # Base de datos
6
+ database_url: str = "postgresql://admin:secret@localhost:5432/internacion_db"
7
+
8
+ # JWT
9
+ jwt_secret: str = "supersecretkey_change_in_production"
10
+ jwt_algorithm: str = "HS256"
11
+ jwt_expire_minutes: int = 60
12
+
13
+ # URLs de módulos externos
14
+ m1_hce_url: str = "http://localhost:8001"
15
+ m2_turnos_url: str = "http://localhost:8002"
16
+ m7_facturacion_url: str = "http://localhost:8007"
17
+ m9_monitoreo_url: str = "http://localhost:8009"
18
+ m10_core_url: str = "http://localhost:8010"
19
+
20
+ # Mock externos (si True, no llama a los otros módulos)
21
+ mock_external_services: bool = True
22
+
23
+ class Config:
24
+ env_file = ".env"
25
+ case_sensitive = False
26
+
27
+
28
+ settings = Settings()
backend/database.py ADDED
@@ -0,0 +1,24 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from sqlalchemy import create_engine
2
+ from sqlalchemy.orm import sessionmaker, DeclarativeBase
3
+ from config import settings
4
+
5
+ engine = create_engine(
6
+ settings.database_url,
7
+ pool_pre_ping=True,
8
+ pool_size=5,
9
+ max_overflow=10,
10
+ )
11
+
12
+ SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
13
+
14
+
15
+ class Base(DeclarativeBase):
16
+ pass
17
+
18
+
19
+ def get_db():
20
+ db = SessionLocal()
21
+ try:
22
+ yield db
23
+ finally:
24
+ db.close()