> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puente.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace

> El panel central de navegación del workspace: proyectos, tasks y componentes en un solo lugar.

**Puente Workspace** es el panel desde donde organizas y navegas todo. Cada componente que creas (Apps, Databases, Workflows, Agents) vive dentro de un proyecto, y cada proyecto tiene sus propias tasks.

## Visión general

El workspace opera en dos niveles:

```text theme={null}
HOME (lista de proyectos)
  - click en un proyecto
DETALLE DEL PROYECTO
  - Tasks (Kanban / Lista)
  - Componentes (Apps - Databases - Workflows - Agents)
```

***

## Vista Home

Al abrir el workspace llegas al Home con la lista de proyectos activos del equipo. Siempre aparece primero el proyecto especial **"Todos"** (ALL), que agrupa todos los componentes del workspace sin importar a qué proyecto pertenecen.

### Controles principales

| Control                    | Qué hace                                                                                                  |
| -------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Buscador**               | Filtra proyectos por nombre o descripción en tiempo real                                                  |
| **Vista Tabla / Tarjetas** | Alterna entre lista compacta y grid visual con estadísticas                                               |
| **Ordenar**                | En vista tabla, haz click en las cabeceras **Proyecto** o **Fecha** para ordenar ascendente o descendente |
| **Nuevo Proyecto**         | Botón en la esquina superior derecha                                                                      |
| **Paginación**             | Si hay más de 10 proyectos, aparece navegación por páginas al pie de la lista                             |

### Qué muestra cada tarjeta

* Nombre y descripción del proyecto
* Fecha de creación
* Contadores por tipo de componente (Apps, Workflows, Databases, Agents)
* Menú de opciones (tres puntos) para editar o eliminar

***

## Gestión de proyectos

### Crear un proyecto

<Steps>
  <Step title="Click en Nuevo Proyecto">
    Botón en la esquina superior derecha del Home.
  </Step>

  <Step title="Completa nombre y descripción">
    El nombre es requerido. La descripción es opcional pero recomendada.
  </Step>

  <Step title="Confirma">
    El proyecto aparece inmediatamente en la lista.
  </Step>
</Steps>

### Editar un proyecto

Pasa el cursor sobre el proyecto, click en el menú de opciones (tres puntos) y elige **Editar**. Modifica nombre o descripción y confirma.

<Note>
  Solo se pueden editar proyectos reales. El proyecto **"Todos"** no es editable.
</Note>

### Eliminar un proyecto

Menú de opciones (tres puntos), elige **Eliminar** (en rojo) y confirma.

<Warning>
  Al eliminar un proyecto, los **componentes** asignados regresan automáticamente al proyecto "Todos". Pero las **tasks** se eliminan de forma permanente junto con el proyecto.
</Warning>

***

## Detalle de proyecto

Al hacer click en un proyecto entras a su vista de detalle. Un botón de volver (←) en el header te lleva de regreso al Home. La vista se divide en dos secciones:

<CardGroup cols={2}>
  <Card title="Tasks" icon="list-check">
    Kanban o lista de tasks asignadas al proyecto.
  </Card>

  <Card title="Componentes" icon="cubes">
    Tabla con todas las Apps, Workflows, Databases y Agents del proyecto.
  </Card>
</CardGroup>

***

## Tasks

Las tasks se gestionan dentro de cada proyecto. La sección aparece en la parte superior del detalle (solo en proyectos reales, no en "Todos").

### Estados y vistas

Los estados disponibles son: **Backlog**, **Pendiente**, **En progreso**, **Completado** y **Cancelado**. Puedes ver las tasks como:

* **Kanban** — columnas por estado, con tarjetas arrastrables entre columnas
* **Lista** — tasks agrupadas por estado, colapsables, con drag & drop entre grupos

Una **barra de progreso** en el encabezado muestra el porcentaje completado y el conteo `X/Total` cuando hay tasks.

### Crear una task

Tienes tres formas de crear una task:

* Botón **+ Nueva task** en el encabezado de la sección (la crea en Backlog).
* Botón **+** en el encabezado de un grupo (vista Lista) — la crea con ese estado.
* Botón **+** en el encabezado de una columna (vista Kanban) — mismo comportamiento.

En el modal puedes configurar:

