# pythonProject

**Repository Path**: omega-he/python-project

## Basic Information

- **Project Name**: pythonProject
- **Description**: python项目包含一些基础库的试用和封装
以及部分项目的后台部分
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-01-21
- **Last Updated**: 2025-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 隧道卫士系统 (SuiDaoWeiShi)

## 项目概述
这是一个基于Django的隧道监测系统，提供设备数据采集、项目管理、用户管理等功能。系统采用RESTful API架构，支持HTTPS安全访问。

## 项目结构
```
pythonProject/
├── backend/                    # 后端服务
│   └── djangoProject/         # Django项目主目录
│       ├── SuiDaoWeiShi/      # 主应用模块
│       │   └── RestfulApi/    # RESTful API接口
│       │       ├── BasicApi/          # 基础API
│       │       ├── CollectDataApi/    # 数据采集API
│       │       ├── InstrumentApi/     # 设备管理API
│       │       ├── ProjectApi/        # 项目管理API
│       │       ├── ServiceApi/        # 服务API
│       │       └── UserApi/           # 用户管理API
│       ├── manage.py          # Django管理脚本
│       └── cert/              # SSL证书目录
├── comm/                      # 公共模块
│   ├── app/                   # 应用模块
│   │   ├── db/                # 数据库管理
│   │   ├── office/            # Office文档处理
│   │   ├── projectApp/        # 项目应用
│   │   └── wechat/            # 微信集成
│   ├── io/                    # 文件IO操作
│   └── picture/               # 图片处理
├── 快捷方式/                  # 快捷启动脚本
└── venv/                      # Python虚拟环境
```

## 主要功能

### 1. 设备数据采集
- 实时监测隧道设备状态
- 数据自动采集和存储
- 历史数据查询和分析

### 2. 项目管理
- 隧道项目创建和管理
- 项目数据统计和报表
- 项目状态监控

### 3. 设备管理
- 设备信息维护
- 设备状态监控
- 设备配置管理

### 4. 用户管理
- 用户注册和认证
- 权限管理
- 用户操作日志

### 5. 微信集成
- 微信消息推送
- 群组管理
- 机器人服务

## 快速开始

### 环境要求
- Python 3.9+
- Django 3.2+
- SQLite数据库
- Windows操作系统

### 安装步骤
1. 克隆项目到本地
2. 激活虚拟环境：
   ```bash
   venv\Scripts\activate
   ```
3. 安装依赖：
   ```bash
   pip install -r comm\requirements
   ```

### 启动服务
使用快捷方式目录下的批处理脚本：

#### 启动服务
```bash
快捷方式\启动服务.bat
```
- 启动Django开发服务器
- 运行在HTTPS模式 (端口8866)
- 使用SSL证书加密通信

#### 重启服务
```bash
快捷方式\重启服务.bat
```
- 自动查找并终止正在运行的服务
- 等待服务完全停止
- 重新启动服务

### 服务配置
- **服务地址**: https://localhost:8866
- **SSL证书**: 位于 `backend/djangoProject/cert/` 目录
- **数据库**: SQLite (`backend/djangoProject/db.sqlite3`)

## API接口

### 基础API
- 图片上传和保存
- 基础数据操作

### 数据采集API
- 设备数据查询
- 实时数据采集
- 历史数据分析

### 设备管理API
- 设备信息查询
- 设备状态更新
- 设备配置管理

### 项目管理API
- 项目创建和编辑
- 项目数据统计
- 项目状态监控

### 用户管理API
- 用户注册和登录
- 权限验证
- 用户信息管理

## 数据库管理

### 数据导入
系统支持从MDB数据库导入历史数据：
```bash
快捷方式\自动将mdb数据导入到数据库.bat
```

### 数据备份
定期备份历史数据：
```bash
快捷方式\自动将备份3年前的老数据.bat
```

## 微信集成功能

### 企业微信机器人
- 自动发送监测报告
- 异常情况通知
- 群组消息管理

### 巡检报告
- 自动生成巡检报告
- 定时发送微信通知
- 报告模板管理

## 故障排除

### 常见问题
1. **服务启动失败**
   - 检查端口8866是否被占用
   - 确认SSL证书文件存在
   - 查看Django日志文件

2. **数据库连接问题**
   - 检查SQLite数据库文件权限
   - 确认数据库文件未损坏

3. **SSL证书问题**
   - 确保证书文件完整
   - 检查证书有效期

### 日志文件
- Django日志: `backend/djangoProject/django_debug.log`
- 系统日志: `快捷方式/django_debug.log`

## 开发说明

### 代码结构
- 遵循Django MVC架构
- RESTful API设计原则
- 模块化开发，便于维护

### 扩展开发
- 新增API接口在对应模块下创建
- 数据库模型在 `models.py` 中定义
- 视图函数在 `views.py` 中实现

## 版本信息
- 当前版本: 1.0.0
- 最后更新: 2024年
- 维护状态: 活跃开发中

## 联系方式
如有问题或建议，请联系开发团队。

---
*本文档最后更新于: 2024年*