feat: KKS P240/P241 蓝牙工牌管理系统初始提交

FastAPI + SQLAlchemy + asyncio TCP 服务器，支持设备管理、实时定位、
告警、考勤打卡、蓝牙记录、指令下发、TTS语音播报等功能。

.env.example

@@ -0,0 +1,43 @@
+# KKS Badge Management System - Environment Configuration
+# Copy to .env and customize values as needed
+
+# Database (default: SQLite in project root)
+# DATABASE_URL=sqlite+aiosqlite:///path/to/badge_admin.db
+# DATABASE_URL=postgresql+asyncpg://user:password@localhost/badge_admin
+
+# Server ports
+# TCP_PORT=5000
+# API_PORT=8088
+
+# Debug mode (default: false)
+# DEBUG=true
+
+# API authentication (uncomment to enable, all /api/ endpoints require X-API-Key header)
+# API_KEY=your-secret-api-key-here
+
+# CORS origins (comma-separated, * = allow all)
+# CORS_ORIGINS=https://example.com,https://admin.example.com
+
+# Rate limiting (format: "count/period", period = second/minute/hour/day)
+# RATE_LIMIT_DEFAULT=60/minute
+# RATE_LIMIT_WRITE=30/minute
+
+# Track query max points (default: 10000)
+# TRACK_MAX_POINTS=10000
+
+# 天地图 API key (reverse geocoding, free 10k/day)
+# Sign up: https://lbs.tianditu.gov.cn/
+# TIANDITU_API_KEY=your_tianditu_key
+
+# Google Geolocation API (optional, for cell/WiFi geocoding)
+# GOOGLE_API_KEY=your_google_key
+
+# Unwired Labs API (optional, for cell/WiFi geocoding)
+# UNWIRED_API_TOKEN=your_unwired_token
+
+# 高德地图 API (optional, requires enterprise auth for IoT positioning)
+# AMAP_KEY=your_amap_key
+# AMAP_SECRET=your_amap_secret
+
+# Geocoding cache size
+# GEOCODING_CACHE_SIZE=10000