Reflects: visión técnica

Documentación técnica Actualizado 24 jun 2026

Resumen

Reflects es un producto pre-desarrollo de notas/widgets personales que reutiliza Folks SSO, vault v3pin, sync Drive y el editor Markdown híbrido de Desk.

Qué es Reflects

Un espacio para combinar notas Markdown con widgets embebidos (gráficos, datos en vivo, bloques interactivos). Privacidad alineada a Kalista: datos cifrados en la nube del usuario, no en servidores zolski.net.

Modos de edición: RAW / SPLIT / RENDER

Modo	Comportamiento
RAW	Solo fuente Markdown
SPLIT	Editor + preview lado a lado (como wiki Desk)
RENDER	Vista lectura sin chrome de edición

El editor wiki actual (desk-wiki-editor.js) es la base técnica prevista.

Sistema de widgets

Bloques delimitados en Markdown o frontmatter.
Widget API: contrato JSON + sandbox de render.
Casos: métricas Splora inline, tablas Kalista read-only exportadas, embeds estáticos.

Protocolo y sandbox aún no implementados — decisiones abiertas.

Reutilización del ecosistema

Componente	Reuso
Folks SSO	Cookies `.zolski.net`
Vault v3pin	Mismo modelo KALV o variante `.ref`
Drive sync	Carpeta `zolski.net - User Data/Reflects/`
Markdown	Pipeline Python-Markdown + marked/DOMPurify

Decisiones abiertas

Vault compartido con Kalista vs archivo .ref separado.
Organización: carpetas Drive vs índice en Postgres (solo metadatos).
Widget trust model: iframe sandbox vs Web Components firmados.

Estado

Pre-desarrollo — documento de visión; sin deploy en Railway.