# myitdb

**Repository Path**: 0x0021/myitdb

## Basic Information

- **Project Name**: myitdb
- **Description**: 基于django-xadmin的一个资产管理系统,可以录入数据  导出表格
- **Primary Language**: Python
- **License**: MulanPSL-1.0
- **Default Branch**: master
- **Homepage**: https://git.oschina.net/0x0021/myitdb.git
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 4
- **Created**: 2015-08-01
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# MyITDB

## 项目简介

MyITDB 是一个基于 **Django** 和 **xadmin** 开发的开源固定资产（IT 资产）管理系统。作为“第一套django-xadmin开发的程序”，它旨在帮助企业或团队集中管理服务器、网络设备、机房资源以及日常的运维事务（如故障报修、巡检记录）。

项目界面美观，继承了 xadmin 强大的后台管理功能，同时针对 IT 资产管理的业务场景进行了定制。

## 功能特性

- **全面的资产管理**：
    - **基础设施**：支持管理 IDC 机房、服务器、交换机、服务器组、防火墙、UPS、宽带接入、光纤链路、AP/AC 等。
    - **资产属性**：记录硬件的详细配置、位置信息、状态等。
- **运维工作流**：
    - **故障处理**：记录网络故障、硬件维修信息。
    - **日常巡检**：支持机房巡检记录管理。
    - **网络接入**：管理设备的上架与网络接入。
- **日志与审计**：
    - **维护日志**：追踪服务器的每一次维护记录。
    - **访问记录**：记录进出机房或访问设备的历史。
- **可视化界面**：利用 Bootstrap 和 xadmin 提供响应式、图表化的管理后台。

## 技术栈

- **后端框架**: Django (Python)
- **后台管理**: xadmin (Django Admin 的替代品)
- **前端框架**: Bootstrap
- **数据库**: SQLite (默认配置，可切换为 MySQL/PostgreSQL)
- **服务器**: Gevent (支持异步高并发)

## 项目结构

```text
myitdb/
├── hbitdb/             # 核心应用：资产管理模块 (服务器、交换机、网络设备等)
│   ├── models.py       # 数据模型定义
│   └── adminx.py       # xadmin 后台定制
├── app/                # 辅助应用：运维管理模块 (故障、维修、巡检等)
│   ├── models.py       # 业务数据模型
│   └── adminx.py       # 后台配置
├── itdb/               # 项目配置目录
│   ├── settings.py     # Django 设置
│   ├── urls.py         # 路由配置
│   └── openshiftlibs.py # OpenShift 部署支持库
├── static/             # 静态资源文件 (CSS, JS, Images)
├── app.py              # 启动脚本 (支持 Gevent 和 Simple HTTPd)
├── data.db             # SQLite 数据库文件
└── requirements.txt    # Python 依赖列表
```

## 快速开始

### 环境准备

确保已安装 Python 和 pip。

### 安装依赖

```bash
pip install -r requirements.txt
```

### 数据库初始化

项目根目录下包含 `data.db`（SQLite 数据库），如果需要全新构建，请执行以下命令：

```bash
# 生成数据库迁移文件
python manage.py makemigrations

# 执行迁移，创建数据表
python manage.py migrate
```

### 创建管理员账户

登录后台需要超级用户权限：

```bash
python manage.py createsuperuser
```

按照提示输入用户名、邮箱和密码。

### 启动服务

**方式一：标准 Django 开发服务器**

```bash
python manage.py runserver 0.0.0.0:8000
```

**方式二：使用 Gevent 服务器（高性能）**

```bash
python app.py
```

启动后，请在浏览器中访问 `http://localhost:8000` 或 `http://your_server_ip:8000`，使用刚才创建的管理员账户登录即可体验。

## 界面预览

项目提供了直观的图表和列表视图。以下是后台管理界面的一个示例：

*(此处应插入演示截图，项目原始 README 中包含一张演示图，位于 http://git.oschina.net/uploads/images/2015/0801/184930_e6e09297_20780.png)*

## 贡献指南

这是一个自用的开源项目，非常欢迎社区成员提出建议、报告问题或贡献代码。如果您有任何想法或疑问，欢迎 Fork 本仓库并进行讨论。

## 许可证

本项目遵循开源协议，具体许可证信息请参阅 LICENSE 文件。