Foundry

基于 Rust、Axum 与 React 构建的高性能、开源多系统后端框架与可视化 Admin 控制台。平台框架与用户业务工程完全解耦。

快速入门架构设计蓝图 GitHub 仓库

⚡ 现代 Rust 后端应用框架 · 完全解耦的子系统架构

bash — foundry CLI v0.1.0

# 1. 从 GitHub 仓库安装 CLI 工具

cargo install --git https://github.com/foundkit/foundry foundry_cli

# 2. 创建全新的独立业务应用工程 (默认 PostgreSQL，可选 --db mysql / mariadb / mongodb)

foundry new my-app

✔创建独立业务应用工程: my-app/

# 3. 进入项目目录并启动服务 (自动执行数据迁移与管理员初始化)

cd my-app && cargo run

✔Foundry 应用成功监听于: http://0.0.0.0:8080

✔REST API 统一接入点: /api/v1

✔可视化 Admin 控制台: /admin

🌟 核心架构支柱

框架与业务完全解耦

Foundry 作为标准 Cargo 依赖提供 (foundry = "0.1")。用户拥有独立 Git 仓库，上游框架升级零合并冲突。

高内聚业务子系统

子系统封装自定义 API 控制器、业务领域服务、DTO 校验与 Admin 扩展页面，结构清晰内聚。

双模存储与多数据库 SPI

因地制宜特化策略：PostgreSQL 与 MongoDB 原生支持极致 Zero-DDL 动态模型与 Auto-CRUD；MySQL 与 MariaDB 采用专题专属物理分表 DDL 与覆盖索引优化，兼顾敏捷迭代与千万级生产吞吐。

自动生成 RESTful CRUD

所有动态模型即刻获得开箱即用的高并发 RESTful CRUD 接口（GET, POST, PUT, DELETE）。

分级权限与专题 RBAC

超级管理员 (super_admin)、普通管理员 (admin) 与专属专题管理员 (topic_admin)，支持细粒度权限控制与 SMTP 邮箱双因素验证。

全链路可观测性与审计

开箱即用 tracing 结构化日志、HTTP TraceLayer 链路耗时追踪与敏感参数脱敏的异步操作审计系统。

环境与动态双模配置

强类型静态环境配置与管理后台可视化的动态专题配置中心无缝结合，业务参数实时热更新免重启。

统一交付与打包流水线

自动化构建脚本 (build-release.sh) 一键将服务二进制、Admin 前端与扩展页面打包为单一部署制品。

🏗️ 架构流转流水线

🌐

客户端请求

Admin 控制台 / 移动端 / HTTP 客户端

⚡

Axum 路由引擎

上下文解析、鉴权与专题 RBAC 校验

⚙️

子系统运行时

Auto-CRUD + Rust 原生业务 + Admin 扩展页面

💾

双模存储引擎

Multi-DB SPI: 0-DDL (PG/Mongo) + 专属分表 DDL (MySQL/MariaDB) + Redis

💾 数据库策略与选型矩阵

Foundry 秉承因地制宜特化策略（Database-Native Strategy），拒绝抹杀各数据库物理特性的“最低公倍数 SQL”，在上层纯方法调用的统一门面下，提供差异化的底层落地模式：

数据库引擎	架构模式	物理实现方式	专题与模型变更机制	最佳适用场景
PostgreSQL `14+`	原生 Zero-DDL	`JSONB` 格式 + `USING GIN(data)` 倒排索引 + 部分索引	真正的 0-DDL Admin 后台秒级增改模型，单表支撑多专题	敏捷业务中台、运营动态表单、中高并发动态实体
MongoDB `6.0+`	原生 0-DDL	原生 BSON 文档 + Wildcard (`$**`) 索引 + 原子自增序列	纯粹 Schemaless 无需表模式维护，集合首次写入自愈生成	海量动态数据、天然文档结构、高吞吐内容存储
MySQL `8.0+ / 8.4+`	专属分表 DDL	专题独立物理单表 + 紧凑覆盖索引 + 延迟关联分页	专题 DDL 迁移脚手架一键生成方言 DDL，开发自动同步/生产 DBA 离线审计	千万级核心结算、强一致关系交易、企业级规范交付
MariaDB `10.5+`	专属分表 DDL	独立 `MariaDbProvider` + 专属方言脚本 + InnoDB 紧凑索引	专题 DDL 迁移原生兼容 MariaDB 连接与系统变量，专属分表 DDL	开源自建集群、高并发并发交易、分表业务落地

[!NOTE] 全引擎通用安全底座：

驱动零泄露：业务层与 Auto-CRUD 统一调用标准纯方法 (state.db.records(), state.db.systems())，无底层连接池对象泄露。

零物理 DELETE 权限运行：全系统所有模块均严格执行软删除（deleted_at 标记更新），即使生产环境 DBA 回收了物理 DELETE 权限，系统依然 100% 顺畅运行。