diff --git a/README.md b/README.md index dab4336..e79fcca 100644 --- a/README.md +++ b/README.md @@ -1,47 +1,55 @@ -[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) +[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) ![Tests](https://github.com/linktimecloud/kdp-catalog-manager/actions/workflows/unit-test.yml/badge.svg) -![Build](https://github.com/linktimecloud/kdp-catalog-manager/actions/workflows/ci-build.yml/badge.svg) +![Build](https://github.com/linktimecloud/kdp-catalog-manager/actions/workflows/ci-build.yml/badge.svg) ![](https://img.shields.io/badge/python-3.10.13-green) -![](https://img.shields.io/badge/fastapi-0.110.0-green) +![](https://img.shields.io/badge/fastapi-0.110.0-green) ![image version](https://img.shields.io/docker/v/linktimecloud/kdp-catalog-manager) ![image size](https://img.shields.io/docker/image-size/linktimecloud/kdp-catalog-manager) # KDP Catalog Manager -## 项目描述 +English | [简体中文](./README_zh.md) +
-### 项目概述 -KDP Catalog Manager是一套大数据应用管理平台。基于应用功能进行分类查看、管理,降低应用管理的复杂度,从而使大数据管理人员更专注于数据的处理 +## Project Description -### 核心技术架构 +### Project Overview +KDP Catalog Manager is a big data application management platform. It categorizes and manages applications based on their functionalities, reducing the complexity of application management and allowing big data administrators to focus more on data processing. + +### Core Technical Architecture ![kdp-catalog-manager](kdp-catalog-manager.png) -### 功能模块描述 +### Functional Module Description #### api * view -定义 Restful API 并对用户输入参数执行基本验证及结果输出 +Defines Restful APIs and performs basic validation on user input parameters and output results. #### Domain + * service -业务逻辑 +Business logic. + * format -数据转换层,用于缓存数据与业务数据转换 +Data conversion layer, used for transforming data between cached data and business data. + * model -数据模型实体 +Data model entities. + ##### Modules * cache -数据存储层,静态数据存储于缓存中 +Data storage layer, where static data is stored in the cache. + * requests -外部数据调用,调用外部服务获取数据 +External data invocation, used to call external services to retrieve data. -## 目录结构 +## Directory Structure ```shell ├── CODEOWNERS ├── README.md @@ -57,33 +65,36 @@ KDP Catalog Manager是一套大数据应用管理平台。基于应用功能进    └── utils ``` -## 启动方式 -### 开发环境搭建 -* 使用python3.10+ +## Startup Procedure + +### Development Environment Setup + +* Requires Python3.10+ + -1. 克隆代码至本地 +1. Clone the code to your local machine. ```shell git clone xxx && cd kdp-catalog-manager ``` -2. 使用虚拟环境 +2. Set up a virtual environment: ```shell -#安装virtualenv +#Install virtualenv pip install virtualenv virtualenv -p /usr/local/bin/python3 venv -# 激活虚拟环境 +# Activate the virtual environment: source ./venv/bin/activate -# 关闭虚拟环境 +# Deactivate the virtual environment: deactivate ``` -3. 安装依赖 +3. Install dependencies: ```shell pip install -r docker/python/requirements.txt ``` -4. 服务启动 +4. Start the service: ```shell cd ~/kdp-catalog-manager \ && export PYTHONPATH=$PYTHONPATH:$(pwd) @@ -91,5 +102,5 @@ python kdp_catalog_manager/main.py ``` -### API 手册 -* 启动服务后通过 http://127.0.0.1:8000/docs 查看提供的接口列表 \ No newline at end of file +### API Manual +* After starting the service, you can view the list of available endpoints by accessing http://127.0.0.1:8000/docs. \ No newline at end of file diff --git a/README_zh.md b/README_zh.md new file mode 100644 index 0000000..25da870 --- /dev/null +++ b/README_zh.md @@ -0,0 +1,96 @@ +[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) +![Tests](https://github.com/linktimecloud/kdp-catalog-manager/actions/workflows/unit-test.yml/badge.svg) +![Build](https://github.com/linktimecloud/kdp-catalog-manager/actions/workflows/ci-build.yml/badge.svg) +![](https://img.shields.io/badge/python-3.10.13-green) +![](https://img.shields.io/badge/fastapi-0.110.0-green) +![image version](https://img.shields.io/docker/v/linktimecloud/kdp-catalog-manager) +![image size](https://img.shields.io/docker/image-size/linktimecloud/kdp-catalog-manager) + + +# KDP Catalog Manager + +## 项目描述 + +### 项目概述 +KDP Catalog Manager是一套大数据应用管理平台。基于应用功能进行分类查看、管理,降低应用管理的复杂度,从而使大数据管理人员更专注于数据的处理 + +### 核心技术架构 +![kdp-catalog-manager](kdp-catalog-manager.png) + + + +### 功能模块描述 + +#### api +* view +定义 Restful API 并对用户输入参数执行基本验证及结果输出 + +#### Domain +* service +业务逻辑 +* format +数据转换层,用于缓存数据与业务数据转换 +* model +数据模型实体 + + +##### Modules +* cache +数据存储层,静态数据存储于缓存中 +* requests +外部数据调用,调用外部服务获取数据 + + +## 目录结构 +```shell +├── CODEOWNERS +├── README.md +└── kdp_catalog_manager +   ├── api +   ├── common +   ├── config +   ├── main.py # 服务启动程序 +   ├── requirements.txt +   ├── test_main.py +   ├── domain +   ├── modules +   └── utils +``` + +## 启动方式 + +### 开发环境搭建 +* 使用python3.10+ + +1. 克隆代码至本地 +```shell +git clone xxx && cd kdp-catalog-manager +``` + +2. 使用虚拟环境 +```shell +#安装virtualenv +pip install virtualenv +virtualenv -p /usr/local/bin/python3 venv +# 激活虚拟环境 +source ./venv/bin/activate + +# 关闭虚拟环境 +deactivate +``` + +3. 安装依赖 +```shell +pip install -r docker/python/requirements.txt +``` + +4. 服务启动 +```shell +cd ~/kdp-catalog-manager \ +&& export PYTHONPATH=$PYTHONPATH:$(pwd) +python kdp_catalog_manager/main.py + +``` + +### API 手册 +* 启动服务后通过 http://127.0.0.1:8000/docs 查看提供的接口列表 \ No newline at end of file diff --git a/kdp-catalog-manager.png b/kdp-catalog-manager.png index 17b4874..32b1f3c 100644 Binary files a/kdp-catalog-manager.png and b/kdp-catalog-manager.png differ