https://github.com/pddzl/td27-admin

基于Goalng、Gin、Casbin & Vue3、TypeScript、Element Plus、Pinia 的前后端分离的动态路由权限管理系统
https://github.com/pddzl/td27-admin

admin casbin element-plus gin-admin go-admin golang jwt rbac typescript vite vue-admin vue3

Last synced: 3 months ago
JSON representation

基于Goalng、Gin、Casbin & Vue3、TypeScript、Element Plus、Pinia 的前后端分离的动态路由权限管理系统

Host: GitHub
URL: https://github.com/pddzl/td27-admin
Owner: pddzl
License: mit
Created: 2023-01-13T02:32:32.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2026-01-10T16:11:18.000Z (3 months ago)
Last Synced: 2026-01-11T03:05:16.455Z (3 months ago)
Topics: admin, casbin, element-plus, gin-admin, go-admin, golang, jwt, rbac, typescript, vite, vue-admin, vue3
Language: Go
Homepage:
Size: 8.98 MB
Stars: 111
Watchers: 3
Forks: 22
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

TD27 Admin

A Golang Rapid Development Framework Based on Gin + Vue3

English | 中文

## Platform Overview

* Frontend tech stack: TypeScript, Vue3, Element-Plus, Vite, Pinia
* Backend tech stack: Golang, Gin, Gorm, MySQL, Redis, Casbin

## Built-in Features

- User Management: Full CRUD and lifecycle management for system accounts, including role binding and status toggling.

- Role Management: Permission entities that map roles to menus and API endpoints.

- Menu Management: Role-based dynamic routing and menu generation.

- API Management: Role-level access control for backend API routes.

- Operation Logs: Records user operations and request traces for auditing.

- Scheduled Tasks: Supports cron-like task configuration via both YAML and UI-driven management.

- File Management: Implements backend file storage with upload, retrieval, and deletion APIs.

- Dictionary Management: Nested dictionary definitions for unified data mapping and frontend rendering.

## Run

Default account / password:

`admin/123456`

Clone the project
`git clone https://github.com/pddzl/td27-admin.git`

### Frontend

```bash
# Requirements
1. Install recommended plugins from the .vscode directory
2. Node version 18+
3. pnpm version 8.x

# Enter project directory
cd web

# Install dependencies
pnpm i

# Start development server
pnpm dev

# Preview staging environment
pnpm preview:stage

# Preview production environment
pnpm preview:prod

# Build staging environment
pnpm build:stage

# Build production environment
pnpm build:prod

# Format code
pnpm lint
```

### Backend

```bash
# Requirements
1. Go >= 1.25

# Enter server directory
cd server

# Use go mod and install dependencies
go generate

# Build
go build -o server cmd/server/main.go

# Run the binary
./server
```

#### Directory Structure
```shell
├── cmd # Main application entry points (one folder per binary)
│ └── server # Main HTTP server entry (main.go)
│
├── configs # Configuration files (YAML/JSON), config templates
│
├── docs # API docs, Swagger files, architecture docs
│
├── internal # Private application code (not for import by other modules)
│ ├── api # Request handlers (Gin handlers / controllers)
│ ├── core # Core startup logic (config load, logger, DB, server setup)
│ ├── global # Global variables (DB, Redis, Config, Logger, etc.)
│ ├── initialize # Init functions (router setup, config init, cron init)
│ ├── middleware # Gin middleware
│ ├── model # Data models: entity, request, response, VO, DTO
│ ├── pkg # Shared utilities (tools, common helpers, not business logic)
│ ├── router # Router groups & route registration
│ └── service # Business logic & database operations (service layer)
│
├── log # Application logs
│
├── resource # Static resources (images, attachments, templates)
│ └── upload # File upload target directory
│
└── scripts # Shell scripts (build, deploy, maintenance)

```

**If you deploy manually, you must create a database `td27` and import the initialization data.
SQL file location: `./docker-compose/mysql/init/init.sql` **

## swagger

```bash
cd server
swag init -g cmd/server/main.go -o docs --parseDependency --parseInternal
```

`Access Swagger UI`

```bash
http://localhost:8888/swagger/index.html
```

## One-Click Installation

Docker Compose version must be V2

```bash
git clone https://github.com/pddzl/td27-admin
cd td27-admin
docker-compose -f docker-compose/docker-compose.yml build
docker-compose -f docker-compose/docker-compose.yml up -d
```

Then open in browser: `http://ip:8500`

## Project Preview