default
11281e5be2
- 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>
105 lines
3.5 KiB
Python
105 lines
3.5 KiB
Python
"""
|
|
Beacons Router - 蓝牙信标管理接口
|
|
API endpoints for managing Bluetooth beacon configuration.
|
|
"""
|
|
|
|
import math
|
|
|
|
from fastapi import APIRouter, Depends, HTTPException, Query
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
from app.dependencies import require_write
|
|
|
|
from app.database import get_db
|
|
from app.schemas import (
|
|
APIResponse,
|
|
BeaconConfigCreate,
|
|
BeaconConfigResponse,
|
|
BeaconConfigUpdate,
|
|
PaginatedList,
|
|
)
|
|
from app.services import beacon_service
|
|
|
|
router = APIRouter(prefix="/api/beacons", tags=["Beacons / 蓝牙信标"])
|
|
|
|
|
|
@router.get(
|
|
"",
|
|
response_model=APIResponse[PaginatedList[BeaconConfigResponse]],
|
|
summary="获取信标列表 / List beacons",
|
|
)
|
|
async def list_beacons(
|
|
status: str | None = Query(default=None, description="状态筛选 (active/inactive)"),
|
|
search: str | None = Query(default=None, description="搜索 MAC/名称/区域"),
|
|
page: int = Query(default=1, ge=1),
|
|
page_size: int = Query(default=20, ge=1, le=100),
|
|
db: AsyncSession = Depends(get_db),
|
|
):
|
|
records, total = await beacon_service.get_beacons(
|
|
db, page=page, page_size=page_size, status_filter=status, search=search
|
|
)
|
|
return APIResponse(
|
|
data=PaginatedList(
|
|
items=[BeaconConfigResponse.model_validate(r) for r in records],
|
|
total=total,
|
|
page=page,
|
|
page_size=page_size,
|
|
total_pages=math.ceil(total / page_size) if total else 0,
|
|
)
|
|
)
|
|
|
|
|
|
@router.get(
|
|
"/{beacon_id}",
|
|
response_model=APIResponse[BeaconConfigResponse],
|
|
summary="获取信标详情 / Get beacon",
|
|
)
|
|
async def get_beacon(beacon_id: int, db: AsyncSession = Depends(get_db)):
|
|
beacon = await beacon_service.get_beacon(db, beacon_id)
|
|
if beacon is None:
|
|
raise HTTPException(status_code=404, detail="Beacon not found")
|
|
return APIResponse(data=BeaconConfigResponse.model_validate(beacon))
|
|
|
|
|
|
@router.post(
|
|
"",
|
|
response_model=APIResponse[BeaconConfigResponse],
|
|
status_code=201,
|
|
summary="添加信标 / Create beacon",
|
|
dependencies=[Depends(require_write)],
|
|
)
|
|
async def create_beacon(body: BeaconConfigCreate, db: AsyncSession = Depends(get_db)):
|
|
existing = await beacon_service.get_beacon_by_mac(db, body.beacon_mac)
|
|
if existing:
|
|
raise HTTPException(status_code=400, detail=f"Beacon MAC {body.beacon_mac} already exists")
|
|
beacon = await beacon_service.create_beacon(db, body)
|
|
return APIResponse(message="Beacon created", data=BeaconConfigResponse.model_validate(beacon))
|
|
|
|
|
|
@router.put(
|
|
"/{beacon_id}",
|
|
response_model=APIResponse[BeaconConfigResponse],
|
|
summary="更新信标 / Update beacon",
|
|
dependencies=[Depends(require_write)],
|
|
)
|
|
async def update_beacon(
|
|
beacon_id: int, body: BeaconConfigUpdate, db: AsyncSession = Depends(get_db)
|
|
):
|
|
beacon = await beacon_service.update_beacon(db, beacon_id, body)
|
|
if beacon is None:
|
|
raise HTTPException(status_code=404, detail="Beacon not found")
|
|
return APIResponse(message="Beacon updated", data=BeaconConfigResponse.model_validate(beacon))
|
|
|
|
|
|
@router.delete(
|
|
"/{beacon_id}",
|
|
response_model=APIResponse,
|
|
summary="删除信标 / Delete beacon",
|
|
dependencies=[Depends(require_write)],
|
|
)
|
|
async def delete_beacon(beacon_id: int, db: AsyncSession = Depends(get_db)):
|
|
success = await beacon_service.delete_beacon(db, beacon_id)
|
|
if not success:
|
|
raise HTTPException(status_code=404, detail="Beacon not found")
|
|
return APIResponse(message="Beacon deleted")
|