OASIS_MOBILE/CONTEXT/00_INDICE.txt
SITO 3a3563f2a0 feat: merge Oasis 0.7.6 upstream — Graphos, E2E, peers/stats, AUTOMATIZACION
Cambios aplicados desde epsylon/oasis 3d46340 (0.7.6):

NUEVO MÓDULO Graphos (mapa interactivo de la red):
- src/views/graphos_view.js (nuevo)

LÓGICA:
- src/backend/nameCache.js (nuevo) — NameAuthor resolver
- src/models/chats_model.js — encriptación E2E
- src/models/calendars_model.js — E2E + calendar invites con códigos
- src/models/maps_model.js — E2E + CLOSED enforcement
- src/models/tribes_model.js — sub-tribe access control (PRESERVA nuestro inviteLog)
- src/models/tribe_crypto.js — soporte E2E
- src/models/main_models.js — refactor (PRESERVA nuestro pub-invite SSB msg)
- src/models/{activity,banking,pads,search,stats,tags,tribes_content}_model.js
- src/backend/backend.js — searchModel constructor + new helpers (errorView, safeRefererRedirect)
- src/backend/blobHandler.js, renderTextWithStyles.js
- src/views/main_views.js — añadido userLink/userLinkLabel + nameCache import (mantiene nuestro hamburger menu)

VISUAL:
- 31 views actualizadas con refactor a userLink helper
- src/views/peers_view.js — tabla con keys clicables
- src/views/stats_view.js — dashboard avanzado
- src/client/assets/styles/style.css — merge (preserva nuestras adiciones QR/mobile)
- Temas desktop: Clear, Dark, Matrix, Purple
- Translations 11 idiomas (ar, de, en, es, eu, fr, hi, it, pt, ru, zh)
- src/configs/{config-manager,oasis-config}, server/SSB_server.js, oasis_client.js

SKIPS (intencionalmente):
- OasisMobile.css del upstream (mantenemos NUESTRO mobile.css y theme)
- main_views.js menu reorganization (mantenemos hamburger nav)
- @xenova/transformers (LLM, no viable mobile)
- node-llama-cpp (build nativo no soportado en arm64 mobile)
- pdfjs-dist (pendiente probar luego)
- AI/embedder.js + AI/routes_index.js (dependen de las libs LLM)

server/package.json: version 0.7.5 → 0.7.6

AUTOMATIZACIÓN:
- Nueva carpeta AUTOMATIZACION/ con 10 archivos:
  - 4 opciones (cron simple, multi-agente, GitHub Actions, webhook)
  - Setup Debian completo paso a paso
  - Scripts bash listos: scout, merger, builder, notify-telegram
  - Prompts listos para los agentes
  - Sección /testing-app para 0asis.net
  - Human-in-the-loop: archivos prohibidos para auto-merge

PENDIENTE: build APK (el bash tool tuvo timeouts; usar comandos
de CONTEXT/cambio_apk_repack.txt manualmente).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-15 19:41:45 +02:00

109 lines
4.8 KiB
Text
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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