feat(content): 시리즈 상세의 언어 감지와 번역을 동기로 완료한다

This commit is contained in:
2026-11-17 14:35:15 +09:00
parent 9cadaa919b
commit 536a5a6fe5
6 changed files with 621 additions and 50 deletions
@@ -0,0 +1,146 @@
package kr.co.vividnext.sodalive.content.series
import kr.co.vividnext.sodalive.content.LanguageDetectionCacheService
import kr.co.vividnext.sodalive.content.series.translation.SeriesTranslationPayload
import kr.co.vividnext.sodalive.content.series.translation.SeriesTranslationRepository
import kr.co.vividnext.sodalive.content.series.translation.TranslatedSeries
import kr.co.vividnext.sodalive.creator.admin.content.series.Series
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
import kr.co.vividnext.sodalive.i18n.translation.ResourceTranslationJobScheduler
import kr.co.vividnext.sodalive.i18n.translation.TranslationLanguages
import kr.co.vividnext.sodalive.i18n.translation.TranslationMemoryService
import kr.co.vividnext.sodalive.i18n.translation.TranslationReadModelMaterializer
import kr.co.vividnext.sodalive.i18n.translation.TranslationSourceField
import org.slf4j.LoggerFactory
import org.springframework.stereotype.Service
import org.springframework.transaction.PlatformTransactionManager
import org.springframework.transaction.TransactionDefinition
import org.springframework.transaction.annotation.Propagation
import org.springframework.transaction.annotation.Transactional
import org.springframework.transaction.support.TransactionTemplate
import javax.persistence.EntityManager
import javax.persistence.LockModeType
data class ContentSeriesDetailTranslationResult(
val languageCode: String?,
val translated: TranslatedSeries? = null,
val detectionQuery: String? = null
)
@Service
class ContentSeriesDetailTranslationService(
private val repository: ContentSeriesRepository,
private val translations: SeriesTranslationRepository,
private val detector: LanguageDetectionCacheService,
private val memories: TranslationMemoryService,
private val materializer: TranslationReadModelMaterializer,
private val scheduler: ResourceTranslationJobScheduler,
private val entityManager: EntityManager,
transactionManager: PlatformTransactionManager
) {
private val log = LoggerFactory.getLogger(javaClass)
private val transaction = TransactionTemplate(transactionManager).apply {
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
}
@Transactional(propagation = Propagation.NOT_SUPPORTED)
fun resolve(seriesId: Long, targetLanguage: String): ContentSeriesDetailTranslationResult {
var source = transaction.execute { snapshot(seriesId) } ?: return ContentSeriesDetailTranslationResult(null)
if (source.languageCode.isNullOrBlank()) {
val beforeDetection = source
try {
val detected = detector.detectWithCache(source.query)?.detectedLanguage
?: return ContentSeriesDetailTranslationResult(source.languageCode, detectionQuery = source.query)
source = transaction.execute {
val series = entityManager.find(Series::class.java, seriesId, LockModeType.PESSIMISTIC_WRITE)
?: return@execute null
val current = snapshot(seriesId) ?: return@execute null
if (current == beforeDetection) series.languageCode = detected
snapshot(seriesId)
} ?: return ContentSeriesDetailTranslationResult(null)
} catch (ex: Exception) {
log.warn("Series detail language detection failed. seriesId={}, error={}", seriesId, ex.message)
return ContentSeriesDetailTranslationResult(source.languageCode, detectionQuery = source.query)
}
}
val language = source.languageCode
if (language.isNullOrBlank()) return ContentSeriesDetailTranslationResult(language, detectionQuery = source.query)
val target = targetLanguage.lowercase()
if (
!TranslationLanguages.isSupported(language) || !TranslationLanguages.isSupported(target) ||
language.lowercase() == target
) {
return ContentSeriesDetailTranslationResult(language)
}
val existing = transaction.execute { translations.findBySeriesIdAndLocale(seriesId, target)?.renderedPayload }
if (existing != null) {
maintainRetries(seriesId, target, scheduleMissing = false)
return result(language, existing)
}
return try {
source.fields.forEach { field ->
memories.ensureMemory(LanguageTranslationTargetType.SERIES, field.fieldKey, field.sourceText, language, target)
}
val payload = transaction.execute {
entityManager.find(Series::class.java, seriesId, LockModeType.PESSIMISTIC_WRITE)
check(snapshot(seriesId) == source) { "series translation source changed" }
check(materializer.materialize(LanguageTranslationTargetType.SERIES, seriesId, target)) {
"series translation is incomplete"
}
requireNotNull(translations.findBySeriesIdAndLocale(seriesId, target)).renderedPayload
}
maintainRetries(seriesId, target, scheduleMissing = false)
result(language, requireNotNull(payload))
} catch (ex: Exception) {
log.warn("Series detail translation failed. seriesId={}, locale={}, error={}", seriesId, target, ex.message)
maintainRetries(seriesId, target, scheduleMissing = true)
ContentSeriesDetailTranslationResult(language)
}
}
private fun maintainRetries(seriesId: Long, target: String, scheduleMissing: Boolean) {
try {
transaction.executeWithoutResult {
scheduler.restartFailedResourceTranslationsInCurrentTransaction(
LanguageTranslationTargetType.SERIES,
listOf(seriesId),
target
)
if (scheduleMissing) {
scheduler.scheduleResourceTranslation(LanguageTranslationTargetType.SERIES, seriesId, target)
}
}
} catch (ex: Exception) {
log.warn(
"Series detail translation retry request failed. seriesId={}, locale={}, error={}",
seriesId,
target,
ex.message
)
}
}
private fun result(language: String, payload: SeriesTranslationPayload) = ContentSeriesDetailTranslationResult(
language,
TranslatedSeries(payload.title, payload.introduction, payload.keywords)
)
private fun snapshot(seriesId: Long): DetailSource? {
val series = repository.findById(seriesId).orElse(null) ?: return null
val keywords = series.keywordList.mapNotNull { it.keyword?.tag }
return DetailSource(
series.languageCode,
listOf(
TranslationSourceField("title", series.title),
TranslationSourceField("introduction", series.introduction),
TranslationSourceField("keywords", keywords.joinToString(", "))
),
listOf(series.title.trim(), series.introduction.trim(), keywords.joinToString(" ").trim())
.filter { it.isNotBlank() }.joinToString(" ")
)
}
private data class DetailSource(val languageCode: String?, val fields: List<TranslationSourceField>, val query: String)
}
@@ -2,13 +2,13 @@ package kr.co.vividnext.sodalive.content.series
import kr.co.vividnext.sodalive.common.SodaException
import kr.co.vividnext.sodalive.content.ContentType
import kr.co.vividnext.sodalive.content.LanguageDetectEvent
import kr.co.vividnext.sodalive.content.LanguageDetectTargetType
import kr.co.vividnext.sodalive.content.order.OrderRepository
import kr.co.vividnext.sodalive.content.order.OrderType
import kr.co.vividnext.sodalive.content.series.content.ContentSeriesContentRepository
import kr.co.vividnext.sodalive.content.series.content.GetSeriesContentListResponse
import kr.co.vividnext.sodalive.content.series.translation.SeriesGenreTranslationRepository
import kr.co.vividnext.sodalive.content.series.translation.SeriesTranslationRepository
import kr.co.vividnext.sodalive.content.series.translation.TranslatedSeries
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesPublishedDaysOfWeek
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesSortType
@@ -21,6 +21,7 @@ import kr.co.vividnext.sodalive.member.Member
import kr.co.vividnext.sodalive.member.block.BlockMemberRepository
import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
import org.springframework.beans.factory.annotation.Value
import org.springframework.context.ApplicationEventPublisher
import org.springframework.stereotype.Service
import org.springframework.transaction.annotation.Transactional
import java.time.ZoneId
@@ -36,7 +37,8 @@ class ContentSeriesService(
private val langContext: LangContext,
private val seriesTranslationRepository: SeriesTranslationRepository,
private val detailTranslationService: ContentSeriesDetailTranslationService,
private val applicationEventPublisher: ApplicationEventPublisher,
private val seriesGenreTranslationRepository: SeriesGenreTranslationRepository,
private val contentTranslationRepository: ContentTranslationRepository,
private val resourceTranslationJobScheduler: ResourceTranslationJobScheduler,
@@ -259,52 +261,16 @@ class ContentSeriesService(
limit = 5
)
/**
* series.languageCode != null && series.languageCode != languageCode
*
* 번역 시리즈를 조회한다. - series, locale
* 번역 콘텐츠가 있으면
* TranslatedSeries로 가공한다
*
* 번역 콘텐츠가 없으면
* 누락 번역 job을 예약하고 원문 응답을 유지한다.
*
* 번역 대상: title, introduction, keywordList
*
* 파파고로 번역한 데이터를 TranslatedSeries 가공한다
*/
val dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy.MM.dd")
// 요청된 언어(locale)에 대한 시리즈 번역을 조회하거나, 없으면 동기 번역 후 저장한다.
var translated: TranslatedSeries? = null
run {
val locale = langContext.lang.code
val languageCode = series.languageCode
// 원본 언어가 존재하고, 요청 언어와 다를 때만 번역 처리
if (!languageCode.isNullOrBlank() && languageCode != locale) {
resourceTranslationJobScheduler.restartFailedResourceTranslations(
LanguageTranslationTargetType.SERIES,
listOf(seriesId),
locale
)
val existing = seriesTranslationRepository.findBySeriesIdAndLocale(seriesId = seriesId, locale = locale)
if (existing != null) {
val payload = existing.renderedPayload
val kws = payload.keywords.ifEmpty { keywordList }
translated = TranslatedSeries(
title = payload.title,
introduction = payload.introduction,
keywords = kws
)
} else {
resourceTranslationJobScheduler.scheduleResourceTranslation(
resourceType = LanguageTranslationTargetType.SERIES,
resourceId = seriesId,
targetLanguage = locale
)
}
}
val translation = detailTranslationService.resolve(seriesId, langContext.lang.code)
if (translation.detectionQuery != null) {
applicationEventPublisher.publishEvent(
LanguageDetectEvent(seriesId, translation.detectionQuery, LanguageDetectTargetType.SERIES)
)
}
val translated = translation.translated?.let {
it.copy(keywords = it.keywords.ifEmpty { keywordList })
}
// 장르 번역 조회 (있으면 반환)
@@ -19,6 +19,7 @@ import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslatio
import kr.co.vividnext.sodalive.content.translation.ContentTranslation
import kr.co.vividnext.sodalive.content.translation.ContentTranslationPayload
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
import kr.co.vividnext.sodalive.creator.admin.content.series.Series
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.CreatorCommunityTranslation
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.CreatorCommunityTranslationRepository
@@ -141,6 +142,7 @@ class TranslationReadModelMaterializer(
.map { it.trim() }
.filter { it.isNotBlank() }
)
entityManager.find(Series::class.java, resourceId, LockModeType.PESSIMISTIC_WRITE)
val existing = seriesTranslationRepository.findBySeriesIdAndLocale(resourceId, targetLanguage)
if (existing == null) {
seriesTranslationRepository.save(SeriesTranslation(resourceId, targetLanguage, payload))