Files
cnbugs 9b79c14267 feat: 新增软件资产(软资产)管理模块
- 新增 SoftwareCategory/SoftwareAsset/SoftwareChangeLog 模型与迁移0010
- 软资产CRUD:编号/名称/分类/供应商/版本/许可类型/授权数量/许可密钥/账号/费用/起止日期/负责人/部门/状态
- 许可类型:永久授权/订阅/开源免费/按需付费;状态:在用/闲置/已过期/已注销
- 到期提醒:已过期/即将到期(30天)自动标识
- Excel导入导出:模板下载、ID存在时更新、分类自动创建、空白行跳过、缺编号/名称报错
- 软件分类独立管理,分类下有资产时禁止删除
- 独立软件变更记录页;仪表盘增加软件统计卡片、软件分类统计、许可类型分布
- 导航栏改造:资产管理/分类管理/变更记录/导入导出下拉菜单
- 全流程15项功能验证通过(CRUD/导入导出/权限/仪表盘)
2026-11-11 17:22:23 +08:00

216 lines
8.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 希姆计算资产管理管理系统
基于 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 密钥 |
## 👥 用户管理
- 超级管理员登录后,导航栏可见 **用户管理** 入口(路径 `/users/`)
- 支持按用户名 / 姓名 / 邮箱搜索,按账号状态(正常/已禁用)筛选
- 点击"重置密码"可为任意用户设置新密码:
- 两次密码必须一致
- 应用 Django 密码强度校验(最少 8 位、不能与用户信息过于相似、不能是常见/纯数字密码)
- 管理员重置自己的密码后当前登录不会失效
- 该功能仅 **超级管理员(is_superuser)** 可访问,其他用户访问会被拒绝
## 🖥️ 软件资产管理
- 导航栏 **资产管理 → 软件资产**(路径 `/software/`)
- 字段:资产编号、软件名称、软件分类、供应商、版本、许可类型(永久授权/订阅/开源免费/按需付费)、授权数量、许可密钥/激活码、账号、费用、启用/到期日期、负责人、使用部门、状态(在用/闲置/已过期/已注销)、备注
- 到期提醒:已过期/即将到期(30天内)自动标识
- 软件分类独立管理(路径 `/software/categories/`),分类下有资产时禁止删除
- 变更记录:创建/更新/删除/导入/导出全程留痕(路径 `/software/changelog/`)
- Excel 导入导出与硬件一致:模板下载、ID 存在时更新、分类自动创建
## 📊 Excel 导入格式
| 资产编号 | 设备名称 | 分类 | 品牌 | 型号 | 资产面值 | 序列号 | 状态 | IP地址 | BMC地址 | 设备位置 | 负责人 | 使用部门 | 维护人 | 采购日期 | 质保到期 | 备注 |
|----------|---------|------|------|------|---------|--------|------|--------|---------|---------|--------|---------|--------|---------|---------|------|
- 分类不存在时自动创建
- 资产编号允许重复
- 日期格式:YYYY-MM-DD
- 状态可选:在用、闲置、维修中、已报废
## 📊 软件资产导入格式
| ID | 资产编号 | 软件名称 | 软件分类 | 供应商 | 版本 | 许可类型 | 授权数量 | 许可密钥/激活码 | 账号 | 费用(元) | 启用日期 | 到期日期 | 负责人 | 使用部门 | 状态 | 备注 |
|----|---------|---------|---------|--------|------|---------|---------|----------------|------|---------|---------|---------|--------|---------|------|------|
- ID 列可选:ID 已存在时更新该记录,否则创建新记录
- 许可类型可选:永久授权、订阅、开源免费、按需付费
- 状态可选:在用、闲置、已过期、已注销
- 日期格式: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
│ ├── models.py # 数据模型(硬件资产 + 软件资产)
├── templates/assetapp/ # HTML 模板(含 user_list / software_* 系列)
├── static/css/ # 静态资源
├── docker-compose.yml # Docker 编排
├── Dockerfile # 容器构建
├── entrypoint.sh # 启动脚本
├── requirements.txt # Python 依赖
└── manage.py # Django 入口
```
## 📝 版本历史
### 1.0.1
- 新增软件资产(软资产)管理:软件分类、软件资产 CRUD、许可类型、到期提醒
- 软件资产 Excel 导入导出、模板下载、独立变更记录
- 仪表盘增加软件资产统计(总数/状态/许可类型分布)
- 导航栏改造:资产管理/分类管理/变更记录/导入导出下拉菜单
### v1.1.0
- 新增用户管理:超级管理员可查看用户列表、搜索筛选、重置任意用户密码
- 补充密码强度校验配置
### v1.0.0
- 资产增删改查
- 仪表盘统计
- 分类管理
- 变更追踪
- Excel 导入导出
- 多维度搜索筛选
- 质保到期提醒
- 深色主题
- Docker 部署支持