gin-vue-admin

gin-vue-admin은 Vue3와 Gin 기반의 풀스택 프론트엔드·백엔드 분리 개발 플랫폼으로, JWT 인증, Casbin 권한, 동적 라우팅, 코드 생성기, 폼 생성기 및 AI 보조 기능을 통합하여 기업급 비즈니스 시스템을 빠르게 구축할 수 있습니다. ## 핵심 기능 - **권한 관리**: JWT와 Casbin 기반으로 세밀한 API 및 메뉴 권한 제어를 구현합니다. - **동적 라우팅과 메뉴**: 사용자 역할에 따라 라우팅과 메뉴를 동적으로 생성합니다. - **코드 생성기**: 프론트엔드·백엔드 기본 CRUD 코드를 원클릭으로 생성하며, 폼 생성기를 지원합니다. - **AI 보조 개발**: 내장 MCP 보조 서비스를 제공하고 AI 편집기 통합을 지원하여 비즈니스 코드를 빠르게 생성할 수 있습니다. - **파일 업로드·다운로드**: Qiniu Cloud, Alibaba Cloud, Tencent Cloud 등 클라우드 스토리지를 지원하며, 분할 업로드 기능을 제공합니다. - **다중 로그인 제한**: Redis 기반으로 다중 단말 로그인 상태를 제어합니다. - **페이지네이션 캡슐화**: 프론트엔드에서 mixins로 페이지네이션 로직을 캡슐화하여 개발을 단순화합니다. - **설정 관리**: 온라인으로 설정 파일을 수정할 수 있습니다(데모 사이트 제외). - **Swagger 문서**: API 문서를 자동 생성합니다. ## 기술 스택 - **프론트엔드**: Vue 3, Element Plus, Vite - **백엔드**: Go, Gin, GORM - **데이터베이스**: MySQL / MariaDB(5.7+) - **캐시**: Redis - **로그**: Zap - **설정**: Viper + fsnotify ## 빠른 시작 ### 환경 요구 사항 - Node.js >= 18.16.0 - Go >= 1.22 ### 백엔드 시작 ```bash git clone https://github.com/flipped-aurora/gin-vue-admin.git cd server go generate go run . ``` ### 프론트엔드 시작 ```bash cd web npm install npm run serve ``` ### Swagger 문서 ```bash cd server swag init ``` 시작 후 `http://localhost:8888/swagger/index.html`에 접속하여 API 문서를 확인할 수 있습니다. ## 프로젝트 문서 - 온라인 문서: https://www.gin-vue-admin.com - 초기화 가이드: https://www.gin-vue-admin.com/guide/start-quickly/initialization.html - 교육 영상: Bilibili에서 gin-vue-admin 검색 - 플러그인 마켓: https://plugin.gin-vue-admin.com/ ## 온라인 데모 - 데모 사이트: http://demo.gin-vue-admin.com (계정 admin / 123456) - 라이선스 버전 데모: https://vip.gin-vue-admin.com ## 오픈 소스 라이선스 이 프로젝트는 Apache License 2.0 오픈 소스 라이선스를 채택합니다. 사용, 수정 및 배포 시 저장소의 LICENSE 파일을 준수하고 라이선스가 요구하는 적용 가능한 고지를 유지하십시오. 라이선스 버전 기능이나 공식 상업 지원이 필요하면 상업 라이선스를 구매하십시오.