springboot-manager

Введение

Основанный на SpringBoot + Mybatis Plus + SaToken + Thymeleaf + Layui, представляет собой систему управления бэкендом.
После подключения Sa-Token система поддерживает меню и права доступа.
Поддерживает основные базы данных, такие как MySQL, Oracle, sqlServer.
Предоставляет генератор кода, который позволяет быстро выполнять базовые операции CRUD без написания кода.
Бэкенд-интерфейс RESTful, поддерживает разделение фронтенда и бэкенда, может совместно использовать один и тот же интерфейс с приложением.
Разработка очень проста, подходит в качестве каркаса для DIY.

Если вам нравится этот проект, пожалуйста, поставьте ему звезду. Ваша поддержка — это источник энергии для нас! Спасибо!

Особенности

• Бэкенд-интерфейсы RESTful поддерживают разделение фронтенда и бэкенда и могут совместно использовать один и тот же интерфейс с приложением;
• Реализован контроль доступа на основе ролей (RBAC);
• Унифицированные инструменты для упаковки и генерации ответов и унифицированная обработка исключений;
• Поддержка Sa-Token для аутентификации ролей, что делает аутентификацию простой и элегантной;
• Интеграция Druid Spring Boot Starter для объединения пула соединений Druid и мониторинга;
• Использование MyBatis-Plus для реализации однотабличных операций без SQL;
• Поддерживает несколько источников данных, легко переключается между ними, просто добавьте @DS к методу или классу;
• Интегрирует Knife4j, инструмент разработки на китайском языке, для автоматической генерации документации по интерфейсу;
• Предоставляет генератор кода (для MySQL, Oracle и sqlServer), генерирует код от HTML до Mapper.

Репозитории кода: последние версии доступны на gitee, github синхронизируется регулярно

Gitee: https://gitee.com/zwens/springboot-manager
GitHub: https://github.com/aitangbao/springboot-manager

Документация по разработке и демонстрационный проект

• Документация по разработке: документация по разработке wiki
• Демонстрационный адрес: springboot-manager
• Логин: guest / 123456

Структура кода

├─main
│  ├─java
│  │  └─com
│  │      └─company
│  │          └─project
│  │              ├─CompanyProjectApplication.java 项目启动类
│  │              ├─common      公共资源，如注解、切面、全局异常处理、组件集成、通用工具类等
│  │              ├─controller  Controler层
│  │              ├─entity      实体类
│  │              ├─mapper      DAO层
│  │              ├─service     Service层
│  │              │  └─impl     Service层实现
│  └─resources
│      ├── application-dev.yml  开发环境配置文件
│      ├── application-test.yml 测试环境配置文件
│      ├── application-prod.yml 生产环境配置文件
│      ├── application.yml      通用配置文件
│      ├── logback-spring.xml   日志配置文件
│      ├─mapper                 Mybatis XML文件
│      ├─static                 静态文件
│      │  ├─css                 通用css文件
│      │  ├─images              静态图片
│      │  ├─js                  通用js文件
│      │  ├─layui               layui库
│      │  └─layui-ext           layui插件库
│      ├─template               代码生成模版
│      └─templates              项目页面目录
│          ├─depts              部门管理
│          ├─error              错误页面
│          ├─generator          代码生成管理
│          ├─logs               日志管理
│          ├─menus              菜单管理
│          ├─roles              角色管理
│          ├─syscontent         内容管理
│          ├─sysdict            字典管理
│          ├─sysfiles           文件管理
│          └─users              用户管理
└─test
    └─java
        └─com
            └─company
                └─project
                    ├── CompanyFrameApplicationTests.java 单元测试

Рекомендации по разработке

• Рекомендуется, чтобы переменные-члены в модели соответствовали полям таблицы, а если требуется расширение переменных-членов (например, связанные запросы), рекомендуется создать VO. В противном случае необходимо добавить @TableField(exist = false) к расширенным переменным-членам.
• Рекомендуется напрямую использовать throw new BusinessException("ErrorMessage") для бизнес-ошибок, и унифицированный обработчик исключений упакует результаты бизнес-исключений в {"code":500002,"message":"ErrorMessage"} и вернёт их.
• Основные поля базы данных: id (bigint), remark (varchar), unable_flag (tinyint), deleted (tinyint), create_id (bigint), update_id (bigint), create_time (datetime), update_time (datetime).

Как использовать

• Импортируйте этот проект в IDE, IDE должна установить плагин lombok.
• Создайте базу данных и импортируйте mysql.sql в базу данных MySQL.
• Настройте соединение с базой данных в application-dev.yml.
• Запустите проект:
  1. Запустите CompanyProjectApplication.java напрямую.
  2. Выполните компиляцию и упаковку проекта в корневом каталоге с помощью команды mvn -X clean package -Dmaven.test.skip=true, затем выполните java -jar manager.jar.
• Войдите в систему по адресу http://localhost:8080/manager/index/login, используя имя пользователя и пароль admin / 123456.
• Генерация кода:
  1. Для логического удаления полей рекомендуется использовать поле deleted: 1 не удалено, 0 удалено. Для первичных ключей рекомендуется формат id varchar(50). Не используйте ключевые слова базы данных для именования столбцов.
  2. В application.yml укажите, какие таблицы должны быть сгенерированы в какой базе данных. project.database=mysql.
  3. Нажмите «Генерация кода», чтобы сгенерировать код для одной или нескольких таблиц и загрузить его.
  4. Распакуйте загруженный код, скопируйте папку main в каталог src вашего локального проекта.
  5. Выполните SQL в базе данных, чтобы создать меню.
  6. Обновите страницу администратора, чтобы сразу увидеть результат.

Технические документы

• Основная структура: Spring Boot
• Постоянная структура слоя: MyBatis-Plus
• Аутентификация: Sa-Token
• Фронтенд-фреймворк: Layui
• Пул соединений с базой данных: Alibaba Druid
• Шаблонизатор: Thymeleaf
• Руководство по разработке на Java от Alibaba P3C последняя версия для скачивания

Участие и вклад

1. Форкните этот проект.
2. Создайте ветку feature_xxx.
3. Отправьте код.
4. Отправьте запрос на вытягивание. Пожертвование

Развитие проекта невозможно без вашей поддержки. Если вы можете себе позволить, угостите автора чашкой кофе!

Общение в группе

Если у вас есть какие-либо вопросы или проблемы, связанные с технологиями, вы можете присоединиться к нашей группе. Обязательно укажите, что вы из сообщества открытого исходного кода.