convez.ai
MCP ServerDevOps & InfraestruturaAvançado
ouywm

Summerrs Admin

ouywm/summerrs-admin

Admin system completo em Rust com sharding, multi-tenancy e MCP server

Ver no GitHub
BomPluginScore · de 0 a 100

Sistema admin full-stack em Rust com autenticação JWT/RBAC, sharding de banco de dados, multi-tenância, gateway de IA e servidor MCP integrado. Agrupa funcionalidades que normalmente exigem múltiplos serviços em um único binário de alta performance.

Instalação

$npx convez-ai ouywm/summerrs-admin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
11
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
2
Contribuidores
1

Casos de uso

  • Construir backends de alta performance com autenticação e autorização robustas
  • Implementar sistemas multi-tenant com isolamento de dados por sharding
  • Integrar comunicação real-time via Socket.IO e gateway de IA
  • Deployar admin panels escaláveis como binário único

Veredito

Projeto maduro e production-ready que consolida em Rust padrões enterprise (RBAC, sharding, multi-tenancy). Ideal para times que buscam performance e type-safety em backends complexos, mas exige proficiência em Rust e arquitetura distribuída.

README

A tradução para o português deste README ainda está na fila.

Summerrs Admin

中文 | English

Full-stack Rust admin system · Database sharding, multi-tenant isolation, MCP service, declarative macros — all in one binary

License Rust Edition GitHub stars zread

Core Capabilities · Architecture · Project Structure · Frontend & Docs


What It Is

summerrs-admin is a production-grade admin system written entirely in Rust, built on top of the Summer framework (a Spring-style application skeleton for Rust). It bundles capabilities that usually require a whole backend team to assemble — authentication, multi-tenancy, real-time messaging, object storage, declarative auditing — into a single binary via a plugin composition model. Use what you need, ignore what you don't.

It is not a demo, nor a showcase of any single component — it is a complete, self-contained, deployable backend foundation.


How It Differs From Similar Projects

summerrs-admin leverages Rust's zero-cost abstractions, type safety, and compile-time guarantees to integrate capabilities that typically require multiple independent services into a single high-performance binary:

CapabilityTypicalThis Project (Rust Advantages)
Database ShardingBolted on via ShardingSphere / Vitesssummer-sharding rewrites SQL transparently — zero runtime overhead, compile-time type safety
MCP ServiceA standalone MCP server processsummer-mcp introspects business schema directly; AI assistants generate CRUD with type-safe guarantees
Declarative Audit & Rate LimitingMiddleware + handwritten code#[login] #[has_perm] #[rate_limit] — procedural macros expand at compile time, no reflection overhead

Core Rust Advantages:

  • Single Binary Deployment — No JVM/interpreter required, instant startup
  • Memory Safety — Eliminates data races and memory leaks at compile time
  • High Performance — Zero-cost abstractions, performance close to C/C++
  • Type Safety — Catches most errors at compile time, reducing runtime failures

Architecture

The system is built around plugin composition. crates/app/src/main.rs is the assembly point — plugins fed into App::new() in order:

                    HTTP 8080
                       │
                       ▼
        ┌──────────────────────────────────┐
        │  Tower middleware (CORS /        │
        │  compression / panic guard /     │
        │  client IP extraction)           │
        └──────────────┬───────────────────┘
                       │
                       ▼
                  /api/* (JWT)
                  summer-system
                       │
                       ▼
        ┌──────────────────────────────────┐
        │  Declarative macro layer         │
        │  #[login] #[has_perm]            │
        │  #[has_role] #[rate_limit]       │
        │  #[operation_log]                │
        └──────────────┬───────────────────┘
                       │
                       ▼
        ┌──────────────────────────────────┐
        │  Sharding / SQL rewrite layer    │
        │  Tenant context injection        │
        └──────┬─────────────┬─────────────┘
               ▼             ▼
          PostgreSQL 17    Redis 7
          (primary)        (sessions / cache / rate limit)
                                │
                                ▼
                    Socket.IO / background jobs / S3

Core Capabilities

Authentication & Authorization

  • Multi-algorithm JWT — HS256 / RS256 / ES256 / EdDSA, key rotation supported
  • Bitmap RBAC — Permission bitmap compression to reduce transmission size
  • Declarative macros — #[login] #[has_perm("user:create")] #[has_role("admin")] #[public]
  • Session governance — concurrent login limits, per-device caps, token refresh, force logout

Multi-Tenancy & Database

  • Four isolation tiers

    ModeSuited forMechanism
    shared_rowMost SaaSSQL rewrite injects tenant_id filter
    separate_tableMid isolationPhysical sharding (user_001 / user_002)
    separate_schemaStrong isolationPostgreSQL schema-level separation
    separate_databaseFull isolationEach tenant gets its own physical database
  • SQL rewrite engine — tenant context injected transparently, business code untouched

  • CDC pipeline — change data capture across tenants

MCP Server Integration

  • Schema discovery — AI assistants can introspect the database schema
  • Code generation — generate CRUD modules through dialogue
  • Menu / dictionary auto-deploy — prompt-driven persistence
  • Underlying — built on rmcp (the official Rust MCP SDK), supporting both stdio and streamable-http transports

Real-time & Background Processing

  • Socket.IO — bidirectional real-time, session state in Redis (horizontally scalable)
  • Background task queue — typed jobs, 4 workers by default, capacity 4096
  • Batch logging — operation logs flushed asynchronously, off the hot path
  • Cron jobs — driven by tokio-cron-scheduler

Storage & Utilities

  • S3-compatible storage — AWS S3 / MinIO / RustFS, multipart upload up to 5 GB
  • IP geolocation — IP2Region xdb embedded, login logs auto-attributed
  • i18n — compile-time, currently zh / en
  • Rate limiting — 5 algorithms: fixed window, sliding window, token bucket, leaky bucket, Lua script
  • OpenAPI docs — at /docs, with Swagger UI

Project Structure

summerrs-admin/
├── crates/
│   ├── app/                          # binary entry, assembles all plugins
│   ├── summer-admin-macros/          # declarative macros (#[login] / #[has_perm] etc.)
│   ├── summer-auth/                  # JWT auth + path policy
│   ├── summer-common/                # shared types & utilities
│   ├── summer-domain/                # domain models (entities / VOs)
│   ├── summer-sharding/              # sharding / multi-tenancy middleware
│   ├── summer-mcp/                   # MCP server
│   ├── summer-plugins/               # S3 / IP2Region / background jobs etc.
│   └── summer-system/                # system business (RBAC / users / menus / Socket.IO)
│       └── model/
├── config/                           # multi-env configs (dev / prod / test)
├── sql/                              # database source of truth
│   ├── sys/                          # system domain (users / menus / perms / logs)
│   ├── tenant/                       # tenant control plane
│   └── biz/                          # B/C-side business
├── doc/                              # deployment / migration / technical guides
├── docs/                             # research, surveys, reference materials
├── locales/                          # i18n resources
├── build-tools/                      # fmt / clippy / pre-commit scripts
├── docker-compose.yml                # one-shot stack: postgres + redis + rustfs + app
└── Dockerfile                        # multi-stage build

Frontend & Docs

Frontend Project

Frontend implementation based on Ant Design Pro:

Documentation Site

Project documentation and guides: https://ouywm.github.io/summer-admin-site/


If this project helps you, a Star is appreciated.

Report an issue · Start a discussion

Ver o original no GitHub

Bom para

Relacionados