🏍️ MotoFácil - Guia Completo Frontend & Backend

Este guia cobre o processo de instalação, configuração e execução do MotoFácil, incluindo backend (Java/Spring Boot) e frontend (React).

1️⃣ Pré-requisitos

• Node.js 18+ e npm ou yarn
• Java 17+ e Maven
• Git
• Postman (opcional, para testar a API)
• Verifique se as portas 8080 (backend) e 3000 (frontend) estão livres.

2️⃣ Clonando o Backend

git clone https://github.com/Cruz-011/motofacil-java.git
cd motofacil-java

3️⃣ Executando o Backend

No diretório motofacil-backend:

• Linux/Mac:

  ./mvnw spring-boot:run

• Windows:

  mvnw.cmd spring-boot:run

O backend estará disponível em: http://localhost:8080

Se precisar alterar a porta, edite src/main/resources/application.properties. Configurando o Backend (Oracle)

No arquivo src/main/resources/application.properties, configure:

spring.datasource.url=jdbc:oracle:thin:@oracle.fiap.com.br:1521:ORCL spring.datasource.username=rm558238 spring.datasource.password=111105 spring.datasource.driver-class-name=oracle.jdbc.OracleDriver

spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=true

Swagger

springdoc.api-docs.path=/api-docs springdoc.swagger-ui.path=/swagger-ui.html

🔹 Para desenvolvimento local, você pode usar H2 se não tiver Oracle.

ESP Simulator Server

Este projeto é um simulador de servidor ESP que simula dados RSSI (Received Signal Strength Indicator) para localização de motos em um pátio usando Flask.

Funcionalidades

• Simula 5 ESPs posicionados em um pátio (4 nos cantos e 1 no centro)
• Gera dados RSSI baseados na distância simulada
• API REST para simulação e obtenção de coordenadas dos ESPs

Pré-requisitos

• Python 3.6 ou superior
• pip (gerenciador de pacotes do Python)

Instalação das Dependências

1. Clone ou baixe o projeto (se ainda não tiver feito)

2. Instale as dependências necessárias:

   pip install flask
   
   

Como Iniciar o Projeto

1. Execute o servidor:

   python esp_simulator_server.py

2. O servidor será iniciado em:

   • Host: 0.0.0.0 (todas as interfaces de rede)
   • Porta: 5001
   • URL local: http://localhost:5001

3. Você verá uma mensagem similar a:

   * Running on all addresses (0.0.0.0)
   * Running on http://127.0.0.1:5001
   * Running on http://[seu-ip]:5001
   

4️⃣ Clonando o Frontend

Em outro terminal:

git clone https://github.com/Cruz-011/MOTOFACIL-APP.git
cd MOTOFACIL-APP

5️⃣ Configurando a URL da API no Frontend

Edite o arquivo:

src/config/api.js

Altere a linha:

export const API_URL = "http://localhost:8080/api"; // Endereço do backend

Se o backend estiver em outro IP, ajuste aqui.

6️⃣ Instalando Dependências do Frontend

No diretório motofacil-frontend:

npm install
# ou
yarn

7️⃣ Executando o Frontend

Ainda em motofacil-frontend:

npm expo start
# ou
yarn expo start

O frontend abrirá em: http://localhost:3000

8️⃣ Estrutura do Frontend

motofacil-frontend/
├─ app/
│  ├─ components/      # Componentes reutilizáveis
│  ├─ (tabs)/          # Telas (Motos, Pátios, Login)
│  ├─ App.js           # Arquivo principal
│  ├─ index.js         # Entrada da aplicação
|  └─ src/
|      └─config/api.js    # Configuração da URL da API

├─ package.json        # Dependências e scripts

9️⃣ Testando Endpoints com Postman

• Listar todas as motos

  GET http://localhost:8080/api/motos
  

• Buscar moto por ID

  GET http://localhost:8080/api/motos/{id}
  

• Criar nova moto

  POST http://localhost:8080/api/motos
  Body (JSON):
  {
    "placa": "ABC1234",
    "modelo": "Mottu Sport",
    "patio": { "id": 1 }
  }
  

• Atualizar localização de uma moto

  PUT http://localhost:8080/api/motos/1/location
  Body (JSON):
  {
    "x": 2.5,
    "y": 3.0,
    "patioId": 1,
    "tag": "patio"
  }
  

🔟 Observações Importantes

• Sempre inicie o backend e o simulador de esp antes do frontend.
• Alterações em API_URL exigem reinício do frontend.
• Problemas de CORS devem ser resolvidos no backend (permitindo http://localhost:3000).

---