✅ Cambios Implementados:
1. PostgreSQL (Base de Datos) Variables de entorno: TZ=Atlantic/Canary y PGTZ=Atlantic/Canary Configurado en todos los archivos Docker: docker-compose.yml, docker-compose.prod.yml, docker-stack.yml 2. Backend (FastAPI/Python) Configuración de zona horaria al inicio de main.py Conexión a PostgreSQL con parámetro de timezone Event listener que establece timezone en cada conexión a la BD Variable de entorno: TZ=Atlantic/Canary 3. Frontend (React) Ya estaba usando fechas locales correctamente con el constructor new Date(year, month, day) 4. Migración SQL Creado set_timezone_canary.sql para actualizar la BD existente
This commit is contained in:
209
TIMEZONE_SETUP.md
Normal file
209
TIMEZONE_SETUP.md
Normal file
@@ -0,0 +1,209 @@
|
||||
# Configuración de Zona Horaria - Atlantic/Canary
|
||||
|
||||
## Cambios Implementados
|
||||
|
||||
Se ha configurado la zona horaria de **Atlantic/Canary (Islas Canarias, España)** en toda la aplicación:
|
||||
|
||||
### 1. Base de Datos PostgreSQL
|
||||
- **Zona horaria**: `Atlantic/Canary` (UTC+0 en invierno, UTC+1 en verano con horario de verano)
|
||||
- Variables de entorno agregadas:
|
||||
- `TZ=Atlantic/Canary`
|
||||
- `PGTZ=Atlantic/Canary`
|
||||
|
||||
### 2. Backend FastAPI
|
||||
- Configuración de zona horaria de Python al inicio de la aplicación
|
||||
- Conexión a PostgreSQL configurada con timezone
|
||||
- Event listener para establecer timezone en cada conexión
|
||||
- Variable de entorno: `TZ=Atlantic/Canary`
|
||||
|
||||
### 3. Frontend React
|
||||
- Los filtros de fecha usan el constructor de Date con zona horaria local
|
||||
- Las fechas se muestran en formato español (es-ES)
|
||||
|
||||
## Aplicar los Cambios
|
||||
|
||||
### Desarrollo Local
|
||||
|
||||
1. **Parar los contenedores actuales**:
|
||||
```powershell
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
2. **Aplicar la migración de zona horaria a la base de datos**:
|
||||
```powershell
|
||||
docker-compose up -d postgres
|
||||
|
||||
# Esperar a que PostgreSQL esté listo
|
||||
Start-Sleep -Seconds 5
|
||||
|
||||
# Aplicar migración
|
||||
docker-compose exec postgres psql -U checklist_user -d checklist_db -f /docker-entrypoint-initdb.d/../migrations/set_timezone_canary.sql
|
||||
```
|
||||
|
||||
**Alternativa manual**:
|
||||
```powershell
|
||||
# Copiar el archivo SQL al contenedor
|
||||
docker cp migrations/set_timezone_canary.sql checklist-db:/tmp/
|
||||
|
||||
# Ejecutarlo
|
||||
docker-compose exec postgres psql -U checklist_user -d checklist_db -f /tmp/set_timezone_canary.sql
|
||||
```
|
||||
|
||||
3. **Reconstruir y levantar todos los servicios**:
|
||||
```powershell
|
||||
docker-compose build
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
4. **Verificar la configuración**:
|
||||
```powershell
|
||||
# Verificar timezone en PostgreSQL
|
||||
docker-compose exec postgres psql -U checklist_user -d checklist_db -c "SHOW timezone;"
|
||||
|
||||
# Verificar timezone en backend
|
||||
docker-compose exec backend python -c "import time; print(time.tzname)"
|
||||
```
|
||||
|
||||
### Producción
|
||||
|
||||
#### Docker Compose Production
|
||||
|
||||
1. **Parar servicios**:
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yml down
|
||||
```
|
||||
|
||||
2. **Aplicar migración**:
|
||||
```bash
|
||||
docker-compose -f docker-compose.prod.yml up -d postgres
|
||||
docker cp migrations/set_timezone_canary.sql syntria-db-prod:/tmp/
|
||||
docker-compose -f docker-compose.prod.yml exec postgres psql -U syntria_user -d syntria_db -f /tmp/set_timezone_canary.sql
|
||||
```
|
||||
|
||||
3. **Reconstruir imágenes y desplegar**:
|
||||
```bash
|
||||
./build-and-push.sh # o build-and-push.ps1 en Windows
|
||||
docker-compose -f docker-compose.prod.yml pull
|
||||
docker-compose -f docker-compose.prod.yml up -d
|
||||
```
|
||||
|
||||
#### Docker Swarm
|
||||
|
||||
1. **Aplicar migración en el nodo manager**:
|
||||
```bash
|
||||
# Encontrar el contenedor de PostgreSQL
|
||||
docker ps | grep syntria_db
|
||||
|
||||
# Copiar y ejecutar migración
|
||||
docker cp migrations/set_timezone_canary.sql <container_id>:/tmp/
|
||||
docker exec <container_id> psql -U syntria_user -d syntria_db -f /tmp/set_timezone_canary.sql
|
||||
```
|
||||
|
||||
2. **Actualizar stack**:
|
||||
```bash
|
||||
docker stack deploy -c docker-stack.yml syntria
|
||||
```
|
||||
|
||||
## Verificación Post-Despliegue
|
||||
|
||||
### 1. Verificar Zona Horaria de PostgreSQL
|
||||
```sql
|
||||
-- Debería mostrar: Atlantic/Canary
|
||||
SHOW timezone;
|
||||
|
||||
-- Verificar hora actual del servidor
|
||||
SELECT NOW();
|
||||
SELECT CURRENT_TIMESTAMP;
|
||||
```
|
||||
|
||||
### 2. Verificar Backend
|
||||
```bash
|
||||
docker-compose exec backend python -c "
|
||||
from datetime import datetime
|
||||
import time
|
||||
print('Timezone:', time.tzname)
|
||||
print('Hora actual:', datetime.now())
|
||||
print('UTC:', datetime.utcnow())
|
||||
"
|
||||
```
|
||||
|
||||
### 3. Probar en la Aplicación
|
||||
1. Crear una nueva inspección
|
||||
2. Verificar que la fecha/hora de inicio coincida con la hora local de Canarias
|
||||
3. Filtrar por fecha y verificar que el filtro funcione correctamente
|
||||
|
||||
## Comportamiento de las Fechas
|
||||
|
||||
### Fechas Existentes
|
||||
- Las fechas ya guardadas en la base de datos **no se modifican**
|
||||
- PostgreSQL las almacena internamente en UTC
|
||||
- Se mostrarán en hora de Canarias al consultarlas
|
||||
|
||||
### Nuevas Fechas
|
||||
- Se guardarán con timezone de Canarias
|
||||
- Se convertirán automáticamente a UTC para almacenamiento
|
||||
- Se mostrarán en hora de Canarias al recuperarlas
|
||||
|
||||
## Horario de Verano
|
||||
|
||||
La zona horaria `Atlantic/Canary` maneja automáticamente el horario de verano:
|
||||
- **Invierno (octubre - marzo)**: UTC+0 / WET (Western European Time)
|
||||
- **Verano (marzo - octubre)**: UTC+1 / WEST (Western European Summer Time)
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Las fechas siguen mostrándose incorrectas
|
||||
|
||||
1. Verificar que los contenedores se reiniciaron después de los cambios:
|
||||
```powershell
|
||||
docker-compose restart
|
||||
```
|
||||
|
||||
2. Verificar logs del backend:
|
||||
```powershell
|
||||
docker-compose logs backend | Select-String -Pattern "timezone|TZ"
|
||||
```
|
||||
|
||||
3. Limpiar caché del navegador y recargar la aplicación
|
||||
|
||||
### Error al conectar a la base de datos
|
||||
|
||||
Si ves errores relacionados con timezone al conectar:
|
||||
```
|
||||
could not find timezone "Atlantic/Canary"
|
||||
```
|
||||
|
||||
Solución:
|
||||
```bash
|
||||
# Entrar al contenedor de PostgreSQL
|
||||
docker-compose exec postgres sh
|
||||
|
||||
# Instalar datos de zona horaria (si no están instalados)
|
||||
apk add --no-cache tzdata
|
||||
|
||||
# Salir y reiniciar
|
||||
exit
|
||||
docker-compose restart postgres
|
||||
```
|
||||
|
||||
### Las fechas en el frontend no coinciden
|
||||
|
||||
El frontend usa la zona horaria del navegador del usuario. Si el usuario está en una zona diferente a Canarias, verá las fechas en su hora local. Para forzar visualización en hora de Canarias en el frontend, se pueden usar bibliotecas como `date-fns-tz` o `luxon`.
|
||||
|
||||
## Archivos Modificados
|
||||
|
||||
- ✅ `docker-compose.yml` - Variables TZ para postgres y backend
|
||||
- ✅ `docker-compose.prod.yml` - Variables TZ para postgres y backend
|
||||
- ✅ `docker-stack.yml` - Variables TZ para db y backend
|
||||
- ✅ `backend/app/core/database.py` - Configuración de conexión con timezone
|
||||
- ✅ `backend/app/main.py` - Configuración de TZ de Python
|
||||
- ✅ `migrations/set_timezone_canary.sql` - Script de migración
|
||||
- ✅ `frontend/src/App.jsx` - Uso correcto de fechas locales
|
||||
|
||||
## Notas Importantes
|
||||
|
||||
⚠️ **Después de aplicar estos cambios en producción**:
|
||||
- Hacer backup de la base de datos antes de aplicar cambios
|
||||
- Aplicar en horario de bajo tráfico
|
||||
- Verificar que todas las funcionalidades de fecha/hora funcionan correctamente
|
||||
- Informar a los usuarios si hay cambios visibles en las fechas mostradas
|
||||
Reference in New Issue
Block a user