Skip to content

Latest commit

 

History

History
163 lines (131 loc) · 9.04 KB

README.md

File metadata and controls

163 lines (131 loc) · 9.04 KB
Vamos Cuidar

Hortum

Deploy status GitHub closed issues GitHub closed pull requests GitHub

Acesse a API do Hortum

Acesse o Frontend do Hortum

Acesse a nossa Wiki

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

  1. Criação de anúncios de produtos

  2. Listagem dos anúncios para consumidores

  3. Visualização detalhada sobre os Produtos e Produtores

Releases

Release 1 (30/03)

Release 2 (20/05)

Documentação API

Documentação Swagger

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.

Baixando da Play Store

Para baixar e utilizar acesse o app Hortum na Play Store.

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

License

GPLv3 © Hortum. Para demais informações acesse nossa LICENSE.