feat(api): Replace imp with importlib

CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of the level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

README.md

@@ -1,116 +1,138 @@
 
 <p align="center">
-  <a href="https://veops.cn"><img src="docs/images/logo.png" alt="维易CMDB" width="300"/></a>
+  <a href="https://veops.cn">
+    <img src="https://github.com/user-attachments/assets/c5cfb272-899b-418d-9e69-8e1dd07db0f6" alt="维易CMDB"/>
+  </a>
 </p>
-<h3 align="center">简单、轻量、通用的运维配置管理数据库</h3>
+
+<h4 align="center">简单、轻量、通用的运维配置管理数据库</h4>
+
 <p align="center">
   <a href="https://github.com/veops/cmdb/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-AGPLv3-brightgreen" alt="License: GPLv3"></a>
-  <a href="https:https://github.com/sendya/ant-design-pro-vue"><img src="https://img.shields.io/badge/UI-Ant%20Design%20Pro%20Vue-brightgreen" alt="UI"></a>
+  <a href="https://github.com/veops/cmdb/releases"><img alt="the latest release version" src="https://img.shields.io/github/v/release/veops/cmdb?color=75C1C4&include_prereleases&label=Release&logo=github&logoColor=white"></a>
-  <a href="https://github.com/pallets/flask"><img src="https://img.shields.io/badge/API-Flask-brightgreen" alt="API"></a>
+  <a href="https:https://github.com/sendya/ant-design-pro-vue"><img src="https://img.shields.io/badge/UI-Ant%20Design%20Pro%20Vue-green" alt="UI"></a>
+  <a href="https://github.com/pallets/flask"><img src="https://img.shields.io/badge/API-Flask-bright" alt="API"></a>
+  <a href="https://github.com/veops/cmdb/stargazers"><img src="https://img.shields.io/github/stars/veops/cmdb" alt="Stars Badge"/></a>
+  <a href="https://github.com/veops/cmdb"><img src="https://img.shields.io/github/forks/veops/cmdb" alt="Forks Badge"/></a>
+</p>
+<p align="center">
+  中文(简体) · <a href="docs/README_en.md">English</a>
 </p>
