Proyectos, tableros y tareas

Qué contiene un proyecto, la lista de proyectos y sus filtros, el tablero de tareas con arrastrar y soltar y movimientos con el teclado, qué contiene una tarea, los archivos del proyecto, y archivar y restaurar.

Para el paquete Full Stack

Qué contiene un proyecto

Parte	Valores
Nombre y descripción, en inglés y en árabe	El nombre en inglés es obligatorio (hasta 120 caracteres); el nombre en árabe y ambas descripciones son opcionales. Una página en árabe muestra el texto en árabe cuando lo hay, y el inglés en caso contrario.
Responsable	Un miembro del espacio de trabajo. El panel lateral ofrece a todos los miembros excepto Billing; el responsable de un proyecto nuevo es su creador salvo que se elija a otro.
Fecha de entrega	Opcional. El resumen lista los proyectos abiertos con vencimiento dentro de su periodo en Projects needing attention.
Estado	In progress (el valor por defecto), Review, Blocked o Completed. In progress, Review y Blocked cuentan como activos.
Progreso	De 0 a 100, definido a mano en Project settings; al poner el estado en Completed pasa a 100.
Tablero	Sus tareas, en cuatro columnas: Backlog, In progress, Review y Done.
Archivos	Archivos subidos de hasta 10 MB cada uno.

El espacio de trabajo de ejemplo, Forma Studio, tiene 12 proyectos (6 en curso, 1 en revisión, 1 bloqueado y 4 completados) con sus tableros, y un proyecto archivado, Pilot dashboard, para que el archivo tenga algo que restaurar.

La lista de proyectos

/en/dashboard/projects lista los proyectos del espacio de trabajo, siete por página, el actualizado más recientemente primero, para los miembros que tienen projects.read.

Tres pestañas con sus recuentos: All projects, Active y Completed.
Filtros: una búsqueda en los nombres y descripciones, Status, Owner (los miembros que son responsables de un proyecto) y Due date (con vencimiento en el día elegido o antes). Reset los borra. La pestaña, los filtros y la página se guardan en la dirección.
Columnas: Project, Status, Owner, Progress, Due date, y un menú de acciones con Open, Edit y Archive.
New project abre el panel lateral del proyecto. Archived abre los proyectos archivados.

Crear y editar un proyecto

New project, en la lista de proyectos y en el resumen, abre un panel lateral con el nombre y la descripción (una pestaña en inglés y otra en árabe cada uno), el responsable, la fecha de entrega y el estado; Create project lo guarda y abre su página. En la página de un proyecto, Project settings abre el mismo panel con Progress (%) además. Cerrar el panel con cambios sin guardar pregunta antes.

Crear, editar, archivar y restaurar requieren projects.write (propietarios, administradores y miembros tal como se cargan).
Cuando el periodo de gracia de un espacio de trabajo con pago vencido (BILLING_GRACE_DAYS, 7 días en .env.example) se ha agotado, o cuando su suscripción está cancelada, un proyecto nuevo se rechaza con "The plan's limits are reached. Change the plan to add projects." Los proyectos existentes siguen funcionando.
Cada cambio se escribe en el registro de actividad: project.created, project.updated (con el estado del que y al que pasó), project.archived y project.restored.

El tablero de tareas

La página de un proyecto (/en/dashboard/projects/all/<id>) muestra su estado, responsable, fecha de entrega y progreso, y luego tres pestañas: Board, Activity y Files.

El tablero tiene cuatro columnas, Backlog, In progress, Review y Done, cada una con su recuento. Una tarjeta muestra el título, la prioridad, la persona asignada y la fecha de entrega de la tarea.
Arrastra una tarjeta a otra columna o a otro lugar de su columna. Con el teclado, pulsa Space para coger una tarea, las flechas para moverla, Space para soltarla y Escape para cancelar. El menú de cada tarjeta también tiene Edit, Move to y Archive. Un movimiento que la API rechaza devuelve la tarjeta a donde estaba.
View alterna entre Board y List, una tabla con la tarea, el estado, la prioridad, la persona asignada y la fecha de entrega.
Filtros: Search tasks, Assignee y Priority.
New task abre el panel lateral de la tarea. Los miembros sin projects.write ven el tablero y las tareas en solo lectura.

