- Batch device CRUD: POST /api/devices/batch (create 500), PUT /api/devices/batch (update 500), POST /api/devices/batch-delete (delete 100) with WHERE IN bulk queries - Batch command: POST /api/commands/batch with model_validator mutual exclusion - API key auth (X-API-Key header, secrets.compare_digest timing-safe) - Rate limiting via SlowAPIMiddleware (60/min default, 30/min writes) - Real client IP extraction (X-Forwarded-For / CF-Connecting-IP) - Global exception handler (no stack trace leaks, passes HTTPException through) - CORS with auto-disable credentials on wildcard origins - Schema validation: IMEI pattern, lat/lon ranges, Literal enums, MAC/UUID patterns - Heartbeats router, per-ID endpoints for locations/attendance/bluetooth - Input dedup in batch create, result ordering preserved - Baidu reverse geocoding, Gaode map tiles with WGS84→GCJ02 conversion - Device detail panel with feature toggles and command controls - Side panel for location/beacon pages with auto-select active device via [HAPI](https://hapi.run) Co-Authored-By: HAPI <noreply@hapi.run>
32 lines
995 B
Python
32 lines
995 B
Python
"""
|
|
TCP Command Service — Abstraction layer for sending commands to devices via TCP.
|
|
|
|
Breaks the circular import between routers/commands.py and tcp_server.py
|
|
by lazily importing tcp_manager only when needed.
|
|
"""
|
|
|
|
import logging
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
def _get_tcp_manager():
|
|
"""Lazily import tcp_manager to avoid circular imports."""
|
|
from app.tcp_server import tcp_manager
|
|
return tcp_manager
|
|
|
|
|
|
def is_device_online(imei: str) -> bool:
|
|
"""Check if a device is currently connected via TCP."""
|
|
return imei in _get_tcp_manager().connections
|
|
|
|
|
|
async def send_command(imei: str, command_type: str, command_content: str) -> bool:
|
|
"""Send an online command (0x80) to a connected device."""
|
|
return await _get_tcp_manager().send_command(imei, command_type, command_content)
|
|
|
|
|
|
async def send_message(imei: str, message: str) -> bool:
|
|
"""Send a text message (0x82) to a connected device."""
|
|
return await _get_tcp_manager().send_message(imei, message)
|