Add volume mapping docs and build/version metadata

Add a volume-mapping guide and surface build/version metadata throughout the project.

Changes included:
- documentation: Add documentation/deployment/volume-mapping.md and update TABLEOFCONTENTS.md and README to reference it (helps users align download client and RMAB paths).
- CI: Capture package.json version in .github/workflows/build-unified-image.yml, pass APP_VERSION as a build-arg, and update the Discord notification to show the semantic version and pull `:latest`.
- Docker: Declare ARG APP_VERSION and expose NEXT_PUBLIC_APP_VERSION / APP_VERSION / GIT_COMMIT env vars in dockerfile.unified so runtime and client can read the semantic version and commit.
- App API/UI: Update src/app/api/version/route.ts and src/components/ui/VersionBadge.tsx to prefer semantic app version (APP_VERSION / NEXT_PUBLIC_APP_VERSION), include fullVersion and commit info, show commit in tooltip, and adjust fallback/dev labels.
- Tests: Update tests (system.routes.test.ts and VersionBadge.test.tsx) to reflect the new version/commit fields and behavior.
- Audible integration: Add ipRedirectOverride query param to multiple Audible requests to avoid IP-based region redirects.
- Misc: Bump package.json version to 1.0.0.

These changes make version information consistent between build, runtime, and UI, improve CI notifications, add user guidance for common volume-mapping issues, and harden Audible scraping against region redirects.

tests/api/system.routes.test.ts

@@ -57,16 +57,17 @@ describe('System routes', () => {
   });
 
   it('returns version info from environment', async () => {
-    process.env.APP_VERSION = 'abcdef123456';
+    process.env.APP_VERSION = '1.0.0';
+    process.env.GIT_COMMIT = 'abcdef123456';
     process.env.BUILD_DATE = '2025-01-01';
 
     const { GET } = await import('@/app/api/version/route');
     const response = await GET();
     const payload = await response.json();
 
-    expect(payload.shortCommit).toBe('abcdef1');
+    expect(payload.version).toBe('v1.0.0');
+    expect(payload.fullVersion).toBe('1.0.0');
+    expect(payload.commit).toBe('abcdef123456');
     expect(payload.buildDate).toBe('2025-01-01');
   });
 });
-
-

tests/components/ui/VersionBadge.test.tsx

@@ -9,11 +9,17 @@ import { afterEach, describe, expect, it, vi } from 'vitest';
 import { render, screen, waitFor } from '@testing-library/react';
 import { VersionBadge } from '@/components/ui/VersionBadge';
 
+const originalVersion = process.env.NEXT_PUBLIC_APP_VERSION;
 const originalCommit = process.env.NEXT_PUBLIC_GIT_COMMIT;
 
 describe('VersionBadge', () => {
   afterEach(() => {
     vi.unstubAllGlobals();
+    if (originalVersion === undefined) {
+      delete process.env.NEXT_PUBLIC_APP_VERSION;
+    } else {
+      process.env.NEXT_PUBLIC_APP_VERSION = originalVersion;
+    }
     if (originalCommit === undefined) {
       delete process.env.NEXT_PUBLIC_GIT_COMMIT;
     } else {
@@ -21,32 +27,33 @@ describe('VersionBadge', () => {
     }
   });
 
-  it('renders short version from build-time commit', async () => {
+  it('renders semantic version from build-time env var', async () => {
+    process.env.NEXT_PUBLIC_APP_VERSION = '1.0.0';
     process.env.NEXT_PUBLIC_GIT_COMMIT = 'abcdef1234';
     const fetchMock = vi.fn();
     vi.stubGlobal('fetch', fetchMock);
 
     render(<VersionBadge />);
 
-    expect(await screen.findByText('v.abcdef1')).toBeInTheDocument();
+    expect(await screen.findByText('v1.0.0')).toBeInTheDocument();
     expect(fetchMock).not.toHaveBeenCalled();
   });
 
-  it('falls back to API when build-time commit is unavailable', async () => {
-    process.env.NEXT_PUBLIC_GIT_COMMIT = 'unknown';
+  it('falls back to API when build-time version is unavailable', async () => {
+    process.env.NEXT_PUBLIC_APP_VERSION = 'unknown';
     const fetchMock = vi.fn().mockResolvedValue({
-      json: async () => ({ version: 'v.1.2.3' }),
+      json: async () => ({ version: 'v1.2.3', commit: 'abc1234' }),
     });
     vi.stubGlobal('fetch', fetchMock);
 
     render(<VersionBadge />);
 
-    expect(await screen.findByText('v.1.2.3')).toBeInTheDocument();
+    expect(await screen.findByText('v1.2.3')).toBeInTheDocument();
     expect(fetchMock).toHaveBeenCalledWith('/api/version');
   });
 
   it('shows dev version when API fetch fails', async () => {
-    process.env.NEXT_PUBLIC_GIT_COMMIT = 'unknown';
+    process.env.NEXT_PUBLIC_APP_VERSION = 'unknown';
     const fetchMock = vi.fn().mockRejectedValue(new Error('down'));
     const errorMock = vi.spyOn(console, 'error').mockImplementation(() => undefined);
     vi.stubGlobal('fetch', fetchMock);
@@ -54,7 +61,7 @@ describe('VersionBadge', () => {
     render(<VersionBadge />);
 
     await waitFor(() => {
-      expect(screen.getByText('v.dev')).toBeInTheDocument();
+      expect(screen.getByText('vDEV')).toBeInTheDocument();
     });
     expect(errorMock).toHaveBeenCalledWith('Failed to fetch version:', expect.any(Error));
   });