GitHub - andresgonzalezperez-hash/legado-digital-familiar: 🛡️ Offline-first, air-gapped pure HTML family digital legacy vault (v1.4.1) | Bóveda patrimonial offline y protocolo notarial de recuperación familiar sin servidores.

🇬🇧 English Documentation

1. Executive Summary & Purpose

Legado Digital Familiar is an open-source, air-gapped sovereign infrastructure designed to organize, safeguard, and delegate your digital estate, asset inventory, and family emergency protocols.

Built entirely in 100% Pure W3C HTML5/CSS/JavaScript with the Web Crypto API, it guarantees perpetual access across decades without relying on external servers, third-party cloud backends, subscriptions, or fragile mobile application stores (no APK/AppStore obsolescence).

📸 Interface & Workflow Gallery

🏷️ Official Version History & Release Milestones

🚀 Key Features

• 100% Pure Web W3C (Store & APK-Free): Runs instantly in any standard web browser across Windows, macOS, Linux, iOS, and Android simply by opening inicio.html. Immune to mobile operating system deprecation and application store bans.
• ISO 27001, ISO 27701 & SOC 2 Type II Hardening:
  • Hermetic CSP: Strict <meta> Content Security Policy forbidding any outbound network requests (connect-src 'none').
  • Active RAM Zeroization: Overwrites sensitive session memory with cryptographically secure random bytes upon logout or timeout.
  • Runtime Immutability: Core cryptographic engines and helpers are frozen via Object.freeze().
  • Anti-XSS DOM Sanitization: Comprehensive input escaping across all view layers.
• Data Freshness Tracker & Obsolescence Semaphore: Calculates days since the last vault review and warns when assets, insurance policies, or credentials may be outdated (🟢 Fresh, 🟡 Review Recommended, 🔴 Stale).
• Interactive Emergency Visual Map (Archify): Embedded interactive visual guide (APP/mapa-recuperacion.html) with 4 guided recovery swimlanes for non-technical family members.
• Dual Operational Modes:
  • Master Owner Mode: Full administrative privileges, estate editing, and security checklist validation.
  • Family Emergency Mode (Read-Only): Clear, grief-adapted step-by-step guidance without any risk of accidental data deletion.
• Notarial Export & Emergency Worksheets:
  • One-click generation of the Master PDF Document formatted for legal archiving.
  • Printable Emergency Notary Access Sheet for physical sealed notary envelopes.
• SHA-256 Bit-Rot Integrity Auditing: Built-in verification against silent storage media degradation.

📁 Repository Structure

legado-digital-familiar/
├── APP/                             # Core web application engine
│   ├── core/                        # Crypto, state, router & security primitives
│   ├── modules/                     # Dashboard, inventory, PDF, checklists
│   ├── sw.js                        # Offline Service Worker cache
│   ├── mapa-recuperacion.html       # Standalone Archify interactive recovery map
│   └── index.html                   # Main application entry point
├── START/                           # Automated emergency scripts (e.g. Drive mirror)
├── TOOLS/                           # Recommended offline utilities (Picocrypt)
├── docs/screenshots/                # High-resolution bilingual UI mockups (EN / ES)
├── inicio.html                      # Root launcher (open directly in any browser)
├── MATRIZ_CUMPLIMIENTO_ISO_SOC2.md  # Formal regulatory compliance audit matrix
├── DOCUMENTACION_MAESTRA.md         # Exhaustive technical and operational manual
└── CHANGELOG.md                     # Full chronological version changelog

⚙️ Quick Start

1. Clone or download this repository onto a clean computer or offline USB drive.
2. Double-click inicio.html in the root directory.
3. Your browser will execute the vault locally without sending a single byte over the network.

❓ Frequently Asked Questions (FAQ)

1. Why not just use Bitwarden, 1Password, or KeePass?

Answer: Password managers are exceptional at storing raw credentials, and we actively encourage storing your master keys and actual passwords inside them (e.g. KeePassXC or Passbolt). However, password managers are not designed for grieving heirs:

