diff --git a/VERSION b/VERSION
new file mode 100644
index 0000000..5c13e7f
--- /dev/null
+++ b/VERSION
@@ -0,0 +1 @@
+2026.5.22
diff --git a/backend/Dockerfile b/backend/Dockerfile
index 52774f6..11ae9e1 100644
--- a/backend/Dockerfile
+++ b/backend/Dockerfile
@@ -7,6 +7,9 @@ WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
+# VERSION must be copied into the build context before `docker build`.
+# In CI / deploy scripts run: cp VERSION backend/VERSION (or pass --build-arg)
+COPY VERSION ./
RUN npm run build
# Stage 2: Production
@@ -17,9 +20,10 @@ WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev && npm cache clean --force
-# Copy compiled output and New Relic preload from builder
+# Copy compiled output, New Relic preload, and VERSION from builder
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/newrelic-preload.js ./newrelic-preload.js
+COPY --from=builder /app/VERSION ./VERSION
# New Relic agent — configured entirely via environment variables
ENV NEW_RELIC_NO_CONFIG_FILE=true
diff --git a/backend/src/app.controller.ts b/backend/src/app.controller.ts
index 8f8d114..65acacc 100644
--- a/backend/src/app.controller.ts
+++ b/backend/src/app.controller.ts
@@ -1,4 +1,20 @@
import { Controller, Get } from '@nestjs/common';
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+
+// Read at module load time — one I/O call for the lifetime of the process.
+// VERSION file lives at the container root (/app/VERSION), mounted from the
+// repo root via docker-compose. Falls back to package.json version if absent
+// (e.g. in environments that pass APP_VERSION as an env var instead).
+function readAppVersion(): string {
+ try {
+ return readFileSync(resolve(process.cwd(), 'VERSION'), 'utf-8').trim();
+ } catch {
+ return process.env.APP_VERSION ?? 'unknown';
+ }
+}
+
+const APP_VERSION = readAppVersion();
@Controller()
export class AppController {
@@ -13,6 +29,7 @@ export class AppController {
getRoot() {
return {
status: 'ok',
+ version: APP_VERSION,
timestamp: new Date().toISOString(),
service: 'hoa-financial-platform',
};
@@ -23,6 +40,7 @@ export class AppController {
getHealth() {
return {
status: 'ok',
+ version: APP_VERSION,
timestamp: new Date().toISOString(),
service: 'hoa-financial-platform',
};
diff --git a/backend/src/common/interceptors/newrelic-transaction.interceptor.ts b/backend/src/common/interceptors/newrelic-transaction.interceptor.ts
index 71adeaa..e471bb9 100644
--- a/backend/src/common/interceptors/newrelic-transaction.interceptor.ts
+++ b/backend/src/common/interceptors/newrelic-transaction.interceptor.ts
@@ -1,12 +1,15 @@
import { Injectable, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
import { Observable } from 'rxjs';
import { Request } from 'express';
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
/**
- * Sets a meaningful New Relic transaction name for every HTTP request.
+ * Sets a meaningful New Relic transaction name for every HTTP request and
+ * tags each transaction with the running app version.
*
- * Without this, NestJS's setGlobalPrefix('api') causes the New Relic Express
- * instrumentation to group ALL requests under the generic bucket
+ * Without the name override, NestJS's setGlobalPrefix('api') causes the New Relic
+ * Express instrumentation to group ALL requests under the generic bucket
* "Expressjs/GET/api$" (the compiled regex for the global prefix router),
* making per-endpoint APM data completely blind.
*
@@ -14,12 +17,25 @@ import { Request } from 'express';
* the matched pattern, e.g. "/api/accounts/:id") and calls newrelic.setTransactionName()
* to override the auto-detected name with "METHOD /route/pattern".
*
+ * The appVersion custom attribute lets you filter / compare releases in NRQL:
+ * SELECT average(duration) FROM Transaction WHERE appVersion = '2026.5.22'
+ *
* Gracefully no-ops when:
* - NEW_RELIC_ENABLED is not 'true' (dev / CI)
* - newrelic package is not installed
* - The NR agent fails to load for any reason
*/
+function readAppVersion(): string {
+ try {
+ return readFileSync(resolve(process.cwd(), 'VERSION'), 'utf-8').trim();
+ } catch {
+ return process.env.APP_VERSION ?? 'unknown';
+ }
+}
+
+const APP_VERSION = readAppVersion();
+
let newrelic: any;
try {
if (process.env.NEW_RELIC_ENABLED === 'true') {
@@ -40,6 +56,9 @@ export class NewRelicTransactionInterceptor implements NestInterceptor {
// 404s get a useful name like "GET /api/unknown-path" instead of "Expressjs/GET/api$".
const route: string = (req.route as any)?.path ?? req.path;
newrelic.setTransactionName(`${req.method} ${route}`);
+ // Tag every transaction with the release version so you can segment NR
+ // dashboards and alerts by deployment.
+ newrelic.addCustomAttribute('appVersion', APP_VERSION);
}
return next.handle();
}
diff --git a/docker-compose.yml b/docker-compose.yml
index 63cdc0a..d176d0c 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -60,6 +60,7 @@ services:
- ./backend/nest-cli.json:/app/nest-cli.json
- ./backend/tsconfig.json:/app/tsconfig.json
- ./backend/tsconfig.build.json:/app/tsconfig.build.json
+ - ./VERSION:/app/VERSION:ro
depends_on:
postgres:
condition: service_healthy
@@ -80,6 +81,7 @@ services:
- ./frontend/src:/app/src
- ./frontend/index.html:/app/index.html
- ./frontend/vite.config.ts:/app/vite.config.ts
+ - ./VERSION:/app/VERSION:ro
depends_on:
- backend
networks:
diff --git a/frontend/Dockerfile b/frontend/Dockerfile
index b56bd2b..ebee601 100644
--- a/frontend/Dockerfile
+++ b/frontend/Dockerfile
@@ -7,6 +7,9 @@ WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
+# VERSION must be copied into the build context before `docker build`.
+# In CI / deploy scripts run: cp VERSION frontend/VERSION (or pass VITE_APP_VERSION as build arg)
+COPY VERSION ./
RUN npm run build
# Stage 2: Serve with nginx
diff --git a/frontend/src/pages/settings/SettingsPage.tsx b/frontend/src/pages/settings/SettingsPage.tsx
index 272de0c..a2abb9b 100644
--- a/frontend/src/pages/settings/SettingsPage.tsx
+++ b/frontend/src/pages/settings/SettingsPage.tsx
@@ -237,7 +237,7 @@ export function SettingsPage() {
Version
- 2026.4.6
+ {__APP_VERSION__}
API
diff --git a/frontend/src/vite-env.d.ts b/frontend/src/vite-env.d.ts
index 2399b4a..8faf3dc 100644
--- a/frontend/src/vite-env.d.ts
+++ b/frontend/src/vite-env.d.ts
@@ -4,3 +4,6 @@ declare module '*.svg' {
const src: string;
export default src;
}
+
+/** Injected by vite.config.ts define — value comes from the root /VERSION file. */
+declare const __APP_VERSION__: string;
diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts
index de3bd57..d251344 100644
--- a/frontend/vite.config.ts
+++ b/frontend/vite.config.ts
@@ -1,9 +1,27 @@
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import path from 'path';
+import fs from 'fs';
+
+// Read the canonical version from /VERSION (repo root, mounted at /app/VERSION in Docker).
+// Falls back to the VITE_APP_VERSION env var so production Docker builds can pass it
+// as a build arg (--build-arg VITE_APP_VERSION=$(cat VERSION)) without needing the file.
+function readAppVersion(): string {
+ try {
+ return fs.readFileSync(path.resolve(__dirname, 'VERSION'), 'utf-8').trim();
+ } catch {
+ return process.env.VITE_APP_VERSION ?? 'dev';
+ }
+}
+
+const APP_VERSION = readAppVersion();
export default defineConfig({
plugins: [react()],
+ define: {
+ // Injected at compile time — use __APP_VERSION__ anywhere in frontend source.
+ __APP_VERSION__: JSON.stringify(APP_VERSION),
+ },
resolve: {
alias: {
'@': path.resolve(__dirname, './src'),