-
-
-------------------------------
-
-[English](docs/README_en.md) / [中文](README.md)
-- 产品文档：https://veops.cn/docs/
-- 在线体验：<a href="https://cmdb.veops.cn" target="_blank">CMDB</a>
-  - username: demo 或者 admin
-  - password: 123456
-
-> **重要提示**: `master` 分支在开发过程中可能处于 _不稳定的状态_ 。
-> 请通过[releases](https://github.com/veops/cmdb/releases)获取
 
 ## 系统介绍
 
-### 系统概览
+维易CMDB是一个简洁、轻量且高度可定制的运维配置管理数据库（CMDB）。它支持灵活的模型配置和资源自动发现，旨在为企业提供便捷的资产管理解决方案，帮助运维团队高效地管理 IT 基础设施和服务。
 
-<img src=docs/images/dashboard.png />
+- 产品文档：[https://veops.cn/docs/](https://veops.cn/docs/)
-
+- 在线体验：[https://cmdb.veops.cn](https://cmdb.veops.cn)
-
+  - 用户名：demo 或者 admin
-### 相关文章
+  - 密码：123456
-
+- **重要提示**：`master` 分支在开发过程中可能处于**不稳定的状态**。请通过 [releases](https://github.com/veops/cmdb/releases) 获取最新稳定版本。
-- <a href="https://mp.weixin.qq.com/s/v3eANth64UBW5xdyOkK3tg" target="_blank">概要设计</a>
-- <a href="https://github.com/veops/cmdb/tree/master/docs/cmdb_api.md" target="_blank">API 文档</a>
-- <a href="https://mp.weixin.qq.com/s/rQaf4AES7YJsyNQG_MKOLg" target="_blank">自动发现</a>
-- 更多文章可以在公众号 **维易科技OneOps** 里查看
-
-### 特点
-
-- 灵活性
-  1. 配置灵活，不设定任何运维场景，有内置模板
-  2. 自动发现、入库 IT 资产
-- 安全性
-  1. 细粒度权限控制
-  2. 完备操作日志
-- 多应用
-  1. 丰富视图展示维度
-  2. API简单强大
-  3. 支持定义属性触发器、计算属性
 
 ### 主要功能
 
-- 自定义模型和模型关系，模型属性支持下拉列表、字体颜色、计算属性等高级特性
+- **自定义模型和模型关系**：支持模型属性的自定义，包括下拉列表、字体颜色、计算属性等高级功能，满足不同业务需求。
-- 支持计算机、网络设备、存储设备、数据库、中间件、公有云资源等自动发现
+- **自动发现资源**：支持计算机、网络设备、存储设备、数据库、中间件、公有云资源等自动发现。
-- 支持资源、层级、关系视图展示
+- **多维度视图展示**：包括资源视图、层级视图、关系视图等，帮助运维人员全面管理资源。
-- 细粒度访问控制，完备的操作日志
+- **细粒度权限控制**：通过精确的访问控制和完备的操作日志保障系统的安全性。
-- 通用的资源搜索和关系搜索
+- **全面的资源搜索功能**：支持灵活的资源和关系搜索，快速定位和操作资源。
-- 支持IP地址管理(IPAM), 数据中心基础设施管理(DCIM)
+- **集成 IP 地址管理（IPAM）和数据中心基础设施管理（DCIM）**：简化网络资源和数据中心设备的管理。
 
+更多详细功能，请移步 [维易科技官网](https://veops.cn) 进行了解。
 
+### 系统优势
 
-### 更多功能
+- 灵活性
+  + 无需指定固定运维场景，支持自由配置并内置多种模板
+  + 支持自动发现和入库 IT 资产，快速搭建资产管理系统
+- 安全性
+  + 细粒度的权限控制机制，确保资源管理的安全性
+  + 完整的操作日志记录，便于审计和问题追踪
+- 多应用
+  + 提供多种视图展示方式，满足不同场景的需求
+  + 强大的 API 接口，支持深度集成
+  + 支持定义属性触发器和计算属性，增强数据处理能力
 
-> 也欢迎移步[维易科技官网](https://veops.cn)，发现更多免费运维系统。
+### 技术栈
+
++ 后端：Python [3.8-3.11]
++ 数据存储：MySQL、Redis
++ 前端：Vue.js
++ UI组件库：Ant Design Vue
+
+### 系统概览
+
+<table style="border-collapse: collapse;">
+  <tr>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/6d2df835-ae93-4d91-9bd9-213c270eca7a"/>
+    </td>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/cb8b598a-a1f9-4c74-adf1-6e59aea2c9b3"/>
+    </td>
+  </tr>
+
+  <tr>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/b440224f-53c3-4b7f-a9be-285d7a4b848f"/>
+    </td>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/f457d5a0-b60b-4949-b94e-020f4c61444b"/>
+    </td>
+  </tr>
+</table>
+
+## 关注我们
+
+欢迎 Star 加关注，第一时间获取更新动态！
+
+![star us](https://github.com/user-attachments/assets/f9056d5a-171c-4f53-9fec-d40c9e5ff94d)
+
+## 快速开始
+
+### 1. 搭建
+
++ 方案一：Docker 一键快速构建
+
+  - 第1步: 安装 Docker 环境和 Docker Compose（v2）
+  - 第2步: 拷贝项目代码, `git clone https://github.com/veops/cmdb.git`
+  - 第3步：进入主目录并启动, `docker compose up -d`
+
++ 方案二：[本地开发环境搭建](docs/local.md)
++ 方案三：[Makefile 安装](docs/makefile.md)
+
+### 2. 访问
+- 打开浏览器并访问: [http://127.0.0.1:8000](http://127.0.0.1:8000)
+- 用户名: demo 或者 admin
+- 密码: 123456
 
 ## 接入公司
 
-> 欢迎使用开源CMDB的公司，在 [#112](https://github.com/veops/cmdb/issues/112) 登记
++ 欢迎使用开源CMDB的公司和团队，在 [#112](https://github.com/veops/cmdb/issues/112) 登记
 
-## 安装
+## 代码贡献
+我们欢迎所有开发者贡献代码，改善和扩展这个项目。请先阅读我们的[贡献指南](docs/CONTRIBUTING.md)。此外，您还可以通过社交媒体、活动和分享来支持 Veops 的开源。
 
-### Docker 一键快速构建
+<a href="https://github.com/veops/cmdb/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=veops/cmdb" />
+</a>
 
-[//]: # (> 方法一)
+## 更多开源
-- 第一步: 先安装 Docker 环境, 以及Docker Compose (v2)
-- 第二步: 拷贝项目
-```shell 
-git clone https://github.com/veops/cmdb.git
-```
-- 第三步：进入主目录，执行:
-```
-docker compose up -d
-```
 
-[//]: # (> 方法二, 该方法适用于linux系统)
+- [OneTerm](https://github.com/veops/oneterm): 一款简单、轻量、灵活的堡垒机服务。
+- [messenger](https://github.com/veops/messenger): 一个简单轻量的消息发送服务。
+- [ACL](https://github.com/veops/acl): 一个简单通用的权限管理系统设计与实践。
 
-[//]: # (- 第一步： 先安装 Docker 环境, 以及Docker Compose &#40;v2&#41;)
+## 相关文章
 
-[//]: # (- 第二步： 直接使用项目根目录下的install.sh 文件进行 `安装`、`启动`、`暂停`、`查状态`、`删除`、`卸载`)
+- <a href="https://mp.weixin.qq.com/s/v3eANth64UBW5xdyOkK3tg" target="_blank">尽可能通用的运维CMDB的设计与实践(Ⅰ) - 概览</a>
+- <a href="https://mp.weixin.qq.com/s/rQaf4AES7YJsyNQG_MKOLg" target="_blank">尽可能通用的运维CMDB的设计与实践(ⅠⅠ) - 自动发现</a>
+- <a href="https://github.com/veops/cmdb/tree/master/docs/cmdb_api.md" target="_blank">CMDB接口文档</a>
 
-[//]: # (```shell)
+更多文章可以在公众号 **维易科技OneOps** 里查看
 
-[//]: # (curl -so install.sh https://raw.githubusercontent.com/veops/cmdb/deploy_on_kylin_docker/install.sh)
+## 与我联系
 
-[//]: # (sh install.sh install)
++ 邮箱: <a href="mailto:bd@veops.cn">bd@veops.cn</a>
-
++ 公众号：**维易科技OneOps**。关注后可以加入微信群，参与产品和技术交流  
-[//]: # (```)
+  <img src="docs/images/wechat.png" alt="公众号: 维易科技OneOps" />
-
-### [本地开发环境搭建](docs/local.md)
-
-### [Makefile 安装](docs/makefile.md)
-
-## 验证
-- 浏览器打开: [http://127.0.0.1:8000](http://127.0.0.1:8000)
-- username: demo 或者 admin
-- password: 123456
-
-
----
-
-_**欢迎关注公众号(维易科技OneOps)，关注后可加入微信群，进行产品和技术交流。**_
-
-
-<p align="center">
-  <img src="docs/images/wechat.png" alt="公众号: 维易科技OneOps" />
-</p>

cmdb-api/api/lib/cmdb/value.py

@@ -3,7 +3,7 @@
 
 from __future__ import unicode_literals
 
-import imp
+import importlib.util
 
 import copy
 import jinja2
@@ -198,11 +198,11 @@ class AttributeValueManager(object):
 
         try:
             path = script_f.name
-            dir_name, name = os.path.dirname(path), os.path.basename(path)[:-3]
+            name = os.path.basename(path)[:-3]
 
-            fp, path, desc = imp.find_module(name, [dir_name])
+            spec = importlib.util.spec_from_file_location(name, path)
-
+            mod = importlib.util.module_from_spec(spec)
-            mod = imp.load_module(name, fp, path, desc)
+            spec.loader.exec_module(mod)
 
             if hasattr(mod, 'computed'):
                 return mod.computed()

cmdb-api/api/views/cmdb/auto_discovery.py

@@ -30,6 +30,7 @@ from api.lib.cmdb.search import SearchError
 from api.lib.cmdb.search.ci import search as ci_search
 from api.lib.decorator import args_required
 from api.lib.decorator import args_validate
+from api.lib.exception import AbortException
 from api.lib.perm.acl.acl import has_perm_from_args
 from api.lib.utils import AESCrypto
 from api.lib.utils import get_page
@@ -296,7 +297,10 @@ class AutoDiscoveryRuleSyncView(APIView):
 
         rules, last_update_at1 = AutoDiscoveryCITypeCRUD.get(None, oneagent_id, oneagent_name, last_update_at)
 
-        subnet_scan_rules, last_update_at2 = SubnetManager().scan_rules(oneagent_id, last_update_at)
+        try:
+            subnet_scan_rules, last_update_at2 = SubnetManager().scan_rules(oneagent_id, last_update_at)
+        except AbortException:
+            subnet_scan_rules, last_update_at2 = [], ""
 
         return self.jsonify(rules=rules,
                             subnet_scan_rules=subnet_scan_rules,

cmdb-api/api/views/cmdb/ci_type.py

@@ -64,9 +64,13 @@ class CITypeView(APIView):
                 ci_type['unique_name'] = ci_type['unique_id'] and AttributeCache.get(ci_type['unique_id']).name
                 ci_types.append(ci_type)
         elif type_name is not None:
-            ci_type = CITypeCache.get(type_name).to_dict()
+            ci_type = CITypeCache.get(type_name)
-            ci_type['parent_ids'] = CITypeInheritanceManager.get_parents(ci_type['id'])
+            if ci_type is not None:
-            ci_types = [ci_type]
+                ci_type = ci_type.to_dict()
+                ci_type['parent_ids'] = CITypeInheritanceManager.get_parents(ci_type['id'])
+                ci_types = [ci_type]
+            else:
+                ci_types = []
         else:
             ci_types = CITypeManager().get_ci_types(q)
         count = len(ci_types)

cmdb-ui/src/views/user/Login.vue

@@ -1,7 +1,7 @@
 <template>
   <div class="ops-login">
     <div class="ops-login-left">
-      <span>维易科技<br />让运维更简单</span>
+      <span>维易科技 &nbsp;&nbsp; 让运维变简单</span>
     </div>
     <div class="ops-login-right">
       <img src="../../assets/logo_VECMDB.png" />
@@ -216,12 +216,12 @@ export default {
       transform: translate(-50%, -50%);
     }
     > span {
-      color: white;
+      color: @text-color_2;
       position: absolute;
-      top: 10%;
+      bottom: 10%;
       left: 50%;
       transform: translateX(-50%);
-      font-size: 1.75vw;
+      font-size: 26px;
     }
   }
   .ops-login-right {

docker-compose.yml

@@ -41,7 +41,7 @@ services:
           - redis
 
   cmdb-api:
-    image: registry.cn-hangzhou.aliyuncs.com/veops/cmdb-api:2.4.17
+    image: registry.cn-hangzhou.aliyuncs.com/veops/cmdb-api:2.5.1
     container_name: cmdb-api
     env_file:
       - .env
@@ -84,7 +84,7 @@ services:
       test: "ps aux|grep -v grep|grep -v '1 root'|grep gunicorn || exit 1"
 
   cmdb-ui:
-    image: registry.cn-hangzhou.aliyuncs.com/veops/cmdb-ui:2.4.17
+    image: registry.cn-hangzhou.aliyuncs.com/veops/cmdb-ui:2.5.1
     container_name: cmdb-ui
     depends_on:
       cmdb-api:

docs/CONTRIBUTING.md

@@ -0,0 +1,61 @@
+# 🎉 Contributing to CMDB 🥳
+
+首先，非常感谢您考虑为我们的项目做出贡献！我们欢迎任何形式的贡献，无论是提出新功能、改进代码、修复 bug 还是改善文档。
+
+本指南将为您提供所有相关信息，帮助您快速入门并开始参与本项目。请花几分钟阅读它，它将帮助我们更好地协作，共同创造一个更好的项目。
+
+## ❖ 提交问题 (Issue)
+
+在提交 PR 之前，请先搜索 现有的 [PR](https://github.com/veops/cmdb/pulls) 或 [Issue](https://github.com/veops/cmdb/issues)，查看是否已经有相关的开放或关闭的提交。
+
+如果是修复 bug，请首先提交一个 Issue。
+
+对于新增功能，请先通过我们提供的联系方式与我们直接联系，以便更好的合作。
+
+## ❖ 提交 PR 的步骤
+
+1. 在 Github 上 fork 该项目的仓库。
+2. 在本地复制仓库后创建一个新分支，用于开发新功能、修复 bug 或进行其他贡献，命令：`git checkout -b feat/xxxx`。
+3. 提交您的更改：`git commit -am 'feat: add xxxxx'`。
+4. 推送您的分支：`git push origin feat/xxxx`。
+5. 提交 Pull Request 时，请确保您的源分支是刚刚推送的分支，目标分支是 CMDB 项目的 master 分支。
+6. 提交后，请留意与 Pull Request 相关的邮件和通知。待通过审核后，我们会按计划将其合并到 master 分支，并进行新一轮的版本发布。
+
+## ❖ 开发环境
+- Python 版本 >= 3.8
+- Node.js 版本 >= 14.17.6
+- Docker
+
+## ❖ 代码风格
+
+**API**: 请遵循 [Python Style](https://google.github.io/styleguide/pyguide.html) 
+
+**UI**: 请遵循 [node-style-guide](https://github.com/felixge/node-style-guide)
+
+## ❖ 提交信息
+
++ 请遵循 [Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular)
+
++ 提交时使用不同的范围
+  - API: `feat(api): xxx`
+  - UI: `feat(ui): xxx`
+
++ 为了确保所有开发者都能更好地理解，提交信息请使用英文。
+
+  - `feat` 添加新功能
+  - `fix` 修复问题/BUG
+  - `style` 代码风格相关，不影响运行结果
+  - `perf` 优化/性能提升
+  - `refactor` 代码重构
+  - `revert` 撤销编辑
+  - `test` 测试相关
+  - `docs` 文档/注释
+  - `chore` 依赖更新/脚手架配置修改等
+  - `workflow` 工作流优化
+  - `ci` 持续集成
+  - `types` 类型定义文件变更
+  - `wip` 开发中
+
+## ❖ 代码内容
+
+为了便于所有开发者理解，请确保代码注释和代码内容使用英文。

docs/CONTRIBUTING_en.md

@@ -0,0 +1,61 @@
+# 🎉 Contributing to CMDB 🥳
+
+First of all, thank you very much for considering contributing to our project! We welcome any kind of contribution, whether it's proposing new functional features, improving code, fixing bugs, or improving documentation.
+
+This guide will provide all the relevant information to help you get started working on this project. Please take a few minutes to read it, it will help us collaborate better and create a better project together.
+
+## ❖ Submit Issue
+
+Before jumping into a PR be sure to search [existing PRs](https://github.com/veops/cmdb/pulls) or [issues](https://github.com/veops/cmdb/issues) for an open or closed item that relates to your submission.
+
+If it's a bug fix, please raise it in an Issue first.
+
+For new feature additions, please first contact us directly via the contact information we provide.
+
+## ❖ Pull Requests Steps
+
+1. Fork this project's repo on Github
+2. Create a new branch on your local copy to develop new features, fix bugs, or make other contributions, `git checkout -b feat/xxxx`
+3. Submit your changes: `git commit -am 'feat: add xxxxx'`
+4. Push your branch: `git push origin feat/xxxx`
+5. To submit a `Pull Request`, make sure your source branch is the one you just pushed, and your target branch is the `master` branch of the CMDB project.
+6. After submitting, watch out for emails and notifications associated with the Pull request. Once it's approved, we'll merge it into the `master` branch as planned. Doing a new round of releases
+
+## ❖ Development Environment
+- Python >= 3.8
+- node >= 14.17.6
+- docker
+
+## ❖ Code Style
+
+**API**: Please follow the [Python Style](https://google.github.io/styleguide/pyguide.html)
+
+**UI**: Please follow the [node-style-guide](https://github.com/felixge/node-style-guide)
+
+## ❖ Commit Messages
+
++ Please follow the [Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular)
+
++ Commit with different scopes
+  - API: `feat(api): xxx`
+  - UI: `feat(ui): xxx`
+
++ Please keep the commit message in English for better understanding by all developers.
+
+  - `feat` Add new features
+  - `fix` Fix the problem/BUG
+  - `style` The code style is related and does not affect the running result
+  - `perf` Optimization/performance improvement
+  - `refactor` Refactor
+  - `revert` Undo edit
+  - `test` Test related
+  - `docs` Documentation/notes
+  - `chore` Dependency update/scaffolding configuration modification etc.
+  - `workflow` Workflow improvements
+  - `ci` Continuous integration
+  - `types` Type definition file changes
+  - `wip` In development
+
+## ❖ Code Content
+
+Please keep the code comments and code content in English for better understanding by all developers.

docs/README_en.md

@@ -1,101 +1,126 @@
-
-<h2 align="center">Simple, lightweight, and versatile operational CMDB</h2>
 <p align="center">
-  <a href="https://github.com/veops/cmdb/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-AGPLv3-brightgreen" alt="License: GPLv3"></a>
+  <a href="https://veops.cn">
-  <a href="https:https://github.com/sendya/ant-design-pro-vue"><img src="https://img.shields.io/badge/UI-Ant%20Design%20Pro%20Vue-brightgreen" alt="UI"></a>
+    <img src="https://github.com/user-attachments/assets/c5cfb272-899b-418d-9e69-8e1dd07db0f6" alt="VE CMDB"/>
-  <a href="https://github.com/pallets/flask"><img src="https://img.shields.io/badge/API-Flask-brightgreen" alt="API"></a>
+  </a>
 </p>
 
+<h4 align="center">Simple, lightweight, and versatile operational CMDB</h4>
+<p align="center">
+  <a href="https://github.com/veops/cmdb/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-AGPLv3-brightgreen" alt="License: GPLv3"></a>
+  <a href="https://github.com/veops/cmdb/releases"><img alt="the latest release version" src="https://img.shields.io/github/v/release/veops/cmdb?color=75C1C4&include_prereleases&label=Release&logo=github&logoColor=white"></a>
+  <a href="https:https://github.com/sendya/ant-design-pro-vue"><img src="https://img.shields.io/badge/UI-Ant%20Design%20Pro%20Vue-green" alt="UI"></a>
+  <a href="https://github.com/pallets/flask"><img src="https://img.shields.io/badge/API-Flask-bright" alt="API"></a>
+  <a href="https://github.com/veops/cmdb/stargazers"><img src="https://img.shields.io/github/stars/veops/cmdb" alt="Stars Badge"/></a>
+  <a href="https://github.com/veops/cmdb"><img src="https://img.shields.io/github/forks/veops/cmdb" alt="Forks Badge"/></a>
+</p>
 
-------------------------------
+<p align="center">
+  English · <a href="../README.md">中文(简体)</a>
+</p>
 
-[English](README_en.md) / [中文](../README.md)
+## Introduce 
+VE CMDB is a simple, lightweight and highly customizable operations and maintenance configuration management database (CMDB). It supports flexible model configuration and resource auto-discovery, and is designed to provide organizations with a convenient asset management solution that helps operations teams efficiently manage IT infrastructure and services.
 
-## DEMO ONLINE
+- Product document：[https://veops.cn/docs/](https://veops.cn/docs/)
-- Product document：https://veops.cn/docs/
+- Preview online: [https://cmdb.veops.cn](https://cmdb.veops.cn)
-- Preview online: <a href="https://cmdb.veops.cn" target="_blank">CMDB</a>
   - username: demo
   - password: 123456
-
+- **ATTENTION**: branch `master` may be unstable as the result of continued development, Please use [releases](https://github.com/veops/cmdb/releases) to get the latest stable version
-> **ATTENTION**: branch `master` may be unstable as the result of continued development, please pull code from [releases](https://github.com/veops/cmdb/releases)
-
-## Overview
-
 
 ### Features
 
+- **Custom Model and Model Relationships**: Supports customization of model attributes, including drop-down lists, font colors, calculated attributes and other advanced functions to meet different business needs.  
+- **Auto-discovery of resources**: supports auto-discovery of computers, network devices, storage devices, databases, middleware, public cloud resources, etc.
+- **Multi-dimensional view display**: including resource view, hierarchical view, relationship view, etc., helping O&M personnel to comprehensively manage resources.
+- **Fine-grained privilege control**: ensure system security through precise access control and complete operation logs.
+- **Comprehensive Resource Search Function**: Supports flexible resource and relationship search to quickly locate and operate resources.
+- **Integrated IP Address Management (IPAM) and Data Center Infrastructure Management (DCIM) features**: Simplify the management of network resources and data center equipment.
+
+For more detailed features, please visit the [official website](https://veops.cn).
+
+### System Advantage
+
 - Flexibility
-  1. Standardize and manage complex data assets
+  + No need to specify fixed operation and maintenance scenarios, supports free configuration and built-in multiple templates.
-  2. Automatically discover and inventory IT assets
+  + Support automatic discovery and inventory of IT assets, quickly set up an asset management system.
 - Security
-  1. Fine-grained access control
+  + Fine-grained permission control mechanism to ensure the security of resource management.
-  2. Comprehensive operation logs
+  + Complete operation logs for easy auditing and problem tracking.
 - Multi-application
-  1. Rich view display dimensions
+  + Provides multiple views to meet the needs of different scenarios.
-  2. Provide Restful API
+  + Powerful API interface supports deep integration.
-  3. Custom field triggers
+  + Support for defining attribute triggers and calculating attributes to enhance data processing capabilities.
 
-### Main Features
+### Tech Stack
 
-- Custom models and model relationships, with model attributes supporting advanced features such as dropdown lists, font colors, and computed attributes.
++ Back-end: Python [3.8-3.11].
-- Support for automatic discovery of computers, network devices, storage devices, databases, middleware, public cloud resources, etc.
++ Data Storage: MySQL, Redis
-- Support for displaying resource, hierarchy, and relationship views.
++ Front-end: Vue.js
-- Fine-grained access control and comprehensive operation logs.
++ UI component library: Ant Design Vue
-- General resource and relationship search capabilities.
-- Support for IP Address Management (IPAM) and Data Center Infrastructure Management (DCIM).
 
+### Overview
 
+<table style="border-collapse: collapse;">
+  <tr>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/6d2df835-ae93-4d91-9bd9-213c270eca7a"/>
+    </td>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/cb8b598a-a1f9-4c74-adf1-6e59aea2c9b3"/>
+    </td>
+  </tr>
 
-### More Features
+  <tr>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/b440224f-53c3-4b7f-a9be-285d7a4b848f"/>
+    </td>
+    <td style="padding: 5px;background-color:#fff;">
+      <img width="400" src="https://github.com/user-attachments/assets/f457d5a0-b60b-4949-b94e-020f4c61444b"/>
+    </td>
+  </tr>
+</table>
 
-> Welcome to visit VeOps official website to discover more free operations and maintenance systems.
+## Getting started & staying tuned with us
 
-## Installation
+Star us, and you will receive all releases notifications from GitHub without any delay!
 
-### One-Click Docker Quick Build
+![star us](https://github.com/user-attachments/assets/f9056d5a-171c-4f53-9fec-d40c9e5ff94d)
 
-[//]: # (> Method 1)
+## Quick Start
-- step 1: **Prepare: install Docker and Docker Compose (v2)**
-- step 2:  copy the repository
-```shell 
-git clone https://github.com/veops/cmdb.git
-```
-- step 3: In directory cmdb:
-```
-docker compose up -d
-```
 
-[//]: # (> M**ethod 2  Usefull for linux os.)
+### 1. Set up
 
-[//]: # (- step 1: **Prepare: install Docker and Docker Compose &#40;v2&#41;**)
++ Option 1: Docker One-Click Quick Builds
 
-[//]: # (- step 2: directly use the install.sh file in the project's root directory to `install`, `start`, `pause`, `status`, `delete`, and `uninstall` the application. )
+  - Step 1: Install Docker environment and Docker Compose (v2)
+  - Step 2: Copy the project code, `git clone https://github.com/veops/cmdb.git`
+  - Step 3: Enter the home directory and start, `docker compose up -d`
 
-[//]: # (```shell)
++ [Local Setup](local_en.md)
++ [Installation with Makefile](makefile_en.md)
 
-[//]: # (curl -so install.sh https://raw.githubusercontent.com/veops/cmdb/master/install.sh )
+### 2. Visit
+- Open your browser and visit: [http://127.0.0.1:8000](http://127.0.0.1:8000)
+- Username: demo or admin
+- Password: 123456
 
-[//]: # (sh install.sh install)
+## Access Company
 
-[//]: # (```**)
++ Companies using the open source CMDB are welcome to record in [#112](https://github.com/veops/cmdb/issues/112)
-
-
-### [Local Setup](local_en.md)
-
-### [Installation with Makefile](makefile_en.md)
-
-## Validation
-
-- View: [http://127.0.0.1:8000](http://127.0.0.1:8000)
-- username: demo or admin
-- password: 123456
 
 ## Contributing
+We welcome all developers to contribute code to improve and extend this project. Please read our [contribution guidelines](./CONTRIBUTING_en.md) first. Additionally, you can support Veops open source through social media, events, and sharing.
 
-1. Fork it
+<a href="https://github.com/veops/cmdb/graphs/contributors">
-2. Create your feature branch (`git checkout -b my-feature`)
+  <img src="https://contrib.rocks/image?repo=veops/cmdb" />
-3. Commit your changes (`git commit -am 'Add some feature'`)
+</a>
-4. Push to the branch (`git push origin my-feature`)
-5. Create new Pull Request
 
----
+## More Open Source
+
+- [OneTerm](https://github.com/veops/oneterm): Provide secure access and control over all infrastructure.
+- [messenger](https://github.com/veops/messenger): A simple and lightweight message sending service.
+- [ACL](https://github.com/veops/acl): A general permission control management system.
+
+## Contact me
+
++ Email: <a href="mailto:bd@veops.cn">bd@veops.cn</a>