WebAppTemplate FARM

Modelo de aplicativo Web Full Stack - FARM Stack

Este repositório contém um modelo de aplicativo web full stack que é executado na pilha de soluções FARM, que significa:

• F lask, uma estrutura web Python de back-end.
• Um mazon Web Services, um serviço em nuvem que pode hospedar software.
• R eact, uma estrutura web JavaScript de front-end.
• MySQL , um sistema de gerenciamento de banco de dados relacional.

O que é FAZENDA?

A pilha FARM é mais ou menos uma extensão da pilha LAMP com estas mudanças notáveis:

• A estrutura de middleware é explícita (Flask)
• Assim como a pilha MEAN, inclui uma camada de apresentação de aplicativo (React)
• O ambiente em que o software é executado é substituído por serviços de computação em nuvem PaaS/IaaS (AWS)
• Não há opinião sobre qual sistema operacional usar

Frasco

Flask é usado para escrever APIs/middleware da web que podem se comunicar entre a UI da web e o backend/banco de dados da web. Este é o núcleo de todo o aplicativo que une as partes do aplicativo full stack.

Observe que este modelo específico não usa um ORM e, em vez disso, usa o módulo pymysql . Isso significa que os desenvolvedores precisam escrever consultas SQL, mas podem maximizar a complexidade das consultas necessárias para executar no banco de dados.

Amazon Web Services

AWS é o serviço de nuvem no qual o aplicativo pode ser hospedado. Podemos hospedar toda a pilha de software nos seguintes serviços:

• AWS Lambda para hospedar nossos aplicativos em uma infraestrutura sem servidor. Também podemos optar por hospedar nossas APIs Flask via Zappa, tornando a implantação na produção extremamente fácil.
• AWS RDS para hospedar nosso banco de dados.
• AWS S3 para armazenar todos os tipos de outros objetos, como imagens e arquivos.

Isso significa que os desenvolvedores podem manter tudo em uma plataforma e minimizar o trabalho de DevOps/TI.

Reagir

React é a estrutura na qual a UI da web é executada. A aplicação React também pode ser executada em AWS Lambda com NodeJS.

Este modelo usa JavaScript/JSX, mas TypeScript também pode ser usado.

MySQL

MySQL é o banco de dados relacional que o backend da web usa. Também pode ser hospedado na AWS por meio de seu serviço RDS.

Como executar localmente

Para executar este aplicativo da web, o seguinte precisa ser feito:

1. Configure uma instância local do MySQL usando o esquema em db/
2. Instale módulos para API e UI
3. Execute a API e a IU localmente

Configuração do banco de dados

Para configurar a instância MySQL, siga estas etapas:

1. Crie e conecte-se a uma instância de banco de dados MySQL. As maneiras mais comuns de fazer isso são com MySQL Workbench ou mysql na interface de linha de comando do Linux.
2. Execute sample.sql na instância. Ele criará um esquema chamado SampleInventory e, em seguida, inicializará uma tabela chamada Inventory .

Configuração de API

A base de código para a API Flask pode ser encontrada no diretório api/ .

Configuração inicial (macOS)

1. Crie um ambiente virtual Python com virtualenv farm-stack depois de navegar até esse diretório.
2. Ative-o com source farm-stack/bin/activate
3. Navegue até api/ e execute pip3 install -r requirements.txt para instalar todos os módulos Python necessários para a API.
4. Abra dbcreds.py no diretório api/ e edite as credenciais do banco de dados conforme necessário.

Executando a API

1. Ative o ambiente virtual acima.
2. Execute python3 app.py para executar a API em http://localhost:8080 .

Configuração da IU

A base de código para a UI do React pode ser encontrada no diretório ui/ . Este modelo usa yarn como gerenciador de pacotes; é crucial que os desenvolvedores não misturem outros gerenciadores de pacotes como npm ao adicionar novos módulos.

Observe que pacotes como react-bootstrap estão faltando neste modelo.

Configuração inicial (macOS)

1. Execute yarn install para instalar todas as dependências necessárias.

Executando a IU

1. Execute yarn start para executar no modo de desenvolvimento.
2. Navegue para http://localhost:3000 no navegador.