Fusion Framework

模块

Crate	说明
fusion-common	基础工具：错误处理、时间、序列化、上下文等
fusion-core	核心框架：Application、Component、Plugin 生命周期管理
fusion-core-macros	过程宏：Builder 派生等编译时增强
fusion-security	安全模块：JWT、密码哈希、OAuth2
fusion-sql-core	SQL 核心：Id 等基础类型
fusion-sql	SQL 层：ModelManager<C>、DbxPostgres、手写 sqlx
fusion-db	数据库：连接池、事务管理、TypedDbPlugin
fusion-web	Web 服务：Axum 封装、中间件、路由
fusion-rpc	ConnectRPC 服务与客户端 transport
fusion-ai	AI 集成：LLM、向量数据库、STT
fusion-mq	消息队列：Postgres 事件队列 producer/consumer
fusion-storage	对象存储：opendal Operator 工厂（feature 透传）+ 预签名 URL（native presign / fs HMAC 兜底）
hetuflow	工作流框架：durable workflow（聚合包，feature-gated）
fusions	聚合包：一键引入全部功能

特性

• Plugin 架构 — 依赖注入、按序加载、循环检测
• Component 系统 — 类型安全的服务注册与获取
• 配置中心 — 多源合并、环境变量、热加载
• 优雅关闭 — Shutdown Hook、信号处理
• 零成本抽象 — 编译时宏、泛型优化

快速开始

use fusions::core::Application;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let app = Application::builder()
        .run()
        .await?;

    println!("{} started at {}", app, app.start_time());

    Application::await_shutdown().await;
    Ok(())
}

开发

# 本仓 workspace 内开发
cargo check --workspace
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace --all-targets --all-features

接入

消费方可通过 path 依赖或 git 依赖接入（本仓 publish = false，不上 crates.io）：

# path 依赖（适合本地 / submodule 接入）
fusions = { version = "0.3.0", path = "path/to/fusions/crates/fusions" }

# git 依赖
fusions = { git = "https://github.com/fusion-data/fusions.git" }

技术栈

• Runtime: Tokio 1.x
• Web: Axum 0.8 + Tower
• Database: SQLx + PostgreSQL（v0.3 删除了 sea-query / BMC ORM 层，SQL 一律手写 sqlx）
• Serialization: serde + sonic-rs
• Observability: tracing + tracing-subscriber + init-tracing-opentelemetry + metrics
• AI: rig + rmcp

---

Fusion 之意，框架之本，服务之基。