docs: update CONTEXT with current state, architecture and Android Studio guide

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
SITO 2026-04-29 01:13:52 +02:00
parent b48944ef57
commit ae7f0c1a4a
4 changed files with 209 additions and 152 deletions

View file

@ -1,57 +1,89 @@
===============================================================
PROXIMOS PASOS Y TAREAS PENDIENTES
PROXIMOS PASOS Y TAREAS PENDIENTES (2026-04-28)
===============================================================
--------------------------------------------------------------
CRITICO — PENDIENTE
--------------------------------------------------------------
[ ] Resolver conectividad al servidor Gitea (code.03c8.net:3000)
-> Comprobar firewall del servidor: ufw allow 3000/tcp
-> Verificar que Gitea corre: systemctl status gitea
-> Una vez conectado: git push -u origin master && git push -u origin test
-> Comprobar firewall: ufw allow 3000/tcp
-> Verificar Gitea: systemctl status gitea
-> Una vez resuelto: git push -u origin test
--------------------------------------------------------------
QR CODES — IMPLEMENTADO (commit 54ad8a1)
IMPLEMENTADO (commits 54ad8a1, 0fc10be, b48944e)
--------------------------------------------------------------
[x] QR en invite de tribe (renderInvitePage - tribes_view.js)
[x] QR en invite de pub SSB (snhInvite box - invites_view.js)
[x] QR en invite de tribe (tribes_view.js)
[x] QR en invite de pub SSB (invites_view.js)
[x] QR del ID SSB en perfil de usuario (inhabitants_view.js)
[x] CSS para los QR codes (style.css)
[x] inviteLog en tribes con trazabilidad completa (tribes_model.js)
[x] SSB msg type:'pub-invite' al aceptar pub invite (main_models.js)
[x] Filtro 'invites' en blockchain explorer (blockchain_model/view)
[x] renderInviteExtra() con tabla detallada en blockchain_view.js
[x] viewport-fit=cover para notch Android/iOS (main_views.js)
[x] mobile.css completo (480 lineas: safe-area, touch, QR lightbox)
[x] OasisMobile.css limpio (solo theming, sin duplicar mobile.css)
POSIBLES MEJORAS QR:
[ ] QR en vista individual de cada tribe (para compartir URL del tribe)
--------------------------------------------------------------
COMO CORRER EL PROYECTO
--------------------------------------------------------------
LOCALMENTE en tu maquina:
cd /home/sito/COFRE/CODERS/oasis_mobile/nodejs-project/nodejs-project
npm install (si no se ha hecho antes)
node main.js
Abre: http://localhost:3000
EN ANDROID STUDIO:
1. Abrir Android Studio
2. View -> Tool Windows -> Terminal
3. cd <ruta al proyecto>/nodejs-project/nodejs-project
4. node main.js
5. Abrir browser o emulador en http://localhost:3000
ALTERNATIVA (emulador Android):
- Compilar el APK Android que envuelve el Node.js
- El APK usa node-on-android para correr el servidor interno
- Requiere entorno Android SDK configurado
--------------------------------------------------------------
CLAUDE CODE EN ANDROID STUDIO
--------------------------------------------------------------
OPCION 1 (recomendada): JetBrains Plugin
- Android Studio -> Settings -> Plugins -> Marketplace
- Buscar: "Claude Code" o "Anthropic"
- Instalar y reiniciar
- Aparece como panel lateral en el IDE
OPCION 2: Terminal integrada de Android Studio
- View -> Tool Windows -> Terminal
- Ejecutar: claude (si Claude Code CLI esta instalado)
- Claude Code CLI: https://claude.ai/code
OPCION 3: Terminal externa
- Abrir una terminal normal (Konsole, GNOME Terminal)
- cd al proyecto y correr: claude
--------------------------------------------------------------
POSIBLES MEJORAS FUTURAS
--------------------------------------------------------------
[ ] QR en vista individual de cada tribe (para compartir URL)
[ ] Boton "Copiar codigo" junto al QR de invite
[ ] QR para cada pub activo en la tabla de pubs
[ ] QR en la pagina de perfil propio (/settings o similar)
[ ] Testing: arrancar la app y verificar que los QR se renderizan
[ ] Comprobar que inviteLog se persiste correctamente en SSB
--------------------------------------------------------------
OTRAS FEATURES A EXPLORAR
COMPARACION CON UPSTREAM
--------------------------------------------------------------
[ ] Revisar si hay mas vistas donde tenga sentido el QR
[ ] Testing: arrancar la app y verificar que los QR se renderizan
[ ] Revisar tribes_view.js linea 1361 (hay un inviteCode en query param
que tambien podria mostrar QR)
github.com/epsylon/oasis -> version basica (~15 vistas)
Local -> version avanzada (43 vistas, IA, blockchain, etc.)
CONCLUSION: No hay que actualizar desde upstream.
El local ya es mas completo.
--------------------------------------------------------------
COMO RETOMAR EN NUEVA SESION
--------------------------------------------------------------
1. Abrir este directorio: /home/sito/COFRE/CODERS/oasis_mobile/
1. Abrir: /home/sito/COFRE/CODERS/oasis_mobile/
2. Leer CONTEXT/01_PROYECTO.txt para orientarse
3. Leer CONTEXT/02_QR_IMPLEMENTACION.txt para ver lo implementado
4. Leer CONTEXT/03_GIT_ESTADO.txt para el estado del repo
5. El codigo fuente esta en:
nodejs-project/nodejs-project/src/
ARCHIVOS MODIFICADOS:
src/views/tribes_view.js
src/views/invites_view.js
src/views/inhabitants_view.js
src/client/assets/styles/style.css
--------------------------------------------------------------
NOTAS
--------------------------------------------------------------
- La APK original esta en: /home/sito/Downloads/oasis-v0.6.8.apk
- El ZIP con el source esta en: assets/nodejs-project.zip
- El source extraido esta en: nodejs-project/nodejs-project/
- Para probar la app hay que tener Node.js + npm install en el proyecto
3. El codigo esta en: nodejs-project/nodejs-project/src/
4. git log --oneline para ver el estado actual