Add Chinese README.md

This commit is contained in:
xiaji
2026-04-30 10:35:55 +08:00
parent cea28e5b62
commit 4961132a76

127
README.md Normal file
View File

@@ -0,0 +1,127 @@
# 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