From 4961132a76ec9cc94fc5df176310c44e56e8e526 Mon Sep 17 00:00:00 2001
From: xiaji <xiaji@example.com>
Date: Thu, 30 Apr 2026 10:35:55 +0800
Subject: [PATCH] Add Chinese README.md

---
 README.md | 127 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 127 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fec9813
--- /dev/null
+++ b/README.md
@@ -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