# 视频主设备管理系统

基于 Django REST Framework 的视频设备全生命周期管理后端API服务。

## 项目背景

随着视频监控、视频会议等业务的扩展，视频主设备（如视频编码器、解码器、矩阵、NVR等）数量快速增长。当前采用人工表格管理方式，存在设备信息分散、维护记录缺失、IP地址冲突、序列号追溯困难等问题。

## 功能特性

### 核心模块

| 模块 | 功能说明 |
|------|----------|
| **设备管理** | 设备增删改查；按地点/楼栋/状态筛选；服役时长自动计算 |
| **序列号管理** | 支持多序列号（主序列号+辅助）；唯一性校验 |
| **IP地址管理** | 支持多IP（管理/业务/备用）；主IP标识；唯一性校验 |
| **维修记录** | 故障描述/维修内容/更换配件/维修人/费用；历史追溯 |
| **附件与缩略图** | 照片/说明书上传；自动生成缩略图展示 |
| **巡检管理** | 最后巡检时间记录；保修到期预警 |
| **Excel导入导出** | 批量导入设备；导出设备列表（含主IP/序列号/维修简述） |

### 技术栈

| 层级 | 技术选型 |
|------|----------|
| 后端框架 | Django 4.2 + Django REST Framework 3.15 |
| 数据库 | SQLite3 (可切换MySQL/PostgreSQL) |
| 对象存储 | 本地文件系统 (可扩展MinIO) |
| 图片处理 | Pillow |
| 身份认证 | JWT + Session |
| API文档 | drf-yasg (Swagger/Redoc) |
| Excel处理 | openpyxl + pandas |
| 日志系统 | loguru |

## 快速开始

### 环境要求

- Python 3.8+
- pip

### 安装依赖

```bash
pip install -r requirements.txt
```

### 数据库迁移

```bash
python manage.py makemigrations
python manage.py migrate
```

### 创建管理员

```bash
python manage.py createsuperuser
```

### 启动服务

```bash
python manage.py runserver 0.0.0.0:8000
```

## 访问地址

| 服务 | 地址 |
|------|------|
| Swagger API文档 | http://localhost:8000/swagger/ |
| Redoc API文档 | http://localhost:8000/redoc/ |
| Django Admin后台 | http://localhost:8000/admin/ |
| 设备列表API | http://localhost:8000/api/devices/ |

## API端点

### 设备管理

| 方法 | 端点 | 说明 |
|------|------|------|
| GET | `/api/devices/` | 设备列表（分页/过滤/搜索） |
| POST | `/api/devices/` | 创建设备（可同时创建主序列号和主IP） |
| GET | `/api/devices/{id}/` | 设备详情（含序列号/IP/维修记录） |
| PUT | `/api/devices/{id}/` | 全量更新设备 |
| PATCH | `/api/devices/{id}/` | 部分更新设备 |
| DELETE | `/api/devices/{id}/` | 删除设备（级联删除子表） |
| GET | `/api/devices/export_excel/` | 导出Excel |
| POST | `/api/devices/import_excel/` | 导入Excel |
| POST | `/api/devices/{id}/upload_attachment/` | 上传附件 |

### 其他资源

- `/api/serials/` - 序列号管理
- `/api/ips/` - IP地址管理
- `/api/maintenance/` - 维修记录管理
- `/api/attachments/` - 附件管理

### 认证

```bash
# 获取JWT Token
POST /api/token/
Body: {
    "username": "your_username",
    "password": "your_password"
}

# 使用Token
Authorization: Bearer <your_access_token>
```

## Excel导入模板列名

| 列名 | 说明 | 必填 |
|------|------|------|
| 地点 | 设备所在地点 | 是 |
| 楼栋 | 所在楼栋 | 否 |
| 设备名称 | 设备标识名 | 是 |
| 型号 | 设备型号 | 否 |
| 品牌 | 设备品牌 | 否 |
| 状态 | normal/warning/offline/repair/scrap | 否（默认normal） |
| 负责人 | 运维负责人 | 否 |
| 主序列号 | 设备主键号 | 否 |
| 主IP | 主要管理IP地址 | 否 |

## 项目结构

```
netmeeting-infra/
├── config/
│   ├── settings.py      # Django配置
│   ├── urls.py          # 主路由
│   └── wsgi.py
├── device_management/
│   ├── models.py        # 5个数据库模型
│   ├── serializers.py   # DRF序列化器
│   ├── views.py         # ViewSet视图
│   ├── urls.py          # API路由
│   ├── admin.py         # Admin配置
│   └── migrations/      # 数据库迁移文件
├── manage.py
├── requirements.txt
└── README.md
```

## 数据库表结构

- `device` - 设备主表（15个业务字段）
- `device_serial` - 序列号子表（唯一约束）
- `device_ip` - IP地址子表（唯一约束）
- `maintenance_record` - 维修记录子表
- `device_attachment` - 附件管理表

## 部署方式（可选）

```bash
# Docker + Nginx + Gunicorn
# 详见Django官方部署文档
```

## 许可证

BSD License