唯一的 API

第一层。作为文化文献的作品：类型、作者、来源节点、策展状态（7 个环节）、形式描述与技术资产。

读取

仅档案（环节 7）公开；其余按权限

写入（权限）

obra:crear · obra:editar / obra:editar_propia · obra:borrar · movimiento:avanzar (estadoCuratorial)

操作

GET /api/obras GET /api/obras/count GET /api/obras/:id POST /api/obras PATCH /api/obras/:id DELETE /api/obras/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/obras?depth=0&locale=zh&limit=1

{
  "id": 3,
  "titulo": "Metsä · 菌丝体 v3",
  "tipo": "codigo_generativo",
  "autor": 3,
  "nodoOrigen": "laboratorio_ia",
  "estadoCuratorial": "movimiento_7",
  "descripcionFormal": {
    "silueta": null,
    "material": "模拟菌丝体生长作为图案生成器。",
    "sintaxisVisual": "形式不是画出来的，而是培育出来的。"
  },
  "activosTecnicos": {
    "docs": [],
    "hasNextPage": false
  },
  "edicion": null,
  "updatedAt": "2026-08-22T18:29:49.582Z",
  "createdAt": "2026-08-21T07:12:39.411Z"
}

第二层。设计师、集体、实验室与机构。文化渊源仅为描述，绝非排序标准。

读取

公开

写入（权限）

autor:gestionar

操作

GET /api/autores GET /api/autores/count GET /api/autores/:id POST /api/autores PATCH /api/autores/:id DELETE /api/autores/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/autores?depth=0&locale=zh&limit=1

{
  "id": 3,
  "nombre": "Lab Metsä",
  "tipo": "laboratorio",
  "origenCultural": "芬兰赫尔辛基",
  "bio": "生成式材料实验室。",
  "trayectoria": "专注于模拟生物纺织品的学术衍生机构。",
  "nodos": [],
  "taller": {
    "capacidad": null,
    "materiales": [],
    "tecnologias": [],
    "usaFibrasRecicladas": null,
    "fibrasRecicladasDetalle": null,
    "notasSostenibilidad": null,
    "procedencia": "humano"
  },
  "updatedAt": "2026-08-22T18:29:48.843Z",
  "createdAt": "2026-08-21T07:12:36.066Z"
}

第三层。图谱的顶点：哲学思潮、技术发展、社群、机构、文化张力。

读取

公开

写入（权限）

nodo:gestionar

操作

GET /api/nodos GET /api/nodos/count GET /api/nodos/:id POST /api/nodos PATCH /api/nodos/:id DELETE /api/nodos/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/nodos?depth=0&locale=zh&limit=1

{
  "id": 4,
  "nombre": "生成模型时代的作者身份",
  "tipo": "tension_cultural",
  "descripcion": null,
  "updatedAt": "2026-08-22T18:29:49.224Z",
  "createdAt": "2026-08-21T07:12:36.120Z"
}

第三层。图的有类型边。机器出处的连接以提议状态创建，仅由人确认。

读取

公开

写入（权限）

conexion:proponer · conexion:confirmar

操作

GET /api/conexiones GET /api/conexiones/count GET /api/conexiones/:id POST /api/conexiones PATCH /api/conexiones/:id DELETE /api/conexiones/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/conexiones?depth=0&locale=zh&limit=1

{
  "id": 6,
  "origen": {
    "relationTo": "obras",
    "value": 2
  },
  "destino": {
    "relationTo": "obras",
    "value": 1
  },
  "tipoRelacion": "conversacion_paralela_con",
  "procedencia": "maquina",
  "estado": "propuesta",
  "confirmadaPor": null,
  "confirmadaEn": null,
  "nota": "Coincidencia en el campo silueta: ambas describen la silueta por lo que le falta de sostén estructural. Aguacero 01: \"Volumen inflado, sin punto de apoyo.\" Kata: \"Hombro desestructurado: la autoridad se retira del cuerpo.\" Vocabulario compartido: \"sin punto de apoyo\" / \"desestructurado\" / \"se retira\" — en las dos la forma se define por la ausencia de estructura que la sostenga, no por lo que añade. Divergen en tipo (coleccion_digital vs modelo_3d), nodo de origen (comunidad_digital_emergente vs academico_investigador) y material (plástico de baja poligonización vs lana simulada), y no tienen conexión entre sí en la cartografía. Solo se usa la descripción formal; no se usa el significado asignado a Kata ni el origen cultural de los autores. Evidencia sintáctica, pendiente de lectura curatorial.",
  "updatedAt": "2026-09-03T07:10:25.005Z",
  "createdAt": "2026-09-03T07:10:25.005Z"
}

第四层。固定的诠释学问题与解读。始终为人工出处（由服务器强制）。

读取

公开

写入（权限）

significado:asignar

操作

