# DEPS — mgf-tele-teltonika's bidirectional dependency manifest

> **§1** — what mgf-tele-teltonika depends on. **§2** — who depends on
> mgf-tele-teltonika. Knowing both directions makes deprecation,
> breaking-change blast-radius, and feature-prioritisation tractable.
>
> **Per standard DOC-16** (v2.12): every project ships a `DEPS.md`.
> Replaces the former `USERS.md`.

Last verified: 2026-06-09.

---

## §1 What mgf-tele-teltonika depends on

| Dependency | Window | Why | Tier |
|---|---|---|---|
| `mgf-tele-core` | `>=0.1,<0.2` | vendor-neutral telematics seam — `TelematicsProvider`, `DecodedAvlRecord`, the typed `TelematicsError` hierarchy, `UnsupportedCodecError` | runtime |
| `mgf-common` | `>=0.41,<0.42` | federation cornerstone — typed exceptions (`AppError`) under the telematics hierarchy, bootstrap, observability | runtime |

*Federation siblings depended on: **`mgf-tele-core`** — the
vendor-neutral two-layer seam this vendor codec builds on. The codec
depends on the core, never the reverse, and `mgf.common.*` is reached
transitively via `mgf-tele-core`.*

---

## §2 Who depends on mgf-tele-teltonika

Consumer projects + federation siblings that import this project.
(Inverse of each consumer's `MGF_ADOPTION.md`.)

mgf-tele-teltonika was newly extracted from PlasmaMapper's ingest path
on 2026-05-28.

| Project / sibling | Location | Import sites | Status | Surfaces used |
|---|---|---:|---|---|
| **PlasmaMapper** | `/home/bassam/PycharmProjects/PlasmaMapper` | 23 | Active — consumer #1 (multi-tenant FastAPI SaaS); the extraction origin | `TeltonikaProvider` (ingest socket loop) / `decode_avl_packet` / `_crc.crc16_ibm` / `_packets` (round-trip + fuzz tests) |

No federation siblings depend on mgf-tele-teltonika — it is a leaf
vendor package. New vendor codecs belong in their own
`mgf-tele-<vendor>` package on `mgf-tele-core`, not here.

---

## §3 Maintenance

Updated every MINOR release + when a dependency or consumer changes.
Import-survey methodology:

```sh
grep -rE "(from|import) +mgf\.tele\.teltonika" /home/bassam/PycharmProjects/PlasmaMapper \
  --include='*.py' | wc -l
```
