NodeEntity
Tracks node identity, address type, authorized registry match, current state, confidence, and timestamps.
Architecture
Native collectors.
Shared intelligence core.
DarkDar should be implemented as a domain-centric system: the Rust core handles deterministic models and state, while each platform shell owns permissions, BLE capture, rendering, and hardware-specific capabilities.
Runtime model
Capability parity, not fake feature parity.
DarkDar’s desktop targets are the strongest scanning and review stations. iOS and iPadOS are native field sensors and LiDAR capture clients. The browser is an admin, replay, documentation, and limited live mode surface where supported.
| Platform | Primary role | Implementation |
|---|---|---|
| Windows 11 | Desktop scanner and review station | Tauri, React, WebGL, Rust desktop BLE adapter, SQLCipher |
| macOS | Desktop scanner and review station | Tauri, React, WebGL, Rust desktop BLE adapter, Keychain, notarized builds |
| iOS / iPadOS | Field sensor and LiDAR capture client | SwiftUI, CoreBluetooth, Metal, ARKit, Rust bridge |
| Browser | Replay, admin, documentation, limited live mode | React, WebGL, WASM replay core, SQLite WASM with OPFS |
Operational data flow
From BLE observation to explainable target state.
01 Capture
Platform adapters receive BLE observations using documented native APIs or a clearly labeled browser capability mode.
02 Normalize
Events are timestamped, parsed, redacted as needed, and converted into shared model contracts.
03 Smooth
Rolling filters, RSSI smoothing, and environmental calibration reduce RF jitter without hiding uncertainty.
04 State
Nodes transition through Discovered, Candidate, Observed, Flagged, Tracked, Lost, and Reacquired only when thresholds are met.
05 Store
Authorized sessions are encrypted locally on native platforms and replay-cached locally in the browser.
06 Review
The dashboard renders radar views, target detail, anomaly evidence, timelines, and exportable summaries.
Model contracts
The first implementation should lock the core schemas.
ObservationEvent
Stores chronological telemetry including RSSI, Tx power, payload, timestamp, and anomaly rule markers.
LicenseTicket
Supports offline premium gating with signed license claims, expiry, and safe downgrade behavior.