| Campo            | Requerido | Descripción                                                                  |
| ---------------- | --------- | ---------------------------------------------------------------------------- |
| **Nombre**       | Sí        | Título de la task                                                            |
| **Descripción**  | No        | Texto libre de contexto                                                      |
| **Estado**       | No        | Por defecto: Backlog                                                         |
| **Fecha límite** | No        | Fecha de vencimiento                                                         |
| **Componentes**  | No        | Tipo de componente relacionado: Apps, Workflows, Databases, Agents           |
| **Owner**        | No        | Miembro del equipo responsable, elegido desde un dropdown con todo el equipo |

### Editar y mover

* **Editar**: click en el botón de editar (lápiz) de la task y modifica los campos en el modal.
* **Cambiar estado**: arrastra la task a otro grupo (vista Lista) o columna (vista Kanban). El cambio se guarda automáticamente al soltarla.
* **Eliminar**: click en el botón de eliminar (papelera) y confirma.

<Warning>
  Eliminar una task es irreversible.
</Warning>

### Buscar y organizar

* El **buscador** del encabezado filtra tasks por nombre o descripción en ambas vistas. Los grupos o columnas vacíos se ocultan automáticamente.
* Puedes **colapsar** toda la sección de tasks (click en el título) o grupos individuales por estado (vista Lista).
* En **Kanban**, cada columna muestra hasta 5 tasks; si hay más aparece un botón **Ver X más** para cargar la siguiente página.

<Tip>
  Cuando una task tiene owner, aparece un avatar con sus iniciales en la fila (Lista) o tarjeta (Kanban). Pasa el cursor sobre el avatar para ver el nombre completo y el correo del responsable.
</Tip>

***

## Componentes

Dentro del detalle de un proyecto, la sección de componentes lista todas las Apps, Workflows, Databases y Agents asignados.

### Filtros rápidos

| Filtro        | Qué muestra                        |
| ------------- | ---------------------------------- |
| **Todos**     | Todos los componentes del proyecto |
| **Apps**      | Solo interfaces visuales           |
| **Workflows** | Solo automatizaciones              |
| **Databases** | Solo bases de datos                |
| **Agents**    | Solo agentes IA                    |

<Note>
  Los filtros solo aparecen si el tipo tiene al menos 1 componente en el proyecto.
</Note>

### Buscar y ordenar

* El **buscador** (esquina superior derecha) filtra por nombre dentro del tipo seleccionado. Se reinicia al cambiar de filtro.
* Las cabeceras **Nombre** y **Fecha** de la tabla son clickeables para ordenar ascendente o descendente.
* Si el proyecto tiene más de 10 componentes, aparece **paginación** al pie de la tabla.

### Agregar un componente

<Steps>
  <Step title="Click en + Agregar">
    Botón en la esquina superior derecha de la sección de componentes.
  </Step>

  <Step title="Elige el tipo">
    Selecciona App, Workflow, Database o Agent.
  </Step>

  <Step title="Crea el componente">
    Se abre el flujo de creación correspondiente.
  </Step>
</Steps>

### Acciones por componente

Al hacer hover sobre una fila aparece el botón de opciones (tres puntos):

| Acción       | Disponible en | Descripción                                                  |
| ------------ | ------------- | ------------------------------------------------------------ |
| **Editar**   | Solo Apps     | Abre el editor de la App                                     |
| **Mover**    | Todos         | Cambia el componente a otro proyecto (o de vuelta a "Todos") |
| **Eliminar** | Todos         | Elimina permanentemente (irreversible)                       |

<Note>
  Un componente solo puede pertenecer a **un proyecto a la vez**. Al moverlo, sale del proyecto actual.
</Note>

### Abrir un componente

Click en cualquier fila o en el botón de abrir (→) te lleva directo al editor del componente (App Builder, Workflow editor, Database editor o Agent editor).

***

## El proyecto "Todos"

<Card title="Qué es" icon="globe">
  El proyecto **"Todos"** (ALL) es un proyecto virtual que existe en todos los workspaces. Agrupa todos los componentes del workspace independientemente de si tienen proyecto asignado.
</Card>

### Cuándo es útil

* Encontrar un componente rápido sin saber en qué proyecto está
* Mover componentes huérfanos a un proyecto real
* Vista general del workspace completo

### Limitaciones

* No puedes crear tasks en "Todos"
* No puedes editarlo ni eliminarlo
* Componentes nuevos que se crean sin proyecto van automáticamente aquí

***

## Siguiente paso

<CardGroup cols={2}>
  <Card title="App Builder" icon="window" href="/componentes/app-builder">
    Construye tu primera aplicación web con IA.
  </Card>

  <Card title="Databases" icon="table" href="/componentes/databases">
    Crea Databases y conéctalas a tus Apps.
  </Card>
</CardGroup>