Qué contiene una tarea

Campo	Valores
Título y descripción, en inglés y en árabe	El título en inglés es obligatorio; cada título admite hasta 160 caracteres ("Keep the title to 160 characters."), y el título en árabe y ambas descripciones son opcionales.
Persona asignada	Un miembro del espacio de trabajo (el panel lateral ofrece a todos los miembros excepto Billing), o Unassigned.
Fecha de entrega	Opcional.
Prioridad	High, Medium (`normal`) o Low.
Estado	Backlog, In progress, Review o Done: la columna del tablero.

Archive en una tarjeta quita la tarea del tablero tras una confirmación; su historial queda en la actividad. Las tareas archivadas no tienen pantalla de restauración. Cada cambio de una tarea es un evento de actividad (task.created, task.moved, task.updated, task.archived), y el gráfico semanal del resumen los cuenta.

Archivos del proyecto

La pestaña Files lista los archivos de un proyecto del más reciente al más antiguo, con quién los subió, su tamaño y cuándo. Upload file acepta cualquier tipo de archivo de hasta 10 MB (projects.write); Download requiere projects.read.
Cada archivo subido se suma al almacenamiento del espacio de trabajo, que Facturación mide frente al plan.
Un archivo se guarda con un nombre aleatorio en el bucket de Cloudflare R2 cuando están definidas las cinco variables R2_*, y en caso contrario en el MEDIA_UPLOAD_DIR de la API (el volumen de datos con Docker), y se sirve desde esa dirección. Cualquiera que tenga la dirección de un archivo puede abrirlo, así que comparte los enlaces con cuidado.
Desde el propio disco de la API, un archivo que no sea una imagen, un PDF, texto plano, audio o vídeo, como un archivo HTML o SVG, se envía como descarga en lugar de abrirse en el navegador, así que una página subida nunca se ejecuta en la dirección de la API. Un bucket sirve cada archivo con el tipo con el que se subió.

Ajustes de almacenamiento

Archivar y restaurar

Archive en un proyecto lo saca de las listas, del resumen y de la búsqueda; su tablero, sus tareas y sus archivos se quedan como están. Archived (/en/dashboard/projects/deleted) lista los proyectos archivados, y Restore devuelve uno a la lista con sus tareas y archivos. Los archivos de un proyecto archivado todavía se pueden listar y descargar.

Las rutas detrás de estas páginas

Ruta	Permiso
`GET /api/workspaces/:workspaceId/projects` (`status`, `state`, `search`, `ownerId`, `dueBefore`, `sort`, `order`, `page`, `limit` hasta 100)	`projects.read`
`GET .../projects/archived`, `GET .../projects/owners`, `GET .../projects/:projectId`, `GET .../projects/:projectId/activity`	`projects.read`
`POST .../projects`, `PATCH .../projects/:projectId`, `DELETE .../projects/:projectId` (archivar), `POST .../projects/:projectId/restore`	`projects.write`
`GET .../projects/:projectId/files`, `GET .../files/:fileId/download`	`projects.read`
`POST .../projects/:projectId/files` (multipart, campo `file`)	`projects.write`
`GET .../projects/:projectId/tasks` (`assigneeId`, `priority`, `search`)	`projects.read`
`POST .../projects/:projectId/tasks`, `PATCH .../tasks/:taskId`, `POST .../tasks/:taskId/move`, `DELETE .../tasks/:taskId` (archivar)	`projects.write`

.../tasks/:taskId/move recibe la columna como status y, para colocar la tarjeta, el id de la tarjeta delante de la cual queda como beforeId. Tus propios sistemas pueden leer, crear y editar proyectos y añadir tareas con una clave de API en /api/v1.