LABIM3D

LABIM3D es una plataforma web educativa desarrollada por TecMedHub (Universidad Austral de Chile, Puerto Montt) que funciona como repositorio curado de modelos anatómicos 3D para la enseñanza en ciencias de la salud.

La plataforma combina modelos alojados localmente —archivos STL originales o modificados— con enlaces a repositorios externos como Thingiverse y NIH 3D Print Exchange, presentándolos bajo una interfaz unificada con metadatos completos, información de licencias Creative Commons y visualización 3D directa en el navegador.

Objetivos principales

• Proveer acceso libre y organizado a modelos 3D verificados para docencia biomédica.
• Documentar el origen, autoría y condiciones de uso de cada modelo (cumplimiento CC BY 4.0).
• Facilitar la impresión 3D con especificaciones técnicas integradas en la ficha de cada modelo.
• Escalar sin infraestructura de servidor compleja: sin base de datos, sin backend dinámico.
• Enfoque especial en estudiantes y docentes de la Escuela de Tecnología Médica, UACh Puerto Montt.

LABIM3D es un sitio web estático: no requiere servidor de aplicaciones ni base de datos. Toda la lógica reside en el frontend (HTML + CSS + JavaScript) y el contenido se gestiona mediante archivos JSON.

Stack tecnológico

Estructura de directorios

LABIM3D/
├── index.html          ← Página principal
├── catalog.html        ← Catálogo con filtros y búsqueda
├── model.html          ← Vista detallada de modelo
├── about.html          ← Esta página
├── admin.html          ← Panel de administración
├── css/
│   ├── base.css        ← Variables globales, nav, footer
│   └── home.css        ← Estilos específicos del home
├── js/
│   ├── catalog.js      ← Lógica de filtrado y búsqueda
│   ├── model-viewer.js ← Visualizador Three.js
│   └── admin.js        ← Gestor de modelos
├── models/             ← Datos JSON por modelo
│   ├── index.json      ← Índice maestro (listado completo)
│   ├── oido-interno.json
│   └── articulacion-rodilla.json
└── images/
    └── models/         ← Thumbnails e imágenes por modelo

El corazón del sistema es el enfoque JSON modular: cada modelo tiene su propio archivo JSON con todos sus metadatos, y un index.json centraliza las referencias para el catálogo. Este diseño permite agregar modelos sin modificar código HTML ni lógica JavaScript.

Flujo para agregar un modelo

• 1Preparar el archivo STL y la imagen thumbnail del modelo.
• 2Crear el JSON del modelo copiando la plantilla y completando los campos.
• 3Registrar el modelo en index.json con la entrada resumida.
• 4Verificar que la tarjeta aparezca correctamente en el catálogo.

Estructura del JSON de un modelo

Cada modelo se describe completamente en su archivo JSON individual. A continuación la plantilla con todos los campos disponibles:

{
  "id":          "nombre-del-modelo",
  "title":       "Nombre Completo del Modelo",
  "category":    "Sistema Anatómico",
  "subcategory": "Subsistema o región",
  "tags":        ["tag1", "tag2", "tag3"],

  "type":   "external | local | modified | original",
  "status": "active | draft | review",

  "files": [
    {
      "filename": "modelo.stl",
      "label":    "Pieza principal",
      "path":     "stl/models/nombre-modelo.stl"
    }
  ],

  "thumbnail": "images/models/nombre/thumb.jpg",
  "images":   ["images/models/nombre/img1.jpg"],

  "description":     "Descripción educativa del modelo.",
  "educationalNotes": "Notas pedagógicas para el docente.",

  "printSpecs": {
    "material":  "PLA",
    "infill":   "20%",
    "supports": true,
    "time":     "4-6 horas",
    "scale":    "1:1"
  },

  "attribution": {
    "originalCreator":      "Nombre del autor original",
    "originalSource":       "https://url-fuente-original.com",
    "license":              "CC BY 4.0",
    "labim3dModifications": "Descripción de cambios realizados"
  },

  "externalLink": "https://url-si-es-externo.com",
  "dateAdded":    "2025-01-15",
  "addedBy":     "fernanda.lopez"
}

