Spaces:
Runtime error
Runtime error
Fix a numero de cama en endpoint de camas. PGAdmin removido de docker compose. Readme y documentacion actualizada
Browse files- .claude/settings.local.json +3 -1
- .env.example +0 -1
- README.md +58 -28
- app/models/cama.py +1 -1
- app/schemas/cama.py +5 -3
- docker-compose.yml +0 -10
- documentation/M6_DISEÑO.md +3 -1
.claude/settings.local.json
CHANGED
|
@@ -9,7 +9,9 @@
|
|
| 9 |
"Bash(git fetch *)",
|
| 10 |
"Bash(git stash *)",
|
| 11 |
"Bash(git pull *)",
|
| 12 |
-
"Bash(python3 -m py_compile app/main.py app/crud/solicitud.py app/integrations/hce.py app/routers/webhooks.py app/schemas/cama.py app/schemas/enums.py app/services/cama_service.py app/services/solicitud_service.py)"
|
|
|
|
|
|
|
| 13 |
]
|
| 14 |
}
|
| 15 |
}
|
|
|
|
| 9 |
"Bash(git fetch *)",
|
| 10 |
"Bash(git stash *)",
|
| 11 |
"Bash(git pull *)",
|
| 12 |
+
"Bash(python3 -m py_compile app/main.py app/crud/solicitud.py app/integrations/hce.py app/routers/webhooks.py app/schemas/cama.py app/schemas/enums.py app/services/cama_service.py app/services/solicitud_service.py)",
|
| 13 |
+
"Bash(docker exec *)",
|
| 14 |
+
"Bash(docker run *)"
|
| 15 |
]
|
| 16 |
}
|
| 17 |
}
|
.env.example
CHANGED
|
@@ -1,5 +1,4 @@
|
|
| 1 |
# ─── Base de datos ─────────────────────────────────────────────────────────
|
| 2 |
-
# Formato Neon: postgresql://USUARIO:CONTRASEÑA@HOST/NOMBRE_BD?sslmode=require&channel_binding=require
|
| 3 |
DATABASE_URL=postgresql://USUARIO:CONTRASEÑA@HOST/NOMBRE_BD?sslmode=require&channel_binding=require
|
| 4 |
|
| 5 |
# ─── JWT ───────────────────────────────────────────────────────────────────
|
|
|
|
| 1 |
# ─── Base de datos ─────────────────────────────────────────────────────────
|
|
|
|
| 2 |
DATABASE_URL=postgresql://USUARIO:CONTRASEÑA@HOST/NOMBRE_BD?sslmode=require&channel_binding=require
|
| 3 |
|
| 4 |
# ─── JWT ───────────────────────────────────────────────────────────────────
|
README.md
CHANGED
|
@@ -17,34 +17,65 @@ Módulo 6 del sistema multi-módulo Health Grid. Gestiona camas hospitalarias, s
|
|
| 17 |
|
| 18 |
## Levantar el proyecto
|
| 19 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 20 |
```bash
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 24 |
|
| 25 |
-
#
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 26 |
docker compose up --build
|
| 27 |
```
|
| 28 |
|
| 29 |
-
El backend queda disponible en `http://localhost:
|
| 30 |
|
| 31 |
-
|
| 32 |
|
| 33 |
```bash
|
| 34 |
-
cd modulo6
|
| 35 |
pip install -r requirements.txt
|
| 36 |
-
uvicorn app.main:app --host 0.0.0.0 --port
|
| 37 |
```
|
| 38 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 39 |
---
|
| 40 |
|
| 41 |
## Documentación interactiva
|
| 42 |
|
| 43 |
| URL | Descripción |
|
| 44 |
| ---------------------------------- | ------------------------ |
|
| 45 |
-
| http://localhost:
|
| 46 |
-
| http://localhost:
|
| 47 |
-
| http://localhost:
|
| 48 |
|
| 49 |
---
|
| 50 |
|
|
@@ -53,7 +84,7 @@ uvicorn app.main:app --host 0.0.0.0 --port 8006 --reload
|
|
| 53 |
El módulo usa JWT (HS256). Para desarrollo, expone un generador de tokens cuando `ENVIRONMENT=development`:
|
| 54 |
|
| 55 |
```bash
|
| 56 |
-
curl "http://localhost:
|
| 57 |
```
|
| 58 |
|
| 59 |
En producción (`ENVIRONMENT=production`), este endpoint devuelve 404. Los tokens de producción deben provenir de M10 (Core).
|
|
@@ -72,22 +103,21 @@ Authorization: Bearer <token>
|
|
| 72 |
|
| 73 |
Copiar `.env.example` a `.env` y completar:
|
| 74 |
|
| 75 |
-
| Variable | Requerida | Descripción
|
| 76 |
-
| ------------------------ | --------- | ----------------------------------------------------------------------------------------------------------- |
|
| 77 |
-
| `DATABASE_URL` | **SÍ** | Cadena de conexión PostgreSQL
|
| 78 |
-
| `POSTGRES_DB` | **SÍ** | Nombre de la base de datos |
|
| 79 |
-
| `POSTGRES_USER` | **SÍ** | Usuario de PostgreSQL |
|
| 80 |
-
| `POSTGRES_PASSWORD` | **SÍ** | Contraseña de PostgreSQL |
|
| 81 |
| `JWT_SECRET` | **SÍ** | Secret de 64+ chars para firmar JWT. Generar con `python -c "import secrets; print(secrets.token_hex(32))"` |
|
| 82 |
-
| `
|
| 83 |
-
| `
|
| 84 |
-
| `
|
| 85 |
-
| `
|
| 86 |
-
| `
|
| 87 |
-
| `
|
| 88 |
-
| `
|
| 89 |
-
| `
|
| 90 |
-
| `
|
|
|
|
|
|
|
| 91 |
|
| 92 |
---
|
| 93 |
|
|
@@ -205,6 +235,6 @@ modulo6/
|
|
| 205 |
## Correr tests
|
| 206 |
|
| 207 |
```bash
|
| 208 |
-
pip install
|
| 209 |
pytest tests/ -v
|
| 210 |
```
|
|
|
|
| 17 |
|
| 18 |
## Levantar el proyecto
|
| 19 |
|
| 20 |
+
**Prerequisitos:** tener Docker instalado y corriendo. Copiar `.env.example` a `.env` y completar `DATABASE_URL` y `JWT_SECRET` antes de arrancar.
|
| 21 |
+
|
| 22 |
+
### Mac (con Colima)
|
| 23 |
+
|
| 24 |
+
Colima puede tener problemas de DNS por defecto. Levantarlo así:
|
| 25 |
+
|
| 26 |
```bash
|
| 27 |
+
colima start --dns 8.8.8.8
|
| 28 |
+
```
|
| 29 |
+
|
| 30 |
+
Luego:
|
| 31 |
+
|
| 32 |
+
```bash
|
| 33 |
+
cp .env.example .env # completar DATABASE_URL y JWT_SECRET
|
| 34 |
+
docker compose up --build
|
| 35 |
+
```
|
| 36 |
|
| 37 |
+
### Windows (con Docker Desktop)
|
| 38 |
+
|
| 39 |
+
Docker Desktop ya maneja DNS automáticamente:
|
| 40 |
+
|
| 41 |
+
```bash
|
| 42 |
+
copy .env.example .env # completar DATABASE_URL y JWT_SECRET
|
| 43 |
docker compose up --build
|
| 44 |
```
|
| 45 |
|
| 46 |
+
El backend queda disponible en `http://localhost:7860`.
|
| 47 |
|
| 48 |
+
### Desarrollo local con hot-reload (sin Docker)
|
| 49 |
|
| 50 |
```bash
|
|
|
|
| 51 |
pip install -r requirements.txt
|
| 52 |
+
uvicorn app.main:app --host 0.0.0.0 --port 7860 --reload
|
| 53 |
```
|
| 54 |
|
| 55 |
+
> Requiere Python 3.12 y tener el `.env` configurado en la raíz del repo.
|
| 56 |
+
|
| 57 |
+
### Base de datos
|
| 58 |
+
|
| 59 |
+
La app usa **Supabase** (PostgreSQL). Al arrancar, `create_all` crea las tablas automáticamente si no existen. Si necesitás resetear las tablas:
|
| 60 |
+
|
| 61 |
+
```sql
|
| 62 |
+
-- Ejecutar en Supabase SQL Editor
|
| 63 |
+
DROP TABLE IF EXISTS reservas_quirofano CASCADE;
|
| 64 |
+
DROP TABLE IF EXISTS solicitudes CASCADE;
|
| 65 |
+
DROP TABLE IF EXISTS camas CASCADE;
|
| 66 |
+
```
|
| 67 |
+
|
| 68 |
+
Luego reiniciar el contenedor para que las recree.
|
| 69 |
+
|
| 70 |
---
|
| 71 |
|
| 72 |
## Documentación interactiva
|
| 73 |
|
| 74 |
| URL | Descripción |
|
| 75 |
| ---------------------------------- | ------------------------ |
|
| 76 |
+
| http://localhost:7860/api/v1/docs | Swagger UI (interactivo) |
|
| 77 |
+
| http://localhost:7860/api/v1/redoc | ReDoc (legible) |
|
| 78 |
+
| http://localhost:7860/health | Health check |
|
| 79 |
|
| 80 |
---
|
| 81 |
|
|
|
|
| 84 |
El módulo usa JWT (HS256). Para desarrollo, expone un generador de tokens cuando `ENVIRONMENT=development`:
|
| 85 |
|
| 86 |
```bash
|
| 87 |
+
curl "http://localhost:7860/api/v1/auth/token?usuario=ADMINISTRATIVO&password=any"
|
| 88 |
```
|
| 89 |
|
| 90 |
En producción (`ENVIRONMENT=production`), este endpoint devuelve 404. Los tokens de producción deben provenir de M10 (Core).
|
|
|
|
| 103 |
|
| 104 |
Copiar `.env.example` a `.env` y completar:
|
| 105 |
|
| 106 |
+
| Variable | Requerida | Descripción |
|
| 107 |
+
| ------------------------ | --------- | ------------------------------------------------------------------------------------------------------------ |
|
| 108 |
+
| `DATABASE_URL` | **SÍ** | Cadena de conexión Neon (PostgreSQL). Formato: `postgresql://USER:PASS@HOST/DB?sslmode=require&...` |
|
|
|
|
|
|
|
|
|
|
| 109 |
| `JWT_SECRET` | **SÍ** | Secret de 64+ chars para firmar JWT. Generar con `python -c "import secrets; print(secrets.token_hex(32))"` |
|
| 110 |
+
| `JWT_ALGORITHM` | No | Algoritmo JWT (default: `HS256`) |
|
| 111 |
+
| `JWT_EXPIRE_MINUTES` | No | Duración del token en minutos (default: `60`) |
|
| 112 |
+
| `ENVIRONMENT` | No | `development` o `production` (default: `production`). En `development` habilita `/auth/token` |
|
| 113 |
+
| `ALLOWED_ORIGINS` | No | Lista JSON de orígenes CORS permitidos |
|
| 114 |
+
| `MOCK_EXTERNAL_SERVICES` | No | `true` = no llama a módulos externos (default: `true`) |
|
| 115 |
+
| `HTTP_TIMEOUT_SECONDS` | No | Timeout para llamadas externas en segundos (default: `5.0`) |
|
| 116 |
+
| `M1_HCE_URL` | No | URL del Módulo 1 - HCE |
|
| 117 |
+
| `M2_TURNOS_URL` | No | URL del Módulo 2 - Turnos |
|
| 118 |
+
| `M7_FACTURACION_URL` | No | URL del Módulo 7 - Facturación |
|
| 119 |
+
| `M9_MONITOREO_URL` | No | URL del Módulo 9 - Monitoreo |
|
| 120 |
+
| `M10_CORE_URL` | No | URL del Módulo 10 - Core |
|
| 121 |
|
| 122 |
---
|
| 123 |
|
|
|
|
| 235 |
## Correr tests
|
| 236 |
|
| 237 |
```bash
|
| 238 |
+
pip install -r requirements-dev.txt
|
| 239 |
pytest tests/ -v
|
| 240 |
```
|
app/models/cama.py
CHANGED
|
@@ -10,7 +10,7 @@ class Cama(Base):
|
|
| 10 |
__tablename__ = "camas"
|
| 11 |
|
| 12 |
id = Column(Integer, primary_key=True, autoincrement=True)
|
| 13 |
-
numero = Column(
|
| 14 |
piso = Column(Integer, nullable=False)
|
| 15 |
# SectorEnum: UTI | SALA_COMUN | QUIROFANO | GUARDIA | NEONATOLOGIA
|
| 16 |
sector = Column(String(20), nullable=False)
|
|
|
|
| 10 |
__tablename__ = "camas"
|
| 11 |
|
| 12 |
id = Column(Integer, primary_key=True, autoincrement=True)
|
| 13 |
+
numero = Column(Integer, nullable=False)
|
| 14 |
piso = Column(Integer, nullable=False)
|
| 15 |
# SectorEnum: UTI | SALA_COMUN | QUIROFANO | GUARDIA | NEONATOLOGIA
|
| 16 |
sector = Column(String(20), nullable=False)
|
app/schemas/cama.py
CHANGED
|
@@ -6,7 +6,7 @@ from app.schemas.enums import EstadoCamaEnum, SectorEnum, TipoCamaEnum
|
|
| 6 |
|
| 7 |
|
| 8 |
class CamaCreateRequest(BaseModel):
|
| 9 |
-
numero:
|
| 10 |
piso: int
|
| 11 |
sector: SectorEnum
|
| 12 |
tipo: TipoCamaEnum
|
|
@@ -14,9 +14,11 @@ class CamaCreateRequest(BaseModel):
|
|
| 14 |
hospital_id: str = Field(..., min_length=1, max_length=50)
|
| 15 |
contraindicaciones_incompatibles: list[str] = []
|
| 16 |
|
| 17 |
-
@field_validator("
|
| 18 |
@classmethod
|
| 19 |
def strip_and_require(cls, v: str) -> str:
|
|
|
|
|
|
|
| 20 |
v = v.strip()
|
| 21 |
if not v:
|
| 22 |
raise ValueError("El campo no puede estar vacío o contener solo espacios")
|
|
@@ -32,7 +34,7 @@ class CamaResponse(BaseModel):
|
|
| 32 |
model_config = ConfigDict(from_attributes=True)
|
| 33 |
|
| 34 |
id: int
|
| 35 |
-
numero:
|
| 36 |
piso: int
|
| 37 |
sector: SectorEnum
|
| 38 |
tipo: TipoCamaEnum
|
|
|
|
| 6 |
|
| 7 |
|
| 8 |
class CamaCreateRequest(BaseModel):
|
| 9 |
+
numero: int
|
| 10 |
piso: int
|
| 11 |
sector: SectorEnum
|
| 12 |
tipo: TipoCamaEnum
|
|
|
|
| 14 |
hospital_id: str = Field(..., min_length=1, max_length=50)
|
| 15 |
contraindicaciones_incompatibles: list[str] = []
|
| 16 |
|
| 17 |
+
@field_validator("hospital_id", mode="before")
|
| 18 |
@classmethod
|
| 19 |
def strip_and_require(cls, v: str) -> str:
|
| 20 |
+
if not isinstance(v, str):
|
| 21 |
+
return v
|
| 22 |
v = v.strip()
|
| 23 |
if not v:
|
| 24 |
raise ValueError("El campo no puede estar vacío o contener solo espacios")
|
|
|
|
| 34 |
model_config = ConfigDict(from_attributes=True)
|
| 35 |
|
| 36 |
id: int
|
| 37 |
+
numero: int
|
| 38 |
piso: int
|
| 39 |
sector: SectorEnum
|
| 40 |
tipo: TipoCamaEnum
|
docker-compose.yml
CHANGED
|
@@ -12,13 +12,3 @@ services:
|
|
| 12 |
# Solo en desarrollo — remover en producción
|
| 13 |
- ./app:/app/app
|
| 14 |
restart: unless-stopped
|
| 15 |
-
|
| 16 |
-
pgadmin:
|
| 17 |
-
image: dpage/pgadmin4:latest
|
| 18 |
-
container_name: m6_pgadmin
|
| 19 |
-
environment:
|
| 20 |
-
PGADMIN_DEFAULT_EMAIL: ${PGADMIN_EMAIL:-admin@admin.com}
|
| 21 |
-
PGADMIN_DEFAULT_PASSWORD: ${PGADMIN_PASSWORD:-admin}
|
| 22 |
-
ports:
|
| 23 |
-
- "5050:80"
|
| 24 |
-
restart: unless-stopped
|
|
|
|
| 12 |
# Solo en desarrollo — remover en producción
|
| 13 |
- ./app:/app/app
|
| 14 |
restart: unless-stopped
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
documentation/M6_DISEÑO.md
CHANGED
|
@@ -82,7 +82,7 @@ Esta separación es la decisión arquitectónica central del módulo y hay que p
|
|
| 82 |
|
| 83 |
### 4.1 Entidades
|
| 84 |
|
| 85 |
-
- **Cama:** unidad física de internación. Identificada por `id` (integer). Atributos clave: `numero`, `piso`, `sector`, `tipo`, `estado`, `paciente_id` (nullable), `hospital_id`, `specialty_id` (nullable), `contraindicaciones_incompatibles` (lista de strings).
|
| 86 |
- **Quirófano:** **es una especialización de Cama** con `sector=QUIROFANO` y `tipo=CIRUGIA`. Comparte tabla y máquina de estados con Cama (ver decisión en §10). Se expone bajo su propio recurso `/quirofanos` por claridad de API, pero internamente es la misma entidad.
|
| 87 |
- **Solicitud:** pedido de internación o traslado originado en HCE (M1). Identificada por `id` string (`SOL-00123`) y vinculada al id de origen `solicitud_hce_id`. Vive en estado `PENDIENTE` hasta que un administrativo la resuelve.
|
| 88 |
- **Reserva de quirófano:** ocupación de un quirófano en una ventana horaria, programada o de emergencia. Una urgente puede desplazar a una programada (`desplazada_por_reserva_id`).
|
|
@@ -344,6 +344,8 @@ Autenticación por JWT centralizada en Core (M10). Un middleware en FastAPI vali
|
|
| 344 |
9. **`WebhookCamaLista.evento` (EXTRA D).** Era `string` libre. Corregido a enum **`{CAMA_LISTA}`**, consistente con `WebhookAltaMonitoreo.evento` y `WebhookBajaMonitoreo.evento`.
|
| 345 |
10. **`Ext_MovimientoRequest.resultado` (EXTRA E).** Era `string` libre pese a que la description decía "APROBADA o RECHAZADA". Tipado como enum **`{APROBADA, RECHAZADA}`**, `nullable: true`.
|
| 346 |
|
|
|
|
|
|
|
| 347 |
### 14.2 Pendientes
|
| 348 |
|
| 349 |
1. **`security` global vacío.** El spec declara el esquema `BearerAuth` pero deja `security` vacío a nivel raíz. Falta declarar **`security: [{ BearerAuth: [] }]`** para que la protección sea explícita en el contrato.
|
|
|
|
| 82 |
|
| 83 |
### 4.1 Entidades
|
| 84 |
|
| 85 |
+
- **Cama:** unidad física de internación. Identificada por `id` (integer). Atributos clave: `numero` (integer), `piso` (integer), `sector`, `tipo`, `estado`, `paciente_id` (nullable integer), `hospital_id`, `specialty_id` (nullable integer), `contraindicaciones_incompatibles` (lista de strings).
|
| 86 |
- **Quirófano:** **es una especialización de Cama** con `sector=QUIROFANO` y `tipo=CIRUGIA`. Comparte tabla y máquina de estados con Cama (ver decisión en §10). Se expone bajo su propio recurso `/quirofanos` por claridad de API, pero internamente es la misma entidad.
|
| 87 |
- **Solicitud:** pedido de internación o traslado originado en HCE (M1). Identificada por `id` string (`SOL-00123`) y vinculada al id de origen `solicitud_hce_id`. Vive en estado `PENDIENTE` hasta que un administrativo la resuelve.
|
| 88 |
- **Reserva de quirófano:** ocupación de un quirófano en una ventana horaria, programada o de emergencia. Una urgente puede desplazar a una programada (`desplazada_por_reserva_id`).
|
|
|
|
| 344 |
9. **`WebhookCamaLista.evento` (EXTRA D).** Era `string` libre. Corregido a enum **`{CAMA_LISTA}`**, consistente con `WebhookAltaMonitoreo.evento` y `WebhookBajaMonitoreo.evento`.
|
| 345 |
10. **`Ext_MovimientoRequest.resultado` (EXTRA E).** Era `string` libre pese a que la description decía "APROBADA o RECHAZADA". Tipado como enum **`{APROBADA, RECHAZADA}`**, `nullable: true`.
|
| 346 |
|
| 347 |
+
11. **`Cama.numero` tipo corregido.** Era `string` en el modelo y schema. Corregido a **`integer`** para reflejar que el número de cama es siempre un valor numérico.
|
| 348 |
+
|
| 349 |
### 14.2 Pendientes
|
| 350 |
|
| 351 |
1. **`security` global vacío.** El spec declara el esquema `BearerAuth` pero deja `security` vacío a nivel raíz. Falta declarar **`security: [{ BearerAuth: [] }]`** para que la protección sea explícita en el contrato.
|