# Index

Content catalog for the TRM wiki. Maintained by the LLM on every ingest. See [[CLAUDE]] for schema and conventions.

## Sources

- [[gps-tracking-architecture]] — System-level architecture: four-component platform, three planes, failure domains.
- [[teltonika-ingestion-architecture]] — Internal Teltonika protocol adapter design; Phase 1 (8/8E/16) and Phase 2 (12/13/14) roadmap.
- [[teltonika-data-sending-protocols]] — Official Teltonika canonical wiki; full codec inventory including Codec 15 and SMS protocols, UDP transport, ACK/nACK details.

## Entities

- [[directus]] — Business plane: schema owner, REST/GraphQL/WSS, admin UI, permissions, Flows.
- [[postgres-timescaledb]] — Durable storage: positions hypertable + business schema. The system's only single point of failure.
- [[processor]] — Domain-logic service consuming Redis Streams; per-device hot state in memory; sole writer for telemetry tables.
- [[react-spa]] — End-user UI; talks exclusively to Directus; role-based views in a single bundle.
- [[redis-streams]] — Durable in-flight queue between Ingestion and Processor; Phase 2 transport for outbound commands.
- [[tcp-ingestion]] — Per-vendor TCP listener service; parses binary protocols and emits normalized records.
- [[teltonika]] — GPS hardware vendor; Codec 8/8E/16 telemetry today, Codec 12/14 commands deferred (13/15 one-way, 15 out of scope).

## Concepts

- [[avl-data-format]] — Canonical Teltonika packet structure: envelope, AVL record, GPS element, IO element layouts per codec.
- [[codec-dispatch]] — Flat registry keyed on codec ID; the seam that makes Phase 2 additive.
- [[failure-domains]] — Independent component failure behavior; database is the only SPOF.
- [[io-element-bag]] — The pass-through principle for model-specific telemetry inside AVL records.
- [[live-channel-architecture]] — Dual-WebSocket design for live UX: Processor's endpoint for telemetry firehose, Directus's for business-plane updates.
- [[phase-2-commands]] — Deferred design for server-to-device commands via Teltonika codecs 12/14.
- [[plane-separation]] — Three-plane architecture (telemetry / business / presentation) split by data velocity and failure domain.
- [[position-record]] — Boundary contract between vendor adapters and the rest of the system.
- [[protocol-adapter]] — Vendor-abstraction interface (bytes in → normalized Position out) at the Ingestion layer.

## Synthesis

_None yet._