ObliviOS Developer portal Project site

Home / Decisions / ADR-157

The first version of the Live Data Map is accepted as designed in 2026-10-11-live-data-map-design.md.

Accepted, recorded 11 October 2026.

Decision
ADR-157
Date
2026-10-11
Status
AcceptedAccepted; the classifier sources and licences are decided in ADR-158; an image needs the plan's checks and a code review first
Part
Atlas
Mentions
ADR-158
Mentioned by
ADR-158, ADR-159, ADR-160, ADR-161, ADR-189

1Decision

The first version of the Live Data Map is accepted as designed in 2026-10-11-live-data-map-design.md (visual reference: live-data-map-2026-10-11.html): an observe-only globe on which every app and every company behind it stands at its base, with a line from an app to each company it talks to, dashed lines between companies that are documented as connected, flags for the countries, and four tabs (Map, Apps, Companies, Links).

(1) The interface is a new privileged system app DataMapApp that declares no network permission, service, receiver or provider, holds READ_DATA_MAP and QUERY_ALL_PACKAGES (icons and labels only), and shows each app's own icon from the system; no logo file of any app is shipped.

(2) A collector in system_server takes the DNS and TCP connect events through a fourth INetdEventCallback slot (CALLBACK_CALLER_DATA_MAP = 3) and keeps aggregates per user, app and service; they stay in memory unless the user turns a history on, and the user chooses its length (1 to 90 days).

(3) Every place on the map is a company or publisher base from a read-only classifier file, each with a source id; no address is looked up and no GeoIP database is used; a service with no known owner or place is listed, not placed. (4) A connection between companies is shown only with a source id, and is worded neutrally. (5) Bytes per destination, blocking and a separate identity per app are not in this version.

Supersedes nothing; narrows requirements.md section 5 to its first slice.

2Why and evidence

Owner decisions 2026-10-11 (chat): the Live Data Map as the next large feature, observe-only first; the history off by default and its length chosen by the user; the globe with the apps standing on it and no row of apps under it; an app of its own; flags; the apps' icons taken from the phone, which must be the correct ones; the design approved on the reference page and the spec approved.

Verified in source (build server, frameworks/base, branch sovereignos-2026091900-r2): onDnsEvent carries the host name, up to 10 addresses and the uid, and onConnectEvent the address, port and uid but not UDP (system/netd/server/FwmarkServer.cpp); neither carries bytes; the resolver keeps a set of listeners and registering needs NETWORK_STACK; NetdEventListenerService forwards each event to one INetdEventCallback per caller type and the three slots are taken (the intrusion detection NetworkLogSource uses the device-policy slot).

The design avoids the NETWORK_STACK permission by running in system_server. Own privileged apps with their own privapp-permissions file already exist (GuardianApp, AirPodsApp).

3Consequences

The map shows only what the system's name and connect events reveal: an app that looks names up itself, a fixed address over UDP and QUIC without a lookup of its own are blind spots, shown as such. A place is where a company is based, which country's law governs what it holds, not where a server is. No bytes per destination. Every change of the app is an image build (a system app update needs the fs-verity signature). DataMapApp.apk and its privapp file join the REQUIRED list of tools/build/check-required-packages.sh with the implementation. The app is a new privileged package, so its capability rows, SELinux domain and code review come before any image.

4Review when

Accepted fully when rows MAP-001 to MAP-018 of the validation matrix have evidence or the owner waives them; a failed row reopens the design. Reopened if the classifier cannot be sourced under compatible licences, or if the globe costs anything while nothing is touched.

Read from docs/governance/decision-log.md, entry ADR-157.