Главная страница>Исходный код PHP>Другие категории
Скачать

AdminKit для панели управления Flask

Панель управления Flask с открытым исходным кодом, созданная AppSeed в современном дизайне. AdminKit — это профессиональный пакет, включающий сотни компонентов пользовательского интерфейса, форм, таблиц, диаграмм, страниц и значков, созданных на основе Bootstrap 5 .

  • Flask Dashboard AdminKit — Демо — Развертывание в реальном времени
  • Учебное пособие по Flask. Начало работы с Flask

Функции

  • СУБД: SQLite, PostgreSQL (производство)
  • Инструменты БД: SQLAlchemy ORM, Alembic (миграция схемы)
  • Модульный дизайн с Blueprints , простая кодовая база
  • Аутентификация на основе сеанса (через flask_login ), проверка форм
  • Скрипты развертывания: Docker, Gunicorn/Nginx, Heroku.
  • Поддержка через Github и Discord.


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

$ # Get the code
$ git clone https://github.com/app-generator/flask-adminkit.git
$ cd flask-adminkit
$
$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .envScriptsactivate
$
$ # Install modules - SQLite Database
$ pip3 install -r requirements.txt
$
$ # OR with PostgreSQL connector
$ # pip install -r requirements-pgsql.txt
$
$ # Set the FLASK_APP environment variable
$ (Unix/Mac) export FLASK_APP=run.py
$ (Windows) set FLASK_APP=run.py
$ (Powershell) $env :FLASK_APP = " .run.py "
$
$ # Set up the DEBUG environment
$ # (Unix/Mac) export FLASK_ENV=development
$ # (Windows) set FLASK_ENV=development
$ # (Powershell) $env:FLASK_ENV = "development"
$
$ # Start the application (development mode)
$ # --host=0.0.0.0 - expose the app on all network interfaces (default 127.0.0.1)
$ # --port=5000    - specify the app port (default 5000)  
$ flask run --host=0.0.0.0 --port=5000
$
$ # Access the dashboard in browser: http://127.0.0.1:5000/

Примечание. Чтобы использовать приложение, зайдите на страницу регистрации и создайте нового пользователя. После аутентификации приложение разблокирует личные страницы.


Структура кодовой базы

Проект написан с использованием чертежей, шаблона фабрики приложений, профиля двойной конфигурации (разработка и производство) и интуитивно понятной структуры, представленной ниже:

Упрощенная версия 

 < PROJECT ROOT >
   |
   | -- app/                      # Implements app logic
   |    | -- base/                # Base Blueprint - handles the authentication
   |    | -- home/                # Home Blueprint - serve UI Kit pages
   |    |
   |   __init__.py               # Initialize the app
   |
   | -- requirements.txt          # Development modules - SQLite storage
   | -- requirements-mysql.txt    # Production modules  - Mysql DMBS
   | -- requirements-pqsql.txt    # Production modules  - PostgreSql DMBS
   |
   | -- .env                      # Inject Configuration via Environment
   | -- config.py                 # Set up the app
   | -- run.py                    # Start the app - WSGI gateway
   |
   | -- ************************************************************************

Бутстрап-поток

  • run.py загружает файл .env
  • Инициализируйте приложение, используя указанный профиль: отладочный или рабочий.
    • Если для env.DEBUG установлено значение True, используется хранилище SQLite.
    • Если для env.DEBUG установлено значение False, используется указанный драйвер БД (MySql, PostgreSQL).
  • Вызов фабричного метода приложения create_app определенного в app/ init.py .
  • Перенаправить гостевых пользователей на страницу входа.
  • Разблокируйте страницы, обслуживаемые Home Blueprint, для прошедших проверку пользователей.

Приложение/базовый проект

Схема Base отвечает за аутентификацию (маршруты и формы) и управление активами. Структура представлена ​​ниже: 

 < PROJECT ROOT >
   |
   | -- app/
   |    | -- home/                                # Home Blueprint - serve app pages (private area)
   |    | -- base/                                # Base Blueprint - handles the authentication
   |         | -- static/
   |         |    | -- < css, JS, images >          # CSS files, Javascripts files
   |         |
   |         | -- templates/                      # Templates used to render pages
   |              |
   |              | -- includes/                  #
   |              |    | -- navigation.html       # Top menu component
   |              |    | -- sidebar.html          # Sidebar component
   |              |    | -- footer.html           # App Footer
   |              |    | -- scripts.html          # Scripts common to all pages
   |              |
   |              | -- layouts/                   # Master pages
   |              |    | -- base-fullscreen.html  # Used by Authentication pages
   |              |    | -- base.html             # Used by common pages
   |              |
   |              | -- accounts/                  # Authentication pages
   |                   | -- login.html            # Login page
   |                   | -- register.html         # Registration page
   |
   | -- requirements.txt                          # Development modules - SQLite storage
   | -- requirements-mysql.txt                    # Production modules  - Mysql DMBS
   | -- requirements-pqsql.txt                    # Production modules  - PostgreSql DMBS
   |
   | -- .env                                      # Inject Configuration via Environment
   | -- config.py                                 # Set up the app
   | -- run.py                                    # Start the app - WSGI gateway
   |
   | -- ************************************************************************

