# smartcamera

**Repository Path**: liu123zhi/smartcamera

## Basic Information

- **Project Name**: smartcamera
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-07
- **Last Updated**: 2025-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SmartCamera - RV1106 AI摄像头应用

基于瑞芯微RV1106芯片的智能AI摄像头系统，集成视频采集、目标检测、跟踪、报警管理等功能。

## 🚀 项目特性

- **实时视频处理**：H.264/H.265编码，RTSP/RTMP推流
- **AI目标检测**：基于YOLOv5的实时目标检测
- **多目标跟踪**：ByteTrack算法实现目标跟踪
- **人脸识别**：ArcFace算法支持人脸识别
- **智能报警**：多渠道报警推送（HTTP/MQTT/WebSocket）
- **Web管理界面**：Vue3前端，实时监控和配置
- **RESTful API**：完整的API接口支持

## 🏗️ 系统架构

```
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   视频采集模块   │    │   AI检测模块    │    │   报警管理模块   │
│  (VideoEncoder) │───▶│ (YOLOv5+Track) │───▶│ (AlarmManager)  │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   视频推流服务   │    │   Web API服务   │    │   推送服务      │
│ (RTSP/RTMP)    │◀───│ (RESTful API)  │◀───│ (HTTP/MQTT/WS) │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │   数据库服务     │
                    │   (SQLite)     │
                    └─────────────────┘
```

## 📋 技术栈

### 后端 (C++17)
- **平台**：瑞芯微RV1106/RV1103
- **AI推理**：RKNN API
- **视频处理**：OpenCV, Rockchip MPP
- **数据库**：SQLite3
- **网络**：httplib, libcurl, mosquitto
- **编码**：H.264/H.265硬件编码

### 前端 (Vue3)
- **框架**：Vue3 + TypeScript
- **UI库**：Element Plus
- **构建工具**：Vite
- **状态管理**：Pinia
- **路由**：Vue Router

## 🛠️ 编译构建

### 环境要求
- CMake >= 3.10
- RV1106 SDK (LuckFox Pico)
- OpenCV >= 4.0
- SQLite3
- Node.js >= 16 (前端开发)

### 后端编译
```bash
# 创建构建目录
mkdir build && cd build

# 配置CMake (交叉编译)
cmake .. -DCMAKE_BUILD_TYPE=Release

# 编译
make -j$(nproc)

# 安装
make install
```

### 前端开发
```bash
cd frontend

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建生产版本
npm run build
```

## 📁 项目结构

```
smartcamera/
├── backend/                 # C++后端
│   ├── src/
│   │   ├── core/           # 核心基础类
│   │   ├── video/          # 视频处理模块
│   │   ├── ai/             # AI检测模块
│   │   ├── alarm/          # 报警管理
│   │   ├── api/            # Web API服务
│   │   ├── utils/          # 工具类
│   │   └── main.cpp        # 主程序
│   ├── include/            # 头文件
│   ├── models/             # AI模型文件
│   └── config/             # 配置文件
├── frontend/               # Vue3前端
│   ├── src/
│   │   ├── components/     # 组件
│   │   ├── views/          # 页面
│   │   ├── api/            # API接口
│   │   └── store/          # 状态管理
│   └── public/             # 静态资源
├── docs/                   # 文档
├── scripts/                # 脚本工具
└── tests/                  # 测试代码
```

## 🚦 开发状态

当前开发进度请查看 [DEVELOPMENT_PLAN.md](DEVELOPMENT_PLAN.md)

- ✅ 项目初始化与构建系统
- 🔄 核心基础类框架 (进行中)
- ⏳ 数据库设计与初始化
- ⏳ 视频采集与处理模块
- ⏳ AI检测与跟踪系统
- ⏳ 报警管理系统
- ⏳ Web API服务
- ⏳ 前端Vue3应用
- ⏳ 系统集成与优化

## 📖 文档

- [需求分析](requirements.md) - 详细的系统需求和架构分析
- [开发计划](DEVELOPMENT_PLAN.md) - 详细的开发任务列表
- [API文档](docs/api.md) - RESTful API接口文档
- [部署指南](docs/deployment.md) - 系统部署说明

## 🤝 贡献

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系方式

- 项目链接：[https://github.com/yourusername/smartcamera](https://github.com/yourusername/smartcamera)
- 问题反馈：[Issues](https://github.com/yourusername/smartcamera/issues)

---

**注意**：本项目专为瑞芯微RV1106平台设计，需要相应的SDK和硬件支持。