Net Tracker

CHANGELOG

QUICK START

1. Create a Net under My Nets — give it a name and frequency.

2. Open the net and click ▶ Start New Session to begin.

3. Use the Check-In form or Expected Stations list to log stations as they call in.

4. Click ■ End Session when the net closes — a session summary card will appear automatically.

Keyboard shortcut: Press / anywhere on the session page to instantly focus the callsign input.

SESSION CLOCK & TIMER

While a session is live, a clock bar appears showing local time, UTC time, and the elapsed session time. The timer starts from when the session was opened and updates every second.

The clock disappears automatically when the session ends.

CALLSIGN LOOKUP & SEARCH

Full callsign (e.g. W7KOL) — type it in and the system looks up the licensee name, class, state, and grid from the FCC database, auto-filling the Name field.

Suffix search (e.g. KOL) — type letters without a district number and the system searches your net's check-in history for matching callsigns. A dropdown appears sorted by suffix. Click any result to select it and trigger a full FCC lookup.

Suffix search only finds callsigns already in your net's history. For a brand-new station, type their full callsign.

STATION REMARKS

After looking up a callsign, a small 📝 Remark pill appears in the lookup info bar. Click it to add or edit a persistent note about that station (e.g. "portable op", "relay to W7NET", "hearing impaired — use Winlink").

Remarks are saved per net and appear every time that station is looked up during any future session on that net.

MANUAL CHECK-IN FORM

Fill in callsign, name (auto-filled from FCC), signal report, and optional comments. Check Has Traffic before clicking Check In or pressing Enter.

Duplicate callsigns in the same session are automatically rejected.

GMRS NETS

When creating a net, select GMRS as the net type. GMRS nets behave like ham nets with a few differences:

Shared callsigns — a GMRS licence covers an entire family. The same callsign can check in multiple times in a single session. Use the Name field to identify each individual operator (e.g. "Dad", "Mom", "Mobile 1").

Callsign lookup — GMRS callsigns (format: 3–4 letters followed by 3–4 digits, e.g. WSMC512) are looked up in a local copy of the FCC ULS GMRS database. The database is refreshed daily; new licences may take up to 24 hours to appear.

ARES mode and DMR integration are not available for GMRS nets and are hidden automatically.

EXPECTED STATIONS

Click Expected Stations to expand the panel. Set the minimum check-in count and lookback window (weeks), then click Load List.

Each row shows two checkboxes: Check In to log them immediately, and Traffic to pre-flag traffic before they're formally logged. On ARES nets, a 📍 zone badge shows their last known evacuation zone.

Already-checked-in stations are greyed out and the list refreshes automatically.

TRAFFIC MANAGEMENT

When any station has traffic, a red 📢 TRAFFIC banner appears listing them as interactive chips. Once you've called a station to pass their traffic, tick the checkbox on their chip — it strikes through and dims to show it's been handled. Unchecked chips remain prominent so nothing gets missed.

Pre-flagged stations from Expected Stations appear with a ⏳ badge until formally checked in. Their checkbox is disabled until they call in.

In the check-ins table, click the 📢 / ○ button in the Traffic column to toggle the flag on any station.

TRAFFIC MESSAGE LOG

Click 📋 TRAFFIC MESSAGE LOG to expand the panel. Use it to record individual traffic messages handled during the session — message number, origin, destination, type (Formal / Informal / Health & Welfare), and notes.

The Status dropdown on each row lets you track progress: Received → Relayed → Delivered (or Undeliverable). Changes save immediately.

The message log is included in the ICS-205 export.

SESSION SUMMARY & ICS-205

When you end a session, a Session Summary card pops up showing total check-ins, session duration, traffic count, and new stations (first-time visitors to this net).

Click 📄 ICS-205 / Net Log to open a printable net log in a new tab. It includes the ICS-205 header (net name, frequency, NCS callsign, operational period) plus the full check-in roster and traffic message log. Use your browser's Print function to save as PDF.

You can also export the raw check-in data as a CSV for logging or upload to other systems.

ARES/ACES MODE

Enable ARES/ACS Net in the net settings to activate evacuation zone tracking. An Evac Zone field appears in the check-in form — enter the station's zone (e.g. "Zone A") when they check in.

The zone is saved automatically to a per-net zone table. In future sessions, the station's last known zone appears as a 📍 badge in the Expected Stations list and is pre-filled when checking them in.

The Zone Roster panel shows all known zones grouped by zone name with their callsigns, sorted by callsign suffix. The Zone column also appears in the check-in table and the ICS-205 export.

SESSION HISTORY

The History view shows every callsign that has checked into the selected net, with check-in counts for the past 2 weeks, 4 weeks, and all time.

Use the filter dropdown to find: Last Net, Missed Last Net, Active (2 wks), Regular (4 wks, ≥2), Frequent (4 wks, ≥3), or Inactive (4 wks).

Combine the dropdown with the text search box for further filtering. Use ⬇ Download CSV to export the current view.

NET SHARING

Net owners can share a net with other registered operators. Open the net's Edit form and expand the 🔗 Sharing section at the bottom.

Choose Share with all registered users to give every active account access, or select individual users from the list. Click Save Sharing to apply — this is separate from the main Save button.

Shared nets appear in other operators' net lists with a Shared badge and show the owner's callsign. Shared users can start sessions and add check-ins, but cannot edit the net configuration or manage sharing.

Admins can see and open all nets on the system regardless of sharing settings.

SCHEDULING

In the Schedule tab of a net, add weekly repeating time slots (day, time, timezone). These appear as a calendar of upcoming dates.

Operators can click Sign Up next to any future date to claim the Net Control Operator slot.

ADMIN PANEL

The first user to register automatically becomes admin. Additional registrations require approval before login is permitted.

Admins can approve/deactivate accounts, grant admin privileges, delete accounts, and opt in to email notifications for new registrations using the ✉/📧 toggle in the Notify column.

Newly approved operators receive an automatic confirmation email if SMTP is configured in .env.

DATABASE MIGRATIONS

Schema migrations are managed by migrate.py in the app directory. It is safe to re-run at any time — every step uses IF NOT EXISTS.

sudo -u netcontrol python3 /opt/netcontrol/migrate.py

Fresh installs: new tables are created automatically on first startup — no migration needed. Run migrate.py only when upgrading an existing instance after a code update.

GMRS licence database

Seed the local GMRS callsign database on first install, then let the daily cron keep it current:

# Initial seed (full ~54 MB download)
python3 /opt/netcontrol/gmrs_sync.py --mode full

# Routine update (runs automatically via cron — daily transaction file)
python3 /opt/netcontrol/gmrs_sync.py --mode update