[Task][OSPP] HertzBeat Official Template Marketplace

templatehub/README-EN.md

@@ -0,0 +1,37 @@
+# Plan
+## Completed
+### Backend
+- Modify the persistence framework to JPA`
+- Replace the utility class with the community utility class: Replace the 'Message' return class and modify the backend request return format
+- Template upload interface: Upload the first version of a template series
+- Version upload interface: Upload subsequent versions of a template series
+- Template search interface: Based on user query templates and querying all templates
+- Abstract file upload interface: complete the implementation class adaptation of MinIO, configurable storage system
+- Template download interface: provides a permanent download address, maps the address, and hides the MinIO address from the user
+- Sharing interface: Generate a download URL for a certain version for sharing based on Base62 encoding`
+- Sharing and downloading interface: Download files by accessing the sharing link in the browser
+### Front end
+- All template query function
+- Template upload function
+- Download function for a certain template and version file
+
+
+## Todo
+- Organize the design framework
+### Backend
+- Like or favorite statistics function:
+- Add likes or favorites statistics in the 'template' and 'version' tables
+- Users can like and bookmark after logging in
+- Template image function: The system automatically assigns images based on categories or generates random images similar to 'GitHub'
+- Category and tag management function
+- Template deletion and removal function
+- Backend management function
+- Login and registration function
+### Front end
+- Template information display
+- Implementation of version query function
+- Sharing Function Implementation
+- Implementation of version upload function
+
+## 🛡️ License
+[`Apache License, Version 2.0`](https://www.apache.org/licenses/LICENSE-2.0.html)

templatehub/README.md

@@ -0,0 +1,37 @@
+# 计划
+## 已完成
+### 后端
+- 修改持久化框架为`JPA`
+- 工具类替换为社区工具类：替换`Message`返回类，修改后端请求返回格式
+- 模版上传接口：上传一个模版系列的第一个版本
+- 版本上传接口：上传某个模版系列的后续版本
+- 模版搜索接口：根据用户查询模版及查询所有模版
+- 抽象文件上传接口：完成适配`MinIO`的实现类，可配置存储系统
+- 模版下载接口：提供永久下载地址，对地址进行映射，对用户隐藏地MinIO地址
+- 分享接口：根据`Base62`编码生成用于分享的某版本下载`URL`
+- 分享下载接口：通过在浏览器中访问分享链接下载文件
+### 前端
+- 全部模版查询功能
+- 模版上传功能
+- 某模版某版本文件下载功能
+
+
+## 待完成
+- 整理设计框架
+### 后端
+- 点赞量或收藏量统计功能：
+    - 在`template`及`version`表中添加点赞量或者收藏量统计
+    - 用户登录后可进行点赞收藏
+- 模版图片功能：系统根据类别自动指定图片或类似`github`生成随机图片
+- 类别、`tag`管理功能
+- 模版删除、下架功能
+- 后台管理功能
+- 登录注册功能
+### 前端
+- 模版信息展示
+- 版本查询功能实装
+- 分享功能实装
+- 版本上传功能实装
+
+## 🛡️ License
+[`Apache License, Version 2.0`](https://www.apache.org/licenses/LICENSE-2.0.html)

templatehub/pom.xml

@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to You under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~     http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>org.springframework.boot</groupId>
+		<artifactId>spring-boot-starter-parent</artifactId>
+		<version>3.3.2</version>
+		<relativePath/> <!-- lookup parent from repository -->
+	</parent>
+	<groupId>org.apache.hertzbeat.templatehub</groupId>
+	<artifactId>hertzbeat-template-hub</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+	<name>hertzbeat-template-hub</name>
+	<description>hertzbeat-template-hub</description>
+	<url/>
+	<licenses>
+		<license/>
+	</licenses>
+	<developers>
+		<developer/>
+	</developers>
+	<scm>
+		<connection/>
+		<developerConnection/>
+		<tag/>
+		<url/>
+	</scm>
+	<properties>
+		<java.version>17</java.version>
+		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+		<spring-boot.version>3.3.2</spring-boot.version>
+		<druid-spring-boot-starter.version>1.2.23</druid-spring-boot-starter.version>
+		<mysql-connector-j.version>8.3.0</mysql-connector-j.version>
+		<mybatis-plus.version>3.5.7</mybatis-plus.version>
+		<mybatis-plus-boot-starter.version>3.5.7</mybatis-plus-boot-starter.version>
+		<minio.version>8.4.3</minio.version>
+		<commons-lang3.version>3.14.0</commons-lang3.version>
+	</properties>
+	<dependencies>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-web</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>com.mysql</groupId>
+			<artifactId>mysql-connector-j</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>com.alibaba</groupId>
+			<artifactId>druid-spring-boot-starter</artifactId>
+			<version>1.2.23</version>
+			<exclusions>
+				<exclusion>
+					<groupId>org.slf4j</groupId>
+					<artifactId>slf4j-api</artifactId>
+				</exclusion>
+			</exclusions>
+		</dependency>
+
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-jpa</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>io.swagger.core.v3</groupId>
+			<artifactId>swagger-annotations</artifactId>
+			<version>2.2.22</version>
+		</dependency>
+
+		<dependency>
+			<groupId>org.apache.commons</groupId>
+			<artifactId>commons-lang3</artifactId>
+		</dependency>
+
+		<!--Spring boot单元测试-->
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-test</artifactId>
+			<version>${spring-boot.version}</version>
+			<scope>test</scope>
+			<exclusions>
+				<exclusion>
+					<groupId>org.junit.vintage</groupId>
+					<artifactId>junit-vintage-engine</artifactId>
+				</exclusion>
+			</exclusions>
+		</dependency>
+
+		<!-- lombok -->
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+		</dependency>
+
+		<dependency>
+			<groupId>io.minio</groupId>
+			<artifactId>minio</artifactId>
+			<version>8.5.11</version>
+		</dependency>
+
+		<!-- okHttp -->
+		<dependency>
+			<groupId>com.squareup.okhttp3</groupId>
+			<artifactId>okhttp</artifactId>
+			<version>4.12.0</version>
+		</dependency>
+
+
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.springframework.boot</groupId>
+				<artifactId>spring-boot-maven-plugin</artifactId>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

templatehub/src/main/java/org/apache/hertzbeat/templatehub/HertzbeatTemplateHubApplication.java

@@ -0,0 +1,32 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.hertzbeat.templatehub;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.transaction.annotation.EnableTransactionManagement;
+
+@SpringBootApplication
+@EnableTransactionManagement
+public class HertzbeatTemplateHubApplication {
+
+	public static void main(String[] args) {
+		SpringApplication.run(HertzbeatTemplateHubApplication.class, args);
+	}
+
+}

templatehub/src/main/java/org/apache/hertzbeat/templatehub/config/FileStorageConfig.java

@@ -0,0 +1,56 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.hertzbeat.templatehub.config;
+
+import org.apache.hertzbeat.templatehub.service.FileStorageService;
+import org.apache.hertzbeat.templatehub.service.impl.LocalFileStorageServiceImpl;
+import org.apache.hertzbeat.templatehub.service.impl.MinIOFileStorageServiceImpl;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class FileStorageConfig {
+
+    @Value("${file.storage.type}")
+    private String storageType;
+
+    @Value("${minio.endpoint}")
+    private String minioEndpoint;
+
+    @Value("${minio.accessKey}")
+    private String accessKey;
+
+    @Value("${minio.secretKey}")
+    private String secretKey;
+
+    @Bean
+    public FileStorageService fileStorageService() {
+        if ("minio".equalsIgnoreCase(storageType)) {
+            return new MinIOFileStorageServiceImpl(
+                    minioEndpoint,
+                    accessKey,
+                    secretKey
+            );
+        } else if ("local".equalsIgnoreCase(storageType)) {
+            return new LocalFileStorageServiceImpl();
+        } else {
+            throw new IllegalArgumentException("Invalid file storage type: " + storageType);
+        }
+    }
+}