===============================================================
  CONTEXT — INDICE DE DOCUMENTACION
  Oasis Mobile | Actualizado: 2026-05-02
===============================================================

Lee esto primero. Cada archivo cubre un area.

--------------------------------------------------------------
FICHEROS DE ESTADO DEL PROYECTO
--------------------------------------------------------------

  01_PROYECTO.txt
    Que es el proyecto, stack tecnico, estructura de carpetas,
    comparacion con el upstream publico, historial de commits.
    Lee esto al inicio de cualquier sesion nueva.

  03_GIT_ESTADO.txt
    Estado de las ramas git, commits, archivos modificados,
    problema de conectividad al remoto, comandos de push.

  04_ARQUITECTURA.txt
    Arquitectura completa: backend Koa, modelos SSB, las 43 vistas
    Hyperaxe, sistema CSS, blockchain SSB. Lista todos los archivos.

  05_PROXIMOS_PASOS.txt
    Tareas pendientes, como correr el proyecto localmente y en
    Android Studio, como instalar Claude Code en Android Studio.

--------------------------------------------------------------
FICHEROS DE CAMBIOS (documentan lo que se modifico y por que)
--------------------------------------------------------------

  02_QR_IMPLEMENTACION.txt
    Resumen de donde estan los QR codes en la app y que libreria
    se usa. Indice rapido con numeros de linea.
    Para detalle tecnico leer: cambio_qr.txt

  cambio_qr.txt
    Documentacion tecnica completa de los QR codes.
    - Como funciona cada funcion (renderInvitePage, invitesView,
      renderInhabitantCard, inhabitantsProfileView)
    - Por que el IIFE async en invites_view
    - CSS para los QR en cada tema
    - Que puede gustar / que puede no gustar del diseño

  cambio_invites_trazabilidad.txt
    Documentacion del sistema de trazabilidad de invites.
    - inviteLog en tribes_model.js (estructura, generateInvite, joinByInvite)
    - SSB message type 'pub-invite' en main_models.js
    - renderInviteExtra en blockchain_view.js
    - Que puede gustar / que puede no gustar

  cambio_visual_movil.txt
    Documentacion de todos los cambios CSS para movil.
    - mobile.css: safe area, layout, filtros horizontales,
      botones, QR lightbox, overrides grid inline
    - OasisMobile.css: por que se reescribio, que se quito
    - main_views.js: viewport-fit=cover y por que importa
    - style.css: que se añadio al final

  cambio_hamburger_nav.txt
    Documentacion del menu hamburger movil y navegacion.
    - Estructura HTML completa del menu (sidebar-panel, quicklinks)
    - Mecanismo CSS puro: checkbox + selector ~ sin JS
    - display:contents en desktop para preservar layout izquierda|main|derecha
    - Botones de grupo redondeados, acordeon colapsado por defecto
    - QR en pubs de invites_view.js (renderPubTable async)

  cambio_apk_repack.txt
    Como reempaquetar el APK con los cambios CSS/JS para instalar en Android.
    - Metodo correcto: modificar SOLO assets/nodejs-project.zip en el APK original
    - Por que falla si se reempaqueta todo (resources.arsc debe ser STORED)
    - Comandos exactos: zip -d META-INF, zip -0, zipalign, apksigner
    - Keystore: /home/sito/oasis-release-key.jks (alias: oasis, pass: oasis123)
    - APK actual: /home/sito/oasis-v0.7.4-20260502-pruebas.apk (132 MB)
    - Tabla de desglose de peso incluida

--------------------------------------------------------------
TAREAS PENDIENTES
--------------------------------------------------------------

  tareas_usabilidad.txt
    Tareas de UX/usabilidad pendientes de implementar.
    - Tarea 1: aplicar paginador CSS-only ‹ › al resto de submenús
      (inventario completo: 8 con paginador, 24 pendientes,
      5 que no lo necesitan).
    - Tarea 2: revisar mode-buttons-cols/row en forum/feed.
    - Tarea 3: uniformar header en vistas de detalle.
    - Tarea 4: revisar formularios largos en móvil.
    - Tarea 5: considerar punto de quiebre 600px para tablet.

--------------------------------------------------------------
NOTA PARA EL DEVELOPER
--------------------------------------------------------------

  Los archivos cambio_*.txt estan escritos para que puedas
  verificar cada decision mirando el codigo.
  Cada seccion indica archivo y numero de linea aproximado.

  Cosas que puede valer la pena revisar en persona:
  - El IIFE async en invites_view.js (linea 121) — funciona pero es raro
  - Los overrides [style*="..."] en mobile.css — fragiles, mejor refactorizar
  - El inviteLog guardado en el SSB message del tribe — crece con el tiempo
  - viewport-fit=cover en main_views.js — probar en dispositivo real con notch
  - El selector div generico que se eliminó en OasisMobile.css — revisar
    que ningun componente dependa del fondo oscuro de ese selector

  Todo el codigo modificado esta en:
    nodejs-project/nodejs-project/src/
