Repository navigation
es 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 | 中文
Este es un mapa de alto nivel de cómo está construida VD Infos. Describe la forma de la aplicación, no el catálogo de lo que lee: el sentido de un depurador de métodos es poner cada lectura delante de ti, y leerlas es tuyo para hacerlo en tu propio dispositivo.
- Un valor, cada método. Para cada pieza de información, léela a través de cada método que pueda leerla y alinea las lecturas. Un depurador saca a la luz la evidencia; no emite juicios.
- En el dispositivo y silencioso. Sin red, sin cuenta, sin trabajo en segundo plano. La aplicación se ejecuta solo mientras está abierta.
- Legible por máquinas. El resultado completo es un documento legible por máquina, así que una herramienta obtiene la misma imagen que una persona. Consulta Agentes de IA.
- Pequeño donde importa. El componente nativo se mantiene deliberadamente diminuto y simple.
Una lente es una forma de leer un valor. El mismo valor se lee a través de varias para que puedan compararse:
| Lente | Qué es |
|---|---|
| Java / SDK | La API de plataforma que llama una aplicación corriente. |
| Nativo / JNI | El mismo valor leído desde código nativo. |
| Shell vía JVM | Un comando de shell generado por la JVM. |
| Shell vía JNI | El mismo comando generado desde código nativo. |
| TEE / Atestación | Atestación de claves respaldada por hardware, donde aplica. |
Alinear las lentes es toda la idea: la aplicación muestra dónde coinciden las lecturas y dónde difieren. Lo que una diferencia significa para un valor dado, en un dispositivo dado, es tuyo para leerlo.
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
- Paralelismo. Las sondas se despliegan a través de un dispatcher con un conteo acotado de permisos; los resultados se transmiten a la interfaz a medida que se completan, con un indicador de progreso en vivo.
- Nada en segundo plano. Sin servicios y sin escaneos programados. La aplicación lee solo mientras está abierta y se cierra sola cuando se deja inactiva.
-
La capa nativa. Un pequeño
.sosin dependencias, vinculado por nombre a través deRegisterNatives, mantenido deliberadamente diminuto y simple.
Cada escaneo produce un Snapshot: la hora en que se tomó, la versión de la aplicación, y una lista de
resultados, uno por sonda, cada uno con las lecturas de cada lente y un veredicto de cómo se
relacionan. La aplicación persiste esto en el almacenamiento privado tras cada escaneo y puede exportar
los mismos datos. La estructura está documentada como el formato de exportación.
La mayor parte de lo que la aplicación busca vive como listas de texto plano bajo
assets/data/, no como código. Añadir o quitar un objetivo es editar una línea. Consulta
Contribuir.
- Nunca cambia nada en tu sistema. Solo lee y compara.
- Nunca habla con la red. Funciona por completo sin conexión.
- Nunca se ejecuta en segundo plano, programa un escaneo, ni mantiene un servicio vivo.
- Nunca envía una lectura a ninguna parte. Un informe sale del dispositivo solo cuando lo compartes o lo guardas, con los valores que portan identidad enmascarados.
Esta documentación se generó con Claude (Anthropic) y la mantiene VD171. Las correcciones y mejoras son bienvenidas; consulta CONTRIBUTING.md.