GET /api/significados GET /api/significados/count GET /api/significados/:id POST /api/significados PATCH /api/significados/:id DELETE /api/significados/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/significados?depth=0&locale=zh&limit=1

{
  "id": 2,
  "obra": 3,
  "tensionSubyacente": "jhksjhdkae",
  "lectura": [],
  "curador": 1,
  "procedencia": "humano",
  "updatedAt": "2026-09-04T12:02:19.341Z",
  "createdAt": "2026-09-04T12:02:19.340Z"
}

策展工作流：每件作品的七个环节，含负责人与出处。

读取

公开

写入（权限）

movimiento:avanzar

操作

GET /api/movimientos GET /api/movimientos/count GET /api/movimientos/:id POST /api/movimientos PATCH /api/movimientos/:id DELETE /api/movimientos/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/movimientos?depth=0&locale=zh&limit=1

{
  "id": 21,
  "obra": 3,
  "movimiento": "movimiento_7",
  "estado": "en_curso",
  "responsable": 2,
  "procedencia": "humano",
  "updatedAt": "2026-08-21T07:12:40.179Z",
  "createdAt": "2026-08-21T07:12:40.179Z"
}

Event Stack。每一届（日期、主办城市、焦点国家）。

读取

公开

写入（权限）

edicion:gestionar

操作

GET /api/ediciones GET /api/ediciones/count GET /api/ediciones/:id POST /api/ediciones PATCH /api/ediciones/:id DELETE /api/ediciones/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/ediciones?depth=0&locale=zh&limit=1

{
  "id": 1,
  "nombre": "DWFW · 第一届",
  "fechaInicio": "2027-03-12T00:00:00.000Z",
  "fechaFin": "2027-03-15T00:00:00.000Z",
  "ciudadAnfitriona": "马德里",
  "paisEnFoco": "西班牙",
  "updatedAt": "2026-08-22T18:29:48.495Z",
  "createdAt": "2026-08-21T07:12:35.921Z",
  "fase": "antes",
  "cuentaAtras": 12331013
}

Event Stack。某届的品牌章节：板块、大洲、时长、作品。

读取

公开

写入（权限）

capitulo:gestionar

操作

GET /api/capitulos GET /api/capitulos/count GET /api/capitulos/:id POST /api/capitulos PATCH /api/capitulos/:id DELETE /api/capitulos/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/capitulos?depth=0&locale=zh&limit=1

{
  "id": 3,
  "titulo": "对谈 · 作者身份与机器",
  "edicion": 1,
  "autor": 2,
  "duracionMin": 60,
  "seccion": "conversaciones",
  "continente": "america",
  "obras": [
    2
  ],
  "updatedAt": "2026-08-22T19:21:09.427Z",
  "createdAt": "2026-08-22T19:21:09.303Z"
}

Event Stack。视听作品（首映、对谈、幕后花絮……）及流媒体引用。

读取

公开

写入（权限）

pieza:gestionar

操作

GET /api/piezas GET /api/piezas/count GET /api/piezas/:id POST /api/piezas PATCH /api/piezas/:id DELETE /api/piezas/:id

字段

真实示例（GET，depth=0，公开视图）

GET https://dwfw.trabemflex.com/api/piezas?depth=0&locale=zh&limit=1

{
  "id": 3,
  "titulo": "与 Colectivo Aguacero 对谈",
  "tipo": "conversacion",
  "capitulo": 3,
  "obra": 2,
  "urlStreaming": null,
  "updatedAt": "2026-08-22T19:21:09.874Z",
  "createdAt": "2026-08-22T19:21:09.764Z"
}

技术资产：图片（≤50 MB）、视频（≤2 GB）、3D 模型 .glb/.gltf/.usdz/.fbx/.obj（≤500 MB）和 PDF（≤20 MB）。默认私密（盲评）：上传者与策展团队可见；作品到达环节 7 时公开。存储于 Cloudflare R2；视频与 3D 直传至存储桶。信息：描述、署名、材质、AI 使用、许可、软件。

读取

仅档案（环节 7）公开；其余按权限

写入（权限）

obra:crear (subir) · propio: editar / borrar si no publicado · obra:editar: todo y publicar

操作

GET /api/media GET /api/media/count GET /api/media/:id POST /api/media PATCH /api/media/:id DELETE /api/media/:id

字段

真实示例（GET，depth=0，公开视图）

未登录时无可见文档。

带角色和额外权限（可到期的授权）的账户，可选关联至作者。

读取

需登录（每个用户只看到自己；usuario:gestionar 可见全部）

写入（权限）

usuario:gestionar

操作

GET /api/usuarios GET /api/usuarios/count GET /api/usuarios/:id POST /api/usuarios PATCH /api/usuarios/:id DELETE /api/usuarios/:id POST …/login POST …/logout GET …/me POST …/refresh-token

字段

真实示例（GET，depth=0，公开视图）

未登录时无可见文档。