fix(version): channel-based label, no semver fallback for branch builds

Stale package.json создавал ложное впечатление rollback'а: staging
показывал "v1.2.0" хотя последний tag — v1.2.2 (package.json не bump'ился
со времён v1.2.0 release).

Vote A — branch builds НЕ используют package.json как version label.
Vite определяет channel:

  serverTag != none → что прод/staging RUNS
  clientTag         → что build'ил CI tag pipeline (CI_COMMIT_TAG set)
  CI без tag        → 'dev' literal (staging / branch CI build)
  локально          → 'local' literal (pnpm dev)

Detection через новый __APP_CI__ define из process.env.CI (GitLab сетает
CI=true). Local pnpm dev: CI undefined → channel='local'.

package.json.version всё ещё инжектится как __APP_VERSION__ и видна в
tooltip badge'а как 'floor vX.Y.Z' — не как primary label.

Files:
  - vite.config.ts: + APP_CI from process.env.CI
  - src/vite-env.d.ts: + __APP_CI__ declare
  - src/components/version/useAppVersion.ts: + clientCI
  - src/components/version/VersionBadge.tsx: channel logic вместо fallback

Verify all three modes:
  local         → 'local · {commit}'
  CI branch     → 'dev · {commit}'
  CI tag v1.3.1 → 'v1.3.1 · {commit}'

Tests: 116 pass.
This commit is contained in:
Zimin A.N.
2026-05-11 14:45:04 +03:00
parent 750395da09
commit 3223a5ced7
4 changed files with 30 additions and 6 deletions
@@ -14,6 +14,7 @@ export function VersionBadge() {
const {
clientVersion,
clientTag,
clientCI,
clientCommit,
clientBuiltAt,
serverVersion,
@@ -22,18 +23,31 @@ export function VersionBadge() {
updateAvailable,
} = useAppVersion()
// Priority: serverTag (что прод RUNS) → clientTag (что build'илось на tag
// pipeline) → v${clientVersion} (package.json fallback для local / branch).
// 'none' — Spring Boot build-info sentinel когда tag отсутствует.
// Channel-based label per "Vote A" — НЕ показываем package.json fallback
// как версию когда tag'а нет. Stale package.json (e.g. 1.2.0 когда уже
// выпущен v1.2.2) создавал ложное впечатление rollback'а.
//
// Channels:
// serverTag real — что прод/staging RUNS (most authoritative)
// clientTag — что build'ил CI tag pipeline
// CI без tag — 'dev' (staging / branch CI build)
// no CI no tag — 'local' (pnpm dev на машине разработчика)
//
// package.json.version используется ТОЛЬКО в tooltip как build-time floor
// — пользователь не видит его если не наведёт.
const displayVersion =
serverTag && serverTag !== 'none'
? serverTag
: clientTag
? `v${clientTag}`
: `v${clientVersion}`
: clientCI
? 'dev'
: 'local'
const tooltip = [
`client: ${clientTag ? `v${clientTag}` : `v${clientVersion}`} (${clientCommit})`,
`client: ${
clientTag ? `v${clientTag}` : clientCI ? `dev (floor v${clientVersion})` : `local (floor v${clientVersion})`
} (${clientCommit})`,
`server: ${serverTag || serverVersion} (${serverCommit ?? '...'})`,
`built: ${clientBuiltAt}`,
].join('\n')
@@ -21,8 +21,11 @@ export function useAppVersion() {
const clientCommit = __APP_COMMIT__
const clientVersion = __APP_VERSION__
// Empty string when build wasn't на tag pipeline. VersionBadge / UpdateBanner
// решают priority: serverTag → clientTag → fallback v${clientVersion}.
// решают priority: serverTag → clientTag → channel-based label.
const clientTag = __APP_TAG__
// true когда GitLab CI собрал bundle. Отличает branch build (dev) от
// local pnpm dev (local) — оба не имеют tag'а, но семантически разные.
const clientCI = __APP_CI__
const clientBuiltAt = __APP_BUILT_AT__
const knownClient = clientCommit !== 'unknown' && clientCommit !== ''
@@ -33,6 +36,7 @@ export function useAppVersion() {
return {
clientVersion,
clientTag,
clientCI,
clientCommit,
clientBuiltAt,
serverVersion: server?.version,
+1
View File
@@ -24,5 +24,6 @@ interface ImportMeta {
*/
declare const __APP_VERSION__: string
declare const __APP_TAG__: string
declare const __APP_CI__: boolean
declare const __APP_COMMIT__: string
declare const __APP_BUILT_AT__: string