Apps: Panorama

Una App es un sitio web que tu workspace publica y que Praxsuite aloja. Tiene su propia dirección, sus propias páginas y su propia navegación — y lee datos vivos del workspace a través del API Gateway, así que el sitio y el sistema que hay detrás nunca se separan.

La premisa es que tu negocio ya corre sobre Praxsuite. Una App es cómo expones una parte hacia afuera: un sitio de marketing, un portal de clientes, un catálogo, una landing de campaña, un área de miembros.

Un workspace, varias Apps

Las Apps no son un sitio único por workspace. Un workspace puede tener tantas como su plan permita, y son completamente independientes entre sí — páginas propias, navegación propia, dirección propia, visibilidad propia.

Eso importa más de lo que parece. Una agencia lleva una App por marca. Un equipo de producto corre un sitio público de marketing y un portal privado de clientes en paralelo, sobre las mismas tablas, sin que ninguno sea una sección del otro.

De qué se compone una App

Páginas

Cada URL es una página, y las páginas anidan — una página puede tener padre, que es cómo /docs/primeros-pasos vive debajo de /docs.

Una página tiene un tipo:

Los tipos dinámicos son la razón por la que una App se mantiene sincronizada con el workspace. No publicas una página por producto: publicas una plantilla de detalle, y cada fila de la tabla queda alcanzable a través de ella.

Una página también tiene un estado — borrador, publicada o archivada — y, aparte de eso, dos cuerpos: el que se sirve a los visitantes y el borrador que estás editando. Editar una página publicada no cambia lo que ve el mundo hasta que la publicas. Conviene interiorizarlo temprano, porque es lo contrario de cómo se comportan la mayoría de los editores.

Quién puede verla

La visibilidad se define en la App:

La autenticación no es un sistema aparte: una App cerrada autentica gente como end users del gateway, las mismas cuentas documentadas en End Users y Roles. La App lleva una credencial de gateway para esto, y a un visitante sin sesión se lo manda a la ruta de login de la App — /login salvo que la cambies — y se lo devuelve a donde iba después.

Mixta es el modo que la mayoría de los portales realmente quiere. Una home y una página de precios públicas, un área de miembros detrás, un solo sitio.

La dirección

Cada App recibe un subdominio de inmediato:

https://{subdominio}.praxsuite.app

Encima de eso podés apuntar tus propios dominios. Cada uno se verifica antes de entrar en servicio, y su certificado se emite solo — los dos pasos reportan su propio estado, así que un dominio que todavía no sirve te dice cuál de las dos mitades está pendiente:

Una App con varios dominios tiene uno marcado como primario. Ese es al que apuntan los enlaces canónicos, que es lo que evita que un buscador trate la misma página en dos hostnames como dos páginas distintas.

Publicar

Publicar es un acto explícito, y produce una versión. El historial de versiones es la lista de todo lo que el sitio fue, y podés volver a cualquier entrada — volver atrás es publicar una versión anterior, no borrar las posteriores.

La App además tiene su propio estado: borrador, publicada, mantenimiento o deshabilitada. Mantenimiento es el que conviene cuando querés que la dirección siga respondiendo mientras trabajás, sin servir un sitio a medio hacer.

Idiomas

Una App declara un idioma por defecto y el conjunto de idiomas que sirve, y elige cómo aparece el idioma en la URL:

También puede detectar el idioma del visitante desde su navegador en la primera visita, y mostrar un selector. El prefijo de ruta es el default y el que mejor manejan los buscadores.

Lo que no es

Las Apps son estáticas primero. Lo que publicás se sirve como archivos, y nada tuyo se ejecuta en un servidor mientras un visitante carga una página. Los componentes reutilizables son lo único que se compila, y eso pasa cuando los guardás — nunca por request.

Es un intercambio deliberado. Significa que una App publicada es rápida, barata de servir y difícil de romper. También significa que todo lo dinámico — leer filas, enviar un formulario, mostrar algo solo al visitante autenticado — ocurre desde el navegador a través del API Gateway, con una clave publicable acotada exactamente a lo que ese sitio puede ver.

Si necesitás lógica corriendo en un servidor, para eso están las automatizaciones: la App llama a un endpoint, la automatización hace el trabajo con credenciales que el navegador nunca ve, y devuelve una respuesta.

Siguiente

• Páginas y navegación — armar el árbol de páginas y los menús encima

• Datos y formularios — conectar una App a las tablas del workspace vía gateway

• Publicación y versiones — el flujo de publicar en detalle

• Dominios — apuntar un dominio y leer su estado

• Destinos de deploy — publicar la misma App también en otro lado