> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Colección Projects

`Project` representa un único proyecto LaTeX en Overleaf. Almacena los metadatos del proyecto, la propiedad y el control de acceso, la estructura de archivos, la configuración de compilación y el estado de la colaboración.

#### Identificación principal y metadatos

* `_id`: ObjectId único de MongoDB que identifica el proyecto.
* `name`: nombre visible del proyecto.
* `description`: descripción textual opcional del proyecto.
* `active`: indica si el proyecto está activo actualmente.
* `version`: versión interna del esquema o del formato del proyecto.
* `trashed`: lista de elementos movidos a la papelera (eliminación lógica).
* `deletedDocs`: registros de documentos eliminados de forma permanente.

#### Propiedad y control de acceso

* `owner_ref`: referencia al usuario propietario del proyecto.
* `collaberator_refs`: usuarios con permisos de edición.
* `reviewer_refs`: usuarios con acceso de nivel revisor.
* `readOnly_refs`: usuarios con acceso de solo lectura.
* `pendingEditor_refs` / `pendingReviewer_refs`: invitaciones pendientes.

#### Acceso basado en tokens

* `tokens`: registro de tokens para enlaces compartidos.
* `tokenAccessReadOnly_refs`: tokens que conceden acceso de solo lectura.
* `tokenAccessReadAndWrite_refs`: tokens que conceden acceso de lectura y escritura.

#### Seguimiento de actividad

* `lastUpdated`: marca de tiempo de la modificación más reciente.
* `lastUpdatedBy`: usuario que realizó la última actualización.
* `lastOpened`: marca de tiempo de la última vez que se abrió el proyecto.
* `deletedByExternalDataSource`: indica si la eliminación la desencadenó una integración externa.

#### Estructura del proyecto

Documento raíz y carpeta

* `rootDoc_id`: ObjectId del documento LaTeX principal de entrada (normalmente `main.tex`).
* `rootFolder`: representación en línea del árbol de archivos del proyecto.

Cada entrada de carpeta contiene:

* `name` / `_id`: nombre e identificador de la carpeta.
* `docs`: lista de documentos fuente LaTeX con su nombre e `_id`.
* `fileRefs`: referencias a archivos binarios (imágenes, archivos de datos), que incluyen:
  * `name`: nombre del archivo
  * `created`: marca de tiempo de la subida
  * `rev`: contador de revisiones
  * `hash`: hash del contenido para la deduplicación
  * `linkedFileData`: vínculo con almacenamiento externo (si lo hay)
* `folders`: subcarpetas anidadas.

#### Configuración de compilación y del editor

* `compiler`: motor LaTeX seleccionado (`pdflatex`, `xelatex`, `lualatex`, etc.).
* `spellCheckLanguage`: idioma del corrector ortográfico para este proyecto.

#### Configuración pública y de uso compartido

* `publicAccesLevel`: visibilidad del proyecto (`private`, `readOnly`, `public`, etc.).
* `collabratecUsers`: usuarios vinculados desde plataformas de colaboración externas.

#### Extensiones específicas de Overleaf

* `overleaf.history`:
  * `id`: identificador utilizado por el servicio de historial.
  * `display`: indica si el historial está habilitado y visible.

#### Versionado interno

* `__v`: clave de versión interna de Mongoose para el control de concurrencia.

Este es un ejemplo real de un proyecto de Overleaf.

<Accordion title="Ejemplo de proyecto">
  ```json5 theme={null}
  {
      _id: ObjectId('69686c09bcb72ccea226ff33'),
      name: 'overleaf-example',
      lastUpdated: ISODate('2026-01-15T04:25:34.637Z'),
      lastUpdatedBy: ObjectId('696868f6bcb72ccea226fe5f'),
      lastOpened: ISODate('2026-01-15T04:25:22.286Z'),
      active: true,
      owner_ref: ObjectId('696868f6bcb72ccea226fe5f'),
      collaberator_refs: [],
      reviewer_refs: [],
      readOnly_refs: [],
      pendingEditor_refs: [],
      pendingReviewer_refs: [],
      rootDoc_id: ObjectId('69686c09bcb72ccea226ff38'),
      rootFolder: [
          {
              name: 'rootFolder',
              _id: ObjectId('69686c09bcb72ccea226ff32'),
              docs: [
                  {
                      name: 'main.tex',
                      _id: ObjectId('69686c09bcb72ccea226ff38')
                  },
                  {
                      name: 'sample.bib',
                      _id: ObjectId('69686c09bcb72ccea226ff3f')
                  }
              ],
              fileRefs: [
                  {
                      name: 'frog.jpg',
                      created: ISODate('2026-01-15T04:24:41.963Z'),
                      rev: 0,
                      linkedFileData: null,
                      hash: '5b889ef3cf71c83a4c027c4e4dc3d1a106b27809',
                      _id: ObjectId('69686c09bcb72ccea226ff45')
                  }
              ],
              folders: []
          }
      ],
      version: 3,
      publicAccesLevel: 'private',
      compiler: 'pdflatex',
      spellCheckLanguage: 'en',
      deletedByExternalDataSource: false,
      description: '',
      trashed: [],
      deletedDocs: [],
      tokens: {},
      tokenAccessReadOnly_refs: [],
      tokenAccessReadAndWrite_refs: [],
      overleaf: {
          history: {
              id: '69686c09bcb72ccea226ff33',
              display: true
          }
      },
      collabratecUsers: [],
      __v: 0
  }
  ```
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.