juampisor commited on
Commit
3f2c35b
·
1 Parent(s): 244663c

Fix a numero de cama en endpoint de camas. PGAdmin removido de docker compose. Readme y documentacion actualizada

Browse files
.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
- # 1. Copiar variables de entorno y editarlas
22
- cp .env.example .env
23
- # Editar .env: JWT_SECRET, POSTGRES_PASSWORD (OBLIGATORIO antes de producción)
 
 
 
 
 
 
24
 
25
- # 2. Levantar con Docker Compose
 
 
 
 
 
26
  docker compose up --build
27
  ```
28
 
29
- El backend queda disponible en `http://localhost:8006/api/v1`.
30
 
31
- Para desarrollo con hot-reload:
32
 
33
  ```bash
34
- cd modulo6
35
  pip install -r requirements.txt
36
- uvicorn app.main:app --host 0.0.0.0 --port 8006 --reload
37
  ```
38
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
39
  ---
40
 
41
  ## Documentación interactiva
42
 
43
  | URL | Descripción |
44
  | ---------------------------------- | ------------------------ |
45
- | http://localhost:8006/api/v1/docs | Swagger UI (interactivo) |
46
- | http://localhost:8006/api/v1/redoc | ReDoc (legible) |
47
- | http://localhost:8006/health | Health check |
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:8006/api/v1/auth/token?usuario=ADMINISTRATIVO&password=any"
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
- | `ENVIRONMENT` | No | `development` o `production` (default: `production`) |
83
- | `ALLOWED_ORIGINS` | No | Lista JSON de orígenes CORS permitidos |
84
- | `MOCK_EXTERNAL_SERVICES` | No | `true` = no llama a módulos externos (default: `true`) |
85
- | `HTTP_TIMEOUT_SECONDS` | No | Timeout para llamadas externas en segundos (default: `5.0`) |
86
- | `M1_HCE_URL` | No | URL del Módulo 1 - HCE |
87
- | `M2_TURNOS_URL` | No | URL del Módulo 2 - Turnos |
88
- | `M7_FACTURACION_URL` | No | URL del Módulo 7 - Facturación |
89
- | `M9_MONITOREO_URL` | No | URL del Módulo 9 - Monitoreo |
90
- | `M10_CORE_URL` | No | URL del Módulo 10 - Core |
 
 
91
 
92
  ---
93
 
@@ -205,6 +235,6 @@ modulo6/
205
  ## Correr tests
206
 
207
  ```bash
208
- pip install pytest pytest-asyncio
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(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)
 
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: str = Field(..., min_length=1, max_length=20)
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("numero", "hospital_id", mode="before")
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: str
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.