Repository navigation
nl ARCHITECTURE
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
Dit is een overzichtskaart van hoe VD Infos in elkaar zit. Het beschrijft de vorm van de app, niet de catalogus van wat het leest: het punt van een methode-debugger is om elke meting voor je neer te leggen, en het lezen ervan is aan jou om te doen op je eigen apparaat.
- Een waarde, elke methode. Lees voor elk stukje informatie het via elke methode die het kan lezen en zet de metingen naast elkaar. Een debugger brengt bewijs naar boven; het velt geen oordeel.
- Op het apparaat en stil. Geen netwerk, geen account, geen achtergrondwerk. De app draait alleen terwijl hij open is.
- Leesbaar door machines. Het hele resultaat is een machineleesbaar document, zodat een tool hetzelfde beeld krijgt als een persoon. Zie AI-agents.
- Klein waar het ertoe doet. De native component wordt bewust piepklein en eenvoudig gehouden.
Een lens is een manier om een waarde te lezen. Dezelfde waarde wordt via meerdere lenzen gelezen zodat ze vergeleken kunnen worden:
| Lens | Wat het is |
|---|---|
| Java / SDK | De platform-API die een gewone app aanroept. |
| Native / JNI | Dezelfde waarde gelezen vanuit native code. |
| Shell via JVM | Een shell-commando dat door de JVM wordt gestart. |
| Shell via JNI | Hetzelfde commando gestart vanuit native code. |
| TEE / Attestation | Hardware-ondersteunde key attestation, waar het van toepassing is. |
De lenzen naast elkaar zetten is het hele idee: de app laat zien waar de metingen overeenkomen en waar ze verschillen. Wat een verschil voor een bepaalde waarde, op een bepaald apparaat, betekent, is aan jou om te lezen.
core/model immutable domain: Lens, Category, Verdict, ProbeSpec, ProbeResult
probe/ the probes and the bridges they use (JNI, reflection, data lists)
engine/ ProbeEngine: parallel fan-out, streams results as they land
data/ SnapshotStore (persist the report), Exporter (share as JSON / text)
ui/ Jetpack Compose, Material 3, dynamic colour, live progress
cpp/ native_probes.cpp: the native lens, dependency-free
- Parallellisme. De probes waaieren uit over een dispatcher met een begrensd aantal permits; resultaten stromen de UI in zodra ze voltooid zijn, met een live voortgangsindicator.
- Niets op de achtergrond. Geen services en geen geplande scans. De app leest alleen terwijl hij open is en sluit zichzelf wanneer het inactief wordt gelaten.
-
De native laag. Eén kleine, afhankelijkheidsvrije
.so, per naam gebonden viaRegisterNatives, bewust piepklein en eenvoudig gehouden.
Elke scan produceert een Snapshot: het tijdstip waarop hij is genomen, de appversie, en
een lijst van resultaten, een per probe, elk met de metingen van elke lens en een oordeel
over hoe ze zich verhouden. De app bewaart dit na elke scan in de priveopslag en kan
dezelfde data exporteren. De structuur is gedocumenteerd als het
exportformaat.
Het meeste van waar de app naar zoekt leeft als platte-tekstlijsten onder
assets/data/, niet als code. Een doel toevoegen of verwijderen is een regel bewerken.
Zie Bijdragen.
- Het verandert nooit iets aan je systeem. Het leest en vergelijkt alleen.
- Het praat nooit met het netwerk. Het werkt volledig offline.
- Het draait nooit op de achtergrond, plant nooit een scan, en houdt nooit een service in leven.
- Het stuurt nooit een meting ergens naartoe. Een rapport verlaat het apparaat alleen wanneer je het deelt of opslaat, met identiteitsdragende waarden gemaskeerd.
Deze documentatie is gegenereerd met Claude (Anthropic) en wordt onderhouden door VD171. Correcties en verbeteringen zijn welkom; zie CONTRIBUTING.md.