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