Open Brand Exchangev0.1Versión 0.1. La versión 0.1 ya está publicada. La especificación y el software son de uso libre.
Alojamiento
Donde tú quieras. Solo pagas el alojamiento.
Un portal es una empresa de marca en un servidor. Tú eliges cómo gestionarlo, desde totalmente externalizado hasta hacerlo todo tú. Abajo, de lo más sencillo a lo más técnico.
Lo más fácil: una empresa aloja tu portal, lo mantiene al día y te ayuda a configurarlo. Como todos los portales hablan el mismo estándar, más adelante puedes cambiar a otro proveedor o a tu propio alojamiento.
Photopilot
Product photography software for fashion and lifestyle. Hosts a brand portal on your own domain and publishes through OBX.
Cualquier empresa de alojamiento, agencia o fabricante de software puede aparecer aquí. Las condiciones son iguales para todos:
tu portal supera las pruebas de conformidad
una marca puede exportar todos sus datos e imágenes e irse
publicas tus propios precios y condiciones en tu propio sitio
Abre una pull request en el repositorio del sitio web con tus datos en src/data/providers.json. Los proveedores aparecen por orden alfabético. openbrandexchange/website
2. Con un clic
Tu propio portal en tu propia cuenta, sin gestionar un servidor.
Portal para Cloudflare
Funciona en Cloudflare Workers, con D1 como base de datos y R2 para las imágenes. Pulsa el botón, inicia sesión en Cloudflare y sigue los pasos. Un portal de uso diario necesita el plan Workers Paid (5 dólares al mes); el plan gratuito solo sirve para echar un vistazo. Las versiones web de tus fotos las crean tu navegador y la herramienta obx.
Un script que pone tu portal en Google Cloud Run. Necesitas una cuenta de Google Cloud y la herramienta gcloud.
git clone https://github.com/openbrandexchange/node-go
cd node-go
gcloud config set project my-project # once: your Google Cloud project (billing on)
DRY_RUN=1 ./deploy/cloudrun.sh # optional: only show what it would do, change nothing
./deploy/cloudrun.sh # region europe-west4; REGION=… for another
Para el alojamiento web que quizá ya tienes, con PHP y una base de datos. Sin comandos:
Descarga obx-portal-php-<version>.zip de la última versión.
Descomprímelo y sube la carpeta a tu alojamiento por (S)FTP.
Apunta tu (sub)dominio, por ejemplo distribuidores.tumarca.es, a la carpeta public.
Permite la escritura en las carpetas data y config (permisos 775; si el instalador sigue diciendo que no se puede, 777).
Abre esa dirección. El instalador comprueba tu servidor y pide el código de instalación del archivo data/SETUP-CODE.txt, que abres con tu programa FTP. Después haz clic en “Abrir el asistente de configuración”.
Añade la dirección cron que muestra el instalador como tarea cron en el panel de tu alojamiento, cada 5 minutos. Sin ella el portal también funciona.
En tu propio servidor o en cualquier nube que ejecute contenedores. Un comando:
openssl rand -hex 32 > obx-secret.key # once; keep this file safe, with your backups
docker run -d --name obx --restart unless-stopped \
-p 8080:8080 -v obx-data:/data \
-e OBX_PUBLIC_URL=https://brands.example.com \
-e OBX_SECRET_KEY="$(cat obx-secret.key)" \
ghcr.io/openbrandexchange/node-go
docker logs obx 2>&1 | grep -i "setup code" # the one-time code for the first-run wizard
O con HTTPS incluido, mediante Caddy:
compose.yaml
# compose.yaml: the node behind Caddy, which gets an HTTPS certificate by itself.
services:
obx:
image: ghcr.io/openbrandexchange/node-go
restart: unless-stopped
environment:
OBX_PUBLIC_URL: https://brands.example.com
OBX_SECRET_KEY: ${OBX_SECRET_KEY} # openssl rand -hex 32, keep it safe
OBX_TRUST_PROXY: "true" # every request comes through Caddy (rate limits per visitor)
volumes:
- obx-data:/data
caddy:
image: caddy:2
restart: unless-stopped
ports: ["80:80", "443:443"]
command: caddy reverse-proxy --from brands.example.com --to obx:8080
volumes:
- caddy-data:/data
volumes:
obx-data:
caddy-data:
Ajustes
OBX_PUBLIC_URL
la dirección pública de tu portal
OBX_SECRET_KEY
una clave aleatoria larga (openssl rand -hex 32); guárdala bien
OBX_SETUP_CODE
opcional: un código de instalación elegido de antemano
PORT
puerto, 8080 por defecto
Tras la instalación: el primer arranque
Abre la dirección de tu portal en el navegador.
Introduce el código de instalación de un solo uso. Aparece en el registro en el primer arranque (Portal para alojamiento web: en data/SETUP-CODE.txt, y el instalador lo rellena por ti), o lo defines de antemano con OBX_SETUP_CODE.
Rellena tu empresa y tu primera marca y elige tu propia contraseña. Nunca hay una contraseña por defecto.
El código de instalación garantiza que nadie más pueda apropiarse de un portal recién instalado.
Tu propio dominio
Usa un subdominio como distribuidores.tumarca.es o b2b.tumarca.es. Los distribuidores verán tu nombre, y tu dirección seguirá igual si cambias de alojamiento.
Tres ediciones, un portal
Las tres ediciones hacen lo mismo y comparten la misma administración y el mismo portal para distribuidores. Elige la que encaje con tu alojamiento; puedes cambiar más adelante. Ver las implementaciones.