Files
ATLAS/backend/app/models/dispositivo.py
FlotillasGPS Developer 51d78bacf4 FlotillasGPS - Sistema completo de monitoreo de flotillas GPS
Sistema completo para monitoreo y gestion de flotas de vehiculos con:
- Backend FastAPI con PostgreSQL/TimescaleDB
- Frontend React con TypeScript y TailwindCSS
- App movil React Native con Expo
- Soporte para dispositivos GPS, Meshtastic y celulares
- Video streaming en vivo con MediaMTX
- Geocercas, alertas, viajes y reportes
- Autenticacion JWT y WebSockets en tiempo real

Documentacion completa y guias de usuario incluidas.
2026-01-21 08:18:00 +00:00

112 lines
3.7 KiB
Python

"""
Modelo de Dispositivo GPS/Tracker para vehículos.
"""
from datetime import datetime
from sqlalchemy import (
Boolean,
DateTime,
Float,
ForeignKey,
Integer,
String,
Text,
)
from sqlalchemy.orm import Mapped, mapped_column, relationship
from app.core.database import Base
from app.models.base import TimestampMixin
class Dispositivo(Base, TimestampMixin):
"""Modelo de dispositivo GPS/tracker instalado en un vehículo."""
__tablename__ = "dispositivos"
id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True)
# Relación con vehículo
vehiculo_id: Mapped[int] = mapped_column(
ForeignKey("vehiculos.id", ondelete="CASCADE"),
nullable=False,
index=True,
)
# Tipo de dispositivo
tipo: Mapped[str] = mapped_column(
String(50),
nullable=False,
default="gps",
) # gps, obd, meshtastic, smartphone
# Identificación
identificador: Mapped[str] = mapped_column(
String(100),
unique=True,
nullable=False,
index=True,
) # ID único del dispositivo
nombre: Mapped[str | None] = mapped_column(String(100), nullable=True)
marca: Mapped[str | None] = mapped_column(String(50), nullable=True)
modelo: Mapped[str | None] = mapped_column(String(50), nullable=True)
numero_serie: Mapped[str | None] = mapped_column(String(100), nullable=True)
# Información de SIM
telefono_sim: Mapped[str | None] = mapped_column(String(20), nullable=True)
operador_sim: Mapped[str | None] = mapped_column(String(50), nullable=True)
iccid: Mapped[str | None] = mapped_column(String(25), nullable=True) # ID de la SIM
# IMEI (para dispositivos celulares)
imei: Mapped[str | None] = mapped_column(String(20), nullable=True, unique=True)
# Protocolo de comunicación
protocolo: Mapped[str] = mapped_column(
String(50),
default="osmand",
nullable=False,
) # osmand, traccar, gt06, meshtastic, mqtt
# Estado de conexión
ultimo_contacto: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
bateria: Mapped[float | None] = mapped_column(Float, nullable=True) # Porcentaje 0-100
señal_gsm: Mapped[int | None] = mapped_column(Integer, nullable=True) # Nivel de señal
satelites: Mapped[int | None] = mapped_column(Integer, nullable=True) # Satélites GPS
# Configuración del dispositivo
intervalo_reporte: Mapped[int] = mapped_column(
Integer,
default=30,
nullable=False,
) # Segundos entre reportes
configuracion: Mapped[str | None] = mapped_column(Text, nullable=True) # JSON con config adicional
# Firmware
firmware_version: Mapped[str | None] = mapped_column(String(50), nullable=True)
# Estado
activo: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
conectado: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
# Notas
notas: Mapped[str | None] = mapped_column(Text, nullable=True)
# Relaciones ORM
vehiculo: Mapped["Vehiculo"] = relationship(
"Vehiculo",
back_populates="dispositivos",
lazy="selectin",
)
@property
def esta_online(self) -> bool:
"""Verifica si el dispositivo está online (último contacto < 5 minutos)."""
if not self.ultimo_contacto:
return False
from datetime import timezone, timedelta
tiempo_limite = datetime.now(timezone.utc) - timedelta(minutes=5)
return self.ultimo_contacto > tiempo_limite
def __repr__(self) -> str:
return f"<Dispositivo(id={self.id}, identificador='{self.identificador}', tipo='{self.tipo}')>"