Documentación · Guías

Workspace

Workspace administra la organización activa. Ábrelo desde Workspace en la cabecera (por defecto Miembros).

Barra lateral de Workspace

La barra Workspace a la izquierda lista Miembros, Invitaciones, tokens API, Campos personalizados y Actividad. En escritorio puedes contraerla a una mini-barra solo con iconos; el avatar o la inicial de la organización sigue visible en la cabecera. Pasa el cursor o enfoca un icono para leer su etiqueta en un tooltip. El estado de contracción se guarda por navegador y es independiente de las barras de proyecto o usuario.

Miembros (/workspace/members)

La pantalla comparte el sistema visual de Invitaciones: breadcrumb mono workspace / miembros, título, subtítulo que explica los roles, y la acción Invitar miembros que enlaza a /workspace/invitations (sin exportar CSV).

Propietarios y administradores pueden:

  • Buscar por nombre o email desde el slot de búsqueda de la barra de filtros compartida (lado del servidor, sin distinguir mayúsculas, con debounce)
  • Agregar un filtro Rol desde Agregar filtro: un chip de selección múltiple sobre Propietario, Administrador, Miembro y Lector. Los roles seleccionados se combinan con OR (role=admin,owner); la búsqueda y el chip de rol se combinan con AND en el servidor; el contador N de N muestra cuántas filas coinciden. El estado del filtro vive en la URL y cualquier cambio reinicia a la página 1
  • Revisar columnas Miembro (foto de perfil si existe; si no, avatar con iniciales; nombre del perfil o derivado del email; email completo; badge TÚ en tu fila), Rol (chip), En la organización desde (fecha absoluta y sublínea relativa), Acciones
  • Cambiar el rol con el control inline por fila (PATCH /api/orgs/:orgUlid/members/:userUlid) — no se puede promover a propietario desde esta pantalla
  • Quitar miembros con el icono de papelera (DELETE) tras confirmación

No puedes quitarte ni degradarte a ti mismo, y el único propietario no puede ser eliminado ni degradado (la API responde 409 last_owner si se viola). Ascender a un viewer a un rol de pago se rechaza con 409 seat_limit_exceeded cuando la organización está en su límite de puestos; un viewer nunca consume un puesto, y degradar a un miembro libera uno para la próxima invitación o ascenso.

Invitaciones (/workspace/invitations)

La pantalla sigue el mock del producto: breadcrumb mono workspace / invitaciones (sin título h1 aparte), tarjeta Nueva invitación con icono de correo en el campo email, y la sección Historial de invitaciones. La barra de filtros del historial ofrece un campo de búsqueda (correo del invitado, lado del servidor y con debounce) más chips Estado y Rol desde Agregar filtro: cada uno de selección múltiple que escribe parámetros separados por coma (status=pending,expired). Los valores se combinan con OR dentro de un chip y con AND entre la búsqueda y ambos chips; cualquier cambio reinicia a la página 1. Los filtros del historial no afectan el formulario de invitación.

Owners y admins pueden:

  1. Indicar correo y rol (admin, member o viewer) y enviar; el enlace es /invite/:token.
  2. Revisar columnas Email · estado (icono de correo por fila, texto de estado, chip de rol), Invitado por (avatar con iniciales, nombre visible y correo del invitador), Enviada y Expira (fecha absoluta y sublínea relativa cuando aplica).
  3. En filas Pendiente, usar iconos Reenviar (POST .../invitations/:ulid/resend, rota el token y reenvía el correo) o Revocar (DELETE).

Etiquetas de estado cortas (Pendiente, Vencida, etc.). Los avatares del invitador usan iniciales del correo (sin foto de perfil en v1).

Límites: una invitación pendiente por correo y org; máximo 50 pendientes; vencen a los siete días.

Tokens de API (/workspace/api-tokens)

La pantalla comparte el sistema visual de Invitaciones y Miembros: breadcrumb mono workspace / tokens de API (segmento actual en acento), título y descripción.

Propietarios y administradores pueden:

  1. Crear un token desde la tarjeta Nuevo token: campo Nombre (estilo bg-input), selector Organización con el FormSelect compartido (limitado a tus membresías) y botón de acento Crear token con icono de llave.
  2. Copiar el secreto en texto claro del panel ámbar de revelación única justo después de crear (cerrar con Cerrar); el secreto no vuelve a mostrarse.
  3. Buscar tokens por nombre y acotarlos con el chip Último uso (Usado / Nunca) desde la barra de filtros compartida. La lista está paginada; el estado del filtro vive en la URL y cualquier cambio reinicia a la página 1. La petición siempre se acota a la organización activa en el servidor.
  4. Revisar tokens activos en una tabla con columnas Nombre, Creado (fecha absoluta y sublínea relativa), Último uso (fecha dual o Nunca si no se usó) y Acciones.
  5. Revocar con el icono de papelera (DELETE /api/v1/me/api-tokens/:ulid) tras confirmación.

No hay columna de organización por fila (la pantalla está acotada a la organización activa). La lista muestra estados distintos de carga, vacío, error y vacío-filtrado.

Campos personalizados (/workspace/custom-fields)

Propietarios y administradores definen campos de metadatos (sistema y personalizados) y a qué proyectos aplica cada uno. Guía detallada: Campos personalizados (Workspace).

Adjuntos (/workspace/attachments)

Cualquier miembro puede monitorear el uso de almacenamiento y explorar todos los archivos que la organización ha subido, en todas las superficies de adjuntos. Propietarios y administradores además pueden seleccionar archivos y eliminarlos en lote. Guía detallada: Adjuntos (Workspace).

Actividad (/workspace/activity)

Propietarios y administradores pueden revisar un feed append-only de cambios de dominio (proyectos, casos, miembros, invitaciones, tokens de API, etc.). Más detalle en Actividad del workspace en la documentación del producto.

Más guías