Приложение / Домашний проект

Схема Home обрабатывает страницы UI Kit для прошедших проверку подлинности пользователей. Это приватная зона приложения — структура представлена ​​ниже: 

 < PROJECT ROOT >
   |
   | -- app/
   |    | -- base/                     # Base Blueprint - handles the authentication
   |    | -- home/                     # Home Blueprint - serve app pages (private area)
   |         |
   |         | -- templates/           # UI Kit Pages
   |              |
   |              | -- index.html      # Default page
   |              | -- page-404.html   # Error 404 - mandatory page
   |              | -- page-500.html   # Error 500 - mandatory page
   |              | -- page-403.html   # Error 403 - mandatory page
   |              | -- * .html          # All other HTML pages
   |
   | -- requirements.txt               # Development modules - SQLite storage
   | -- requirements-mysql.txt         # Production modules  - Mysql DMBS
   | -- requirements-pqsql.txt         # Production modules  - PostgreSql DMBS
   |
   | -- .env                           # Inject Configuration via Environment
   | -- config.py                      # Set up the app
   | -- run.py                         # Start the app - WSGI gateway
   |
   | -- ************************************************************************

Развертывание

Приложение имеет базовую конфигурацию для работы в Docker, Heroku, Gunicorn и Waitress.


Выполнение докера

Приложение можно легко выполнить в Docker-контейнере. Шаги:

Получить код 

$ git clone https://github.com/app-generator/flask-adminkit.git
$ cd flask-adminkit

Запустите приложение в Docker 

$ sudo docker-compose pull && sudo docker-compose build && sudo docker-compose up -d

Посетите http://localhost:5005 в своем браузере. Приложение должно быть запущено и работать.


Хероку

Шаги по развертыванию на Heroku

  • Создайте БЕСПЛАТНУЮ учетную запись на платформе Heroku.
  • Установите интерфейс командной строки Heroku, соответствующий вашей ОС: Mac, Unix или Windows.
  • Откройте окно терминала и выполните аутентификацию с помощью команды heroku login
  • Клонируйте исходные коды и отправьте проект для развертывания в реальном времени. 
$ # Clone the source code:
$ git clone https://github.com/app-generator/flask-adminkit.git
$ cd flask-adminkit
$
$ # Check Heroku CLI is installed
$ heroku -v
heroku/7.25.0 win32-x64 node-v12.13.0 # <-- All good
$
$ # Check Heroku CLI is installed
$ heroku login
$ # this commaond will open a browser window - click the login button (in browser)
$
$ # Create the Heroku project
$ heroku create
$
$ # Trigger the LIVE deploy
$ git push heroku master
$
$ # Open the LIVE app in browser
$ heroku open

Единорог

Gunicorn «Green Unicorn» — это HTTP-сервер Python WSGI для UNIX.

Установить с помощью pip 

$ pip install gunicorn

Запустите приложение, используя двоичный файл Gunicorn. 

$ gunicorn --bind 0.0.0.0:8001 run:app
Serving on http://localhost:8001

Посетите http://localhost:8001 в своем браузере. Приложение должно быть запущено и работать.


Официантка

Waitress (эквивалент Gunicorn для Windows) задуман как WSGI-сервер производственного качества на чистом Python с очень приемлемой производительностью. У него нет никаких зависимостей, кроме тех, которые находятся в стандартной библиотеке Python.

Установить с помощью pip 

$ pip install waitress

Запустите приложение с помощью waitress-serve. 

$ waitress-serve --port=8001 run:app
Serving on http://localhost:8001

Посетите http://localhost:8001 в своем браузере. Приложение должно быть запущено и работать.


Кредиты и ссылки

  • Flask Framework — официальный сайт
  • Шаблонный код — индекс предоставлен AppSeed
  • Шаблонный код — индекс опубликован на Github

Flask Dashboard AdminKit — предоставлен генератором приложений AppSeed .

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все