Campos del JSON — Referencia rápida

El índice maestro (index.json)

El index.json contiene una versión resumida de cada modelo — solo los campos necesarios para renderizar las tarjetas del catálogo y ejecutar filtros. Esto evita cargar todos los JSON completos al iniciar.

{
  "models": [
    {
      "id":        "oido-interno",
      "title":     "Oído Interno - Cóclea y Vestíbulo",
      "category":  "Sistema Auditivo",
      "tags":      ["coclea", "vestibulo", "orl"],
      "type":      "modified",
      "thumbnail": "images/models/oido-interno/thumb.jpg",
      "license":   "CC BY 4.0"
    }
    // ... demás modelos
  ],
  "lastUpdated": "2025-03-15",
  "totalModels": 3
}

El sistema de organización del catálogo opera en dos niveles jerárquicos: categorías (agrupaciones por sistema anatómico) y etiquetas libres (tags) para búsqueda granular. No existe una lista cerrada de valores predefinidos; los términos se definen al crear cada modelo.

Categorías del sistema

Convención de tags recomendada

• Minúsculas sin tildes: coclea, no Cóclea
• Términos anatómicos + clínicos: lumbar, vertebra, columna
• Indicar funcionalidad si aplica: funcional, articulado, seccionable
• Siglas de especialidad: orl, oft, traumato
• Separar sinónimos como tags distintos; no concatenar palabras

El panel admin.html provee una interfaz gráfica para agregar y editar modelos sin editar JSON manualmente. Implementa el patrón plantilla prellenada que garantiza campos consistentes y cumplimiento de atribución de licencias.

Funcionalidades del panel

• Formulario completo con todos los campos del JSON en interfaz visual.
• Auto-completado de campos derivados: ID desde el título, fecha automática.
• Soporte multi-STL: agregar varias piezas a un mismo modelo.
• Campos obligatorios de atribución para cumplimiento de licencias CC.
• Auto-guardado con localStorage: el formulario no se pierde al cerrar el navegador.
• Generación automática de JSON descargable listo para subir al repositorio.
• Actualización del index.json integrada en el flujo de exportación.

Plantilla JSON mínima para uso manual

Si se prefiere crear el JSON sin usar el panel, copiar esta plantilla mínima:

{
  "id":          "",
  "title":       "",
  "category":    "",
  "subcategory": "",
  "tags":        [],
  "type":        "local",
  "status":      "active",
  "files":       [{ "filename": "", "label": "Pieza única", "path": "" }],
  "thumbnail":   "",
  "images":      [],
  "description":      "",
  "educationalNotes": "",
  "printSpecs": {
    "material": "PLA", "infill": "20%",
    "supports": false, "time": "", "scale": "1:1"
  },
  "attribution": {
    "originalCreator":      "",
    "originalSource":       "",
    "license":              "CC BY 4.0",
    "labim3dModifications": ""
  },
  "externalLink": null,
  "dateAdded":    "YYYY-MM-DD",
  "addedBy":     ""
}

Checklist para agregar un modelo

• 01Localizar el archivo STL y verificar licencia CC compatible.
• 02Preparar thumbnail (mínimo 800×600px, fondo neutro).
• 03Abrir admin.html y completar todos los campos obligatorios.
• 04Agregar datos de atribución: autor original, fuente, licencia, modificaciones.
• 05Exportar JSON y verificar que el ID no exista en index.json.
• 06Subir thumbnail a images/models/[id]/thumb.jpg.
• 07Subir JSON a models/[id].json y actualizar index.json.
• 08Verificar en catálogo: tarjeta visible, 3D carga, metadatos correctos.

LABIM3D es un proyecto de TecMedHub, laboratorio de fabricación digital de la Escuela de Tecnología Médica, Universidad Austral de Chile, Puerto Montt. El equipo integra tecnología médica, ciencias biomédicas e ingeniería de software.