El panel de espacios de trabajo

Páginas

Cada página existe en inglés bajo /en y en árabe bajo /ar. El panel se abre en /en/dashboard tras el inicio de sesión en /en/auth/signin. La barra lateral tiene dos columnas: el espacio de trabajo, para los miembros de un espacio, y la administración de la plataforma, para el personal de la plataforma. Cada fila se muestra solo cuando la cuenta con sesión iniciada tiene su permiso en el espacio de trabajo en el que trabaja.

• Activity (/en/dashboard/activity, audit.read) se abre desde los enlaces View all activity del resumen y desde la campana. Archived projects (/en/dashboard/projects/deleted, projects.read) se abre desde la lista de proyectos.
• El menú de la cuenta al pie de la barra lateral contiene My profile y Preferences (Settings, en sus pestañas Profile y Notifications) y Sign out. Debajo, Documentation abre el /docs del sitio web (NEXT_PUBLIC_WEBSITE_URL), y Platform admin aparece para las cuentas que tienen un permiso de plataforma.
• La barra superior contiene el recorrido de la página, la búsqueda (Ctrl K, o Cmd K en Mac), el selector de idioma, el selector de tema y la campana.
• Una página abierta por su dirección sin el permiso muestra Access required: "Your role in this workspace does not include this page." La API rechaza las mismas peticiones sea lo que sea que muestre la pantalla.
• Una cuenta sin espacio de trabajo es enviada al alta inicial, o a la administración de la plataforma cuando es personal de la plataforma.

• Equipo y roles
• Administración de la plataforma

Iniciar sesión y registrarse

• Todos inician sesión en la misma página, /en/auth/signin, con un correo y una contraseña: tanto los miembros de un espacio de trabajo como el personal de la plataforma. Las cuentas de ejemplo están listadas en la guía de instalación.
• Remember me está marcado por defecto y mantiene la sesión durante 30 días; desmárcalo y la sesión termina a las 12 horas. Cuando la API rechaza una sesión, el panel cierra la sesión y abre la página de inicio de sesión.
• Un correo incorrecto y una contraseña incorrecta muestran el mismo mensaje, "That email and password do not match an account." Tras RATE_LIMIT_LOGIN inicios de sesión fallidos (10 en .env.example) desde una dirección en 15 minutos, la API rechaza todo intento desde ella, también con la contraseña correcta, hasta que el fallo más antiguo cumple 15 minutos, y el formulario dice "Too many failed sign-in attempts. Wait 15 minutes, then try again."
• Create an account (/en/auth/signup) pide un nombre completo, un correo de trabajo, una contraseña de al menos 8 caracteres y los Terms. La cuenta nueva inicia sesión y pasa al alta inicial. Una dirección puede iniciar 10 registros por hora; pasado eso, y mientras la plataforma tiene New sign-ups desactivado, el formulario muestra la propia frase de la API.
• Forgot password? (/en/auth/forgot-password) responde igual tenga o no cuenta el correo, y envía un enlace a /en/auth/reset-password que funciona una vez y caduca en una hora. Sin SMTP_HOST, el mensaje, con su enlace, se escribe en el registro de la API.
• La página de inicio de sesión enlaza a las páginas Privacy y Terms del sitio web (NEXT_PUBLIC_WEBSITE_URL).
• Con los datos de ejemplo integrados, sin API, entra cualquier contraseña: consulta Datos de ejemplo.

• El inicio de sesión falla
• Ajustes de correo

Crear un espacio de trabajo

/en/onboarding crea un espacio de trabajo en tres pasos. Una cuenta nueva llega aquí tras el registro, y cualquier cuenta lo abre de nuevo desde Create workspace en el selector de espacios de trabajo.

El creador pasa a ser el propietario del espacio de trabajo. Un espacio nuevo empieza en Starter, marcado como prueba durante el ajuste Trial length de la plataforma (14 días como se carga, leído del GET /api/public-settings público de la API, de modo que el alta inicial indica la duración antes de que exista el espacio), con la matriz de roles por defecto, y cada invitación se envía por correo (o se escribe en el registro de la API). Facturación muestra la fecha de fin de la prueba. Cuando pasa sin un plan de pago, el espacio de trabajo queda con el pago vencido y empieza el periodo de gracia, como tras un pago fallido.

Mientras el personal de la plataforma tiene New sign-ups desactivado, la API rechaza tanto el registro como un espacio de trabajo nuevo, y el formulario, o el paso de revisión del alta inicial, dice "New sign-ups are closed on this platform right now."

• Facturación y planes

Cambiar de espacio de trabajo

