agmission/server/public/releases/3.4.0-pilot-analytical-dashboard.md

# AgMission Release Notes — v3.4.0

**Release:** 3.4.0  
**Date:** June 15, 2026

---

## Overview

This release introduces the **Pilot Analytical Dashboard** — a new dedicated analytics view for pilots that provides a real-time operational picture of their assigned jobs, daily performance, and flight quality metrics, all in one screen.

Additional improvements include:  
- **Dashboard features:**  
  + Unit switching between Metric and US-Imperial measurement units across all dashboard values.  
  + A configurable auto-refresh so the dashboard stays live during active operations.  
  + A **Print** button Print/capture the full dashboard as a PDF file or send to a printer.   
 
- Added a new job Completed status and a streamlined workflow to mark jobs as Completed directly from the Job List or Job Edit pages.  
 

<div class="dashboard-img">
  <img src="/images/pilot_dashboard.png" alt="Pilot Analytical Dashboard" />
</div>

<style>
.dashboard-img { margin: 1.5rem auto; text-align: center; }
.dashboard-img img { max-height: 55vh; max-width: 85%; width: auto; display: inline-block; border-radius: 8px; box-shadow: 0 4px 20px rgba(0,0,0,0.15); border: 1px solid #c8e6c9; }
</style>

---

## New Features

### 1. Pilot Analytical Dashboard

Pilots can now access comprehensive analytics dashboard via the **Dashboard** menu. The dashboard is scoped exclusively to the logged-in pilot's own jobs and flight data.

---

### 2. KPI Summary Cards

Four headline cards summarise the pilot's performance across a selectable time window.

| Card | What it shows |
|---|---|
| **Assigned Jobs** | Total jobs assigned, broken down by New / In Progress / Completed |
| **Assigned Acres** | Total field (exclude non-sprayed/non-flight areas) area across assigned jobs |
| **Acres Sprayed** | Area actually covered by the operation (spray-on/boom-on) |
| **Flight Hours** | Total accumulated airborne time |

**Period filter** — a tab strip above the cards lets you switch between:

| Filter | Coverage |
|---|---|
| Day | Today only |
| Week | Current rolling week |
| Month | Current calendar month |
| Year | Current calendar year |
| All | All time |

The **Assigned Jobs** card also includes a summary of jobs grouping by status (New / In Progress / Completed) within the selected period. 
  
---

### 3. Daily Summary — Today vs Yesterday

A dark Green summary bar below the KPI cards shows five key metrics for **today**, each with a colour-coded percentage change compared to yesterday.

| Metric | Description |
|---|---|
| **Acres Sprayed** | Today total acreage |
| **Flight Hours** | Total airborne time today |
| **Spray Rate** | Average application rate (ac/hr or ha/hr) during spray-on/boom-on passes |
| **Avg Speed** | Average ground speed during spray-on/boom-on passes |
| **Spray Volume** | Total spray material applied today |

A positive delta (↑) is shown in Green; a negative delta (↓) is shown in Red, giving an immediate at-a-glance comparison against yesterday's output.

---

### 4. Operations Today

A secondary metrics row beneath the daily summary provides additional operational context for today's flying.

| Metric | Description |
|---|---|
| **Travelled Distance** | Total distance flown including ferry and turns |
| **Sprayed Distance** | Distance covered during spray-on/boom-on passes only |
| **Spray Efficiency** | Percentage of total flight time spent spraying |
| **Ferry Time** | Percentage of total flight time spent ferrying (not spraying) |
| **Flow Accuracy** | How closely the actual spray volume matched the target application rate |
| **GPS Health** | Average HDOP score across spray-on records (lower is better, < 1 excellent; 1–2 good; 2–5 moderate; > 5 poor) |

---

### 5. Active Jobs Panel

The lower half of the left panel lists the pilot's active jobs for the selected period, each showing:

- Job name, client, created date, and status badge (**New**, **In Progress**, **Completed**)
- A progress bar representing acres sprayed vs. total assigned acres
- Spray volume applied

A **period dropdown** (Day / Week / Month / Year) on the panel header filters which jobs appear. A **View All** link navigates to the full job list.

---

### 6. Trend Charts

The right panel shows two charts over the selected date range.

**Hours Flown (Week History/ Custom Range)** — a line chart plotting daily flight hours, making it easy to spot which days had the most airborne time.

**Acres Sprayed Per Day** — a bar chart showing daily sprayed area, with today's bar visually distinct from earlier days.

Both charts update automatically according to the auto-reload interval and respond instantly when the date range is changed.

---

### 7. Date Range & Auto-Reload

**Date Range selector** — a calendar date picker above the charts lets you: quickly select a week date range or a custom start and end date for the trend charts and performance gauges. Max range is 90 days.

**Auto-reload** — a dropdown next to the date range controls how often the entire right panel refreshes automatically, keeping the dashboard live during active operations.

A **manual refresh button** (↻) is also available to make an immediate reload at any time.

---

### 8. Performance Gauges

Two quality needle indicators appear below the trend charts, each with a colour-coded gauge bar and a status badge.

**Average XT Error**

A indicator needle shows the pilot's average cross-track error (how far off the intended spray line the aircraft flew) across all spray-on records in the date range.

| Zone | Threshold | Badge, Color indicator range |
|---|---|---|
| Ideal | < 1.0 m | **Good** (green) |
| Caution | 1 – 3 m | **Caution** (orange) |
| High | > 3 m | **High** (red) |

**Average Altitude Spraying**

An indicator needle shows the pilot's average spray altitude, relative to the configured target altitude ranges. A deviation label below the value tells the pilot exactly how many feet above or below target they are flying on average.

| Zone | Threshold | Badge, Color indicator range |
|---|---|---|
| Ideal | Within ±0.5 ft of target | **Good** (green) |
| Caution | ±0.5 – ±1.5 ft | **Caution** (orange) |
| High risk | > ±1.5 ft | **High** (red) |

**Customisable thresholds** — both gauges have an **edit button** that expands an inline form, letting each pilot save their own ideal and caution thresholds. Changes are saved per account and persist across sessions.

---

### 9. Metric / US Imperial Toggle

A Unit of Measurement toggle button in the top-right corner of the dashboard to switches all distance, area, speed, and altitude values between **Metric** and **US / Imperial** units instantly, without reloading any data. The preference is saved per account.

---

### 10. Print Live Dashboard

A print button in the top-right corner opens the browser print dialog with a clean print-optimised layout of the full dashboard (KPI cards, daily summary, operations today, active jobs), ready to save as PDF or to send to a printer for printing.

---

### 11. Mark Jobs as Completed

Now, Job Life Cycle includes a new **Completed** status after Sprayed. Jobs life cycle follows: New > Ready > Downloaded/Sprayed (In Progress) > **Completed** > Invoiced > Archived. 
  
When a Job is finished, Pilots and Applicators can now mark a job as **Completed** directly from the **Job List** or the **Job Edit** page. A completed job is ready for invoicing and archiving. 

The **Complete** button appears once flight data has been uploaded for a job (when the job is in **Sprayed** status). Clicking it marks the job as Completed and updates its status immediately across the Job List, Job Edit page, and the Active Jobs panel on the Pilot Dashboard.