Guía de inicio

¿Qué es ARTid?

ARTid — by POORdesigner.com — es una plataforma diseñada para dar identidad digital a las obras de arte, de manera que el artista, como dueño de la propiedad intelectual, tenga el control de su información y el propietario, tenga un medio digital para validar la autenticidad de su obra.

Cada obra se asocia con un QR permanente, que enlaza a una ficha digital pública y actualizable donde van a residir datos básicos e históricos de la misma. Adicional, cada obra va a tener un sistema de control cifrado para identificar la propiedad de la misma.

• Tú eres el dueño de la información — la identidad digital de tus obras viven en tu GitHub, tu dominio y tu short URL.
• QR permanente — se genera una vez y se asocia a la obra física, nunca cambia.
• Short URL — el punto intermedio entre el QR y la ficha digital. Si cambias de hosting o de dominio, solo re-apuntas el short URL y el acceso a la ficha pública se mantiene vigente sin tener que modificar tu QR.
• Ficha pública — muestra la imagen, la metadata, el historial (exposiciones y proveniencia).
• Control de Propiedad — la generación de llaves cifradas permiten establecer un método digital para demostrar quién es el propietario de la pieza.

Filosofía

• El artista es dueño de su información.
• La plataforma es abierta, y permite la gestión manual de cada ficha técnica si así se desea.
• ARTid es la estructura definida para que esto sea posible, y a su vez es una herramienta, un facilitador, para la gestión y mantenimiento de la identidad digital de cada obra.

Cómo funciona la ficha (open source)

La ficha es un conjunto de archivos estáticos (HTML + CSS + JS) que se instalan en tu repositorio. Es open source: tú la posees, puedes descargarla, modificarla y alojarla donde quieras.

El flujo al escanear el QR

1. Escaneas el QR → apunta a https://tudominio.s.gy?art=<ID>.
2. short.io redirige a https://tu-ficha/redirect.html?art=<ID>.
3. redirect.html convierte ?art=<ID> en #/art/<ID> (routing por hash, sin servidor).
4. index.html + js/app.js leen el hash y cargan desde GitHub:
   • artworks/<ID>/metadata.json — datos de la obra.
   • artworks/<ID>/exhibitions.json — exposiciones.
   • artworks/<ID>/ownership.json — proveniencia.
5. Se renderiza la obra con su imagen, metadata e historial.

Los archivos

• index.html — estructura base de la página.
• js/app.js — lógica: routing + carga de JSON + render.
• css/style.css — diseño oscuro minimalista.
• redirect.html — puente entre el short URL y la ficha.

Todo es tuyo: el repositorio, el dominio y el short URL. El QR nunca cambia; si mañana migras a otro hosting, solo re-apuntas el short URL.

1. Crear tu cuenta en ARTid

1. Entra a https://artid.poordesigner.com.
2. Haz clic en «Continuar con Google» o regístrate con email y contraseña.
3. Se crea tu cuenta de artista y entras al Dashboard.

2. Conectar tu cuenta de GitHub

ARTid guarda tus obras en tu repositorio de GitHub. Necesitas una cuenta de GitHub:

1. Si no tienes cuenta, créala en github.com/signup.
2. En el Dashboard de ARTid, haz clic en «Connect GitHub».
3. GitHub te pedirá autorizar a ARTid (acceso a tus repositorios). Acepta.
4. Al volver verás «Conectado como @tuusuario».

3. Vincular o crear tu repositorio

El repositorio es donde vivirán tus obras (artworks/) y la ficha.

1. Dashboard → «Configure repository».
2. Opción A — vincular existente: elige uno de tus repositorios y clic en «Link».
3. Opción B — crear nuevo: escribe un nombre (ej. arte) y clic en «Create».
4. Si el repo ya tiene obras, usa «Sync artworks» para importarlas.

4. Instalar la ficha

La ficha es la página pública que muestra tu obra al escanear el QR.

1. En la configuración de GitHub, haz clic en «Install ficha».
2. ARTid escribe en la raíz de tu repositorio: index.html, redirect.html, js/app.js y css/style.css.

5. Publicar con GitHub Pages

Para que la ficha sea pública y accesible por URL:

1. Ve a tu repositorio en GitHub → Settings → Pages.
2. En «Build and deployment» → Source: «Deploy from a branch».
3. Rama: main, carpeta: / (root) → Save.
4. GitHub te da una URL del tipo https://tuusuario.github.io/turepo/.
5. Esa URL es tu ficha base. El short URL apuntará a <esa URL>/redirect.html.
6. (Alternativa: sube el contenido del repo a tu propio hosting/dominio.)

6. Configurar short.io

El short URL es el punto intermedio entre el QR y tu ficha. Así el QR nunca cambia aunque cambies de hosting.

1. Crea una cuenta en short.io.
2. Añade un dominio corto (puedes usar el gratuito .s.gy que te asigna, o conectar tu propio dominio).
3. Configura el root redirect del dominio para que apunte a la URL de tu ficha + redirect.html. Ejemplo:

   https://tuusuario.github.io/turepo/redirect.html

4. Prueba: abre https://tudominio.s.gy?art=NOMBRE_DE_OBRA → debe redirigir a tu ficha y mostrar la obra.
5. En ARTid → GitHub settings → «Short URL», escribe tu dominio corto (ej. tudominio.s.gy) y guarda.

Así, el QR codifica https://tudominio.s.gy?art=<ID>, y short.io reenvía a tu ficha con el parámetro ?art=.

7. Crear tu primera obra

1. Menú → «Artworks» → «New Artwork».
2. Completa: título, año, edición (1/x), serie, técnicas y descripción.
3. Sube la imagen de la obra.
4. El Artwork ID se genera del título (o escríbelo tú, en mayúsculas y guiones).
5. Al guardar, ARTid commitea artworks/<ID>/metadata.json + la imagen a tu repositorio.

8. Generar el QR

1. En la lista de obras verás el QR de cada una.
2. Haz clic sobre el QR para abrirlo en tamaño completo.
3. Descárgalo (SVG, vectorial) e imprímelo en la obra física.
4. El QR codifica https://tudominio.s.gy?art=<ID>.

9. Historial de la obra

1. En la lista de obras, clic en el título para abrir el historial.
2. + Expo: agrega exposiciones (nombre, fecha, descripción, links).
3. + Propiedad: registra la propiedad. En una venta se genera una llave secreta para revelar al nuevo propietario.
4. El historial se muestra en la ficha pública (exposiciones + proveniencia).