border_Inspection/server/readme.md

边检CV算法接口服务

技术栈

• 后端框架: FastAPI
• 数据库: SQLite (SQLAlchemy ORM)
• AI模型: YOLOv11n
• 进程管理: Supervisor
• 开发语言: Python 3.8+

项目结构

server/
├── app.py                 # FastAPI主应用
├── start.py              # 启动脚本
├── requirements.txt       # Python依赖
├── env.example           # 环境变量示例
├── init_data.py          # 示例数据初始化
├── core/                 # 核心配置
│   └── database.py       # 数据库配置
├── models/               # 数据模型
│   ├── __init__.py
│   ├── base.py          # 基础模型
│   ├── algorithm.py     # 算法模型
│   ├── device.py        # 设备模型
│   └── event.py         # 事件模型
├── schemas/              # Pydantic模型
│   ├── __init__.py
│   ├── algorithm.py     # 算法相关模型
│   ├── device.py        # 设备相关模型
│   └── event.py         # 事件相关模型
└── routers/              # API路由
    ├── __init__.py
    ├── algorithms.py     # 算法管理接口
    ├── devices.py        # 设备管理接口
    └── events.py         # 事件管理接口

功能模块

1. 算法管理模块

• 算法的增删改查
• 算法状态管理（启用/禁用）
• 算法版本管理
• 算法性能指标（准确率、推理时间等）

2. 设备管理模块

• 设备信息管理（摄像头、传感器等）
• 设备状态监控
• 设备类型管理
• 设备地理位置信息

3. 事件管理模块

• 事件记录和查询
• 事件状态管理
• 事件统计分析
• 告警管理

API接口

算法管理接口

• POST /api/algorithms/ - 创建算法
• GET /api/algorithms/ - 获取算法列表
• GET /api/algorithms/{id} - 获取算法详情
• PUT /api/algorithms/{id} - 更新算法
• DELETE /api/algorithms/{id} - 删除算法
• PATCH /api/algorithms/{id}/status - 更新算法状态
• PATCH /api/algorithms/{id}/enable - 启用/禁用算法

设备管理接口

• POST /api/devices/ - 创建设备
• GET /api/devices/ - 获取设备列表
• GET /api/devices/{id} - 获取设备详情
• PUT /api/devices/{id} - 更新设备
• DELETE /api/devices/{id} - 删除设备
• PATCH /api/devices/{id}/status - 更新设备状态
• PATCH /api/devices/{id}/enable - 启用/禁用设备
• GET /api/devices/types/list - 获取设备类型列表
• GET /api/devices/status/stats - 获取设备状态统计

事件管理接口

• POST /api/events/ - 创建事件
• GET /api/events/ - 获取事件列表
• GET /api/events/{id} - 获取事件详情
• PUT /api/events/{id} - 更新事件
• DELETE /api/events/{id} - 删除事件
• PATCH /api/events/{id}/status - 更新事件状态
• GET /api/events/types/list - 获取事件类型列表
• GET /api/events/stats/summary - 获取事件统计摘要
• GET /api/events/stats/by-type - 按类型统计事件

安装和运行

1. 环境准备

# 创建虚拟环境
conda create -n border_inspection python=3.8
conda activate border_inspection

# 安装依赖
pip install -r requirements.txt

2. 初始化数据库

# 启动服务（会自动创建数据库表）
python start.py

3. 初始化示例数据

python init_data.py

4. 启动服务

python start.py

服务将在 http://localhost:8000 启动

API文档

启动服务后，可以访问以下地址查看API文档：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

数据库设计

算法表 (algorithms)

• 基本信息：名称、描述、版本
• 模型信息：模型路径、配置文件路径
• 性能指标：准确率、推理时间、输入尺寸
• 状态管理：启用状态、算法状态
• 分类信息：检测类别、标签

设备表 (devices)

• 基本信息：名称、类型、位置
• 连接信息：IP地址、端口、用户名、密码
• 视频流：RTSP地址、分辨率、帧率
• 状态信息：在线状态、最后心跳时间
• 地理位置：经纬度坐标

事件表 (events)

• 事件信息：类型、设备ID、算法ID
• 检测结果：置信度、边界框、检测对象
• 状态管理：事件状态、严重程度
• 告警信息：是否告警、告警发送状态
• 处理信息：处理人员、处理备注、解决时间

开发说明

1. 添加新模型: 在 models/ 目录下创建新的模型文件
2. 添加新接口: 在 routers/ 目录下创建新的路由文件
3. 添加新Schema: 在 schemas/ 目录下创建新的Pydantic模型
4. 数据库迁移: 修改模型后重启服务，数据库表会自动更新

部署说明

使用Supervisor管理进程

[program:border_inspection]
command=python /path/to/server/start.py
directory=/path/to/server
user=www-data
autostart=true
autorestart=true
stderr_logfile=/var/log/border_inspection.err.log
stdout_logfile=/var/log/border_inspection.out.log

环境变量配置

复制 env.example 为 .env 并修改相应配置：

cp env.example .env
# 编辑 .env 文件