Add WebSocket, multi API key, geocoding proxy, beacon map picker, and comprehensive bug fixes

- Multi API Key + permission system (read/write/admin) with SHA-256 hash
- WebSocket real-time push (location, alarm, device_status, attendance, bluetooth)
- Geocoding proxy endpoints for Amap POI search and reverse geocode
- Beacon modal map-based location picker with search and click-to-select
- GCJ-02 ↔ WGS-84 bidirectional coordinate conversion
- Data cleanup scheduler (configurable retention days)
- Fix GPS longitude sign inversion (course_status bit 11: 0=East, 1=West)
- Fix 2G CellID 2→3 bytes across all protocols (0x28, 0x2C, parser.py)
- Fix parser loop guards, alarm_source field length, CommandLog.sent_at
- Fix geocoding IMEI parameterization, require_admin import
- Improve API error messages for 422 validation errors
- Remove beacon floor/area fields (consolidated into name)

via [HAPI](https://hapi.run)

Co-Authored-By: HAPI <noreply@hapi.run>

app/routers/bluetooth.py

@@ -5,6 +5,7 @@ API endpoints for querying Bluetooth punch and location records.
 
 import math
 from datetime import datetime
+from typing import Literal
 
 from fastapi import APIRouter, Depends, HTTPException, Query
 from sqlalchemy import func, select
@@ -30,15 +31,17 @@ router = APIRouter(prefix="/api/bluetooth", tags=["Bluetooth / 蓝牙数据"])
 async def list_bluetooth_records(
     device_id: int | None = Query(default=None, description="设备ID / Device ID"),
     record_type: str | None = Query(default=None, description="记录类型 / Record type (punch/location)"),
+    beacon_mac: str | None = Query(default=None, description="信标MAC / Beacon MAC filter"),
     start_time: datetime | None = Query(default=None, description="开始时间 / Start time (ISO 8601)"),
     end_time: datetime | None = Query(default=None, description="结束时间 / End time (ISO 8601)"),
+    sort_order: Literal["asc", "desc"] = Query(default="desc", description="排序方向 / Sort order (asc/desc)"),
     page: int = Query(default=1, ge=1, description="页码 / Page number"),
     page_size: int = Query(default=20, ge=1, le=100, description="每页数量 / Items per page"),
     db: AsyncSession = Depends(get_db),
 ):
     """
-    获取蓝牙数据记录列表，支持按设备、记录类型、时间范围过滤。
-    List Bluetooth records with filters for device, record type, and time range.
+    获取蓝牙数据记录列表，支持按设备、记录类型、信标MAC、时间范围过滤。
+    List Bluetooth records with filters for device, record type, beacon MAC, and time range.
     """
     query = select(BluetoothRecord)
     count_query = select(func.count(BluetoothRecord.id))
@@ -51,6 +54,10 @@ async def list_bluetooth_records(
         query = query.where(BluetoothRecord.record_type == record_type)
         count_query = count_query.where(BluetoothRecord.record_type == record_type)
 
+    if beacon_mac:
+        query = query.where(BluetoothRecord.beacon_mac == beacon_mac)
+        count_query = count_query.where(BluetoothRecord.beacon_mac == beacon_mac)
+
     if start_time:
         query = query.where(BluetoothRecord.recorded_at >= start_time)
         count_query = count_query.where(BluetoothRecord.recorded_at >= start_time)
@@ -63,7 +70,8 @@ async def list_bluetooth_records(
     total = total_result.scalar() or 0
 
     offset = (page - 1) * page_size
-    query = query.order_by(BluetoothRecord.recorded_at.desc()).offset(offset).limit(page_size)
+    order = BluetoothRecord.recorded_at.asc() if sort_order == "asc" else BluetoothRecord.recorded_at.desc()
+    query = query.order_by(order).offset(offset).limit(page_size)
     result = await db.execute(query)
     records = list(result.scalars().all())