• El bloque en la parte superior de la barra lateral muestra el nombre y el plan del espacio de trabajo. Su menú lista cada espacio al que pertenece la cuenta, con Create workspace debajo. El propietario de ejemplo, owner@northstack.example, es propietario de Forma Studio y administrador de Monogram.
• Elegir uno descarta todo lo mostrado para el espacio anterior y recarga las páginas para el nuevo, así que ninguna fila de un espacio se muestra nunca bajo otro. La elección se guarda en la cuenta, y el siguiente inicio de sesión abre el mismo espacio.
• El rol es por espacio de trabajo: la misma persona puede ser propietaria de uno y miembro de otro, y la barra lateral sigue el rol del espacio elegido.

El resumen

El Reporting period (Last 7 days, Last 30 days o Last 90 days, 30 por defecto) acota los proyectos que necesitan atención y la actividad reciente; el gráfico semanal conserva sus propios siete días. El periodo se guarda en la dirección (?period=7d). New project aparece para los miembros que tienen projects.write.

Búsqueda y campana

• La búsqueda (Ctrl K o Cmd K) encuentra páginas y, desde dos caracteres escritos, los proyectos, tareas y miembros del espacio de trabajo, cinco de cada uno. Los proyectos y las tareas aparecen solo para los miembros que tienen projects.read. En la administración de la plataforma busca organizaciones.
• La campana lista los ocho últimos eventos del espacio de trabajo con el número de no leídos desde la última vez que quien lee pulsó Mark all read, y se actualiza cada minuto. Muestra los mismos eventos que la actividad reciente del resumen: todos con projects.read o audit.read, los eventos de facturación para un rol que solo lee facturación, y ninguno en caso contrario. View all activity abre el registro de actividad para los miembros que tienen audit.read.

El registro de actividad

Cada cambio en un espacio de trabajo escribe un evento: proyectos, tareas, archivos, invitaciones, miembros, roles, ajustes, claves de API, facturación y las sugerencias aplicadas del asistente. /en/dashboard/activity los lista del más reciente al más antiguo, diez por página, para los miembros que tienen audit.read (el propietario y los administradores tal como se cargan).

• Filtros: una búsqueda, Action (uno de los grupos de arriba), Person, y fechas From y To. Reset los borra. Cada filtro se guarda en la dirección.
• Export CSV descarga todos los eventos que cumplen los filtros como <workspace-address>-activity.csv, con las columnas date, actor, action, subject y details. Un valor que empieza por =, +, - o @ se escribe con una comilla inicial para que una hoja de cálculo no lo ejecute.

Ajustes

Settings (/en/dashboard/settings) tiene cinco pestañas, y la abierta se guarda en la dirección (?tab=profile). Todos los miembros lo abren; lo que pueden cambiar depende de su rol.

• Email notifications activa o desactiva los correos de facturación: un pago fallido, una prueba terminada, un cambio de plan pagado y un cambio programado aplicado en la renovación, enviados al propietario, a los miembros de facturación y al correo de facturación del espacio de trabajo. Las invitaciones, los restablecimientos de contraseña y los recibos de licencia se envían siempre.
• Weekly digest envía a cada miembro activo un resumen de la semana pasada, los lunes desde las 08:00 UTC, una vez por espacio de trabajo y semana. Las cifras de proyectos y tareas van solo a los roles con projects.read, y el recuento de actividad sigue lo que el rol puede ver. El primer resumen de un espacio de trabajo cubre su primera semana completa, y en una instalación nueva el primer ciclo solo marca la semana actual y no envía nada, así que los primeros resúmenes salen el lunes siguiente.
• Cada correo se redacta en el idioma del propio destinatario, o en el del espacio de trabajo cuando no ha elegido ninguno. El idioma de las pantallas es siempre el de la dirección. Sin ajustes SMTP, la API escribe cada correo en su registro.
• Delete workspace, en la Danger zone, es solo del propietario: escribe el nombre del espacio de trabajo y tu contraseña. La API cancela entonces su suscripción de Stripe, si la tiene, sin abono por los días restantes, y marca el espacio de trabajo como eliminado (una eliminación lógica): todos los miembros pierden el acceso, sus claves de API dejan de funcionar, desaparece de cada lista y selector, sus filas siguen en la base de datos y su dirección sigue ocupada. Si no se puede contactar con Stripe, no se elimina nada, y un aviso indica que lo intentes de nuevo en unos minutos.
• El nombre de marca, el logotipo y los colores no se definen aquí: vienen de los archivos de marca del panel.

• Claves de API y la API pública
• Marca

Idioma y tema

La barra superior alterna entre inglés y árabe (las páginas en árabe van de derecha a izquierda) y entre el tema claro y el oscuro. El tema sigue el ajuste del equipo hasta que se cambia, y la elección se guarda en ese navegador.

• Idiomas

Cómo encaja el código del panel