128 lines
3.2 KiB
Markdown
128 lines
3.2 KiB
Markdown
# UPS管理系统
|
||
|
||
基于Django的UPS主机和电池管理系统，用于管理UPS设备、电池信息及维修记录。
|
||
|
||
## 功能特性
|
||
|
||
- **UPS主机管理** - 管理UPS主机的品牌、型号、IP地址、数量、存放位置等信息
|
||
- **电池管理** - 管理电池的品牌、型号、重量、数量、安装日期等信息
|
||
- **下挂电池编辑** - 在编辑UPS主机时可以直接查看和编辑下挂的电池
|
||
- **联系人管理** - 管理联系人信息
|
||
- **维保供应商管理** - 管理维保供应商信息
|
||
- **维修记录管理** - 记录UPS主机和电池的维修历史
|
||
- **仪表盘** - 首页显示重要统计信息和按存放位置的汇总表格
|
||
|
||
## 技术栈
|
||
|
||
- Python 3.11+
|
||
- Django 5.0.6
|
||
- SQLite 数据库
|
||
- Bootstrap 5
|
||
- Flatpickr 日期选择器
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Python 3.11 或更高版本
|
||
- pip 包管理器
|
||
|
||
### 安装依赖
|
||
|
||
```bash
|
||
cd ups_management
|
||
pip install django
|
||
```
|
||
|
||
### 启动服务
|
||
|
||
```bash
|
||
python manage.py runserver
|
||
```
|
||
|
||
### 访问地址
|
||
|
||
- 主页仪表盘: http://localhost:8000/
|
||
- 管理后台: http://localhost:8000/admin/
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
ups-infra/
|
||
└── ups_management/ # 项目根目录
|
||
├── manage.py # Django管理命令
|
||
├── db.sqlite3 # 数据库文件
|
||
├── ups_management/ # 项目配置目录
|
||
│ ├── settings.py # 配置文件
|
||
│ ├── urls.py # 主路由
|
||
│ └── ...
|
||
└── ups_manager/ # 应用目录
|
||
├── models.py # 数据模型
|
||
├── views.py # 视图逻辑
|
||
├── urls.py # 应用路由
|
||
├── admin.py # 后台管理
|
||
├── forms.py # 表单定义
|
||
└── templates/ # 模板文件
|
||
```
|
||
|
||
## 数据模型
|
||
|
||
### UPSHost (UPS主机)
|
||
- brand: 品牌
|
||
- model: 型号
|
||
- ip_address: IP地址
|
||
- quantity: 数量
|
||
- location: 存放位置
|
||
- last_maintenance_date: 上次维保时间
|
||
- contact: 联系人
|
||
|
||
### Battery (电池)
|
||
- brand: 品牌
|
||
- model: 型号
|
||
- weight: 重量(kg)
|
||
- quantity: 数量
|
||
- location: 存放位置
|
||
- install_date: 安装日期
|
||
- last_maintenance_date: 上次维保时间
|
||
- ups_host: 关联UPS主机
|
||
|
||
### Contact (联系人)
|
||
- name: 姓名
|
||
- phone: 联系电话
|
||
- email: 邮箱
|
||
|
||
### Supplier (维保供应商)
|
||
- company_name: 公司名称
|
||
- contact_person: 联系人
|
||
- phone: 联系电话
|
||
- email: 邮箱
|
||
- address: 地址
|
||
- remark: 备注
|
||
|
||
### MaintenanceRecord (维修记录)
|
||
- ups_host: UPS主机
|
||
- battery: 电池
|
||
- supplier: 维保供应商
|
||
- maintenance_date: 维修日期
|
||
- technician: 维修人员
|
||
- content: 维修内容
|
||
|
||
## 使用说明
|
||
|
||
1. **添加UPS主机**: 访问 `/ups/add/` 添加新的UPS主机
|
||
2. **编辑UPS主机**: 访问 `/ups/<id>/edit/` 编辑UPS主机信息，同时可以编辑下挂的电池
|
||
3. **添加电池**: 访问 `/battery/add/` 添加新的电池，或在编辑UPS主机时管理
|
||
4. **查看汇总**: 访问首页查看按存放位置的汇总信息
|
||
5. **搜索过滤**: 在各管理页面使用搜索框过滤记录
|
||
|
||
## 版本更新
|
||
|
||
### 最新版本
|
||
- 新增：在编辑UPS主机时可直接管理下挂的电池信息
|
||
- 优化：电池列表支持表格展示和内联编辑
|
||
- 修复：UPS主机的str显示问题
|
||
|
||
## 许可证
|
||
|
||
MIT License
|