Skip to content

gxmzung/wildtrack-assist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WildTrack Assist

Search Operation Support System with Drone Simulation and Report Validation

WildTrack Assist is a prototype system for supporting field search operations by combining drone status, field team information, sighting reports, alerts, and AI-assisted report validation.

The project is not a real emergency-response product.
It is a simulation-oriented system prototype designed to show how search operation data can be collected, organized, prioritized, and visualized.


Why This Project Exists

Field search operations can suffer from fragmented information.

Common problems include:

  • separated drone, team, and report data
  • delayed situational awareness
  • search gaps caused by drone battery limitations
  • duplicated or unreliable sighting reports
  • unclear priority between search zones

WildTrack Assist focuses on building an integrated operation layer rather than claiming full autonomous detection.


Core Concept

Drone simulator
+ field team status
+ sighting reports
+ alert logic
+ report validation
→ operation dashboard and search support

The core idea is to support decision-making by organizing field data into a structured workflow.


Main Features

Operation Dashboard

  • drone status monitoring
  • field team status
  • alert and event tracking
  • search zone visualization
  • operation timeline support

Sighting Report System

  • image-based sighting reports
  • location-aware report registration
  • duplicate report checking
  • trust score calculation
  • metadata-based validation support

Drone Simulation

  • drone movement simulation
  • battery decrease logic
  • fake thermal event generation
  • simulated drone feed

Search Support Logic

  • search priority support
  • dispatch support
  • heatmap-related service structure
  • zone and team coordination logic

Repository Structure

wildtrack-assist/
├─ backend/
│  ├─ app/
│  │  ├─ routers/
│  │  ├─ models/
│  │  ├─ schemas/
│  │  ├─ services/
│  │  ├─ db/
│  │  ├─ core/
│  │  └─ main.py
│  ├─ tests/
│  └─ requirements.txt
│
├─ frontend/
│  ├─ src/app/
│  └─ package.json
│
├─ drone_simulator/
│  ├─ simulator.py
│  ├─ battery_logic.py
│  ├─ fake_feed_generator.py
│  └─ thermal_mock.py
│
├─ ai_tools/
│  ├─ image_check/
│  └─ report_ranker/
│
└─ docs/
   ├─ architecture.md
   ├─ api-spec.md
   ├─ scenario.md
   └─ ui-wireframe.md

Tech Stack

Backend

  • Python
  • FastAPI
  • WebSocket
  • SQLAlchemy-style project structure
  • pytest

Frontend

  • Next.js
  • TypeScript

Simulation / AI Assist

  • Python drone simulator
  • image metadata parsing
  • duplicate report checking
  • trust score calculation
  • thermal mock event generation

Quick Start

Backend

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

Frontend

cd frontend
npm install
npm run dev

Drone Simulator

cd drone_simulator
python simulator.py

Example Scenario

A field search operation is simulated with:

  1. drone movement
  2. battery decrease
  3. thermal event generation
  4. sighting report submission
  5. duplicate report detection
  6. trust score calculation
  7. alert and zone status updates

The project demonstrates how multiple field signals can be organized into a single operation-support workflow.


Implementation Evidence

This repository includes:

  • FastAPI backend entry point
  • routers for alerts, drones, sightings, teams, zones, and WebSocket
  • service layer for dispatch, drone status, reports, heatmap logic, and verification
  • backend tests for drone, sighting, and team logic
  • drone simulator modules
  • AI-assisted report ranking modules
  • frontend dashboard scaffold
  • architecture and API documents

Current Limits

This project does not claim:

  • real drone integration
  • certified emergency response usage
  • production-grade AI detection
  • verified thermal camera pipeline
  • offline field operation support
  • complete authentication and authorization
  • production database persistence

It is a prototype for system architecture, simulation, and operation-support workflow design.


Future Work

  • connect ROS2 / PX4 drone simulation
  • add real-time map visualization
  • improve authentication and authorization
  • add persistent database storage
  • add multi-drone coordination logic
  • add offline-first mobile field reporting
  • add dashboard screenshots and operation flow GIFs
  • improve report validation with real image datasets

Status

WildTrack Assist is a prototype search-operation support system.

The current version focuses on backend structure, drone simulation, report validation logic, and dashboard scaffolding.

About

Search operation support system with FastAPI backend, React dashboard, drone simulator, report ranking, and AI-assisted sighting validation.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors