📡 DRF Triangulation System - Operational Manual

1. User Provisioning & Account Creation

The platform supports a secure, zero-conf workflow for onboarding operators in the field or pre-provisioning accounts from headquarters.

Method A: Self-Registration via Telegram Gatekeeper

• Search for the bot username or interact with it within an authorized group channel.
• Send a greeting message (e.g., Hi or Hello). The bot's integrated registration gatekeeper will recognize you as a new user and prompt: "👋 Welcome! Type your Username below:"
• Reply directly with your desired visual tracking name. The system will automatically create your profile, bind it to your unique Telegram ID, assign a standard tracking color, and configure your default temporary security key to DRF_2026.

Method B: Administrative Creation & Profile Linking

• An administrator can provision your account directly on the Web Management panel by entering a default username and secure passphrase.
• To activate your field capabilities, message the Telegram Bot. The gatekeeper will prompt you for a username. Enter the username matching your web profile.
• The bot will recognize that the user already exists in the database and reply: "⚠️ User exists. Type Password (DM me):"
• Send the matching password via a Direct Message to the bot. The system will securely pair your Telegram account to your web dashboard profile.

2. Managing Your Operator Profile

Web Dashboard Once provisioned, log into the central control dashboard at drf.itsonlyelectronics.co.za to configure your profile settings located in the user grid:

• Password Update: Replace the default temporary DRF_2026 string with a personalized passphrase.
• Line Color Configuration: Select a distinct color from the color-picker utility. This color dynamically brands your visual cross-bearing vectors on the shared mission map.
• APRS Callsign Assignment: Bind your amateur radio or experimental tracking callsign (e.g., ZR6XYZ-9) to enable background automation utilities.

3. Mobile Logging via Telegram (Field Operations)

Telegram Bot Field operators can log target directions seamlessly without keeping a web browser active, conserving field battery life.

The Signal Submission Pipeline:

1. Submit Origin Location: Tap the attachment icon (paperclip), select Location, and drop a static pin. CRITICAL: Do not use "Live Location Sharing". The bot requires a distinct static coordinate pin to lock the observation origin point.
2. Target Project Selection: The bot will immediately reply with a dynamic inline button menu containing all active tracking assignments. Tap the target project you are currently searching.
   • If the project does not exist yet, tap ➕ Add New. The bot will prompt you for a **Project Name** followed by an **RF Frequency** (e.g., 145.500) to instantly establish a new vector coordinate space for all field units.
3. Heading Entry (Optional): The bot prompts you for a compass bearing. Type an integer between 0 and 360 degrees and send. If you lack direction tools, type skip.
4. Signal Strength Entry (Optional): The bot prompts you for signal data. Type an integer corresponding to your received strength meter (e.g., -85) and send. If you do not have signal strength metrics, type skip.

4. Advanced Dashboard Capabilities & Automation

Web Dashboard The browser interface handles real-time cross-bearing visualization and geometric targeting analysis.

Manual Data Capture

• 📱 Phone GPS: Pulls live positioning parameters from your mobile browser's hardware location subsystem.
• 📡 APRS Link: Instantly fetches your tracking vehicle's most recent geodetic coordinates from the core network using your assigned callsign.
• 🧭 Hardware Compass: Decodes internal hardware gyroscopes on supported smartphone web browsers to populate your heading entry box with your physical relative pointing alignment.

Automated APRS Radio Direction Finding (Auto-Poll Engine)

The platform contains a localized automatic tracking subsystem capable of pulling location beacons directly from raw APRS assets, entirely bypassing the need for manual inputs while driving:

• In the User Management & Auto-APRS DF grid, locate your profile row.
• Check the DF Auto-Poll activation box.
• Select your preferred tracking sample rate window (1 min, 5 min, or 15 min) and allocate it to your active target assignment profile.
• The background script will periodically harvest your tracker's location data and extract integrated course heading tracking lines automatically, discarding duplicates and positioning drift errors below 15 meters to keep maps mathematically clean.

Map Filter Layers

• The Map Layers & Filters console aggregates active operational assets. You can check or uncheck individual operators to clear up line intersections, or isolate specific data packets to evaluate multipath interference and signal bounce anomalies.

Dispatching Tactical Ground Teams

• Privileged Action Once line intersections reveal a cross-bearing coordinate convergence lock, an operator can Right-Click (Desktop) or Long-Press (Mobile Touchscreens) onto the map intersection point.
• Confirming the prompt triggers a target notification directly to the central Telegram operational room, transmitting a hyperlinked Google Maps location pin to guide support vehicles directly to the target center.

5. Core Command Glossary

Type these commands into the Telegram interface to control session states:

• /help - Outputs an overview of command strings and contains the active hyperlink to this web manual document.
• /cancel - Purges and resets any ongoing signal logging workflow if an error was made during coordinate or tracking entry.
• /deleteuser [username] - Admin Only Permanently removes an operational account profile from the centralized system registry.