Documentatio

Dux completus ad distribuendum et administrandum tuum Galleria portfolio photographiae.

Incipiens

Galleria est moderna website portfolio photographiae constructa cum React 19, TypeScript, Express 5, et SQLite. Praebet imagines optimas tradendas, panelum administrativum, analytics tracking, et consilium responsivum.

Links Celeres

Configuratio Google OAuth SSO

Fac Google OAuth Unum Signum activum pro secure, sine tessera authenticatione ad tuam Galleria administrativam tabulam.

Gradus 1: Crea Google Cloud Project

  1. I ad Google Cloud Console
  2. Crea novum projectum aut elige iam existens
  3. Naviga ad APIs & Services → Credentials
  4. Clicca Crea Credentials → OAuth client ID
  5. Si rogatus, configura primum OAuth consensum screen

Gradus 2: Configura OAuth Client

  1. Elige Applicationem Web ut genus applicationis
  2. Addi tuum domainum ad Authorized JavaScript origins:
    https://yourdomain.com
  3. Addi URL reditus ad Authorized redirect URIs:
    https://yourdomain.com/api/auth/google/callback
  4. Clicca Crea et salva tua credentials

Gradus 3: Configura in Galleria Settings

  1. Intra in tuam Galleria administrativam tabulam
  2. Naviga ad Settings → Google OAuth
  3. Intra tuum Google Client ID
  4. Intra tuum Google Client Secret
  5. Clica Salva ut Google OAuth SSO enableas

Automatica Usorum Conversio: Usus existentes cum email inscriptionibus congruentibus automatice convertentur ad authenticationem Google OAuth. Possunt signare in Google statim postquam OAuth configuratur.

Consilium Securitatis: Solum addere inscriptiones electronicas fiduciales ut usores administratores. Potes administrare accessum usorum ex panel administrativi post initium configurationis.

OpenObserve Analytics Configuratio

OpenObserve praebet potentem log analytics et real-time monitoring pro tuo Galleria situ cum geo-enrichment facultatibus.

Gradus 1: Installa OpenObserve cum Docker

Curre OpenObserve utens Docker Compose:

Gradus 2: Crea Service Account

  1. Accede OpenObserve ad http://localhost:5080
  2. Intra cum tuis credencialibus administratoris
  3. Naviga ad Configuratio → Service Accounts
  4. Clica Crea Service Account
  5. Da ei nomen (exempli gratia, "galleria-analytics") et assigna iura apta
  6. Copia generatum API token ad usum postea

Gradus 7: Configura Galleria

  1. Intra in tabula administrationis Galleriae tuae
  2. Naviga ad Instincta → Analytics
  3. Inserte URL tuum OpenObserve (exempli gratia, http://localhost:5080)
  4. Inserte ID tuae Organizationis
  5. Inserte Nomen Stream (website)
  6. Inserte Nomen Usoris (ex Gradus 2)
  7. Inserte Tesseram tuam (token rationis servitii ex Gradus 2)
  8. Clica Salva ut analytics OpenObserve activas

Successus! Analytics tua nunc includet data geo-ditata cum urbe, regione, patria, ISP, et coordinatis pro omnibus visitatoribus.

Encoding Video Hardware

Galleria sustentat encoding video acceleratum a hardware pro 5-10x celerius processus video utens GPU tuo.

Hardware Sustentatum

NVIDIA GPUs (NVENC)

Docker et sustentatio native

Intel Quick Sync (QSV)

Sustentatio tantum native

AMD GPU (AMF)

Sola subsidia nativa

Apple VideoToolbox

macOS sola nativa

Enable Hardware Encoding

  1. I ad Panel Admin → Instar → Qualitas Video
  2. Toggle "Hardware Transcoding" ad enabled
  3. Processus video nunc utetur GPU acceleratione cum praesto est

Productio Deployment

Utendo PM2

Pro productione deployment sine Docker:

npm run build
npm install -g pm2
pm2 start ecosystem.config.cjs
pm2 save
pm2 startup

Automatizatum Deployment: Pone in ramum magistrum et GitHub Actions automatice deploys tuas mutationes.

Adiuva Meliorare Hanc Documentationem

Invenisti errorem aut vis contribuere ad documentationem? Contributus gratanter accipimus!

Contribue in GitHub