Add README.md

ups_management/README.md

@@ -0,0 +1,115 @@
+# UPS管理系统
+
+基于Django的UPS主机和电池管理系统，用于管理UPS设备、电池信息及维修记录。
+
+## 功能特性
+
+- **UPS主机管理** - 管理UPS主机的品牌、型号、IP地址、数量、存放位置等信息
+- **电池管理** - 管理电池的品牌、型号、重量、数量、安装日期等信息
+- **联系人管理** - 管理联系人信息
+- **维保供应商管理** - 管理维保供应商信息
+- **维修记录管理** - 记录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_management/
+├── manage.py              # Django管理命令
+├── ups_management/        # 项目配置目录
+│   ├── settings.py        # 配置文件
+│   ├── urls.py            # 主路由
+│   └── ...
+└── ups_manager/           # 应用目录
+    ├── models.py          # 数据模型
+    ├── views.py           # 视图逻辑
+    ├── urls.py            # 应用路由
+    ├── admin.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. **添加电池**: 访问 `/battery/add/` 添加新的电池
+3. **查看汇总**: 访问首页查看按存放位置的汇总信息
+4. **搜索过滤**: 在各管理页面使用搜索框过滤记录
+
+## 许可证
+
+MIT License