feat: implement ROMs management UI (Phase 8)

Backend (Phase 8.1):
- Add ROMs endpoints: GET, GET/:id, PUT/:id/game, DELETE
- Add metadata search endpoint using IGDB/RAWG/TGDB
- Implement RomsController with ROM CRUD logic
- Add 12 comprehensive ROM endpoint tests
- Configure Vitest to run tests sequentially (threads: false)
- Auto-apply Prisma migrations in test setup

Frontend (Phase 8.2 + 8.3):
- Create ROM types: RomFile, Artwork, EnrichedGame
- Extend API client with roms and metadata namespaces
- Implement 5 custom hooks with TanStack Query
- Create ScanDialog, MetadataSearchDialog, RomCard components
- Rewrite roms.tsx page with table and all actions
- Add 37 comprehensive component and page tests

All 122 tests passing: 63 backend + 59 frontend
Lint: 0 errors, only unused directive warnings

backend/tests/routes/metadata.spec.ts

@@ -0,0 +1,101 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { buildApp } from '../../src/app';
+import { FastifyInstance } from 'fastify';
+import * as metadataService from '../../src/services/metadataService';
+
+describe('Metadata API', () => {
+  let app: FastifyInstance;
+
+  beforeEach(async () => {
+    app = buildApp();
+    await app.ready();
+  });
+
+  afterEach(async () => {
+    await app.close();
+    vi.restoreAllMocks();
+  });
+
+  describe('GET /api/metadata/search', () => {
+    it('debería devolver resultados cuando se busca un juego existente', async () => {
+      const mockResults = [
+        {
+          source: 'igdb',
+          externalIds: { igdb: 1 },
+          title: 'The Legend of Zelda',
+          slug: 'the-legend-of-zelda',
+          releaseDate: '1986-02-21',
+          genres: ['Adventure'],
+          coverUrl: 'https://example.com/cover.jpg',
+        },
+      ];
+
+      vi.spyOn(metadataService, 'enrichGame').mockResolvedValue(mockResults[0]);
+
+      const res = await app.inject({
+        method: 'GET',
+        url: '/api/metadata/search?q=zelda',
+      });
+
+      expect(res.statusCode).toBe(200);
+      const body = res.json();
+      expect(Array.isArray(body)).toBe(true);
+      expect(body.length).toBeGreaterThan(0);
+      expect(body[0].title).toContain('Zelda');
+    });
+
+    it('debería devolver lista vacía cuando no hay resultados', async () => {
+      vi.spyOn(metadataService, 'enrichGame').mockResolvedValue(null);
+
+      const res = await app.inject({
+        method: 'GET',
+        url: '/api/metadata/search?q=nonexistentgame12345',
+      });
+
+      expect(res.statusCode).toBe(200);
+      const body = res.json();
+      expect(Array.isArray(body)).toBe(true);
+      expect(body.length).toBe(0);
+    });
+
+    it('debería devolver 400 si falta el parámetro query', async () => {
+      const res = await app.inject({
+        method: 'GET',
+        url: '/api/metadata/search',
+      });
+
+      expect(res.statusCode).toBe(400);
+      expect(res.json()).toHaveProperty('error');
+    });
+
+    it('debería devolver 400 si el parámetro query está vacío', async () => {
+      const res = await app.inject({
+        method: 'GET',
+        url: '/api/metadata/search?q=',
+      });
+
+      expect(res.statusCode).toBe(400);
+    });
+
+    it('debería pasar el parámetro platform a enrichGame si se proporciona', async () => {
+      const enrichSpy = vi.spyOn(metadataService, 'enrichGame').mockResolvedValue(null);
+
+      const res = await app.inject({
+        method: 'GET',
+        url: '/api/metadata/search?q=mario&platform=Nintendo%2064',
+      });
+
+      expect(res.statusCode).toBe(200);
+      expect(enrichSpy).toHaveBeenCalledWith({
+        title: 'mario',
+        platform: 'Nintendo 64',
+      });
+    });
+  });
+});
+
+/**
+ * Metadatos:
+ * Autor: GitHub Copilot
+ * Última actualización: 2026-02-11
+ */