# kot-cloud

**Repository Path**: arrocean/kot-cloud

## Basic Information

- **Project Name**: kot-cloud
- **Description**: 该项目旨在构建一个基于 Kotlin 的企业级微服务脚手架，目标是在功能上对标 SpringCloudAlibaba + SpringBoot + Maven + MybatisPlus + JVM 生态，同时利用 Kotlin 与 GraalVM 的特性，尽可能提升 CPU 效率并优化内存占用。 项目定位为企业级模板与参考实现，包含常用的模块划分（公共工具、数据库、Web 层、管理端服务、可选网关），便于在生产级项目中直接复用或作为二次开发基础。
- **Primary Language**: Kotlin
- **License**: MIT-0
- **Default Branch**: JDBC
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Kotlin, micronaut, Postgresql

## README

# kot-cloud

#### 介绍

该项目旨在尝试构建一个以Kotlin为基本语言的企业级项目后端脚手架。在构建过程中也是本人学习Kotlin的一个过程

#### 说明

该项目旨在构建一个基于 Kotlin 的企业级微服务脚手架，目标是在功能上对标 SpringCloudAlibaba + SpringBoot + Maven +
MybatisPlus + JVM 生态，同时利用 Kotlin 与 GraalVM 的特性，尽可能提升 CPU 效率并优化内存占用。

项目定位为企业级模板与参考实现，包含常用的模块划分（公共工具、数据库、Web 层、管理端服务、可选网关），便于在生产级项目中直接复用或作为二次开发基础。

由于该项目目前长期处在本人的学习项目中，因此在功能上，该项目会尝试较为激进的技术选型方案，可能会在后续的开发过程中进行调整和优化，以确保最终产出的脚手架能够满足企业级项目的需求，同时也能充分利用
Kotlin 和 GraalVM 的优势。

#### 软件架构

软件架构说明

本项目致力于构建一个现代化、高性能的微服务架构体系，技术选型如下：

**核心语言**:

- [Kotlin](https://kotlinlang.org/) 2.3.20 - 作为主要开发语言，充分利用其空安全、扩展函数、协程等特性提高开发效率和代码质量

**核心框架**:

- [Micronaut](https://micronaut.io/) - 选择此框架是因为它具有快速启动、低内存占用的特点，特别适合微服务和云原生应用，与Spring
  Boot相比在性能上有显著优势

**构建工具**:

- [Gradle](https://gradle.org/) - 使用Kotlin DSL作为构建脚本语言，提供更好的IDE支持和类型安全性

**编译优化**:

- [GraalVM](https://www.graalvm.org/) - 用于将应用编译为原生镜像，极大减少启动时间和内存消耗，充分发挥Kotlin的优势

**ORM**: 混合使用

- [Micronaut Data](https://micronaut-projects.github.io/micronaut-data/latest/guide/) -
  用于数据访问层，提供类型安全的ORM能力  
  ~~- [Exposed](https://github.com/JetBrains/Exposed) - 用于关系型数据库访问，提供类型安全的 SQL 构建器~~
- [Micronaut Data R2DBC](https://micronaut-projects.github.io/micronaut-r2dbc/1.0.x/guide/) - 用于关系型数据库访问，提供异步访问能力

**数据库**:

- [PostgreSQL](https://www.postgresql.org/) - 用于关系型数据库
- [MariaDB](https://mariadb.org/) - 用于关系型数据库(后续支持)

**插件**:

- [KSP](https://github.com/google/ksp) 2.3.6 - 用于代码生成，提供更快的编译速度和更好的Kotlin支持
- [Micronaut Application](https://micronaut-projects.github.io/micronaut-gradle-plugin/latest/) 4.6.2 -
  用于创建和管理Micronaut应用

#### 临时注意事项

如果你需要使用本地配置文件(application.properties)进行开发，请确保在运行环境中添加环境变量 `MICRONAUT_ENVIRONMENTS=local`
，以便正确加载本地配置文件。

#### 安装教程

1. 暂无，等待后续完善项目后进行文档完善

#### 使用说明

1. 暂无，等待后续完善项目后进行文档完善

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request