• An heir without technical expertise opening a vault with 400 credentials will experience panic and confusion.
• They do not know which bank accounts hold assets, what life insurance policies exist, which phone numbers to call, or what legal steps to take first.
• Legado Digital is the orchestration and asset catalog layer: it documents what exists, where it is kept, what immediate emergency actions to execute, and provides printable legal worksheets for notaries.

2. Why not a native Android / iOS app (Why Pure W3C HTML)?

Answer: Mobile applications are fragile against the test of time:

• In 10 to 15 years, Android and iOS will deprecate current SDKs, change app store policies, ban legacy APIs, or reject sideloaded APKs.
• A digital estate solution must guarantee accessibility 30+ years into the future.
• An offline, air-gapped W3C HTML5 document with Web Crypto runs natively in every modern and legacy browser across Windows, macOS, Linux, Android, and iOS without permissions, app stores, or compilation.

3. What happens if the physical USB flash drive gets damaged or corrupted?

Answer: The system implements multi-tier contingency redundancy:

• SHA-256 Bit-Rot Verification: Detects magnetic or flash storage degradation with 1-click active hash verification.
• Encrypted Cloud Mirror: Automated AES-256-GCM encrypted backup synchronization via START/sincronizar_drive.ps1 (mirroring to Google Drive).
• Upcoming Cloud Storage Integrations: Automated sync connectors for Proton Drive, Nextcloud, Microsoft OneDrive, and Dropbox are currently on the roadmap and will be rolled out in upcoming releases.

⚖️ Legal & Inheritance Disclaimer

In accordance with Spanish Civil Code and Article 96 of Organic Law 3/2018 (LOPD-GDD):
This system and its generated reports serve solely as an informative, private inventory to assist heirs and executors in identifying and locating assets. It does not constitute a formal legal will, nor does it provide legal authority to transfer funds or close accounts prior to the official settlement of inheritance deeds and tax obligations.

🇪🇸 Documentación en Español

1. Resumen Ejecutivo y Propósito

Legado Digital Familiar es una infraestructura soberana de código abierto diseñada para organizar, proteger y delegar tu patrimonio digital, inventario de activos y protocolos de emergencia familiares.

Construida íntegramente en HTML5/CSS/JavaScript puro W3C con la Web Crypto API, garantiza el funcionamiento perpetuo a lo largo de décadas sin depender de servidores externos, servicios en la nube de terceros, suscripciones ni tiendas de aplicaciones móviles (sin riesgo de obsolescencia de APKs o App Store).

📸 Galería Visual de Pantallas y Flujos

🏷️ Historial de Versiones Oficiales

🚀 Características Principales

• 100% Pure Web W3C (Sin APKs ni Tiendas): Ejecución inmediata en cualquier navegador moderno (Windows, macOS, Linux, iOS y Android) abriendo directamente inicio.html. Inmune al abandono de versiones de sistemas operativos móviles.
• Hardening Normativo ISO 27001, ISO 27701 y SOC 2:
  • CSP Hermética: Directiva de seguridad en cabecera <meta> que bloquea toda salida hacia internet (connect-src 'none').
  • Zeroización Activa en RAM: Sobrescritura de memoria con bytes criptográficos aleatorios al cerrar sesión o por inactividad.
  • Inmutabilidad en Runtime: Motores criptográficos sellados mediante Object.freeze().
  • Sanitización Integral Anti-XSS: Escapado automático de datos en todas las capas del DOM.
• Semáforo de Frescura de Información: Detección de desfase temporal desde la última actualización para alertar sobre pólizas o cuentas bancarias desactualizadas (🟢 Al día, 🟡 Revisión recomendada, 🔴 Desactualizado).
• Mapa Visual Interactivo de Contingencia (Archify): Diagrama interactivo (APP/mapa-recuperacion.html) con 4 carrileras ordenadas paso a paso para familiares sin conocimientos técnicos.
• Doble Modo Operativo:
  • Modo Titular: Administración total, edición de activos y verificación de checklists de seguridad.
  • Modo Familiar (Solo Lectura): Asistente guiado para contingencias sin peligro de borrado accidental.
• Exportación Notarial y Hojas de Contingencia:
  • Generación del Documento Maestro PDF preparado para archivo documental formal.
  • Impresión de la Hoja de Acceso Notarial de Emergencia para sobre cerrado o caja de seguridad física.
