205 lines
8.3 KiB
TypeScript
205 lines
8.3 KiB
TypeScript
|
// services/api/src/public/public.service.ts —— 公开（观众端）读逻辑（Task 22
|
|||
|
|
// 起步：getPublicAlbum；Task 23 增补 listPublicPhotos / getPublicPhoto）。
|
|||
|
|
// 契约权威：packages/contracts/openapi.yaml tags [public]。要点：
|
|||
|
|
// · 相册定位只认 publicToken + status=active + publicEnabled——三者任一不满足
|
|||
|
|
// 统一 404 ALBUM_NOT_PUBLIC（同码防枚举，持有链接即可访问，无认证语义）。
|
|||
|
|
// · 语言回退（需求 4.7）：请求 locale ∈ 契约枚举（zh-CN/en）且相册有该语言
|
|||
|
|
// 翻译条目 → 用之；否则回退 defaultLocale（创建/更新路径保证 defaultLocale
|
|||
|
|
// 条目必在，缺行属装配异常按 5xx 兜底）。非法 locale 值不报 400（Task 5
|
|||
|
|
// 决策），与缺省同样走回退；resolvedLocale 向客户端指示实际返回语言。
|
|||
|
|
// · 分类名称同语言解析：resolved locale → defaultLocale → 任一既有条目
|
|||
|
|
// （确定性：locale 升序取首）；分类创建必附翻译，末级分支纯防御。
|
|||
|
|
// · banner：album_assets(kind=banner) 多行时取最新一条（createdAt DESC,
|
|||
|
|
// id DESC 决胜）；P1a 无按语言选封面概念（locale 列为 P1b 上传链路预留）。
|
|||
|
|
// · 签名 URL 一律现签（SIGNED_URL_TTL_SECONDS 惰性读取，SigV4 本地计算无
|
|||
|
|
// 网络副作用）；单图定位端点是契约规定的过期刷新入口。
|
|||
|
|
// · viewCount：P1a 占位 null（§7.1 /visits 端点后续提供）。
|
|||
|
|
// · 限流：公开端点 P1a 不做（P2 引入点赞限流时一并评估），此处仅记录约定。
|
|||
|
|
import { HttpStatus, Inject, Injectable } from '@nestjs/common';
|
|||
|
|
import type { components } from '@photo/contracts';
|
|||
|
|
import { ErrorCodes } from '@photo/contracts';
|
|||
|
|
import type { Prisma } from '@photo/db-cn';
|
|||
|
|
import type { StoragePort } from '@photo/storage';
|
|||
|
|
import { ApiException } from '../api-exception';
|
|||
|
|
import { ALBUM_LOCALES, type AlbumLocale } from '../albums/dto';
|
|||
|
|
import { PrismaService } from '../prisma/prisma.service';
|
|||
|
|
import { STORAGE_PORT } from '../uploads/storage.provider';
|
|||
|
|
import { signedUrlTtlSeconds } from '../uploads/support';
|
|||
|
|
import { albumNotPublic } from './support';
|
|||
|
|
|
|||
|
|
export type PublicAlbumResponse = components['schemas']['PublicAlbum'];
|
|||
|
|
export type PublicPhotoListResponse =
|
|||
|
|
components['schemas']['PublicPhotoList'];
|
|||
|
|
export type PublicPhotoDetailResponse =
|
|||
|
|
components['schemas']['PublicPhotoDetail'];
|
|||
|
|
type SignedUrlResponse = components['schemas']['SignedUrl'];
|
|||
|
|
|
|||
|
|
type AlbumRow = Prisma.albumsGetPayload<Prisma.albumsDefaultArgs>;
|
|||
|
|
type AlbumTranslationRow = Prisma.album_translationsGetPayload<
|
|||
|
|
Prisma.album_translationsDefaultArgs
|
|||
|
|
>;
|
|||
|
|
|
|||
|
|
/** 契约 listPublicPhotos：limit 缺省 30，上下界 1..60（§7 建议 30-60）。 */
|
|||
|
|
export const DEFAULT_PUBLIC_PHOTO_PAGE_SIZE = 30;
|
|||
|
|
export const MAX_PUBLIC_PHOTO_PAGE_SIZE = 60;
|
|||
|
|
|
|||
|
|
@Injectable()
|
|||
|
|
export class PublicService {
|
|||
|
|
constructor(
|
|||
|
|
private readonly prisma: PrismaService,
|
|||
|
|
@Inject(STORAGE_PORT) private readonly storage: StoragePort,
|
|||
|
|
) {}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 公开相册信息：token → 相册（active+public）→ 翻译回退解析 → 分类（同语言
|
|||
|
|
* 名称）→ banner 签名。响应不含工作人员信息与内部存储键（契约 PublicAlbum）。
|
|||
|
|
*/
|
|||
|
|
async getPublicAlbum(
|
|||
|
|
token: string,
|
|||
|
|
localeRaw: string | undefined,
|
|||
|
|
): Promise<PublicAlbumResponse> {
|
|||
|
|
const album = await this.findPublicAlbum(token);
|
|||
|
|
const translations = await this.prisma.album_translations.findMany({
|
|||
|
|
where: { albumId: album.id },
|
|||
|
|
orderBy: { locale: 'asc' },
|
|||
|
|
});
|
|||
|
|
const resolved = this.resolveTranslation(
|
|||
|
|
album.defaultLocale,
|
|||
|
|
translations,
|
|||
|
|
localeRaw,
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
// 分类：sortOrder 升序（契约），id 决胜保证确定性输出。
|
|||
|
|
const categories = await this.prisma.categories.findMany({
|
|||
|
|
where: { albumId: album.id },
|
|||
|
|
orderBy: [{ sortOrder: 'asc' }, { id: 'asc' }],
|
|||
|
|
});
|
|||
|
|
const categoryTranslations =
|
|||
|
|
categories.length === 0
|
|||
|
|
? []
|
|||
|
|
: await this.prisma.category_translations.findMany({
|
|||
|
|
where: { categoryId: { in: categories.map((c) => c.id) } },
|
|||
|
|
orderBy: { locale: 'asc' },
|
|||
|
|
});
|
|||
|
|
const namesByCategory = new Map<string, Map<string, string>>();
|
|||
|
|
for (const row of categoryTranslations) {
|
|||
|
|
let bucket = namesByCategory.get(row.categoryId);
|
|||
|
|
if (bucket === undefined) {
|
|||
|
|
bucket = new Map();
|
|||
|
|
namesByCategory.set(row.categoryId, bucket);
|
|||
|
|
}
|
|||
|
|
bucket.set(row.locale, row.name);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// banner：最新 banner 资产行现签（无行 → null）。
|
|||
|
|
const bannerAsset = await this.prisma.album_assets.findFirst({
|
|||
|
|
where: { albumId: album.id, kind: 'banner' },
|
|||
|
|
orderBy: [{ createdAt: 'desc' }, { id: 'desc' }],
|
|||
|
|
});
|
|||
|
|
const banner =
|
|||
|
|
bannerAsset === null
|
|||
|
|
? null
|
|||
|
|
: await this.presign(bannerAsset.objectKey);
|
|||
|
|
|
|||
|
|
return {
|
|||
|
|
publicToken: album.publicToken,
|
|||
|
|
resolvedLocale: resolved.locale,
|
|||
|
|
defaultLocale: album.defaultLocale as AlbumLocale,
|
|||
|
|
timezone: album.timezone,
|
|||
|
|
startAt: album.startAt.toISOString(),
|
|||
|
|
endAt: album.endAt === null ? null : album.endAt.toISOString(),
|
|||
|
|
translation: {
|
|||
|
|
locale: resolved.locale,
|
|||
|
|
title: resolved.row.title,
|
|||
|
|
description: resolved.row.description,
|
|||
|
|
venue: resolved.row.venue,
|
|||
|
|
address: resolved.row.address,
|
|||
|
|
},
|
|||
|
|
categories: categories.map((c) => ({
|
|||
|
|
id: c.id,
|
|||
|
|
name: this.resolveCategoryName(
|
|||
|
|
namesByCategory.get(c.id),
|
|||
|
|
resolved.locale,
|
|||
|
|
album.defaultLocale,
|
|||
|
|
),
|
|||
|
|
sortOrder: c.sortOrder,
|
|||
|
|
})),
|
|||
|
|
banner,
|
|||
|
|
// P1a 占位：浏览计数由后续 /visits 端点提供（技术实施方案 §7.1）。
|
|||
|
|
viewCount: null,
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 相册定位：publicToken 唯一索引；不存在 / offline / 未公开统一 404
|
|||
|
|
* ALBUM_NOT_PUBLIC。
|
|||
|
|
*/
|
|||
|
|
private async findPublicAlbum(token: string): Promise<AlbumRow> {
|
|||
|
|
const album = await this.prisma.albums.findUnique({
|
|||
|
|
where: { publicToken: token },
|
|||
|
|
});
|
|||
|
|
if (album === null || album.status !== 'active' || !album.publicEnabled) {
|
|||
|
|
throw albumNotPublic();
|
|||
|
|
}
|
|||
|
|
return album;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 语言回退解析（需求 4.7）：请求 locale 合法（契约枚举）且有翻译条目 → 用之；
|
|||
|
|
* 否则 defaultLocale。defaultLocale 条目由创建/更新路径的跨字段校验保证必在，
|
|||
|
|
* 缺行属装配异常，按 5xx 兜底（公开端点不得以半翻译状态 200）。
|
|||
|
|
*/
|
|||
|
|
private resolveTranslation(
|
|||
|
|
defaultLocale: string,
|
|||
|
|
rows: AlbumTranslationRow[],
|
|||
|
|
requested: string | undefined,
|
|||
|
|
): { locale: AlbumLocale; row: AlbumTranslationRow } {
|
|||
|
|
const byLocale = new Map(rows.map((row) => [row.locale, row]));
|
|||
|
|
const defaultRow = byLocale.get(defaultLocale);
|
|||
|
|
if (defaultRow === undefined) {
|
|||
|
|
throw new ApiException(
|
|||
|
|
ErrorCodes.INTERNAL_ERROR,
|
|||
|
|
'Internal server error',
|
|||
|
|
HttpStatus.INTERNAL_SERVER_ERROR,
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
if (
|
|||
|
|
requested !== undefined &&
|
|||
|
|
(ALBUM_LOCALES as readonly string[]).includes(requested)
|
|||
|
|
) {
|
|||
|
|
const row = byLocale.get(requested);
|
|||
|
|
if (row !== undefined) {
|
|||
|
|
return { locale: requested as AlbumLocale, row };
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
return { locale: defaultLocale as AlbumLocale, row: defaultRow };
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 分类名称解析：resolved locale → defaultLocale → 任一既有条目（locale 升序
|
|||
|
|
* 首，确定性输出）。分类创建必附翻译，末两级纯防御（名称为契约必返 string，
|
|||
|
|
* 不返回 null——真缺行时回退空串并保持 200，公开页不因单分类脏数据整页 5xx）。
|
|||
|
|
*/
|
|||
|
|
private resolveCategoryName(
|
|||
|
|
names: Map<string, string> | undefined,
|
|||
|
|
resolvedLocale: AlbumLocale,
|
|||
|
|
defaultLocale: string,
|
|||
|
|
): string {
|
|||
|
|
if (names === undefined || names.size === 0) {
|
|||
|
|
return '';
|
|||
|
|
}
|
|||
|
|
return (
|
|||
|
|
names.get(resolvedLocale) ??
|
|||
|
|
names.get(defaultLocale) ??
|
|||
|
|
([...names.entries()].sort(([a], [b]) => (a < b ? -1 : 1))[0][1] as string)
|
|||
|
|
);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** 现签短期 GET 凭证（TTL 惰性读取；expiresAt 与 URL 同源推导）。 */
|
|||
|
|
private async presign(objectKey: string): Promise<SignedUrlResponse> {
|
|||
|
|
const ttl = signedUrlTtlSeconds();
|
|||
|
|
const url = await this.storage.presignGet(objectKey, ttl);
|
|||
|
|
return { url, expiresAt: new Date(Date.now() + ttl * 1000).toISOString() };
|
|||
|
|
}
|
|||
|
|
}
|