BAIC

BAIC is a Chinese automotive brand. Oliver Agency maintains the BAIC Dashboard — an internal analytics/reporting tool hosted on the main Oliver web server (baic SSH alias).

Key Facts

SSH alias: baic → vadym.samoilenko@10.220.72.13 (same server as many Oliver projects — see wiki/infrastructure/server-baic)
URL: https://baic.oliver.solutions/dashboard/
Auth: Azure AD / Microsoft SSO via MSAL
Stack: React + Vite (frontend) + FastAPI (backend)

Deploy Process

[!important] No git on server — deploy via rsync only

# 1. Build locally
npm run build

# 2. Sync dist/ to server (no git pull on server)
rsync -avz --delete dist/ baic:/var/vhosts/baic.oliver.solutions/htdocs/dashboard/

Remote path: /var/vhosts/baic.oliver.solutions/htdocs/dashboard/
Backend systemd service: baic_dashboard.service (underscore, not hyphen)

# Restart backend after Python changes
ssh baic "sudo systemctl restart baic_dashboard.service"

# Check status
ssh baic "sudo systemctl status baic_dashboard.service"

Known Gotchas

Gotcha	Detail	Article
FastAPI `root_path` route stripping	Routes must be registered WITHOUT `/dashboard` prefix	wiki/concepts/fastapi-root-path-route-stripping
SSE needs `?token=`	`EventSource` can't set custom headers	wiki/concepts/sse-jwt-query-param
SPA index.html must be no-cache	Old hashes cause blank screen after rebuild	wiki/concepts/spa-index-html-cache-control
MS SSO IDs are not UUIDs	`ms-4n0T2x-...` format breaks UUID validators	wiki/concepts/microsoft-sso-non-uuid-ids

wiki/infrastructure/server-baic — server overview (hosts 40+ domains, not just BAIC)
wiki/tech-patterns/azure-ad-msal-auth — MSAL SSO pattern
wiki/tech-patterns/react-vite-typescript — frontend stack

2 KiB Raw Blame History

BAIC

Key Facts

Deploy Process

Known Gotchas

Related

2 KiB

Raw Blame History