Documentation of Mow-E Backend

High Level Requirements

Low Level Requirements

Network diagram

File structure overview

Main Class

• SweBotApplication.java
  • The heart of the project
    • Contains the swagger configuration.

Configs

• ErrorConfig.java

  • This class captures all untracked errors from endpoints and returns a default error-json.

• ExecutorConfig.java

  • We reserve a pool of executors that are needed for various tasks.
    • Currently for the communication with the Google Vision API in a separate thread.

• SecurityConfig.java

  • Setting the access authority for all endpoints.
  • Error handling in case of missing authorities.
  • Enabling the JwtRequestFilter for processing the JWT.
  • Creates standard users for testing the application. (user & admin).

    EncoderComponent.java

    • Encodes the passwords for saving them in db

  JwtRequestFilter.java

  • Simply processes the JWT tokens if exists in request.
  • All requests are going through this filter to identify the authority.

• WebConfig.java

  • Resource handler
  • Path matching
  • CORS configuration

• WebSocketConfig.java

  • Stomp configuration
  • Authentication for websockets
  • Destination prefixes for endpoints

Services

• JwtService.java
  • Generation of JWT
  • Creation of JWT
  • Validation of JWT
• AuthService.java
  • Creates JWT tokens.
  • User authentication.
• AdminService.java
  • Functions for deleteing users.
  • Fetching user statistics.
  • functions to get mower statistics.
• UserService.java
  • Get images for a user.
  • Get history for a user.
  • Add a mower to a user account.
• ImageService.java
  • Logic for receiving images
  • Image storing
  • Uses the ImageClassificationService
• ImgClassificationService.java
  • Uses the Google Vision APIsimus for image classification
• MowerService.java
  • Creates a new mowing session
  • Stores the coordinates

Controllers

• AuthController.java
  • Makes use of the AuthService
  • Auth endpoints
  • Error handling

    LoginRequest.java

    • Processes the username and password

• AdminController
  • Makes use of AuthService
  • Makes use of ImageService
  • Handles CRUD function for users and admins.
• UserController
  • Endpoints for fetching user history and images.
  • Endpoints for adding a mower to a user account.
• ErrorController.java
  • The real error handler
    • Default errors
    • Db errors
    • Validation errors
• ImageController.java
  • Makes use of the ImageService
  • Image endpoints
• MowerController.java
  • Makes use of the MowerService
  • Broadcasts the coordinates to the subscribers of a specific mower
• MyControlous.java
  • A hello worldous endpointus

Repository

• CoordinateRepo.java
  • Methods for retrieving coordinate data from the db

    Coordinate.java

    • Processes the coordinate data
    • Creates the table

Resources

• application.properties
  • A lot of settings for the entire application
  • I resist to document all of them
• schema.sql
  • Initializes the db tables on first application run

Utils

• UtilImage
  • Saving images to file system.

Tests

• AutohControllerTest

  • Tests endpoints for register and login user.

• UserControllerTest

  • Tests user functionality for fetching history, images and binding mower to a user.

Frontendus -> under construction

Dashboard that help the admin to see key information about the all project.

Stack used

• Vite
• React.js
• MUI 5

How to launch it ?

First you need to create a .env

VITE_API_HOST=https://mow-e.me/

cd frontend/
yarn install
yarn build
yarn start

The default port used is 3000

127.0.0.1:3000

Endpoints