DroneGuard

DroneGuard is a tool that lets lifeguards supervise the beaches with a drone in an intuitive way and without any prior knowledge of flying drones. The tool also records usage sequences thereby enabling a review and analysis of emergency events.

High-Level Project Tree

.
├── assets
├── control-server
│   ├── algorithm
│   ├── test
│   └── utils
├── debriefing-service
│   ├── client
│   │   ├── public
│   │   └── src
│   ├── lambdas
│   └── server
│       ├── api
│       ├── postman
│       └── test
├── docs
├── droneguard-app
│   ├── public
│   └── src
│       ├── api
│       ├── app
│       ├── components
│       ├── config
│       ├── features
│       ├── pages
│       └── utils
├── hardware
│   ├── camera
│   │   ├── pycam
│   │   └── server
│   ├── compass
│   └── gps
├── poc
│   ├── transformations
│   │   ├── node-version
│   │   └── python-version
│   └── views
├── raspberry-pi-config
│   └── add-to-boot-drive
├── scripts
└── tello-basics
    ├── basics-node
    │   └── utils
    ├── basics-python
    │   └── tello-captures
    └── tello-sdk-documentation
    

Build and Run

Prerequisites

• Node v16.13.2
• NPM 8.4.0
• Python 3.8
• Docker CLI (optional)

There are two ways to build and run DroneGuard project locally

1. Service by Service

• Navigate to the DroneGuard directory and run $make install.
• Get all of the required project dependencies installed.
  
• See internal README files to run the different services.

2. Using Docker

• Make sure to have Docker CLI installed on your machine.
• Navigate to the DroneGuard directory and run $make build.
• Five core DroneGuard services:
  • DroneGuard Main Server (./debriefing-service/server)
  • DroneGuard DB [mongoDB]
  • DroneGuard Control Server (./control-server)
  • DroneGuard Main App (./droneguard-app)
  • DroneGuard Debriefing App (./debriefing-service/client)
• Get all of the required project images built [from the internal Docker files].
  
• Run $make start in order to start the containers and run the project.
• When finish run $make stop to stop the project and remove its containers.
• If needed, run $make clear to remove both volumes and images.

Test and Lint

See compatible internal services

Run tests:

$npm run test:unit

$npm run test:integration

Validate code style with eslint:

$npm run lint:validate