OASIS_MOBILE/CONTEXT/00_INDICE.txt
SITO d3fc961649 docs: rename APK with date oasis-v0.7.4-20260502-pruebas.apk
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-02 17:54:22 +02:00

95 lines
4.2 KiB
Text

===============================================================
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
--------------------------------------------------------------
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/