gem-hunter

An Enterprise-Grade Full-Stack RBAC Permission Management System Built with Go + React

简体中文 · English

Gin · Ent ORM · Casbin · Shadcn UI · TanStack Router · Tailwind CSS

✨ Features

🚀 Get Running

Prerequisites

Run

# Clone the repository
git clone https://github.com/ahaodev/shadmin.git
cd shadmin

go install github.com/swaggo/swag/cmd/swag@latest
go install entgo.io/ent/cmd/ent@latest

# Install & build frontend
cd frontend && pnpm install && pnpm build

# Start backend (from project root)
# Generates Ent code, embeds frontend/dist/, listens on :55667
# .env auto‑generated on first run
cd ..
swag init
go run -mod=mod entgo.io/ent/cmd/ent generate ./ent/schema
go run .

🔐 Auth & Permissions

shadmin/
├── api/            # Controllers & routes (Gin)
├── bootstrap/      # App bootstrap, DB, Casbin, seed
├── domain/         # Entities, DTOs, interfaces
├── ent/schema/     # Ent ORM schemas
├── repository/     # Data access layer
├── usecase/        # Business logic
├── internal/       # Internal utilities
├── pkg/            # Shared packages
├── frontend/            # React frontend (Vite + shadcn/ui)
│   └── src/
│       ├── routes/       # TanStack file‑based routing
│       ├── features/     # Feature modules
│       ├── services/     # API wrappers (Axios)
│       └── stores/       # Zustand state management
├── docs/           # Documentation & images
└── main.go         # Entry point

📚 Documentation

📄 License