Initial import

2025-11-30 03:11:18 +00:00
commit 3607376d58
134 changed files with 19618 additions and 0 deletions
--- a/backend/.gitignore
+++ b/backend/.gitignore
@@ -0,0 +1,56 @@
+# compiled output
+/dist
+/node_modules
+/build
+
+# Logs
+logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# OS
+.DS_Store
+
+# Tests
+/coverage
+/.nyc_output
+
+# IDEs and editors
+/.idea
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+
+# IDE - VSCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# temp directory
+.temp
+.tmp
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
--- a/backend/.prettierrc
+++ b/backend/.prettierrc
@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}
--- a/backend/README.md
+++ b/backend/README.md
@@ -0,0 +1,98 @@
+<p align="center">
+  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
+</p>
+
+[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
+[circleci-url]: https://circleci.com/gh/nestjs/nest
+
+  <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
+    <p align="center">
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/dm/@nestjs/common.svg" alt="NPM Downloads" /></a>
+<a href="https://circleci.com/gh/nestjs/nest" target="_blank"><img src="https://img.shields.io/circleci/build/github/nestjs/nest/master" alt="CircleCI" /></a>
+<a href="https://discord.gg/G7Qnnhy" target="_blank"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a>
+<a href="https://opencollective.com/nest#backer" target="_blank"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
+<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
+  <a href="https://paypal.me/kamilmysliwiec" target="_blank"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg" alt="Donate us"/></a>
+    <a href="https://opencollective.com/nest#sponsor"  target="_blank"><img src="https://img.shields.io/badge/Support%20us-Open%20Collective-41B883.svg" alt="Support us"></a>
+  <a href="https://twitter.com/nestframework" target="_blank"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow" alt="Follow us on Twitter"></a>
+</p>
+  <!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
+  [![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
+
+## Description
+
+[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository.
+
+## Project setup
+
+```bash
+$ npm install
+```
+
+## Compile and run the project
+
+```bash
+# development
+$ npm run start
+
+# watch mode
+$ npm run start:dev
+
+# production mode
+$ npm run start:prod
+```
+
+## Run tests
+
+```bash
+# unit tests
+$ npm run test
+
+# e2e tests
+$ npm run test:e2e
+
+# test coverage
+$ npm run test:cov
+```
+
+## Deployment
+
+When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information.
+
+If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps:
+
+```bash
+$ npm install -g @nestjs/mau
+$ mau deploy
+```
+
+With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure.
+
+## Resources
+
+Check out a few resources that may come in handy when working with NestJS:
+
+- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework.
+- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy).
+- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/).
+- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks.
+- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com).
+- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com).
+- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs).
+- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com).
+
+## Support
+
+Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
+
+## Stay in touch
+
+- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- Twitter - [@nestframework](https://twitter.com/nestframework)
+
+## License
+
+Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE).
--- a/backend/eslint.config.mjs
+++ b/backend/eslint.config.mjs
@@ -0,0 +1,35 @@
+// @ts-check
+import eslint from '@eslint/js';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  {
+    ignores: ['eslint.config.mjs'],
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  eslintPluginPrettierRecommended,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.jest,
+      },
+      sourceType: 'commonjs',
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+  {
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-floating-promises': 'warn',
+      '@typescript-eslint/no-unsafe-argument': 'warn',
+      "prettier/prettier": ["error", { endOfLine: "auto" }],
+    },
+  },
+);
--- a/backend/nest-cli.json
+++ b/backend/nest-cli.json
@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}
--- a/backend/package-lock.json
+++ b/backend/package-lock.json
--- a/backend/package.json
+++ b/backend/package.json
@@ -0,0 +1,74 @@
+{
+  "name": "backend",
+  "version": "0.0.1",
+  "description": "",
+  "author": "",
+  "private": true,
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "nest build",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:e2e": "jest --config ./test/jest-e2e.json"
+  },
+  "dependencies": {
+    "@google/generative-ai": "^0.24.1",
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/platform-express": "^11.0.1",
+    "dotenv": "^17.2.3",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "undici": "^7.16.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.7",
+    "@types/supertest": "^6.0.2",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^16.0.0",
+    "jest": "^30.0.0",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}
--- a/backend/src/app.controller.spec.ts
+++ b/backend/src/app.controller.spec.ts
@@ -0,0 +1,22 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+
+describe('AppController', () => {
+  let appController: AppController;
+
+  beforeEach(async () => {
+    const app: TestingModule = await Test.createTestingModule({
+      controllers: [AppController],
+      providers: [AppService],
+    }).compile();
+
+    appController = app.get<AppController>(AppController);
+  });
+
+  describe('root', () => {
+    it('should return "Hello World!"', () => {
+      expect(appController.getHello()).toBe('Hello World!');
+    });
+  });
+});
--- a/backend/src/app.controller.ts
+++ b/backend/src/app.controller.ts
@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from './app.service';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}
--- a/backend/src/app.module.ts
+++ b/backend/src/app.module.ts
@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+import { GlobalWordsModule } from './global-words/global-words.module';
+import { ImageEngineModule } from './image-engine/image-engine.module';
+
+@Module({
+  imports: [ImageEngineModule, GlobalWordsModule],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}
--- a/backend/src/app.service.ts
+++ b/backend/src/app.service.ts
@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHello(): string {
+    return 'Hello World!';
+  }
+}
--- a/backend/src/global-words/global-word.interface.ts
+++ b/backend/src/global-words/global-word.interface.ts
@@ -0,0 +1,12 @@
+export interface GlobalWord {
+  palabra: string;
+  categoria: string;
+  tema: string;
+  descripcion: string;
+}
+
+export interface WordWithAsset extends GlobalWord {
+  slug: string;
+  imageUrl: string | null;
+  imageStatus: 'ready' | 'pending';
+}
--- a/backend/src/global-words/global-words.controller.ts
+++ b/backend/src/global-words/global-words.controller.ts
@@ -0,0 +1,44 @@
+import {
+  Controller,
+  Get,
+  Param,
+  Post,
+  Res,
+  StreamableFile,
+  HttpStatus,
+  HttpCode,
+} from '@nestjs/common';
+import type { Response } from 'express';
+import { createReadStream } from 'node:fs';
+import { GlobalWordsService } from './global-words.service';
+
+@Controller('global-words')
+export class GlobalWordsController {
+  constructor(private readonly globalWordsService: GlobalWordsService) {}
+
+  @Get()
+  async getWords() {
+    return this.globalWordsService.listWords();
+  }
+
+  @Post('prefetch')
+  @HttpCode(HttpStatus.ACCEPTED)
+  async prefetchAll() {
+    this.globalWordsService.prefetchAll();
+    return { status: 'scheduled' };
+  }
+
+  @Post(':slug/generate')
+  async generateForWord(@Param('slug') slug: string) {
+    await this.globalWordsService.ensureImage(slug);
+    return { slug, status: 'ready' };
+  }
+
+  @Get(':slug/image')
+  async getImage(@Param('slug') slug: string, @Res({ passthrough: true }) res: Response) {
+    const asset = await this.globalWordsService.ensureImage(slug);
+    res.setHeader('Content-Type', asset.mimeType);
+    const file = createReadStream(asset.path);
+    return new StreamableFile(file);
+  }
+}
--- a/backend/src/global-words/global-words.module.ts
+++ b/backend/src/global-words/global-words.module.ts
@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { GlobalWordsController } from './global-words.controller';
+import { GlobalWordsService } from './global-words.service';
+import { ImageEngineModule } from '../image-engine/image-engine.module';
+
+@Module({
+  imports: [ImageEngineModule],
+  controllers: [GlobalWordsController],
+  providers: [GlobalWordsService],
+  exports: [GlobalWordsService],
+})
+export class GlobalWordsModule {}
--- a/backend/src/global-words/global-words.service.ts
+++ b/backend/src/global-words/global-words.service.ts
@@ -0,0 +1,150 @@
+import { Injectable, Logger, NotFoundException, OnModuleInit } from '@nestjs/common';
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import type { GlobalWord, WordWithAsset } from './global-word.interface';
+import { ImageEngineService } from '../image-engine/image-engine.service';
+
+@Injectable()
+export class GlobalWordsService implements OnModuleInit {
+  private readonly logger = new Logger(GlobalWordsService.name);
+  private readonly repoRoot = path.resolve(process.cwd(), '..');
+  private readonly contentRoot = path.join(this.repoRoot, 'content');
+  private readonly wordsPath = path.join(this.contentRoot, 'palabras-globales.json');
+  private readonly assetsDir = path.join(this.contentRoot, 'generated', 'global-words');
+  private wordsCache: GlobalWord[] | null = null;
+
+  constructor(private readonly imageEngine: ImageEngineService) {}
+
+  async onModuleInit() {
+    await fs.mkdir(this.assetsDir, { recursive: true });
+    // Lanzamos prefetch en background.
+    this.prefetchAll().catch((error) =>
+      this.logger.error('No se pudieron precargar todas las imágenes', error as Error),
+    );
+  }
+
+  private async loadWords(): Promise<GlobalWord[]> {
+    if (!this.wordsCache) {
+      const raw = await fs.readFile(this.wordsPath, 'utf8');
+      this.wordsCache = JSON.parse(raw) as GlobalWord[];
+    }
+    return this.wordsCache;
+  }
+
+  private slugify(text: string) {
+    return text
+      .normalize('NFD')
+      .replace(/[\u0300-\u036f]/g, '')
+      .replace(/[^a-zA-Z0-9]+/g, '-')
+      .replace(/^-+|-+$/g, '')
+      .toLowerCase();
+  }
+
+  private readonly mimeByExtension: Record<string, string> = {
+    png: 'image/png',
+    webp: 'image/webp',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    svg: 'image/svg+xml',
+  };
+
+  private async resolveExistingAsset(slug: string) {
+    for (const ext of Object.keys(this.mimeByExtension)) {
+      const candidate = path.join(this.assetsDir, `${slug}.${ext}`);
+      try {
+        await fs.access(candidate);
+        return { path: candidate, mimeType: this.mimeByExtension[ext] };
+      } catch {
+        // keep iterating
+      }
+    }
+    return null;
+  }
+
+  private buildPrompt(word: GlobalWord) {
+    return `Ilustración infantil estilo acuarela, vibrante y amigable para niños pequeños. Palabra clave: "${word.palabra}". Tema: ${word.tema}. Categoría: ${word.categoria}. Descripción: ${word.descripcion}. Usa los colores azul y oro si es un elemento de fútbol o autos. Fondo suave, detalles simples.`;
+  }
+
+  async listWords(): Promise<WordWithAsset[]> {
+    const words = await this.loadWords();
+    return Promise.all(
+      words.map(async (word) => {
+        const slug = this.slugify(word.palabra);
+        const existing = await this.resolveExistingAsset(slug);
+        return {
+          ...word,
+          slug,
+          imageUrl: existing ? `/global-words/${slug}/image` : null,
+          imageStatus: existing ? 'ready' : 'pending',
+        };
+      }),
+    );
+  }
+
+  private async findWordBySlug(slug: string): Promise<GlobalWord & { slug: string }> {
+    const words = await this.loadWords();
+    const found = words
+      .map((word) => ({ ...word, slug: this.slugify(word.palabra) }))
+      .find((word) => word.slug === slug);
+    if (!found) {
+      throw new NotFoundException(`No existe la palabra con slug ${slug}`);
+    }
+    return found;
+  }
+
+  async ensureImage(slug: string) {
+    const word = await this.findWordBySlug(slug);
+    const existing = await this.resolveExistingAsset(slug);
+    if (existing) {
+      return existing;
+    }
+    this.logger.log(`Generando imagen para ${word.palabra}`);
+    const prompt = this.buildPrompt(word);
+    try {
+      const asset = await this.imageEngine.generate(word, slug, prompt);
+      return asset;
+    } catch (error) {
+      this.logger.warn(
+        `No se pudo generar ${word.palabra} con el motor local, usando placeholder. Motivo: ${
+          (error as Error).message
+        }`,
+      );
+      const svgBuffer = this.buildPlaceholder(word);
+      const filePath = path.join(this.assetsDir, `${slug}.svg`);
+      await fs.writeFile(filePath, svgBuffer);
+      return { path: filePath, mimeType: this.mimeByExtension.svg };
+    }
+  }
+
+  async prefetchAll() {
+    const words = await this.loadWords();
+    for (const word of words) {
+      const slug = this.slugify(word.palabra);
+      if (await this.resolveExistingAsset(slug)) continue;
+      await this.ensureImage(slug);
+      await new Promise((resolve) => setTimeout(resolve, 400)); // evita saturar API
+    }
+  }
+
+  private buildPlaceholder(word: GlobalWord) {
+    const background = word.categoria === 'fútbol' ? '#13347a' : '#ffe6b3';
+    const accent = word.categoria === 'fútbol' ? '#f7c948' : '#1967d2';
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512">
+      <defs>
+        <linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
+          <stop offset="0%" stop-color="${background}" stop-opacity="0.9"/>
+          <stop offset="100%" stop-color="${accent}" stop-opacity="0.9"/>
+        </linearGradient>
+      </defs>
+      <rect width="512" height="512" fill="url(#grad)" rx="42" ry="42"/>
+      <text x="50%" y="45%" font-size="120" font-family="Nunito, Arial" font-weight="800" text-anchor="middle" fill="#ffffff">${word.palabra}</text>
+      <text x="50%" y="62%" font-size="36" font-family="Nunito, Arial" text-anchor="middle" fill="#ffffff" opacity="0.85">${word.categoria}</text>
+      <foreignObject x="56" y="320" width="400" height="160">
+        <div xmlns="http://www.w3.org/1999/xhtml" style="font-size:28px;font-family:Nunito,Arial;text-align:center;color:#fff;">
+          ${word.descripcion}
+        </div>
+      </foreignObject>
+    </svg>`;
+    return Buffer.from(svg);
+  }
+}
--- a/backend/src/image-engine/image-engine.module.ts
+++ b/backend/src/image-engine/image-engine.module.ts
@@ -0,0 +1,8 @@
+import { Module } from '@nestjs/common';
+import { ImageEngineService } from './image-engine.service';
+
+@Module({
+  providers: [ImageEngineService],
+  exports: [ImageEngineService],
+})
+export class ImageEngineModule {}
--- a/backend/src/image-engine/image-engine.service.ts
+++ b/backend/src/image-engine/image-engine.service.ts
@@ -0,0 +1,49 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { fetch } from 'undici';
+import type { GlobalWord } from '../global-words/global-word.interface';
+
+interface GenerateResponse {
+  path: string;
+  mimeType?: string;
+}
+
+@Injectable()
+export class ImageEngineService {
+  private readonly logger = new Logger(ImageEngineService.name);
+  private readonly baseUrl = process.env.IMAGE_SERVICE_URL ?? 'http://localhost:8001';
+
+  async generate(word: GlobalWord, slug: string, prompt: string) {
+    const response = await fetch(`${this.baseUrl}/generate`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        prompt,
+        slug,
+        negative_prompt: 'text, watermark, logo, disfigured, deformed',
+        width: 640,
+        height: 512,
+        steps: 4,
+      }),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      this.logger.error(
+        `Image service error ${response.status}: ${errorText}`,
+      );
+      throw new Error(
+        `Image service responded with ${response.status}: ${errorText}`,
+      );
+    }
+
+    const data = (await response.json()) as GenerateResponse;
+    if (!data?.path) {
+      throw new Error('Image service did not return a file path');
+    }
+
+    return {
+      path: data.path,
+      mimeType: data.mimeType ?? 'image/png',
+    };
+  }
+}
--- a/backend/src/main.ts
+++ b/backend/src/main.ts
@@ -0,0 +1,15 @@
+import { config } from 'dotenv';
+import * as path from 'node:path';
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+config({ path: path.resolve(process.cwd(), '..', '.env') });
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  app.enableCors({
+    origin: process.env.CLIENT_ORIGIN ?? true,
+  });
+  await app.listen(process.env.PORT ?? 3000);
+}
+bootstrap();
--- a/backend/test/app.e2e-spec.ts
+++ b/backend/test/app.e2e-spec.ts
@@ -0,0 +1,25 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { INestApplication } from '@nestjs/common';
+import request from 'supertest';
+import { App } from 'supertest/types';
+import { AppModule } from './../src/app.module';
+
+describe('AppController (e2e)', () => {
+  let app: INestApplication<App>;
+
+  beforeEach(async () => {
+    const moduleFixture: TestingModule = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+
+    app = moduleFixture.createNestApplication();
+    await app.init();
+  });
+
+  it('/ (GET)', () => {
+    return request(app.getHttpServer())
+      .get('/')
+      .expect(200)
+      .expect('Hello World!');
+  });
+});
--- a/backend/test/jest-e2e.json
+++ b/backend/test/jest-e2e.json
@@ -0,0 +1,9 @@
+{
+  "moduleFileExtensions": ["js", "json", "ts"],
+  "rootDir": ".",
+  "testEnvironment": "node",
+  "testRegex": ".e2e-spec.ts$",
+  "transform": {
+    "^.+\\.(t|j)s$": "ts-jest"
+  }
+}
--- a/backend/tsconfig.build.json
+++ b/backend/tsconfig.build.json
@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}
--- a/backend/tsconfig.json
+++ b/backend/tsconfig.json
@@ -0,0 +1,25 @@
+{
+  "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",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "forceConsistentCasingInFileNames": true,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "noFallthroughCasesInSwitch": false
+  }
+}