本项目「智慧步道」面向郊野公园、生态科普径等户外健身场景，服务于百岁山郊野公园科普径建设中的 AI 步道系统 板块。传统公园步道普遍存在运动数据无法自动采集、游客身份难以识别、大屏展示与后台运维割裂、多公园/多租户难以统一管理等痛点，难以支撑「智慧公园 + 健康科普」的数字化运营目标。
立项旨在打造一套 「立杆感知 + 人脸识人 + 大屏互动 + 后台统管」 的步道智能化产品：通过步道立杆摄像头采集过杆事件，结合百度人脸 1:N 检索实现无感身份识别；Android 大屏终端提供刷脸注册/登录、运动数据展示、地图路径、天气资讯等沉浸式交互；PHP 统一后端与 Web 管理后台支撑多租户、设备、用户、路线、资讯的全链路运营。产品适用于郊野公园、城市绿道、景区健身步道等需要 运动量化、科普展示、设备远程管理 的业务场景。
智慧步道产品由 Android 大屏终端、PHP 统一后端、Bootstrap Web 管理后台 三部分构成，核心功能模块包括：
（1）AI 人脸识别与注册登录
Android 端集成 CameraX 采集 + ML Kit 本地人脸检测，服务端对接 百度人脸 1:N 检索，支持刷脸自动识别老用户或新建注册；结合身高、体重、BMI 生成个性化慢跑运动建议。
（2）立杆过杆感知与运动统计
支持海康摄像头 HTTP 报警接入，记录用户过杆流水；后端按杆间距、会话间隔自动切分 trail_activity 运动会话，计算里程、时长、速度、热量，并生成日/周/月/年个人汇总与 今日运动排行榜 TOP10。
（3）步道地图与路径可视化
后台配置立杆、杆间路段、摄像头；服务端调用 百度步行路径规划（或天地图）生成杆间折线并持久化；Android 大屏叠加 天地图瓦片 展示步道全貌与立杆分布。
（4）大屏首页综合展示
集成和风天气（含空气质量）、园区通知公告、RSS 资讯列表、参与者统计、实时时钟等，形成公园入口级智慧互动大屏。
（5）多租户 Web 管理后台
Bootstrap 5 单页管理端，覆盖步道用户、设备登记与心跳监测、立杆/路段/摄像头、过杆流水、资讯源与 RSS 自动抓取、隐私协议、通知公告、管理员 RBAC、操作审计等模块。
（6）设备与 API 开放能力
一机一 App，设备 UUID 本地持久化；HTTP 心跳上报在线状态；统一 JSON API 供 Android 终端与管理后台调用，规划与导视、AR 动植物等应用共用同一后端底座。
我负责的具体任务：
本人主导智慧步道 V1.0 核心链路的设计与实现，包括：PHP 单入口 API（index.php）路由与业务逻辑、MySQL 建表与迁移脚本、百度人脸 1:N 注册/识别接口、立杆过杆与会话统计模型、百度步行路径折线补算、和风天气代理、多租户与 RBAC 权限体系；Android 大屏 App（Kotlin）首页交互、刷脸流程、地图叠加、排行榜与资讯展示；Web 管理后台（admin.php）各业务模块；以及 Docker + Caddy 生产部署、RSS 定时抓取 cron 等运维落地。
技术栈、架构与实现亮点/难点：
技术栈：Android 端 Kotlin + CameraX + ML Kit + OkHttp + 天地图瓦片；服务端 PHP 7.4+ 手写路由（无框架依赖）+ PDO + MySQL 8.0；管理端 Bootstrap 5 + fetch API；生产环境 Docker Compose（PHP + MySQL）+ Caddy 反向代理 HTTPS；外部能力对接百度人脸、百度 LBS 步行规划、和风天气、海康报警 Webhook。
架构设计：「Android 大屏终端 ↔ PHP REST API ↔ MySQL」三层架构；多租户按 device_uuid + app_type 自动解析租户；三应用（步道/导视/AR）规划共用同一后端与数据库，V1.0 优先落地步道全链路。
实现亮点：刷脸即注册/登录，过杆流水自动聚合为运动会话并生成排行榜；杆间路径首次访问自动调用百度步行 API 补算并入库复用；设备 HTTP 心跳判定在线；租户级百度人脸库 group 自动创建与隔离；RSS 资讯每小时 cron 自动抓取 enriched 正文配图。
技术难点：虚拟主机环境下 Authorization 头丢失，统一改用 X-Auth
评论