Guías

Personas, roles y revisiones

Invita a personas al admin, dales roles por sitio y deja que los editores aprueben lo que publican los autores y sus agentes.

Personas, roles y revisiones

Las personas llegan a Hollware por el admin, en /admin/. Inician sesión con una passkey: no hay contraseñas.

Roles

Una persona tiene un rol en cada sitio del que es miembro:

RolPuede
ownertodo, incluidos los tokens y las invitaciones
editorleer, escribir y publicar, y aprobar revisiones
authorleer y escribir; lo que publica espera la aprobación de un editor

Un token nunca hace más que el rol actual de su persona: bajar el rol de alguien les quita los scopes a sus tokens al instante.

En el admin, en Personas, un dueño le da otro rol a un miembro, o lo quita del sitio junto con cada token y aplicación que tenía en él. Un sitio siempre conserva un dueño: haz dueña a otra persona antes de que el último deje de serlo.

Invita a alguien

En el admin, en Personas, invita a un editor o a un autor. Recibes un enlace, válido una sola vez y por siete días, en el que la persona configura su passkey. Desde la línea de comandos:

npx hollware invite --role author --remote

Un dueño que necesita una passkey en un dispositivo nuevo obtiene un enlace de configuración con hollware invite --owner.

Revisiones

Cuando alguien sin content:publish llama a publish, la entrada no se publica. En su lugar se abre una revisión, con la versión que pidió, que espera en el admin, en Revisiones.

Un editor ve el diff contra lo que está publicado y el veredicto de los contratos, y luego:

  • la aprueba: los contratos se ejecutan de nuevo, como los ejecuta publish, y Hollware publica esa versión a nombre del editor;
  • pide cambios, con una nota que el autor y su agente leen con list_reviews: guardan una versión nueva y la vuelven a pedir;
  • la rechaza, con el motivo (reject_review): ese cambio no se publicará, y la revisión se cierra como rejected. La entrada queda como estaba; para descartar también el borrador, restaura desde su historial la versión que muestra el sitio.

Una nueva versión de la entrada cancela su revisión pendiente, y el autor vuelve a pedirla: una aprobación siempre corresponde a lo que vio el editor.

Tu nombre

Cada persona cambia su propio nombre en Tu cuenta: lo muestran sus revisiones, las revisiones que pide y sus comentarios. Nadie más puede cambiarlo, ni siquiera un dueño. La misma página renombra sus passkeys, como "Portátil del trabajo", y elimina una que perdió.

Varios sitios

Una persona tiene una sola passkey para todo el despliegue y un rol en cada sitio. En el admin, cambia de sitio desde el encabezado; el permiso de un agente es para un sitio, elegido en la página de consentimiento.