add NestJS skeleton and GET /api/health-check.

Thin API bootstrap with config module and nullcart-style health route for Docker checks.

.gitignore

@@ -6,6 +6,7 @@
 
 /backend/node_modules
 /backend/dist
+/backend/*.tsbuildinfo
 /backend/storage
 
 /frontend/node_modules

backend/nest-cli.json

@@ -0,0 +1,8 @@
+{
+    "$schema": "https://json.schemastore.org/nest-cli",
+    "collection": "@nestjs/schematics",
+    "sourceRoot": "src",
+    "compilerOptions": {
+        "deleteOutDir": true
+    }
+}

backend/package.json

@@ -0,0 +1,28 @@
+{
+    "name": "backend",
+    "version": "0.0.1",
+    "private": true,
+    "license": "UNLICENSED",
+    "scripts": {
+        "build": "nest build",
+        "start": "nest start",
+        "start:dev": "nest start --watch",
+        "start:prod": "node dist/main"
+    },
+    "dependencies": {
+        "@nestjs/common": "^11.0.1",
+        "@nestjs/config": "^4.0.3",
+        "@nestjs/core": "^11.0.1",
+        "@nestjs/platform-express": "^11.0.1",
+        "class-transformer": "^0.5.1",
+        "class-validator": "^0.15.1",
+        "reflect-metadata": "^0.2.2"
+    },
+    "devDependencies": {
+        "@nestjs/cli": "^11.0.24",
+        "@nestjs/schematics": "^11.0.0",
+        "@types/express": "^5.0.0",
+        "@types/node": "^22.10.7",
+        "typescript": "~6.0.2"
+    }
+}

backend/src/AppModule.ts

@@ -0,0 +1,15 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import appConfig from './config';
+import { HealthCheckModule } from './modules/healthCheck/HealthCheckModule';
+
+@Module({
+    imports: [
+        ConfigModule.forRoot({
+            isGlobal: true,
+            load: [appConfig]
+        }),
+        HealthCheckModule
+    ]
+})
+export class AppModule {}

backend/src/config/index.ts

@@ -0,0 +1,22 @@
+import { registerAs } from '@nestjs/config';
+import { AppConfig } from '../types/AppConfig';
+import { NodeEnv } from '../types/NodeEnv';
+
+const env = (key: string): string => process.env[key] || '';
+
+const envInt = (key: string): number => parseInt(env(key), 10);
+
+export const getAppConfig = (): AppConfig => {
+    const rawOrigins = env('CORS_ORIGINS');
+
+    return {
+        port: envInt('BACKEND_PORT'),
+        nodeEnv: env('NODE_ENV') as NodeEnv,
+        corsOrigins: rawOrigins
+            .split(',')
+            .map(o => o.trim())
+            .filter(Boolean)
+    };
+};
+
+export default registerAs('app', getAppConfig);

backend/src/main.ts

@@ -0,0 +1,30 @@
+import { ValidationPipe } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './AppModule';
+import { AppConfig } from './types/AppConfig';
+
+async function bootstrap() {
+    const app = await NestFactory.create(AppModule);
+
+    const configService = app.get(ConfigService);
+    const { port, corsOrigins } = configService.get('app') as AppConfig;
+
+    app.setGlobalPrefix('api');
+
+    app.useGlobalPipes(
+        new ValidationPipe({
+            transform: true,
+            transformOptions: { enableImplicitConversion: true }
+        })
+    );
+
+    app.enableCors({
+        origin: corsOrigins,
+        credentials: true
+    });
+
+    await app.listen(port);
+}
+
+void bootstrap();

backend/src/modules/healthCheck/HealthCheckModule.ts

@@ -0,0 +1,7 @@
+import { Module } from '@nestjs/common';
+import { HealthCheckController } from './controllers/HealthCheckController';
+
+@Module({
+    controllers: [HealthCheckController]
+})
+export class HealthCheckModule {}

backend/src/modules/healthCheck/controllers/HealthCheckController.ts

@@ -0,0 +1,10 @@
+import { Controller, Get, HttpStatus, Res } from '@nestjs/common';
+import type { Response } from 'express';
+
+@Controller('/health-check')
+export class HealthCheckController {
+    @Get('/')
+    getStatus(@Res() res: Response) {
+        return res.sendStatus(HttpStatus.OK);
+    }
+}

backend/src/types/AppConfig.ts

@@ -0,0 +1,7 @@
+import { NodeEnv } from './NodeEnv';
+
+export type AppConfig = {
+    port: number;
+    nodeEnv: NodeEnv;
+    corsOrigins: string[];
+};

backend/src/types/NodeEnv.ts

@@ -0,0 +1,4 @@
+export enum NodeEnv {
+    Development = 'development',
+    Production = 'production'
+}

backend/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+    "extends": "./tsconfig.json",
+    "exclude": ["node_modules", "dist", "**/*spec.ts"]
+}

backend/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        "module": "nodenext",
+        "moduleResolution": "nodenext",
+        "resolvePackageJsonExports": true,
+        "esModuleInterop": true,
+        "isolatedModules": true,
+        "declaration": true,
+        "removeComments": true,
+        "emitDecoratorMetadata": true,
+        "experimentalDecorators": true,
+        "allowSyntheticDefaultImports": true,
+        "target": "ES2023",
+        "sourceMap": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "types": ["node"],
+        "incremental": true,
+        "skipLibCheck": true,
+        "strictNullChecks": true,
+        "strictPropertyInitialization": false,
+        "forceConsistentCasingInFileNames": true,
+        "noImplicitAny": false,
+        "strictBindCallApply": false,
+        "noFallthroughCasesInSwitch": false
+    }
+}