欢迎加入我们～
Koi 是一个致力于打造企业级快速研发框架的开源技术组织。
以「锦鲤」为吉祥物，寓意"敏捷、吉祥、高效"——让企业开发如鱼得水。
Koi 是一个面向企业级应用开发的全栈技术框架组织，核心理念是：
「统一技术底座，加速企业研发」
我们提供从后端基础设施、服务端引擎到前端桌面端/移动端的一站式技术解决方案，帮助企业和开发团队摆脱重复造轮子的困境，聚焦业务创新。
Koi 组织下目前包含 3 个核心仓库，它们协同构成完整的研发框架体系：
koi-site
├── 🏗️ koi-carrier Java 企业级研发支撑框架（核心底座）
├── 🚀 koi-fast Python AI 智能管理后端（快速业务场景）
└── 🖥️ koi-platform 全栈企业应用开发平台（桌面 + 移动 + 后端）
基于 Java 21 + Spring Boot 4.0.3 + Spring Cloud 2025 + Spring AI 2.0 构建的企业级研发支撑框架，是整个 Koi 体系的 Java 技术底座。
| 能力 | 说明 |
|---|---|
| 🚀 统一启动入口 | 单体（@KoiBootApplication）/ 微服务（@KoiCloudApplication）双模式一键启动 |
| 📦 统一依赖管理 | 多 BOM 分层体系，版本一致，升级零改动 |
| 🌐 统一 Web 响应 |
R<T> 标准化响应 + 全局异常处理 |
| 🔐 统一安全认证 | Spring Security 7 + JWT + 可插拔 Token Granter |
| 🗄️ 统一数据访问 | MyBatis-Plus + 动态数据源 + 多租户 + 数据权限 |
| ⚡ 统一缓存 | Redis + ProtoStuff 序列化 + 分布式锁 + 限流 |
| ☁️ 统一对象存储 | OssTemplate 门面，支持 RustFS / MinIO 等多后端切换 |
| 🤖 统一 AI 入口 | KoiAiTemplate 门面，多 AI 提供商灵活切换 |
| 📖 统一接口文档 | Knife4j OpenAPI3 自动生成 |
koi-carrier
├── koi-bom/ 物料清单层（统一版本管理）
├── koi-base/ 基础层（核心常量与工具，零业务依赖）
├── koi-engine/ 引擎层（技术组件中台，业务无关）
└── koi-struct/ 结构层（业务实体定义）
严格分层：
struct → engine → base → (bom)，禁止反向依赖。
基于 FastAPI + SQLAlchemy (Async) + Redis + MinIO 构建的企业信息智能化管理系统后端，主打多租户 SaaS 与 AI 智能助手支撑。
| 能力 | 说明 |
|---|---|
| 🏢 多租户隔离 | 基于 TENANT_ID 的数据级隔离，天然支持 SaaS |
| 🔐 双 Token 认证 | JWT Access Token + Refresh Token + Redis Session 管理 |
| 🛡️ RBAC 权限体系 | 功能权限 + 五种数据权限级别（本人/部门/部门及下级/全部/自定义） |
| 🇨🇳 国密加密 | 密码采用 SM3 加盐哈希存储 |
| 🤖 AI 助手集成 | 内置 AI 聊天助手界面 |
| ☁️ 对象存储 | MinIO 集成，预签名 URL 安全访问 |
| ⚡ 异步高性能 | 全程 async/await 异步处理 |
项目代号 TeamWork，是一套覆盖桌面端 + 移动端 + 后端的全栈企业应用开发平台。
| 端 | 技术选型 |
|---|---|
| 🖥️ 桌面端 | Tauri v2（Rust）+ Vue 3.5 + Element Plus + Vxe-Table |
| 📱 移动端 | uni-app-x（跨 8 平台：Android / iOS / Web / 微信小程序等） |
| 🗄️ 后端 | Spring Boot 4.0.3 + MyBatis-Plus + Redis + AI |
| 类别 | Java 体系（koi-carrier / koi-platform） | Python 体系（koi-fast） |
|---|---|---|
| 语言 | Java 21 | Python 3.12+ |
| Web 框架 | Spring Boot 4.0.3 / Spring Cloud 2025 | FastAPI 0.139+ |
| ORM | MyBatis-Plus 3.5.16 | SQLAlchemy 2.0+ (Async) |
| 数据库 | MySQL 8.0+ | MySQL 8.0+ |
| 缓存 | Redis + ProtoStuff | Redis 8.0+ |
| 对象存储 | RustFS / MinIO / AWS S3 | MinIO |
| 安全 | Spring Security 7 + JWT | JWT (HS256) + SM3 国密 |
| AI 集成 | Spring AI 2.0（多提供商） | 原生 AI 接口 |
| 桌面端 | Tauri v2 + Vue 3.5 | — |
| 移动端 | uni-app-x（多平台小程序） | — |
| 构建工具 | Maven 3.9+ | UV |
Koi 的核心理念是统一——通过统一的启动入口、统一的响应结构、统一的安全模型、统一的数据访问、统一的缓存策略，让业务开发团队只需关心"做什么"而非"怎么做"。
koi-engine-boot + koi-platform 桌面端，快速交付koi-engine-cloud 微服务模式，无痛升级虽然 koi-carrier（Java）和 koi-fast（Python）技术栈不同，但在架构设计上追求理念一致：
| 设计维度 | koi-carrier（Java） | koi-fast（Python） |
|---|---|---|
| 统一响应 | R<T> |
R 响应模型 |
| 认证模型 | JWT + Token Granter | JWT + Redis Session |
| 数据权限 |
@DataScope 注解 |
data_scope_filter |
| 对象存储 | OssTemplate 门面 | MinIO Client 封装 |
koi-cloud）Koi 是一个开放的技术组织，欢迎所有对企业级快速研发感兴趣的同学加入！
git checkout -b feature/your-feature
各仓库均包含详细的文档与开发规范，请参阅各仓库的
docs/目录。
| 仓库 | 许可 |
|---|---|
| koi-carrier | Apache License 2.0 |
| koi-fast | Apache License 2.0 |
| koi-platform | MIT License |
Koi — 让企业开发如鱼得水
Built with ❤️ by Elcker