• Auditoría de Integridad SHA-256: Comprobación contra la degradación magnética de datos (bit-rot).

📁 Estructura del Repositorio

legado-digital-familiar/
├── APP/                             # Núcleo de la aplicación web
│   ├── core/                        # Criptografía, estado, router y helpers
│   ├── modules/                     # Dashboard, inventario, PDF, checklists
│   ├── sw.js                        # Service Worker de caché offline
│   ├── mapa-recuperacion.html       # Mapa visual interactivo Archify
│   └── index.html                   # Vista principal de la aplicación
├── START/                           # Scripts automatizados de respaldo
├── TOOLS/                           # Utilidades offline recomendadas (Picocrypt)
├── docs/screenshots/                # Mockups visuales bilingües en alta resolución
├── inicio.html                      # Acceso directo raíz para el navegador
├── MATRIZ_CUMPLIMIENTO_ISO_SOC2.md  # Matriz de cumplimiento normativo
├── DOCUMENTACION_MAESTRA.md         # Manual técnico integral
└── CHANGELOG.md                     # Registro histórico de versiones

⚙️ Puesta en Marcha Rápida

1. Descarga o clona este repositorio en un ordenador seguro o memoria USB de contingencia.
2. Haz doble clic en inicio.html en la raíz del proyecto.
3. La aplicación se ejecutará de forma instantánea en tu navegador sin requerir conexión a internet.

❓ Preguntas Frecuentes (FAQ)

1. ¿Por qué no usar simplemente Bitwarden, 1Password o KeePass?

Respuesta: Los gestores de contraseñas son extraordinarios para custodiar credenciales, y recomendamos activamente guardar las contraseñas reales dentro de ellos (KeePassXC o Passbolt). Sin embargo, no están adaptados para familiares en situación de duelo:

• Un heredero sin conocimientos técnicos que abra una bóveda con 400 contraseñas crudas sufrirá confusión y bloqueo.
• No sabrá qué cuentas bancarias tienen saldo real, qué pólizas de vida existen, a qué teléfonos llamar de inmediato ni qué trámites legales realizar en los primeros días.
• Legado Digital es la capa de orquestación y catálogo patrimonial: documenta qué existe, dónde se custodia, qué acción de contingencia ejecutar ante cada entidad y genera hojas físicas de acceso para la notaría.

2. ¿Por qué no una aplicación nativa para Android o iOS (Por qué HTML Puro)?

Respuesta: Las aplicaciones móviles son muy frágiles frente al paso de las décadas:

• En 10 o 15 años, Google y Apple habrán cambiado sus SDKs, políticas de tienda, permisos de sistema y habrán bloqueado las APKs antiguas.
• Un protocolo de legado digital debe garantizar su funcionamiento a 30 años vista sin obsolescencia.
• Un archivo HTML5 estándar con la Web Crypto API de la W3C funcionará de forma perpetua en cualquier navegador de cualquier ordenador o teléfono (Windows, Mac, Linux, Android, iOS) sin depender de tiendas ni actualizaciones del sistema operativo.

3. ¿Qué ocurre si la memoria USB física se rompe o se degrada?

Respuesta: El sistema incorpora redundancia por capas:

• Auditoría de Bit-Rot (SHA-256): Detecta la degradación magnética de la memoria mediante verificación de huella digital en 1 clic.
• Espejo Cifrado en la Nube: Respaldo automático cifrado con AES-256-GCM mediante START/sincronizar_drive.ps1 (respaldando en Google Drive).
• Próxima Integración con Otras Nubes: El soporte para sincronización automatizada con Proton Drive, Nextcloud, Microsoft OneDrive y Dropbox está formalmente en hoja de ruta y se incorporará en las próximas versiones.

⚖️ Aviso Legal y Sucesorio

Conforme al Código Civil y al Art. 96 de la Ley Orgánica 3/2018 (LOPD-GDD):
Este sistema y sus reportes impresos constituyen exclusivamente un inventario informativo privado de ayuda y coordinación familiar. No constituyen un testamento formal ni confieren facultades para disponer de cuentas bancarias o transferir activos con anterioridad a la formal adjudicación de herencia y liquidación tributaria ante los organismos competentes.