v1.0.0: 希姆计算资产管理系统正式版

2026-04-25 08:29:01 +08:00
parent a40a0137cf
commit 855547d70f
11 changed files with 279 additions and 18 deletions
@@ -0,0 +1,171 @@
+# 希姆计算资产管理管理系统
+
+基于 Django + MySQL 的企业级硬件资产管理系统，支持 Excel 批量导入导出。
+
+## ✨ 功能特性
+
+- **仪表盘** — 资产统计总览、分类统计、状态分布、最近变更记录
+- **资产管理** — 设备增删改查、资产编号/品牌/型号/序列号/资产面值等完整字段
+- **分类管理** — 自定义设备分类（服务器、网络设备、存储设备等）
+- **变更追踪** — 资产信息修改自动记录变更历史
+- **Excel 导入导出** — 批量导入（分类不存在自动创建）、筛选导出、模板下载
+- **多维度搜索** — 按编号/名称/部门/使用人/位置搜索，按分类/状态/位置筛选
+- **质保提醒** — 已过保/即将过保状态标识
+- **用户认证** — 登录/退出，管理员权限控制
+- **深色主题** — 护眼深色 UI，适合长时间使用
+
+## 🛠️ 技术栈
+
+| 组件 | 技术 |
+|------|------|
+| 后端 | Django 4.2 |
+| 数据库 | MySQL / MariaDB |
+| 前端 | Bootstrap 5 + 自定义深色主题 |
+| 部署 | Docker Compose / 直接运行 |
+
+## 📋 资产字段
+
+| 字段 | 说明 |
+|------|------|
+| 资产编号 | 自定义编号，可重复 |
+| 设备名称 | 设备名称 |
+| 分类 | 服务器/网络设备/存储设备等（支持自定义） |
+| 品牌 | 设备品牌 |
+| 型号 | 设备型号 |
+| 资产面值 | 资产价值（元） |
+| 序列号 | 设备序列号 |
+| 状态 | 在用/闲置/维修中/已报废 |
+| IP地址 | 管理IP |
+| BMC地址 | BMC管理地址 |
+| 设备位置 | 机房/机柜/U位 |
+| 负责人 | 设备负责人 |
+| 使用部门 | 使用部门 |
+| 使用人 | 实际使用人 |
+| 采购日期 | 采购时间 |
+| 质保到期 | 质保截止日期 |
+| 备注 | 补充说明 |
+
+## 🚀 快速部署
+
+### 方式一：Docker Compose（推荐）
+
+```bash
+# 克隆仓库
+git clone ssh://git@git.cnbugs.com:10022/cnbugs/asset-management.git
+cd asset-management
+
+# 启动服务
+docker-compose up -d
+
+# 访问系统
+# http://<服务器IP>:8010
+# 默认账号: admin / admin123
+```
+
+### 方式二：直接运行
+
+```bash
+# 克隆仓库
+git clone ssh://git@git.cnbugs.com:10022/cnbugs/asset-management.git
+cd asset-management
+
+# 创建虚拟环境
+python3 -m venv venv
+source venv/bin/activate
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 配置数据库（修改 config/settings.py 中的 DATABASES）
+# 创建 MySQL 数据库: CREATE DATABASE asset_management CHARACTER SET utf8mb4;
+
+# 初始化
+python manage.py migrate
+python manage.py createsuperuser
+
+# 启动
+python manage.py runserver 0.0.0.0:8010
+```
+
+## ⚙️ 配置说明
+
+### 数据库配置
+
+编辑 `config/settings.py` 中的 `DATABASES`：
+
+```python
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.mysql',
+        'NAME': 'asset_management',
+        'USER': 'root',
+        'PASSWORD': 'password123',
+        'HOST': 'localhost',
+        'PORT': '3306',
+    }
+}
+```
+
+### Docker 环境变量
+
+在 `docker-compose.yml` 中配置：
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| MYSQL_HOST | db | MySQL 主机 |
+| MYSQL_PORT | 3306 | MySQL 端口 |
+| MYSQL_USER | root | MySQL 用户 |
+| MYSQL_PASSWORD | password123 | MySQL 密码 |
+| MYSQL_DATABASE | asset_management | 数据库名 |
+| DJANGO_DEBUG | False | 调试模式 |
+| DJANGO_SECRET_KEY | your-secret-key... | Django 密钥 |
+
+## 📊 Excel 导入格式
+
+| 资产编号 | 设备名称 | 分类 | 品牌 | 型号 | 资产面值 | 序列号 | 状态 | IP地址 | BMC地址 | 设备位置 | 负责人 | 使用部门 | 使用人 | 采购日期 | 质保到期 | 备注 |
+|----------|---------|------|------|------|---------|--------|------|--------|---------|---------|--------|---------|--------|---------|---------|------|
+
+- 分类不存在时自动创建
+- 资产编号允许重复
+- 日期格式：YYYY-MM-DD
+- 状态可选：在用、闲置、维修中、已报废
+
+## 📁 项目结构
+
+```
+asset-management/
+├── assetapp/                  # 主应用
+│   ├── models.py              # 数据模型
+│   ├── views.py               # 视图逻辑
+│   ├── forms.py               # 表单定义
+│   ├── excel_utils.py         # Excel 导入导出工具
+│   ├── urls.py                # URL 路由
+│   ├── management/commands/   # 管理命令
+│   ├── migrations/            # 数据库迁移
+│   └── templatetags/          # 自定义模板标签
+├── config/                    # Django 配置
+│   ├── settings.py
+│   ├── urls.py
+│   └── wsgi.py
+├── templates/assetapp/        # HTML 模板
+├── static/css/                # 静态资源
+├── docker-compose.yml         # Docker 编排
+├── Dockerfile                 # 容器构建
+├── entrypoint.sh              # 启动脚本
+├── requirements.txt           # Python 依赖
+└── manage.py                  # Django 入口
+```
+
+## 📝 版本历史
+
+### v1.0.0
+
+- 资产增删改查
+- 仪表盘统计
+- 分类管理
+- 变更追踪
+- Excel 导入导出
+- 多维度搜索筛选
+- 质保到期提醒
+- 深色主题
+- Docker 部署支持