Open Brand Exchangev0.1Versão 0.1. A versão 0.1 foi publicada. A especificação e o software são de utilização livre.
Alojamento
Onde quiser. Paga só o alojamento.
Um portal é uma empresa de marca num servidor. Escolhe como o gere, de totalmente externalizado a totalmente por conta própria. Abaixo, do mais simples ao mais técnico.
O mais fácil: uma empresa aloja o seu portal, mantém-no atualizado e ajuda na configuração. Como todos os portais falam a mesma norma, mais tarde pode mudar para outro fornecedor ou para alojamento próprio.
Photopilot
Product photography software for fashion and lifestyle. Hosts a brand portal on your own domain and publishes through OBX.
Qualquer empresa de alojamento, agência ou fabricante de software pode constar aqui. As condições são iguais para todos:
o seu portal passa nos testes de conformidade
uma marca pode exportar todos os dados e imagens e sair
publica os seus preços e condições no seu próprio site
Abra um pull request no repositório do site com os seus dados em src/data/providers.json. Os fornecedores aparecem por ordem alfabética. openbrandexchange/website
2. Com um clique
O seu próprio portal na sua própria conta, sem gerir um servidor.
Portal para Cloudflare
Funciona no Cloudflare Workers, com D1 como base de dados e R2 para as imagens. Clique no botão, inicie sessão no Cloudflare e siga os passos. Um portal de uso diário precisa do plano Workers Paid (5 dólares por mês); o plano gratuito só chega para dar uma vista de olhos. As versões web das suas fotos são criadas pelo seu navegador e pela ferramenta obx.
Um script que coloca o seu portal no Google Cloud Run. Precisa de uma conta Google Cloud e da ferramenta 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 o alojamento web que talvez já tenha, com PHP e uma base de dados. Sem comandos:
Transfira obx-portal-php-<version>.zip da versão mais recente.
Descompacte-o e envie a pasta para o seu alojamento por (S)FTP.
Aponte o seu (sub)domínio, por exemplo revendedores.suamarca.pt, para a pasta public.
Permita a escrita nas pastas data e config (permissões 775; se o instalador continuar a dizer que não, 777).
Abra esse endereço. O instalador verifica o servidor e pede o código de instalação do ficheiro data/SETUP-CODE.txt, que abre com o seu programa FTP. Depois clique em “Abrir o assistente de configuração”.
Adicione o endereço cron que o instalador mostra como tarefa cron no painel do seu alojamento, a cada 5 minutos. Mesmo sem ele, o portal funciona.
No seu próprio servidor ou em qualquer cloud que execute contentores. Um 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
Ou com HTTPS incluído, através do 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:
Definições
OBX_PUBLIC_URL
o endereço público do seu portal
OBX_SECRET_KEY
uma chave aleatória longa (openssl rand -hex 32); guarde-a bem
OBX_SETUP_CODE
opcional: um código de configuração escolhido antecipadamente
PORT
porta, 8080 por predefinição
Depois de instalar: o primeiro arranque
Abra o endereço do seu portal no navegador.
Introduza o código de instalação de utilização única. Está no registo no primeiro arranque (Portal para alojamento web: em data/SETUP-CODE.txt, e o instalador preenche-o por si), ou define-o antecipadamente com OBX_SETUP_CODE.
Preencha a sua empresa e a primeira marca e escolha a sua palavra-passe. Nunca há uma palavra-passe predefinida.
O código de configuração garante que mais ninguém pode apropriar-se de um portal acabado de instalar.
O seu domínio
Use um subdomínio como revendedores.suamarca.pt ou b2b.suamarca.pt. Os revendedores veem o seu nome, e o endereço mantém-se se mudar de alojamento.
Três edições, um portal
As três edições fazem o mesmo e partilham a mesma administração e o mesmo portal de revendedores. Escolha a que se adapta ao seu alojamento; pode mudar mais tarde. Ver as implementações.