Go-admin

Go-Admin — это система управления правами доступа, основанная на Gin + Vue + Element UI OR Arco Design OR Ant Design. Система имеет разделение между фронтендом и бэкендом. Её легко настроить: нужно только изменить файл конфигурации и базу данных.

Система поддерживает несколько команд для упрощения работы с базой данных и запуска API-сервисов.

Онлайн-документация: https://www.go-admin.pro
Фронтенд-проект: https://github.com/go-admin-team/go-admin-ui
Видеоуроки: https://space.bilibili.com/565616721/channel/detail?cid=125737

Онлайн-демонстрация

Демонстрация с использованием Element UI vue: https://vue2.go-admin.dev/#/login

⚠️⚠️⚠️ Имя пользователя / пароль: admin / 123456

Демоверсия Arco Design vue3: https://vue3.go-admin.dev/#/login

⚠️⚠️⚠️ Имя пользователя / пароль: admin / 123456

Антд демо: https://antd.go-admin.pro/

⚠️⚠️⚠️ Имя пользователя / пароль: admin / 123456

Особенности

Следование стандартам RESTful API.
Использование GIN WEB API в качестве основы, предоставляющей множество функций промежуточного программного обеспечения (аутентификация пользователей, междоменное взаимодействие, журналы доступа, отслеживание ID и т. д.).
Модель управления доступом на основе RBAC с Casbin.
Аутентификация JWT.
Поддержка Swagger на основе swaggo.
База данных на основе GORM, поддерживающая различные типы баз данных.
Простая модель сопоставления конфигурационных файлов для быстрого получения желаемой конфигурации.
Инструменты генерации кода.
Инструменты построения форм.
Многокомандный режим.
Поддержка мультиарендности.
TODO: модульное тестирование.

Встроенные функции

Мультиарендность: система по умолчанию поддерживает мультиарендность, разделяя её по библиотекам, где каждая библиотека представляет собой отдельную аренду.
Управление пользователями: пользователи являются операторами системы, и эта функция в основном предназначена для настройки пользователей системы.
Управление отделами: настройка организационной структуры компании, отделов и групп, а также представление древовидной структуры данных для управления разрешениями.
Управление должностями: настройка должностей пользователей в системе.
Управление меню: настройка меню системы, разрешений операций, разрешений кнопок и разрешений интерфейсов.
Управление ролями: распределение ролей меню в соответствии с организационной структурой для определения диапазона разрешений данных.
Управление словарями: управление некоторыми часто используемыми данными в системе.
Управление параметрами: управление динамическими параметрами конфигурации системы.
Управление журналами операций: ведение журнала обычных операций системы и запросов; ведение журнала аномальных событий системы.
Управление журналом входа: ведение журнала входа в систему, включая аномальные события входа.
Управление документацией API: автоматическое создание соответствующей документации API на основе бизнес-кода.
Генерация кода: создание соответствующего бизнес-кода на основе структуры таблицы данных, полностью визуализированного процесса, позволяющего реализовать основные бизнес-процессы без написания кода.
Построение форм: пользовательские стили страниц, перетаскивание и перетаскивание для реализации макета страницы.
Мониторинг сервисов: просмотр основной информации о сервере.
Управление контентом: демонстрационная функция, включающая управление категориями и контентом. Рекомендуется использовать в качестве введения.
Планирование задач: автоматизация задач, в настоящее время поддерживаются вызовы API и вызовы функций.

Подготовка

Вам необходимо установить go, gin, node (http://nodejs.org/) и git (https://git-scm.com/) на вашем компьютере.

Также предоставляются учебные пособия, включая видео и документацию, которые помогут вам от установки до эффективного использования. Мы настоятельно рекомендуем сначала просмотреть эти учебные пособия перед практическим применением этого проекта!

Простое создание первого приложения с Go-Admin — учебное пособие по документации

Шаг 1 — Введение в содержание: https://doc.zhangwj.com/guide/intro/tutorial01.html
Шаг 2 — Практическое применение — написание кода для добавления, удаления, изменения и запроса: https://doc.zhangwj.com/guide/intro/tutorial02.html

Пошаговое руководство по использованию — видеоучебник

Как запустить Go-Admin: https://www.bilibili.com/video/BV1z5411x7JG
Использование инструментов генерации для простого создания бизнес-логики: https://www.bilibili.com/video/BV1Dg4y1i79D
Версия инструмента генерации кода v1.1.0 — освободите обе руки: https://www.bilibili.com/video/BV1N54y1i71P [продвинутый уровень]
Объяснение многокомандного режима запуска и настройка IDE: https://www.bilibili.com/video/BV1Fg4y1q7ph
Подробное объяснение конфигурации меню Go-Admin: https://www.bilibili.com/video/BV1Wp4y1D715 [обязательно к просмотру]
Подробное объяснение настройки информации меню и информации интерфейса: https://www.bilibili.com/video/BV1zv411B7nG [обязательно к просмотру]
Подробные инструкции по настройке разрешений Go-Admin: https://www.bilibili.com/video/BV1rt4y197d3 [обязательно к просмотру]
Инструкции по использованию разрешений данных Go-Admin: https://www.bilibili.com/video/BV1LK4y1s71e [обязательно к просмотру]

Если у вас есть какие-либо вопросы, пожалуйста, сначала обратитесь к вышеупомянутым документам и статьям. Если они не могут удовлетворить ваши потребности, вы можете создать issue или PR. Видеоуроки и документы постоянно обновляются. or linux 下使用

$ ./go-admin server -c config/settings.yml

⚠️注意:windows 下使用

$ go-admin.exe server -c config/settings.yml


#### sys_api 表的数据如何添加

При запуске проекта используйте `-a true`, система автоматически добавит недостающие данные интерфейса.

```bash
./go-admin server -c config/settings.yml -a true

Использование docker для компиляции и запуска

# Компиляция образа
docker build -t go-admin .

# Запуск контейнера, где go-admin — имя контейнера, а go-admin-server — название образа
# -v сопоставляет пути к файлам конфигурации: локальный путь и путь в контейнере
docker run --name go-admin -p 8000:8000 -v /config/settings.yml:/config/settings.yml -d go-admin-server

Генерация документации

go generate

Кросс-компиляция

# windows
env GOOS=windows GOARCH=amd64 go build main.go

# или
# linux
env GOOS=linux GOARCH=amd64 go build main.go

Запуск UI-интерфейса взаимодействия с терминалом

# Установка зависимостей
npm install

# Рекомендуется не использовать cnpm для установки зависимостей, так как это может вызвать различные проблемы. Можно решить проблему медленной загрузки npm с помощью следующей команды
npm install --registry=https://registry.npmmirror.com

# Запустить сервис
npm run dev