RepiMe

A aplicação mobile RepiMe busca centralizar, gerenciar e organizar as informações sobre as vagas em Repúblicas e Kitnets disponíveis na cidade selecionada.

Sobre

Tendo em vista a forte tradição de repúblicas na cidade de Itajubá, muitos ingressantes nas universidades da cidade buscam acomodações durante o ciclo acadêmico. Nesse cenário, a fraca centralização das informações acerca das vagas gera um estresse que pode ser evitado.

Conforme as atividades da disciplina de Administração e Gerência de Redes da Universidade Federal de Itajubá, a equipe de desenvolvedores deste projeto propôs uma aplicação que busca auxiliar os universitário no processo para encontrar uma moradia. A aplicação mobile/web RepiMe foi construída com framework Flutter e a linguagem de Dart.

As orientações estão divididas nos seguintes tópicos:

• RepiMe
  • Sobre
  • Funcionalidades ⚙️
  • Banco de dados 🪑 🎲
  • Pré-requisitos e configuração 🛠️
  • Layout 🎨
  • Tecnologias 🧑‍💻
  • Contribuidores

Funcionalidades ⚙️

• Coletar cidade e universidade do usuário;
• Anunciar novas vagas (características da acomodação);
• Fornecer as informações para contato com o dono da vaga;
• Permitir o anúncio de novas vagas para usuários cadastrados;
• Marcar no mapa as vagas já cadastradas.

Banco de dados 🪑 🎲

A aplicação utiliza um banco relacional presente no modelo entidade relacionamento abaixo, a modelagem visa permitir o registro dos cadastros de usuários, vagas, residências, locadores, vagas e cidades. A hospedagem foi feita no Heroku com o add-on Heroku Postgres e a aplicação conversa diretamento com o banco. O pgAdmin4 facilitou o processo de criação e vizualização das tabelas/relacionamentos.

Todos os comandos SQL utilizados para criar tabelas, tipos e funções estão presentes nesta path desse repositório.

Para realizar a conexão com o banco utilizou-se a dependência:

postgres: ^2.5.2

Pré-requisitos e configuração 🛠️

No geral, para executar a aplicação é recomendado que o sistema já possua:

> Java 8+;
> Flutter SDK;
> Android Studio;
> Visual Studio (para Windows);
> Visual Studio Code;
> Maven/Gradle.

Para verificar o status do Flutter rode no terminal:

flutter doctor

Deve-se ativar as licenças mais recentes do android com o comando:

flutter doctor --android-licenses

Se houver problemas com o SDK Command-line do Android, entre no SDK Manager presente no Android Studio e baixe o pacote conforme imagem abaixo.

Se necessário instale a extensão do Flutter no VSCode com:

ext install Dart-Code.flutter

O release do projeto fornece um apk para utilizar o aplicativo e, apesar do foco na versão mobile, as versões para Windows e Linux também estão funcionais.

Para executar essas versões é necessário:

# Clone este repositório com
$ git clone https://github.com/darlosss/repime.git
# ou
$ git clone [email protected]:darlosss/repime.git

# Acesse a pasta do projeto no seu terminal/cmd
$ cd repime

# Instale as dependências
$ flutter pub get

# Instâncie as versões para Windows/Linux com Flutter
$ flutter create .

# Execute a aplicação
$ flutter run

# O Flutter irá sugerir a plataforma no qual será executada a aplicação

Se quiser rodar a aplicação mobile em modo de debuggação é necessário habilitar a depuração no Android, conectar o aparelho com cabo USB e usar o Run and Debug do VSCode.

Layout 🎨

Design base do figma: Real Estate Mobile App Design

Tecnologias 🧑‍💻

O ponto de início deste projeto foi uma aplicação Flutter, as dependências utilizadas estão presentes no pubspec.yaml. 

Aplicação:

-> Flutter
- easy_refresh: ^3.0.5
- flutter_launcher_icons: ^0.11.0
- flutter_mobx: ^2.0.6+5
- flutter_modular: ^5.0.3
- image_picker: ^0.8.6
- mobx: ^2.1.3
- path_provider: ^2.0.11
- postgres: ^2.5.2
- skeletons: ^0.0.3
- cupertino_icons: ^1.0.2
- flutter_lints: ^2.0.0
- build_runner: ^2.3.2
- mobx_codegen: ^2.1.1

Banco de Dados:

-> PostgreSQL
- pgAdmin4 6.16
- Heroku Postgres Mini
- BRmodelo

Utilitários:

-> Dev
- Visual Studio Code 1.73
- Android Studio Dolphin 2021.3.1
- Figma

Contribuidores

Carlos Eduardo 🧑‍💻

Matheus Martins 🧑‍💻

João Marcos 🧑‍💻

Adriano Lucas 🧑‍💻

Alexsandra 🎨