feat: add Cypress e2e app and tighten local Docker + seed workflow

- Add @nbw/e2e (Cypress, smoke spec, shared clock from @nbw/config); root cy:open / test:cy
  and apps/e2e postinstall for the Cypress binary.
- Docker: minio-init profile + root docker:* scripts; disable flaky MailDev healthcheck
  so compose --wait can finish; document flow in CONTRIBUTING.
- Backend: deterministic seed API, tests, UserService.update plain $set; move seed
  constants and SeedDevOptions into @nbw/config for reuse with Cypress.

Author: tomast1337

apps/backend/src/seed/seed.controller.spec.ts

@@ -1,13 +1,14 @@
 import { BadRequestException } from '@nestjs/common';
 import { Test, TestingModule } from '@nestjs/testing';
 
-import { SeedController } from './seed.controller';
-import { SeedService } from './seed.service';
 import {
   DEFAULT_SEED_DATA_TIME_CAP,
   DEFAULT_SEED_FAKER,
   SEED_USER_COUNT_MAX,
-} from './seed.types';
+} from '@nbw/config';
+
+import { SeedController } from './seed.controller';
+import { SeedService } from './seed.service';
 
 describe('SeedController', () => {
   let controller: SeedController;

apps/backend/src/seed/seed.controller.ts

@@ -7,14 +7,15 @@ import {
 } from '@nestjs/common';
 import { ApiOperation, ApiQuery, ApiTags } from '@nestjs/swagger';
 
-import { SeedService } from './seed.service';
 import {
   DEFAULT_SEED_DATA_TIME_CAP,
   DEFAULT_SEED_FAKER,
   SEED_USER_COUNT_MAX,
   SEED_USER_COUNT_MIN,
   type SeedDevOptions,
-} from './seed.types';
+} from '@nbw/config';
+
+import { SeedService } from './seed.service';
 
 @Controller('seed')
 @ApiTags('seed')

apps/backend/src/seed/seed.service.spec.ts

@@ -1,11 +1,11 @@
 import { Test, TestingModule } from '@nestjs/testing';
 
+import { DEFAULT_SEED_FAKER } from '@nbw/config';
 import type { UserDocument } from '@nbw/database';
 import { SongService } from '@server/song/song.service';
 import { UserService } from '@server/user/user.service';
 
 import { SeedService } from './seed.service';
-import { DEFAULT_SEED_FAKER } from './seed.types';
 
 describe('SeedService', () => {
   let service: SeedService;

apps/backend/src/seed/seed.service.ts

@@ -2,7 +2,14 @@ import { Instrument, Note, Song } from '@encode42/nbs.js';
 import { faker } from '@faker-js/faker';
 import { Inject, Injectable, Logger } from '@nestjs/common';
 
-import { UPLOAD_CONSTANTS } from '@nbw/config';
+import {
+  DEFAULT_SEED_DATA_TIME_CAP,
+  DEFAULT_SEED_FAKER,
+  SEED_USER_COUNT_MAX,
+  SEED_USER_COUNT_MIN,
+  type SeedDevOptions,
+  UPLOAD_CONSTANTS,
+} from '@nbw/config';
 import { SongDocument, type UserDocument } from '@nbw/database';
 import type {
   CategoryType,
@@ -13,14 +20,6 @@ import type {
 import { SongService } from '@server/song/song.service';
 import { UserService } from '@server/user/user.service';
 
-import {
-  DEFAULT_SEED_DATA_TIME_CAP,
-  DEFAULT_SEED_FAKER,
-  SEED_USER_COUNT_MAX,
-  SEED_USER_COUNT_MIN,
-  type SeedDevOptions,
-} from './seed.types';
-
 @Injectable()
 export class SeedService {
   public readonly logger = new Logger(SeedService.name);

apps/e2e/.gitignore

@@ -0,0 +1,3 @@
+cypress/downloads/
+cypress/screenshots/
+cypress/videos/

apps/e2e/cypress.config.ts

@@ -0,0 +1,26 @@
+/**
+ * E2E tests hit the Next app (default http://localhost:3000).
+ * Start the frontend before `cy:open` / `cy:run`. Many routes also need the API
+ * (see apps/frontend/.env.local.example: NEXT_PUBLIC_API_URL).
+ *
+ * Docker deps (Mongo, MinIO, MailDev): from repo root run `bun run docker:reset`
+ * before backend/tests when you need a clean stack; use `docker:reset:fresh` to
+ * wipe volumes as well.
+ *
+ * Browser time in specs can align with backend seed caps via `@nbw/config`
+ * (`DEFAULT_SEED_DATA_TIME_CAP`, `SEED_E2E_BROWSER_CLOCK_MS`).
+ */
+import { defineConfig } from 'cypress';
+
+const baseUrl =
+  process.env.CYPRESS_BASE_URL?.replace(/\/$/, '') ?? 'http://localhost:3000';
+
+export default defineConfig({
+  e2e: {
+    baseUrl,
+    supportFile: 'cypress/support/e2e.ts',
+    specPattern: 'cypress/e2e/**/*.cy.ts',
+    video: false,
+    screenshotOnRunFailure: true,
+  },
+});

apps/e2e/cypress/e2e/smoke.cy.ts

@@ -0,0 +1,9 @@
+import { SEED_E2E_BROWSER_CLOCK_MS } from '@nbw/config';
+
+describe('smoke', () => {
+  it('loads the home page', () => {
+    cy.clock(SEED_E2E_BROWSER_CLOCK_MS, ['Date']);
+    cy.visit('/');
+    cy.get('body').should('be.visible');
+  });
+});

apps/e2e/cypress/support/e2e.ts

@@ -0,0 +1 @@
+// Global setup for Cypress e2e runs (hooks and commands can be added here).

apps/e2e/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@nbw/e2e",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Cypress end-to-end tests for NoteBlockWorld",
+  "license": "ISC",
+  "scripts": {
+    "postinstall": "cypress install",
+    "build": "exit 0",
+    "start": "exit 0",
+    "dev": "exit 0",
+    "cy:open": "cypress open",
+    "cy:run": "cypress run"
+  },
+  "dependencies": {
+    "@nbw/config": "workspace:*"
+  },
+  "devDependencies": {
+    "cypress": "^14.3.0",
+    "typescript": "^5.9.2"
+  }
+}

apps/e2e/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "lib": ["ES2022", "DOM"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "noEmit": true,
+    "isolatedModules": true,
+    "esModuleInterop": true,
+    "types": ["cypress", "node"]
+  },
+  "include": ["cypress/**/*.ts", "cypress.config.ts"]
+}