Hortum

Sobre o Projeto

O projeto Hortum é um aplicativo para celulares Android, que busca facilitar e promover a venda e distribuição das mercadorias de pequenos produtores. Com uma plataforma simples e eficaz ,os produtores podem desfrutar de diversas facilidades para a promoção de seus produtos, assim também facilitando para os compradores a comunicação, localização e possíveis aquisições de produtos dos vendedores.

Ideias e Incentivos

A ideia do projeto surgiu relacionada ao site PõeNaCesta da EMATER-DF, que tem como princípio promover o contato direto entre produtor e consumidor sem a necessidade de intervenções e intermediações de mercados. Dessa forma, a plataforma Hortum incentivada pelo PõeNaCesta busca seguir com os mesmos princípios em um aplicativo de fácil utilização para todos os seus usuários.

Principais Funcionalidades

Criação de anúncios de produtos
Listagem dos anúncios para consumidores
Visualização detalhada sobre os Produtos e Produtores

Instalação

Pré-Requisitos

Obrigatórias

Tecnologias	Descrição
Git	`git` é uma ferramenta de versionamento de código `gratuito` e `open source`, capaz de lidar com tudo desde pequenos até grandes projetos, com `velocidade` e `eficiência`.
Docker	o `docker` é uma plataforma `open source` de containerização, ou seja um software para criação de sistemas isolados. Os `containers` são extremamente leves e permitem que os softwares sejam `facilmente` executados e exportados para os diversos sistemas existentes atualmente.
Docker compose	O `docker-compose` é uma tecnologia de `multi-dockerização` que permite, através de um único arquivo de configuração `.yml`, criar e rodar todos os serviços/dockers da sua aplição.

Para sistemas Windows

Tecnologias	Descrição
Windows Subsystem for Linux	O Subsistema do Windows para Linux permite que os desenvolvedores executem um `ambiente GNU/Linux`, incluindo a maioria das ferramentas de linha de comando, utilitários e aplicativos, diretamente no Windows, sem modificações e sem a sobrecarga de uma `máquina virtual tradicional` ou instalação `dualboot`.
Docker compose para WSL	O Windows Subsystem for Linux `WSL` apresenta uma mudança significativa na arquitetura, pois é um kernel Linux completo desenvolvido pela Microsoft, permitindo que os contêineres do Linux sejam executados `nativamente`, `sem emulação`.

Baixando e rodando o Backend

# Clone o Backend
$ git clone https://github.com/fga-eps-mds/2020.2-Hortum.git

# Entre na pasta do projeto
$ cd 2020.2-Hortum

# Build do docker
$ docker-compose build

# Rodando o docker
$ docker-compose up

Ao rodar o código a porta 8000 estará aberta para o uso da API.

Baixando e rodando o Frontend

Para rodar o frontend acesse o repositório mobile e siga o passo a passo da instalação.

Utilizando o sistema

Backend

Alguns comandos que podem ser úteis utilizando o backend.

# Acessando o container de maneira interativa
$ docker exec -it [hash do container] bash

# Rodar o docker do backend sem exibir os logs
$ docker-compose run -d

# Acessando o log caso a flag -d tenha sido utilizada
$ docker log [hash do container]

Script de Limpeza de migrations

# Entre na pasta do projeto
$ cd 2020.2-Hortum

# Rode o script de limpeza
$ ./src/scripts/clear_migrations.sh

Desenvolvedores

_{Brenno Oliveira Silva}

_{Carlos Eduardo de Sousa Fiuza}

_{João Pedro Moura Oliveira}

_{Lucas Braun Vieira Xavier}

_{Matheus Calixto Vaz Pinheiro}

_{Victor Souza Dantas Martins Lima}

_{Vitor Magalhães Lamego}

lmmLucasMachado/2020.2-Hortum