feat(260928-ujj): Dashboard-Hintergrund pro Benutzer in der Datenbank

- Spalte User.dashboardBackground (JSONB) samt Migration
- PATCH /users/me/dashboard-background, geprueft mit parseDashboardBackground aus @tessera/shared (Allowlist, UUID-Bildkennung)
- getMe liefert dashboardBackground normalisiert neben accentColor
- Web liest die Wahl aus dem Auth-Store, speichert ueber die Server-Aktion, alte localStorage-Wahl wird einmalig uebernommen
- Hinweistext: gilt auf jedem Geraet

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-28 22:13:49 +02:00
parent 76f6d87973
commit 0aaa15240d
16 changed files with 333 additions and 66 deletions
+43
View File
@@ -20,6 +20,8 @@ import { FileInterceptor } from '@nestjs/platform-express';
import { Role } from '@prisma/client';
import {
compareReleaseVersions,
type DashboardBackground,
parseDashboardBackground,
parseReleaseVersion,
type ReleaseNoticeResponse,
} from '@tessera/shared';
@@ -62,6 +64,10 @@ function resolveAvatarsDir(): string {
* Selbstbedienungswege `GET me/release-notice` und `POST me/release-seen`
* ("Was ist neu"-Fenster), ebenfalls `forTenant()` mit
* `where: { id: currentUser.id }`.
*
* quick-260928-ujj: dazu kommt ein gebundener Zugriff des
* Selbstbedienungswegs `PATCH me/dashboard-background`, ebenfalls
* `forTenant()` mit `where: { id: currentUser.id }`.
*/
@Controller('users')
@UseGuards(RolesGuard)
@@ -483,6 +489,43 @@ export class UserController {
return { success: true };
}
/**
* PATCH /users/me/dashboard-background (quick-260928-ujj)
*
* Speichert den gewaehlten Dashboard-Hintergrund des angemeldeten
* Benutzers. Jeder angemeldete Benutzer, kein `@Roles`.
*
* T-ujj-01 (Tampering): der Wert wird spaeter als CSS-Hintergrund
* gerendert. `parseDashboardBackground` (@tessera/shared) laesst nur
* `kind` none/preset/image, bekannte Preset-Kennungen und eine UUID als
* Bildkennung zu und baut ein frisches Objekt ohne Zusatzschluessel;
* alles andere ergibt 400 ohne Schreibzugriff. Bewusst Inline-Body-Typ
* statt DTO-Klasse (wie `me/accent-color`): die globale ValidationPipe mit
* `whitelist` wuerde das verschachtelte Objekt sonst nicht pruefen.
*
* T-ujj-02 (Elevation of Privilege): kein Kennungsparameter; geschrieben
* wird ausschliesslich die eigene Zeile (`where: { id: currentUser.id }`)
* ueber `forTenant(this.prisma, currentUser.tenantId)`.
*/
@Patch('me/dashboard-background')
async updateDashboardBackground(
@Body() body: { background: unknown },
@CurrentUser() currentUser: AuthUser,
): Promise<{ success: true; dashboardBackground: DashboardBackground }> {
const background = parseDashboardBackground(body?.background);
if (background === null) {
throw new BadRequestException('Invalid dashboard background.');
}
const tenantPrisma = forTenant(this.prisma, currentUser.tenantId);
await tenantPrisma.user.update({
where: { id: currentUser.id },
data: { dashboardBackground: background },
});
return { success: true, dashboardBackground: background };
}
/**
* GET /users/me/avatar
* Stream the current user's avatar image.