WebAppTemplate FARM

Полнофункциональный шаблон веб-приложения — FARM Stack

Этот репозиторий содержит полнофункциональный шаблон веб-приложения, который работает в стеке решений FARM, что означает:

• F lask, серверная веб-инфраструктура Python .
• Веб-службы mazon — облачный сервис, на котором может размещаться программное обеспечение.
• React , интерфейсный веб-фреймворк JavaScript .
• MySQL — система управления реляционными базами данных.

Что такое ФЕРМА?

Стек FARM является более или менее расширением стека LAMP со следующими заметными изменениями:

• Платформа промежуточного программного обеспечения является явной (Flask).
• Как и стек MEAN, он включает в себя уровень представления приложения (React).
• Вместо этого среда, в которой работает программное обеспечение, заменяется службами облачных вычислений PaaS/IaaS (AWS).
• Нет мнения, какую операционную систему использовать

Колба

Flask используется для написания веб-API/промежуточного программного обеспечения, которое может взаимодействовать между веб-интерфейсом и веб-сервером/базой данных. Это ядро ​​всего приложения, которое объединяет части полнофункционального приложения.

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

Веб-сервисы Amazon

AWS — это облачный сервис, на котором может быть размещено приложение. Мы можем разместить весь стек программного обеспечения на следующих сервисах:

• AWS Lambda для размещения наших приложений в бессерверной инфраструктуре. Мы также можем разместить наши API-интерфейсы Flask через Zappa, что чрезвычайно упрощает развертывание в рабочей среде.
• AWS RDS для размещения нашей базы данных.
• AWS S3 для хранения всевозможных других объектов, таких как изображения и файлы.

Это означает, что разработчики могут хранить все на одной платформе и минимизировать работу DevOps/ИТ.

Реагировать

React — это платформа, на которой работает веб-интерфейс. Приложение React также можно запустить на AWS Lambda с NodeJS.

В этом шаблоне используется JavaScript/JSX, но также можно использовать TypeScript.

MySQL

MySQL — это реляционная база данных, которую использует веб-сервер. Его также можно разместить на AWS через службу RDS.

Как запустить локально

Чтобы запустить это веб-приложение, необходимо сделать следующее:

1. Настройте локальный экземпляр MySQL, используя схему в db/
2. Установите модули для API и пользовательского интерфейса.
3. Запускайте API и пользовательский интерфейс локально

Настройка базы данных

Чтобы настроить экземпляр MySQL, выполните следующие действия:

1. Создайте экземпляр базы данных MySQL и подключитесь к нему. Наиболее распространенные способы сделать это — с помощью MySQL Workbench или mysql в интерфейсе командной строки Linux.
2. Запустите sample.sql внутри экземпляра. Он создаст схему под названием SampleInventory , а затем инициализирует таблицу под названием Inventory .

Настройка API

Кодовую базу API Flask можно найти в каталоге api/ .

Первоначальная установка (macOS)

1. Создайте виртуальную среду Python с помощью virtualenv farm-stack после перехода в этот каталог.
2. Активируйте его с помощью source farm-stack/bin/activate
3. Перейдите в api/ и запустите pip3 install -r requirements.txt , чтобы установить все модули Python, необходимые для API.
4. Откройте dbcreds.py в каталоге api/ и при необходимости отредактируйте учетные данные базы данных.

Запуск API

1. Активируйте виртуальную среду сверху.
2. Запустите python3 app.py , чтобы запустить API на http://localhost:8080 .

Настройка пользовательского интерфейса

Базу кода для пользовательского интерфейса React можно найти в каталоге ui/ . Этот шаблон использует yarn в качестве менеджера пакетов; Крайне важно, чтобы разработчики не смешивали другие менеджеры пакетов, такие как npm при добавлении новых модулей.

Обратите внимание, что в этом шаблоне отсутствуют такие пакеты, как react-bootstrap .

Первоначальная установка (macOS)

1. Запустите yarn install , чтобы установить все необходимые зависимости.

Запуск пользовательского интерфейса

1. Запустите yarn start , чтобы запустить ее в режиме разработки.
2. Перейдите по адресу http://localhost:3000 в браузере.