Compare commits
52
Commits
eae0c41cea
..
test
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0164a76299 | ||
|
|
156693b76f | ||
|
|
3fd10c3d48 | ||
|
|
2b6b9c1445 | ||
|
|
d9755bf995 | ||
|
|
cfd815cd7c | ||
|
|
05cc5a1427 | ||
|
|
8d96f6e3e7 | ||
|
|
0779e8ed97 | ||
|
|
bc84faf7a8 | ||
|
|
1c270048a1 | ||
|
|
6e14c38915 | ||
|
|
a6fad94563 | ||
|
|
a48797980a | ||
|
|
9d8bc9149b | ||
|
|
a3c76a1bbe | ||
|
|
d436fd6bff | ||
|
|
536a5a6fe5 | ||
|
|
9cadaa919b | ||
|
|
0796b2b4fb | ||
|
|
85d6a14c40 | ||
|
|
ff30ebacc5 | ||
|
|
2da499f716 | ||
|
|
ecace9ba67 | ||
|
|
f7f6ab6864 | ||
|
|
55669c4465 | ||
|
|
cd4667813a | ||
|
|
ba7bc81ac7 | ||
|
|
081f22b2c0 | ||
|
|
d1c9f3a3d8 | ||
|
|
3ed79f2acb | ||
|
|
ed37990e2b | ||
|
|
309f794168 | ||
|
|
5eee580aaf | ||
|
|
c3e5f19cb3 | ||
|
|
cf31c5702c | ||
|
|
4c1d876d5e | ||
|
|
9c1c544e45 | ||
|
|
e097e27ac6 | ||
|
|
cc85322eb5 | ||
|
|
fe620aa9c0 | ||
|
|
9d29355bf2 | ||
|
|
992844df66 | ||
|
|
7cac09e39c | ||
|
|
a8e4cbac28 | ||
|
|
2bd2328548 | ||
|
|
ec890047a5 | ||
|
|
6093b37747 | ||
|
|
9136b0e3bb | ||
|
|
f3a558f659 | ||
|
|
f7fadf7ac7 | ||
|
|
320adb037c |
+33
-1
@@ -1,3 +1,4 @@
|
|||||||
|
import buildlogic.TestHeapPolicy
|
||||||
import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
|
import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
|
||||||
|
|
||||||
plugins {
|
plugins {
|
||||||
@@ -16,6 +17,8 @@ plugins {
|
|||||||
group = "kr.co.vividnext"
|
group = "kr.co.vividnext"
|
||||||
version = "0.0.1-SNAPSHOT"
|
version = "0.0.1-SNAPSHOT"
|
||||||
val querydslVersion = "5.0.0"
|
val querydslVersion = "5.0.0"
|
||||||
|
extra["httpclient5.version"] = "5.6.4"
|
||||||
|
extra["httpcore5.version"] = "5.4.3"
|
||||||
|
|
||||||
java {
|
java {
|
||||||
sourceCompatibility = JavaVersion.VERSION_17
|
sourceCompatibility = JavaVersion.VERSION_17
|
||||||
@@ -56,6 +59,10 @@ dependencies {
|
|||||||
implementation("com.amazonaws:aws-java-sdk-s3:1.12.380")
|
implementation("com.amazonaws:aws-java-sdk-s3:1.12.380")
|
||||||
implementation("com.amazonaws:aws-java-sdk-cloudfront:1.12.380")
|
implementation("com.amazonaws:aws-java-sdk-cloudfront:1.12.380")
|
||||||
|
|
||||||
|
implementation(platform("software.amazon.awssdk:bom:2.57.11"))
|
||||||
|
implementation("software.amazon.awssdk:comprehend")
|
||||||
|
implementation("software.amazon.awssdk:translate")
|
||||||
|
|
||||||
// bootpay
|
// bootpay
|
||||||
implementation("io.github.bootpay:backend:2.2.1")
|
implementation("io.github.bootpay:backend:2.2.1")
|
||||||
|
|
||||||
@@ -102,8 +109,33 @@ tasks.withType<KotlinCompile> {
|
|||||||
|
|
||||||
tasks.withType<Test>().configureEach {
|
tasks.withType<Test>().configureEach {
|
||||||
useJUnitPlatform()
|
useJUnitPlatform()
|
||||||
maxHeapSize = "4g"
|
maxParallelForks = 1
|
||||||
|
forkEvery = 300
|
||||||
|
systemProperty("spring.test.context.cache.maxSize", 4)
|
||||||
jvmArgs("-Dfile.encoding=UTF-8")
|
jvmArgs("-Dfile.encoding=UTF-8")
|
||||||
|
|
||||||
|
val gcLogDirectory = layout.buildDirectory.dir("test-gc/$name").get().asFile
|
||||||
|
doFirst {
|
||||||
|
val availableBytes = TestHeapPolicy.readAvailableBytes()
|
||||||
|
val maxWorkers = gradle.startParameter.maxWorkerCount
|
||||||
|
val heapMiB = TestHeapPolicy.calculateHeapMiB(availableBytes, maxParallelForks, maxWorkers)
|
||||||
|
maxHeapSize = "${heapMiB}m"
|
||||||
|
logger.lifecycle(
|
||||||
|
"Test heap: available estimate={} MiB, workers={}, maxHeap={} MiB (50% worker budget, 25% native reserve)",
|
||||||
|
availableBytes / (1024 * 1024),
|
||||||
|
minOf(maxParallelForks, maxWorkers),
|
||||||
|
heapMiB
|
||||||
|
)
|
||||||
|
gcLogDirectory.mkdirs()
|
||||||
|
}
|
||||||
|
jvmArgs(
|
||||||
|
"-Xlog:gc*:file=${gcLogDirectory.resolve("gc-%p.log")}:time,uptime,pid,level,tags:filecount=3,filesize=10M"
|
||||||
|
)
|
||||||
|
beforeSuite(
|
||||||
|
closureOf<TestDescriptor> {
|
||||||
|
if (className != null) logger.lifecycle("Test class: $className")
|
||||||
|
}
|
||||||
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
tasks.getByName<Jar>("jar") {
|
tasks.getByName<Jar>("jar") {
|
||||||
|
|||||||
@@ -0,0 +1,21 @@
|
|||||||
|
plugins {
|
||||||
|
`kotlin-dsl`
|
||||||
|
id("org.jlleitschuh.gradle.ktlint") version "11.5.0"
|
||||||
|
}
|
||||||
|
|
||||||
|
repositories {
|
||||||
|
mavenCentral()
|
||||||
|
}
|
||||||
|
|
||||||
|
java {
|
||||||
|
toolchain.languageVersion.set(JavaLanguageVersion.of(17))
|
||||||
|
}
|
||||||
|
|
||||||
|
dependencies {
|
||||||
|
testImplementation("org.junit.jupiter:junit-jupiter-api:5.8.2")
|
||||||
|
testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.8.2")
|
||||||
|
}
|
||||||
|
|
||||||
|
tasks.test {
|
||||||
|
useJUnitPlatform()
|
||||||
|
}
|
||||||
@@ -0,0 +1,172 @@
|
|||||||
|
package buildlogic
|
||||||
|
|
||||||
|
import com.sun.management.OperatingSystemMXBean
|
||||||
|
import org.gradle.api.logging.Logging
|
||||||
|
import java.io.IOException
|
||||||
|
import java.lang.management.ManagementFactory
|
||||||
|
import java.nio.charset.StandardCharsets
|
||||||
|
import java.nio.file.Files
|
||||||
|
import java.nio.file.Path
|
||||||
|
import java.util.concurrent.TimeUnit
|
||||||
|
import java.util.regex.Pattern
|
||||||
|
|
||||||
|
object TestHeapPolicy {
|
||||||
|
private const val MIB = 1L shl 20
|
||||||
|
private const val JVM_MINIMUM_HEAP_MIB = 2L
|
||||||
|
private val PAGE_SIZE = Pattern.compile(
|
||||||
|
"Mach Virtual Memory Statistics:\\s*\\(page size of ([0-9]+) bytes\\)"
|
||||||
|
)
|
||||||
|
private val PAGE_COUNTER = Pattern.compile("Pages (free|inactive)\\s*:\\s*([0-9]+)\\.?")
|
||||||
|
private val LINUX_MEMORY_COUNTER = Pattern.compile("(MemTotal|MemAvailable):\\s+([0-9]+)\\s+kB")
|
||||||
|
|
||||||
|
@JvmStatic
|
||||||
|
fun calculateHeapMiB(availableBytes: Long, maxParallelForks: Int, maxWorkers: Int): Long {
|
||||||
|
require(availableBytes > 0 && maxParallelForks > 0 && maxWorkers > 0) {
|
||||||
|
"Available bytes, maxParallelForks and maxWorkers must be positive"
|
||||||
|
}
|
||||||
|
|
||||||
|
val effectiveWorkers = minOf(maxParallelForks, maxWorkers)
|
||||||
|
val perWorkerBytes = availableBytes / 2 / effectiveWorkers
|
||||||
|
val nativeReserveBytes = (perWorkerBytes + 3) / 4
|
||||||
|
val heapMiB = (perWorkerBytes - nativeReserveBytes) / MIB
|
||||||
|
check(heapMiB >= JVM_MINIMUM_HEAP_MIB) {
|
||||||
|
"Insufficient test memory: availableBytes=$availableBytes, effectiveWorkers=$effectiveWorkers" +
|
||||||
|
", heapMiB=$heapMiB. JVM requires at least 2 MiB. Close other applications or reduce workers."
|
||||||
|
}
|
||||||
|
return heapMiB
|
||||||
|
}
|
||||||
|
|
||||||
|
@JvmStatic
|
||||||
|
fun readAvailableBytes(): Long {
|
||||||
|
val osName = System.getProperty("os.name")
|
||||||
|
val availableBytes = if (osName.startsWith("Mac")) {
|
||||||
|
val builder = ProcessBuilder("/usr/bin/vm_stat").redirectErrorStream(true)
|
||||||
|
builder.environment()["LC_ALL"] = "C"
|
||||||
|
try {
|
||||||
|
val process = builder.start()
|
||||||
|
try {
|
||||||
|
process.inputStream.use { output ->
|
||||||
|
process.errorStream.use {
|
||||||
|
process.outputStream.use {
|
||||||
|
check(process.waitFor(5, TimeUnit.SECONDS)) {
|
||||||
|
"vm_stat did not finish within 5 seconds"
|
||||||
|
}
|
||||||
|
check(process.exitValue() == 0) {
|
||||||
|
"vm_stat failed with exit code ${process.exitValue()}"
|
||||||
|
}
|
||||||
|
parseMacVmStat(String(output.readAllBytes(), StandardCharsets.US_ASCII))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
process.destroyForcibly()
|
||||||
|
}
|
||||||
|
} catch (failure: InterruptedException) {
|
||||||
|
Thread.currentThread().interrupt()
|
||||||
|
throw IllegalStateException("Interrupted while reading available memory with vm_stat", failure)
|
||||||
|
} catch (failure: IOException) {
|
||||||
|
throw IllegalStateException("Unable to read available memory with vm_stat", failure)
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
val operatingSystem = checkNotNull(ManagementFactory.getPlatformMXBean(OperatingSystemMXBean::class.java)) {
|
||||||
|
"OperatingSystemMXBean free-memory observation is unavailable"
|
||||||
|
}
|
||||||
|
if (osName == "Linux") {
|
||||||
|
val memInfo = try {
|
||||||
|
Files.readString(Path.of("/proc/meminfo"), StandardCharsets.US_ASCII)
|
||||||
|
} catch (failure: IOException) {
|
||||||
|
throw IllegalStateException("Unable to read Linux available memory from /proc/meminfo", failure)
|
||||||
|
}
|
||||||
|
val jvmTotalBytes = operatingSystem.totalMemorySize
|
||||||
|
val jvmFreeBytes = operatingSystem.freeMemorySize
|
||||||
|
val available = resolveLinuxAvailableBytes(memInfo, jvmTotalBytes, jvmFreeBytes)
|
||||||
|
Logging.getLogger(TestHeapPolicy::class.java).lifecycle(
|
||||||
|
"Test memory (Linux): JVM total={} MiB, JVM free={} MiB, effective available={} MiB",
|
||||||
|
jvmTotalBytes / MIB,
|
||||||
|
jvmFreeBytes / MIB,
|
||||||
|
available / MIB
|
||||||
|
)
|
||||||
|
available
|
||||||
|
} else {
|
||||||
|
operatingSystem.freeMemorySize
|
||||||
|
}
|
||||||
|
}
|
||||||
|
check(availableBytes > 0) {
|
||||||
|
"Available-memory observation must be positive: availableBytes=$availableBytes"
|
||||||
|
}
|
||||||
|
return availableBytes
|
||||||
|
}
|
||||||
|
|
||||||
|
internal fun resolveLinuxAvailableBytes(memInfo: String, jvmTotalBytes: Long, jvmFreeBytes: Long): Long {
|
||||||
|
var hostTotalBytes = -1L
|
||||||
|
var hostAvailableBytes = -1L
|
||||||
|
try {
|
||||||
|
for (rawLine in memInfo.lineSequence()) {
|
||||||
|
val line = rawLine.trim()
|
||||||
|
if (line.startsWith("MemTotal:") || line.startsWith("MemAvailable:")) {
|
||||||
|
val counter = LINUX_MEMORY_COUNTER.matcher(line)
|
||||||
|
require(counter.matches()) { "Malformed Linux memory counter: $line" }
|
||||||
|
val bytes = Math.multiplyExact(counter.group(2).toLong(), 1024L)
|
||||||
|
if (counter.group(1) == "MemTotal") {
|
||||||
|
require(hostTotalBytes < 0) { "Duplicate Linux MemTotal counter" }
|
||||||
|
hostTotalBytes = bytes
|
||||||
|
} else {
|
||||||
|
require(hostAvailableBytes < 0) { "Duplicate Linux MemAvailable counter" }
|
||||||
|
hostAvailableBytes = bytes
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (failure: NumberFormatException) {
|
||||||
|
throw IllegalArgumentException("Linux memory counters exceed the supported long range", failure)
|
||||||
|
} catch (failure: ArithmeticException) {
|
||||||
|
throw IllegalArgumentException("Linux memory counters exceed the supported long range", failure)
|
||||||
|
}
|
||||||
|
require(hostTotalBytes > 0 && hostAvailableBytes >= 0 && hostAvailableBytes <= hostTotalBytes) {
|
||||||
|
"Linux /proc/meminfo requires positive MemTotal and MemAvailable within that total"
|
||||||
|
}
|
||||||
|
check(jvmTotalBytes > 0) { "JVM total-memory observation must be positive" }
|
||||||
|
if (jvmTotalBytes < hostTotalBytes) {
|
||||||
|
check(jvmFreeBytes >= 0) { "Container free-memory observation must not be negative" }
|
||||||
|
return minOf(hostAvailableBytes, jvmFreeBytes, jvmTotalBytes)
|
||||||
|
}
|
||||||
|
return hostAvailableBytes
|
||||||
|
}
|
||||||
|
|
||||||
|
internal fun parseMacVmStat(output: String): Long {
|
||||||
|
var pageSize = -1L
|
||||||
|
var freePages = -1L
|
||||||
|
var inactivePages = -1L
|
||||||
|
try {
|
||||||
|
for (rawLine in output.lineSequence()) {
|
||||||
|
val line = rawLine.trim { Character.isWhitespace(it) }
|
||||||
|
if (line.startsWith("Mach Virtual Memory Statistics")) {
|
||||||
|
val header = PAGE_SIZE.matcher(line)
|
||||||
|
require(pageSize < 0 && header.matches()) {
|
||||||
|
"Duplicate or malformed vm_stat page-size header: $line"
|
||||||
|
}
|
||||||
|
pageSize = header.group(1).toLong()
|
||||||
|
} else if (line.startsWith("Pages free") || line.startsWith("Pages inactive")) {
|
||||||
|
val counter = PAGE_COUNTER.matcher(line)
|
||||||
|
require(counter.matches()) { "Malformed vm_stat page counter: $line" }
|
||||||
|
val pages = counter.group(2).toLong()
|
||||||
|
if (counter.group(1) == "free") {
|
||||||
|
require(freePages < 0) { "Duplicate vm_stat Pages free counter" }
|
||||||
|
freePages = pages
|
||||||
|
} else {
|
||||||
|
require(inactivePages < 0) { "Duplicate vm_stat Pages inactive counter" }
|
||||||
|
inactivePages = pages
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
require(pageSize > 0 && freePages >= 0 && inactivePages >= 0) {
|
||||||
|
"vm_stat requires a positive page size and both free and inactive counters"
|
||||||
|
}
|
||||||
|
// Raw free already includes speculative pages; do not subtract or add them separately.
|
||||||
|
return Math.multiplyExact(Math.addExact(freePages, inactivePages), pageSize)
|
||||||
|
} catch (failure: NumberFormatException) {
|
||||||
|
throw IllegalArgumentException("vm_stat page size or counters exceed the supported long range", failure)
|
||||||
|
} catch (failure: ArithmeticException) {
|
||||||
|
throw IllegalArgumentException("vm_stat page size or counters exceed the supported long range", failure)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,109 @@
|
|||||||
|
package buildlogic
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Assertions.assertEquals
|
||||||
|
import org.junit.jupiter.api.Assertions.assertThrows
|
||||||
|
import org.junit.jupiter.api.DynamicTest
|
||||||
|
import org.junit.jupiter.api.DynamicTest.dynamicTest
|
||||||
|
import org.junit.jupiter.api.Test
|
||||||
|
import org.junit.jupiter.api.TestFactory
|
||||||
|
|
||||||
|
class LinuxAvailableMemoryTest {
|
||||||
|
@Test
|
||||||
|
fun shouldUseReclaimableHostMemoryInsteadOfTheReportedJenkinsFreeMemory() {
|
||||||
|
val available = TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 16 * GIB, 1315 * MIB)
|
||||||
|
|
||||||
|
assertEquals(10 * GIB, available)
|
||||||
|
assertEquals(3840L, TestHeapPolicy.calculateHeapMiB(available, 1, 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldAllowHostMemoryWhenJvmTotalIsLargerThanProcTotal() {
|
||||||
|
assertEquals(10 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 16 * GIB + 4096, 1315 * MIB))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldNotTreatZeroHostFreePagesAsZeroAvailableMemory() {
|
||||||
|
assertEquals(10 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 16 * GIB, 0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldCapAvailableMemoryByRecognizedContainerHeadroom() {
|
||||||
|
assertEquals(3 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, 3 * GIB))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldRespectHostPressureEvenWhenTheContainerHasMoreHeadroom() {
|
||||||
|
assertEquals(GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(availableKiB = GIB / 1024), 4 * GIB, 3 * GIB))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldNeverExceedTheRecognizedContainerTotal() {
|
||||||
|
assertEquals(4 * GIB, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, 8 * GIB))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldPreserveZeroAvailableMemoryWithoutFallingBackToHostFree() {
|
||||||
|
assertEquals(0L, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(availableKiB = 0), 16 * GIB, 1315 * MIB))
|
||||||
|
assertEquals(0L, TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, 0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldRejectUnknownRemainingMemoryForARecognizedContainerLimit() {
|
||||||
|
assertThrows(IllegalStateException::class.java) {
|
||||||
|
TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), 4 * GIB, -1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@TestFactory
|
||||||
|
fun shouldRejectUnknownJvmTotalMemory(): List<DynamicTest> = listOf(0L, -1L).map { total ->
|
||||||
|
dynamicTest("JVM total $total") {
|
||||||
|
assertThrows(IllegalStateException::class.java) {
|
||||||
|
TestHeapPolicy.resolveLinuxAvailableBytes(memInfo(), total, GIB)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldParseReorderedKiBCountersWithoutAddingCachedOrSwapPages() {
|
||||||
|
val input = "MemAvailable:\t3072 kB\nCached: 999999 kB\nSwapFree: 999999 kB\n MemTotal: 4096 kB\n"
|
||||||
|
assertEquals(3 * MIB, TestHeapPolicy.resolveLinuxAvailableBytes(input, 4 * MIB, MIB))
|
||||||
|
}
|
||||||
|
|
||||||
|
@TestFactory
|
||||||
|
fun shouldRejectMissingDuplicateMalformedOrOverflowingProcCounters(): List<DynamicTest> {
|
||||||
|
val valid = memInfo()
|
||||||
|
return listOf(
|
||||||
|
"",
|
||||||
|
"MemTotal: 16777216 kB\n",
|
||||||
|
"MemAvailable: 10485760 kB\n",
|
||||||
|
valid + "MemTotal: 16777216 kB\n",
|
||||||
|
valid + "MemAvailable: 10485760 kB\n",
|
||||||
|
valid.replace("16777216 kB", "0 kB"),
|
||||||
|
valid.replace("10485760 kB", "16777217 kB"),
|
||||||
|
valid.replace("10485760 kB", "-1 kB"),
|
||||||
|
valid.replace("10485760 kB", "1.5 kB"),
|
||||||
|
valid.replace("10485760 kB", "invalid kB"),
|
||||||
|
valid.replace("10485760 kB", "10485760 MB"),
|
||||||
|
valid.replace("10485760 kB", "10485760"),
|
||||||
|
valid.replace("10485760 kB", "10485760 kB trailing"),
|
||||||
|
valid.replace("16777216 kB", "9223372036854775808 kB"),
|
||||||
|
valid.replace("10485760 kB", "9223372036854775808 kB"),
|
||||||
|
valid.replace("16777216 kB", "9007199254740992 kB"),
|
||||||
|
valid.replace("10485760 kB", "9007199254740992 kB")
|
||||||
|
).map { input ->
|
||||||
|
dynamicTest("rejects ${input.replace('\n', ' ')}") {
|
||||||
|
assertThrows(IllegalArgumentException::class.java) {
|
||||||
|
TestHeapPolicy.resolveLinuxAvailableBytes(input, 16 * GIB, GIB)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun memInfo(availableKiB: Long = 10 * GIB / 1024): String =
|
||||||
|
"MemTotal: 16777216 kB\nMemFree: 1346560 kB\nMemAvailable: $availableKiB kB\n"
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
private const val MIB = 1_048_576L
|
||||||
|
private const val GIB = 1_073_741_824L
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,187 @@
|
|||||||
|
package buildlogic
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Assertions.assertAll
|
||||||
|
import org.junit.jupiter.api.Assertions.assertEquals
|
||||||
|
import org.junit.jupiter.api.Assertions.assertThrows
|
||||||
|
import org.junit.jupiter.api.Assertions.assertTrue
|
||||||
|
import org.junit.jupiter.api.DynamicTest
|
||||||
|
import org.junit.jupiter.api.DynamicTest.dynamicTest
|
||||||
|
import org.junit.jupiter.api.Test
|
||||||
|
import org.junit.jupiter.api.TestFactory
|
||||||
|
|
||||||
|
class TestHeapPolicyTest {
|
||||||
|
@TestFactory
|
||||||
|
fun shouldCalculateHeapWithinTheAvailableWorkerBudget(): List<DynamicTest> = listOf(
|
||||||
|
dynamicTest("the reported Jenkins availability runs below the former fixed floor") {
|
||||||
|
assertEquals(879L, TestHeapPolicy.calculateHeapMiB(2_460_004_352L, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("1 GiB reserves native memory proportionally") {
|
||||||
|
assertEquals(384L, TestHeapPolicy.calculateHeapMiB(GIB, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("2 GiB does not lose the whole worker budget to a fixed reserve") {
|
||||||
|
assertEquals(768L, TestHeapPolicy.calculateHeapMiB(2 * GIB, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("8 GiB permits a heap below 4 GiB") {
|
||||||
|
assertEquals(3072L, TestHeapPolicy.calculateHeapMiB(8 * GIB, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("10 GiB scales without a policy floor") {
|
||||||
|
assertEquals(3840L, TestHeapPolicy.calculateHeapMiB(10 * GIB, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("20 GiB is shared between two workers") {
|
||||||
|
assertEquals(3840L, TestHeapPolicy.calculateHeapMiB(20 * GIB, 2, 2))
|
||||||
|
},
|
||||||
|
dynamicTest("13 GiB leaves half and a proportional native reserve") {
|
||||||
|
assertEquals(4992L, TestHeapPolicy.calculateHeapMiB(13 * GIB, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("max workers caps four requested forks") {
|
||||||
|
assertEquals(6144L, TestHeapPolicy.calculateHeapMiB(32 * GIB, 4, 2))
|
||||||
|
},
|
||||||
|
dynamicTest("max forks caps four available workers") {
|
||||||
|
assertEquals(6144L, TestHeapPolicy.calculateHeapMiB(32 * GIB, 2, 4))
|
||||||
|
},
|
||||||
|
dynamicTest("fractional MiB rounds down") {
|
||||||
|
assertEquals(4992L, TestHeapPolicy.calculateHeapMiB(13 * GIB + 2 * MIB, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("an exact proportional increase is retained") {
|
||||||
|
assertEquals(4995L, TestHeapPolicy.calculateHeapMiB(13 * GIB + 8 * MIB, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("one byte below the proportional increase rounds down") {
|
||||||
|
assertEquals(4994L, TestHeapPolicy.calculateHeapMiB(13 * GIB + 8 * MIB - 1, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("the JVM technical minimum is not replaced with an application floor") {
|
||||||
|
assertEquals(2L, TestHeapPolicy.calculateHeapMiB(5_592_406, 1, 1))
|
||||||
|
},
|
||||||
|
dynamicTest("the JVM technical minimum accounts for two workers") {
|
||||||
|
assertEquals(2L, TestHeapPolicy.calculateHeapMiB(11_184_812, 2, 2))
|
||||||
|
},
|
||||||
|
dynamicTest("the largest positive long does not overflow") {
|
||||||
|
assertEquals(3_298_534_883_327L, TestHeapPolicy.calculateHeapMiB(Long.MAX_VALUE, 1, 1))
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
@TestFactory
|
||||||
|
fun shouldRejectOnlyBudgetsTooSmallToStartTheJvm(): List<DynamicTest> = listOf(
|
||||||
|
Triple(5_592_405L, 1, 1),
|
||||||
|
Triple(11_184_811L, 4, 2),
|
||||||
|
Triple(1L, 1, 1),
|
||||||
|
Triple(MIB, 1, 1),
|
||||||
|
Triple(2 * MIB, 1, 1),
|
||||||
|
Triple(4 * MIB, 1, 1)
|
||||||
|
).map { (available, forks, workers) ->
|
||||||
|
dynamicTest("[$available, $forks, $workers]") {
|
||||||
|
val failure = assertThrows(IllegalStateException::class.java) {
|
||||||
|
TestHeapPolicy.calculateHeapMiB(available, forks, workers)
|
||||||
|
}
|
||||||
|
val message = requireNotNull(failure.message)
|
||||||
|
assertAll(
|
||||||
|
{ assertTrue(message.contains("availableBytes=$available"), message) },
|
||||||
|
{ assertTrue(message.contains("effectiveWorkers=${minOf(forks, workers)}"), message) },
|
||||||
|
{ assertTrue(message.contains("JVM requires at least 2 MiB"), message) },
|
||||||
|
{ assertTrue(message.contains("Close other applications"), message) },
|
||||||
|
{ assertTrue(message.contains("reduce workers"), message) }
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@TestFactory
|
||||||
|
fun shouldRejectNonpositiveAvailabilityOrWorkerLimits(): List<DynamicTest> = listOf(
|
||||||
|
Triple(0L, 1, 1),
|
||||||
|
Triple(-1L, 1, 1),
|
||||||
|
Triple(Long.MIN_VALUE, 1, 1),
|
||||||
|
Triple(10 * GIB, 0, 1),
|
||||||
|
Triple(10 * GIB, -1, 1),
|
||||||
|
Triple(10 * GIB, Int.MIN_VALUE, 1),
|
||||||
|
Triple(10 * GIB, 1, 0),
|
||||||
|
Triple(10 * GIB, 1, -1),
|
||||||
|
Triple(10 * GIB, 1, Int.MIN_VALUE)
|
||||||
|
).map { (available, forks, workers) ->
|
||||||
|
dynamicTest("[$available, $forks, $workers]") {
|
||||||
|
assertThrows(IllegalArgumentException::class.java) {
|
||||||
|
TestHeapPolicy.calculateHeapMiB(available, forks, workers)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@TestFactory
|
||||||
|
fun shouldParseOnlyRawFreeAndInactivePages(): List<DynamicTest> = listOf(
|
||||||
|
dynamicTest("4K pages ignore speculative and file-backed counts") {
|
||||||
|
assertEquals(
|
||||||
|
2_371_584L,
|
||||||
|
TestHeapPolicy.parseMacVmStat(
|
||||||
|
"""
|
||||||
|
Mach Virtual Memory Statistics: (page size of 4096 bytes)
|
||||||
|
Pages free: 123.
|
||||||
|
Pages speculative: 100.
|
||||||
|
Pages inactive: 456.
|
||||||
|
File-backed pages: 999.
|
||||||
|
""".trimIndent()
|
||||||
|
)
|
||||||
|
)
|
||||||
|
},
|
||||||
|
dynamicTest("16K pages accept reordered counters and whitespace") {
|
||||||
|
assertEquals(
|
||||||
|
81_920L,
|
||||||
|
TestHeapPolicy.parseMacVmStat(
|
||||||
|
" Mach Virtual Memory Statistics: (page size of 16384 bytes)\n" +
|
||||||
|
" Pages inactive : 3.\nPages active: 999.\nPages free:\t2.\n"
|
||||||
|
)
|
||||||
|
)
|
||||||
|
},
|
||||||
|
dynamicTest("both raw counters may be zero") {
|
||||||
|
assertEquals(0L, TestHeapPolicy.parseMacVmStat(vmStat("4096", "0", "0")))
|
||||||
|
},
|
||||||
|
dynamicTest("counters need not have trailing periods") {
|
||||||
|
assertEquals(20_480L, TestHeapPolicy.parseMacVmStat(vmStat("4096", "2", "3").replace(".\n", "\n")))
|
||||||
|
},
|
||||||
|
dynamicTest("the largest representable byte count remains valid") {
|
||||||
|
assertEquals(Long.MAX_VALUE, TestHeapPolicy.parseMacVmStat(vmStat("1", "9223372036854775806", "1")))
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
@TestFactory
|
||||||
|
fun shouldRejectMissingDuplicateMalformedNegativeOrOverflowingVmStatFields(): List<DynamicTest> {
|
||||||
|
val valid = vmStat("4096", "2", "3")
|
||||||
|
return listOf(
|
||||||
|
"",
|
||||||
|
"Pages free: 2.\nPages inactive: 3.\n",
|
||||||
|
"page size of 4096 bytes\nPages free: 2.\nPages inactive: 3.\n",
|
||||||
|
valid.replace("Pages free: 2.\n", ""),
|
||||||
|
valid.replace("Pages inactive: 3.\n", ""),
|
||||||
|
valid + "Pages free: 2.\n",
|
||||||
|
valid + "Pages inactive: 3.\n",
|
||||||
|
valid + "Mach Virtual Memory Statistics: (page size of 4096 bytes)\n",
|
||||||
|
valid + "Pages free: broken.\n",
|
||||||
|
vmStat("4096", "-1", "3"),
|
||||||
|
vmStat("4096", "2", "-1"),
|
||||||
|
vmStat("-4096", "2", "3"),
|
||||||
|
vmStat("0", "2", "3"),
|
||||||
|
vmStat("invalid", "2", "3"),
|
||||||
|
vmStat("4096", "2x", "3"),
|
||||||
|
vmStat("4096", "2", "3.5"),
|
||||||
|
valid.replace("Pages free:", "Pages free"),
|
||||||
|
valid.replace("bytes)", "bytes) trailing"),
|
||||||
|
vmStat("9223372036854775808", "2", "3"),
|
||||||
|
vmStat("4096", "9223372036854775808", "3"),
|
||||||
|
vmStat("1", "9223372036854775807", "1"),
|
||||||
|
vmStat("4096", "2251799813685248", "0")
|
||||||
|
).map { output ->
|
||||||
|
dynamicTest("rejects ${output.replace('\n', ' ')}") {
|
||||||
|
assertThrows(IllegalArgumentException::class.java) { TestHeapPolicy.parseMacVmStat(output) }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
fun shouldReadPositiveAvailabilityFromTheCurrentOperatingSystem() {
|
||||||
|
assertTrue(TestHeapPolicy.readAvailableBytes() > 0)
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun vmStat(pageSize: String, free: String, inactive: String): String =
|
||||||
|
"Mach Virtual Memory Statistics: (page size of $pageSize bytes)\n" +
|
||||||
|
"Pages free: $free.\nPages inactive: $inactive.\n"
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
private const val MIB = 1_048_576L
|
||||||
|
private const val GIB = 1_073_741_824L
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,429 @@
|
|||||||
|
# AWS 언어 감지·번역 Provider 구현 계획
|
||||||
|
|
||||||
|
> **실행 방식:** 사용자 승인 Subagent-driven 실행 완료. 기능 범위 검증과 독립 최종 리뷰를 통과했다.
|
||||||
|
> **후속 회귀:** 2026-11-10 사용자 보고로 추가한 P4-R1 및 P4-GATE까지 완료했다. 기존 P1~P3 완료·검증 기록은 보존한다.
|
||||||
|
> **실행 skill:** `subagent-driven-development`.
|
||||||
|
|
||||||
|
**Goal:** 기존 언어 감지·번역 계약과 캐시를 유지하면서 AWS Comprehend 및 Translate를 Papago 다음 순서로 사용할 수 있게 한다.
|
||||||
|
|
||||||
|
**Architecture:** 공급자에 종속되지 않는 UTF-8/UTF-16 code-point splitter를 공통 패키지에 추가하고 Papago 분할을 해당 helper로 옮긴다. AWS SDK for Java v2의 동기 client는 기존 명시적 AWS 자격 증명과 리전을 쓰는 lifecycle Bean으로 만들며, 두 adapter를 기존 coordinator 순서에 등록한다. 끝으로 실제 adapter를 SDK mock과 H2 저장 흐름에 연결해 캐시·worker·표시 경계를 검증한다.
|
||||||
|
|
||||||
|
**Tech Stack:** Kotlin 1.6.21, Java 17, Spring Boot 2.7.14, Gradle, JUnit 5, AWS SDK for Java v2 BOM 2.57.11, Comprehend 및 Translate 모듈.
|
||||||
|
**Spec:** [prd.md](prd.md), 승인 결정 DEC-006. 제공 API 근거는 PRD의 공식 Comprehend 및 Translate 문서 링크를 따른다.
|
||||||
|
|
||||||
|
## Global Constraints
|
||||||
|
|
||||||
|
- SDK v2 BOM은 `2.57.11`로 고정하고 `software.amazon.awssdk:comprehend`, `software.amazon.awssdk:translate`만 새 SDK 모듈로 추가한다. 기존 AWS SDK v1 의존성은 유지한다.
|
||||||
|
- 기존 `cloud.aws.credentials.access-key`, `cloud.aws.credentials.secret-key`, `cloud.aws.region.static` 설정을 사용한다. AWS 자격 증명 기본 체인, 환경변수 인증 설계, IAM 설정은 변경하지 않는다.
|
||||||
|
- AWS 동기 clients는 Spring `@Bean`과 `destroyMethod = "close"`로 관리한다. 기본 동기 HTTP runtime은 SDK의 전이 의존성으로 둔다.
|
||||||
|
- 모든 production 변경은 `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/`에, 대응 테스트는 `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/` 및 실제 영향받는 기존 테스트 디렉터리에 둔다.
|
||||||
|
- splitter는 Unicode code point 경계에서 자른다. Papago 크기는 UTF-16 code unit `5000`, AWS Translate 크기는 UTF-8 byte `10000`, 감지 prefix는 UTF-8 byte 최대 `100000`이다.
|
||||||
|
- 빈 raw Papago 문자열과 whitespace 보존을 포함한 기존 동작을 유지한다. 감지 prefix는 전체 원문 hash/cache key와 번역 입력을 바꾸지 않는다.
|
||||||
|
- 감지 순서 및 번역 순서는 각각 `PAPAGO, AWS`로 둔다. 지원 번역 언어는 기존 ko/en/ja만 허용한다.
|
||||||
|
- 공개 API, DB schema, provider interface, retry 동작, AWS IAM, 실계정 자격 증명, 유료 API 호출은 범위 밖이다.
|
||||||
|
- 구현 전에 각 구현 Task의 RED 테스트가 의도된 assertion 실패임을 확인한다. test/compiler setup 오류는 RED 증거가 아니다.
|
||||||
|
- 직접 영향받는 테스트만 `--tests`로 지정한다. 무필터 `test`, `check`, `build`, `clean build`는 자동 실행하지 않는다. 필요한 최종 산출물 확인은 `./gradlew bootJar`로 한다.
|
||||||
|
- 이후 `build.gradle.kts` 변경 시 `docs/agent-guides/실행명령어.md`의 AWS dependency/build 예시를, 신규 테스트 추가 시 해당 문서의 단일 테스트 예시를 갱신한다.
|
||||||
|
- 어떤 응답 원문, 인증정보, 민감 오류 메시지도 로그, fixture 또는 worker 오류 문자열에 노출하지 않는다.
|
||||||
|
|
||||||
|
## Review Focus
|
||||||
|
1. 경계 바로 앞의 한글 및 supplementary-plane 문자는 잘리지 않고 한 조각 안에 남으며, byte/UTF-16 한도는 초과하지 않는다. `CodePointTextSplitterTest`에서 각 공급자 한도 경계, 재구성 및 100000 byte prefix와 제외 tail을 고정한다.
|
||||||
|
2. blank 입력, 짧은 감지 입력, blank/누락 후보와 AWS 오류가 감지 cache에 잘못된 값으로 저장되지 않는다. `AwsLanguageDetectionProviderTest`와 `LanguageProviderCacheEndToEndTest`에서 호출 수와 결과를 확인한다.
|
||||||
|
3. AWS 번역 일부 조각의 오류 또는 공백 응답이 앞선 조각·원문의 성공값과 섞이거나 후속 호출을 유발하지 않는다. `AwsTranslationServiceTest` 및 필요 시 `TranslationCoordinatorTest`에서 전체 요청 폐기와 원문 단위 fallback을 확인한다.
|
||||||
|
4. AWS 기본 순서 전환 후 Papago 전용 fixture가 실제 AWS adapter를 가짜 AWS provider와 함께 로드하거나 PAPAGO 전용 검증을 바꾸지 않는다. `LanguageProviderSpringConfigurationTest` 및 아래 명시한 영향 테스트를 확인한다.
|
||||||
|
5. 서로 prefix가 같은 긴 본문도 원문 전체 hash/cache key로 구분되고, 성공 AWS 결과는 `aws` 및 `translate-2017-07-01`로 저장되며 재호출되지 않는다. `LanguageProviderCacheEndToEndTest`에서 H2 row, SDK 호출 수, 화면 결과를 확인한다.
|
||||||
|
---
|
||||||
|
|
||||||
|
## 현재 상태
|
||||||
|
| Phase | 상태 | Task | 다음 Goal | 차단 조건 |
|
||||||
|
|---:|---|---:|---|---|
|
||||||
|
| 1 | 완료 | 1/1 | 없음 | 없음 |
|
||||||
|
| 2 | 완료 | 2/2 | 없음 | 없음 |
|
||||||
|
| 3 | 완료 | 1/1 | 없음 | 없음 |
|
||||||
|
| 4 | 완료 | 1/1 | 없음 | 없음 |
|
||||||
|
|
||||||
|
P1~P4의 모든 Task/Gate가 완료됐고 활성 Goal은 없다. 실제 IAM·유료 API·운영 DB 및 사용자 전체 테스트 검증은 아래 미검증 범위로 구분한다.
|
||||||
|
## 범위와 파일 책임
|
||||||
|
|
||||||
|
### 포함
|
||||||
|
- 공통 Unicode code point splitter 및 기존 Papago 분할의 helper 이전.
|
||||||
|
- AWS Comprehend 감지 adapter, AWS Translate adapter, AWS SDK v2 client 설정 Bean.
|
||||||
|
- 감지/번역 기본 순서를 PAPAGO 다음 AWS로 등록하고 PAPAGO 전용 테스트 fixture를 명시 설정으로 고정.
|
||||||
|
- 실제 adapter, cache, worker, H2 persistence, materializer 표시 및 현재 provider guide의 구현 상태 갱신.
|
||||||
|
### 제외
|
||||||
|
- 공개 interface나 API/DB schema 변경, 기존 AWS SDK v1 마이그레이션, AWS 실계정 호출/IAM 변경.
|
||||||
|
- AWS를 이유로 한 지원 언어 확대, confidence threshold, 다중 조각 감지 집계, retry·logging 확장.
|
||||||
|
- 일반적인 provider-guide 재작성 또는 역사적 PRD/계획/결정 기록 수정.
|
||||||
|
### 파일 맵
|
||||||
|
| 책임 | 파일 |
|
||||||
|
|---|---|
|
||||||
|
| 공유 code point 분할과 UTF-8 길이 계산 | `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/CodePointTextSplitter.kt` |
|
||||||
|
| Papago splitter 사용 | `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/PapagoTranslationService.kt` |
|
||||||
|
| AWS detection/translation adapter | `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsLanguageDetectionProvider.kt`, `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsTranslationService.kt` |
|
||||||
|
| client 생성 및 종료 | `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsLanguageProviderConfiguration.kt` |
|
||||||
|
| adapter 순서와 직접 영향 테스트 | `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt`, 아래 Task별 명시 파일 |
|
||||||
|
| 의존성과 실행 예시 | `build.gradle.kts`, `docs/agent-guides/실행명령어.md` |
|
||||||
|
| AWS 검증 및 가이드 | `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderCacheEndToEndTest.kt`, `docs/20261109_감지번역공급자공통화/provider-guide.md` |
|
||||||
|
## 요구사항 추적
|
||||||
|
| PRD 요구사항 | 구현 Goal | 검증 핵심 |
|
||||||
|
|---|---|---|
|
||||||
|
| AWS-001 | `P2-T1` | client configuration의 synthetic credentials, `Region`, 종료 |
|
||||||
|
| AWS-002, AWS-003, AWS-004 | `P2-T1` | blank/짧은 입력, 100000 byte prefix, 첫 후보만 검사하고 blank면 실패 null |
|
||||||
|
| AWS-005, AWS-007 | `P2-T1` | 명시 source/target, 순차 chunk, 전체 결과/중단, 안정 version |
|
||||||
|
| AWS-006 | `P1-T1` | Papago 5000 UTF-16 회귀와 AWS UTF-8/code point 경계 |
|
||||||
|
| 순서·실제 provider cache 귀속·전체 fallback | `P2-T2`, `P3-T1` | PAPAGO → AWS, H2 저장 및 재사용, 전체 원문 fallback |
|
||||||
|
| 보안·기존 API 및 DB 계약 | 모든 Goal, 특히 `P3-T1` | cause/error marker 비노출, 기존 hash 및 저장 계약 |
|
||||||
|
## TDD 및 실행 규칙
|
||||||
|
- 구현 Task는 각각 정확히 다섯 체크박스인 `RED`, `RED 확인`, `GREEN`, `GREEN 확인`, `REFACTOR`를 가진다.
|
||||||
|
- RED 테스트를 작성한 뒤 필요한 production type의 컴파일용 빈 shell만 추가할 수 있다. shell은 요구 동작을 구현하지 않으며, intended assertion failure를 확인한 뒤에만 행동 코드를 쓴다.
|
||||||
|
- RED 확인은 해당 focused test가 테스트 누락/compile failure가 아닌 요구 동작 부재 assertion으로 실패했음을 기록한다.
|
||||||
|
- Gate는 통합 검증용 대체 절차를 따르고 TDD exception을 명시한다. P3-T1은 test-only wiring 작업이므로 첫 실행이 통과할 수 있다. 실패를 만들기 위해 production이나 응답을 고의 변경하거나 assertion을 약화하지 않는다.
|
||||||
|
- 모든 향후 명령은 저장소 루트에서 실행한다. 신규 명령은 아래 Task의 focused 명령 및 Gate 범위에 한정한다.
|
||||||
|
### Phase 1: 공통 code point 분할
|
||||||
|
|
||||||
|
**Phase 결과:** Papago의 기존 동작을 보존하며 공급자별 크기 측정 함수를 받는 내부 splitter 계약을 갖는다.
|
||||||
|
### Task 1.1: 공통 splitter와 Papago 이전
|
||||||
|
|
||||||
|
- [x] **Task 1.1: 공통 splitter와 Papago 이전**
|
||||||
|
|
||||||
|
**Goal `P1-T1`:** Papago의 기존 분할 경계를 유지하면서 code point 단위 공통 분할 및 prefix helper를 제공한다.
|
||||||
|
|
||||||
|
- **시작 조건:** 사용자 승인된 PRD 및 DEC-004/DEC-005 확인, 계획 검토와 실행 방식 선택 완료. 변경 전 `./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'`로 기존 동작의 통과를 기록한다. 기존 실패가 있으면 변경 영향과 분리해 먼저 보고한다.
|
||||||
|
- **완료 증거:** 3개 helper의 단위 테스트, Papago 기존 assertion 보존, focused 테스트 및 lint 성공.
|
||||||
|
- **범위 밖:** AWS adapter 구현, Papago HTTP 흐름·응답 계약 변경.
|
||||||
|
**Files:**
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/CodePointTextSplitter.kt`
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/PapagoTranslationService.kt`
|
||||||
|
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/CodePointTextSplitterTest.kt`
|
||||||
|
- Preserve and verify: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/PapagoTranslationServiceTest.kt`
|
||||||
|
**Interfaces:**
|
||||||
|
- **Consumes:** 기존 Papago의 `MAX_REQUEST_TEXT_LENGTH = 5000` 및 `String.length` 기준.
|
||||||
|
- **Produces:** `internal fun splitTextByCodePoint(text: String, maxSize: Int, codePointSize: (Int) -> Int): List<String>`; `internal fun takeTextPrefixByCodePoint(text: String, maxSize: Int, codePointSize: (Int) -> Int): String`; `internal fun utf8CodePointSize(codePoint: Int): Int`.
|
||||||
|
|
||||||
|
- [x] **RED:** `CodePointTextSplitterTest`에 정확 한도/초과, Korean, supplementary character, whitespace 포함 재구성, empty input (`listOf("")`), 100000 UTF-8 byte prefix와 제외 tail 테스트를 작성한다. Papago 5001/10001 및 경계 surrogate pair 기대도 기존 `PapagoTranslationServiceTest`에 유지한다.
|
||||||
|
- [x] **RED 확인:** `./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest'`를 실행한다. helper 미구현에 따른 compile failure가 아니라 splitter 요구 결과 assertion 실패를 기록한다. 테스트 실행 명령 오류는 RED가 아니다.
|
||||||
|
- [x] **GREEN:** 위 세 internal 함수를 `CodePointTextSplitter.kt`에 구현한다. UTF-16 계수 callback에는 `Character.charCount(codePoint)`, UTF-8 계수에는 `utf8CodePointSize`를 쓴다. Prefix는 첫 허용 경계에서 멈춰 전체 입력을 split하지 않는다. 공통 boundary scanning은 중복이 실제 생길 때만 private helper로 공유한다.
|
||||||
|
- [x] **GREEN 확인:** `./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest'`를 실행해 경계·재구성 assertion이 통과함을 확인한다.
|
||||||
|
- [x] **REFACTOR:** `PapagoTranslationService.splitText`를 helper 호출로 바꾸고 5000 UTF-16 callback을 지정한다. `./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'`와 `./gradlew ktlintCheck`로 Papago 전체 HTTP 회귀를 확인한다.
|
||||||
|
|
||||||
|
**P1-T1 검증 기록 (2026-11-09):**
|
||||||
|
- 변경 전 `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'`: exit 0, 기존 17개 통과. 기존 assertion은 수정하지 않았고 빈 raw 문자열/공백 HTTP 회귀 2개만 추가했다.
|
||||||
|
- RED `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest'`: 최초 실행은 테스트 컴파일 중 120초 timeout으로 RED에서 제외했다. 300초 제한 재시도로 compile 후 33개 중 32개 assertion 실패를 관찰했고, 같은 명령 재실행에서 `COMMAND_EXIT_CODE=1`을 확인했다. UTF-8 크기 assertion 예: `expected: <1> but was: <0>`. 빈 prefix 1개만 기존 shell에서도 통과했다.
|
||||||
|
- GREEN 같은 splitter focused 명령: exit 0, 33개 통과. 공통 경계 scanner를 split과 prefix가 공유하며 prefix는 전체 tail을 순회하지 않는다. JVM UTF-8 인코딩과 일치하도록 짝 없는 surrogate의 1바이트 대체 인코딩도 검증했다.
|
||||||
|
- Papago 이전 후 `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'`: 최초 실행은 테스트 컴파일 중 120초 timeout, 300초 제한 재시도는 exit 0. splitter 33개와 Papago 19개, 합계 52개 통과(실패/오류/skip 모두 0).
|
||||||
|
- `./gradlew --no-daemon ktlintCheck --continue`: exit 0. main/test/Kotlin script lint 모두 성공. LSP 도구 대신 Kotlin compile 및 lint를 사용했다. 기존 Gradle deprecation, 중복 `org.json.JSONObject` 및 변경하지 않은 테스트의 compiler warning은 수정하지 않았다.
|
||||||
|
- 신규 단일 테스트 예시만 `docs/agent-guides/실행명령어.md`에 추가했다. 상세 보고서: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/aws-implementation.7dG8YS/p1.W0mxDa/report.md`. 전체 테스트·빌드·외부 API는 실행하지 않았다. 사용자 전체 테스트 명령은 `./gradlew test`다. `P1-GATE`는 부모 reviewer 판정 전이며 완료 처리하지 않는다.
|
||||||
|
|
||||||
|
### Phase 1 Gate
|
||||||
|
|
||||||
|
- [x] **Phase 1 Gate: Papago 호환성·분할 경계 검증**
|
||||||
|
|
||||||
|
2026-11-09 Gate: 독립 reviewer 명세·품질 모두 Approved. 부모가 두 focused class 명령을 재실행해 exit 0(UP-TO-DATE)을 확인했다. 직전 실제 실행은 helper 33개 + Papago 19개, 총 52개 통과이며 ktlintCheck도 exit 0이다. LSP 도구 부재는 Kotlin 컴파일·lint로 보완했고 전체 테스트는 미실행이다.
|
||||||
|
|
||||||
|
**Goal `P1-GATE`:** 공통 helper가 Papago 호환성과 Unicode/byte 경계를 만족하는지 판정한다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P1-T1`의 다섯 체크와 결과 기록 완료.
|
||||||
|
- **완료 증거:** 두 focused test class와 ktlint 성공, assertion 및 실제 명령 결과가 기록됨.
|
||||||
|
- **범위 밖:** AWS SDK dependency 또는 adapter 추가.
|
||||||
|
- **TDD 예외 사유:** 구현을 추가하지 않는 단계별 통합 검증이다.
|
||||||
|
- **대체 검증 방법:** 아래 명령 결과와 splitter 경계 assertion을 대조하고, 기존 Papago 5000/5001/10001 및 surrogate 요청/결합 검증이 유지되는지 확인한다.
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'
|
||||||
|
./gradlew ktlintCheck
|
||||||
|
```
|
||||||
|
|
||||||
|
**Expected:** 두 테스트 범위와 lint가 exit code 0. 실패가 있으면 해당 Task의 미완료 상태를 보존한다.
|
||||||
|
### Phase 2: AWS adapters와 순서 등록
|
||||||
|
|
||||||
|
**Phase 결과:** Comprehend 및 Translate가 기존 provider contract를 구현하고 production 기본 순서 PAPAGO 다음에 AWS가 온다.
|
||||||
|
### Task 2.1: AWS SDK v2 clients와 adapters
|
||||||
|
|
||||||
|
- [x] **Task 2.1: AWS SDK v2 clients와 adapters**
|
||||||
|
|
||||||
|
**Goal `P2-T1`:** 명시된 AWS 설정으로 client lifecycle을 관리하고 기존 provider contract에 맞는 감지·번역 adapter를 추가한다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P1-GATE` 통과 및 `CodePointTextSplitter` 계약 확정.
|
||||||
|
- **완료 증거:** SDK dependency, 세 production 클래스, 세 focused test class, 실행 명령 문서 갱신과 해당 테스트 성공.
|
||||||
|
- **범위 밖:** production provider order 변경, 실 AWS 연결, IAM 권한 검증.
|
||||||
|
**Files:**
|
||||||
|
- Modify: `build.gradle.kts`
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsLanguageDetectionProvider.kt`
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsTranslationService.kt`
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsLanguageProviderConfiguration.kt`
|
||||||
|
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsLanguageDetectionProviderTest.kt`
|
||||||
|
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsTranslationServiceTest.kt`
|
||||||
|
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsLanguageProviderConfigurationTest.kt`
|
||||||
|
- Modify: `docs/agent-guides/실행명령어.md`
|
||||||
|
**Interfaces:**
|
||||||
|
- **Consumes:** `LanguageDetectionProvider.detect(query: String): String?`; `TranslationProvider.translate(request: TranslateRequest): TranslateResult`; P1 splitter three functions; existing cloud AWS `@Value` keys.
|
||||||
|
- **Produces:** `AwsLanguageDetectionProvider(ComprehendClient) : LanguageDetectionProvider`; `AwsTranslationService(TranslateClient) : TranslationProvider`; `@Configuration` bean methods `comprehendClient(): ComprehendClient`, `translateClient(): TranslateClient`, each with `@Bean(destroyMethod = "close")`.
|
||||||
|
|
||||||
|
**테스트 실행 준비:** RED 테스트를 먼저 작성하고 SDK 타입을 컴파일하는 데 필요한 BOM `2.57.11`, `comprehend`, `translate` 의존성과 비동작 shell만 준비한다. dependency resolution 및 compile 성공 자체는 RED 증거가 아니다. 생산 동작은 아래 RED 확인 뒤 구현한다.
|
||||||
|
|
||||||
|
- [x] **RED:** 신규 세 테스트 클래스에 성공·실패 assertion을 작성한다. 감지는 짧은 입력 그대로 전달, blank 무호출, 100000바이트 prefix, 첫 후보의 낮은 score/미지원 코드 허용을 검증한다. 첫 후보가 blank이고 두 번째가 유효해도 결과는 null이며 빈 후보 목록·SDK 예외도 null이다. 번역은 10000바이트 정확 경계와 초과, 한글·보조 평면 문자·공백, source/target, 순서·원문별 결과 하나, 중간 조각 또는 다음 원문의 예외/blank/null 응답 시 전체 결과 폐기와 이후 무호출을 검증한다. 빈 목록·동일 언어·미지원 언어 가드도 검증한다. Configuration은 synthetic credentials/region과 실제 client 생성·종료를 좁은 Spring context에서 검증하고, adapter는 SDK interface만 mock한다.
|
||||||
|
- [x] **RED 확인:** 세 신규 test class를 `./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageProviderConfigurationTest'`로 실행한다. 각 intended assertion 실패를 확인하며 test compile 오류는 거부한다.
|
||||||
|
- [x] **GREEN:** static credentials provider에 기존 access/secret 키를 연결하고 `Region.of`와 종료 관리 client Bean을 구현한다. 감지는 blank 무호출·짧은 입력·100000바이트 prefix를 적용하고 첫 후보만 검사한다. 첫 후보의 blank/missing 또는 SDK 예외는 null이며 후속 후보를 대신 선택하지 않는다. PRD의 prefix 한계 `shortcut:` 주석을 남긴다. 번역은 source/target을 명시하고 10000 UTF-8 바이트 이하 조각을 순서대로 번역해 원문별로 결합한다. 예외·null/blank 번역이면 전체 요청 결과를 폐기하고 이후 호출을 중단한다. 기존 언어 가드와 `translate-2017-07-01` 버전을 적용한다.
|
||||||
|
- [x] **GREEN 확인:** 동일한 세 `--tests` 대상으로 실행해 client 설정/종료, 감지 boundary 및 응답 매핑, 번역 요청 assertions가 통과함을 확인한다.
|
||||||
|
- [x] **REFACTOR:** 통과한 동작을 바꾸지 않고 이번 Task가 만든 중복만 정리한다. `docs/agent-guides/실행명령어.md`에 신규 focused 테스트 예시를 추가하고 Papago 및 AWS 공통 focused suite와 `./gradlew ktlintCheck` 결과를 기록한다.
|
||||||
|
|
||||||
|
**P2-T1 검증 기록 (2026-11-09):**
|
||||||
|
- 아래 명령에 모두 `--no-daemon`을 추가하고 600000ms timeout 및 전용 TMPDIR/cache 경로를 사용했다. 테스트 세 클래스를 먼저 작성한 뒤 dependency와 비동작 shell만 추가했다. 최초 세 클래스 RED는 main/test compile 성공 후 48개 중 40개 실패(감지 19/16 실패, 번역 27/22 실패, 설정 2/2 실패), exit 1이었다. 실제 assertion은 감지 `expected: <ko> but was: <null>`, 번역 `expected: <[translated]> but was: <[]>`, 설정 Bean 수 `expected: <1> but was: <0>`이며 compiler/setup 오류가 아니다. 빈 입력/언어 가드 8개는 shell에서도 통과했다. 숫자 exit marker만 얻기 위한 동일 RED 재실행은 하지 않았다.
|
||||||
|
- 첫 구현 후 세 클래스 실행은 exit 1(48개 중 설정 2개 실패). 실제 client 생성에서 `BeanCreationException → BeanInstantiationException → NoClassDefFoundError: org/apache/hc/client5/http/ssl/TlsSocketStrategy`를 발견했다. `dependencyInsight --dependency httpclient5` 및 `--dependency httpcore5`를 `--configuration runtimeClasspath`로 실행(각 exit 0)해 Boot의 `5.1.4`/`5.1.5` 하향 관리를 확인했다. 공식 SDK POM의 `5.6.4`/`5.4.3`으로 build extra 두 값만 정렬했으며 transport 추가/제외와 v1 변경은 없다. 정렬 후 `dependencyInsight --dependency org.apache.httpcomponents --configuration runtimeClasspath`는 exit 0이며 HTTP4는 기존 `4.5.14`/`4.4.16`, SDK v1은 `1.12.380`이다.
|
||||||
|
- HTTP5 정렬 후 실행은 실제 생성/인증/region을 통과했으나 test proxy의 종료 관찰 assertion 2개가 실패해 exit 1이었다. Spring의 원래 Bean destruction 경로에 맞춰 proxy 대신 실제 두 Apache5 pool의 종료 전 false/종료 후 true를 관찰하도록 테스트만 수정했다. 동일 세 클래스 최종 GREEN은 exit 0, 48개 통과(감지 19, 번역 27, 설정 2; failure/error/skip 0). 실제 client는 synthetic credentials와 서울/대체 region으로 생성하며 네트워크 요청 없이 종료를 검증한다.
|
||||||
|
- 위 다섯 클래스 공통 focused 명령은 exit 0, 총 100개 통과(splitter 33, Papago 19, 감지 19, 번역 27, 설정 2; failure/error/skip 0). `./gradlew --no-daemon ktlintCheck --continue`는 신규 번역 클래스 한 줄 길이로 exit 1, 신규 설정 테스트 개행으로 exit 1, 두 줄만 정리한 최종 실행은 exit 0이다. 실행 문서는 새 세 단일 테스트 및 AWS dependency/build 예시만 추가했다.
|
||||||
|
- 원문·합성 민감 오류 marker의 신규 로그 비노출 assertion을 확인했다. LSP 도구가 없어 Kotlin compiler와 lint를 사용했다. 전체 테스트, build/check/clean, bootJar, 실 AWS/Papago 호출, 실제 자격 증명/IAM 및 SDK wire/signing은 미검증이다. 사용자 전체 테스트 명령은 `./gradlew test`다. 상세 명령·실패 이력·변경 파일 보고서는 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/aws-implementation.7dG8YS/p2-adapters.wy5Eu6/report.md`에 저장했다. Provider order와 다른 Task/Gate는 변경하지 않았다.
|
||||||
|
|
||||||
|
**검증 명령:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageProviderConfigurationTest'
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageProviderConfigurationTest'
|
||||||
|
./gradlew ktlintCheck
|
||||||
|
```
|
||||||
|
|
||||||
|
Maven Central BOM POM 확인 URL: `https://repo.maven.apache.org/maven2/software/amazon/awssdk/bom/2.57.11/bom-2.57.11.pom`. SDK 2.57.11 BOM/service POM과 Java 17 호환성은 부모 조사에서 확인된 근거다. 실제 Gradle dependency resolution 및 프로젝트 통합 호환성은 이 Task 실행 시 검증하며, 현재 이미 통과했다고 기록하지 않는다. 전이 기본 HTTP runtime 외의 transport 의존성/제외는 추가하지 않는다.
|
||||||
|
### Task 2.2: AWS 기본 순서와 Papago 전용 fixture
|
||||||
|
|
||||||
|
- [x] **Task 2.2: AWS 기본 순서와 Papago 전용 fixture**
|
||||||
|
|
||||||
|
**Goal `P2-T2`:** 실제 두 AWS adapter를 등록하고 Papago 전용 테스트는 의도한 한 provider만 주입하도록 고정한다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P2-T1`의 adapter 테스트와 configuration 성공.
|
||||||
|
- **완료 증거:** 두 default list의 순서, 영향 테스트의 PAPAGO 전용 설정, 실제 AWS와 fake AWS bean의 중복 없는 Spring wiring을 검증.
|
||||||
|
- **범위 밖:** 공개 provider ID/code, properties 검증 규칙 및 기존 PAPAGO 우선순위 변경.
|
||||||
|
**Files:**
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderIdTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderSpringConfigurationTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorkerTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/content/LanguageDetectionCacheServiceTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/content/CreatorCommunityLanguageDetectTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/content/CreatorCommunityLanguageDetectionCacheConcurrencyTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/community/translation/CreatorCommunityTranslationServiceTest.kt`
|
||||||
|
**Interfaces:**
|
||||||
|
- **Consumes:** `AwsLanguageDetectionProvider` 및 `AwsTranslationService` 실제 Spring components, `LanguageProviderProperties(List<LanguageProviderId>, List<LanguageProviderId>)`.
|
||||||
|
- **Produces:** production `detectionOrder`와 `translationOrder` 각각 `listOf(PAPAGO, AWS)`; fake-only test runner와 actual-adapter runner가 구분된 Spring wiring.
|
||||||
|
|
||||||
|
- [x] **RED:** `LanguageProviderIdTest`의 기본 순서 assertion을 `[PAPAGO, AWS]`로 기대하고 production adapter identity 및 안정 code assertion은 보존한다. Spring 기본 순서/legacy override 테스트에 두 provider와 PAPAGO 첫 성공, AWS 미호출 assertion을 추가한다.
|
||||||
|
- [x] **RED 확인:** `./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderIdTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest'` 실행 결과가 production default가 아직 `[PAPAGO]`인 데서 비롯된 intended assertion failure인지 확인한다.
|
||||||
|
- [x] **GREEN:** `LanguageProviderOrder.kt`의 두 목록에 AWS를 Papago 다음에 추가한다. Spring 테스트의 legacy property/env default 기대를 새 순서로 갱신하며 PAPAGO 우선 성공과 AWS 미호출을 검증한다. actual adapter를 검증할 runner는 SDK mock과 함께 별도로 구성하고 fake `AwsProviders`를 같은 capability에 로드하지 않는다.
|
||||||
|
- [x] **GREEN 확인:** 위 두 class를 다시 실행한다. startup uniqueness assertion을 유지하고 `shouldRejectInvalidOrdersAtStartup`의 `papagoRunner`가 AWS 없는 `[AWS]` 설정에서 실패하는 검증을 그대로 보존한다.
|
||||||
|
- [x] **REFACTOR:** 아래 영향 테스트 helper만 `LanguageProviderProperties(listOf(PAPAGO), listOf(PAPAGO))`로 명시해 기존 단일 Papago 기대를 유지한다. `LanguageProviderPropertiesTest`의 invalid inventory 검증은 변경하지 않는다. 전체 지정 suite와 ktlint 결과를 기록한다.
|
||||||
|
|
||||||
|
PAPAGO-only fixture 대상은 `TranslationJobWorkerTest`의 여섯 coordinator 생성 위치, `LanguageDetectionCacheServiceTest.service`, `CreatorCommunityLanguageDetectTest`의 production 기본 properties import 및 `ControlledLanguageDetectionCacheService` super 생성자, `CreatorCommunityLanguageDetectionCacheConcurrencyTest`의 imported default properties, `CreatorCommunityTranslationServiceTest.materializer` helper다.
|
||||||
|
**검증 명령:**
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest'
|
||||||
|
./gradlew ktlintCheck
|
||||||
|
```
|
||||||
|
|
||||||
|
**P2-T2 검증 기록 (2026-11-10):**
|
||||||
|
- 모든 Gradle 명령은 저장소 루트에서 `--no-daemon`, timeout 600000ms 및 전용 TMPDIR/runtime cache 환경으로 실행했다. 두 default assertion 테스트부터 작성한 최초 RED는 exit 1, 10개 중 5개 실패였다(ID 3/1 실패, Spring 7/4 실패; 오류/skip 0). 실패는 모두 `expected: <[PAPAGO, AWS]> but was: <[PAPAGO]>`이며 compiler/setup 오류가 아니다. 두 production 목록 변경 후 같은 명령의 GREEN은 exit 0, 10개 전체 통과다.
|
||||||
|
- Production 변경은 `LanguageProviderOrder.kt` 두 목록뿐이다. Spring fake AWS runner와 실제 `AwsLanguageDetectionProvider`/`AwsTranslationService` + SDK interface mock runner를 분리했다. 실제 capability별 두 Bean, AWS enum/version, PAPAGO 첫 성공 뒤 AWS 무호출, 명시 AWS 우선 SDK 요청/응답을 확인했다. legacy property/env 무시, PAPAGO adapter identity/code 및 `papagoRunner`의 AWS 없는 inventory 거부는 유지했다. `LanguageProviderPropertiesTest`는 수정하지 않았다.
|
||||||
|
- 지정 Papago-only fixture만 명시 목록으로 격리했다(worker 여섯 coordinator, content cache helper, community 감지 테스트의 imported properties와 controlled service super 생성자, concurrency imported properties, community translation materializer). 기존 기대와 assertion은 유지했다. `i18n.translation.*` + `content.LanguageDetectionCacheServiceTest` 명령은 최초/최종 모두 exit 0, 각 142개 통과다. 별도 세 community class 명령도 최초/최종 모두 exit 0, 각 30개 통과(감지 12, concurrency 2, translation 16)이며 두 최종 실행의 실패/오류/skip은 모두 0이다.
|
||||||
|
- `./gradlew --no-daemon ktlintCheck`는 최초에 신규 테스트 네 파일의 인자 개행/130자 위반으로 exit 1이었다. 해당 변경 줄만 개행한 최종 실행은 exit 0이며 format 명령은 실행하지 않았다. `./gradlew --no-daemon bootJar`는 exit 0이다. 최종 포맷 뒤 두 focused suite를 각각 다시 실제 실행했다. 산출물의 production 클래스와 실제 AWS 번역 adapter를 호출한 Java 드라이버는 exit 0으로 기본 순서, 첫 성공 무호출, AWS fallback, blank 입력 및 AWS 누락 거부를 확인했다. 네트워크 요청은 없다.
|
||||||
|
- 기존 Gradle deprecation, 중복 `org.json.JSONObject`, invalid-order startup 및 worker 실패 시나리오의 예상 WARN은 유지했다. LSP가 없어 Kotlin main/test compile 및 lint로 검증했다. 전체 테스트·실 AWS/Papago·실제 credentials/IAM·운영 DB는 미검증이며 사용자 전체 명령은 `./gradlew test`다. 상세 count/명령/로그 및 보고서는 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/aws-implementation.7dG8YS/p2-order.NhauNM/report.md`에 기록했다. `P2-GATE`는 부모 독립 review 전이며 체크하지 않았다. 다른 Task/Gate와 현재 상태 표는 변경하지 않았다.
|
||||||
|
|
||||||
|
### Phase 2 Gate
|
||||||
|
|
||||||
|
- [x] **Phase 2 Gate: AWS 동작·순서·직접 영향 회귀 검증**
|
||||||
|
|
||||||
|
2026-11-10 Gate: 독립 reviewer 명세·품질 Approved. 부모가 모든 변경 diff와 suite/lint/build 증거를 대조했다. translation/cache 142개와 community 30개 모두 실패·오류·skip 0, ktlintCheck 및 bootJar exit 0. 실제 AWS adapter의 localhost SDK 요청 검증도 완료했다. 실 AWS IAM·번역 품질·전체 테스트는 미검증이다.
|
||||||
|
|
||||||
|
**Goal `P2-GATE`:** AWS adapter 동작, default provider order, Papago 전용 회귀 및 두 capability wiring을 판정한다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P2-T1`, `P2-T2` 완료 증거와 Progress 기록.
|
||||||
|
- **완료 증거:** 아래 두 focused suite, ktlint 및 `bootJar` exit code 0. Gradle에서 실제 dependency resolution도 성공.
|
||||||
|
- **범위 밖:** 전체 테스트, live cloud/API, IAM 권한 확인.
|
||||||
|
- **TDD 예외 사유:** 구현 결과에 대한 검증 gate다.
|
||||||
|
- **대체 검증 방법:** focused suites를 각각 실행하고 Papago-only fixtures, 실제 AWS adapter, provider uniqueness와 저장 계약 경계를 대조한다. 실제 AWS 권한은 미검증으로 기록한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest'
|
||||||
|
./gradlew ktlintCheck
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
Phase 2 관련 추가 회귀는 coordinator/worker/cache/end-to-end 테스트에 한정한다. 무필터 `test`나 `check`/`build`는 실행하지 않는다.
|
||||||
|
### Phase 3: 실제 adapter의 저장·표시 경로 검증
|
||||||
|
|
||||||
|
**Phase 결과:** SDK mock으로 실제 AWS adapter를 H2 기반 기존 worker/cache/materializer 경로에서 실행하고 현재 확장 가이드를 실제 구현과 일치시킨다.
|
||||||
|
|
||||||
|
### Task 3.1: adapter end-to-end와 현재 가이드
|
||||||
|
|
||||||
|
- [x] **Task 3.1: 실제 adapter 통합 검증과 현재 가이드**
|
||||||
|
|
||||||
|
**Goal `P3-T1`:** 실제 AWS adapter 성공·cache 재사용·fallback·표시를 H2에서 검증하고 현재 provider guide 설명을 갱신한다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P2-GATE` 통과.
|
||||||
|
- **완료 증거:** actual SDK adapter mock을 이용한 H2 검증, 원문 full hash 및 output/providerVersion 저장 assertion, guide 대조 완료.
|
||||||
|
- **범위 밖:** 실 AWS 연결, 운영 MySQL claim query의 SKIP LOCKED 동작 증명, 역사적 PRD 변경.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderCacheEndToEndTest.kt`
|
||||||
|
- Modify if required by a proven gap: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationCoordinatorTest.kt`
|
||||||
|
- Modify if required by a proven gap: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorkerTest.kt`
|
||||||
|
- Modify: `docs/20261109_감지번역공급자공통화/provider-guide.md`
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
|
||||||
|
- **Consumes:** `AwsLanguageDetectionProvider(ComprehendClient)`, `AwsTranslationService(TranslateClient)`, production order `[PAPAGO, AWS]`, 기존 H2 cache/worker/materializer wiring.
|
||||||
|
- **Produces:** H2 integration evidence for original full-source cache identity, successful AWS provider/version attribution, SDK call count and displayed output; current guide description of AWS adapters, order, splitter and version.
|
||||||
|
|
||||||
|
- [x] **TDD (명시적 예외):** test-only integration wiring 및 검증이다. 새 전체 경로 검증은 첫 실행에 통과할 수 있으므로 인위적 RED를 만들지 않는다. Production behavior, SDK response 또는 assertion을 sabotage/약화하지 않는다.
|
||||||
|
- [x] **TDD 예외 대체 검증:** `LanguageProviderCacheEndToEndTest`에서 실제 adapters를 사용하고 AWS SDK interface만 mock한다. 중복 fake AWS beans/casts를 제거하고 assertion을 actual SDK call counts로 바꾼다. Comprehend에 동일 prefix와 서로 다른 tail을 가진 긴 원문 두 개를 보내 full hash/cache row가 구분되는지 확인하고 반복 조회는 AWS 호출이 없는지 확인한다.
|
||||||
|
- [x] **TDD 예외 대체 검증:** 번역 경로에서 Papago 실패 후 실제 AWS adapter의 성공 결과가 `aws`, `translate-2017-07-01`, 정확한 joined output으로 저장되고 worker 완료 및 materializer 화면에 보이는지 검증한다. cache 재사용 시 AWS 재호출이 없고, generic `Recording` provider의 version rewriting이 없음을 확인한다.
|
||||||
|
- [x] **TDD 예외 대체 검증:** 기존 `PAPAGO → AWS` production order를 보존한다. 실제 AWS adapter의 중간 조각 실패를 명시적 테스트 순서 `AWS → PAPAGO`로 실행해 다음 공급자에 원래 요청 전체가 전달됨을 검증한다. 모든 공급자 실패 시 cause 없는 고정 오류와 worker 오류 저장을 확인하고, 실패한 AWS의 부분 번역 memory가 저장되지 않음을 H2에서 확인한다. 기존 테스트가 이를 이미 검증하면 재사용하고 없으면 명시된 coordinator/worker 테스트에 추가한다. 합성 민감 오류 marker와 원문은 최종 오류·신규 로그에 없어야 한다.
|
||||||
|
- [x] **TDD 예외 대체 검증:** `provider-guide.md`의 현재 구현, default order, helper와 provider version 문장을 코드와 대조해 갱신한다. H2의 claim query spy는 기존 `FOR UPDATE SKIP LOCKED` 한정으로만 설명한다. Progress에 명령, 실제 결과, 운영 DB/live API 미검증을 기록한다.
|
||||||
|
|
||||||
|
**P3-T1 검증 기록 (2026-11-10):**
|
||||||
|
- Test-only 예외대로 production 변경이나 인위적 RED 없이 기존 E2E를 실제 `AwsLanguageDetectionProvider`/`AwsTranslationService`와 mock `ComprehendClient`/`TranslateClient`로 교체했다. Fake AWS 두 Bean과 해당 recording 주입을 제거하고 Papago 실패 fixture, 실제 H2 저장소·worker·materializer·표시 및 기존 claim query 한 곳의 spy를 유지했다. SDK mock은 매 테스트 `Mockito.reset`, Papago 기록 목록과 cache/job/read model은 매 테스트 비워 context 재사용을 격리한다.
|
||||||
|
- 최초 `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest'`는 exit 0, 32초, 5개 전체 통과(실패/오류/skip 0)다. 같은 100000 UTF-8 바이트 prefix의 서로 다른 전체 원문 두 개가 같은 SDK prefix 두 번, 서로 다른 전체 hash 및 H2 aws row 두 개를 만들고 반복 조회에는 추가 SDK/Papago 호출이 없다. 첫 후보가 blank이고 둘째가 유효한 응답은 두 번 모두 null이며 H2 row는 0이다.
|
||||||
|
- 10000 UTF-8 바이트를 넘는 한글·보조 평면 원문은 Papago 실패 뒤 실제 AWS 두 조각으로 번역된다. H2 memory 한 개에 전체 원문/hash, `aws`, `translate-2017-07-01`, 정확한 `first tail` 결과를 저장하고 worker 완료와 유효 표시를 확인했다. read model/job을 삭제한 뒤 materializer 재생성과 새 job도 같은 memory를 사용하며 총 SDK 2회/Papago 1회가 늘지 않는다. 실제 중간 SDK 오류는 앞선 성공까지 버려 빈 결과를 반환하고 후속 조각/원문을 호출하지 않는다. 전체 실패의 cause는 null, worker 재시도 오류는 `all translation providers failed`, memory/read model은 0이며 합성 민감 marker와 원문은 출력에 없다. 별도 로컬 `AWS → PAPAGO` 순서에서는 여러 원문을 포함한 원래 요청 객체 전체가 Papago에 전달된다. 모든 경계를 E2E에서 검증하므로 coordinator/worker 단위 테스트의 중복 추가는 필요하지 않았다.
|
||||||
|
- 위 지정 translation/cache 명령에 `--no-daemon`을 추가한 실행은 exit 0, 25초, 145개 통과다(기존 142개에서 E2E 2→5로 3개 추가). 별도 세 community class 명령은 exit 0, 32초, 30개 통과(감지 12, concurrency 2, translation 16)다. 두 실행 모두 `:test`가 실제 실행됐고 실패/오류/skip은 0이다. `./gradlew --no-daemon ktlintCheck`는 exit 0, 24초(test lint 실제 실행), `./gradlew --no-daemon bootJar`는 exit 0, 11초(`UP-TO-DATE`)다. 모든 Gradle 명령은 timeout 600000ms와 전용 TMPDIR/runtime cache 환경으로 실행했다.
|
||||||
|
- 현재 `provider-guide.md`만 실제 adapter 가용성·기본 순서·공유 splitter·기존 명시 credentials/region·SDK/HTTP5 버전·providerVersion·테스트 경계에 맞췄고 역사적 PRD/계획은 수정하지 않았다. 기존 Gradle deprecation, 중복 `org.json.JSONObject`, negative startup/worker 시나리오의 예상 WARN은 유지했다. LSP 도구가 없어 Kotlin test compile과 lint로 보완했다. 전체 테스트·실 AWS/Papago·credentials/IAM·운영 MySQL claim 동시성 및 별도 SDK wire QA는 이 Task에서 실행하지 않았다. 사용자 전체 테스트 명령은 `./gradlew test`다. 상세 명령/count/파일/로그는 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/aws-implementation.7dG8YS/p3-integration.QpAQTJ/report.md`에 기록했다. `P3-GATE`, 상단 상태 표와 다른 Task/Gate는 부모 소유로 남겼다.
|
||||||
|
|
||||||
|
**검증 명령:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest'
|
||||||
|
./gradlew ktlintCheck
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
**H2 검증 경계:** repository 저장·별도 transaction 조회·materializer/display는 실제 H2다. Claim query만 H2 호환 spy로 교체한다. 이 경로는 SDK serialization/signing, 실제 AWS 품질·권한, 운영 MySQL `SKIP LOCKED` 동시성을 증명하지 않는다.
|
||||||
|
|
||||||
|
### Phase 3 Gate
|
||||||
|
|
||||||
|
- [x] **Phase 3 Gate: 기능 범위 최종 검증**
|
||||||
|
|
||||||
|
2026-11-10 Gate: Oracle이 P3 명세·품질과 전체 변경을 승인했다. 부모가 별도 fresh 실행한 translation/cache 145건, community 30건 모두 통과했고 lint·bootJar·최종 산출물 기반 실제 SDK localhost QA도 성공했다. 실패·오류·skip 0이며 코드·가이드·PRD를 대조했다. 실제 IAM·AWS/Papago 품질·과금·운영 MySQL 및 전체 테스트는 미검증이며 기능 범위 완료와 구분한다.
|
||||||
|
|
||||||
|
**Goal `P3-GATE`:** 세 Phase의 범위, 실제 adapter 사용자 흐름, 문서 최신성 및 검증 증거를 최종 판정한다.
|
||||||
|
|
||||||
|
- **시작 조건:** `P3-T1`과 모든 이전 Goal 완료 증거 기록.
|
||||||
|
- **완료 증거:** 아래 focused suite 각각 성공, ktlint와 bootJar 성공, trace table의 요구사항과 실제 결과 대조, 전체 테스트 미실행 표시.
|
||||||
|
- **범위 밖:** test 전체 실행, 실 AWS 호출 및 PRD의 IAM/live 품질 미검증 상태 변경.
|
||||||
|
- **TDD 예외 사유:** 구현을 새로 하지 않는 final verification gate다.
|
||||||
|
- **대체 검증 방법:** 아래 명령 결과, H2 assertion, guide/current code/PRD 대조 및 문서 공백 검사를 Progress에 기록한다. 사용자의 전체 검증 명령은 별도로 안내한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest'
|
||||||
|
./gradlew ktlintCheck
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
**Expected:** 각 명령이 exit code 0이고 문서/코드 대조에서 미해결 contract 차이가 없다. 전체 테스트는 사용자가 `./gradlew test`로 실행하며, 이 계획의 focused 성공을 전체 성공으로 표현하지 않는다.
|
||||||
|
|
||||||
|
## Goal 순서와 의존성
|
||||||
|
|
||||||
|
### Phase 4: 공용 테스트 AWS 초기화 회귀 보정
|
||||||
|
|
||||||
|
- [x] **Task 4.1: 테스트 전용 인증정보와 공유 설정 회귀 (`P4-R1`)**
|
||||||
|
- **목표:** 공용 테스트 YAML로 전체 Spring 앱이 시작되며 운영의 빈 키 거부는 그대로 유지한다.
|
||||||
|
- **시작 조건:** `SpringBootIntegrationSampleTest`가 `Access key ID cannot be blank` 및 `AwsLanguageProviderConfiguration.kt:18`에서 실패함을 수정 전에 재현.
|
||||||
|
- **완료 증거:** 아래 RED/GREEN, 실제 H2·Redis 및 로컬 HTTP 통합 검증, 독립 리뷰와 결과 기록.
|
||||||
|
- **범위 밖:** 운영 코드·인증정보·Provider 순서·lazy/profile 우회·전체 테스트·실 AWS 호출 변경.
|
||||||
|
- **Files:** 수정 `src/test/resources/application.yml`, `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/AwsLanguageProviderConfigurationTest.kt`; 검증 `src/test/kotlin/kr/co/vividnext/sodalive/support/SpringBootIntegrationSampleTest.kt`, `src/test/kotlin/kr/co/vividnext/sodalive/deployment/DeploymentEndpointIntegrationTest.kt`.
|
||||||
|
- **계약:** 공용 test YAML을 실제로 로드하고 인증정보 property를 테스트에서 덮어쓰지 않는다. 두 client와 두 provider가 생성되며 합성 static credentials/서울 설정을 사용한다. 운영 빈 access/secret 키는 계속 실패한다.
|
||||||
|
- [x] **RED:** 공용 YAML 기반 AWS 설정·provider 생성 assertion과 빈 키 거부 회귀를 기존 설정 테스트에 추가한다.
|
||||||
|
- [x] **RED 확인:** `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageProviderConfigurationTest'`에서 공용 빈 키가 원인인 실패를 확인한다.
|
||||||
|
- [x] **GREEN:** 공용 test YAML의 accessKey/secretKey 두 값만 명백한 테스트 전용 가짜 값으로 교체한다. production 설정·검증은 수정하지 않는다.
|
||||||
|
- [x] **GREEN 확인:** 같은 설정 테스트와 `SpringBootIntegrationSampleTest`, `DeploymentEndpointIntegrationTest`를 각각 focused 실행한다.
|
||||||
|
- [x] **REFACTOR:** 불필요한 추가 변경 없이 `i18n.translation.*` 회귀·`ktlintCheck`와 변경 공백 검사를 수행하고 실패·성공 증거를 기록한다.
|
||||||
|
|
||||||
|
**P4-R1 검증 기록 (2026-11-10):**
|
||||||
|
- `ConfigDataApplicationContextInitializer`로 실제 공용 `application.yml`을 읽는 설정 회귀를 기존 클래스에 추가했다. 이 회귀는 인증정보 property override나 SDK/provider mock 없이 실제 configuration·두 client·두 adapter를 로드하고 capability별 Bean 수, AWS ID, static synthetic credentials와 서울 리전을 확인한다. 기존 두 region의 실제 client 생성·종료 테스트는 수정하지 않았다. 별도 parameterized negative 2건은 동일 production configuration에서 blank access/secret 각각의 startup failure와 SDK root cause를 확인한다.
|
||||||
|
- YAML 수정 전 `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageProviderConfigurationTest'`: exit 1, 19초, 5건 중 공유 YAML 회귀 1건 실패(오류/skip 0). `assertNull(context.startupFailure)`가 `BeanCreationException → BeanInstantiationException → NullPointerException: Access key ID cannot be blank.`로 실패했다. main/test compile은 성공했으며 기존 lifecycle 2건과 빈 키 거부 2건은 통과했다. 원본 RED assertion/count는 아래 보고서 경로의 `01-config-red-evidence.log`에 보존했다.
|
||||||
|
- `src/test/resources/application.yml`의 두 값만 `test-access-key`/`test-secret-key`로 교체했다. 동일 설정 focused 명령은 exit 0, 13초, 5건 전체 통과다. 두 negative는 각각 `Access key ID cannot be blank.`와 `Secret access key cannot be blank.`를 계속 확인한다. production 코드·설정·build와 다른 도메인 테스트는 이번 수정에서 변경하지 않았다.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.support.SpringBootIntegrationSampleTest'`: exit 0, 35초, 1건 통과. 실제 전체 Spring 앱에서 H2 `select 1`과 embedded Redis set/get을 확인했다. `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.deployment.DeploymentEndpointIntegrationTest'`: exit 0, 35초, 4건 통과. 실제 Tomcat 앱/management 포트 `65041`/`65042`에서 TestRestTemplate HTTP로 readiness 200 두 경로, deployment 기본 응답 및 앱 포트 비노출을 검증했다. 두 기존 클래스와 credential override는 추가·변경하지 않았다.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.*'`: exit 0, 26초, 15개 클래스 146건 통과(AWS 설정/감지/번역 5/19/27건 포함). GREEN 실행은 모두 실패/오류/skip 0이며 `:test`가 실제 실행됐다. 중복 없는 검증 범위는 translation 146건과 전체 앱/HTTP 5건, 총 151건이다. `./gradlew --no-daemon ktlintCheck`: exit 0, 20초(test lint 실제 실행); `git diff --check`: exit 0. 불필요한 refactor/format과 bootJar는 실행하지 않았다.
|
||||||
|
- 모든 Gradle 명령은 timeout 600000ms와 지정 TMPDIR/cache export로 실행했다. 테스트 후 lsof/ps에서 해당 Spring test workers, Redis `65026`, HTTP `65041`/`65042`와 잔존 Redis listener가 없었으며 프로세스를 kill하지 않았다. LSP 도구가 없어 Kotlin compile·ktlint로 보완했다. Gradle deprecation, 기존 중복 JSONObject 경고와 JVM 종료 시 Redis 재접속 WARN은 수정하지 않았다. 전체 테스트·실 AWS/Papago·실계정/IAM은 미검증이며 사용자 전체 명령은 `./gradlew test`다.
|
||||||
|
- 상세 명령/exit/count/RED 증거 보고서: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/aws-test-fix.We4KIU/fix.4xaIEt/report.md`. 다섯 실행 체크는 완료했으며 완료 증거의 독립 리뷰 및 Task 최상위 완료 판정은 부모에게 남긴다. `P4-GATE`, 상단 상태 표, PRD와 기존 P1~P3 기록은 수정하지 않았다.
|
||||||
|
|
||||||
|
- [x] **Phase 4 Gate (`P4-GATE`): 회귀 수정·운영 검증 보존 승인**
|
||||||
|
- **시작 조건:** P4-R1 결과 및 독립 리뷰 확인.
|
||||||
|
- **완료 증거:** 설정 회귀, H2/Redis 전체 앱, 실제 로컬 HTTP 테스트가 통과하고 production diff가 이번 수정에 없음을 확인한다.
|
||||||
|
- **범위 밖:** 전체 테스트 성공 또는 실 IAM 검증으로 확대 해석하지 않는다.
|
||||||
|
- **TDD 예외:** Gate는 검증·문서 마감이며 새 동작을 구현하지 않는다.
|
||||||
|
- **대체 검증:** 위 focused 명령의 실제 실행 결과, runtime context·HTTP 응답, diff·리뷰 대조.
|
||||||
|
- **진행 기록:** 2026-11-10 수정 전 `./gradlew --no-daemon test --rerun --tests 'kr.co.vividnext.sodalive.support.SpringBootIntegrationSampleTest'` 실패. root cause는 공용 test YAML의 빈 accessKey로 SDK v2의 eager credential 생성이 거부되는 것이다. 앞선 전용 AWS 설정 테스트는 합성 property를 직접 주입해 이 경로를 놓쳤다. 전체 테스트는 사용자 실행 `./gradlew test`로 남긴다.
|
||||||
|
- **부모 fresh 검증:** `./gradlew --no-daemon test --rerun --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.support.SpringBootIntegrationSampleTest' --tests 'kr.co.vividnext.sodalive.deployment.DeploymentEndpointIntegrationTest'` exit 0, 실제 재실행 17개 클래스 151건 실패·오류·skip 0을 XML에서 확인했다. `./gradlew --no-daemon ktlintCheck` 및 `git diff --check` exit 0. 실제 H2/Redis와 앱·management HTTP 경로가 포함되며 변경한 테스트 외 credential override는 없다.
|
||||||
|
- **독립 리뷰:** 명세·품질 및 S1(공용 설정 로딩), S2(빈 운영 키 거부), S3(실제 앱·HTTP) 모두 승인, 차단 사항 없음. H2가 지원하지 않는 background scheduler `SKIP LOCKED` 오류는 별도 기존 한계로 관찰했으며 이번 통과가 scheduler SQL의 정상 동작을 증명하는 것은 아니다.
|
||||||
|
- **실행 경계:** test worker PID 70305와 HTTP 포트 65088/65089가 종료됐음을 확인했다. production 코드·운영 설정·빌드에는 이번 수정이 없고, 전체 테스트·실 IAM·외부 API는 미검증이다. 위 임시 보고서의 핵심 RED/GREEN 증거는 이 문서에 보존하고 임시 산출물은 작업 종료 시 정리한다.
|
||||||
|
- **정리 영수증:** 소유한 회귀 조사·구현·리뷰 임시 root의 열린 파일이 없음을 확인하고 하위 로그·캐시·노트를 제거했다. 경로 부재 검사 exit 0. 공유 캐시·기존 프로세스·저장소 파일은 제거하지 않았다.
|
||||||
|
|
||||||
|
| 순서 | Goal | 의존성 | 실행 방식 |
|
||||||
|
|---:|---|---|---|
|
||||||
|
| 1 | `P1-T1` | 시작 조건 충족 | splitter 단일 Task |
|
||||||
|
| 2 | `P1-GATE` | `P1-T1` | focused 검증 |
|
||||||
|
| 3 | `P2-T1` | `P1-GATE` | SDK dependency 및 adapter |
|
||||||
|
| 4 | `P2-T2` | `P2-T1` | order 및 영향 fixture |
|
||||||
|
| 5 | `P2-GATE` | `P2-T1`, `P2-T2` | focused suite/lint/bootJar |
|
||||||
|
| 6 | `P3-T1` | `P2-GATE` | H2 adapter 통합 및 guide |
|
||||||
|
| 7 | `P3-GATE` | `P3-T1` | focused 최종 검증 |
|
||||||
|
| 8 | `P4-R1` | 사용자 후속 오류 재현 | 공용 테스트 설정 회귀 보정 |
|
||||||
|
| 9 | `P4-GATE` | `P4-R1` | 실제 앱·HTTP 및 리뷰 판정 |
|
||||||
|
|
||||||
|
`P1-T1 → P1-GATE → P2-T1 → P2-T2 → P2-GATE → P3-T1 → P3-GATE`. 한 번에 하나의 goal만 active로 둔다. 선행 goal이 완료되지 않으면 뒤 goal을 시작하지 않는다.
|
||||||
|
|
||||||
|
## 문서 및 실행 기록
|
||||||
|
|
||||||
|
### 계획 작성 기록
|
||||||
|
|
||||||
|
- 상태: 계획 문서만 작성 완료, 구현 대기.
|
||||||
|
- 무엇을: 승인 PRD의 확정 요구사항을 세 Phase와 일곱 Goal로 추적하고 정확한 구현/테스트 경로 및 focused 명령을 계획했다.
|
||||||
|
- 어떻게: 필수 작업/문서/실행/테스트 가이드, 샘플, 현재 PRD, build 설정, splitter/order 및 직접 영향 테스트를 읽어 파일과 계약을 확인했다.
|
||||||
|
- 실행 검증: 문서 전용 변경이므로 Gradle, 설치, AWS/API 호출을 실행하지 않는다. 향후 구현 명령은 계획 예시이며 아직 실행하지 않았다.
|
||||||
|
- 다음 행동: 사용자가 계획을 검토하고 실행 방법을 선택한 뒤에만 첫 Goal을 시작한다.
|
||||||
|
|
||||||
|
### Verification Record
|
||||||
|
|
||||||
|
#### 부모 최종 실행 검증 — 2026-11-10
|
||||||
|
|
||||||
|
- `./gradlew --no-daemon test --rerun --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'`: exit 0, 실제 test 재실행. 16개 클래스 145건, 실패·오류·skip 0을 XML에서 확인했다.
|
||||||
|
- `./gradlew --no-daemon test --rerun --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest'`: exit 0, 실제 test 재실행. 각각 12·2·16건, 총 30건 모두 통과했다. 두 범위 합계는 중복 없는 175건이다.
|
||||||
|
- `./gradlew --no-daemon ktlintCheck bootJar --rerun`: exit 0. 변경 없는 lint는 UP-TO-DATE, bootJar는 재생성했다. 앞선 실제 lint 실행도 통과했다. 산출물은 `build/libs/sodalive-0.0.1-SNAPSHOT.jar`다.
|
||||||
|
- 부모가 산출물의 classes/libs를 임시 경로에 추출하고 `javac`/`java`로 로컬 HTTP 드라이버를 실행했다. 실제 SDK의 Comprehend JSON, Translate rpc-v2-cbor 요청·응답과 서울 리전 서명, 100000바이트 prefix, 10000바이트 번역 분할·재구성·결합, blank 응답 후 중단이 모두 PASS(exit 0)였다. 합성 인증정보와 localhost만 사용했고 SDK clients와 HTTP 서버 종료를 확인했다.
|
||||||
|
- `git diff --check`: exit 0. LSP 도구가 제공되지 않아 Kotlin 컴파일과 ktlint로 보완했다. 전체 테스트 `./gradlew test`, 실제 IAM·AWS/Papago 품질·과금, 운영 MySQL claim 동시성은 미검증이다. Gradle deprecation 및 기존 중복 `org.json` 경고는 범위 밖으로 유지했다.
|
||||||
|
- 전체 변경 최종 리뷰: Oracle이 P3 명세·품질 및 전체 변경을 승인했다. 구체적 차단 사항 없음. SDK lifecycle 테스트의 내부 reflection은 버전 변경 시 유지보수가 필요하다는 비차단 제약으로 기록했다.
|
||||||
|
- 실행 중 판단: 재현된 HTTP5 충돌만 두 버전 정렬로 수정했다. 기존 HTTP4·SDK v1은 그대로이며 다른 HTTP5 사용 경로의 전체 회귀는 사용자 전체 테스트 범위다. 자동 worktree·커밋·push 없이 기존 `test` 브랜치에 변경을 남긴다.
|
||||||
|
- 2026-11-10 정리 영수증: 실제 SDK QA 서버·clients가 종료된 뒤 작업 root의 열린 파일이 없음을 `lsof`로 확인했다. 소유한 임시 root와 모든 하위 작업 캐시·드라이버·추출 jar·임시 로그를 제거하고 경로 부재를 확인했다. 저장소의 구현 코드·문서·최종 `build/libs/sodalive-0.0.1-SNAPSHOT.jar`는 유지했다. 핵심 명령·결과·실패 이력은 이 계획에 보존했다.
|
||||||
|
|
||||||
|
- P2-T1 부모 검증: 독립 reviewer 명세·품질 Approved. `./gradlew --no-daemon bootJar` exit 0. 산출물 라이브러리로 Java 드라이버를 컴파일하고 실제 SDK를 localhost HTTP 서버에 연결해 감지 prefix·서울 서명·번역 바이트 분할·결합·blank 응답 후 중단을 검증했다(exit 0). 서버 종료·client close 영수증을 확인했다. 첫 QA는 Translate가 JSON이라는 드라이버 가정으로 실패했으며 실제 rpc-v2-cbor에 맞춰 드라이버만 수정 후 통과했다. 실 AWS 호출은 없다.
|
||||||
|
- P2-T1 통합 결정: 재현된 `TlsSocketStrategy` 누락을 해결하기 위해 Spring Boot의 HTTP5 관리 버전만 SDK POM 기준 `httpclient5=5.6.4`, `httpcore5=5.4.3`으로 정렬했다. 기존 HTTP4·AWS SDK v1 선언은 유지한다.
|
||||||
|
|
||||||
|
계획 작성 시 문서 간 정합성 및 경로 대조만 수행한다. 구현 전 테스트 결과나 실행 count는 없다. 구현 시 각 Goal의 실제 명령·결과를 해당 Goal에 누적하고, 공통 회귀·문서 검사는 여기에 추가한다. 전체 테스트는 사용자가 `./gradlew test`로 실행한다.
|
||||||
|
|
||||||
|
- 2026-11-09 문서 검토: 첫 후보만 검사하는 감지 계약, SDK 준비와 RED/GREEN 순서, 기존 Papago-only fixture·미등록 공급자 거부 유지의 세 시나리오를 독립 검토해 모두 PASS를 받았다. 중요한 차단 사유 없음.
|
||||||
|
- 실제 파일 경로와 PRD 수용 기준을 대조하고 공백 검사를 수행했다. 문서 전용 변경이므로 테스트·빌드·LSP 진단·실제 AWS 호출은 수행하지 않았으며, 이 PASS는 구현 성공을 뜻하지 않는다.
|
||||||
|
|
||||||
|
### Self-review
|
||||||
|
|
||||||
|
- **Coverage:** AWS-001 client credentials/region은 P2-T1; AWS-002~004 감지 입력/후보는 P2-T1 및 P3-T1; AWS-005 chunk/atomic fallback 및 AWS-007 version은 P2-T1/P3-T1; AWS-006 Papago 및 code-point 경계는 P1-T1; 순서/cache/schema/security 요구는 P2-T2/P3-T1에 추적했다.
|
||||||
|
- **Step scan:** 모든 구현 Task에 RED, assertion 중심 RED 확인, GREEN, GREEN 확인, REFACTOR가 다섯 개씩 있다. P3 test-only와 Gate는 TDD 예외 사유 및 대체 검증을 둔다.
|
||||||
|
- **Type consistency:** splitter는 `String`, `Int`, `(Int) -> Int`, `List<String>`/`String`을 사용한다. AWS client 생성 및 constructor 주입 타입은 AWS SDK v2의 `ComprehendClient`/`TranslateClient`다.
|
||||||
|
- **Review focus:** 다섯 항목이 owner test와 task에 각각 매핑돼 있다. 빈 Papago 원문, blank 입력, Unicode 경계, full hash, 에러 민감정보를 포함한다.
|
||||||
|
- **Proportion:** plan은 테스트 대상·contract·실행 명령·dependency 및 영향 fixture를 확정하는 범위다. 별도 subsystem 분할은 필요하지 않다.
|
||||||
|
|
||||||
|
## 실행 승인 기록
|
||||||
|
|
||||||
|
요구사항과 SDK v2 방향은 DEC-006으로 승인됐다. 실행 전 이 계획의 Task 경로와 범위를 검토한다. 구현 방식은 두 선택지 중 하나를 정한다.
|
||||||
|
|
||||||
|
- **Subagent-driven:** 각 Task를 독립 실행하고 단계별 fresh review를 거친다. Goal 사이 의존성과 AWS 설정/실제 provider 등록 회귀 위험이 있어 권장한다.
|
||||||
|
- **Native:** 한 구현자가 모든 Goal을 순서대로 실행하고 마지막에 전체 변경 review를 한다.
|
||||||
|
|
||||||
|
2026-11-09 사용자가 "진행"으로 계획과 Subagent-driven 실행을 승인했다. 기존 `test` 브랜치에서 구현하며 자동 worktree 생성, 커밋·push, 실 AWS 호출은 하지 않는다.
|
||||||
|
|
||||||
|
### 커밋 전 검증 — 2026-11-10
|
||||||
|
|
||||||
|
- 사용자 `/commit-with-validation` 요청으로 공용 커밋 절차를 적용했다. 기존 구현은 변경하지 않고 의존 순서별 구현·테스트 및 문서 커밋을 준비했다.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'`: exit 0, 33초, 16개 클래스 148건 통과.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest'`: exit 0, 41초, 30건 통과.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.support.SpringBootIntegrationSampleTest' --tests 'kr.co.vividnext.sodalive.deployment.DeploymentEndpointIntegrationTest' ktlintCheck bootJar`: exit 0, 55초, 5건 통과. lint와 bootJar는 UP-TO-DATE다.
|
||||||
|
- 세 실행의 `:test`가 실제 실행됐고 XML 기준 총 183건, 실패·오류·skip 모두 0이다. `git diff --check`도 exit 0이다. 전체 테스트·실 AWS/Papago·IAM·운영 MySQL은 미검증이며 전체 테스트는 사용자가 `./gradlew test`로 실행한다.
|
||||||
@@ -0,0 +1,111 @@
|
|||||||
|
# AWS 언어 감지·번역 Provider PRD
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 작성일 | 2026-11-09 |
|
||||||
|
| 최종 수정일 | 2026-11-10 |
|
||||||
|
| 문서 상태 | 기능 구현 및 공용 테스트 설정 회귀 보정 완료 |
|
||||||
|
| 구현 상태 | P4-R1 검증·리뷰 완료, 실제 AWS/IAM 및 전체 테스트 미검증 |
|
||||||
|
| 구현 계획 | [plan-task.md](plan-task.md), P1~P4 완료 및 기존 이력 보존 |
|
||||||
|
| 근거 문서 | [공급자 공통화 PRD](../20261109_감지번역공급자공통화/prd.md), [공급자 확장 가이드](../20261109_감지번역공급자공통화/provider-guide.md) |
|
||||||
|
|
||||||
|
## 목표와 범위
|
||||||
|
|
||||||
|
공통 언어 감지·번역 구조에 AWS Comprehend 감지 Provider와 AWS Translate 번역 Provider를 추가한다. 콘텐츠 등 도메인 호출자는 기존 인터페이스와 coordinator만 사용하며 AWS 분기를 추가하지 않는다. 감지와 번역은 각각 독립적으로 등록하고 기존 캐시, 실패 전환, 저장 계약을 보존한다.
|
||||||
|
|
||||||
|
구현 범위는 두 AWS adapter와 필요한 내부 분할 로직이다. 기존 `LanguageDetectionProvider`, `TranslationProvider`, coordinator 경계, `LanguageProviderId.AWS` 및 안정 code `aws`를 유지한다. 지원 번역 언어는 기존 ko/en/ja이며 AWS를 이유로 확장하지 않는다. 공개 API, DB 스키마, 재시도 계약은 변경하지 않는다.
|
||||||
|
|
||||||
|
## 확정 요구사항
|
||||||
|
|
||||||
|
| ID | 상태 | 요구사항 | 관찰 가능한 수용 기준 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AWS-001 | 확정 | Comprehend와 Translate는 기존 `cloud.aws.credentials.access-key`, `cloud.aws.credentials.secret-key`, 서울 리전 `cloud.aws.region.static` (`ap-northeast-2`)을 재사용한다. Provider 전용 자격 증명 설정은 추가하지 않는다. | adapter 요청 테스트에서 설정된 자격 증명 공급자와 리전을 사용한다. IAM 정책을 변경하지 않으며 실제 권한은 별도로 검증되지 않았다고 표시한다. |
|
||||||
|
| AWS-002 | 확정 | 감지는 `DetectDominantLanguage`를 호출한다. 짧은 비어 있지 않은 입력도 길이로 사전 차단하지 않고, blank 입력은 기존 가드를 따른다. | 20자 미만 입력이 adapter까지 전달된다. blank 입력은 AWS 호출이 없다. |
|
||||||
|
| AWS-003 | 확정 | 감지 텍스트가 100KB를 넘으면 원문 앞부분의 최대 100000 UTF-8 바이트를 코드포인트 경계에서 잘라 보낸다. 여러 조각의 감지 결과를 합산하지 않는다. 원문 hash/cache key와 번역 원문은 바꾸지 않는다. | prefix가 UTF-8 유효하고 크기 한도를 넘지 않는다. 원문 hash/cache key와 번역 입력은 원문 기준 그대로다. 이 보수적 구현값은 공식 문서의 “100KB”를 구현하는 선택이며 공식 서비스 한도가 정확히 100000바이트라고 주장하지 않는다. |
|
||||||
|
| AWS-004 | 확정 | Comprehend 응답의 내림차순 정렬 결과에서 첫 dominant-language 후보를 사용한다. 언어 코드는 blank가 아니어야 유효하다. 임의 confidence 임계값을 두거나 공개 타입을 변경하지 않는다. | 후보가 없거나 언어 코드가 blank이면 기존 공급자 실패 전환으로 넘어가며, 유효 결과는 첫 후보 코드다. |
|
||||||
|
| AWS-005 | 확정 | Translate에는 source와 target 언어를 명시한다. 입력은 UTF-8 기준 10000바이트 이하 조각으로 나누어 원래 순서대로 번역하고 결합한다. 조각 하나라도 실패하면 해당 Provider의 부분 결과를 버리고 기존 전체 요청 단위 fallback을 따른다. | 경계·순서·결과 개수·전체 실패 동작을 검증한다. 원문과 조각 사이 whitespace를 손실 없이 재구성하고 별도 구분자를 삽입하지 않는다. |
|
||||||
|
| AWS-006 | 확정 | Papago의 기존 5000 UTF-16 코드 단위 분할은 유지한다. 내부 공통 splitter는 완전한 Unicode 코드포인트만 조각 경계로 삼고 공급자별 크기 측정 함수를 적용한다. | Papago 5000 UTF-16 단위 동작과 회귀 테스트가 유지된다. AWS 조각은 UTF-8 바이트 기준이며 한글·보조 평면 문자 경계가 유효하다. |
|
||||||
|
| AWS-007 | 확정 | 새 AWS 번역 결과의 기존 `providerVersion` 필드에는 안정 값 `translate-2017-07-01`을 사용한다. 실제 성공 Provider 귀속, 캐시 우선순위, 부분 성공 금지는 기존 공통화 계약을 따른다. | 캐시 미스 호출 성공 시 저장 귀속은 `aws`; 유효 AWS 캐시 재사용 시 외부 AWS 호출은 없다. 버전 값은 지정한 문자열이다. |
|
||||||
|
| AWS-008 | 확정 | 공용 테스트 설정만 사용하는 Spring 컨텍스트도 AWS Bean을 생성할 수 있도록 테스트 전용 합성 키를 제공한다. 운영의 빈 키 거부와 실계정 호출 금지 경계는 유지한다. | 공용 YAML을 덮어쓰지 않는 설정 회귀 및 기존 전체 앱 컨텍스트 테스트 통과. 빈 운영 키는 계속 초기화 실패. |
|
||||||
|
|
||||||
|
## 동작과 데이터 보존
|
||||||
|
|
||||||
|
- 감지 순서와 번역 순서는 독립이다. AWS가 등록된 이후의 production 순서는 기존 공통화 PRD에서 상속한 PAPAGO → AWS다. 이번 PRD를 위해 순서를 다시 사용자에게 묻지 않는다. 미구현 AWS는 현재 실행 설정에 추가된 것처럼 동작하지 않는다.
|
||||||
|
- 기존 캐시 조회 순서와 실제 성공 Provider 귀속을 유지한다. 캐시 미스에서 앞선 Provider가 실패하면 다음 Provider로 전환하고, 첫 성공 뒤에는 더 호출하지 않는다. 전체 실패는 기존 감지 null 및 번역 worker 오류 흐름을 따른다.
|
||||||
|
- AWS 번역은 결과를 Papago와 섞지 않는다. 분할 중 하나라도 실패하면 AWS의 부분 결과를 버린 뒤 전체 입력을 다음 Provider에 전달한다.
|
||||||
|
- 원문, 인증 정보, 공급자 원시 응답·오류를 새 로그나 worker 오류 문자열에 남기지 않는다. 호출자 공개 타입, API schema, DB schema는 변경하지 않는다.
|
||||||
|
- IAM 변경, 자격 증명 발급, 실제 AWS 유료 호출은 이 문서나 구현 승인에 포함되지 않는다.
|
||||||
|
- 필요한 IAM 작업은 `comprehend:DetectDominantLanguage`, `translate:TranslateText`다. API 호출만 하는 이번 범위에 `TranslateFullAccess`는 필수가 아니다. [공식 API 권한 안내](https://docs.aws.amazon.com/translate/latest/dg/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-console)를 따르며 실제 권한은 미검증이다.
|
||||||
|
|
||||||
|
## 승인된 구현 기술
|
||||||
|
|
||||||
|
다음 기술 설계는 DEC-006에서 승인됐다. 구현 계획에서 버전 pin과 파일 배치를 구체화한다.
|
||||||
|
|
||||||
|
- 새 Comprehend/Translate 모듈에만 AWS SDK for Java v2를 사용한다. 기존 SQS, SES, S3, CloudFront SDK v1은 마이그레이션하지 않는다.
|
||||||
|
- v2의 static credentials provider에 기존 명시적 `cloud.aws` 자격 증명을 연결하고 기존 region 설정을 사용한다.
|
||||||
|
- 동기 SDK client는 Spring lifecycle 관리 Bean으로 제공하고 adapter에 주입한다. 애플리케이션 종료 시 client를 닫는다.
|
||||||
|
- SDK 정확한 버전 pin과 파일·클래스 이름은 제품 결정이 아니라 구현 세부이며, 계획 단계에서 저장소 관례에 맞춰 정한다.
|
||||||
|
- splitter만 내부에서 공유한다. HTTP/SDK adapter는 별도 구현하며 `TranslationProvider` 공개 메서드는 추가하지 않는다.
|
||||||
|
- `providerVersion`은 기존 필드에 `translate-2017-07-01`을 사용한다.
|
||||||
|
|
||||||
|
AWS SDK for Java v1은 2025-12-31에 지원 종료가 공지됐다. 새 모듈에서 v2를 택하는 근거이며 기존 v1 전환 범위를 넓히지는 않는다. AWS는 v1/v2 공존 방식을 공식 지원한다.
|
||||||
|
|
||||||
|
- [AWS SDK for Java v1 지원 종료 안내](https://aws.amazon.com/blogs/developer/announcing-end-of-support-for-aws-sdk-for-java-v1-x-on-december-31-2025/)
|
||||||
|
- [SDK v1/v2 side-by-side 사용 안내](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration-side-by-side.html)
|
||||||
|
|
||||||
|
## 공식 API 근거
|
||||||
|
|
||||||
|
- [Comprehend DetectDominantLanguage](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectDominantLanguage.html): 감지 API, 100KB 입력 한도. 긴 입력 prefix 정책은 DEC-005에서 확정한다.
|
||||||
|
- [Comprehend 언어 감지 품질 안내](https://docs.aws.amazon.com/comprehend/latest/dg/how-languages.html): 20자 이상 권장. 20자 미만을 서비스의 확정 거부 조건으로 해석하지 않는다.
|
||||||
|
- [Translate TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html): source/target 명시 및 입력 최대 10000 UTF-8 바이트.
|
||||||
|
- [Papago 번역 요청 규격](https://api.ncloud-docs.com/docs/en/ai-naver-papagonmt-translation): 요청당 최대 5000 characters. 정확한 Unicode 계수 단위는 명시되지 않는다. 기존 구현의 UTF-16 `String.length` 상한을 유지하며 실제 Papago 호출은 미검증이다.
|
||||||
|
|
||||||
|
## 검증 기준 및 실행 계획
|
||||||
|
|
||||||
|
아래 검증은 실제 AWS/Papago 계정 호출 없이 완료했다. 2026-11-10 부모 fresh 실행에서 관련 테스트 175건이 통과했고, lint·bootJar 및 실제 SDK localhost 호출도 성공했다. 상세 명령과 실패·재시도 이력은 구현 계획에 보존한다.
|
||||||
|
|
||||||
|
- 내부 splitter 단위 테스트: 정확한 한도와 한도 초과, 한글, supplementary-plane 문자의 UTF-8/UTF-16 경계, 공백을 포함한 원문 손실 없는 재구성, Papago 기존 회귀.
|
||||||
|
- 감지 테스트: prefix 최대 바이트, UTF-8 코드포인트 경계 보존, prefix가 원문의 끝부분을 포함하지 않음, 응답 첫 후보 선택, blank/없음 실패 전환, 짧은 입력 전달, 원문 hash/cache key 보존.
|
||||||
|
- SDK adapter 테스트: 통제된 로컬 transport 또는 외부 경계만 대체한 SDK mock으로 요청 필드와 응답 매핑을 확인한다. 유료 API 호출은 하지 않는다.
|
||||||
|
- coordinator/캐시 테스트: PAPAGO → AWS 순서, 첫 성공 시 후속 호출 없음, 전체 입력 단위 fallback, 부분 번역 폐기, AWS 성공 캐시 귀속, 실제 AWS 캐시 재사용 시 AWS 네트워크 호출 없음.
|
||||||
|
- 기능 회귀 명령은 `./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'`이며 community 관련 3개 클래스는 별도 명령으로 검증했다. 산출물 검증은 `./gradlew bootJar`다. 전체 테스트 `./gradlew test`는 사용자가 실행한다.
|
||||||
|
|
||||||
|
## 제외 및 안전 경계
|
||||||
|
|
||||||
|
- IAM 정책/role 변경, 운영 자격 증명 교체, 실제 유료 AWS/Papago 호출.
|
||||||
|
- 공개 API, DB schema, `TranslationProvider` 공개 메서드, 번역 언어 정책 변경.
|
||||||
|
- 새 재시도, 캐시 계층, 품질 임계값, 다중 조각 감지 집계, 관측성 확장.
|
||||||
|
- 원문·인증정보·공급자 원시 본문 또는 오류의 신규 로그 기록.
|
||||||
|
- v1 SDK를 사용하는 기존 서비스의 v2 마이그레이션.
|
||||||
|
|
||||||
|
## Open Questions 및 승인 상태
|
||||||
|
|
||||||
|
| ID | 상태 | 내용 | 영향 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| OQ-001~004 | 해결, DEC-001~003 | 서울 리전/기존 자격 증명 재사용, 짧은 감지 입력, 번역 분할 | 요구사항에 반영됨 |
|
||||||
|
| OQ-005 | 해결, DEC-006 | 새 AWS 모듈에 SDK v2 사용. 기존 SDK v1 유지 | 전체 PRD와 SDK v2 제안 승인 완료 |
|
||||||
|
| OQ-006 | 해결, DEC-005 | 100KB 초과 감지 입력을 UTF-8 코드포인트 경계 prefix로 제한하고 조각별 감지 집계 없음 | 혼합 언어 입력에서는 prefix의 감지 결과가 전체 원문의 dominant language와 다를 수 있음. 구현 코드에 `shortcut: 감지는 앞 100000 UTF-8 바이트만 판정하므로 전체 본문과 결과가 다를 수 있음, 전체 본문 기준 품질이 요구되면 별도 감지 정책 승인 후 업그레이드` 형식의 주석을 둔다. |
|
||||||
|
| OQ-007 | 해결, DEC-004 | 인터페이스 변경 없이 공통 internal 분할 함수와 공급자별 길이 계산 사용 | Papago와 AWS가 공통 분할 로직을 사용함 |
|
||||||
|
|
||||||
|
요구사항 인터뷰 종료 시 가중 모호도는 약 0.03이었으며 열린 제품 질문은 없다. 승인된 전체 설계와 SDK v2 구현의 기능 범위 검증이 완료됐다. IAM의 실제 권한과 외부 API 품질 확인은 별도이며 운영 검증 완료로 간주하지 않는다.
|
||||||
|
|
||||||
|
### 문서 검증 기록
|
||||||
|
|
||||||
|
- 2026-11-09: 독립 builder 검토 결과, 제안 설계 승인 후 계획 수립을 막는 중요한 미결 사항 없음(`nothing important left`). SDK 버전 pin과 클래스 이름은 구현 계획 단계에서 결정한다.
|
||||||
|
- 문서의 결정 상태·수용 기준·공백 및 placeholder 잔존 여부를 대조했다. 문서 전용 변경이므로 Gradle 테스트·빌드와 실제 외부 API 호출은 실행하지 않았다.
|
||||||
|
- 2026-11-10 구현 후 검증: 모든 Task/Gate 완료, 관련 테스트 175건·lint·bootJar 및 실제 SDK localhost QA 통과, Oracle 전체 변경 리뷰 승인. 문서 작성 시점의 위 미실행 기록은 과거 이력이며 실제 실행 결과는 구현 계획을 따른다.
|
||||||
|
- 2026-11-10 후속 회귀: 공용 YAML의 빈 키가 실제 전체 앱 시작을 막는 실패를 재현했다. 테스트 전용 키 두 값과 공유 설정 회귀를 보완한 뒤 부모 fresh 검증 151건(번역 146건, 전체 앱·HTTP 5건)·lint 및 독립 리뷰를 통과했다. 앞선 175건과 다른 검증 범위이며 전체 테스트 성공으로 해석하지 않는다. 운영의 빈 키 거부는 그대로 유지한다.
|
||||||
|
|
||||||
|
## 결정 기록
|
||||||
|
|
||||||
|
| 날짜 | ID | 상태 | 결정 | 근거 |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| 2026-11-09 | DEC-001 | 확정 | Comprehend·Translate에 기존 자격 증명과 서울 리전 설정을 재사용한다. | 사용자: “기존 인증정보와 서울 리전을 재사용한다.” |
|
||||||
|
| 2026-11-09 | DEC-002 | 확정 | 20자 미만도 AWS 감지를 요청하고 실패·결과 없음은 기존 실패 정책을 따른다. | 사용자 답변: “네” |
|
||||||
|
| 2026-11-09 | DEC-003 | 확정 | 긴 AWS 번역은 Papago와 같은 분할·순차 번역·결합 흐름으로 구현한다. Papago 길이 단위를 공식 가이드와 대조하고 불일치가 확인되면 함께 수정한다. 공통 분할 함수 배치는 조사 후 설계한다. | 사용자: “파파고 번역이 어떻게 되어 있는지 확인하고 동일하게 처리하자”, 공식 가이드와 다르면 변경 요청 |
|
||||||
|
| 2026-11-09 | DEC-004 | 확정 | 공개 인터페이스는 유지한다. 공통 internal splitter와 공급자별 길이 계산을 사용하고 Papago 5000 UTF-16 단위 및 AWS 10000 UTF-8 바이트를 적용한다. | 사용자 답변: “그렇게 진행하자” |
|
||||||
|
| 2026-11-09 | DEC-005 | 확정 | 긴 감지 텍스트는 처음 최대 100KB만 사용한다. UTF-8 prefix를 코드포인트 경계에서 자르고 여러 조각의 언어를 합산하지 않는다. 원문 hash/cache key와 번역 입력은 그대로 유지한다. | 사용자 답변: “확정” |
|
||||||
|
| 2026-11-09 | OQ-005 | 제안 | 신규 AWS 모듈만 SDK v2 사용. 기존 SQS/SES/S3/CloudFront v1은 유지한다. | 기술 제안, 전체 설계 및 SDK 제안 승인 대기 |
|
||||||
|
| 2026-11-09 | DEC-006 | 확정 | 이 PRD의 전체 설계와 신규 AWS Provider의 SDK v2 사용을 승인하고 구현 계획 작성으로 진행한다. 기존 SDK v1 연동은 유지한다. | 최종 PRD·SDK v2 제안 승인 및 구현 계획 작성 질문에 대한 사용자 답변: "진행" |
|
||||||
|
| 2026-11-09 | DEC-007 | 확정 | 구현 계획과 Subagent-driven 실행을 승인한다. | 계획 검토·실행 방식 질문에 대한 사용자 답변: "진행" |
|
||||||
|
| 2026-11-10 | DEC-008 | 회귀 보정 | 공용 테스트 YAML의 빈 AWS 키로 전체 앱 테스트 시작이 실패함을 재현했다. 테스트 전용 합성 값과 공유 설정 로딩 회귀를 추가하며 운영 코드는 변경하지 않는다. | 사용자 오류 보고 및 SpringBootIntegrationSampleTest의 AwsLanguageProviderConfiguration:18 동일 오류 재현 |
|
||||||
@@ -0,0 +1,717 @@
|
|||||||
|
# 언어 감지·번역 공급자 공통화 구현 계획
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 작성일 | 2026-11-09 |
|
||||||
|
| 상태 | Phase 1~3 구현·검증·독립 리뷰·리소스 정리 완료 |
|
||||||
|
| 요구사항 | [prd.md](prd.md), LP-001~015 및 최종 Phase 계약 |
|
||||||
|
| 활성 Goal | 없음 |
|
||||||
|
|
||||||
|
## 목표와 제약
|
||||||
|
|
||||||
|
별도 감지·번역 인터페이스와 독립 공급자 순서 설정으로 새 구현체를 도메인 변경 없이 추가할 수 있게 한다.
|
||||||
|
기존 Kotlin 1.6.21 / Java 17 / Spring Boot 2.7.14 / RestTemplate / JPA를 사용한다.
|
||||||
|
AWS SDK·실제 adapter·새 의존성·DDL·공개 API·워커 스케줄/재시도·커뮤니티 revision 정책은 변경하지 않는다.
|
||||||
|
새 공급자 selector를 vendor처럼 등록하거나 실제 성공 결과를 selector 이름으로 저장하지 않는다.
|
||||||
|
별도 worktree 없이 현재 작업 트리에서 진행한다. 구현 위임 범위에서는 commit/staging/push하지 않는다.
|
||||||
|
부모 세션은 ULW의 명시적 커밋 지시에 따라 검증 완료 후 원자적 커밋을 만들며 push하지 않는다.
|
||||||
|
|
||||||
|
## 실행 순서
|
||||||
|
|
||||||
|
공통 계약·설정 → 감지/번역 연결과 fixture 갱신 → 기능별 회귀·HTTP/DB QA → 독립 리뷰 순서다.
|
||||||
|
생산 코드/fixture 간 공유 의존성이 있어 구현 에이전트 한 명이 순차 진행한다. 부모는 별도 QA·최종 리뷰를 맡는다.
|
||||||
|
|
||||||
|
### Phase 1: 공급자 독립 실행과 캐시
|
||||||
|
|
||||||
|
- [x] **Task 1.1: 공통 공급자 구조 구현 (P1-T1)**
|
||||||
|
|
||||||
|
**Objective:** 두 기능의 독립 우선순위, 실패 전환, 실제 provider 저장과 공통 cache 선택을 완성한다.
|
||||||
|
**시작 조건:** PRD 확정, 기존 64건 baseline 통과, Oracle 계약 검토 및 Plan 순서 검토 완료.
|
||||||
|
**완료 증거:** 새 테스트의 의미 있는 RED/GREEN, 기존 fixture 회귀, 기능 범위 빌드/정적 검사.
|
||||||
|
**범위 밖:** 실 AWS 연동, 실행 중 설정 변경, 범용 plugin framework, 새로운 DB 경합 해결 정책.
|
||||||
|
|
||||||
|
**Files (src/main/kotlin/kr/co/vividnext/sodalive 기준):**
|
||||||
|
- Create: `i18n/translation/LanguageProviderProperties.kt`, `LanguageDetectionProvider.kt`, `DetectedLanguage.kt`,
|
||||||
|
`ProviderTranslationResult.kt`, `TranslationLanguages.kt`, `PapagoLanguageDetectionProvider.kt`, `TranslationCoordinator.kt`.
|
||||||
|
- Modify: `content/LanguageDetectionCacheService.kt`, `content/LanguageDetectEvent.kt`.
|
||||||
|
- Modify: `i18n/translation/TranslationJobWorker.kt`, `TranslationReadModelMaterializer.kt`, `PapagoTranslationService.kt`,
|
||||||
|
`ResourceTranslationJobScheduler.kt`, `TranslationJobScheduler.kt`.
|
||||||
|
- Modify: `v2/creator/channel/community/translation/application/CreatorCommunityTranslationService.kt` (언어 helper 참조만).
|
||||||
|
- Modify: `src/main/resources/application.yml` (독립 순서 설정과 환경변수).
|
||||||
|
|
||||||
|
**Tests (src/test/kotlin/kr/co/vividnext/sodalive 기준):**
|
||||||
|
- Add focused tests in `i18n/translation/`: 공급자 순서 설정, `TranslationCoordinator`, `PapagoLanguageDetectionProvider`,
|
||||||
|
독립 순서 Spring wiring 및 보조 공급자 캐시 저장/materialization 통합 시나리오.
|
||||||
|
- Update: `content/LanguageDetectionCacheServiceTest.kt`, `CreatorCommunityLanguageDetectTest.kt`,
|
||||||
|
`CreatorCommunityLanguageDetectionCacheConcurrencyTest.kt`.
|
||||||
|
- Update: `i18n/translation/TranslationJobWorkerTest.kt` 및 생성자 변경의 직접 영향 fixture.
|
||||||
|
- Update where required: `v2/creator/channel/community/translation/CreatorCommunityTranslationServiceTest.kt`,
|
||||||
|
`explorer/profile/creatorCommunity/CreatorCommunityTranslationEndToEndTest.kt`.
|
||||||
|
- Preserve: `i18n/translation/PapagoTranslationServiceTest.kt`의 17개 HTTP/chunk 회귀 assertion.
|
||||||
|
|
||||||
|
**Interfaces:** PRD의 확정 구현 계약을 그대로 적용한다. 설정 validation은 각 capability의 등록 구현체 목록과 대조한다.
|
||||||
|
후보 구현체는 설정 순서로 정렬하고, 첫 성공 뒤 중단한다. catch 밖의 repository 오류는 그대로 전파한다.
|
||||||
|
DB 스키마를 유지하고 cache key의 provider 값에는 실제 성공 adapter 이름을 사용한다.
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 behavior를 보존하는 fixture 갱신 후, 두 가짜 공급자의 순서·실패 전환·저장 귀속 테스트를 작성한다.
|
||||||
|
- [x] **RED 확인:** 신규 타입의 unresolved symbol 오류는 RED로 계산하지 않는다. 필요한 최소 선언으로 컴파일한 뒤
|
||||||
|
누락된 순서/전환/캐시 동작 때문에 실패하는 assertion을 실제로 확인한다.
|
||||||
|
- [x] **GREEN:** PRD 계약을 충족하는 최소 두 coordinator 및 설정/adapter 연결을 구현한다.
|
||||||
|
- [x] **GREEN 확인:** 새 focused 테스트에서 독립 순서·캐시·폴백·모두 실패·설정 오류가 통과한다.
|
||||||
|
- [x] **REFACTOR:** 이번 변경의 중복만 정리하고 기존 focused·DB 경합·revision·chunk 테스트를 회귀 실행한다.
|
||||||
|
|
||||||
|
**P1-T1 결과:** 새 테스트 21건과 기존 64건을 포함한 85건이 기능별 실행에서 모두 통과했다.
|
||||||
|
`LanguageDetectionCacheService`의 insertIfAbsent → locking read와 커뮤니티 경합·revision assertion은 유지했다.
|
||||||
|
번역 worker/materializer는 같은 coordinator cache lookup을 사용하며 저장 provider/version은 실제 성공 adapter 값이다.
|
||||||
|
기본 production bean은 Papago뿐이며 테스트 secondary는 `@Primary` 없이 list 주입으로 등록된다.
|
||||||
|
전체 테스트·운영 MySQL·실 API 호출은 수행하지 않았다. 명령/RED·GREEN/한계는 아래 실행 증거에 누적했다.
|
||||||
|
|
||||||
|
**구현상 보존 항목:**
|
||||||
|
1. 감지 cache 트랜잭션, insertIfAbsent 이후 locking read 승자 반환, cache hit 무호출.
|
||||||
|
2. listener의 AFTER_COMMIT/REQUIRES_NEW, domain별 languageCode 가드, 커뮤니티 lock/refresh/revision 및 afterCommit 요청.
|
||||||
|
3. worker는 외부 번역을 DB 저장 트랜잭션 밖에서 실행하고, 성공 vendor 기준 저장 직전 재조회·저장한다.
|
||||||
|
4. materializer의 조회에는 외부 호출이 없고, 현재 원문 검증·read model 저장 방식은 유지한다.
|
||||||
|
5. 테스트의 latch·동시 경합·stale revision assertions는 삭제/완화하지 않는다. 새 seam으로 fixture만 옮긴다.
|
||||||
|
|
||||||
|
**검증 명령:**
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest'
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest'
|
||||||
|
./gradlew --no-daemon --offline ktlintCheck bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
- [x] **Task 1.2: 확장 방법 문서화 (P1-T2)**
|
||||||
|
|
||||||
|
**Objective:** 새 공급자 추가에 필요한 구현체·빈·설정·테스트 절차를 개발자가 바로 적용할 수 있게 한다.
|
||||||
|
**시작 조건:** 실제 구현 계약과 설정 key 확정.
|
||||||
|
**Files:** `docs/20261109_감지번역공급자공통화/provider-guide.md`.
|
||||||
|
**완료 증거:** 현재 설정과 일치하는 예시, 감지/번역별 순서 변경, 미등록 vendor 시작 실패, AWS 미구현 명시.
|
||||||
|
**TDD 예외:** 문서 변경이며 실제 코드/config/테스트와 대조한다.
|
||||||
|
**범위 밖:** 미구현 AWS 코드 예제를 작동 코드처럼 제공하거나 가짜 SDK 계약 작성.
|
||||||
|
|
||||||
|
**P1-T2 결과:** `provider-guide.md`를 작성하고 실제 interface/생성자/config/test와 대조했다.
|
||||||
|
구현체+빈+해당 기능 순서 설정만으로 확장하며 기존 business 호출자는 수정하지 않는 경로를 문서화했다.
|
||||||
|
독립 환경변수, AWS/secondary의 현재 미구현·테스트 전용 경계, cache-first 및 오류·검증 한계를 명시했다.
|
||||||
|
문서 추가 후 별도 Gradle 실행은 하지 않았고 코드 검증은 P1-T1의 fresh 결과를 사용했다.
|
||||||
|
|
||||||
|
- [x] **Phase Gate: 통합 검증·리뷰 (P1-GATE)**
|
||||||
|
|
||||||
|
**Objective:** 가짜 공급자만 추가해 실패 전환·순서 교체·저장·재사용이 관측됨을 확인한다.
|
||||||
|
**시작 조건:** P1-T1/P1-T2 완료.
|
||||||
|
**완료 증거:** 아래 시나리오 통과, 독립 리뷰의 차단 이슈 없음, 임시 리소스 정리 영수증.
|
||||||
|
**TDD 예외:** 독립 실행 확인·리뷰로, 새 구현은 추가하지 않는다.
|
||||||
|
|
||||||
|
| 시나리오 | 이진 통과 조건 | 표면 |
|
||||||
|
|---|---|---|
|
||||||
|
| S1 기존 동작 | 파파고 단독 및 기존 64건 회귀 유지 | 실제 서비스 HTTP mock + 기존 H2 integration |
|
||||||
|
| S2 독립 순서·전환 | 기능별 설정 교체가 다른 기능에 영향 없음, 첫 성공 이후 호출 0회 | Spring context와 fake adapters, 부모 driver |
|
||||||
|
| S3 저장·재사용 | 보조 공급자 실제 이름으로 저장, 이후 모든 외부 호출 0회, materializer 결과 일치 | 실제 H2 repository 재조회 |
|
||||||
|
| S4 실패·설정 | 모두 실패 시 안전한 결과, 빈/중복/unknown 설정 시작 실패, DB 오류를 공급자 실패로 숨기지 않음 | focused tests 및 부모 context driver |
|
||||||
|
| S5 파파고 감지 분리 | 감지 HTTP 형식과 결과를 유지하고 listener는 vendor를 모름 | 실제 RestTemplate loopback 또는 controlled HTTP 경계 |
|
||||||
|
|
||||||
|
## 검증 기록
|
||||||
|
|
||||||
|
- 변경 전 baseline: 번역 package, 감지 cache, 커뮤니티 감지/경합 및 번역 service 60건 통과, exit 0, 1m38s.
|
||||||
|
- 추가 baseline: `CreatorCommunityTranslationEndToEndTest` 4건 통과, exit 0, 2m38s. 합계 64건.
|
||||||
|
- Oracle는 두 coordinator, cache-first, 실제 provider 귀속, 기존 DB/트랜잭션 보존 설계를 검토했다.
|
||||||
|
- LSP 도구 미제공. Kotlin 컴파일/ktlint로 보완하며 성공한 LSP 진단으로 표현하지 않는다.
|
||||||
|
- 전체 테스트는 실행하지 않는다. 사용자 명령: `./gradlew test`.
|
||||||
|
- RUN_TMP: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/language-providers.06uAbV`.
|
||||||
|
모든 실행의 임시 자원은 이 작업 소유 root 아래에 두고 종료 시 삭제한다. 공유 Gradle 캐시나 다른 daemon은 건드리지 않는다.
|
||||||
|
- 구현 child root: `implementation.F9mSBa` (위 RUN_TMP 하위, parent 존재 확인 후 `mktemp -d` 생성).
|
||||||
|
모든 shell 실행은 이 child로 TMPDIR/NODE_COMPILE_CACHE/BUN_RUNTIME_TRANSPILER_CACHE_PATH를 지정한다.
|
||||||
|
정리 완료: 검증 프로세스 종료 확인 후 이 child만 삭제했다. 아래 영수증 참조. parent/shared cache는 유지한다.
|
||||||
|
- 실행 판정: 기존 승인 문서를 재사용하며 새 planning/worktree/리뷰 dispatch는 하지 않는다. P1-GATE는 부모가 판정한다.
|
||||||
|
|
||||||
|
### P1-T1 실행 증거 (2026-11-09)
|
||||||
|
|
||||||
|
모든 Gradle 실행은 `--no-daemon --offline`, tool timeout `600000ms`로 시작했다. 무필터 test/check/build는 실행하지 않았다.
|
||||||
|
아래 명령 전에 다음 환경변수를 child root로 지정했다. 로그는 child 안에서만 보관하며 정리 시 삭제한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export TMPDIR=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/language-providers.06uAbV/implementation.F9mSBa
|
||||||
|
export NODE_COMPILE_CACHE="$TMPDIR" BUN_RUNTIME_TRANSPILER_CACHE_PATH="$TMPDIR"
|
||||||
|
```
|
||||||
|
|
||||||
|
**RED-1 (9건, 9실패, exit 1, 7m40s):** 컴파일 가능한 최소 계약과 첫 adapter만 호출하는 coordinator로 실행했다.
|
||||||
|
설정 순서·잘못된 설정 거부·폴백·안전한 전체 실패·guard·캐시 조회 누락 assertion이 실패했다.
|
||||||
|
unresolved symbol이나 컴파일 실패는 없었다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderPropertiesTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
**RED-2 / 부분 GREEN (19건, 7실패, exit 1, 9m01s):** RED-1의 9건은 GREEN.
|
||||||
|
감지의 다음 공급자 미호출·예외 전파·보조 cache-first 누락 3건이 행동 RED였다.
|
||||||
|
raw 감지 stub의 HTTP 미호출 3건과 Spring context의 쉼표 목록 변환 문제 1건도 관측했다.
|
||||||
|
설정은 `@Value String` → split/trim으로 고쳐 별도 변환 서비스 의존을 제거했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderPropertiesTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
**H2 첫 실행 (4건, 2실패, exit 1, 3m27s):** Spring 독립 순서 2건 GREEN, 감지 fallback 누락은 행동 RED.
|
||||||
|
번역 테스트는 H2의 기존 MySQL `FOR UPDATE SKIP LOCKED` syntax 오류로 worker 결과까지 도달하지 못했으므로
|
||||||
|
이 SQL 오류는 행동 RED로 계산하지 않았다. production query는 바꾸지 않고 test spy로 claim만 대체했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
**H2 RED / 부분 GREEN (21건, 2실패, exit 1, 7m20s):** 감지 fallback과 H2 secondary 감지 귀속은 GREEN.
|
||||||
|
기존 worker가 Papago 실패 뒤 secondary를 호출하지 않아 secondary memory 재조회가 null인 행동 RED를 확인했다.
|
||||||
|
다른 1건은 HTTP form Content-Type에 실제 UTF-8 charset이 붙는 테스트 기대값 오류로, 행동 RED로 계산하지 않았다.
|
||||||
|
실제 요청의 charset을 정확히 기대하도록 수정했으며 공급자 요청 형식은 기존과 같다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderPropertiesTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
**GREEN 및 최종 회귀:** 아래 각 실행은 XML의 tests/failures/errors/skipped를 확인했다. 총 85건 = 기존 64 + 신규 21,
|
||||||
|
최종 각 실행 모두 failure/error/skipped 0, exit 0이다. 최초 package GREEN도 51건, 7m27s였다.
|
||||||
|
|
||||||
|
| 실행 | 결과 | 소요 |
|
||||||
|
|---|---|---|
|
||||||
|
| 번역 package + 감지 cache (아래 첫 명령, 최종 재실행) | 51/51 | 45s |
|
||||||
|
| 커뮤니티 감지 + 최초 cache 경합 | 14/14 (12 + 2) | 2m23s |
|
||||||
|
| 커뮤니티 번역 service + 레거시 end-to-end | 20/20 (16 + 4) | 52s |
|
||||||
|
| ktlintCheck + bootJar | 성공, exit 0 | 1m20s |
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest'
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' --tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest'
|
||||||
|
./gradlew --no-daemon --offline ktlintCheck bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
신규 21건의 구성은 TranslationCoordinator 6, 설정 unit 3, 감지 coordinator 5, Papago 감지 HTTP 3,
|
||||||
|
실제 Spring 설정 2, 실제 H2 저장/worker/materializer 2다. 기존 Papago chunk 17건은 수정 없이 통과했다.
|
||||||
|
`ktlintCheck` 초기 실행은 import/들여쓰기/줄 길이로 exit 1 (1m44s)이었으며 모든 수정을 apply_patch로 적용했다.
|
||||||
|
중간 ktlintCheck는 exit 0 (38s), 최종 ktlintCheck+bootJar도 exit 0이다. 자동 formatter는 사용하지 않았다.
|
||||||
|
기존 unrelated 테스트의 Kotlin unchecked cast/불필요한 `!!` 경고와 Gradle 9 deprecation 경고는 유지했다.
|
||||||
|
|
||||||
|
**검증 한계/판정:** 제공된 LSP/diagnostics 도구는 없다. Kotlin 컴파일과 ktlint로 보완했다.
|
||||||
|
H2 integration은 실제 DB round-trip, worker 결과, materializer 표시와 무호출 cache 재사용을 검증하지만,
|
||||||
|
H2 미지원 MySQL claim SQL 한 곳은 test spy이며 운영 MySQL claim 동시성을 새로 증명하지 않는다.
|
||||||
|
실제 유료 API·운영 DB·전체 테스트는 실행하지 않았다. 사용자 전체 검증 명령은 `./gradlew test`다.
|
||||||
|
부모의 독립 Java driver와 ONE reviewer는 P1-GATE에서 수행하며 이 구현자가 대신 완료 표시하지 않는다.
|
||||||
|
|
||||||
|
### 부모 Java QA용 실제 생성자/바인딩
|
||||||
|
|
||||||
|
`javap -classpath build/classes/kotlin/main`으로 아래 생성자와 메서드가 존재함을 확인했다.
|
||||||
|
클래스 패키지는 content service/listener를 제외하면 `kr.co.vividnext.sodalive.i18n.translation`이다.
|
||||||
|
|
||||||
|
```text
|
||||||
|
LanguageProviderProperties(String detectionOrder, String translationOrder)
|
||||||
|
LanguageProviderProperties() // 두 기능 모두 papago
|
||||||
|
getDetectionOrder(): List<String>
|
||||||
|
getTranslationOrder(): List<String>
|
||||||
|
TranslationCoordinator(List<TranslationProvider>, LanguageProviderProperties, TranslationMemoryRepository)
|
||||||
|
findCached(String sourceHash, String sourceLanguage, String targetLanguage): TranslationMemory?
|
||||||
|
translate(TranslateRequest): ProviderTranslationResult
|
||||||
|
LanguageDetectionCacheService(LanguageDetectionResultRepository, List<LanguageDetectionProvider>, LanguageProviderProperties)
|
||||||
|
detectWithCache(String): DetectedLanguage?
|
||||||
|
PapagoLanguageDetectionProvider(String papagoClientId, String papagoClientSecret)
|
||||||
|
ProviderTranslationResult(TranslateResult, String providerName, String providerVersion)
|
||||||
|
DetectedLanguage(String detectedLanguage, String providerName)
|
||||||
|
TranslationJobWorker(TranslationJobRepository, TranslationMemoryRepository, TranslationCoordinator,
|
||||||
|
TranslationReadModelMaterializer, PlatformTransactionManager)
|
||||||
|
TranslationReadModelMaterializer(TranslationSourceExtractor, TranslationCoordinator,
|
||||||
|
ContentTranslationRepository, AiCharacterTranslationRepository, ContentThemeTranslationRepository,
|
||||||
|
SeriesTranslationRepository, SeriesGenreTranslationRepository, OriginalWorkTranslationRepository,
|
||||||
|
CategoryTranslationRepository, CreatorCommunityRepository, CreatorCommunityTranslationRepository, EntityManager)
|
||||||
|
```
|
||||||
|
|
||||||
|
`LanguageDetectListener`는 기존 repository/service/EntityManager/publisher 주입을 유지하고 마지막 Papago 인증 String 2개만 제거했다.
|
||||||
|
HTTP 테스트 reflection 대상은 listener가 아니라 `PapagoLanguageDetectionProvider.restTemplate`이다.
|
||||||
|
설정은 component의 두 생성자 인자에 각각 `@Value("\${sodalive.language-providers.detection-order:papago}")`,
|
||||||
|
`@Value("\${sodalive.language-providers.translation-order:papago}")`가 붙는다.
|
||||||
|
application.yml의 독립 환경변수는 `LANGUAGE_PROVIDERS_DETECTION_ORDER`, `LANGUAGE_PROVIDERS_TRANSLATION_ORDER`다.
|
||||||
|
Spring context 테스트는 두 가짜 bean의 실제 순서 변경과 빈/중복/unknown 설정 시작 실패를 확인한다.
|
||||||
|
|
||||||
|
### 이 구현자가 변경한 전체 파일
|
||||||
|
|
||||||
|
생산 Kotlin 경로 prefix: `src/main/kotlin/kr/co/vividnext/sodalive/`.
|
||||||
|
|
||||||
|
```text
|
||||||
|
A i18n/translation/DetectedLanguage.kt
|
||||||
|
A i18n/translation/LanguageDetectionProvider.kt
|
||||||
|
A i18n/translation/LanguageProviderProperties.kt
|
||||||
|
A i18n/translation/PapagoLanguageDetectionProvider.kt
|
||||||
|
A i18n/translation/ProviderTranslationResult.kt
|
||||||
|
A i18n/translation/TranslationCoordinator.kt
|
||||||
|
A i18n/translation/TranslationLanguages.kt
|
||||||
|
M content/LanguageDetectEvent.kt
|
||||||
|
M content/LanguageDetectionCacheService.kt
|
||||||
|
M i18n/translation/PapagoTranslationService.kt
|
||||||
|
M i18n/translation/ResourceTranslationJobScheduler.kt
|
||||||
|
M i18n/translation/TranslationJobScheduler.kt
|
||||||
|
M i18n/translation/TranslationJobWorker.kt
|
||||||
|
M i18n/translation/TranslationReadModelMaterializer.kt
|
||||||
|
M v2/creator/channel/community/translation/application/CreatorCommunityTranslationService.kt
|
||||||
|
```
|
||||||
|
|
||||||
|
테스트 Kotlin 경로 prefix: `src/test/kotlin/kr/co/vividnext/sodalive/`.
|
||||||
|
|
||||||
|
```text
|
||||||
|
A i18n/translation/LanguageDetectionProviderTest.kt
|
||||||
|
A i18n/translation/LanguageProviderCacheEndToEndTest.kt
|
||||||
|
A i18n/translation/LanguageProviderPropertiesTest.kt
|
||||||
|
A i18n/translation/LanguageProviderSpringConfigurationTest.kt
|
||||||
|
A i18n/translation/PapagoLanguageDetectionProviderTest.kt
|
||||||
|
A i18n/translation/TranslationCoordinatorTest.kt
|
||||||
|
M content/CreatorCommunityLanguageDetectTest.kt
|
||||||
|
M content/CreatorCommunityLanguageDetectionCacheConcurrencyTest.kt
|
||||||
|
M content/LanguageDetectionCacheServiceTest.kt
|
||||||
|
M i18n/translation/TranslationJobWorkerTest.kt
|
||||||
|
M v2/creator/channel/community/translation/CreatorCommunityTranslationServiceTest.kt
|
||||||
|
```
|
||||||
|
|
||||||
|
나머지 3개: `src/main/resources/application.yml` 수정,
|
||||||
|
`docs/20261109_감지번역공급자공통화/plan-task.md` 갱신,
|
||||||
|
`docs/20261109_감지번역공급자공통화/provider-guide.md` 추가. 합계 29개다.
|
||||||
|
부모가 만든 `prd.md`는 읽기만 했으며 이 구현자는 변경하지 않았다.
|
||||||
|
`CreatorCommunityTranslationEndToEndTest.kt`는 기존 생성자 영향이 없어 변경하지 않고 4건을 그대로 실행했다.
|
||||||
|
의존성·DDL·AWS 코드·git index/commit/branch/worktree는 변경하지 않았다.
|
||||||
|
|
||||||
|
### 소유 임시 자원 정리 영수증
|
||||||
|
|
||||||
|
- 삭제 대상: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/language-providers.06uAbV/implementation.F9mSBa`.
|
||||||
|
- 모든 Gradle 명령이 종료된 뒤 `lsof -nP +D "$TMPDIR"`에서 열린 파일이 없음을 확인했다 (출력 없음, exit 1).
|
||||||
|
process 목록에서도 이 child를 사용하는 Gradle/test/compiler 프로세스가 없었다. 다른 프로젝트의 daemon은 종료하지 않았다.
|
||||||
|
- 정확한 child 경로를 `test`로 대조한 후 해당 child만 `rm -rf -- "$TMPDIR"`로 삭제했다.
|
||||||
|
이어진 `test ! -e "$TMPDIR"`와 parent `ls -ld`가 exit 0이었다 (2026-11-09 15:22 KST).
|
||||||
|
- child의 일회성 로그/임시 파일만 제거했다. parent, 부모 QA 소유 형제 경로, 공유 Gradle/Kotlin cache는 유지했다.
|
||||||
|
이 문서의 명령/횟수/실패 원인/최종 결과는 로그 삭제 전에 기록했다.
|
||||||
|
|
||||||
|
### P1-GATE 부모 독립 실행 검증
|
||||||
|
|
||||||
|
- 부모가 최종 production/test diff, 신규 interface/coordinator/config 및 fixture 변환을 직접 읽었다.
|
||||||
|
기존 concurrency/revision assertion은 삭제·완화되지 않았다.
|
||||||
|
- fresh 명령: 아래 실행에서 `:test`가 실제 재실행됐고 exit 0, `BUILD SUCCESSFUL in 2m`이었다.
|
||||||
|
ktlintCheck/bootJar는 직전 성공 산출물과 일치하여 UP-TO-DATE였다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --rerun \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
|
||||||
|
ktlintCheck bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
- 부모가 XML 15개를 직접 확인했다. 총 85건, failures/errors/skipped 모두 0.
|
||||||
|
- 별도 임시 Java `ProviderQa`를 Java 17로 컴파일하고 실제 Spring AnnotationConfigApplicationContext에서 실행했다.
|
||||||
|
실제 공통 설정·coordinator와 테스트 전용 `papago`/`aws` adapter, 메모리 repository 대역을 사용했다.
|
||||||
|
이 driver는 DB 검증이 아니며 DB 저장/재조회는 위 H2 테스트가 담당한다.
|
||||||
|
|
||||||
|
| 부모 runtime QA | 관측 결과 |
|
||||||
|
|---|---|
|
||||||
|
| 감지 aws,papago / 번역 papago,aws | 감지 aws, 번역 papago만 호출 |
|
||||||
|
| 감지 papago,aws / 번역 aws,papago | 감지 papago, 번역 aws만 호출 |
|
||||||
|
| 파파고 예외 후 보조 성공 | detect:papago → detect:aws, translate:papago → translate:aws; 성공 provider는 aws |
|
||||||
|
| 보조 cache 재사용 | 감지·번역 provider 호출 0회 |
|
||||||
|
| 모든 provider 실패 | 감지 null, 번역 cause 없는 고정 실패 메시지 |
|
||||||
|
| unknown/duplicate/empty 설정 | 실제 Spring context 초기화 실패 |
|
||||||
|
|
||||||
|
- driver 출력: `QA PASS: independent Spring-configured provider chains; all contexts closed; no external requests` (exit 0).
|
||||||
|
- 별도 `PapagoDetectionQa`에서 실제 추출된 Papago adapter와 RestTemplate을 loopback HTTP 서버에 연결했다.
|
||||||
|
test-only interceptor로 목적지를 127.0.0.1로 바꿨으며 운영 endpoint/설정은 변경하지 않았다.
|
||||||
|
원문 공백·한글·&의 form 직렬화, POST, 가짜 인증 헤더, 성공 언어 반환, blank 결과 null,
|
||||||
|
HTTP 500 전파의 3개 응답 시나리오를 검증했다.
|
||||||
|
출력: `QA PASS: 3 loopback HTTP scenarios; server stopped; no paid API requests` (exit 0).
|
||||||
|
- 모든 Spring context와 loopback 서버는 finally/try-with-resources에서 종료됐다.
|
||||||
|
부모 driver·추출 라이브러리·로그는 최종 정리에서 소유 RUN_TMP만 제거한다.
|
||||||
|
- `git diff --check` exit 0. LSP·전체 테스트·실제 유료 API·운영 MySQL 미검증 범위는 기존 기록과 같다.
|
||||||
|
- 독립 최종 reviewer 판정: **APPROVE**, 확정 발견 사항 없음. 미추적 파일을 포함한 전체 변경과
|
||||||
|
XML 15개(85건 통과)를 직접 대조했다. [리뷰 보고서](reviews/phase-1-review.md).
|
||||||
|
- 원자적 커밋은 (1) 공통 계약·순서 설정·raw 감지/coordinator와 해당 unit/HTTP 테스트,
|
||||||
|
(2) 기존 감지/worker/materializer 연결과 fixture·통합 테스트, (3) 요구사항·계획·가이드·리뷰 문서로 나눈다.
|
||||||
|
첫 단위는 기존 호출자와 독립적으로 컴파일 가능하며, 두 번째 단위는 생성자/fixture 변경을 함께 보존한다.
|
||||||
|
- 코드 커밋: `320adb03` (공통 계약·설정·기반 테스트), `f7fadf7a` (기존 흐름 연결·캐시·통합 테스트).
|
||||||
|
두 커밋의 변경 Kotlin pre-commit ktlint와 메시지 규칙 사전/사후 검사 모두 통과했다.
|
||||||
|
코드 커밋 후 production/test 미커밋 diff가 없고 문서 디렉터리만 남음을 확인했다. push하지 않는다.
|
||||||
|
- 부모 소유 리소스 정리: 모든 driver/context/server/Gradle 실행이 종료됐고 `lsof -nP +D "$RUN_TMP"` 출력이 없었다.
|
||||||
|
사전 생성·내용 확인한 `language-providers.06uAbV`만 삭제하고 `test ! -e` exit 0을 확인했다.
|
||||||
|
출력: `CLEANUP PASS: owned language-providers.06uAbV removed; shared caches untouched`.
|
||||||
|
임시 Java/class/추출 라이브러리/로그가 함께 제거됐으며 필요한 증거는 이 문서에 보존했다.
|
||||||
|
작업 임시 노트도 문서에 이관 후 삭제한다. 다른 작업의 파일·프로세스·캐시에는 조치하지 않았다.
|
||||||
|
|
||||||
|
### Phase 2: 코드 목록으로 공급자 순서 지정
|
||||||
|
|
||||||
|
- [x] **Task 2.1: 우선순위 환경 설정 제거 (P2-T1)**
|
||||||
|
|
||||||
|
**Objective:** LP-011/012에 따라 코드의 독립 목록만 production 순서를 결정한다.
|
||||||
|
**시작 조건:** 사용자의 상수 목록 방식 승인, 기존 Phase 1 완료.
|
||||||
|
**완료 증거:** 과거 property/env 무시 회귀 RED/GREEN, typed-list 순서/검증, Spring/H2 wiring 회귀.
|
||||||
|
**범위 밖:** 공급자 선택/캐시 로직 변경, 인증 키 환경변수 제거, AWS 구현, 전역 mutable 테스트 설정.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Add: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt`.
|
||||||
|
- Modify: 같은 패키지 `LanguageProviderProperties.kt`, `src/main/resources/application.yml`의 우선순위 항목만.
|
||||||
|
- Update tests: `LanguageProviderPropertiesTest.kt`, `LanguageProviderSpringConfigurationTest.kt`,
|
||||||
|
`LanguageProviderCacheEndToEndTest.kt`, `LanguageDetectionProviderTest.kt`, `TranslationCoordinatorTest.kt`.
|
||||||
|
- Update docs: 이 PRD/plan과 `provider-guide.md`. 이전 완료 이력·리뷰는 삭제하지 않는다.
|
||||||
|
|
||||||
|
**계약:** `LanguageProviderOrder` object에 두 `val` 목록. `LanguageProviderProperties`의 주 생성자는
|
||||||
|
두 `List<String>`을 받고 `@Autowired`가 붙은 noarg 보조 생성자가 production object 목록으로 위임한다.
|
||||||
|
기존 `orderedProviders` 검증은 그대로 유지한다. 기본 생성자를 사용하는 호출자와 coordinator는 변경하지 않는다.
|
||||||
|
|
||||||
|
- [x] **RED:** 실제 Spring 기본 생성에서 과거 priority property/env override를 무시해야 한다는 테스트를 추가하고 기존 binding 동작으로 실패함을 확인한다.
|
||||||
|
- [x] **GREEN:** 코드 목록·typed 생성자·Spring 기본 생성자를 적용하고 우선순위 YAML/env 연결을 삭제한다.
|
||||||
|
- [x] **GREEN 확인:** default/legacy override 무시/테스트별 독립 순서/잘못된 목록·공급자 등록 검증이 통과한다.
|
||||||
|
- [x] **REFACTOR:** 실제 H2 fallback 캐시 테스트를 property override 대신 테스트 bean으로 연결하고 기존 assertion을 유지한다.
|
||||||
|
|
||||||
|
**명령:**
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' --tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest'
|
||||||
|
./gradlew --no-daemon --offline ktlintCheck bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
- [x] **Phase 2 Gate (P2-GATE): 코드 순서 실행·리뷰·정리**
|
||||||
|
|
||||||
|
**Objective:** production bean이 코드 목록으로 동작하고 환경값으로 순서가 바뀌지 않음을 직접 실행 검증한다.
|
||||||
|
**시작 조건:** P2-T1 통과.
|
||||||
|
**대체 검증:** 부모 Spring driver에 충돌 property/env를 넣고 코드 목록 유지, 테스트 bean으로 목록 교체·validation을 확인한다.
|
||||||
|
**완료 증거:** focused 통과, build/lint, 독립 scoped 리뷰 승인, 소유 임시 경로 정리.
|
||||||
|
**범위 밖:** 전체 테스트·유료 API·운영 환경 조작. 전체 테스트는 사용자 `./gradlew test`.
|
||||||
|
|
||||||
|
Phase 2 실행 증거는 아래에 누적한다. 코드 변경 전 현재 git status는 깨끗했다.
|
||||||
|
|
||||||
|
### P2-T1 실행 증거 (2026-11-09)
|
||||||
|
|
||||||
|
승인된 Phase 2 계약과 기존 Phase 1 결과를 재사용했다. baseline 85건을 변경 전에 다시 실행하지 않고
|
||||||
|
실제 Spring의 과거 override 무시 회귀부터 작성했다. PRD의 승인 정정과 Phase 1 이력·리뷰는 수정하지 않았다.
|
||||||
|
|
||||||
|
**실행 환경:** parent 존재를 `ls -ld`로 확인하고 아래 명령으로 이 구현자만 소유하는 child를 생성했다.
|
||||||
|
이후 모든 shell 명령에서 아래 세 환경변수를 이 child로 지정했다. Gradle tool timeout은 모두 `600000ms`다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mktemp -d /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/provider-order-code.RRCyJ1/phase2.XXXXXX
|
||||||
|
export TMPDIR=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/provider-order-code.RRCyJ1/phase2.QPrb3i
|
||||||
|
export NODE_COMPILE_CACHE="$TMPDIR" BUN_RUNTIME_TRANSPILER_CACHE_PATH="$TMPDIR"
|
||||||
|
```
|
||||||
|
|
||||||
|
**RED (2건, 2실패, errors/skipped 0, exit 1, 20초):** production 코드를 바꾸기 전에 다음 명령을 실행했다.
|
||||||
|
두 테스트 모두 context는 정상 시작했지만 기대 `[papago]`, 실제 `[secondary, papago]`로 assertion 실패했다.
|
||||||
|
property 직접 지정과 `SystemEnvironmentPropertySource`의 과거 환경변수 → property placeholder 연결을 각각 검증했다.
|
||||||
|
환경변수 테스트는 실제 property가 `secondary,papago`로 해석됐다는 assertion도 통과한 뒤 실패했다.
|
||||||
|
컴파일·unresolved symbol·context 오류를 행동 RED로 계산하지 않았다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest.shouldIgnoreLegacy*Overrides'
|
||||||
|
```
|
||||||
|
|
||||||
|
**GREEN:** 하나의 구현 변경으로 코드 목록·생성자·다섯 테스트의 typed-list fixture·현재 가이드를 전환했다.
|
||||||
|
`LanguageProviderOrder`에는 독립 `val` 두 개만 있으며 각각 `listOf("papago")`다. 전역 mutable 상태는 추가하지 않았다.
|
||||||
|
`LanguageProviderProperties`의 `orderedProviders`는 그대로다. production 기본/negative 테스트는
|
||||||
|
`withUserConfiguration(LanguageProviderProperties::class.java)`로 실제 component를 Spring이 생성하게 한다.
|
||||||
|
독립 순서·잘못된 목록은 테스트 bean으로 주입하고 H2는 테스트 `@Bean`으로 두 목록을 주입한다.
|
||||||
|
기존 캐시·폴백·귀속·materializer·동시성·revision assertion은 삭제하거나 완화하지 않았다.
|
||||||
|
|
||||||
|
**결합 focused 회귀 + lint/산출물 (exit 0, 3분 14초):** 아래 명령 한 번으로 모두 실행했다.
|
||||||
|
`:test`, `:ktlintCheck`, `:bootJar`의 실제 실행과 `BUILD SUCCESSFUL`을 확인했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
|
||||||
|
ktlintCheck bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
| XML로 확인한 범위 | 결과 |
|
||||||
|
|---|---|
|
||||||
|
| 번역 package + 감지 cache | 54/54 |
|
||||||
|
| 커뮤니티 감지 + cache 경합 | 14/14 (12 + 2) |
|
||||||
|
| 커뮤니티 번역 service + 기존 end-to-end | 20/20 (16 + 4) |
|
||||||
|
| 합계 | 15개 XML, 88/88, failures/errors/skipped 모두 0 |
|
||||||
|
|
||||||
|
새 override 무시 회귀 2/2가 GREEN이며 Spring 클래스 전체는 5/5다.
|
||||||
|
85건 대비 증가는 회귀 2건과 기존 default/invalid 검증을 서로 다른 테스트로 분리한 1건이다.
|
||||||
|
기존 Papago chunk 17건과 H2 secondary 귀속·재사용 2건도 통과했다.
|
||||||
|
변경하지 않은 테스트의 Kotlin 경고 7개(불필요한 `!!` 4개, unchecked cast 3개)와 Gradle 9 deprecation 경고는 남아 있다.
|
||||||
|
|
||||||
|
**부모 QA용 실제 생성자:** 아래 `javap` 명령은 exit 0이었다. 문자열 생성자와 setter는 없다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
javap -classpath build/classes/kotlin/main kr.co.vividnext.sodalive.i18n.translation.LanguageProviderProperties kr.co.vividnext.sodalive.i18n.translation.LanguageProviderOrder
|
||||||
|
```
|
||||||
|
|
||||||
|
```text
|
||||||
|
LanguageProviderProperties(java.util.List<java.lang.String>, java.util.List<java.lang.String>)
|
||||||
|
LanguageProviderProperties() // @Autowired, LanguageProviderOrder의 두 목록으로 위임
|
||||||
|
getDetectionOrder(): List<String>
|
||||||
|
getTranslationOrder(): List<String>
|
||||||
|
LanguageProviderOrder.INSTANCE.getDetectionOrder(): List<String>
|
||||||
|
LanguageProviderOrder.INSTANCE.getTranslationOrder(): List<String>
|
||||||
|
```
|
||||||
|
|
||||||
|
**이 구현자의 변경 파일:** production은 `i18n/translation/LanguageProviderOrder.kt` 추가,
|
||||||
|
`LanguageProviderProperties.kt` 수정과 `application.yml` 우선순위 블록 5줄 삭제뿐이다.
|
||||||
|
테스트는 같은 패키지의 `LanguageProviderPropertiesTest.kt`, `LanguageProviderSpringConfigurationTest.kt`,
|
||||||
|
`LanguageProviderCacheEndToEndTest.kt`, `LanguageDetectionProviderTest.kt`, `TranslationCoordinatorTest.kt`만 수정했다.
|
||||||
|
문서는 `provider-guide.md`와 이 `plan-task.md`를 갱신했다. 합계 10개다.
|
||||||
|
기본 생성자 기존 호출자·인증 환경변수·기타 설정·AWS/SDK·DB/schema·domain·캐시·폴백 코드는 변경하지 않았다.
|
||||||
|
|
||||||
|
**한계/소유권:** LSP/diagnostics 도구가 제공되지 않아 Kotlin 컴파일과 ktlint로 보완했다.
|
||||||
|
H2의 기존 claim SQL test spy 한계는 유지된다. 실제 API·운영 DB·전체 테스트는 실행하지 않았다.
|
||||||
|
전체 테스트는 사용자 명령 `./gradlew test`이며 무필터 test/check/build는 실행하지 않았다.
|
||||||
|
별도 수동 Spring driver와 ONE reviewer 및 P2-GATE 완료 판정은 부모가 맡는다.
|
||||||
|
commit/staging/push/worktree/하위 에이전트 작업은 하지 않았다.
|
||||||
|
|
||||||
|
**소유 임시 자원 정리 영수증 (2026-11-09 18:13:46 KST):** 모든 Gradle/test 실행이 종료된 뒤
|
||||||
|
`lsof -nP +D "$TMPDIR"` 출력이 없고 Java process 목록에 이 child를 사용하는 프로세스가 없음을 확인했다.
|
||||||
|
정확한 child 경로와 존재를 `test`로 대조한 뒤 이 구현자 소유 `phase2.QPrb3i`만 `rm -rf -- "$TMPDIR"`로 삭제했다.
|
||||||
|
`test ! -e "$TMPDIR"`와 parent `ls -ld`가 포함된 정리 명령은 exit 0이었다.
|
||||||
|
parent `provider-order-code.RRCyJ1`, 부모 QA의 형제 경로, 기존 공유 daemon/cache는 건드리지 않았다.
|
||||||
|
마지막 `git diff --check`는 exit 0이었다. P2-T1만 완료 처리하고 P2-GATE는 부모 검증을 위해 미완료로 남겼다.
|
||||||
|
|
||||||
|
### P2-GATE 부모 검증
|
||||||
|
|
||||||
|
- 부모가 최종 production/test/guide diff와 신규 `LanguageProviderOrder.kt`를 직접 읽었다.
|
||||||
|
구현자 결과 XML 15개를 대조해 88건, failures/errors/skipped 0을 확인했다.
|
||||||
|
- 별도 Java 17 `CodeOrderQa`로 실제 Spring component를 생성했다. 충돌하는 과거 Spring property와
|
||||||
|
`SystemEnvironmentPropertySource`를 주입해도 두 기본 순서는 코드의 `papago` 목록을 유지했다.
|
||||||
|
typed-list 생성자로 감지 B/A/C, 번역 C/B/A를 독립 지정했고 빈 목록·빈 이름·중복·미등록 순서 및
|
||||||
|
중복 공급자 이름 거부를 확인했다. 전역 목록은 변경하지 않았다.
|
||||||
|
출력: `QA PASS: production code defaults, ignored legacy configuration, independent lists and validation; context closed`.
|
||||||
|
driver exit 0, Spring context 종료, 외부 API 요청 없음.
|
||||||
|
- 부모 fresh 명령:
|
||||||
|
`./gradlew --no-daemon --offline test --rerun --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' ktlintCheck bootJar`
|
||||||
|
→ exit 0, `BUILD SUCCESSFUL in 36s`, `:test` 실제 실행. lint/build는 검증된 현재 산출물과 일치해 UP-TO-DATE였다.
|
||||||
|
- 이후 사용자가 enum의 적합성을 물어 검토 의견만 제공했다. enum 변경은 별도 구현 승인 전이므로 Phase 2에 포함하지 않는다.
|
||||||
|
- 부모 fresh XML 11개 합계 54건, failures/errors/skipped 0을 확인했다.
|
||||||
|
- [독립 Phase 2 리뷰](reviews/phase-2-review.md): **APPROVE**, 차단/수정 요구 사항 없음.
|
||||||
|
이전 Phase 1 리뷰는 그대로 보존한다. 코드·테스트와 문서는 각각 원자적으로 커밋한다.
|
||||||
|
- 코드·테스트 커밋: `9136b0e3`. pre-commit ktlint와 커밋 메시지 사전/사후 검증을 통과했다.
|
||||||
|
- 부모 리소스 정리: `lsof -nP +D` 출력 없음으로 열린 파일이 없음을 확인하고, 소유 root
|
||||||
|
`provider-order-code.RRCyJ1`(driver/class/라이브러리/로그)만 제거했다. `test ! -e` exit 0.
|
||||||
|
출력: `CLEANUP PASS: owned provider-order-code.RRCyJ1 removed; shared caches untouched`.
|
||||||
|
필요한 증거는 이 문서에 이관했으며 임시 노트도 삭제한다. 다른 작업의 리소스는 건드리지 않았다.
|
||||||
|
|
||||||
|
### Phase 3: 공급자 enum과 DB code 경계
|
||||||
|
|
||||||
|
- [x] **Task 3.1: 식별자 enum 전환 (P3-T1)**
|
||||||
|
|
||||||
|
**Objective:** LP-013~015에 따라 코드 내부 공급자 식별은 enum, 저장 값은 기존 안정 문자열로 유지한다.
|
||||||
|
**시작 조건:** 사용자 enum 구현 승인, Phase 2 완료, 변경 전 focused baseline 88건 확인.
|
||||||
|
**완료 증거:** enum 타입 계약 RED/GREEN, 기존 papago 데이터 재사용 및 code 저장 호환, focused 회귀·lint·bootJar.
|
||||||
|
**범위 밖:** AWS 실제 adapter/SDK, DDL/entity/repository 타입 변경, 공급자 정책·캐시 정책·언어 정책·분할·인증 변경.
|
||||||
|
|
||||||
|
**Files (src/main/kotlin/kr/co/vividnext/sodalive/ 기준):**
|
||||||
|
- Add: `i18n/translation/LanguageProviderId.kt`.
|
||||||
|
- Modify: 같은 패키지 `LanguageProviderOrder.kt`, `LanguageProviderProperties.kt`, `TranslationProvider.kt`,
|
||||||
|
`LanguageDetectionProvider.kt`, `DetectedLanguage.kt`, `ProviderTranslationResult.kt`, 두 Papago adapter,
|
||||||
|
`TranslationCoordinator.kt`, `TranslationJobWorker.kt`; `content/LanguageDetectionCacheService.kt`.
|
||||||
|
- Update: 직접 영향 테스트의 fake provider/순서/결과 타입. DB 문자열 기대값은 유지한다.
|
||||||
|
- Update: 현재 `provider-guide.md`와 이 PRD/plan. 이전 완료 증거/리뷰는 보존한다.
|
||||||
|
|
||||||
|
**계약:** PRD Phase 3 그대로 적용한다. `orderedProviders`는 enum 목록과 `(T) -> LanguageProviderId`로
|
||||||
|
선택한다. 존재하지 않는 문자열/blank ID 테스트는 정적 타입으로 대체되며 AWS ID에 해당 구현체가 없으면 거부한다.
|
||||||
|
테스트 first/second/secondary 공급자는 PAPAGO/AWS로 옮기고, 번역 본문 fixture의 같은 문자열은 바꾸지 않는다.
|
||||||
|
|
||||||
|
- [x] **RED:** 컴파일 가능한 기존 인터페이스/결과에 대한 runtime getter 반환 타입 assertion으로 새 enum 식별 계약의 실패를 재현한다. missing symbol 컴파일 오류를 RED로 보고하지 않는다.
|
||||||
|
- [x] **GREEN:** enum·providerId·typed 순서 및 DB 경계 `.code` 변환을 한 단위로 구현한다.
|
||||||
|
- [x] **GREEN 확인:** enum code 고정값, 원래 papago 캐시 재사용, 실제 DB의 papago/aws 문자열 저장·조회, 결과 enum 귀속이 통과한다.
|
||||||
|
- [x] **REFACTOR:** 관련 fixture만 정리하고 빈 목록/중복/미등록 AWS 검증·감지/번역 순서·실패 전환·경합·분할 회귀를 실행한다.
|
||||||
|
|
||||||
|
**검증 명령:** Phase 2의 결합 focused 명령(번역 package·감지 cache·커뮤니티 감지/경합·번역 service·end-to-end)을
|
||||||
|
그대로 실행하며 새 enum 테스트도 번역 package 필터에 포함한다. `--no-daemon --offline`, timeout600000 사용.
|
||||||
|
`ktlintCheck bootJar`를 함께 검증한다. 전체 테스트는 사용자 실행 `./gradlew test`로 남긴다.
|
||||||
|
|
||||||
|
- [x] **Phase 3 Gate (P3-GATE): typed 실행·저장 호환·리뷰**
|
||||||
|
|
||||||
|
**Objective:** production 목록/구현체/결과가 enum이며 DB 값은 lowercase code임을 독립 검증한다.
|
||||||
|
**시작 조건:** P3-T1 통과.
|
||||||
|
**완료 증거:** 부모 Java/Spring enum driver, H2 DB 호환 테스트 대조, 한 명의 독립 리뷰 승인, 소유 리소스 정리.
|
||||||
|
**TDD 예외:** 독립 실행 확인·리뷰이며 새 구현을 추가하지 않는다.
|
||||||
|
**범위 밖:** 실제 유료 API·운영 MySQL·전체 테스트. LSP 미제공은 컴파일/lint 보완과 함께 명시한다.
|
||||||
|
|
||||||
|
### P3 초기 증거
|
||||||
|
|
||||||
|
- 변경 전 깨끗한 작업 트리를 확인했고 Phase 2 결합 focused baseline은 exit 0, `BUILD SUCCESSFUL in 45s`였다.
|
||||||
|
- SQL/entity의 provider String과 기존 code 값을 유지하는 계약을 확정했다. enum은 실제 AWS 연동을 의미하지 않는다.
|
||||||
|
|
||||||
|
### P3-T1 실행 증거 (2026-11-09)
|
||||||
|
|
||||||
|
부모가 직전에 확인한 baseline 88건(45초)을 재실행하지 않았다. 승인된 최종 Phase 3 계약으로 기존 작업을 이어갔다.
|
||||||
|
PRD는 수정하지 않았으며 Phase 1·2 실행 이력과 기존 리뷰도 보존했다. P3-T1만 완료하고 P3-GATE는 부모가 판정한다.
|
||||||
|
|
||||||
|
**실행 환경:** parent를 read 및 `ls -ld`로 확인하고 `mktemp -d "$TMPDIR/phase3.XXXXXX"`로
|
||||||
|
이 구현자만 소유하는 child를 생성했다. 생성 후 모든 shell 명령에서 아래 세 환경변수를 지정했다.
|
||||||
|
모든 Gradle 실행은 `--no-daemon --offline`, tool timeout `600000ms`다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export TMPDIR=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/provider-id-enum.jLt5Ki/phase3.eX59R8
|
||||||
|
export NODE_COMPILE_CACHE="$TMPDIR" BUN_RUNTIME_TRANSPILER_CACHE_PATH="$TMPDIR"
|
||||||
|
```
|
||||||
|
|
||||||
|
**RED (1건, failures 1, errors/skipped 0, exit 1, 19초):** production 변경 전에 `LanguageProviderIdTest`를 추가했다.
|
||||||
|
reflection의 `"getProviderId"`와 반환 타입의 전체 이름 문자열을 사용하므로 구 코드에서도 정상 컴파일된다.
|
||||||
|
JUnit `assertAll`에서 두 raw interface 및 두 성공 결과의 getter가 모두 없어 expected enum type / actual null인
|
||||||
|
`AssertionFailedError` 4개가 발생했다. missing symbol·컴파일 오류·예외 기반 실패가 아닌 런타임 assertion RED다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderIdTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
**GREEN:** enum·인터페이스·adapter·결과·순서·매칭·직접 영향 fixture를 한 단위로 전환한 뒤 결합 회귀를 한 번 실행했다.
|
||||||
|
`PAPAGO("papago")`, `AWS("aws")`만 정의했고 production 기본 목록은 두 기능 모두 PAPAGO 하나다.
|
||||||
|
`providerVersion`은 String 그대로이며 `providerName` alias/호환 wrapper와 test-only enum은 없다.
|
||||||
|
`.code` 사용은 cache 조회/insert/locking read 3곳, coordinator 조회 1곳, worker 조회/저장 2곳의 DB 경계뿐이다.
|
||||||
|
production 식별자 리터럴 `"papago"`는 enum 선언 한 곳에만 남았다. HTTP URL·인증 key·과거 env 무시 문자열은 유지했다.
|
||||||
|
|
||||||
|
**보존/저장 검증:** 아래 assertion들은 기대값을 enum에서 계산하지 않는다.
|
||||||
|
|
||||||
|
- 기존 Papago 감지 cache hit는 `"papago"` fixture를 재사용하고 외부 호출 0회를 검증한다.
|
||||||
|
기존 H2 최초 감지 경합 2건은 저장값 `"papago"`, 승자 반환, target·job 수와 revision을 그대로 검증한다.
|
||||||
|
- H2 가짜 보조 공급자는 AWS enum이다. 감지/번역을 별도 트랜잭션에서 `"aws"`로 재조회하고 실제 provider를 확인한다.
|
||||||
|
번역 memory의 실제 version은 `"AWS-v1"`, 본문과 materializer 표시값은 `"AWS:0"`이며 재사용 후 호출 수는 각각 1회다.
|
||||||
|
이는 테스트 adapter가 만드는 version/본문 fixture이고 DB provider code `"aws"`와 별도다.
|
||||||
|
- 독립 감지/번역 순서·첫 성공 중단·전체 요청 폴백·개수 불일치/blank·전체 실패·DB 오류 전파 assertion을 유지했다.
|
||||||
|
기존 Papago HTTP/chunk 17건의 `first`/`second` 본문 fixture는 변경하지 않았다.
|
||||||
|
- 빈 문자열 ID만 enum으로 표현할 수 없어 제거했다. 빈 목록·중복 순서·미선택 구현체의 중복 ID 검증은 유지했다.
|
||||||
|
기존 unknown 문자열 사례는 AWS enum 순서와 해당 구현체 부재로 바꾸고, 실제 Spring에서 감지/번역 각각 시작 실패를 확인했다.
|
||||||
|
|
||||||
|
**최종 결합 focused + lint/산출물 (exit 0, 2분 45초):** `:test`, `:ktlintCheck`, `:bootJar`가 모두 실제 실행됐다.
|
||||||
|
`BUILD SUCCESSFUL`을 확인했으며 XML 16개를 직접 집계했다. 불필요한 baseline/중간 전체 컴파일 반복은 하지 않았다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --offline test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
|
||||||
|
ktlintCheck bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
| XML로 확인한 범위 | 결과 |
|
||||||
|
|---|---|
|
||||||
|
| 번역 package + 감지 cache | 57/57 |
|
||||||
|
| 커뮤니티 감지 + cache 경합 | 14/14 (12 + 2) |
|
||||||
|
| 커뮤니티 번역 service + 기존 end-to-end | 20/20 (16 + 4) |
|
||||||
|
| 합계 | 91/91, failures/errors/skipped 모두 0 |
|
||||||
|
|
||||||
|
신규 enum 테스트 3건(런타임 타입·code·production 기본값/실제 adapter ID)이 baseline 대비 증가분이다.
|
||||||
|
기존 unrelated Kotlin 경고 7개(불필요한 `!!` 4, unchecked cast 3)와 Gradle 9 deprecation 경고는 남아 있다.
|
||||||
|
제공된 LSP/diagnostics 도구는 없으며 Kotlin 컴파일·ktlint로 보완했다. 성공한 LSP 진단으로 보고하지 않는다.
|
||||||
|
|
||||||
|
### Phase 3 부모 Java QA용 실제 생성자/Getter
|
||||||
|
|
||||||
|
`javap -classpath build/classes/kotlin/main`으로 다음 바인딩을 확인했다(exit 0).
|
||||||
|
패키지는 content service를 제외하면 `kr.co.vividnext.sodalive.i18n.translation`이다.
|
||||||
|
Java enum 자체가 자동 생성하는 `valueOf`는 존재하지만 production의 역변환이나 저장에 사용하지 않는다.
|
||||||
|
|
||||||
|
```text
|
||||||
|
LanguageProviderId.PAPAGO / AWS; getCode(): String
|
||||||
|
LanguageProviderProperties(List<? extends LanguageProviderId>, List<? extends LanguageProviderId>)
|
||||||
|
LanguageProviderProperties() // @Autowired, production object 목록으로 위임
|
||||||
|
getDetectionOrder(): List<LanguageProviderId>; getTranslationOrder(): List<LanguageProviderId>
|
||||||
|
LanguageProviderOrder.INSTANCE.getDetectionOrder/getTranslationOrder(): List<LanguageProviderId>
|
||||||
|
orderedProviders(List<? extends LanguageProviderId>, List<? extends T>, Function1<? super T, ? extends LanguageProviderId>)
|
||||||
|
LanguageDetectionProvider.getProviderId(): LanguageProviderId; detect(String): String?
|
||||||
|
TranslationProvider.getProviderId(): LanguageProviderId; getProviderVersion(): String
|
||||||
|
DetectedLanguage(String detectedLanguage, LanguageProviderId providerId); getProviderId(): LanguageProviderId
|
||||||
|
ProviderTranslationResult(TranslateResult result, LanguageProviderId providerId, String providerVersion)
|
||||||
|
ProviderTranslationResult.getProviderId(): LanguageProviderId; getProviderVersion(): String
|
||||||
|
PapagoLanguageDetectionProvider(String clientId, String clientSecret); getProviderId(): LanguageProviderId
|
||||||
|
PapagoTranslationService(String clientId, String clientSecret); getProviderId(): LanguageProviderId
|
||||||
|
TranslationCoordinator(List<? extends TranslationProvider>, LanguageProviderProperties, TranslationMemoryRepository)
|
||||||
|
LanguageDetectionCacheService(LanguageDetectionResultRepository, List<? extends LanguageDetectionProvider>,
|
||||||
|
LanguageProviderProperties)
|
||||||
|
```
|
||||||
|
|
||||||
|
### P3-T1 변경 파일 전체 (23개)
|
||||||
|
|
||||||
|
production prefix: `src/main/kotlin/kr/co/vividnext/sodalive/` (12개).
|
||||||
|
|
||||||
|
```text
|
||||||
|
A i18n/translation/LanguageProviderId.kt
|
||||||
|
M i18n/translation/LanguageProviderOrder.kt
|
||||||
|
M i18n/translation/LanguageProviderProperties.kt
|
||||||
|
M i18n/translation/TranslationProvider.kt
|
||||||
|
M i18n/translation/LanguageDetectionProvider.kt
|
||||||
|
M i18n/translation/DetectedLanguage.kt
|
||||||
|
M i18n/translation/ProviderTranslationResult.kt
|
||||||
|
M i18n/translation/PapagoLanguageDetectionProvider.kt
|
||||||
|
M i18n/translation/PapagoTranslationService.kt
|
||||||
|
M i18n/translation/TranslationCoordinator.kt
|
||||||
|
M i18n/translation/TranslationJobWorker.kt
|
||||||
|
M content/LanguageDetectionCacheService.kt
|
||||||
|
```
|
||||||
|
|
||||||
|
test prefix: `src/test/kotlin/kr/co/vividnext/sodalive/` (9개).
|
||||||
|
|
||||||
|
```text
|
||||||
|
A i18n/translation/LanguageProviderIdTest.kt
|
||||||
|
M i18n/translation/LanguageProviderPropertiesTest.kt
|
||||||
|
M i18n/translation/LanguageProviderSpringConfigurationTest.kt
|
||||||
|
M i18n/translation/LanguageProviderCacheEndToEndTest.kt
|
||||||
|
M i18n/translation/LanguageDetectionProviderTest.kt
|
||||||
|
M i18n/translation/TranslationCoordinatorTest.kt
|
||||||
|
M i18n/translation/TranslationJobWorkerTest.kt
|
||||||
|
M content/LanguageDetectionCacheServiceTest.kt
|
||||||
|
M content/CreatorCommunityLanguageDetectTest.kt
|
||||||
|
```
|
||||||
|
|
||||||
|
문서는 현재 `provider-guide.md`와 이 `plan-task.md`만 변경했다(2개).
|
||||||
|
부모가 사전 갱신한 `prd.md`는 수정하지 않았다. entity/repository/DDL·설정·domain service·실제 AWS/SDK는 변경하지 않았다.
|
||||||
|
`CreatorCommunityLanguageDetectionCacheConcurrencyTest`와 community 번역 service/end-to-end는 수정 없이 회귀 실행했다.
|
||||||
|
|
||||||
|
**한계/부모 경계:** H2의 기존 MySQL claim SQL test spy는 변경하지 않았다. 실제 DB 저장·재조회·표시는 검증했지만
|
||||||
|
운영 MySQL claim 동시성은 새로 증명하지 않는다. 유료 API·운영 DB·전체 테스트는 실행하지 않았다.
|
||||||
|
무필터 test/check/build 대신 요청된 필터와 bootJar만 실행했고 사용자 전체 검증 명령은 `./gradlew test`다.
|
||||||
|
Java/Spring typed driver와 한 명의 독립 reviewer, P3-GATE 판정은 부모가 맡는다.
|
||||||
|
이 구현자는 staging/commit/push/worktree/하위 에이전트 작업을 하지 않았다.
|
||||||
|
|
||||||
|
### P3-T1 소유 임시 자원 정리
|
||||||
|
|
||||||
|
- 정리 대상은 생성 시 확인한 child `provider-id-enum.jLt5Ki/phase3.eX59R8` 하나다.
|
||||||
|
RED/GREEN 로그의 명령·횟수·실패 원인·결과를 이 문서에 이관한 뒤 삭제한다.
|
||||||
|
- Gradle/test 실행 종료 후 `lsof -nP +D "$TMPDIR"` 출력이 없었다. Java process 목록에도 이 child를 사용하는
|
||||||
|
Gradle/test/compiler 프로세스가 없다. 기존 shared Gradle daemon(PID 85602)은 종료하거나 변경하지 않는다.
|
||||||
|
- 정확한 child 경로와 존재를 `test`로 대조한 다음 이 child만 삭제했다. parent와 공유 cache는 유지했다.
|
||||||
|
- 완료 영수증: `2026-11-09 19:02:10 KST`, lsof exit 1(열린 파일 없음), `test ! -e "$TMPDIR"` 및
|
||||||
|
parent `ls -ld` exit 0. 출력은 `CLEANUP PASS: owned phase3.eX59R8 removed; parent and shared caches untouched`다.
|
||||||
|
로그/일회성 임시 파일만 제거했으며 필요한 증거는 위에 보존했다.
|
||||||
|
|
||||||
|
### P3-GATE 부모 독립 검증
|
||||||
|
|
||||||
|
- 부모가 신규 enum/테스트, 모든 production/test diff와 현재 가이드를 직접 대조했다.
|
||||||
|
production의 `"papago"` 식별자 리터럴은 enum 선언 1곳, `.code`는 기존 DB 접점 6곳이다.
|
||||||
|
`providerName` alias와 providerId의 `.name`/`.ordinal`/`valueOf` 사용은 발견되지 않았다.
|
||||||
|
- Phase 3 결합 focused 명령에 `test --rerun`을 적용하고 `ktlintCheck bootJar`를 함께 실행했다.
|
||||||
|
exit 0, `BUILD SUCCESSFUL in 52s`, `:test` 실제 실행, 나머지 현재 컴파일/lint/build 18개 작업은 UP-TO-DATE였다.
|
||||||
|
부모가 fresh XML 16개를 직접 확인: 91건, failures/errors/skipped 0.
|
||||||
|
- 별도 Java 17 `EnumProviderQa`에서 실제 컴파일 클래스와 Spring context를 실행했다.
|
||||||
|
raw interface·결과 4개 runtime getter의 enum 반환 타입, 실제 두 Papago adapter의 ID와 code 고정값,
|
||||||
|
PAPAGO-only 기본값을 확인했다.
|
||||||
|
- 메모리 repository 대역에 기존 `"papago"` 캐시를 미리 넣고 provider 호출 0회로 재사용함을 확인했다.
|
||||||
|
가짜 PAPAGO 실패 → AWS 성공에서 결과는 AWS enum이며 감지 저장/조회 인자는 소문자 `"aws"`였다.
|
||||||
|
모든 repository provider 인자가 `"papago"` 또는 `"aws"`임을 독립 문자열 기대값으로 검사했다.
|
||||||
|
AWS enum만 순서에 있고 해당 구현체가 없으면 Spring 초기화가 실패했다.
|
||||||
|
- driver 출력: `QA PASS: enum runtime and persistence-boundary compatibility; all Spring contexts closed; no API calls`.
|
||||||
|
exit 0이고 모든 context를 종료했다. 이 driver의 repository는 대역이며 실제 DB 저장 증거는 H2 테스트와 구분한다.
|
||||||
|
- 실제 H2 AWS code 저장/재조회·worker/materializer 표시 및 기존 Papago 경합 테스트도 위 fresh 명령에 포함됐다.
|
||||||
|
전체 테스트·운영 MySQL·유료 API·LSP 미검증 범위는 기존대로 유지한다.
|
||||||
|
- 독립 Phase 3 gate 리뷰: **APPROVE**, 확정 발견 사항·차단 이슈 없음.
|
||||||
|
[리뷰 보고서](reviews/phase-3-review.md). XML 16개와 모든 변경을 대조했고 `git diff --check`도 통과했다.
|
||||||
|
- 인터페이스·구현체·결과·호출자·fixture의 타입 변경은 분리하면 컴파일되지 않으므로 코드/테스트를 한 원자적 커밋으로 묶는다.
|
||||||
|
요구사항·가이드·검증·리뷰 기록은 별도 문서 커밋으로 남긴다. push하지 않는다.
|
||||||
|
- 코드·테스트 커밋: `ec890047`. 변경 Kotlin hook ktlint와 메시지 사전/사후 검증이 통과했다.
|
||||||
|
코드 커밋 후 작업 트리에는 이 작업의 문서 변경만 남았음을 확인했다.
|
||||||
|
- 부모 최종 정리: 모든 실행이 끝난 뒤 `lsof -nP +D` 출력이 없었다. 생성·내용 확인한 소유
|
||||||
|
`provider-id-enum.jLt5Ki`만 삭제했고 `test ! -e` exit 0을 확인했다.
|
||||||
|
출력: `CLEANUP PASS: owned provider-id-enum.jLt5Ki removed; shared caches untouched`.
|
||||||
|
driver/class/추출 라이브러리/로그를 제거했으며 필요한 증거는 이 문서에 남겼다.
|
||||||
|
임시 노트도 이관 후 삭제한다. 공유 cache·다른 작업의 프로세스/파일은 변경하지 않았다.
|
||||||
@@ -0,0 +1,118 @@
|
|||||||
|
# 언어 감지·번역 공급자 공통화 PRD
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 작성일 | 2026-11-09 |
|
||||||
|
| 상태 | Phase 1~3 구현·기능 범위 검증·독립 리뷰 완료 |
|
||||||
|
| 승인 범위 | 감지·번역 별도 인터페이스, 공통 공급자 선택·실패 전환, 기능별 순서 설정 |
|
||||||
|
| 계획 | [plan-task.md](plan-task.md) |
|
||||||
|
|
||||||
|
## 목적
|
||||||
|
|
||||||
|
파파고에 결합된 언어 감지·번역 호출을 분리한다. 이후 공급자는 해당 인터페이스 구현체와 빈·인증·순서 설정을
|
||||||
|
추가하면 사용할 수 있어야 하며, 콘텐츠·댓글·커뮤니티 등 도메인 코드에 공급자 분기를 추가하지 않는다.
|
||||||
|
|
||||||
|
## 범위와 제외
|
||||||
|
|
||||||
|
- 현재 실행되는 실제 구현체는 파파고뿐이다. AWS 실제 API·SDK 구현은 다음 작업이며 이번에는 추가하지 않는다.
|
||||||
|
- AWS 구현체가 등록된 뒤 기본 운영 의도는 파파고 → AWS이다. 감지와 번역 순서는 각각 독립 설정으로 바꾼다.
|
||||||
|
- 기본 실행 설정은 존재하는 파파고만 사용한다. 미구현 AWS를 등록한 것처럼 처리하거나 네트워크 호출하지 않는다.
|
||||||
|
- 기존 파파고 5,000 UTF-16 단위 분할, 지원 번역 언어 ko/en/ja, 공개 API, DB 스키마, job 재시도 정책은 유지한다.
|
||||||
|
- 감지 결과 저장 대상별 차이, 커뮤니티 원문 revision 검증, 이벤트 after-commit 처리 및 DB 경합 규칙을 유지한다.
|
||||||
|
- 실행 중 설정 변경, 관리 화면, 임의 플러그인 로딩, 새 번역 품질 정책, 기존 FAILED 작업 재처리는 제외한다.
|
||||||
|
|
||||||
|
## 요구사항
|
||||||
|
|
||||||
|
| ID | 수용 기준 |
|
||||||
|
|---|---|
|
||||||
|
| LP-001 | 감지와 번역은 독립된 공급자 인터페이스이며, 둘 중 하나만 구현한 공급자도 해당 기능에 등록 가능하다. |
|
||||||
|
| LP-002 | 감지·번역의 공급자 순서를 서로 다른 설정으로 지정한다. 테스트 공급자 2개로 한쪽만 순서를 바꿔도 다른 쪽에 영향이 없음을 증명한다. |
|
||||||
|
| LP-003 | 공급자별 예외 또는 유효 결과 없음이면 다음 공급자를 순서대로 한 번 시도한다. 첫 성공 뒤 후속 공급자를 호출하지 않는다. |
|
||||||
|
| LP-004 | 모든 공급자 실패 시 감지는 기존처럼 결과 없음으로 처리하고 번역은 기존 워커 실패·재시도 경로를 따른다. |
|
||||||
|
| LP-005 | 캐시는 실제 성공 공급자 이름으로 저장한다. AWS 역할의 가짜 공급자 성공을 papago 이름으로 저장하지 않는다. |
|
||||||
|
| LP-006 | 설정된 공급자들의 유효 캐시를 우선 재사용한다. 새 외부 호출의 순서는 별도 설정 순서를 따른다. 워커와 결과 조립의 캐시 선택 정책이 같다. |
|
||||||
|
| LP-007 | 빈 원문·동일 언어·서비스 미지원 번역 언어는 불필요한 공급자 전환을 일으키지 않는다. 유효한 미지원 언어 감지 결과는 감지 장애와 구분한다. |
|
||||||
|
| LP-008 | 빈/중복/미등록 구현체의 공급자 순서는 초기화 단계에서 거부한다. 선택 코드에 공급자 분기를 추가하지 않는다. Phase 3부터 새 공급자는 enum 항목을 추가한다. |
|
||||||
|
| LP-009 | 기존 파파고 캐시·번역 데이터 및 분할 번역 동작과 감지 캐시 동시성 승자 반환을 보존한다. |
|
||||||
|
| LP-010 | 추가 방법과 기능별 순서 설정 예시, 실제 AWS 미구현 상태를 문서화한다. |
|
||||||
|
| LP-011 | 공급자 순서는 `LanguageProviderOrder`의 독립 `val List<String>` 두 개로 지정한다. 기본은 각각 `listOf("papago")`이다. |
|
||||||
|
| LP-012 | 우선순위 환경변수·YAML·문자열 파싱을 제거한다. 기존 우선순위 property/env 값이 있어도 production 순서를 바꾸지 않는다. 인증정보 환경변수는 유지한다. |
|
||||||
|
| LP-013 | 순서 목록·감지/번역 인터페이스·구현체·성공 결과·매칭의 식별자는 `LanguageProviderId` enum으로 통일한다. |
|
||||||
|
| LP-014 | DB entity/repository의 provider는 String으로 유지하며 `.code`로만 변환한다. 기존 `"papago"` 데이터·캐시 키·중복 방지 계약을 유지한다. |
|
||||||
|
| LP-015 | enum은 `PAPAGO("papago")`, `AWS("aws")`이며 AWS 실제 구현은 추가하지 않는다. 기본 순서는 둘 다 PAPAGO 하나이고 미구현 AWS 선택은 거부한다. |
|
||||||
|
|
||||||
|
## 보안·오류 처리
|
||||||
|
|
||||||
|
외부 HTTP 응답과 실행 설정이 신뢰 경계다. 부분 번역·빈 응답은 정상 결과로 저장하지 않는다.
|
||||||
|
원문, 인증정보, 공급자 응답 본문이 신규 로그나 워커 오류 문자열에 노출되지 않도록 한다.
|
||||||
|
공급자 식별자·순서 외에 임의 URL을 사용자 요청으로 받지 않는다. 유료 API 테스트는 하지 않는다.
|
||||||
|
|
||||||
|
## 검증 시나리오
|
||||||
|
|
||||||
|
1. 파파고 단독 기본 설정에서 기존 감지·번역·캐시·분할·커뮤니티 동작이 유지된다.
|
||||||
|
2. 두 가짜 공급자로 감지/번역 순서 독립 변경, 첫 성공 중단, 실패 전환·전체 실패를 확인한다.
|
||||||
|
3. 가짜 보조 공급자의 감지/번역 결과가 실제 provider로 DB에 저장되고 다음 요청과 materializer가 재사용한다.
|
||||||
|
4. 잘못된 설정의 초기화 실패, 원문 정책 가드, 캐시 동시성·revision 회귀를 검증한다.
|
||||||
|
|
||||||
|
## 검증 범위
|
||||||
|
|
||||||
|
변경 전 관련 focused 테스트 60건과 추가 end-to-end 4건 통과를 확인했다.
|
||||||
|
구현 후 새 계약 테스트를 포함한 85건 및 부모 런타임·HTTP 검증을 통과했다. 상세 증거는 계획 문서에 기록한다.
|
||||||
|
전체 테스트는 저장소 정책에 따라 사용자 실행(`./gradlew test`)이며, 운영 DDL·실제 AWS/Papago 계정 호출은 제외한다.
|
||||||
|
LSP 도구가 제공되지 않으면 Kotlin 컴파일과 ktlint로 보완하고 그 한계를 기록한다.
|
||||||
|
|
||||||
|
## 확정 구현 계약
|
||||||
|
|
||||||
|
아래는 Phase 1 구현 계약이며, 순서 설정 방식은 하단의 Phase 2 정정 계약이 우선한다. 기존 실행 기록은 보존한다.
|
||||||
|
|
||||||
|
- 기존 `TranslationProvider`와 raw `TranslateResult`는 유지한다.
|
||||||
|
- `LanguageDetectionProvider`: `providerName: String`, `detect(query: String): String?`.
|
||||||
|
- `DetectedLanguage`: `detectedLanguage: String`, `providerName: String`.
|
||||||
|
- `ProviderTranslationResult`: `result: TranslateResult`, `providerName: String`, `providerVersion: String`.
|
||||||
|
- 기존 `LanguageDetectionCacheService.detectWithCache(query: String): DetectedLanguage?`가 감지 선택·캐시·전환을 담당한다.
|
||||||
|
기존 callback overload는 남기지 않고 모든 테스트 fixture도 새 계약에 맞춘다.
|
||||||
|
- `TranslationCoordinator.findCached(sourceHash, sourceLanguage, targetLanguage): TranslationMemory?`를
|
||||||
|
worker와 materializer가 함께 사용한다. 캐시 선택만 통일하며 DB 저장 트랜잭션은 기존 worker에 남긴다.
|
||||||
|
- `TranslationCoordinator.translate(request: TranslateRequest): ProviderTranslationResult`가 실제 성공 공급자를 반환한다.
|
||||||
|
결과 개수 불일치·blank 결과·공급자 예외는 다음 공급자로 전환한다. 부분 결과는 섞지 않고 전체 요청을 넘긴다.
|
||||||
|
- 새 번역 coordinator의 빈 입력/blank 텍스트/동일 언어/미지원 언어 요청은 고정 메시지의 `IllegalArgumentException`으로
|
||||||
|
외부 호출 전에 거부한다. 기존 Papago raw adapter 가드는 그대로 유지한다.
|
||||||
|
- 전체 번역 공급자 실패는 원문·원시 예외를 포함하지 않는 `IllegalStateException("all translation providers failed")`이다.
|
||||||
|
감지 전체 실패는 null이다. catch는 adapter 호출에만 적용하고 DB 실패를 공급자 실패로 처리하지 않는다.
|
||||||
|
- `sodalive.language-providers.detection-order`와 `translation-order`는 각각 기본 `papago`이다.
|
||||||
|
순서는 재시작/재배포 시 반영한다. 미등록 공급자는 설정 오류로 거부하며 AWS 구현 전에는 `aws`를 활성화하지 않는다.
|
||||||
|
- 감지 캐시의 정규화/hash 규칙과 `insertIfAbsent` 다음 `findDetectedLanguageForUpdate` 승자 반환을 유지한다.
|
||||||
|
adapter에는 기존처럼 원래 query를 전달한다. 유효한 ko/en/ja 밖 감지 결과는 공급자 실패로 재해석하지 않는다.
|
||||||
|
- 공통 `TranslationLanguages`로 서비스 언어 정책만 옮긴다. Papago 분할은 Papago adapter에 유지한다.
|
||||||
|
- 현재 entity에는 공급자별 cache key가 있으므로 DDL 변경 없이 실제 공급자를 기록한다.
|
||||||
|
캐시 두 개가 있으면 설정상 앞선 결과를 선택하며 특정 job의 공급자를 영구 고정하는 새 모델은 만들지 않는다.
|
||||||
|
|
||||||
|
## Phase 2 결정 정정 — 2026-11-09
|
||||||
|
|
||||||
|
사용자는 YAML·환경변수 대신 코드의 상수 목록으로 감지·번역 순서를 지정하도록 승인했다.
|
||||||
|
|
||||||
|
- 유일한 production 순서 편집 지점은 `i18n/translation/LanguageProviderOrder.kt`의
|
||||||
|
`detectionOrder = listOf("papago")`, `translationOrder = listOf("papago")`이다. Kotlin 목록은 `const val`이 아닌 `val`이다.
|
||||||
|
- 목록의 왼쪽부터 사용한다. 감지·번역은 각각 수정할 수 있으며 변경 후 빌드·배포한다.
|
||||||
|
- 기존 `LanguageProviderProperties`는 typed-list 생성자와 명시적 Spring 기본 생성자로 코드 목록을 읽는다.
|
||||||
|
선택 코드·호출자의 이름 변경을 확산시키지 않는다. 문자열 생성자·`@Value`·split/trim은 제거한다.
|
||||||
|
- 테스트는 전역 목록을 바꾸지 않고 테스트 전용 bean에 typed list를 주입하여 독립 순서와 invalid order를 검증한다.
|
||||||
|
- 과거 우선순위 environment/property override는 무시한다. 다른 환경변수나 Spring 설정 체계는 변경하지 않는다.
|
||||||
|
- 실패 전환·공급자 검증·캐시·DB·인증·AWS 미구현 정책은 Phase 1을 그대로 유지한다.
|
||||||
|
|
||||||
|
## Phase 3 결정 정정 — 2026-11-09
|
||||||
|
|
||||||
|
사용자는 공급자 enum 도입과 식별자 용도의 papago 리터럴 변경을 승인했다. 타입 관련 항목은 이 계약이 앞선 Phase보다 우선한다.
|
||||||
|
|
||||||
|
- `LanguageProviderId(val code: String)`에 `PAPAGO("papago")`, `AWS("aws")`를 정의한다.
|
||||||
|
- `LanguageProviderOrder`, `LanguageProviderProperties`의 두 순서는 `List<LanguageProviderId>`이다.
|
||||||
|
기본 목록은 각각 `listOf(LanguageProviderId.PAPAGO)`이며 코드에서만 순서를 변경한다.
|
||||||
|
- 두 공급자 인터페이스, 두 실제 Papago adapter, `DetectedLanguage`, `ProviderTranslationResult`는
|
||||||
|
`providerName: String` 대신 `providerId: LanguageProviderId`를 사용한다. 버전은 기존 String을 유지한다.
|
||||||
|
- 선택/검증/coordinator는 enum으로 매칭한다. DB 조회/저장 접점에서만 `.code`로 변환한다.
|
||||||
|
entity와 repository, DDL은 변경하지 않는다. `.name`, `.ordinal`, `valueOf` 저장/변환과 불필요한 fromCode는 추가하지 않는다.
|
||||||
|
- API URL·인증 설정 키·원문/번역 fixture·DB 문자열 기대값·과거 환경변수 무시 테스트는 enum 전환 대상이 아니다.
|
||||||
|
- 기존 DB 값 호환 테스트는 기대값을 enum에서 계산하지 않고 독립 문자열 `"papago"`로 검증한다.
|
||||||
|
가짜 보조 공급자는 AWS enum과 저장값 `"aws"`를 사용하며 test-only enum 항목을 추가하지 않는다.
|
||||||
|
- 빈 문자열 ID는 타입으로 표현할 수 없어진다. 빈 목록·중복 순서·중복 구현체·해당 capability 구현체 부재 검증은 유지한다.
|
||||||
|
- 새로운 공급자 추가 시 enum 항목·구현체·코드 순서 목록을 추가한다. 도메인 호출자와 선택 알고리즘은 변경하지 않는다.
|
||||||
@@ -0,0 +1,152 @@
|
|||||||
|
# 언어 감지·번역 공급자 확장 가이드
|
||||||
|
|
||||||
|
## 현재 실행 구조
|
||||||
|
|
||||||
|
감지 구현체는 `PapagoLanguageDetectionProvider`와 `AwsLanguageDetectionProvider`,
|
||||||
|
번역 구현체는 `PapagoTranslationService`와 `AwsTranslationService`다.
|
||||||
|
production 기본 순서는 감지와 번역 모두 `AWS → PAPAGO`다. AWS는 기존 자격 증명과 리전 설정을 재사용한다.
|
||||||
|
|
||||||
|
감지와 번역은 별도 capability다. 감지만 또는 번역만 제공하는 공급자도 등록할 수 있다.
|
||||||
|
두 capability에서 같은 `providerId`를 쓰는 것은 가능하지만, 한 capability 안의 ID 중복은 시작 시 거부한다.
|
||||||
|
|
||||||
|
| 경계 | 계약 |
|
||||||
|
|---|---|
|
||||||
|
| `LanguageDetectionProvider` | `providerId: LanguageProviderId`, `detect(query: String): String?` |
|
||||||
|
| `LanguageDetectionCacheService` | `detectWithCache(query: String): DetectedLanguage?` |
|
||||||
|
| `DetectedLanguage` | `detectedLanguage: String`, `providerId: LanguageProviderId` |
|
||||||
|
| `TranslationProvider` | `providerId: LanguageProviderId`, `providerVersion: String`, `translate(TranslateRequest): TranslateResult` |
|
||||||
|
| `TranslationCoordinator` | `findCached(sourceHash, sourceLanguage, targetLanguage): TranslationMemory?`, `translate(TranslateRequest): ProviderTranslationResult` |
|
||||||
|
| `ProviderTranslationResult` | `result: TranslateResult`, `providerId: LanguageProviderId`, `providerVersion: String` |
|
||||||
|
|
||||||
|
인터페이스와 DTO는 `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/`에 있다.
|
||||||
|
감지 coordinator는 기존 `content/LanguageDetectionCacheService.kt`이며 별도 vendor가 아니다.
|
||||||
|
`TranslationCoordinator`도 `TranslationProvider`를 구현하지 않는다.
|
||||||
|
|
||||||
|
## 새 공급자 추가 순서
|
||||||
|
|
||||||
|
1. `LanguageProviderId`에 공급자 enum 항목과 재배포 후에도 안정적인 DB `code`를 추가한다.
|
||||||
|
현재 항목은 `PAPAGO("papago")`, `AWS("aws")`이며 두 공급자의 실제 adapter가 등록돼 있다.
|
||||||
|
2. 필요한 capability 인터페이스를 구현하고 Spring `@Component`/`@Service` 또는 `@Bean`으로 등록한다.
|
||||||
|
예를 들어 Papago adapter의 식별자는 `override val providerId = LanguageProviderId.PAPAGO`다.
|
||||||
|
3. 공급자의 HTTP/SDK 및 인증은 adapter 안에 둔다. 외부 응답 형식과 빈 결과를 검증하고,
|
||||||
|
원문·인증정보·응답 본문·예외 cause를 로그로 출력하지 않는다. 번역은 입력별 결과를 같은 순서로 반환한다.
|
||||||
|
4. `LanguageProviderOrder.kt`에서 구현한 capability의 목록에만 enum을 넣고 빌드·배포한다. `@Primary`나 selector 분기는 필요 없다.
|
||||||
|
5. 아래 테스트 경계로 순서·실패 전환·실제 provider 저장·무호출 캐시 재사용·materializer 표시를 검증한다.
|
||||||
|
|
||||||
|
콘텐츠·댓글·커뮤니티 호출자, worker, materializer, scheduler에 공급자 분기를 추가하지 않는다.
|
||||||
|
기존 두 coordinator는 주입된 구현체 목록과 설정만 사용한다. 공급자마다 다른 분할·요청 크기 제한은 adapter 책임이다.
|
||||||
|
`CodePointTextSplitter.kt`의 internal helper가 code point 경계의 분할·prefix와 UTF-8 길이 계산을 공유한다.
|
||||||
|
Papago는 기존 5,000 UTF-16 코드 단위(`Character.charCount`)로, AWS Translate는 10,000 UTF-8 바이트로 분할한다.
|
||||||
|
각 adapter는 조각을 순차 호출해 원문별로 구분자 없이 결합하며, 조각 하나라도 실패하면 전체 요청의 부분 결과를 버린다.
|
||||||
|
AWS Comprehend는 앞 최대 100,000 UTF-8 바이트만 감지한다. prefix는 원문 전체 hash/cache key나 번역 원문을 바꾸지 않는다.
|
||||||
|
혼합 언어 입력은 prefix와 전체 본문의 감지 결과가 다를 수 있다. blank 입력은 호출하지 않으며 짧은 비어 있지 않은 입력은 전달한다.
|
||||||
|
응답은 첫 후보만 사용하고 첫 코드가 blank/누락이면 뒤 후보를 대신 선택하지 않는다. 별도 confidence threshold는 없다.
|
||||||
|
ko/en/ja 서비스 정책은 `TranslationLanguages`에 있으며 공급자를 추가해도 자동 확장하지 않는다.
|
||||||
|
|
||||||
|
## 기능별 독립 코드 목록
|
||||||
|
|
||||||
|
production 순서의 유일한 편집 지점은
|
||||||
|
`src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt`다.
|
||||||
|
목록의 왼쪽부터 사용하며 감지와 번역의 기본 순서는 다음과 같다.
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
object LanguageProviderOrder {
|
||||||
|
val detectionOrder = listOf(LanguageProviderId.AWS, LanguageProviderId.PAPAGO)
|
||||||
|
val translationOrder = listOf(LanguageProviderId.AWS, LanguageProviderId.PAPAGO)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Kotlin 목록은 `const val`이 아닌 `val`이다. `LanguageProviderProperties`는 기존 주입 wrapper로 유지하며,
|
||||||
|
Spring은 `@Autowired` 기본 생성자로 위 목록을 읽는다. 문자열 파싱은 하지 않는다.
|
||||||
|
테스트에서는 전역 목록을 변경하지 않고
|
||||||
|
`LanguageProviderProperties(List<LanguageProviderId>, List<LanguageProviderId>)`로 만든 테스트 bean을 주입한다.
|
||||||
|
|
||||||
|
다음은 감지만 Papago 우선으로 바꾸는 예시다. 현재 기본 순서를 뜻하지 않는다.
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val detectionOrder = listOf(LanguageProviderId.PAPAGO, LanguageProviderId.AWS)
|
||||||
|
val translationOrder = listOf(LanguageProviderId.AWS, LanguageProviderId.PAPAGO)
|
||||||
|
```
|
||||||
|
|
||||||
|
감지만 순서를 바꾸어도 번역 순서는 바뀌지 않는다. 반대로 번역만 바꿀 수도 있다.
|
||||||
|
변경 후 빌드·배포해야 반영된다. 과거 우선순위 Spring property·환경변수·YAML 값이 남아 있어도 순서는 바뀌지 않는다.
|
||||||
|
공급자 인증정보는 기존 설정 경계로 주입하며 이 코드 목록에 넣지 않는다.
|
||||||
|
빈 목록·중복 ID·해당 capability의 구현체 부재·capability 안의 중복 구현체 ID는 초기화에서 거부한다.
|
||||||
|
빈 문자열 ID는 enum 타입으로 표현할 수 없다. 공급자가 번역에만 등록됐다면 그 ID를 감지 순서에 넣을 수 없다.
|
||||||
|
실행 중 설정 변경은 지원하지 않는다. 테스트의 Papago-only inventory는 두 순서를 명시적으로 `[PAPAGO]`로 제한한다.
|
||||||
|
|
||||||
|
## AWS SDK와 설정
|
||||||
|
|
||||||
|
Comprehend와 Translate만 AWS SDK for Java v2 BOM `2.57.11`을 사용하며 기존 SDK v1 의존성은 유지한다.
|
||||||
|
동기 HTTP runtime은 SDK의 전이 의존성이다. Spring Boot 2.7의 하향 버전 관리를 피하도록
|
||||||
|
`httpclient5.version=5.6.4`, `httpcore5.version=5.4.3`을 SDK POM 기준으로 고정한다.
|
||||||
|
|
||||||
|
`AwsLanguageProviderConfiguration`은 기존 `cloud.aws.credentials.access-key`, `cloud.aws.credentials.secret-key`를
|
||||||
|
`StaticCredentialsProvider`에 연결하고 `cloud.aws.region.static`을 `Region.of`에 전달한다(현재 설정은 `ap-northeast-2`).
|
||||||
|
기본 credentials chain이나 AWS 전용 새 인증 설정을 추가하지 않는다. 두 동기 client는 Spring Bean이며 종료 시 `close`한다.
|
||||||
|
AWS 번역은 source/target을 명시하며 `providerVersion`은 안정 값 `translate-2017-07-01`이다.
|
||||||
|
Papago의 `providerVersion`은 기존 `nmt-v1`이다. 두 값은 SDK 라이브러리 버전과 별개다.
|
||||||
|
|
||||||
|
실 AWS 호출·IAM·품질·과금은 자동 테스트에서 확인하지 않는다. 필요한 IAM 작업은
|
||||||
|
`comprehend:DetectDominantLanguage`, `translate:TranslateText`이며 이 가이드는 권한 변경을 승인하지 않는다.
|
||||||
|
|
||||||
|
## DB code 호환성
|
||||||
|
|
||||||
|
내부 순서·구현체 매칭·성공 결과는 `LanguageProviderId`를 사용한다. entity/repository의 `provider`는 String 그대로다.
|
||||||
|
coordinator/cache/worker의 DB 조회·저장 접점에서만 `providerId.code`로 변환하므로 기존 `"papago"` 캐시를 재사용한다.
|
||||||
|
실제 AWS 성공 결과의 저장값은 `"aws"`다. enum `.name`/`.ordinal`, `@Enumerated`/`@Convert`, 역변환 helper는 사용하지 않는다.
|
||||||
|
새 enum 항목을 추가할 때도 기존 code와 DB 스키마·캐시 키는 변경하지 않는다. `providerVersion`은 별도의 String 기록 필드다.
|
||||||
|
|
||||||
|
## 캐시와 오류 계약
|
||||||
|
|
||||||
|
콘텐츠의 `tags` 작업은 원문과 쉼표 요소별 정규화 결과가 같은 AWS 응답을 성공으로 인정하지 않고 Papago로 넘긴다.
|
||||||
|
같은 AWS 캐시도 이 필드의 worker/materializer에서는 사용하지 않는다. Papago가 원문과 같은 값을 반환하면 성공으로 인정한다.
|
||||||
|
일반 제목/본문과 다른 리소스의 필드에는 이 추가 판정을 적용하지 않으며, 원문 hash와 저장 캐시는 일괄 변경하지 않는다.
|
||||||
|
|
||||||
|
감지는 정규화/hash/normalization version을 기존과 같이 사용하고 adapter에는 원래 query를 전달한다.
|
||||||
|
설정된 모든 공급자의 캐시를 순서대로 조회한 뒤, 유효 캐시가 하나도 없을 때만 외부 호출을 시작한다.
|
||||||
|
저장은 실제 성공 공급자로 `insertIfAbsent`하고 이어지는 locking read의 승자를 반환한다.
|
||||||
|
ko/en/ja 밖의 유효 감지 결과도 성공이다. 커뮤니티의 기존 지원 언어 gate는 별도로 유지된다.
|
||||||
|
|
||||||
|
번역 worker와 materializer는 동일한 `TranslationCoordinator.findCached`를 사용한다.
|
||||||
|
앞선 공급자의 캐시가 없어도 뒤 공급자의 유효 캐시가 있으면 외부 호출을 하지 않는다.
|
||||||
|
여러 공급자 캐시가 있으면 설정 순서상 첫 유효 결과를 선택한다. job을 특정 vendor에 영구 고정하지 않는다.
|
||||||
|
cache key와 DDL은 바꾸지 않았으며 `providerVersion`은 기록 필드이지 cache key가 아니다.
|
||||||
|
외부 번역은 worker의 저장 트랜잭션 밖에서 실행하고, 실제 성공 공급자로 저장 직전 재조회한다.
|
||||||
|
materializer는 외부 번역을 호출하지 않는다.
|
||||||
|
|
||||||
|
adapter 예외·null 감지·빈 감지·번역 결과 개수 불일치·blank 번역 결과는 다음 공급자로 전환한다.
|
||||||
|
번역은 부분 결과를 섞지 않고 원래 요청 전체를 다음 공급자에게 한 번 넘긴다. 첫 성공 이후에는 중단한다.
|
||||||
|
저장소 조회·저장 오류는 adapter 실패로 catch하지 않는다.
|
||||||
|
감지가 모두 실패하면 `null`, 번역이 모두 실패하면 cause 없는
|
||||||
|
`IllegalStateException("all translation providers failed")`를 반환하며 기존 job 재시도 경로를 따른다.
|
||||||
|
빈 목록·blank 텍스트·동일 언어(대소문자 무시)·미지원 번역 언어는 외부 호출 전에
|
||||||
|
`IllegalArgumentException("invalid translation request")`로 거부한다. raw Papago의 기존 가드는 유지한다.
|
||||||
|
|
||||||
|
## 검증 경계
|
||||||
|
|
||||||
|
| 테스트 | 검증 내용 |
|
||||||
|
|---|---|
|
||||||
|
| `LanguageProviderSpringConfigurationTest` | production 기본 생성자와 AWS 우선 성공, 과거 property/env 무시, 독립 순서와 잘못된 목록의 시작 실패; fake AWS context와 실제 adapter + SDK mock context 분리 |
|
||||||
|
| `LanguageProviderIdTest` | 런타임 enum getter 계약, 안정적인 papago/aws code, production 기본값과 실제 adapter ID |
|
||||||
|
| `LanguageProviderPropertiesTest` | 순서 검증 및 선택되지 않은 bean을 포함한 capability 내 중복 ID 거부 |
|
||||||
|
| `LanguageDetectionProviderTest` / `TranslationCoordinatorTest` | 전체 요청 폴백, 첫 성공 중단, cache-first, 안전한 전체 실패, DB 오류 전파 |
|
||||||
|
| `PapagoLanguageDetectionProviderTest` / `PapagoTranslationServiceTest` | 제어된 HTTP form/header/response와 빈 raw 입력·공백을 포함한 19개 번역 회귀 |
|
||||||
|
| `CodePointTextSplitterTest` | UTF-16/UTF-8 한도, 한글·보조 평면 문자·공백 보존, prefix와 전체 원문의 분리 |
|
||||||
|
| `AwsLanguageDetectionProviderTest` / `AwsTranslationServiceTest` | 실제 adapter + SDK mock의 요청·응답, prefix/분할·결합, 첫 후보, 중간 실패 폐기와 호출 중단, 민감 오류 비노출 |
|
||||||
|
| `AwsLanguageProviderConfigurationTest` | 합성 credentials/region으로 실제 client 생성과 종료, 네트워크 무호출 |
|
||||||
|
| `LanguageProviderCacheEndToEndTest` | 실제 AWS adapters + SDK mock + H2의 5개 시나리오: 동일 prefix·서로 다른 전체 hash, 첫 blank 후보 미저장, aws/version/결합 결과 저장과 무호출 재사용·표시, 부분 실패 미저장과 안전한 worker 오류, 테스트 전용 AWS → PAPAGO의 전체 요청 fallback |
|
||||||
|
|
||||||
|
H2 버전은 MySQL `FOR UPDATE SKIP LOCKED`를 지원하지 않으므로 새 H2 테스트는 claim 조회 한 곳만
|
||||||
|
test spy로 대체한다. 나머지 repository 저장·별도 트랜잭션 재조회·materialization은 실제 H2다.
|
||||||
|
이 테스트가 운영 MySQL claim 동시성이나 SDK serialization/signing·실 AWS 권한/품질을 검증한다는 뜻은 아니다.
|
||||||
|
SDK mocks는 테스트마다 reset하고 Papago 기록 목록과 cache/job/read model을 비워 context 재사용을 격리한다.
|
||||||
|
기존 감지 cache 경합·revision 테스트는 별도로 유지한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
AWS 구현의 실행 명령, 결과와 미검증 범위는 [AWS 구현 계획](../20261109_AWS언어감지번역/plan-task.md)의 실행 증거를 따른다.
|
||||||
|
이전 공통화 기록은 [공통화 계획](plan-task.md)에 보존한다. 전체 테스트는 사용자가 `./gradlew test`로 실행한다.
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
# 감지·번역 공급자 공통화 최종 리뷰
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 일자 | 2026-11-09 |
|
||||||
|
| 범위 | P1-T1/P1-T2와 전체 작업 트리 변경, 신규 미추적 파일 포함 |
|
||||||
|
| 기준 | [PRD](../prd.md) LP-001~010, [구현 계획](../plan-task.md) |
|
||||||
|
| 리뷰어 | 독립 읽기 전용 gate reviewer |
|
||||||
|
| 판정 | **APPROVE** |
|
||||||
|
|
||||||
|
## 발견 사항
|
||||||
|
|
||||||
|
확정 발견 사항 없음. 추가 회귀 수정 Task로 전환할 항목 없음.
|
||||||
|
|
||||||
|
## 수용 기준
|
||||||
|
|
||||||
|
| 기준 | 확인 내용 |
|
||||||
|
|---|---|
|
||||||
|
| LP-001/002/008 | 감지·번역별 인터페이스와 순서 설정, 빈/중복/미등록 이름 시작 실패, enum/분기 없이 bean 확장 |
|
||||||
|
| LP-003/004/007 | 한 번씩 순차 호출, 첫 성공 중단, 전체 요청 폴백, 입력 guard, 안전한 전체 실패 |
|
||||||
|
| LP-005/006 | 실제 provider/version 저장, 모든 활성 provider의 cache-first, worker/materializer의 공통 lookup |
|
||||||
|
| LP-009 | 기존 캐시 데이터·canonical winner·트랜잭션·revision·afterCommit·워커 재시도·Papago 분할 보존 |
|
||||||
|
| LP-010 | 실제 코드와 일치하는 확장 가이드, 기본 papago, production AWS 미구현 명시 |
|
||||||
|
|
||||||
|
## 품질·보안
|
||||||
|
|
||||||
|
- catch는 adapter 호출에만 적용하며 DB 오류는 전파한다.
|
||||||
|
- 원문·인증정보·공급자 응답·원시 vendor 오류를 신규 로그에 기록하지 않는다.
|
||||||
|
- 기존 latch·경합·stale revision assertion을 삭제/완화하지 않았다.
|
||||||
|
- 번역 worker의 오류 기대값 변경은 고정 안전 메시지 계약에 따른 것이다.
|
||||||
|
- 기존 Papago 분할/HTTP 테스트 17건을 수정하지 않았다.
|
||||||
|
|
||||||
|
## 검증 근거
|
||||||
|
|
||||||
|
- reviewer가 XML 15개를 직접 확인: 85건, failures/errors/skipped 0.
|
||||||
|
- reviewer `git diff --check`: exit 0.
|
||||||
|
- 부모 실행 증거: fresh filtered `test --rerun` 성공, ktlintCheck/bootJar 확인.
|
||||||
|
- 부모 독립 Spring runtime: 감지/번역 순서 각각 교체, fallback 귀속, 캐시 무호출, 전체 실패 및 잘못된 설정 거부.
|
||||||
|
- 부모 loopback HTTP: 실제 Papago 감지 adapter의 form/header/원문 보존과 성공/blank/500 응답 처리.
|
||||||
|
- 리뷰는 읽기 전용이며 추가 에이전트, 실제 API, 테스트/빌드 재실행, 파일 변경을 하지 않았다.
|
||||||
|
|
||||||
|
## 남은 검증 한계
|
||||||
|
|
||||||
|
실제 유료 API·운영 MySQL·전체 테스트·LSP는 미검증이다. H2의 MySQL `SKIP LOCKED` claim SQL 한 곳은
|
||||||
|
테스트 대역이므로 운영 claim 동시성을 검증했다고 주장하지 않는다. 이 한계는 이번 범위의 승인과 구분한다.
|
||||||
@@ -0,0 +1,31 @@
|
|||||||
|
# 코드 기반 공급자 순서 Phase 2 리뷰
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 기준 | [PRD](../prd.md) LP-011/012, [계획](../plan-task.md) Phase 2 |
|
||||||
|
| 일자 | 2026-11-09 |
|
||||||
|
| 리뷰어 | 독립 읽기 전용 gate reviewer |
|
||||||
|
| 판정 | **APPROVE** |
|
||||||
|
|
||||||
|
## 판정 근거
|
||||||
|
|
||||||
|
- `LanguageProviderOrder`의 두 독립 `val List<String>`이 production 순서의 기준이며 기본값은 각각 papago다.
|
||||||
|
- `LanguageProviderProperties`는 typed-list 생성자와 `@Autowired` 기본 생성자만 제공한다.
|
||||||
|
우선순위용 String overload, `@Value`, 문자열 파싱이나 mutable 전역 설정이 없다.
|
||||||
|
- YAML 삭제는 우선순위 블록 5줄뿐이다. 인증 환경변수는 유지한다.
|
||||||
|
- 실제 Spring 기본 경로에서 과거 property/env 값은 순서에 영향을 주지 않는다.
|
||||||
|
- 독립 순서·invalid 목록·중복 공급자·H2 귀속/재사용의 기존 검증을 유지한다.
|
||||||
|
- 현재 가이드가 코드 편집 지점·빌드/배포·기존 override 무시 동작과 일치한다.
|
||||||
|
- enum 변경은 사용자가 적합성만 질문한 별도 미승인 범위로, 이번 구현 누락이 아니다.
|
||||||
|
|
||||||
|
**확정 발견 사항 없음. 수정 Task 전환 항목 없음.**
|
||||||
|
|
||||||
|
## 검증 근거와 한계
|
||||||
|
|
||||||
|
변경 전 의미 있는 RED 2건, 구현 후 88/88 통과와 실제 lint/bootJar 성공 기록을 검토했다.
|
||||||
|
부모가 XML 15개를 직접 대조했고, focused 54건을 `--rerun`하여 exit 0(36초)을 확인했다.
|
||||||
|
부모의 별도 Java/Spring 실행은 충돌 property/env 무시, 감지 B/A/C·번역 C/B/A, invalid 목록/공급자 거부를 통과했다.
|
||||||
|
Spring context는 종료됐으며 외부 API 요청은 없었다. reviewer `git diff --check`는 exit 0이다.
|
||||||
|
|
||||||
|
리뷰는 코드·테스트·설정을 변경하거나 테스트/빌드를 재실행하지 않았다.
|
||||||
|
전체 테스트·LSP·유료 API·운영 MySQL은 미검증이며 기존 H2 claim SQL 대역 한계를 그대로 명시한다.
|
||||||
@@ -0,0 +1,32 @@
|
|||||||
|
# 공급자 enum 전환 Phase 3 리뷰
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 일자 | 2026-11-09 |
|
||||||
|
| 범위 | LP-013~015 및 Phase 1·2 보존 계약, 전체 미커밋 변경과 신규 파일 |
|
||||||
|
| 기준 | [PRD](../prd.md) Phase 3, [계획](../plan-task.md) P3, 현재 확장 가이드 |
|
||||||
|
| 리뷰어 | 독립 읽기 전용 gate reviewer |
|
||||||
|
| 판정 | **APPROVE** |
|
||||||
|
|
||||||
|
## 확인 결과
|
||||||
|
|
||||||
|
- 공급자 인터페이스·구현체·성공 결과·순서·매칭은 enum이며 providerName alias/호환 shim이 없다.
|
||||||
|
- enum은 PAPAGO/AWS 두 항목이고 기본 순서는 PAPAGO 하나다. 실제 AWS adapter/SDK는 추가하지 않았다.
|
||||||
|
- `.code`는 DB 조회·저장 경계 6곳에 적용된다. entity/repository String, 고유 키와 schema는 그대로다.
|
||||||
|
- `.name`/`.ordinal`/`valueOf` 저장/변환이나 불필요한 fromCode가 없다.
|
||||||
|
- 기존 papago 문자열 기대값을 유지하고 AWS 저장값은 독립 문자열 aws로 확인한다.
|
||||||
|
- 빈 목록·중복 순서·중복 구현체·해당 capability의 AWS 구현체 부재를 거부한다.
|
||||||
|
- fallback·개수/blank·첫 성공 중단·DB 오류 전파·cache-first·동시성·revision·afterCommit·분할 검증을 유지한다.
|
||||||
|
|
||||||
|
**확정 발견 사항 없음. 추가 수정 Task 전환 항목 없음.**
|
||||||
|
|
||||||
|
## 실행 증거와 한계
|
||||||
|
|
||||||
|
리뷰어가 현재 XML 16개를 직접 대조하여 91/91, failures/errors/skipped 0을 확인했다.
|
||||||
|
컴파일 가능한 runtime getter assertion의 RED, 구현자의 실제 lint/bootJar 성공,
|
||||||
|
부모 fresh filtered test --rerun 성공(52초)과 별도 Java/Spring 실행 증거를 구분해 검토했다.
|
||||||
|
부모 driver는 typed getter/adapter ID/기존 문자열 cache 재사용/실패 전환/DB code 인자/미구현 AWS 거부를 확인했다.
|
||||||
|
driver repository 대역은 실제 H2 저장·재조회·표시 증거와 구분했다. 리뷰어 git diff --check는 exit 0이다.
|
||||||
|
|
||||||
|
리뷰는 파일 변경·테스트/빌드 재실행·서버/API 호출·추가 에이전트 위임 없이 수행했다.
|
||||||
|
전체 테스트·LSP·운영 MySQL·실제 유료 API는 미검증이며 H2의 SKIP LOCKED claim은 기존 test spy 한계가 있다.
|
||||||
@@ -0,0 +1,146 @@
|
|||||||
|
# 자막 Phase 1 배포 게이트
|
||||||
|
|
||||||
|
**현재 판정: 배포 BLOCKED.** 이 문서는 로컬 저장 계약과 배포 전 확인 항목이며 DB 적용·AWS 배포 증거가 아니다.
|
||||||
|
기준일은 2026-11-10이며 [PRD](prd.md), [구현 계획](plan-task.md), [DDL](subtitle-schema.sql)을 함께 본다.
|
||||||
|
|
||||||
|
## 1. 검토 기준과 파일 경계
|
||||||
|
|
||||||
|
- persistence 기준 경로: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/`.
|
||||||
|
- 실제 읽은 파일: `SubtitleJob.kt`, `Subtitle.kt`, `SubtitleCallbackReceipt.kt` 및 세 repository.
|
||||||
|
- 콘텐츠 기준: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContent.kt`, `common/BaseEntity.kt`.
|
||||||
|
- `src/main/resources/application.yml`의 `MySQL8Dialect`·`ddl-auto: validate`는 로컬 설정 근거일 뿐 운영 DB 증거가 아니다.
|
||||||
|
- 문서 담당은 이 문서와 DDL만 작성한다. 병렬 Kotlin 구현의 최종 엔티티 대조는 상위 구현 게이트에서 다시 수행한다.
|
||||||
|
|
||||||
|
## 2. 저장 계약 대조
|
||||||
|
|
||||||
|
물리명은 기존 Spring snake_case 매핑 기준이다. 길이 미지정 `String`은 JPA 기본 `VARCHAR(255)`를 따른다.
|
||||||
|
`jobId`는 UUID **문자열**이며 `BINARY(16)`으로 바꾸지 않는다. `N`은 NOT NULL, `Y`는 NULL 허용이다.
|
||||||
|
|
||||||
|
| `SubtitleJob.kt` 속성 | DDL 컬럼·타입 | NULL |
|
||||||
|
|---|---|---|
|
||||||
|
| `jobId` | `job_id VARCHAR(36)` PK | N |
|
||||||
|
| `contentId` | `content_id BIGINT` signed | N |
|
||||||
|
| `sourceBucket`, `sourceKey` | `source_bucket`, `source_key VARCHAR(255)`; 전체 두 컬럼 unique | N |
|
||||||
|
| `outputKey` | `output_key VARCHAR(255)` | N |
|
||||||
|
| `status` | `status VARCHAR(32)`; enum STRING | N |
|
||||||
|
| `errorCode` | `error_code VARCHAR(255)` | Y |
|
||||||
|
| `errorMessage` | `error_message TEXT` | Y |
|
||||||
|
| `sourceUploadErrorCode` | `source_upload_error_code VARCHAR(255)` | Y |
|
||||||
|
| `sourceUploadErrorAt` | `source_upload_error_at TIMESTAMP`; 명시적 JPA TIMESTAMP | Y |
|
||||||
|
| `createdAt`, `updatedAt` | `created_at`, `updated_at TIMESTAMP` | N |
|
||||||
|
|
||||||
|
| `Subtitle.kt` 속성 | DDL 컬럼·타입 | NULL |
|
||||||
|
|---|---|---|
|
||||||
|
| `id` | `id BIGINT` signed PK AUTO_INCREMENT | N |
|
||||||
|
| `jobId` | `job_id VARCHAR(36)` FK → `subtitle_job.job_id` | N |
|
||||||
|
| `language` | `language VARCHAR(35)`; `(job_id, language)` unique | N |
|
||||||
|
| `format` | `format VARCHAR(16)` | N |
|
||||||
|
| `s3Bucket`, `s3Key` | `s3_bucket`, `s3_key VARCHAR(255)` | N |
|
||||||
|
|
||||||
|
2026-11-11 정정: 이전 정적 대조는 `s3Bucket`의 숫자 경계 명명 규칙을 놓쳤다. 기본 naming strategy가
|
||||||
|
`s3bucket`/`s3key`로 추론하므로 두 필드에 명시적 `@Column(name = "s3_bucket"/"s3_key")`가 필요하다.
|
||||||
|
`P3-R1`에서 실제 `validate` 실패를 재현한 뒤 두 이름을 명시해 H2 validation/저장/재조회를 통과했다.
|
||||||
|
독립 리뷰도 승인했다. 운영 DB에 `s3bucket` 컬럼을 추가한 것이 아니며 실 MySQL 기동은 별도 확인 대상이다.
|
||||||
|
|
||||||
|
| 기존 엔티티 속성 | DDL 컬럼·타입 | NULL |
|
||||||
|
|---|---|---|
|
||||||
|
| `SubtitleCallbackReceipt.eventId` | `event_id VARCHAR(255)` PK; UUID 제한 없음 | N |
|
||||||
|
| `SubtitleCallbackReceipt.jobId` | `job_id VARCHAR(36)` | N |
|
||||||
|
| `SubtitleCallbackReceipt.bodyHash` | `body_hash VARCHAR(64)` | N |
|
||||||
|
| `SubtitleCallbackReceipt.createdAt` | `created_at TIMESTAMP` | N |
|
||||||
|
| `AudioContent.latestSubtitleJobId` | `content.latest_subtitle_job_id VARCHAR(36)` | Y |
|
||||||
|
|
||||||
|
### 미확정 차이와 적용 전 대조
|
||||||
|
|
||||||
|
1. 마지막 정적 대조에서 `Subtitle.kt`의 테이블명·6개 컬럼·길이·nullable·IDENTITY PK·unique가 합의 계약과 일치했다.
|
||||||
|
`SubtitleJob.kt`에서도 `koKey`/`jaKey` 제거를 확인했다. `Subtitle.jobId`는 scalar이고 JPA 관계/FK 선언은 없다.
|
||||||
|
DDL의 `subtitle.job_id` FK는 합의 계약에 따른 DB 제약이며 ORM 관계 선언 확인으로 보고하지 않는다.
|
||||||
|
`subtitle_job` CREATE에 `ko_key`/`ja_key`는 넣지 않는다. 미출시 초안 교체이며 기존 데이터 이관·컬럼 삭제 SQL은 없다.
|
||||||
|
2. 최초 대조에서는 `sourceUploadErrorAt`에 `columnDefinition`이 없어 차이로 기록했다.
|
||||||
|
최종 구현은 `@Column(columnDefinition = "TIMESTAMP")`와 초 절삭을 명시했고 부모가 DDL과 다시 대조했다.
|
||||||
|
이 로컬 mapping 차이는 해소됐지만 실제 MySQL schema 적용·왕복 검증은 여전히 운영 게이트다.
|
||||||
|
3. 나머지 시각은 엔티티의 명시적 `TIMESTAMP`와 초 절삭을 따른다. DDL 소수초 정밀도는 모두 0이다.
|
||||||
|
`created_at`은 `DEFAULT CURRENT_TIMESTAMP`, job의 `updated_at`은 같은 기본값과 `ON UPDATE CURRENT_TIMESTAMP`다.
|
||||||
|
`Subtitle.kt`에는 시각이나 `BaseEntity` 상속이 없으므로 결과 행에 임의 시각 컬럼을 추가하지 않는다.
|
||||||
|
UTC 생성값과 JDBC/session timezone 및 실제 MySQL 왕복은 미검증이다.
|
||||||
|
4. `AudioContent`는 `content` 테이블이며 `BaseEntity.id: Long?`의 IDENTITY를 상속한다.
|
||||||
|
신규 `content_id`는 signed BIGINT로 맞췄지만 운영 `content.id`의 실제 타입·부호·엔진은 확인하지 않았다.
|
||||||
|
합의된 `subtitle.job_id` FK만 둔다. receipt의 jobId 및 콘텐츠 연결은 현재 scalar 매핑이므로 FK를 임의 추가하지 않는다.
|
||||||
|
FK cascade는 없으며 기본 RESTRICT다. `(job_id, language)` unique가 결과 FK와 작업별 조회 인덱스를 겸한다.
|
||||||
|
5. 현재 callback 활성화는 `ko-KR`/`ja-JP`, 형식은 `SRT`, 결과 2/1/0개의 상태 판정은 그대로다.
|
||||||
|
저장 구조만 언어별 행으로 바꾼다. 새 언어 활성화·재생성·새 관리 API·recovery 상태/테이블은 추가하지 않는다.
|
||||||
|
|
||||||
|
### 식별자와 인덱스 전제
|
||||||
|
|
||||||
|
- 세 신규 테이블과 최신 job 컬럼은 `utf8mb4_0900_bin`을 쓴다. 대소문자·후행 공백을 구별하는 NO PAD 비교다.
|
||||||
|
eventId 및 bucket/key의 정확한 식별에 case-insensitive collation이나 PAD SPACE인 `utf8mb4_bin`을 대신 쓰지 않는다.
|
||||||
|
- MySQL 8.0.17 이상 및 해당 collation의 binary/NO PAD 속성, InnoDB DYNAMIC·3072-byte 키 지원을 운영자가 확인한다.
|
||||||
|
16 KiB 이상 InnoDB page를 전제로 하며 4/8 KiB page 환경의 적합성을 주장하지 않는다.
|
||||||
|
- source unique 최대 키 데이터는 `(255 + 255) × 4 = 2040` bytes다. eventId PK는 `255 × 4 = 1020` bytes다.
|
||||||
|
결과 unique는 `(36 + 35) × 4 = 284` bytes다. 보조 인덱스의 PK 포함분도 3072 bytes 미만이다.
|
||||||
|
prefix unique나 해시 식별자로 원래 bucket/key를 대체하지 않는다.
|
||||||
|
- 경로 컬럼은 현재 UUID 기반 계약에 맞는 `VARCHAR(255)`이며 일반 S3 최대 길이 전체 지원을 뜻하지 않는다.
|
||||||
|
job의 `(content_id, created_at)` 인덱스는 현재 `findFirstByContentIdOrderByCreatedAtAsc` 조회에 대응한다.
|
||||||
|
|
||||||
|
## 3. Lambda handoff와 실제 환경 구분
|
||||||
|
|
||||||
|
아래 SHA-256은 **PRD §2의 기존 조사 기록 인용**이다. 문서 담당이 외부 저장소·ZIP·AWS를 다시 조회한 결과가 아니다.
|
||||||
|
원본 보고서 참조는 PRD에 적힌 `aws-subtitle-service/docs/FINAL_REPORT.md`다.
|
||||||
|
|
||||||
|
| 정확한 artifact | SHA-256 |
|
||||||
|
|---|---|
|
||||||
|
| `start-subtitle-transcription.zip` | `a0d0b19b2ecb24c0f89caf528bf09fd039558563a99063f082ac64418704abfd` |
|
||||||
|
| `generate-subtitle.zip` | `bfa8742ca436bace853ec2540fc5f70daa24cbab49e75315565d980189fbf209` |
|
||||||
|
|
||||||
|
로컬 artifact 일치 기록은 운영 함수 버전/alias·event routing·consumer·in-flight·Scheduler·DB 적용 증거가 아니다.
|
||||||
|
자격 증명/JWT/raw body 값은 이 문서나 증거 보고서에 기록하지 않는다.
|
||||||
|
|
||||||
|
## 4. 운영 차단 항목
|
||||||
|
|
||||||
|
| 게이트 | 현재 | 해제에 필요한 증거 |
|
||||||
|
|---|---|---|
|
||||||
|
| 최종 엔티티·DB | BLOCKED | 위 차이 해소, 운영 기존 스키마·버전·collation·인덱스 확인, 별도 DDL 승인·적용 기록 |
|
||||||
|
| consumer·조정 배포 | BLOCKED | 운영자 inventory, 실행 중일 때만 pause/drain, backend·정확한 두 Lambda의 조정 배포 기록 |
|
||||||
|
| MediaConvert·CloudFront | BLOCKED | UUID 입력의 ID 추출/출력 확장자 및 private origin·서명 URL 실환경 검증 |
|
||||||
|
| controlled live | BLOCKED | ko/ja/mixed의 실제 S3 → callback → 콘텐츠/앱 결과와 word/item 언어 증거 |
|
||||||
|
| 대표 2시간 입력 | BLOCKED·미측정 | 신뢰 가능한 duration 근거 및 대표 입력의 전체 처리 예산 실측 |
|
||||||
|
|
||||||
|
### 운영자 실행 순서: 별도 승인 후에만
|
||||||
|
|
||||||
|
1. 운영 consumer·event routing·함수 버전/alias·in-flight·기존 DB 상태를 inventory로 확정한다.
|
||||||
|
실행 중인 consumer가 있을 때만 신규 유입을 pause하고 기존 작업·callback을 drain하는 전환 구간을 조율한다.
|
||||||
|
실행 중인 대상이 없으면 그 증거와 함께 pause/drain을 생략한다. 미확인 상태를 비가동으로 간주하지 않는다.
|
||||||
|
2. 최종 JPA와 실제 `SHOW CREATE TABLE`·collation·인덱스 전제를 대조하고 DB 변경을 별도 승인받는다.
|
||||||
|
기존 동명 테이블/컬럼이 있으면 중단하고 차이를 검토한다. `IF NOT EXISTS`로 불일치를 숨기지 않는다.
|
||||||
|
additive DDL 승인·적용 확인과 Phase 1 backend/두 Lambda의 배포를 같은 전환 계획으로 조율한다.
|
||||||
|
구·신 consumer의 중복 실행이나 호환성 미확인 in-flight를 남긴 채 재개하지 않는다.
|
||||||
|
3. UUID 원본 `input/{contentId}/{UUID filename}`으로 외부 MediaConvert의 contentId 추출 규칙을 확인한다.
|
||||||
|
등록은 안전한 실제 파일 확장자를 UUID 뒤에 보존한다. 실제 START ZIP은 지원 확장자를 검사하므로
|
||||||
|
누락/미지원 확장자의 자막 성공을 주장하지 않는다. 이를 위해 기존 업로드를 거부하거나 파일을 허위 변환하지 않는다.
|
||||||
|
출력 경로·실제 확장자·완료 callback·기존 preview/알림 흐름의 호환 증거가 필요하다.
|
||||||
|
로컬 `matchesOutput`의 허용 확장자는 `aac`/`m4a`/`mp3`이나 실제 외부 출력 계약이 확인된 것은 아니다.
|
||||||
|
자막 bucket/key가 기존 private CloudFront origin/path에 정확히 매핑되고 권한 있는 사용자만 서명 URL로
|
||||||
|
열람하는지 확인한다. 두 항목 모두 현재 미검증이며 임의 prefix 허용이나 공개 S3 URL로 우회하지 않는다.
|
||||||
|
현재 Spring의 자막 bucket allowlist는 기존 `cloud.aws.s3.content-bucket` 한 개다.
|
||||||
|
Lambda `MEDIA_BUCKET`과 `SUBTITLE_BUCKET`도 이 값에 맞춰야 하며, 별도 자막 bucket을 쓰려면
|
||||||
|
allowlist와 CloudFront origin 계약을 먼저 변경·검증해야 한다. 현재 구현이 다중 bucket을 지원한다고 보지 않는다.
|
||||||
|
4. 일반 유입을 재개하기 전에 controlled ko/ja/mixed live를 수행한다.
|
||||||
|
S3 source binding, Transcribe 실제 word/item 언어, 결과 SRT, BOT callback, 언어별 콘텐츠/앱 표시를 연결해 기록한다.
|
||||||
|
mixed는 실제 word/item 언어 증거가 필수이며 synthetic fixture나 HTTP metadata 검증으로 대체할 수 없다.
|
||||||
|
유료 preview-only 사용자의 전체 자막 차단과 private 접근도 확인한다.
|
||||||
|
5. 신뢰 가능한 기존 duration의 가용성과 입력 검증 경계를 확인하고 대표 2시간 입력의 처리 예산을 실측한다.
|
||||||
|
구형/검증 불가능 원본은 수동 게이트로 남기며 임의 client duration을 신뢰하지 않는다.
|
||||||
|
2시간은 입력 목표이지 SLA/지원 보장이 아니다. 미측정 상태에서 지원 또는 재개 승인을 하지 않는다.
|
||||||
|
모든 차단 항목의 증거와 승인자를 기록한 뒤에만 일반 유입을 재개한다.
|
||||||
|
|
||||||
|
purge·데이터 정리·적용 migration 수정·Scheduler fallback·자동 복구·Translate 50-call 정책은 이 절차에 없다.
|
||||||
|
재생성 전체와 새 언어 활성화 역시 제외한다. 미해결 작업을 삭제하거나 성공 처리해 drain을 가장하지 않는다.
|
||||||
|
|
||||||
|
## 5. 문서 담당 검증 경계
|
||||||
|
|
||||||
|
문서 간 계약·실제 엔티티 속성·컬럼별 COMMENT·테이블 COMMENT·SQL 종류·공백을 read/rg로 정적으로 대조했다.
|
||||||
|
DDL은 CREATE TABLE 3개와 ALTER TABLE ADD COLUMN 1개뿐이며 23개 신규 컬럼·3개 신규 테이블에 COMMENT가 있다.
|
||||||
|
후행 공백·탭·CR·130자 초과 행은 발견하지 않았다. SQL 파싱/실행이나 물리 스키마 호환성을 검증한 결과가 아니다.
|
||||||
|
이 담당은 테스트·빌드·DB 실행·AWS 접근·외부 저장소 조회를 하지 않으며 성공 결과를 주장하지 않는다.
|
||||||
|
상위 구현 검증도 이번 작업에서 새로 작성한 테스트만 실행하도록 승인되어 있다. 기존 테스트 실행은 승인 범위가 아니다.
|
||||||
|
로컬 HTTP·새 테스트·빌드 결과는 구현 담당의 별도 증거이며, 그 성공도 위 운영 게이트를 해제하지 않는다.
|
||||||
@@ -0,0 +1,132 @@
|
|||||||
|
# 자막 Phase 1 Spring 구현 검증 기록
|
||||||
|
|
||||||
|
> 상태: **재생성 제외 로컬 backend 구현·신규 테스트 15개·독립 리뷰 완료**. 운영 배포 완료가 아니다.
|
||||||
|
|
||||||
|
## 범위와 결정
|
||||||
|
|
||||||
|
- 이번 범위: 기존 업로드의 PENDING/source 선등록, 네 BOT 내부 endpoint, raw-body receipt, 기존 상세의 언어·권한별 자막 제공.
|
||||||
|
- 재생성은 사용자 결정으로 제외했다. 새 공개 재생성 API, 직접 START 호출, Scheduler/outbox를 만들지 않는다.
|
||||||
|
- 후속 요구로 언어별 결과는 `Subtitle` 행에 저장한다. 이번 callback 허용 언어/완료 판정은 ko/ja만 유지하며 다른 언어를 활성화하지 않는다.
|
||||||
|
- 테스트 실행은 사용자 후속 지시 이후 **이번 작업에서 새로 작성한 테스트만** 대상으로 한다. 기존 클래스에 추가한 사례도 메서드 selector로 한정한다.
|
||||||
|
|
||||||
|
## 실제 조사와 보존
|
||||||
|
|
||||||
|
- 현재 Spring에 subtitle/recovery/자막 HMAC/재생성 action이 발견되지 않았다. 제거할 해당 코드가 없으므로 실제 삭제 없음.
|
||||||
|
- 공유 member login/JWT/MemberRole.BOT, Agora HMAC, 텍스트 TranslationJob/worker, S3Uploader와 기존 MediaConvert 관련 외부 코드/설정은 보존 대상이다.
|
||||||
|
- 기존 MediaConvert 완료 API의 ADMIN/BOT 권한은 유지한다. 새 원본 UUID에 대한 source-bound 경로 검증과 기존 파일 검증을 구분한다. 실제 consumer ID 추출·출력 규칙 호환성은 운영 확인 전 배포 BLOCKED다.
|
||||||
|
- Flyway/Liquibase 의존성 및 자막 migration은 현재 프로젝트에서 발견되지 않았다. 운영/공유 환경의 적용 schema/data 상태는 조회하지 않았다. additive SQL 문서만 준비하며 DB에는 적용하지 않는다.
|
||||||
|
|
||||||
|
## Lambda와 운영 전환
|
||||||
|
|
||||||
|
명시된 `aws-subtitle-service/docs/FINAL_REPORT.md`와 실제 로컬 ZIP을 대조했다.
|
||||||
|
|
||||||
|
| 산출물 | SHA-256 |
|
||||||
|
|---|---|
|
||||||
|
| `start-subtitle-transcription.zip` | `a0d0b19b2ecb24c0f89caf528bf09fd039558563a99063f082ac64418704abfd` |
|
||||||
|
| `generate-subtitle.zip` | `bfa8742ca436bace853ec2540fc5f70daa24cbab49e75315565d980189fbf209` |
|
||||||
|
|
||||||
|
파일 hash 일치는 AWS 배포 증거가 아니다. 운영 legacy consumer/caller/in-flight/Scheduler/배포 버전은 미확인이다. AWS 호출·설정·배포·중지·삭제·재개를 수행하지 않았다. 운영자는 inventory 후 실제 가동 중인 경우에만 pause/drain하고 Phase 1 backend/Lambda를 조정 배포해야 한다. S3/DB purge나 legacy fake work API는 금지한다.
|
||||||
|
|
||||||
|
## 실행 기록
|
||||||
|
|
||||||
|
| 시점 | 명령/검증 | 관찰 결과 |
|
||||||
|
|---|---|---|
|
||||||
|
| 테스트 범위 변경 지시 전 | 기존 `AudioContentServiceTest`, `MemberLoginResponseContractTest`, `TokenProviderTest` focused baseline | 부모 실행은 kapt 단계 200초 제한 종료, 테스트 판정 없음 |
|
||||||
|
| 테스트 범위 변경 지시 전 | 구현 담당자의 격리 focused 시도 | `red-focused.log`: 41 cases 중 새 사례의 JWT key setup 1건 실패. 기능 RED로 인정하지 않음. 기존 테스트 실행은 이후 중단 |
|
||||||
|
| RED | 새 `SubtitleHttpIntegrationTest.shouldRejectActualNonBotLoginJwt` | `red-http.log`: 실제 로그인한 non-BOT의 자막 접근 차단 실패를 재현. 최종 GREEN 아님 |
|
||||||
|
| 1차 새 테스트/HTTP | 부모가 신규 `SubtitleHttpIntegrationTest` 직접 재실행 | **13 passed, failures/errors/skipped 0**. XML timestamp `2026-11-10T14:33:59`, `BUILD SUCCESSFUL in 2m 21s` |
|
||||||
|
| bootJar/변경 범위 lint | 구현 담당 실제 실행 및 부모 같은 코드 재확인 | `build-lint.log`: `BUILD SUCCESSFUL in 1m 28s`; 부모 재확인은 UP-TO-DATE |
|
||||||
|
| 리뷰 수정 RED | 신규 HTTP 2개 | 빈 body 422 기대/200 실제, DB 실패 500 기대/200 실제 확인 |
|
||||||
|
| 최종 새 테스트/빌드/lint | `P1-R1` 수정 후 신규 자막 클래스 전체 | **15 passed, failures/errors/skipped 0**, bootJar/변경 lint 실제 실행 성공, 7m44s |
|
||||||
|
| 부모 최종 HTTP 재검증 | 추가된 새 2개 메서드만 직접 실행 | **2 passed**, 422/500 및 전체 rollback 확인. XML timestamp `2026-11-10T15:34:43`, 4m55s |
|
||||||
|
| 독립 리뷰 | 1차 REQUEST_CHANGES 1건 수정 후 delta 재검토 | **REV-P1-001 ADDRESSED / 로컬 backend APPROVE**, 추가 blocker 없음 |
|
||||||
|
|
||||||
|
테스트 fixture는 로컬 합성 데이터와 H2, 실제 localhost HTTP, 외부 S3/서명 경계 대체를 사용한다. 실제 음성 또는 live S3 품질 검증이 아니다. LSP diagnostics 도구가 제공되지 않아 실제 Kotlin compile/lint 결과를 대체 증거로 기록했으며 LSP 성공을 주장하지 않는다.
|
||||||
|
|
||||||
|
실제 검증한 HTTP 결과: BOT 허용 및 non-BOT 403/익명 401, unknown 404, callback 수락/replay 200,
|
||||||
|
같은 eventId의 변경 body 422, terminal 다른 결과 409, 동시 receipt 경합 200/422 및 loser rollback.
|
||||||
|
기존 콘텐츠 상세에서 preview-only의 자막 null, 구매/소유자/무료 및 공개 시점별 ko/ja 선택을 검증했다.
|
||||||
|
동일 job 결과는 언어별 행 ID를 보존하며, 이전 job 완료가 최신 선택값을 바꾸지 않는 것을 확인했다.
|
||||||
|
|
||||||
|
실제 HTTP 증거는 테스트 JVM PID `23390`, Tomcat `127.0.0.1:59074`, XML timestamp
|
||||||
|
`2026-11-10T14:33:59`다. 실행 후 `ps -p 23390,20950,22207`, `lsof -iTCP:59074 -sTCP:LISTEN`,
|
||||||
|
작업 root를 대상으로 한 `pgrep`에서 남은 프로세스/listener가 없음을 확인했다. 임시 산출물은 리뷰 후 정리했다.
|
||||||
|
|
||||||
|
후속 HTTP 검증은 PID `44707`, Tomcat port `59977`에서 실행했다. 빈 callback/started는 422이고,
|
||||||
|
receipt 저장 실패는 `{"error":"Subtitle request failed"}`와 500을 반환하며 상태/오류/결과/receipt가 rollback된다.
|
||||||
|
구현 담당의 첫 GREEN은 컴파일 600초 제한으로 종료됐으나 캐시 재사용 후 성공했다. 실패 이력은 삭제하지 않았다.
|
||||||
|
후속 PID `44707`/`28638`/`37727`/`39291`, port `59977`, 작업 root 참조 프로세스의 부재도 확인했다.
|
||||||
|
|
||||||
|
## 내부 API와 저장 구조
|
||||||
|
|
||||||
|
| Method | Path |
|
||||||
|
|---|---|
|
||||||
|
| GET | `/internal/api/subtitle-jobs/resolve` |
|
||||||
|
| GET | `/internal/api/subtitle-jobs/{jobId}` |
|
||||||
|
| POST | `/internal/api/subtitle-jobs/{jobId}/started` |
|
||||||
|
| POST | `/internal/api/subtitle-jobs/callback` |
|
||||||
|
|
||||||
|
네 API는 기존 로그인 JWT와 활성 DB BOT role을 요구한다. 조회는 최소 DTO이며 callback은 원문 bytes hash를 사용한다.
|
||||||
|
`subtitle_job`, 언어별 `subtitle`, `subtitle_callback_receipt`와 `content.latest_subtitle_job_id`의
|
||||||
|
additive SQL만 작성했다. 실제 DB 적용은 하지 않았다. 미래 언어는 결과 행으로 저장할 수 있지만
|
||||||
|
현재 허용 언어는 ko/ja뿐이고 향후 Lambda·API·조회 정책 변경 없이 새 언어가 자동 활성화되지는 않는다.
|
||||||
|
|
||||||
|
공유 로그인/JWT/업로드/MediaConvert는 보존했다. 현재 저장소에는 삭제할 자막 recovery code가 없어서 삭제 파일은 0개다.
|
||||||
|
외부 프로젝트, AWS 리소스, 적용 migration 및 운영 데이터는 변경하지 않았다. commit/push도 수행하지 않았다.
|
||||||
|
|
||||||
|
전체 변경 경로·신규 case 이름·재현 명령·실패/수정 이력은 [implementation-report.md](implementation-report.md)에 있다.
|
||||||
|
로컬 mapping의 업로드 오류 시각 TIMESTAMP 불일치는 수정·대조했으나 운영 MySQL 실행 증거는 아니다.
|
||||||
|
테스트 전체 Spring context에서 기존 worker의 H2/MySQL 구문 차이 로그가 발생했다. 해당 worker 성공을 주장하지 않는다.
|
||||||
|
|
||||||
|
## 외부 차단 항목
|
||||||
|
|
||||||
|
| 항목 | 상태와 재개 조건 |
|
||||||
|
|---|---|
|
||||||
|
| 운영 DB | BLOCKED: 기존 schema 확인 및 additive DDL 승인·적용 필요 |
|
||||||
|
| old consumer coordination | BLOCKED: 원격 배포/사용/in-flight 조사와 운영자 조정 필요 |
|
||||||
|
| MediaConvert/CloudFront | BLOCKED: UUID ID 추출·출력 key 규칙 및 자막 private origin/서명 접근 확인 필요 |
|
||||||
|
| live ko/ja/mixed | BLOCKED: 승인된 실제 S3 입력부터 callback/콘텐츠/앱 표시 검증 필요. mixed는 실제 word/item 언어 evidence 필수 |
|
||||||
|
| 2시간 입력 목표 | BLOCKED: 실제 처리 시간/예산 미측정. 상한을 내리거나 SLA/지원 성공을 주장하지 않음 |
|
||||||
|
|
||||||
|
전체 테스트는 실행하지 않는다. 사용자가 별도로 전체 검증을 원하면 `./gradlew test`를 실행할 수 있다. 기존 회귀 미실행에 따른 잔여 위험은 새 기능 테스트 성공과 구분한다.
|
||||||
|
|
||||||
|
## 종료 정리와 재현
|
||||||
|
|
||||||
|
2026-11-11 리뷰 승인 후 이번 작업 소유 임시 root `subtitle-phase1.wiRcAJ`와 그 안의 build/cache/log/JAR를 제거했다.
|
||||||
|
`test ! -e` exit0으로 부재를 확인했고 공유 캐시·기존 worker는 변경하지 않았다. 위 임시 경로는 과거 검증 위치이며,
|
||||||
|
검증 결과와 실패 이력은 이 문서 및 구현/리뷰 보고서에 보존했다.
|
||||||
|
|
||||||
|
정상 개발 환경에서 이번에 작성한 테스트만 다시 실행하는 명령:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
## 후속 완료: generate-url 자막 응답
|
||||||
|
|
||||||
|
2026-11-11 요청에 따라 `GET /audio-content/{id}/generate-url`에도 상세와 동일한 nullable `subtitle`을 추가했다.
|
||||||
|
기존 `contentUrl`과 활성 구매 검사/음원 URL 동작은 유지하며 자막만 요청 언어·완료 상태·공개 시점 조건을 따른다.
|
||||||
|
이번 후속에서 새로 작성한 HTTP3개만 실행했고 부모 재실행도 3/0/0/0으로 통과했다. 독립 리뷰 APPROVE다.
|
||||||
|
컴파일/bootJar/테스트 lint는 성공했으나 production lint는 시작 전부터 있던 서비스 EOF 공백1건을 지적해 보존했다.
|
||||||
|
이 결과를 기존15개를 포함한 클래스 전체 재실행 성공으로 표현하지 않는다.
|
||||||
|
상세 명령/선택자/응답 예시/잔여 게이트는 [generate-url-report.md](generate-url-report.md)에 있다.
|
||||||
|
|
||||||
|
## 후속 회귀: s3 컬럼 schema-validation
|
||||||
|
|
||||||
|
2026-11-11 실제 기동의 missing `[s3bucket]` 오류를 독립 H2 table과 Hibernate `validate`로 재현했다.
|
||||||
|
기본 명명전략이 숫자 경계를 분리하지 않는 것을 기존 정적 대조와 create-drop 테스트가 놓친 문제다.
|
||||||
|
`Subtitle`의 두 Column 이름만 `s3_bucket`, `s3_key`로 명시했고 DDL/운영 DB/JSON 계약은 바꾸지 않았다.
|
||||||
|
신규 회귀 테스트1개에서 validation과 Hibernate/JDBC 저장·재조회가 통과했으며 bootJar/변경 lint 및 독립 리뷰 APPROVE다.
|
||||||
|
실제 운영 MySQL 재기동은 수행하지 않았다. 상세 원인·검증은 [schema-validation-report.md](schema-validation-report.md)에 기록했다.
|
||||||
|
|
||||||
|
## 커밋 검증 후속 기록
|
||||||
|
|
||||||
|
2026-11-11 별도 사용자 `/commit-with-validation` 요청으로 변경을 커밋했다.
|
||||||
|
기능 연동 커밋은 pre-commit `ktlintCheck`에서 위에 기록된 서비스 EOF 빈 줄 1건으로 처음 거부됐다.
|
||||||
|
해당 빈 줄만 제거한 뒤 재시도하여 staged Kotlin 대상 lint, `git diff --staged --check` 및
|
||||||
|
`work/scripts/check-commit-message-rules.sh`의 커밋 직전·직후 검증이 통과했다.
|
||||||
|
기존 EOF 미해결 기록은 당시 상태이며 이 커밋 준비 과정에서 해소됐다.
|
||||||
|
|
||||||
|
이번 커밋 작업에서는 기능 테스트·전체 테스트·bootJar를 재실행하지 않았다.
|
||||||
|
기존 테스트 결과는 위 실행 시점의 기록이며 운영 배포 BLOCKED는 유지한다.
|
||||||
|
사용자가 전체 테스트를 실행할 때의 명령은 `./gradlew test`다.
|
||||||
@@ -0,0 +1,101 @@
|
|||||||
|
# generate-url 자막 후속 구현 검증
|
||||||
|
|
||||||
|
## 범위와 결과
|
||||||
|
|
||||||
|
- 기준: `prd.md` §7, `plan-task.md` `P2-T1`. Phase 1은 재구현하지 않았다.
|
||||||
|
- 이번 production 변경은 `content/GenerateUrlResponse.kt`의 기존 DTO import/nullable 필드 추가와 `content/AudioContentService.kt`의 `generateUrl` 본문뿐이다. DTO는 `GenerateUrlResponse(contentUrl: String, subtitle: ContentSubtitleResponse? = null)`이다.
|
||||||
|
- 기존 `orderRepository.isExistOrdered`를 그대로 사용한다. 구매 없는 소유자/무료, 비활성 KEEP, 만료 RENTAL은 빈 `contentUrl`과 명시적 null `subtitle`이다. 활성 구매의 기존 음원 경로/만료 기간/envelope는 유지했다.
|
||||||
|
- 구매자는 하나의 `expirationTime`을 음원 서명과 `SubtitleJobService.subtitle(audioContent, langContext.lang, expirationTime)`에 전달한다. 자막만 미지정/도래한 공개일 또는 소유자 조건을 적용한다. 예약 구매자의 기존 음원 URL은 유지한다.
|
||||||
|
- 기존 `SubtitleHttpIntegrationTest`의 15개 메서드/도우미를 보존하고 HTTP 테스트 3개와 세 테스트가 공용으로 사용하는 요청 도우미 1개만 추가했다. 다른 dirty 파일, PRD/plan/final-report, controller/DB/Lambda는 수정하지 않았다.
|
||||||
|
|
||||||
|
## 새 HTTP 테스트
|
||||||
|
|
||||||
|
클래스: `kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest`. 실행은 아래 세 메서드 selector만 사용했다.
|
||||||
|
|
||||||
|
1. `shouldIncludeRequestedSubtitleInGenerateUrl`: 활성 KEEP 구매/공개 완료 ko·ja, 정확한 `{contentUrl,subtitle}` 및 자막 3필드, 상세와 동일한 자막, 음원/SRT 경로와 같은 14,400,000ms 서명 인자, 기존 success envelope.
|
||||||
|
2. `shouldReturnNullSubtitleInGenerateUrlWhenUnavailable`: PENDING/최신 job 미등록/부분 완료 ko 누락/미지원 en의 명시적 null과 음원 URL 보존, 부분 완료 ja 정상 제공.
|
||||||
|
3. `shouldPreserveGenerateUrlPurchaseAndReleaseRestrictions`: 미구매자·소유자·무료 및 비활성/만료 주문 차단, 활성 RENTAL 구매자의 예약 음원 URL 보존/자막 차단, 활성 구매 소유자의 예약 예외, 공개일 null/과거 허용, 익명 401.
|
||||||
|
|
||||||
|
실제 EMAIL 로그인/JWT, RANDOM_PORT Tomcat HTTP, H2와 기존 fixture/callback 도우미를 사용했다. 외부 S3/CloudFront 경계만 기존 mock을 재사용했다. 서명 URL은 전달 경로/만료 인자 검증이며 실제 CloudFront 암호학적 서명이나 다운로드 검증은 아니다.
|
||||||
|
|
||||||
|
## 명령과 증거
|
||||||
|
|
||||||
|
소유 root는 아래 `VERIFY_ROOT`다. build/project-cache/TMPDIR/Node/Bun 캐시를 격리했으며 init script는 production 소스를 필터링하지 않는다. 테스트 compile만 이 클래스와 필요한 support 3파일로 한정한다. `test.outputs.upToDateWhen { false }`로 실제 실행을 강제한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export VERIFY_ROOT=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/generate-url-subtitle.fSBkJM/implementer
|
||||||
|
export TMPDIR="$VERIFY_ROOT/tmp" NODE_COMPILE_CACHE="$VERIFY_ROOT/node-cache"
|
||||||
|
export npm_config_cache="$VERIFY_ROOT/node-cache" BUN_INSTALL_CACHE_DIR="$VERIFY_ROOT/bun-cache"
|
||||||
|
export AWS_EC2_METADATA_DISABLED=true
|
||||||
|
G=(./gradlew --offline --no-daemon --max-workers=2
|
||||||
|
-Pkotlin.compiler.execution.strategy=in-process -Dorg.gradle.jvmargs=-Xmx4g
|
||||||
|
--project-cache-dir "$VERIFY_ROOT/project-cache"
|
||||||
|
--init-script "$VERIFY_ROOT/verification.init.gradle")
|
||||||
|
S=(--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldIncludeRequestedSubtitleInGenerateUrl'
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldReturnNullSubtitleInGenerateUrlWhenUnavailable'
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldPreserveGenerateUrlPurchaseAndReleaseRestrictions')
|
||||||
|
|
||||||
|
# RED: production 변경 전
|
||||||
|
"${G[@]}" test "${S[@]}" > "$VERIFY_ROOT/red-assertions.log" 2>&1
|
||||||
|
# 첫 GREEN
|
||||||
|
"${G[@]}" test "${S[@]}" ktlintCheck bootJar > "$VERIFY_ROOT/green-build-lint.log" 2>&1
|
||||||
|
# 입력 3파일을 고정/확인한 production+test lint
|
||||||
|
"${G[@]}" verifyLintScope ktlintCheck bootJar > "$VERIFY_ROOT/final-verified-scope-lint-build.log" 2>&1
|
||||||
|
# 기존 dirty EOF 보존 후 최종 HTTP/컴파일/테스트 lint/bootJar
|
||||||
|
"${G[@]}" test "${S[@]}" verifyLintScope ktlintTestSourceSetCheck bootJar > "$VERIFY_ROOT/final-green-build-test-lint.log" 2>&1
|
||||||
|
```
|
||||||
|
|
||||||
|
| 검증 | 결과/증거 |
|
||||||
|
|---|---|
|
||||||
|
| RED | exit 1, 50초, 3 tests/3 failures/0 errors/0 skipped. 모두 `has("subtitle")`에서 expected true/actual false. `red-assertions.log`, `red-summary.log` |
|
||||||
|
| 첫 GREEN | exit 0, `BUILD SUCCESSFUL in 3m 35s`, HTTP 3개 통과 및 compile/bootJar. lint의 정확한 입력 증거는 이후 고정한 실행을 기준으로 한다. |
|
||||||
|
| 정확한 변경 lint | 입력은 production 2파일+이 테스트 1파일, Kotlin script 0개임을 `verifyLintScope` assertion으로 확인. production lint는 **기존 EOF 빈 줄 1건 실패**: `AudioContentService.kt:1482:1 Needless blank line(s)`. 그 외 지적 없음. `final-verified-scope-lint-build.log` |
|
||||||
|
| 최종 GREEN | exit 0, `BUILD SUCCESSFUL in 3m 30s`, compileKotlin/compileTestKotlin/bootJar 실제 실행, 테스트 lint 통과. HTTP XML 3 tests/0 failures/0 errors/0 skipped, timestamp `2026-11-10T22:07:38` (UTC). `final-green-build-test-lint.log`, `green-summary.log` |
|
||||||
|
|
||||||
|
최초 임시 init의 상대 source 경로로 `test NO-SOURCE`가 된 `red.log`는 RED 증거가 아니다. `project.file`로 수정 후 실제 assertion RED를 확인했다. `final-scope-lint-build.log`도 lint scope introspection assertion 실패 기록이며 HTTP 실패가 아니다. 이후 init에서 lint 입력 파일을 명시적으로 고정하고 검증했다. 이 이력과 로그를 삭제하지 않았다.
|
||||||
|
|
||||||
|
## 보존 사항과 남은 게이트
|
||||||
|
|
||||||
|
- 시작 전 `git diff`에도 있던 서비스 EOF 빈 줄은 타 dirty 변경 보존 지시에 따라 유지했다. `git diff --check` 역시 같은 EOF 1건을 지적하므로 lint 전체 clean을 주장하지 않는다. 테스트/새 DTO lint 오류는 없다.
|
||||||
|
- LSP 도구는 제공되지 않았다. Kotlin compile과 실제 3파일 ktlint 결과로 대체했다. 기존 Kotlin 경고와 테스트 종료 중 Redis reconnect 경고가 있으나 새 테스트 실패/오류는 없다.
|
||||||
|
- 기존 15개 테스트/기타 기존 테스트/전체 test/check/build는 실행하지 않았다. 사용자 전체 테스트 명령은 `./gradlew test`이며 이번 승인된 자동 검증 범위 밖이다.
|
||||||
|
- RED PID 14462/HTTP 50806, 첫 GREEN PID 15417/HTTP 50833, 최종 GREEN PID 16741/HTTP 50879는 테스트 종료로 정상 종료했다. 세 PID와 HTTP/Redis port 50806/50833/50879/50803/50831/50877에 `ps`/`lsof` 조회 결과가 없었다. 공유 프로세스를 종료하거나 task 취소를 호출하지 않았다. 부모 재검증을 위해 소유 root/init/log/JAR는 남겼다.
|
||||||
|
- AWS/외부 저장소/운영 DB/배포/live ko·ja·mixed/2h 처리/앱/실제 CloudFront 다운로드는 미검증이다. 부모 재검증과 독립 리뷰도 이 보고서의 완료 주장에 포함하지 않는다. credential/JWT/request body는 로그/보고서에 출력하지 않았으며 최종 XML과 로그의 관련 패턴 검색 결과도 없었다.
|
||||||
|
|
||||||
|
## 부모 재검증
|
||||||
|
|
||||||
|
- 같은 격리 init 및 정확히 새 메서드 3개 selector로 직접 재실행했다. `parent-verification.log`의 결과는 exit0,
|
||||||
|
`BUILD SUCCESSFUL in 37s`이며 test는 실제 실행, bootJar/테스트 lint는 동일 코드의 UP-TO-DATE 확인이다.
|
||||||
|
- XML: 3 tests/0 failures/0 errors/0 skipped, UTC timestamp `2026-11-10T22:12:51`. 실제 Tomcat PID17759, HTTP port50914다.
|
||||||
|
- 부모가 DTO·generateUrl의 전후 diff 및 추가 테스트 전체를 읽었다. 공유 자막 조회와 기존 구매 판정·음원 URL이 유지된다.
|
||||||
|
- 독립 리뷰와 임시 자원 정리는 아래 후속 기록으로 남긴다. 기존 production EOF lint1건은 성공으로 덮어쓰지 않는다.
|
||||||
|
|
||||||
|
## 독립 리뷰 및 사용 계약
|
||||||
|
|
||||||
|
- 제한 독립 리뷰 `ses_e387b1e8fffensjb6dnoRk82ST`: **APPROVE**. 이번 production delta의 명세·품질 blocker나 새 회귀 없음.
|
||||||
|
- `data.contentUrl`과 기존 envelope는 유지하며 `data.subtitle`만 추가된다. 요청 언어는 기존 `Accept-Language`/`LangContext`를 따른다.
|
||||||
|
- 자막 응답 예시:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"contentUrl": "https://cdn.example.com/audio-signed-url",
|
||||||
|
"subtitle": {
|
||||||
|
"language": "ko-KR",
|
||||||
|
"format": "SRT",
|
||||||
|
"url": "https://cdn.example.com/subtitle-signed-url"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- 구매/공개 조건을 충족하지 못하거나 미완료·해당 언어 자막이 없으면 `subtitle`은 명시적 null이다. 기존 URL 권한을 확대하지 않는다.
|
||||||
|
- 부모 HTTP PID17759 및 자식 PID14462/15417/16741, port50914, 소유 root 참조 프로세스는 `ps`/`lsof`/`pgrep`에서 부재를 확인했다.
|
||||||
|
- 리뷰 승인/결과 문서 보존 후 작업 소유 root `generate-url-subtitle.fSBkJM`과 하위 build/cache/log/JAR를 제거했고 `test ! -e` exit0으로 확인했다. 위 임시 log/init 경로는 과거 검증 위치이며 공유 캐시는 건드리지 않았다.
|
||||||
|
|
||||||
|
일반 개발 환경에서 이번 후속 테스트만 실행하는 명령:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldIncludeRequestedSubtitleInGenerateUrl' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldReturnNullSubtitleInGenerateUrlWhenUnavailable' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldPreserveGenerateUrlPurchaseAndReleaseRestrictions'
|
||||||
|
```
|
||||||
@@ -0,0 +1,192 @@
|
|||||||
|
# 자막 Phase 1 Kotlin 구현 보고
|
||||||
|
|
||||||
|
## 결과와 검증 경계
|
||||||
|
|
||||||
|
- 재생성을 제외한 기존 업로드 등록, 네 BOT 내부 API, callback 원자 저장, 기존 콘텐츠 상세의 권한별 ko/ja 자막 조회를 구현했다.
|
||||||
|
- 새로 작성한 `SubtitleHttpIntegrationTest` 13개는 실제 RANDOM_PORT localhost HTTP/H2에서 전부 통과했다. 외부 AWS 클라이언트와 서명 URL 생성만 대체하고, 회원 서비스·로그인·비밀번호 검증·JWT·DB principal/role은 실제 경로를 사용했다.
|
||||||
|
- `bootJar`와 변경 Kotlin 파일에 한정한 `ktlintCheck`가 성공했다. LSP 도구는 제공되지 않아 실행하지 않았으며 실제 Kotlin/JPA 생성 코드·테스트 컴파일과 lint로 대체했다.
|
||||||
|
- PRD/계획과 SQL/deployment 문서는 병렬 담당자 소유다. 이 담당자는 해당 문서를 수정하지 않았으며 전체 Phase gate/독립 리뷰 완료를 대신 선언하지 않는다.
|
||||||
|
|
||||||
|
## 구현 선택
|
||||||
|
|
||||||
|
1. `AudioContentService.createAudioContent` 두 overload와 AI 관리자 create orchestration은 `NOT_SUPPORTED`다. 필수 주입된 transaction manager의 `TransactionTemplate(REQUIRES_NEW)`가 content·tags·cover·source/job·latest pointer를 commit한 뒤 원본 S3 업로드를 시작한다. 업로드 후 content의 input 경로를 다시 대입하지 않으므로 조기 MediaConvert 완료 경로를 되돌리지 않는다. 성공 후 기존 언어 이벤트는 별도의 짧은 실제 쓰기 트랜잭션에서 발행한다.
|
||||||
|
2. 원본은 `input/{contentId}/{canonical UUID}.{safe actual extension}`이다. multipart filename의 경로는 버리고 영문/숫자 1~16자리 실제 확장자만 소문자로 보존한다. 예를 들어 `C:\client\dir/file.MP3`는 UUID `.mp3`로 등록된다. 확장자가 없거나 안전하게 보존할 수 없으면 UUID만 사용한다. 업로드 자체를 새로 거부하거나 `.mp3`로 허위 변경하지 않는다. 확장자는 형식 hint일 뿐 실제 오디오 검증 증거가 아니다.
|
||||||
|
3. `SubtitleJob.outputKey`는 확장자를 제외한 `output/{contentId}/{same UUID}` stem이다. 새 등록의 upload-complete는 이 정확한 stem과 `aac`/`m4a`/`mp3` 확장자 조합만 수락한다. 다른 콘텐츠, 다른 UUID, 추가 suffix, 임의 디렉터리, 비오디오 확장자는 거부한다. source가 없는 기존 콘텐츠의 동작은 기존 prefix 검증을 유지한다. 실제 consumer의 basename·ID 추출 호환성은 여전히 배포 전 확인 대상이다.
|
||||||
|
4. 언어 결과는 `Subtitle` 행에 저장한다. `jobId` scalar와 `unique(job_id, language)`, 실제 `language`·`format`·`s3Bucket`·`s3Key`를 보존한다. callback 허용 언어는 여전히 ko-KR/ja-JP이며 상태 규칙은 2/1/0개 그대로다. 미래 언어 활성화/새 provider framework는 추가하지 않았다.
|
||||||
|
5. callback은 원래 HTTP `ByteArray` SHA-256을 receipt와 함께 저장한다. `REQUIRES_NEW`/`READ_COMMITTED`에서 receipt를 먼저 조회하고 job lock 뒤 다시 조회한다. 기존 eventId로 unknown job을 보낸 변경 body도 422다. receipt는 JPA `Persistable.isNew=true`로 insert하여 merge가 경합한 다른 receipt를 update하지 못하게 했다. unique 경합은 rollback 종료 후 새 트랜잭션에서 receipt를 읽어 200/422를 판정한다. terminal의 동일 결과는 행 ID를 보존하고, 다른 결과는 409다.
|
||||||
|
|
||||||
|
## 변경 경로
|
||||||
|
|
||||||
|
### 신규 production
|
||||||
|
|
||||||
|
```text
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/domain/SubtitleJobStatus.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/dto/SubtitleJobDtos.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/SubtitleJob.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/SubtitleJobRepository.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/Subtitle.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/SubtitleRepository.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/SubtitleCallbackReceipt.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/SubtitleCallbackReceiptRepository.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/application/SubtitleJobService.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/web/SubtitleJobController.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/web/SubtitleRequestParser.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/web/SubtitleExceptionHandler.kt
|
||||||
|
```
|
||||||
|
|
||||||
|
### 기존 production 연결
|
||||||
|
|
||||||
|
```text
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/configs/SecurityConfig.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContent.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/content/GetAudioContentDetailResponse.kt
|
||||||
|
src/main/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentFacade.kt
|
||||||
|
```
|
||||||
|
|
||||||
|
### 테스트와 보고
|
||||||
|
|
||||||
|
```text
|
||||||
|
src/test/kotlin/kr/co/vividnext/sodalive/v2/subtitle/SubtitleHttpIntegrationTest.kt
|
||||||
|
src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt
|
||||||
|
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentCreateTest.kt
|
||||||
|
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/LegacyCreatorAdminAudioContentCharacterizationTest.kt
|
||||||
|
docs/20261110_자막Phase1연동/implementation-report.md
|
||||||
|
```
|
||||||
|
|
||||||
|
- 기존 수동 `AudioContentService` 생성자는 필수 자막 서비스/transaction manager 인자를 반영했다.
|
||||||
|
- 기존 생성 통합 테스트의 성공 fixture는 등록 전에 실제 commit되도록 조정했다. audio 업로드/후속 이벤트 실패 테스트는 이미 commit된 등록을 보존한다는 새 승인 계약에 맞췄다. 실패 테스트를 삭제하거나 성공 assertion을 느슨하게 하지 않았다.
|
||||||
|
- 이 기존 테스트들은 후속 사용자 지시 이후 **실행하지 않았다**. 관련 기존 5개 클래스는 새 테스트 실행의 컴파일 입력에 포함했지만 실행 selector는 신규 자막 패키지뿐이다.
|
||||||
|
- production 파일 삭제, 기존 JWT/member/텍스트 TranslationJob worker 변경, 외부 프로젝트 변경, 신규 AWS SDK 의존성, 재생성 API/START 호출은 없다.
|
||||||
|
|
||||||
|
## 새 테스트 selector
|
||||||
|
|
||||||
|
전체 신규 클래스만 실행하는 selector:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
개별 selector는 아래 클래스명 뒤에 각 메서드를 붙인다. 모두 이번 작업에서 새로 작성한 case다.
|
||||||
|
|
||||||
|
```text
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldRejectActualNonBotLoginJwt
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldUseRealBotJwtAndStoreCallbackBeforeStartedWithExactByteReplay
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldStartMonotonicallyAndAcceptPartialAndFailedResults
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldReturn404WithoutDiscoveryAndCheckCurrentDatabaseRole
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldRejectMalformedContractsWithoutPersistingAnything
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldSerializeConcurrentCallbacksAndRollbackLosingJob
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldRollbackResultsAndStatusWhenReceiptInsertFails
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldKeepLatestPointerWhenOlderJobCompletes
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldCommitRegistrationBeforeUploadAndNeverRevertEarlyMediaConvertOutput
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldKeepAcceptedSourceAndTerminalResultWhenUploadReturnFails
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldPreserveOnlySafeActualSourceExtensionsWithoutClaimingConversion
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldExposeLanguageSubtitleOnlyWithReleasedOriginalAccessInExistingDetail
|
||||||
|
kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldReadOnlyPersistedLanguageOfMatchingLatestCompletedJob
|
||||||
|
```
|
||||||
|
|
||||||
|
## 재현 명령과 아티팩트
|
||||||
|
|
||||||
|
작업 전용 root는 삭제하지 않고 부모 검증에 인계한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ROOT=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/subtitle-phase1.wiRcAJ/backend.HX0j0B
|
||||||
|
export TMPDIR="$ROOT"
|
||||||
|
export NODE_COMPILE_CACHE="$ROOT/node"
|
||||||
|
export BUN_RUNTIME_TRANSPILER_CACHE_PATH="$ROOT/bun"
|
||||||
|
|
||||||
|
./gradlew --no-daemon --max-workers=2 \
|
||||||
|
-Pkotlin.compiler.execution.strategy=in-process -Dorg.gradle.jvmargs=-Xmx4g \
|
||||||
|
--project-cache-dir "$ROOT/gradle-cache" -I "$ROOT/isolation.gradle" \
|
||||||
|
test --tests 'kr.co.vividnext.sodalive.v2.subtitle.*'
|
||||||
|
|
||||||
|
./gradlew --no-daemon --max-workers=2 \
|
||||||
|
-Pkotlin.compiler.execution.strategy=in-process -Dorg.gradle.jvmargs=-Xmx4g \
|
||||||
|
--project-cache-dir "$ROOT/gradle-cache" -I "$ROOT/isolation.gradle" \
|
||||||
|
bootJar ktlintCheck
|
||||||
|
```
|
||||||
|
|
||||||
|
- 임시 init script는 build 출력과 Gradle project cache를 공유 출력에서 격리한다. 테스트 Kotlin 컴파일 입력은 신규 자막/직접 영향 기존 5개 클래스/support이며, lint filter도 변경 Kotlin 파일만 대상으로 한다. 전역 설정이나 저장소 build 설정은 변경하지 않았다.
|
||||||
|
- 성공 테스트: `$ROOT/green-new-tests-cached.log`, `BUILD SUCCESSFUL in 1m 32s`. 임시 script의 사용하지 않는 JWT 기본값을 제거한 뒤 다시 실행한 최종 `$ROOT/final-new-tests.log`도 `BUILD SUCCESSFUL in 2m 25s`다. XML: `$ROOT/build/test-results/test/TEST-kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.xml`, `tests=13`, `failures=0`, `errors=0`, `skipped=0`.
|
||||||
|
- 실제 두 job의 동일 eventId 경합에서 H2 SQLState `23505` unique 위반이 관찰됐고, 최종 HTTP 200/422와 loser job의 PENDING/결과 행 없음 assertion이 통과했다. 별도의 receipt 쓰기 실패 주입에서도 identity 생성으로 flush된 결과 행까지 rollback됨을 확인했다.
|
||||||
|
- 성공 빌드/lint: `$ROOT/build-lint.log`, `BUILD SUCCESSFUL in 1m 28s`. 실행 가능한 boot JAR은 `$ROOT/build/libs/sodalive-0.0.1-SNAPSHOT.jar`다. `jar tf`에서 새 컨트롤러/서비스/엔티티/repository/DTO가 `BOOT-INF/classes`에 포함된 것을 확인했다.
|
||||||
|
- 검증 완료 후 root를 참조하는 작업 소유 Gradle/HTTP/Redis 프로세스는 관찰되지 않았다. 기존 공유 worker PID `55393`과 그 Redis PID `55452`는 이 작업 소유가 아니며 종료하지 않았다. 테스트 실행 중 관찰된 작업 소유 executor PID `20950`과 최종 executor PID `22207`은 종료됐다.
|
||||||
|
|
||||||
|
## RED와 실패 이력
|
||||||
|
|
||||||
|
- 첫 baseline/신규 RED 명령은 테스트 컴파일 중 600초 제한으로 종료됐다(`red.log`). 테스트 결과가 아니며 RED로 인정하지 않았다.
|
||||||
|
- `red-focused.log`는 이전 지시에 따른 기존 3개 회귀 클래스와 신규 1개 case 실행이다. 총 41개 중 1개가 테스트 JWT key setup에서 실패했다. 이를 기능 RED로 인정하지 않았다. 이 명령은 기존 테스트 실행 금지라는 후속 사용자 지시 전의 기록이며 현재 구현의 회귀 성공 증거로 사용하지 않는다.
|
||||||
|
- 테스트 전용 `DynamicPropertySource`로 유효 길이의 비운영 JWT key를 지정한 뒤 `red-http.log`에서 실제 로그인 성공 후 `403 기대 / 404 실제`를 확인했다. BOT 전용 경로가 없던 동작의 실제 RED다.
|
||||||
|
- 초기 `red-binding.log`는 JPA unique constraint의 logical/physical column 이름 오류로 context가 뜨지 못했다. 이를 RED로 인정하지 않고 엔티티에 명시적 column 이름을 붙였다.
|
||||||
|
- `red-binding-assertions.log`에서 새 두 case가 실제 assertion으로 실패했다: source 확장자 보존 실패, 기존 eventId의 unknown job 변경에 대해 `422 기대 / 404 실제`. 확장자 전달과 receipt 선조회/명시적 isolation 변경 후 같은 두 case를 포함한 13개 전체 신규 case가 GREEN이다.
|
||||||
|
- `green-first.log`는 사용자 지시 갱신을 위한 중단으로 완료 결과가 없다. `green-new-tests.log`는 compile을 통과한 뒤 test 시작 시점에 600초 도구 제한으로 종료됐다. 공유 프로세스를 종료하지 않고 같은 격리 경로의 캐시를 재사용한 `green-new-tests-cached.log`에서 완료 결과를 얻었다.
|
||||||
|
- `format.log`의 첫 변경 파일 format 실행은 길이 위반을 보고했다. 해당 새 줄만 정리한 뒤 최종 `ktlintCheck`가 통과했다.
|
||||||
|
|
||||||
|
## 외부 게이트와 남은 미검증
|
||||||
|
|
||||||
|
1. 실제 MediaConvert consumer가 기존 contentId filename prefix를 읽는지, UUID basename·출력 확장자·디렉터리를 어떻게 구성하는지 운영 증거가 없다. 로컬에서는 정확한 UUID stem과 AAC/M4A/MP3 경로 검증만 확인했다. consumer의 운영 호환성을 확인하기 전 배포 전환은 BLOCKED다.
|
||||||
|
2. 부모가 승인된 ZIP에서 확인한 Transcribe 지원 확장자는 amr/flac/m4a/mp3/mp4/ogg/webm/wav다. Spring은 AAC/opus 등 기존 업로드를 임의로 거부하지 않는다. 이들 또는 누락/불안전 확장자에 대한 자막 성공은 보장하지 않으며 Lambda의 명시적 unsupported 결과/수동 확인 대상이다. 테스트의 한 바이트 파일은 source binding/transaction fixture일 뿐 실제 미디어 증거가 아니다.
|
||||||
|
3. S3 putObject 수락 후 getUrl 실패는 성공으로 숨기지 않는다. 원래 예외를 호출자에게 전파하고 `SOURCE_UPLOAD_UNCERTAIN` 및 초 정밀도 TIMESTAMP를 별도 기록한다. 이미 완료된 자막 상태/metadata와 content를 삭제하거나 회귀시키지 않는다. 실제 객체/MediaConvert 상태는 운영자 수동 확인이 필요하다.
|
||||||
|
4. 운영 MySQL DDL 적용, case-sensitive/NO PAD collation 및 FK/인덱스 검증, private CloudFront origin과 실제 SRT 서명 접근, 실서버 권한/앱 표시, live ko/ja/mixed 및 실제 duration/2시간 처리 예산은 미검증이다. AWS 호출·배포·DB 적용은 수행하지 않았다.
|
||||||
|
5. 전체 테스트와 후속 지시 이후의 기존 회귀 case 실행은 수행하지 않았다. H2 전체 Spring context의 기존 charge/translation scheduler는 MySQL `FOR UPDATE SKIP LOCKED` 구문 때문에 로그 오류를 남겼다. 이번 신규 case는 모두 통과했지만 그 worker 기능의 성공 증거는 아니다. 사용자가 별도로 전체 테스트를 원할 때만 `./gradlew test`를 실행한다.
|
||||||
|
|
||||||
|
## 20261111 P1 후속 수정: body/DB 실패의 HTTP 200 오인 방지
|
||||||
|
|
||||||
|
### 수정 범위와 계약
|
||||||
|
|
||||||
|
- `SubtitleExceptionHandler.kt`의 기존 `SubtitleJobController` 전용 scope와 우선순위를 유지했다. `HttpMessageNotReadableException`은 HTTP 422와 기존 일반화된 거절 body로, 그 외 예상하지 못한 `Exception`은 HTTP 500과 `{"error":"Subtitle request failed"}`로 응답한다.
|
||||||
|
- 기존 `ResponseStatusException`의 404/409/422 처리는 변경하지 않았다. 공통 `SodaExceptionHandler`, JWT, 컨트롤러, 서비스 및 DB 저장 로직은 변경하지 않았으며 예외 원문·요청·토큰 로그도 추가하지 않았다.
|
||||||
|
- 수정 파일은 자막 advice, `SubtitleHttpIntegrationTest.kt` 및 이 보고서의 추가 기록뿐이다. 기존 직접 서비스 롤백 테스트 `shouldRollbackResultsAndStatusWhenReceiptInsertFails`와 기존 assertion은 그대로 보존했다. 부모 소유 PRD/계획/final-report는 수정하지 않았다.
|
||||||
|
|
||||||
|
### 새 HTTP 두 사례
|
||||||
|
|
||||||
|
1. `shouldRejectEmptyCallbackAndStartedBodiesWithoutPersistingAnything`: 실제 BOT 로그인/JWT로 빈 callback·started body를 모두 전송해 422를 확인한다. job/receipt/결과 행 수, PENDING 상태, 갱신 시각 및 오류 필드가 변경되지 않고 해당 job 결과도 없음을 검증한다.
|
||||||
|
2. `shouldReturn500AndRollbackWhenReceiptInsertFailsOverHttp`: 실제 HTTP callback에서 기존 receipt repository SpyBean의 `saveAndFlush`에 DB 예외를 주입한다. ko-KR partial callback을 사용하여 상태뿐 아니라 오류 필드도 변경 대상에 포함하고, 일반화된 500 body 및 receipt·결과 부재, PENDING/갱신 시각/오류 필드 롤백을 DB 재조회로 확인한다.
|
||||||
|
|
||||||
|
### RED/GREEN 명령과 증거
|
||||||
|
|
||||||
|
위 격리 `ROOT`와 `TMPDIR`/Node/Bun cache 환경을 그대로 사용했다. 외부 의존성 다운로드를 막는 `--offline`과 부모의 `verification.gradle`을 추가하여 테스트만 강제로 다시 실행했다. `clean` 및 무필터 test/check/build는 실행하지 않았다.
|
||||||
|
|
||||||
|
advice 수정 전 RED와 수정 후 두 사례 GREEN에 사용한 동일 selector/명령:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --offline --no-daemon --max-workers=2 \
|
||||||
|
-Pkotlin.compiler.execution.strategy=in-process -Dorg.gradle.jvmargs=-Xmx4g \
|
||||||
|
--project-cache-dir "$ROOT/gradle-cache" \
|
||||||
|
-I "$ROOT/isolation.gradle" -I "$ROOT/../verification.gradle" \
|
||||||
|
test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldRejectEmptyCallbackAndStartedBodiesWithoutPersistingAnything' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.shouldReturn500AndRollbackWhenReceiptInsertFailsOverHttp'
|
||||||
|
```
|
||||||
|
|
||||||
|
- RED: `$ROOT/p1-red-two-http.log`, `BUILD FAILED in 4m 16s`, 정확히 2개 실행/2개 assertion 실패다. `$ROOT/p1-red-assertions.log`에 XML의 실패 증거를 보존했다. 빈 body는 `expected [422, 422] / actual [200, 200]`, DB 실패는 `expected 500 / actual 200`이었다.
|
||||||
|
- 첫 GREEN 시도 `$ROOT/p1-green-two-http.log`는 `compileKotlin` 도중 600초 도구 제한으로 종료됐다. 테스트가 실행되지 않아 GREEN으로 계산하지 않았다. 작업 소유 프로세스가 남지 않은 것을 확인한 후 같은 캐시와 1200초 제한으로 재실행했다.
|
||||||
|
- 두 사례 GREEN: `$ROOT/p1-green-two-http-retry.log`, `BUILD SUCCESSFUL in 13m 29s`. `$ROOT/p1-green-two-assertions.log`는 `tests=2`, `failures=0`, `errors=0`, `skipped=0`이다.
|
||||||
|
|
||||||
|
이후 자막 신규 클래스 15개 전체와 기존 격리 script의 변경 Kotlin 파일 lint 및 boot JAR를 함께 검증했다:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --offline --no-daemon --max-workers=2 \
|
||||||
|
-Pkotlin.compiler.execution.strategy=in-process -Dorg.gradle.jvmargs=-Xmx4g \
|
||||||
|
--project-cache-dir "$ROOT/gradle-cache" \
|
||||||
|
-I "$ROOT/isolation.gradle" -I "$ROOT/../verification.gradle" \
|
||||||
|
test --tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest' \
|
||||||
|
bootJar ktlintCheck
|
||||||
|
```
|
||||||
|
|
||||||
|
- 최종 `$ROOT/p1-green-15-build-lint.log`: `BUILD SUCCESSFUL in 7m 44s`. production/test 컴파일은 `UP-TO-DATE`였으며 test, bootJar, main/test 변경 파일 lint는 실제 실행됐다.
|
||||||
|
- 최종 XML `$ROOT/build/test-results/test/TEST-kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest.xml`: `tests=15`, `failures=0`, `errors=0`, `skipped=0`. 실제 RANDOM_PORT HTTP에서 새 422/500과 기존 404/409/422 및 직접 서비스 롤백 case가 모두 통과했다. 기존 회귀 클래스는 컴파일 입력일 뿐 실행하지 않았다.
|
||||||
|
- `$ROOT/build/libs/sodalive-0.0.1-SNAPSHOT.jar`에 수정된 `SubtitleExceptionHandler.class`가 포함됨을 `jar tf`로 확인했다. LSP 도구는 제공되지 않아 사용하지 못했으며 Kotlin 컴파일과 변경 파일 lint를 확인했다.
|
||||||
|
- RED/GREEN/최종 테스트 executor PID `28638`/`37727`/`39291`은 모두 종료됐다(`$ROOT/p1-test-process-status.log`는 header만 존재). 완료 후 작업 root를 사용하는 Gradle/HTTP/Redis 프로세스는 관찰되지 않았다. 기존 공유 PID `55393`/`55452`는 그대로이며 어떤 task도 취소하거나 프로세스를 수동 종료하지 않았다. root와 로그는 부모 재검증용으로 보존했다.
|
||||||
|
|
||||||
|
### 남은 검증 경계
|
||||||
|
|
||||||
|
- 기존 Kotlin 경고, Gradle deprecation, H2의 기존 charge/translation scheduler SQL 오류와 Redis 종료 시 재접속 경고는 관찰됐으나 수정 범위 밖이다. 신규 자막 15개 assertion은 전부 통과했다.
|
||||||
|
- 기존 회귀/전체 테스트, 운영 MySQL, AWS·MediaConvert·Lambda 실연동 및 배포 검증은 수행하지 않았다. 앞 절의 외부 게이트는 그대로 남으며, 전체 테스트 사용자 실행 명령은 `./gradlew test`다.
|
||||||
|
|
||||||
|
## 부모 최종 검증·정리 추가 기록
|
||||||
|
|
||||||
|
- 부모가 처음 신규13개 및 P1의 두 HTTP 사례를 각각 직접 재실행해 모두 통과했고, 독립 리뷰의 유일 finding은 ADDRESSED 및 로컬 backend APPROVE 판정을 받았다.
|
||||||
|
- 부모의 P1 재실행은 `BUILD SUCCESSFUL in 4m 55s`, 실제 XML2/0/0/0, timestamp `2026-11-10T15:34:43`이다.
|
||||||
|
- 2026-11-11 작업 소유 PID/listener 부재를 확인한 후 위 임시 ROOT 전체를 제거했다. 따라서 ROOT 기반 로그·init script·JAR 경로는 과거 검증 위치이며 현재 파일로 남아 있지 않다. 명령/결과/실패 이력은 본 보고서와 final-report에 보존했다.
|
||||||
|
- 일반 개발 환경의 재현 명령은 `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleHttpIntegrationTest'`다. 기존 테스트는 실행하지 않는 selector다.
|
||||||
@@ -0,0 +1,217 @@
|
|||||||
|
# 자막 Phase 1 Spring 연동 구현 계획
|
||||||
|
|
||||||
|
**Goal:** 기존 업로드와 권한을 보존하면서 자막 작업 등록, 네 BOT 내부 API, 언어별 안전한 자막 조회를 제공한다.
|
||||||
|
|
||||||
|
**Architecture:** 기존 Kotlin/Spring/JPA와 member JWT를 재사용한다. 신규 자막 기능은 `v2.subtitle` 하위에 두고 기존 콘텐츠 서비스의 업로드 및 상세에만 연결한다. 원본 S3 쓰기 이전 commit과 callback receipt/status/metadata의 원자성을 보장한다.
|
||||||
|
|
||||||
|
**Tech Stack:** Kotlin 1.6.21, Java 17, Spring Boot 2.7.14, JPA, MySQL 운영 DDL, H2 테스트.
|
||||||
|
|
||||||
|
**Spec:** [prd.md](prd.md). 사용자 승인 범위이며 재생성 기능은 제외한다.
|
||||||
|
|
||||||
|
## 현재 상태
|
||||||
|
|
||||||
|
- Phase 1/2 완료 이력 유지. Phase3 컬럼 매핑 수정·신규 테스트·독립 리뷰·소유 임시 자원 정리 완료. 활성 로컬 Goal 없음. 운영 DB/외부 게이트는 별도 검증 대상이다.
|
||||||
|
- 실행: subagent-driven-development, 공유 Kotlin 구현은 단일 담당자가 순차 처리한다. 엔티티 계약이 확보된 additive DDL·운영 문서는 별도 담당자가 병렬 준비하고 마지막에 대조한다.
|
||||||
|
- 새 worktree는 만들지 않는다. 기존 `test` 작업 트리는 조사 시 clean이며 main/master가 아니다.
|
||||||
|
- commit/push/배포/DB 적용은 이 계획의 실행 항목이 아니다.
|
||||||
|
|
||||||
|
## 전역 제약
|
||||||
|
|
||||||
|
- PRD의 네 endpoint/payload/상태/경로와 BOT 인증을 그대로 구현한다. 공개 재생성 API와 직접 START 호출은 금지한다.
|
||||||
|
- 기존 upload/MediaConvert/preview/알림/JWT/텍스트 번역 worker를 보존한다. 기존 테스트를 삭제하거나 완화하지 않는다.
|
||||||
|
- additive DDL만 작성한다. 적용 migration 편집/삭제와 데이터 DROP 금지.
|
||||||
|
- 이번 작업에서 새로 작성한 테스트만 실행하며 `bootJar`로 빌드를 별도 확인한다. 기존 클래스에 추가한 새 테스트는 메서드 selector로 지정한다. 기존 focused 회귀도 실행하지 않는다. 전체 테스트 명령은 사용자용 `./gradlew test`다.
|
||||||
|
- AWS/live/mixed/2h/운영 DB/consumer 미검증을 성공으로 보고하지 않는다.
|
||||||
|
|
||||||
|
## Review Focus
|
||||||
|
|
||||||
|
1. 외부 호출자가 트랜잭션을 가지고 있어도 S3 이벤트 시점에는 job/source가 commit되어 있어야 한다.
|
||||||
|
2. UUID 파일명 변경 후 기존 MediaConvert 완료 콜백을 수락하되 다른 콘텐츠/경로를 허용하지 않아야 한다.
|
||||||
|
3. callback 중복/경합 때 receipt와 상태 및 자막이 원자 반영되고 older 결과가 최신을 덮지 않아야 한다.
|
||||||
|
4. JSON 숫자 coercion/누락 nullable 필드/추가 필드 및 raw-body 재직렬화로 계약이 약화되지 않아야 한다.
|
||||||
|
5. preview-only 사용자에게 전체 자막이 노출되거나 BOT 변경으로 기존 역할 권한이 넓어지지 않아야 한다.
|
||||||
|
|
||||||
|
## Phase 1: 업로드부터 자막 조회까지
|
||||||
|
|
||||||
|
### Task 1.1: 자막 backend 연결
|
||||||
|
|
||||||
|
**Goal `P1-T1`:** 기존 콘텐츠 흐름에 durable source/job 등록과 네 내부 API, 안전한 자막 조회가 연결된다.
|
||||||
|
|
||||||
|
- 시작 조건: 재생성 제외 승인, PRD 작성 완료, 업로드 transaction 경계 검토 완료.
|
||||||
|
- 완료 증거: 아래 RED/GREEN 기록과 5개 기능 그룹을 검증하는 새 테스트 통과. 기존 콘텐츠/로그인 테스트는 코드 대조만 하고 미실행으로 보고.
|
||||||
|
- 범위 밖: Lambda 코드, 앱 코드, 인프라, 재생성, 자동 복구.
|
||||||
|
- 신규 구현 파일은 `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/` 아래 `application`, `domain`, `adapter`, `dto` 책임별로 배치한다. 과도한 port/wrapper는 만들지 않는다.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/domain/SubtitleJobStatus.kt`
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/SubtitleJob.kt`, `SubtitleJobRepository.kt`, `SubtitleCallbackReceipt.kt`, `SubtitleCallbackReceiptRepository.kt` 및 필요한 최소 subtitle metadata 저장 타입.
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/Subtitle.kt`, `SubtitleRepository.kt`. 결과 행은 auto-increment Long PK와 `jobId`(36), `language`(35), `format`(16), `s3Bucket`(255), `s3Key`(255)를 저장하며 `(jobId, language)` unique와 job FK를 둔다. `findAllByJobId(jobId)` 및 `findByJobIdAndLanguage(jobId, language)`로 callback/조회에서 재사용한다. 언어별 컬럼을 제거하되 아직 미배포인 이번 draft만 교체하고 기존 적용 schema/data는 건드리지 않는다.
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/application/SubtitleJobService.kt`
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/web/SubtitleJobController.kt`
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/dto/SubtitleJobDtos.kt`
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`, `AudioContent.kt`, `GetAudioContentDetailResponse.kt` 및 필요한 기존 호출자.
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/configs/SecurityConfig.kt`와 필요한 자막 전용 설정.
|
||||||
|
- Create: `docs/20261110_자막Phase1연동/subtitle-schema.sql`.
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/subtitle/`의 기능 통합 테스트 및 기존 `content/AudioContentServiceTest.kt`, `member/MemberLoginResponseContractTest.kt`, `jwt/TokenProviderTest.kt` 관련 회귀.
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
|
||||||
|
- Consumes: 기존 `AudioContent`, `S3Uploader`, `AudioContentCloudFront`, `LangContext`, member JWT/role 및 PRD의 exact Lambda HTTP 계약.
|
||||||
|
- Produces: PRD의 네 내부 HTTP endpoint; 기존 콘텐츠 상세의 nullable 자막 정보. source lookup은 최초 업로드 binding에 고정한다.
|
||||||
|
- 내부 함수/저장 형태는 기존 패턴과 transaction 검토에 맞추며 실제 파일/이름은 구현 기록에 갱신한다. 공개 계약은 변경하지 않는다.
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 관련 테스트의 의도를 먼저 읽고 새 실제 HTTP 테스트를 작성했다. 지시 이후 기존 baseline은 실행하지 않았다.
|
||||||
|
- [x] **RED 확인:** 실제 로그인 후 403 기대/404 실제, source 확장자 보존 실패 및 기존 eventId/unknown job의 422 기대/404 실제를 확인했다. compile/setup 실패는 RED로 인정하지 않았다.
|
||||||
|
- [x] **GREEN:** 최소 persistence/업로드 commit 경계/API/상세 연결 및 additive DDL을 구현했다. 언어별 결과는 `Subtitle` 행이다.
|
||||||
|
- [x] **GREEN 확인:** 부모 직접 실행에서 신규 `SubtitleHttpIntegrationTest` 13개 통과, 실패·오류·skip 0.
|
||||||
|
- [x] **REFACTOR:** Kotlin/JPA·직접 영향 test compile, 변경 파일 ktlint 및 bootJar 성공을 확인했다. 기존 회귀 case는 실행하지 않았다.
|
||||||
|
|
||||||
|
검증 상세: [implementation-report.md](implementation-report.md). 부모 재실행 `parent-verification.log`는
|
||||||
|
`BUILD SUCCESSFUL in 2m 21s`, XML timestamp `2026-11-10T14:33:59`, 13/0/0/0이다.
|
||||||
|
|
||||||
|
### Task 1.2: 실제 HTTP와 독립 리뷰
|
||||||
|
|
||||||
|
**Goal `P1-T2`:** 구현 결과를 실제 HTTP 표면과 독립 검토로 확인하고 외부 미검증을 구분한다.
|
||||||
|
|
||||||
|
- 시작 조건: `P1-T1` 구현 및 focused test 완료.
|
||||||
|
- 완료 증거: 실제 HTTP status/body assertion, `bootJar`, 변경 범위 lint/compile, 독립 리뷰의 blocker 해소.
|
||||||
|
- 범위 밖: 외부 AWS 환경에 대한 실제 운영 검증 및 전체 테스트.
|
||||||
|
- TDD 예외 사유: 검증/보고 task다. 대체 검증은 HTTP 실행과 코드/DDL/테스트 대조다.
|
||||||
|
- [x] 실제 localhost HTTP로 EMAIL BOT 로그인, 네 endpoint, 중복/경합/오류 및 기존 콘텐츠 상세를 실행했다. H2와 외부 S3/서명 경계 대체를 사용했다.
|
||||||
|
- [x] `bootJar`, 변경 파일 `ktlintCheck`, 신규 HTTP 테스트를 실행했다. LSP 미제공이며 Kotlin compile/lint를 대체 증거로 기록했다.
|
||||||
|
- [x] 독립 리뷰에서 HTTP 오류 경계 1건을 발견·수정하고, 제한 delta 재검토에서 ADDRESSED 및 로컬 backend APPROVE를 받았다.
|
||||||
|
- [x] `final-report.md`에 실제 수정·삭제·보존 경로, 명령/결과, DB 적용 및 consumer 상태, fixture 출처, live/mixed/2h BLOCKED를 기록했다.
|
||||||
|
|
||||||
|
### Task 1.R1: 리뷰 회귀 수정
|
||||||
|
|
||||||
|
**Goal `P1-R1`:** 자막 API의 빈 body/저장 실패가 HTTP 200으로 숨겨지지 않는다.
|
||||||
|
|
||||||
|
- 시작 조건: 독립 리뷰 P1 finding 및 `SodaExceptionHandler.kt`의 기존 HTTP200 변환 확인.
|
||||||
|
- 완료 증거: 새 실제 HTTP 테스트에서 빈 callback/started 422 및 DB 실패 5xx, receipt/status/results rollback 확인.
|
||||||
|
- 범위 밖: 기존 공통 exception handler나 다른 API 응답 변경.
|
||||||
|
- Files: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/web/SubtitleExceptionHandler.kt`,
|
||||||
|
`src/test/kotlin/kr/co/vividnext/sodalive/v2/subtitle/SubtitleHttpIntegrationTest.kt`.
|
||||||
|
- [x] **RED:** 빈 body와 receipt 저장 실패의 실제 HTTP 테스트 2개를 추가했다.
|
||||||
|
- [x] **RED 확인:** `[422,422]` 기대에 `[200,200]`, `500` 기대에 `200` 실패를 확인했다.
|
||||||
|
- [x] **GREEN:** 자막 전용 advice에서 body 읽기 오류는 422, 예상치 못한 서버 오류는 일반화된 500으로 반환한다.
|
||||||
|
- [x] **GREEN 확인:** 신규 자막 15개 통과, 부모의 추가 두 HTTP 사례 재실행도 통과했다. 기존 서비스 직접 호출 rollback 테스트를 유지했다.
|
||||||
|
- [x] **REFACTOR:** 변경 lint/build 및 부모 HTTP 재검증 후 제한 delta 리뷰가 승인했다. 원 reviewer session 유실로 대체 reviewer가 기존 판정과 수정분만 재검토했다.
|
||||||
|
|
||||||
|
### Phase 1 Gate
|
||||||
|
|
||||||
|
**Goal `P1-GATE`:** 로컬 backend 완료와 운영 배포 준비 상태가 증거로 구분된다.
|
||||||
|
|
||||||
|
- [x] `P1-T1`, `P1-T2`, `P1-R1` 완료 증거 확인.
|
||||||
|
- [x] 임시 QA 프로세스/listener 부재와 작업 소유 build/cache/log root 제거를 확인했다. 공유 프로세스·캐시는 변경하지 않았다.
|
||||||
|
- [x] 재생성 URI/worker/HMAC/파괴적 SQL/외부 프로젝트 변경이 없음을 diff 확인했다.
|
||||||
|
- [x] 운영 반영은 consumer inventory, DB additive DDL 검토, 조정 배포, controlled live ko/ja/mixed와 2h 측정이 필요하다고 보고했다.
|
||||||
|
|
||||||
|
## Phase 2: generate-url 자막 응답
|
||||||
|
|
||||||
|
### Task 2.1: 기존 URL 권한을 유지한 자막 제공
|
||||||
|
|
||||||
|
**Goal `P2-T1`:** 구매자의 generate-url 응답에 상세와 동일한 요청 언어 자막이 포함되고 기존 contentUrl 계약이 보존된다.
|
||||||
|
|
||||||
|
- 시작 조건: PRD §7 사용자 요청 확정, 기존 generateUrl/공유 subtitle 조회 및 새 HTTP fixture 확인.
|
||||||
|
- 범위 밖: 기존 구매 판정 확대, URI/DB/Lambda 변경, 재생성, 기존 테스트/전체 테스트 실행.
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/GenerateUrlResponse.kt`.
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`의 `generateUrl`만.
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/subtitle/SubtitleHttpIntegrationTest.kt`에 이번 후속용 HTTP 사례 추가.
|
||||||
|
- Consumes: `SubtitleJobService.subtitle(content, lang, expirationTime)`, 기존 `LangContext`, 구매 검사와 `AudioContentCloudFront`.
|
||||||
|
- Produces: `data.contentUrl` 유지 + nullable `data.subtitle`의 language/format/url.
|
||||||
|
- 완료 증거: 아래 세 시나리오의 새 HTTP 사례 RED/GREEN, 컴파일/변경 lint, 범위 한정 독립 리뷰와 임시 자원 정리.
|
||||||
|
|
||||||
|
시나리오:
|
||||||
|
1. 구매·공개 완료 콘텐츠: `Accept-Language: ko/ja` 각각에 해당 SRT 정보와 기존 음원 URL, 기존 envelope가 반환된다.
|
||||||
|
2. 미완료 job/해당 언어 없음/미지원 언어/자막 미등록: 음원 URL은 유지하고 subtitle은 명시적 null이다.
|
||||||
|
3. 미구매자(소유자·무료 포함)는 기존 빈 contentUrl과 null 자막을 받는다. 예약 공개 구매자의 subtitle은 공개 전 null이며 공개 후 제공된다. 기존 URL 반환은 그대로다.
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 HTTP fixture를 재사용한 새 메서드 3개만 추가했다.
|
||||||
|
- [x] **RED 확인:** 실제 응답의 `has("subtitle")`에서 3개 모두 assertion 실패함을 확인했다.
|
||||||
|
- [x] **GREEN:** DTO field와 generateUrl의 공유 자막 조회 연결만 구현했다.
|
||||||
|
- [x] **GREEN 확인:** 이번 새 HTTP 메서드 3개 통과, 부모 직접 재실행도 3/0/0/0. 이전 15개와 클래스 전체는 실행하지 않았다.
|
||||||
|
- [x] **REFACTOR:** 컴파일/bootJar/테스트 lint 및 제한 독립 리뷰 APPROVE를 확인했다. production lint의 기존 EOF 빈 줄1건을 별도 기록하고 dirty 변경을 보존했다. 자원 정리는 Phase2 Gate에서 확인한다.
|
||||||
|
|
||||||
|
### Phase 2 Gate
|
||||||
|
|
||||||
|
**Goal `P2-GATE`:** 추가 응답의 HTTP·권한·호환성 증거가 확보된다.
|
||||||
|
|
||||||
|
- [x] 새 HTTP3개 통과와 독립 리뷰 APPROVE 확인.
|
||||||
|
- [x] 기존 코드 변경은 DTO와 generateUrl 본문뿐임을 실제 전후 diff로 대조했다.
|
||||||
|
- [x] 결과 보고를 보존하고 소유 테스트 PID/listener 및 임시 build/cache/root 부재를 확인했다.
|
||||||
|
|
||||||
|
## Phase 3: Schema-validation 회귀 수정
|
||||||
|
|
||||||
|
### Task 3.R1: s3 컬럼 물리명 일치
|
||||||
|
|
||||||
|
**Goal `P3-R1`:** 기존 `subtitle.s3_bucket`/`s3_key` 테이블을 Hibernate가 검증하고 정상 저장·조회한다.
|
||||||
|
|
||||||
|
- 시작 조건: 실제 사용자 에러, 명시적 이름이 없는 엔티티와 DDL 차이 확인.
|
||||||
|
- Files: `src/main/kotlin/kr/co/vividnext/sodalive/v2/subtitle/adapter/persistence/Subtitle.kt`.
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/subtitle/SubtitleSchemaValidationTest.kt` 신규.
|
||||||
|
- 범위 밖: DDL 수정·운영 DB 접속/컬럼 추가·자동 update·전역 naming strategy·JSON/property rename·기존 테스트 실행.
|
||||||
|
- 시나리오: 독립적으로 만든 s3_bucket/s3_key 테이블에 실제 Boot 기본 naming strategy를 사용한 Hibernate validate 성공, 두 값의 persist/reload/JDBC column 확인 성공.
|
||||||
|
- [x] **RED:** 엔티티 자동 DDL 생성 없이 기존 컬럼명의 H2 table을 준비하고 실제 schema validate를 수행하는 새 테스트를 작성했다.
|
||||||
|
- [x] **RED 확인:** 사용자 보고와 동일한 missing s3bucket 에러로 1개 실패를 확인했다. 컴파일 오류가 아니다.
|
||||||
|
- [x] **GREEN:** `@Column(name = "s3_bucket")`, `@Column(name = "s3_key")`를 기존 속성에 명시했다.
|
||||||
|
- [x] **GREEN 확인:** 새 테스트1개만 실행해 validation 및 Hibernate 저장/새 Session 조회/JDBC 두 컬럼 조회 성공을 확인했다.
|
||||||
|
- [x] **REFACTOR:** 변경 compile/bootJar/lint와 독립 리뷰 APPROVE, 검증 기록 보존 및 소유 임시 자원 제거·부재 확인을 완료했다.
|
||||||
|
|
||||||
|
## 이전 기능 실행 검증 이력
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.subtitle.*'
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
기존 클래스에 추가한 새 테스트는 실제 메서드명을 `--tests`에 지정한다. 기존 테스트 클래스 전체는 실행하지 않는다. 수동 전체 검증은 사용자 실행 `./gradlew test`다. 실제 명령/추가 영향 테스트/결과는 아래에 누적한다.
|
||||||
|
|
||||||
|
## Progress
|
||||||
|
|
||||||
|
- 2026-11-11 `P3-R1` 종료: 작업 root를 참조하는 프로세스가 없고 실제 디렉터리/symlink 아님을 확인한 뒤 소유 `subtitle-schema-fix.XcftjN`만 제거했다. `test ! -e` exit0, 공유캐시 미변경. 결과/명령/리뷰는 문서로 보존했다. 운영 재시작/DB 변경/커밋은 하지 않았다.
|
||||||
|
|
||||||
|
- 2026-11-11 `P3-R1` 독립 리뷰 APPROVE: 명세/품질 blocker 없음. 두@Column만 바뀌었고 기존 SQL/JSON 계약은 유지된다. 독립DDL+actualvalidate+새Session/JDBC 조회와 RED/GREEN 증거가 확인됐다. 실제MySQL/전체Spring검증은 별도 게이트다.
|
||||||
|
|
||||||
|
- 2026-11-11 `P3-R1` RED/GREEN: 실제 Hibernate validation의 missing[s3bucket] 실패를 수정 전 재현했다(1fail, 3m49s). 두@Column만 수정한 뒤 신규 테스트1/0/0/0, Kotlin compile/bootJar/변경2파일 lint 성공(3m29s). 실제 운영 DB는 조회·변경하지 않았다. `schema-validation-report.md`에 원인과 기존 create-drop 검증 공백을 기록했다. 독립 한정 리뷰 진행 중.
|
||||||
|
|
||||||
|
- 2026-11-11 `P3-R1` 등록: 사용자 보고 missing `[s3bucket]` 재현/수정. 기존 기본 명명전략이 숫자-대문자 경계에서 underscore를 넣는다고 가정한 정적 대조와 엔티티 생성 H2 테스트의 검증 공백을 기록한다. 기존 DDL은 유지하고 실제 validate 회귀 검증으로 보완한다.
|
||||||
|
|
||||||
|
- 2026-11-11 별도 사용자 `/commit-with-validation` 요청으로 커밋 진행. 기능 연동 커밋의 pre-commit `ktlintCheck`가 기존 `AudioContentService.kt` EOF 빈 줄 1건으로 실패하여 해당 빈 줄만 제거했다. 재시도에서 staged Kotlin 대상 lint와 `git diff --staged --check`, 커밋 직전·직후 메시지 검증이 통과했다. 이번 커밋 작업에서는 기능/전체 테스트 및 bootJar를 재실행하지 않았으며 기존 실행 이력과 외부 배포 BLOCKED는 유지한다. 전체 테스트 사용자 명령은 `./gradlew test`다.
|
||||||
|
|
||||||
|
- 2026-11-11 `P2-GATE` 종료: 부모 직접 HTTP3개 재실행 성공과 독립 승인 후 소유 root `generate-url-subtitle.fSBkJM`의 디렉터리/symlink 여부를 확인해 제거했다. `test ! -e` exit0이며 공유 캐시/다른 dirty 파일은 건드리지 않았다. 원래 EOF lint1건은 별도 미해결 관찰로 남긴다. 검증 로그 경로는 과거 위치이며 결과/명령/실패 이력은 보고서에 보존했다.
|
||||||
|
|
||||||
|
- 2026-11-11 `P2-T1` 독립 리뷰 APPROVE: 기존 contentUrl/envelope/활성 구매 정책과 서명 만료 인자 유지, 자막만 공개 시점·언어·최신 결과 조건 적용, 새 HTTP3개 증거를 확인했다. 이번 delta blocker/새 회귀 없음. production EOF 공백은 작업 시작 전 dirty 상태의 잔여사항이며 전체 lint clean을 주장하지 않는다.
|
||||||
|
|
||||||
|
- 2026-11-11 `P2-T1` 구현: DTO nullable field 및 generateUrl 본문만 수정. 새 HTTP3개 RED/GREEN 후 부모가 정확히 새3method selector로 직접 실행해 3 tests/0 failures/errors/skipped, `BUILD SUCCESSFUL in 37s`, XML UTC `2026-11-10T22:12:51` 확인. 실제 Tomcat PID17759/port50914. Kotlin compile/bootJar 및 테스트 lint 성공. 두 production 파일 lint에서는 작업 전부터 있던 서비스 EOF 빈 줄1건만 실패하므로 다른 dirty 변경으로 보존했다. 상세는 `generate-url-report.md`. 범위 한정 독립 리뷰 진행 중.
|
||||||
|
|
||||||
|
- 2026-11-11 후속 요청: generate-url에도 상세와 같은 자막 응답 추가. `GenerateUrlResponse`는 현재 contentUrl만 있고 기존 URL 권한은 구매 검사다. `P2-T1`에서 additive field/공유 조회만 연결한다. 기존 Phase1 완료·검증 기록은 유지한다. 시작 시 추가 dirty 파일(기존 관리자 controller/query 테스트 등)을 발견했으며 다른 작업으로 보고 변경하지 않는다.
|
||||||
|
|
||||||
|
- 2026-11-11 종료 정리: 소유 root `subtitle-phase1.wiRcAJ`가 실제 디렉터리이며 symlink가 아님을 확인한 후 제거했고 `test ! -e` exit0으로 부재 확인했다. 작업 소유 테스트 PID/HTTP port의 종료는 먼저 확인했다. 결과·명령·실패 이력·리뷰 판정은 저장소 문서에 보존했으며 임시 log/init/JAR 경로는 과거 검증 위치다. 모든 로컬 Goal 완료, 외부 배포 게이트는 별도 BLOCKED로 유지한다.
|
||||||
|
|
||||||
|
- 2026-11-11 최종 제한 리뷰: `REV-P1-001 ADDRESSED`, 로컬 backend gate `APPROVE`. 신규 blocker 없음. 원 reviewer session 유실 때문에 기존 전체 리뷰 판정과 오류 advice/두 테스트 delta만 대체 reviewer가 확인했으며 전체 리뷰를 반복하지 않았다. 재생성·AWS·운영 DB·live·2h는 구현/승인 범위에서 분리했다.
|
||||||
|
|
||||||
|
- 2026-11-11 `P1-R1` 검증: 2개 HTTP RED 후 수정, 신규 자막 15개 전체와 bootJar/변경 lint 통과 (`p1-green-15-build-lint.log`, 7m44s). 부모는 수정한 두 새 HTTP 사례만 재실행해 2/0/0/0 및 `BUILD SUCCESSFUL in 4m 55s` 확인. 실제 Tomcat port 59977/PID44707, XML timestamp `2026-11-10T15:34:43`. 기존 reviewer session continuation이 유실돼 이전 판정과 수정 delta만 전달한 단일 재리뷰를 진행 중이다. 같은 기능을 재설계하거나 전체 리뷰를 반복하지 않는다.
|
||||||
|
|
||||||
|
- 2026-11-10 독립 gate 리뷰: REQUEST_CHANGES 1건. 자막 advice가 ResponseStatusException만 처리하므로 빈 body/저장 실패가 기존 공통 advice에서 HTTP200으로 변환될 수 있다. 부모가 실제 공통 handler를 확인했고 전용 advice+새 HTTP 사례의 `P1-R1`로 수정한다. 나머지 저장/권한/언어별 구조/업로드/DDL 범위는 reviewer가 부합 판정했다.
|
||||||
|
|
||||||
|
- 2026-11-10 부모 검증: 격리 build/cache에서 신규 HTTP 13개를 up-to-date 무시하고 직접 재실행, 13 passed/0 failed/0 errors/0 skipped, `BUILD SUCCESSFUL in 2m 21s`. 같은 코드의 bootJar와 ktlint는 up-to-date 확인이며 구현 담당의 실제 실행 로그 `build-lint.log`는 `BUILD SUCCESSFUL in 1m 28s`다. 로컬 mapping의 `sourceUploadErrorAt` TIMESTAMP 차이는 해소했다. 기존 독립 reviewer 결과 회수 실패 및 session 유실로 승인을 주장하지 않고 대체 단일 reviewer를 실행 중이다.
|
||||||
|
|
||||||
|
- 2026-11-10 실제 ZIP 계약 대조: `unzip -p .../start-subtitle-transcription.zip common/transcribe.py`로 확장자 없는 원본 key가 `UNSUPPORTED_MEDIA`임을 확인했다. `common/runtime.py::source_content`는 UUID 뒤 확장자를 허용한다. 원본의 안전한 확장자를 보존하도록 등록 seam/새 테스트를 수정한다. 이는 기존 artifact의 read-only 계약 확인이며 Lambda 변경·실행·AWS 호출이 아니다. 확장자는 형식 보장이 아니며 기존 업로드/MediaConvert 동작을 미지원 자막 형식 때문에 막지 않는다.
|
||||||
|
|
||||||
|
- 2026-11-10 후속 설계 조정: 사용자에게 향후 언어 추가 가능성이 확인되어 고정 `koKey`/`jaKey` 대신 `Subtitle` 결과 행을 둔다. 현재 API 허용 언어/상태 판정은 ko/ja 고정 그대로다. 구현 담당과 DDL 담당을 잠시 중단하고 같은 session으로 갱신 계약을 전달한다. callback 원자성/terminal replay/조회 권한 새 테스트를 같은 구조로 갱신한다. 아래 Oracle의 고정 컬럼 권고는 당시 두 언어 고정 가정의 기록이며 이 결정으로 대체한다.
|
||||||
|
|
||||||
|
- 2026-11-10 후속 지시: 테스트는 이번에 작성한 것만 실행. 지시 반영을 위해 실행 중 implementer를 일시 중단하고 같은 session으로 재개한다. Kotlin 공유 파일은 기존 담당자가 소유하고 DDL/운영 문서만 병렬 분리한다. 이전 baseline 실행 이력은 아래에 보존하되 재실행하지 않는다.
|
||||||
|
|
||||||
|
- 2026-11-10: 현재 상태 조사 완료. Spring 자막/recovery 구현 없음, 기존 BOT 인증/업로드 보존. Phase 1 Lambda ZIP hash 대조 완료, AWS 상태는 미확인. 사용자 결정으로 재생성 전체 제외.
|
||||||
|
- 2026-11-10: PRD/계획 준비. 아직 production 코드 수정 및 테스트 실행 전이며 성공 결과를 주장하지 않는다.
|
||||||
|
- 2026-11-10: Oracle 경계 검토 완료. create orchestration은 `NOT_SUPPORTED`, 실제 등록은 필수 주입 `TransactionTemplate(REQUIRES_NEW)`로 분리한다. AI 관리자 create 바깥 transaction도 조정한다. content/source/job/최신 선택값을 한 번 저장한 뒤 S3 원본 업로드하고 후속 input 경로 재대입은 제거한다. 업로드 예외는 객체 생성 여부가 불명확하므로 처리 상태를 terminal로 덮지 않고 별도 업로드 오류만 기록해 수동 확인 대상으로 남긴다.
|
||||||
|
- 2026-11-10: 고정 두 언어 metadata는 job의 nullable 컬럼으로 최소 저장하고 별도 번역/checkpoint 구조는 만들지 않는다. receipt eventId는 case-sensitive unique, callback/started는 동일 job lock을 사용한다. 다른 job 사이 eventId 경합은 rollback 후 receipt 재조회로 판정한다.
|
||||||
|
- 2026-11-10: UUID 파일명 변경은 외부 MediaConvert의 ID 추출/output 명명 규칙 확인 전 **배포 BLOCKED**다. 현재 저장소에 외부 consumer의 운영 계약 증거가 없으며, 임의 prefix 완화로 숨기지 않는다. 자막 S3 bucket의 private CloudFront origin/서명 접근도 운영 확인 게이트다.
|
||||||
|
- 2026-11-10: baseline 명령 `./gradlew test --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.member.MemberLoginResponseContractTest' --tests 'kr.co.vividnext.sodalive.jwt.TokenProviderTest'`는 `kaptGenerateStubsKotlin` 단계에서 200초 도구 제한으로 종료. 테스트 결과 없음. 기존 다른 Gradle 작업이 관찰되어 타 작업을 종료하지 않고 이 작업 전용 build/cache 경로로 검증을 격리한다.
|
||||||
|
|
||||||
|
## Schema-validation 커밋 전 재검증
|
||||||
|
|
||||||
|
- 2026-11-11 별도 `/commit-with-validation` 요청으로 `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleSchemaValidationTest'`를 실행했다.
|
||||||
|
- 결과: `BUILD SUCCESSFUL in 46s`, 테스트 1개, 실패/오류/건너뜀 0개. 기존 컬럼명의 Hibernate validation과 저장·재조회를 재확인했다.
|
||||||
|
- 전체 테스트와 실제 MySQL 기동은 실행하지 않았다. 사용자 전체 테스트 명령은 `./gradlew test`다.
|
||||||
@@ -0,0 +1,150 @@
|
|||||||
|
# 자막 Phase 1 Spring 연동 PRD
|
||||||
|
|
||||||
|
## 문서 정보
|
||||||
|
|
||||||
|
- 작성일: 2026-11-10
|
||||||
|
- 상태: 재생성 제외 로컬 backend 구현·검증 완료. 운영 배포/외부 게이트는 별도 차단 상태.
|
||||||
|
- 구현 계획: [plan-task.md](plan-task.md)
|
||||||
|
- 기준: 사용자 제공 Phase 1 계약 및 후속 결정 "이번 스코프에 재생성 기능은 추가하지 않고 나머지만 진행"
|
||||||
|
|
||||||
|
## 1. 목표와 범위
|
||||||
|
|
||||||
|
기존 콘텐츠 업로드에 자막 원본 binding과 PENDING 작업을 연결하고, 기존 BOT JWT로 보호한 네 내부 API를 통해 Lambda 결과를 저장한다. 기존 콘텐츠 상세에서 요청 언어와 원본 열람 권한에 맞는 자막 정보만 반환한다.
|
||||||
|
|
||||||
|
Spring은 업로드/작업 등록/결과 저장/콘텐츠 접근 제어를 맡는다. Lambda의 S3 이벤트, Transcribe, 번역, SRT 생성은 이미 별도 구현되어 있으므로 다시 구현하지 않는다. 앱 플레이어 구현은 이 Spring 저장소의 변경 대상이 아니며 실제 앱 표시 검증은 외부 게이트다.
|
||||||
|
|
||||||
|
### 제외
|
||||||
|
|
||||||
|
- 사용자 결정에 따라 자막 재생성 전체: 새 공개 API, 새 job 생성 business action, START 직접 비동기 호출 모두 제외.
|
||||||
|
- Scheduler discovery, recovery/lease/fence/checkpoint/outbox/자동 복구, HMAC 인증, 신규 로그인/refresh 계약.
|
||||||
|
- 외부 프로젝트 수정, AWS 설정/배포/실데이터 변경, DB DROP, 적용 migration 편집/삭제.
|
||||||
|
- MediaConvert/AAC/preview/기존 알림의 기능 변경과 2GB 다운로드/probe pipeline.
|
||||||
|
|
||||||
|
## 2. 실제 현재 상태
|
||||||
|
|
||||||
|
| 영역 | 확인 결과 | 처리 |
|
||||||
|
|---|---|---|
|
||||||
|
| Spring 작업 트리 | `test`, 조사 기준 `fe620aa9`, 변경 없음 | 현 작업 트리에서 최소 변경 |
|
||||||
|
| 로그인/JWT/BOT | `MemberService.login`, `MemberRole.BOT`, `JwtFilter`, `TokenProvider` 존재 | 재사용, 공유 인증 약화 금지 |
|
||||||
|
| 콘텐츠 | `AudioContent`의 numeric PK, 기존 multipart 업로드와 상세/서명 URL 존재 | 보존 및 필요한 연결만 추가 |
|
||||||
|
| 업로드 | `AudioContentService.createAudioContent` 트랜잭션 안에서 S3 업로드 | S3 이벤트 전에 committed PENDING/source가 보이도록 조정 |
|
||||||
|
| 업로드 완료 | `uploadComplete`가 파일명의 contentId prefix 검사 후 경로/duration/알림 처리 | 기존 파일은 유지, 새 UUID 원본과의 정확한 연결 검증 필요 |
|
||||||
|
| 자막/recovery | 자막 API/job/worker/HMAC 및 자막 migration 검색 결과 없음 | 실제 삭제 대상 없음, 공유 텍스트 TranslationJob/JWT/Agora 보존 |
|
||||||
|
| DB 관리 | Flyway/Liquibase 의존성 없음, 기존 문서 SQL 관례 | additive MySQL DDL 문서만 작성, 운영 적용 여부 미확인 |
|
||||||
|
| 재생성 | 기존 action 없음. `generate-url`은 재생 URL 발급 | 이번 범위 제외 |
|
||||||
|
|
||||||
|
### Lambda handoff 확인
|
||||||
|
|
||||||
|
참조는 `/Users/klaus/Develop/sodalive/Lambda/generate-subtitle/aws-subtitle-service/docs/FINAL_REPORT.md`다. 실제 로컬 ZIP hash가 보고서 및 manifest와 일치함을 조사했다.
|
||||||
|
|
||||||
|
- `start-subtitle-transcription.zip`: `a0d0b19b2ecb24c0f89caf528bf09fd039558563a99063f082ac64418704abfd`
|
||||||
|
- `generate-subtitle.zip`: `bfa8742ca436bace853ec2540fc5f70daa24cbab49e75315565d980189fbf209`
|
||||||
|
|
||||||
|
이는 AWS 배포 상태의 증거가 아니다. 현재 운영 consumer/in-flight/Scheduler/DB 상태는 미확인이다. 이 저장소에 삭제할 legacy 자막 consumer는 발견되지 않았으며 외부 consumer 삭제/중지/교체는 하지 않는다.
|
||||||
|
|
||||||
|
## 3. 고정 계약
|
||||||
|
|
||||||
|
### 식별자와 저장 경로
|
||||||
|
|
||||||
|
- `contentId`: 기존 Long PK, JSON number. `jobId`: Spring 생성 UUID string.
|
||||||
|
- 원본: `input/{contentId}/{UUID filename}`, 같은 key 덮어쓰기 금지. VersionId 생성/사용 없음.
|
||||||
|
- 원본 파일의 안전한 확장자를 UUID 뒤에 보존한다(예: `{UUID}.mp3`). 실제 Phase 1 START ZIP의 `common/transcribe.py::validate_binding`은 `amr/flac/m4a/mp3/mp4/ogg/webm/wav` 확장자를 요구하며, 확장자 없는 key는 `UNSUPPORTED_MEDIA`다. 확장자는 형식 힌트일 뿐 실제 미디어 검증을 대신하지 않는다. 기존 업로드 허용 동작을 임의로 축소하지 않고 미지원 형식은 자막 실패와 기존 업로드를 구분한다.
|
||||||
|
- transcript: `transcripts/{contentId}/{jobId}/transcript.json`.
|
||||||
|
- 자막: `subtitles/{contentId}/{jobId}/ko.srt`, `subtitles/{contentId}/{jobId}/ja.srt`.
|
||||||
|
- 상태: `PENDING`, `PROCESSING`, `COMPLETED`, `PARTIAL_COMPLETED`, `FAILED`.
|
||||||
|
- 등록과 원본 binding은 S3 원본 업로드 전에 commit한다. 업로드 실패를 성공으로 숨기지 않으며 이미 commit된 job의 실패를 기록한다. 자동 복구는 추가하지 않는다.
|
||||||
|
|
||||||
|
### 내부 API: 정확히 네 개
|
||||||
|
|
||||||
|
모든 요청은 기존 `/member/login`에서 발급된 JWT의 BOT 권한을 검증한다. 일반 USER/CREATOR/ADMIN만으로 허용하지 않는다. unknown job/source는 404이며 조회 중 job을 만들지 않는다.
|
||||||
|
|
||||||
|
| Method | Path | 계약 |
|
||||||
|
|---|---|---|
|
||||||
|
| GET | `/internal/api/subtitle-jobs/resolve?bucket=...&key=...` | 업로드의 정확한 source binding 조회 |
|
||||||
|
| GET | `/internal/api/subtitle-jobs/{jobId}` | UUID job 조회 |
|
||||||
|
| POST | `/internal/api/subtitle-jobs/{jobId}/started` | 정확히 `transcribeJobName`, `status` |
|
||||||
|
| POST | `/internal/api/subtitle-jobs/callback` | 정확히 아래 8개 필드 |
|
||||||
|
|
||||||
|
조회 응답은 envelope 없이 `jobId`, numeric `contentId`, `status`, `source:{bucket,key,versionId:null}`다. recovery/provider/lease 정보는 노출하지 않는다.
|
||||||
|
|
||||||
|
started의 이름은 `subtitle-{jobId}`, status는 `PROCESSING`만 허용한다. PENDING만 PROCESSING으로 전이하고 같은 PROCESSING 및 terminal은 no-op이다. 성공은 200 `{}` 또는 204 empty다.
|
||||||
|
|
||||||
|
callback은 `eventId`, `jobId`, numeric `contentId`, `transcribeJobName`, `status`, `subtitles`, `errorCode`, `errorMessage`만 받는다. `eventId`는 비어 있지 않은 문자열로 UUID 제한을 하지 않는다. subtitle 항목은 `language`, `format`, `s3Bucket`, `s3Key`만 받는다. 언어는 `ko-KR`/`ja-JP`, format은 `SRT`, 언어 중복은 금지한다. 이름/job/content/configured bucket allowlist/정확한 자막 key를 검증한다.
|
||||||
|
|
||||||
|
- 2개 자막이면 COMPLETED, 1개면 PARTIAL_COMPLETED, 0개면 FAILED만 허용한다.
|
||||||
|
- COMPLETED의 errorCode/errorMessage는 명시적 null, partial/failed는 구체적 비어 있지 않은 오류를 요구한다. nullable 필드도 요청에서 생략하지 않는다.
|
||||||
|
- started 전 callback도 허용한다. callback 검증은 SRT 내용 검사로 위장하지 않는다. 실제 빈 파일/무음 방지는 기존 Lambda 및 live 검증 책임이다.
|
||||||
|
- receipt의 eventId와 **원래 HTTP body bytes의 SHA-256**을 상태/자막 metadata와 같은 DB 트랜잭션으로 저장한다. hash는 인증이 아니다.
|
||||||
|
- 같은 eventId/hash는 200, 같은 eventId/다른 hash는 422, terminal job의 다른 결과는 409다. 회귀 및 부분 반영 금지.
|
||||||
|
- 오래된 job의 결과는 자체 저장하되 콘텐츠 최신 선택 결과를 대체하지 않는다. 재생성 API가 제외되어도 이 저장 불변식은 유지한다.
|
||||||
|
|
||||||
|
### 로그인/권한/개인정보
|
||||||
|
|
||||||
|
기존 login 요청의 `isAdmin:false`, `isCreator:false`와 기존 `data.token` 응답을 바꾸지 않는다. 활성 EMAIL BOT의 DB role과 발급 JWT를 실제 인증 경로 테스트로 확인한다. Lambda의 success envelope/401 1회 갱신/403 갱신 금지 구현은 재작성하지 않는다.
|
||||||
|
|
||||||
|
credentials/JWT/body를 코드/로그/보고서에 출력하지 않는다. BOT 운영 계정 준비는 운영자 책임이다. 기존 JWT 등록/회원 권한/다른 role 경로는 그대로 보존한다.
|
||||||
|
|
||||||
|
### 언어별 저장 구조
|
||||||
|
|
||||||
|
추후 언어 추가 가능성을 반영해 `SubtitleJob`에 `koKey`/`jaKey` 같은 언어별 컬럼을 두지 않는다. `Subtitle` 결과 행에 `jobId`, `language`, `format`, `s3Bucket`, `s3Key`를 저장하고 `(jobId, language)` unique로 중복을 방지한다. 작업 상태/원본/오류는 `SubtitleJob`, callback 중복 방지는 receipt가 담당한다. callback transaction에서 결과 행도 함께 저장한다.
|
||||||
|
|
||||||
|
이번 Phase 1의 외부 계약은 그대로 유지한다. callback은 `ko-KR`/`ja-JP`만 허용하며 2개/1개/0개 결과의 상태 판정도 변경하지 않는다. 다른 언어 활성화, 언어 관리 API, 동적 provider 설정은 구현하지 않는다. 새 언어는 향후 계약·Lambda·조회 정책 변경이 필요하지만 언어별 DB 컬럼 추가는 필요 없도록 한다.
|
||||||
|
|
||||||
|
### 콘텐츠 상세 응답
|
||||||
|
|
||||||
|
기존 상세 API 응답에 nullable 자막 정보를 additive하게 제공한다. 기존 `LangContext`의 한국어/일본어에 맞는 완료 자막만 선택한다. 미지원 언어/미완료/없는 언어는 null이며 원문 복사 fallback을 만들지 않는다.
|
||||||
|
|
||||||
|
원본 재생이 가능한 구매/소유자/무료 조건과 공개 시점 등 기존 접근 제한을 통과한 경우에만 서명된 SRT URL을 제공한다. 유료 preview만 볼 수 있는 사용자는 전체 자막을 받지 않는다. 새로운 공개 download URI를 만들지 않는다.
|
||||||
|
|
||||||
|
## 4. 검증 시나리오
|
||||||
|
|
||||||
|
| 그룹 | 통과 조건 | 증거 |
|
||||||
|
|---|---|---|
|
||||||
|
| 1. 등록/조회 | S3 upload 경계에서 별도 transaction으로 PENDING/source 조회 가능, UUID/숫자 JSON 및 404 정확 | Spring DB/HTTP 테스트, upload 경계 assertion |
|
||||||
|
| 2. started | 단조 전이, duplicate/terminal no-op, 잘못된 이름/status 거부 | DB/HTTP 테스트 |
|
||||||
|
| 3. callback | complete/partial/fail, exact body hash replay, 422/409, callback-before-started, atomic rollback, older/latest guard | DB/HTTP 및 동시성 테스트 |
|
||||||
|
| 4. 로그인/보안 | 실제 active EMAIL BOT 로그인/JWT로 네 API 허용, 다른 role/익명 거부, 기존 envelope 보존 | 기존 로그인/JWT 회귀 및 통합 테스트 |
|
||||||
|
| 5. 콘텐츠 | ko/ja 선택 및 구매/소유자/무료/preview 권한 유지, 기존 업로드 완료/알림 회귀 없음 | 기존 콘텐츠 테스트와 추가 회귀 |
|
||||||
|
|
||||||
|
실제 서버 HTTP 요청으로 핵심 endpoint를 검증하고, 이번 작업에서 새로 작성한 테스트와 `bootJar`를 분리 실행한다. 기존 테스트는 읽어 계약을 보존하되 실행하지 않는다. 기존 클래스에 새 테스트를 추가한 경우 해당 메서드만 지정한다. 전체 테스트는 사용자 실행 `./gradlew test`로 남긴다. LSP 도구가 제공되지 않으면 Kotlin compile/lint 대체 결과와 미실행 사실을 명시한다.
|
||||||
|
|
||||||
|
## 5. 외부 게이트와 미검증
|
||||||
|
|
||||||
|
- AWS 접근/배포는 승인 없이 하지 않는다. 기존 consumer 운영 여부가 미확인이므로 삭제/전환/재개는 BLOCKED다.
|
||||||
|
- live ko/ja/mixed S3 -> callback -> 콘텐츠/앱 검증은 별도 승인 및 환경 필요. 실제 word/item 언어 evidence 없는 mixed 결과는 통과 불가. synthetic fixture는 대체 증거가 아니다.
|
||||||
|
- 2시간은 입력 목표이며 SLA/지원 보장이 아니다. 기존 신뢰 가능한 duration의 가용성과 검증 경계를 확인한다. 구형 또는 검증 불가능한 원본은 수동 게이트로 남기고 임의 client 값을 신뢰하지 않는다.
|
||||||
|
- 대표 2시간 처리 예산은 미측정이며 지원 검증 BLOCKED. 분할/상한 하향/Translate 50-call 제한을 추가하지 않는다.
|
||||||
|
- 운영 DB 적용 상태 미확인. DDL 적용/기존 데이터/미확인 환경에 대한 삭제는 하지 않는다.
|
||||||
|
|
||||||
|
## 6. Decision Log
|
||||||
|
|
||||||
|
| 날짜 | 결정 | 근거 |
|
||||||
|
|---|---|---|
|
||||||
|
| 2026-11-10 | 자막 재생성 기능 전체 제외, 나머지 진행 | 사용자 명시 결정 |
|
||||||
|
| 2026-11-10 | 현재 Spring 중심, 외부 참조는 명시된 Lambda handoff에 한정 | 사용자 범위 확인 |
|
||||||
|
| 2026-11-10 | 이미 있는 로그인/JWT/Lambda 재구현 금지, 자막 recovery 삭제 없음 | 실제 코드/ZIP 조사 |
|
||||||
|
| 2026-11-10 | 실행 테스트는 이번 작업에서 새로 작성한 사례만. 기존 focused 회귀 및 전체 테스트 실행 금지 | 사용자 후속 지시 |
|
||||||
|
| 2026-11-10 | 향후 언어 추가를 고려해 언어별 결과 행으로 저장, 이번 API는 ko/ja만 유지 | 사용자 확장 가능성 제시 및 중단 없이 진행 지시에 따른 최소 저장 구조 조정 |
|
||||||
|
|
||||||
|
## 7. 후속 범위: generate-url 자막 응답
|
||||||
|
|
||||||
|
2026-11-11 사용자 요청에 따라 기존 `GET /audio-content/{id}/generate-url` 응답에도 콘텐츠 상세와 동일한
|
||||||
|
nullable `subtitle`을 추가한다. 기존 `ApiResponse` envelope와 `data.contentUrl` 이름·타입·URL 생성 동작은 유지한다.
|
||||||
|
|
||||||
|
- `GenerateUrlResponse`에 `subtitle: ContentSubtitleResponse? = null`을 추가한다. 필드는 `language`, `format`, `url`이다.
|
||||||
|
- 기존 `orderRepository.isExistOrdered` 검사를 유지한다. 구매가 없으면 기존처럼 `contentUrl`은 빈 문자열이며 `subtitle`은 null이다.
|
||||||
|
- 상세와 달리 현재 generate-url은 소유자/무료 콘텐츠만으로 구매 검사를 우회하지 않는다. 이 요청으로 기존 URL 권한을 확대하지 않는다.
|
||||||
|
- 구매가 확인된 사용자의 자막은 상세와 같은 공개 시점 조건(미지정/도래 또는 소유자)을 적용한다. 기존 `contentUrl` 동작은 바꾸지 않는다.
|
||||||
|
- `SubtitleJobService.subtitle`을 재사용해 요청 `LangContext`의 ko/ja, 최신 job, 완료/부분 완료 및 해당 언어 존재 여부를 처리한다.
|
||||||
|
- 자막 미완료·누락·미지원 언어면 null이며 원문 fallback이나 새 자막 생성은 하지 않는다. 음원과 자막 서명 URL에는 같은 만료 기간을 전달한다.
|
||||||
|
- 컨트롤러 URI/인증·DB 스키마·Lambda·재생성은 변경하지 않는다. 검증은 이번 후속 작업에서 새로 작성한 HTTP 테스트만 실행한다.
|
||||||
|
|
||||||
|
## 8. Schema-validation 회귀 수정
|
||||||
|
|
||||||
|
2026-11-11 실제 기동에서 `Schema-validation: missing column [s3bucket] in table [subtitle]`가 보고됐다.
|
||||||
|
공개된 DDL의 `s3_bucket`/`s3_key`를 기준으로 엔티티의 물리 컬럼 이름을 명시한다.
|
||||||
|
Kotlin 속성 및 JSON 이름 `s3Bucket`/`s3Key`는 바꾸지 않고 DB 컬럼 추가/rename이나 전역 naming strategy 변경도 하지 않는다.
|
||||||
|
|
||||||
|
기존 테스트의 `ddl-auto:create-drop`은 잘못 추론된 이름으로 테이블을 함께 생성해 이 불일치를 가렸다.
|
||||||
|
신규 회귀 검증은 엔티티와 독립적으로 기존 DDL 컬럼 이름의 H2 테이블을 먼저 생성하고 실제 Hibernate
|
||||||
|
`validate` 및 저장/재조회로 두 필드를 확인한다. 실제 운영 MySQL 재기동을 검증했다고 주장하지 않는다.
|
||||||
@@ -0,0 +1,47 @@
|
|||||||
|
# 자막 Phase 1 Backend Gate 리뷰
|
||||||
|
|
||||||
|
## 1. 리뷰 정보
|
||||||
|
|
||||||
|
- 일자: 2026-11-10
|
||||||
|
- 대상: `test` working tree의 신규 `v2.subtitle` 및 기존 업로드/상세/보안 연결
|
||||||
|
- 기준: [PRD](../prd.md), [계획](../plan-task.md), [구현 보고](../implementation-report.md)
|
||||||
|
- 리뷰어: 독립 Oracle (`ses_e3a1e039bffeXbBb7Nx0V7Hvk8`)
|
||||||
|
- 상태: 회귀 수정 검증 완료, 로컬 backend APPROVE
|
||||||
|
- 검토 제외: AWS/운영 DB/실음성/2시간 성능, 기존 전체 회귀 실행
|
||||||
|
|
||||||
|
## 2. 근거와 판정
|
||||||
|
|
||||||
|
부모 직접 실행의 실제 localhost HTTP 신규 테스트 13개가 0 failure/error/skip으로 통과했다.
|
||||||
|
reviewer는 코드·신규 테스트·실행 로그·DDL을 읽었고 테스트를 재실행하지 않았다.
|
||||||
|
저장/권한/언어별 결과/업로드/스키마는 부합 판정이나 HTTP 오류 경계 한 건으로 REQUEST_CHANGES다.
|
||||||
|
|
||||||
|
| ID | 심각도 | 상태 | 내용 | 수정 Goal |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| REV-P1-001 | High | 수정 완료 / ADDRESSED | 자막 빈 body/저장 실패가 공통 advice에서 HTTP200으로 변환 | P1-R1 |
|
||||||
|
|
||||||
|
## 3. REV-P1-001
|
||||||
|
|
||||||
|
- `SubtitleExceptionHandler.kt`는 ResponseStatusException만 처리한다.
|
||||||
|
- 기존 `common/SodaExceptionHandler.kt:73`과 `:94`는 DB 예외/일반 예외에 HTTP 상태 없이 ApiResponse.error를 반환한다.
|
||||||
|
- 필수 body가 비면 strict parser 이전에 HttpMessageNotReadableException이 발생한다.
|
||||||
|
- receipt 실패의 기존 새 테스트는 서비스 직접 호출 rollback만 검증하므로 HTTP200 문제를 포착하지 못했다.
|
||||||
|
- 영향: 결과가 저장되지 않았어도 Lambda가 HTTP 성공으로 해석할 수 있다.
|
||||||
|
|
||||||
|
최소 수정은 자막 controller에 한정된 advice에서 body 읽기 오류를 422, 예상하지 못한 서버 오류를
|
||||||
|
민감정보 없는 500으로 반환하는 것이다. 기존 404/409/422 및 공유 API 동작을 보존한다.
|
||||||
|
|
||||||
|
## 4. 수정 검증 조건
|
||||||
|
|
||||||
|
1. 빈 callback/started 요청이 200이 되는 RED를 실제 HTTP로 확인한다.
|
||||||
|
2. receipt 실패 callback이 200이 되는 RED와 전체 DB rollback을 확인한다.
|
||||||
|
3. 수정 후 422/500 및 무부분반영을 검증하고 이번 작성 테스트만 재실행한다.
|
||||||
|
4. 같은 reviewer가 수정 delta와 새 증거를 재검토한다.
|
||||||
|
|
||||||
|
## 5. 판정 기록
|
||||||
|
|
||||||
|
- 1차: REQUEST_CHANGES 1건. 부모가 공통 handler 코드를 직접 확인하고 `P1-R1`에 반영했다.
|
||||||
|
- 2026-11-11 수정 검증: 전용 advice만 수정하고 신규 HTTP 두 사례의 RED/GREEN을 확인했다. 이후 신규 자막15개·bootJar·변경 lint가 통과했고, 부모 직접 두 HTTP 사례 재실행도 2/0/0/0으로 통과했다. 기존 공통 handler와 직접 서비스 rollback 테스트는 보존했다. reviewer session continuation 유실로 기존 판정과 delta만 전달한 단일 재검토를 진행 중이다.
|
||||||
|
- 운영 배포는 코드 리뷰와 별개이며 [배포 게이트](../deployment-gates.md)의 차단 상태를 유지한다.
|
||||||
|
- 최종 제한 delta 리뷰 (`ses_e39e64c42ffeCOGUZjgeM4P1jf`): **REV-P1-001 ADDRESSED / 로컬 backend APPROVE**.
|
||||||
|
전용 advice의 422/500, 기존 404/409/422 유지, 실제 HTTP 및 rollback RED/GREEN 증거를 확인했다.
|
||||||
|
수정 delta에서 신규 버그/blocker는 발견하지 못했다. 추가 코드 수정 불필요 판정이며 전체 리뷰 반복이나 기존 테스트 실행은 하지 않았다.
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# generate-url 자막 응답 제한 리뷰
|
||||||
|
|
||||||
|
- 일자: 2026-11-11
|
||||||
|
- 범위: `P2-T1`, `GenerateUrlResponse`와 `AudioContentService.generateUrl`, 새 HTTP 테스트3개.
|
||||||
|
- 기준: PRD §7, plan-task P2, 실제 메서드/DTO 전후 diff 및 `generate-url-report.md`의 RED/GREEN 증거.
|
||||||
|
- 리뷰어: `ses_e387b1e8fffensjb6dnoRk82ST`, read-only. 기존 Phase1 전체는 다시 리뷰하지 않았다.
|
||||||
|
- 판정: **APPROVE**, 이번 범위의 확정 finding/blocker/새 회귀 없음.
|
||||||
|
|
||||||
|
확인한 기준:
|
||||||
|
1. contentUrl과 ApiResponse envelope 유지, 공유 nullable subtitle만 additive 추가.
|
||||||
|
2. 활성 구매(KEEP/유효 RENTAL) 정책 유지, 소유자·무료만으로 우회하지 않음.
|
||||||
|
3. 음원 URL은 기존대로이며 자막에만 상세와 동일한 공개일/소유자 조건 적용.
|
||||||
|
4. 동일 expirationTime 전달 및 공유 latest/언어/상태별 자막 조회 재사용.
|
||||||
|
5. 새 HTTP3개 RED → GREEN 및 부모 재실행3/0/0/0, 실제 localhost HTTP/JWT/H2 증거 확인.
|
||||||
|
|
||||||
|
잔여사항: production lint의 기존 서비스 EOF 빈 줄1건은 보존했다. 기존 테스트/전체 테스트/LSP 및 실제 AWS 서명·다운로드/운영 배포는 이번 검증이 아니다. 수정 Task로 전환할 새로운 발견 사항은 없다.
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
# Subtitle 물리 컬럼명 회귀 리뷰
|
||||||
|
|
||||||
|
- 일자: 2026-11-11
|
||||||
|
- 범위: `P3-R1`, Subtitle의 두 Column annotation과 신규 ORM schema-validation 테스트.
|
||||||
|
- 기준: PRD §8, plan-task Phase3, 실제 RED/GREEN 로그와 production diff.
|
||||||
|
- 리뷰어: `ses_e37b4db2bffeUyLw5vO2EtHHuG`, read-only.
|
||||||
|
- 판정: **APPROVE**, 범위 내 확정 finding/blocker 없음.
|
||||||
|
|
||||||
|
검토 결과: `s3Bucket`/`s3Key`의 기본 추론 이름을 기존 DDL의 `s3_bucket`/`s3_key`로 명시했다.
|
||||||
|
Kotlin/JSON 이름·타입/길이/nullable, DDL과 전역 전략은 그대로다. 신규 테스트는 독립 테이블에서 실제
|
||||||
|
Hibernate validate, commit 후 새 Session 및 직접 JDBC 컬럼 조회를 수행한다. RED missing[s3bucket]과
|
||||||
|
GREEN1/0/0/0, bootJar 및 변경 lint 성공을 확인했다. 기존 create-drop 테스트의 한계를 반복하지 않는다.
|
||||||
|
|
||||||
|
미검증: 실제 MySQL 기동/collation/FK, 전체 Spring 연동, 기존 테스트/전체 테스트, LSP.
|
||||||
|
추가 수정 Task 없음. 운영 DB 변경이나 배포 승인을 의미하지 않는다.
|
||||||
@@ -0,0 +1,86 @@
|
|||||||
|
# Subtitle 컬럼명 schema-validation 회귀
|
||||||
|
|
||||||
|
## 원인과 범위
|
||||||
|
|
||||||
|
사용자가 보고한 `Schema-validation: missing column [s3bucket] in table [subtitle]`를 실제 Hibernate로 재현했다.
|
||||||
|
`Subtitle.s3Bucket`/`s3Key`에 물리 컬럼 이름이 없었고, 기본 naming strategy는 숫자 `3` 다음 대문자 앞에
|
||||||
|
underscore를 넣지 않아 `s3bucket`/`s3key`로 변환한다. 기존 DDL은 `s3_bucket`/`s3_key`이므로 불일치했다.
|
||||||
|
|
||||||
|
production 수정은 `Subtitle.kt`의 두 annotation뿐이다:
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
@Column(name = "s3_bucket", nullable = false, length = 255)
|
||||||
|
val s3Bucket: String,
|
||||||
|
@Column(name = "s3_key", nullable = false, length = 255)
|
||||||
|
val s3Key: String
|
||||||
|
```
|
||||||
|
|
||||||
|
Kotlin/JSON 필드명, 기존 DDL, 전역 naming strategy, 운영 DB는 변경하지 않는다.
|
||||||
|
잘못 추론된 이름의 DB 컬럼을 새로 만들거나 `ddl-auto`를 update/none으로 바꿔 오류를 숨기지 않는다.
|
||||||
|
|
||||||
|
## 기존 검증의 공백
|
||||||
|
|
||||||
|
기존 HTTP 테스트는 `ddl-auto:create-drop`으로 엔티티 기준 테이블을 자동 생성했으므로 잘못된 컬럼명으로
|
||||||
|
테이블과 ORM이 동시에 일치했다. 앞선 정적 DDL/JPA 대조도 숫자-대문자 경계의 이름 변환을 놓쳤다.
|
||||||
|
해당 완료 이력은 보존하되 이번 재현으로 그 검증 한계를 명확히 정정한다.
|
||||||
|
|
||||||
|
## 신규 회귀 테스트
|
||||||
|
|
||||||
|
`SubtitleSchemaValidationTest.shouldValidateAndUseExistingS3Columns` 한 개만 실행한다.
|
||||||
|
|
||||||
|
1. 엔티티와 독립적으로 H2에 `s3_bucket`/`s3_key`를 포함한 테이블을 직접 생성한다.
|
||||||
|
2. `HibernateProperties`/`HibernateSettings`로 Boot 기본 설정을 얻고 실제 Hibernate의 `hbm2ddl.auto=validate`를 실행한다.
|
||||||
|
3. `Subtitle`을 저장하고 새 Session 및 직접 JDBC SELECT로 두 컬럼의 값을 확인한다.
|
||||||
|
|
||||||
|
전체 Spring context/Redis/AWS 및 mock 없이 ORM 저장 표면을 검증한다. DB는 테스트 전용 메모리 H2이며
|
||||||
|
실제 MySQL collation/FK/운영 기동 전부를 검증하는 테스트는 아니다.
|
||||||
|
|
||||||
|
## 실행 기록
|
||||||
|
|
||||||
|
- RED: 새 테스트1개/실패1개/오류0/skip0, XML UTC `2026-11-11T01:42:01`.
|
||||||
|
- 실제 실패: `SchemaManagementException: Schema-validation: missing column [s3bucket] in table [subtitle]`.
|
||||||
|
- RED 빌드 결과: `BUILD FAILED in 3m 49s`. 컴파일 오류가 아닌 보고된 운영 오류와 동일한 validation 실패다.
|
||||||
|
- GREEN: 새 테스트1개/실패0/오류0/skip0, XML UTC `2026-11-11T01:46:49`.
|
||||||
|
- 실제 Hibernate validation 성공 후 저장/new Session 조회/직접 JDBC 두 컬럼 조회가 통과했다.
|
||||||
|
- `bootJar` 및 변경 엔티티/신규 테스트에 한정한 `ktlintCheck` 성공, `BUILD SUCCESSFUL in 3m 29s`.
|
||||||
|
- LSP 도구 미제공으로 Kotlin 컴파일·변경 파일 lint를 사용했다.
|
||||||
|
- 독립 한정 리뷰 `ses_e37b4db2bffeUyLw5vO2EtHHuG`: **APPROVE**. 두 annotation만 변경됐고 독립 DDL/실제 ORM roundtrip 테스트가 원인에 맞는 것을 확인했다. 신규 blocker 없음.
|
||||||
|
|
||||||
|
일반 환경의 신규 테스트 실행 명령:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleSchemaValidationTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
격리 실행은 작업 소유 root `subtitle-schema-fix.XcftjN`의 init script로 build/project-cache와 테스트 compile/lint
|
||||||
|
입력을 이 변경에 한정한다. production source는 필터링하지 않는다. 기존 테스트와 전체 테스트는 실행하지 않는다.
|
||||||
|
|
||||||
|
실제 격리 실행 명령(RED는 `test`까지만, GREEN은 아래 전체):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export VERIFY_ROOT=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/subtitle-schema-fix.XcftjN
|
||||||
|
export TMPDIR="$VERIFY_ROOT" NODE_COMPILE_CACHE="$VERIFY_ROOT/node-compile-cache"
|
||||||
|
export BUN_RUNTIME_TRANSPILER_CACHE_PATH="$VERIFY_ROOT/bun-transpiler"
|
||||||
|
./gradlew --offline --no-daemon --max-workers=2 \
|
||||||
|
-Pkotlin.compiler.execution.strategy=in-process -Dorg.gradle.jvmargs=-Xmx4g \
|
||||||
|
--project-cache-dir "$VERIFY_ROOT/project-cache" --init-script "$VERIFY_ROOT/verification.init.gradle" \
|
||||||
|
test --tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleSchemaValidationTest' bootJar ktlintCheck
|
||||||
|
```
|
||||||
|
|
||||||
|
로그는 위 root의 `red.log`, `green.log`다. 실제 운영 DB 접속·DDL 변경·서버 배포/재시작·기존 테스트 실행은 하지 않았다.
|
||||||
|
|
||||||
|
## 정리
|
||||||
|
|
||||||
|
검증·리뷰 후 작업 root를 참조하는 프로세스의 부재를 확인하고 소유 root/build/cache/log/JAR를 제거했다.
|
||||||
|
`test ! -e` exit0으로 확인했으며 위 임시 경로는 과거 검증 위치다. 공유 캐시/다른 작업은 변경하지 않았다.
|
||||||
|
새 테스트/원인/명령/결과와 리뷰 기록은 저장소에 남겼고 이번 수정은 커밋하지 않았다.
|
||||||
|
|
||||||
|
## 후속 커밋 검증
|
||||||
|
|
||||||
|
2026-11-11 별도 `/commit-with-validation` 요청으로 요구사항·계획은 `cf31c570`, 수정·회귀 테스트는
|
||||||
|
`c3e5f19c`에 커밋했다. 두 커밋 모두 저장소 메시지 검증 스크립트의 직전·직후 검증을 통과했다.
|
||||||
|
수정 커밋의 pre-commit hook에서 변경 Kotlin 2개 파일의 `ktlintCheck`도 통과했다.
|
||||||
|
|
||||||
|
`./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.subtitle.SubtitleSchemaValidationTest'`를
|
||||||
|
재실행해 `BUILD SUCCESSFUL in 46s`, 테스트 1개/실패 0/오류 0/건너뜀 0을 확인했다.
|
||||||
|
전체 테스트·실제 MySQL 기동·bootJar는 이번 커밋 작업에서 실행하지 않았다. 전체 테스트 사용자 명령은 `./gradlew test`다.
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
-- 자막 Phase 1 미출시 초안. 운영 DB 적용/호환성은 확인하지 않았다.
|
||||||
|
-- 실행 전 deployment-gates.md의 엔티티 대조 및 운영 DB 게이트 승인이 필요하다.
|
||||||
|
-- MySQL 8.0.17 이상, utf8mb4_0900_bin(NO PAD), InnoDB 3072-byte 인덱스 지원이 전제다.
|
||||||
|
-- 대소문자와 후행 공백을 보존하여 eventId 및 S3 bucket/key를 정확히 구별한다.
|
||||||
|
-- source_upload_error_at은 최종 JPA의 TIMESTAMP 선언과 초 단위 정밀도를 맞췄다.
|
||||||
|
|
||||||
|
CREATE TABLE subtitle_job (
|
||||||
|
job_id VARCHAR(36) NOT NULL COMMENT 'Spring 생성 자막 작업 UUID',
|
||||||
|
content_id BIGINT NOT NULL COMMENT '기존 콘텐츠 Long 식별자',
|
||||||
|
source_bucket VARCHAR(255) NOT NULL COMMENT '최초 등록 원본 S3 버킷',
|
||||||
|
source_key VARCHAR(255) NOT NULL COMMENT '최초 등록 원본 S3 객체 키',
|
||||||
|
output_key VARCHAR(255) NOT NULL COMMENT 'MediaConvert 출력 객체 키의 확장자 제외 경로',
|
||||||
|
status VARCHAR(32) NOT NULL COMMENT '자막 작업 상태',
|
||||||
|
error_code VARCHAR(255) NULL COMMENT '자막 처리 오류 코드',
|
||||||
|
error_message TEXT NULL COMMENT '자막 처리 오류 설명',
|
||||||
|
source_upload_error_code VARCHAR(255) NULL COMMENT '원본 업로드 불확실성 오류 코드',
|
||||||
|
source_upload_error_at TIMESTAMP NULL DEFAULT NULL COMMENT '원본 업로드 오류 기록 시각',
|
||||||
|
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각',
|
||||||
|
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각',
|
||||||
|
PRIMARY KEY (job_id),
|
||||||
|
UNIQUE KEY uk_subtitle_job_source (source_bucket, source_key),
|
||||||
|
KEY ix_subtitle_job_content_created (content_id, created_at)
|
||||||
|
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC
|
||||||
|
DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin
|
||||||
|
COMMENT='원본 binding과 자막 작업 상태 및 오류';
|
||||||
|
|
||||||
|
CREATE TABLE subtitle (
|
||||||
|
id BIGINT NOT NULL AUTO_INCREMENT COMMENT '언어별 자막 결과 Long 식별자',
|
||||||
|
job_id VARCHAR(36) NOT NULL COMMENT '소속 자막 작업 UUID',
|
||||||
|
language VARCHAR(35) NOT NULL COMMENT '자막 언어 태그',
|
||||||
|
format VARCHAR(16) NOT NULL COMMENT '자막 파일 형식',
|
||||||
|
s3_bucket VARCHAR(255) NOT NULL COMMENT '자막 결과 S3 버킷',
|
||||||
|
s3_key VARCHAR(255) NOT NULL COMMENT '자막 결과 S3 객체 키',
|
||||||
|
PRIMARY KEY (id),
|
||||||
|
UNIQUE KEY uk_subtitle_job_language (job_id, language),
|
||||||
|
CONSTRAINT fk_subtitle_job FOREIGN KEY (job_id) REFERENCES subtitle_job (job_id)
|
||||||
|
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC
|
||||||
|
DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin
|
||||||
|
COMMENT='작업별 언어별 자막 결과';
|
||||||
|
|
||||||
|
CREATE TABLE subtitle_callback_receipt (
|
||||||
|
event_id VARCHAR(255) NOT NULL COMMENT 'callback 중복 방지 이벤트 식별자',
|
||||||
|
job_id VARCHAR(36) NOT NULL COMMENT 'callback 대상 자막 작업 UUID',
|
||||||
|
body_hash VARCHAR(64) NOT NULL COMMENT '원래 HTTP body bytes의 SHA-256 소문자 16진수',
|
||||||
|
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각',
|
||||||
|
PRIMARY KEY (event_id)
|
||||||
|
) ENGINE=InnoDB ROW_FORMAT=DYNAMIC
|
||||||
|
DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin
|
||||||
|
COMMENT='callback 이벤트와 원본 요청 본문 해시 수신 기록';
|
||||||
|
|
||||||
|
ALTER TABLE content
|
||||||
|
ADD COLUMN latest_subtitle_job_id VARCHAR(36)
|
||||||
|
CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_bin NULL DEFAULT NULL COMMENT '최신 선택 자막 작업 UUID';
|
||||||
@@ -0,0 +1,471 @@
|
|||||||
|
# 메타데이터 자동 번역 신속 반영 구현 계획
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 상태 | 시리즈 상세 동기 번역 포함 구현·기능 검증·독립 리뷰 완료 |
|
||||||
|
| 작성일 | 2026-11-16 |
|
||||||
|
| 요구사항 | [prd.md](prd.md) |
|
||||||
|
| 현재 활성 Goal | 없음 |
|
||||||
|
| 다음 Goal | 없음 |
|
||||||
|
|
||||||
|
## 목표와 제약
|
||||||
|
|
||||||
|
기존 DB 큐에서 감지 후 작업 등록, 최초+5회 재시도, 요청 시 실패 재개, AWS 번역 우선과 1초 워커를 제공한다.
|
||||||
|
Kotlin 1.6.21, Java 17, Spring Boot 2.7.14와 기존 패키지/스키마/API/캐시를 유지한다.
|
||||||
|
새 worktree, 커밋, 배포, 외부 유료 호출은 만들지 않는다. 시작 작업 트리는 깨끗했고 현재 브랜치는 test다.
|
||||||
|
단일 구현 Goal 안에서 파일이 겹치지 않는 작업을 분담하며, Gradle 실행은 부모가 직렬로 관리한다.
|
||||||
|
전체 테스트는 사용자 실행 `./gradlew test`이며 에이전트는 기능별 테스트, ktlintCheck, bootJar만 실행한다.
|
||||||
|
|
||||||
|
## Phase 1: 번역 수명주기와 요청 연결
|
||||||
|
|
||||||
|
- [x] **Task 1.1: 순서·재시도·신속 처리 구현**
|
||||||
|
|
||||||
|
**Goal P1-T1:** 감지 성공부터 실패 소진 후 재요청까지 번역 상태가 요구사항대로 이어진다.
|
||||||
|
|
||||||
|
- 시작 조건: MT-001~007 확정, PRD와 이 계획 준비.
|
||||||
|
- 완료 증거: 아래 RED/GREEN, 트랜잭션 저장/롤백과 재개 검증, 기능별 회귀 통과.
|
||||||
|
- 범위 밖: 감지 자체 새 재시도, 외부 API/브로커 추가, 운영 데이터 일괄 변경, 응답 스키마 변경.
|
||||||
|
|
||||||
|
### 작업 A: 공통 큐와 워커
|
||||||
|
|
||||||
|
파일:
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobScheduler.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobRepository.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorker.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobSchedulerTest.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorkerTest.kt`
|
||||||
|
- 같은 테스트 패키지의 DB 재시도 통합 테스트.
|
||||||
|
|
||||||
|
계약: 기존 scheduleMissingTranslation 시그니처를 유지한다. 기존 FAILED 행만 원자적으로 재개하고 현재 원문 해시를 사용한다.
|
||||||
|
진행 중 작업과 완료 작업은 요청으로 초기화하지 않는다. 워커는 최초 실행 뒤 5회 재시도하며 1/5/15/15/15분 지연을 사용한다.
|
||||||
|
기본 fixedDelay는 1000ms이며 5개 그룹 처리와 SKIP LOCKED claim을 유지한다.
|
||||||
|
|
||||||
|
재개 DB 경계는 `TranslationJobRepository.restartFailedJob(jobId: Long, now: LocalDateTime): Int` 조건부 update다.
|
||||||
|
id와 FAILED 조건으로 4개 필드를 함께 변경하며 persistence context를 자동 clear하지 않는다.
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 행의 상태별 재개, 동시 재개, 5회 재시도 경계와 1초 설정의 실패 테스트 작성.
|
||||||
|
- [x] **RED 확인:** `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest'`에서 의도한 assertion 실패 확인.
|
||||||
|
- [x] **GREEN:** 기존 상태 전이와 DB 경합 경계에서 최소 구현.
|
||||||
|
- [x] **GREEN 확인:** 동일 focused 테스트와 추가 DB 통합 테스트 통과.
|
||||||
|
- [x] **REFACTOR:** 새 중복만 정리하고 캐시/부분 실패 회귀를 기능별 실행.
|
||||||
|
|
||||||
|
### 작업 B: 언어 감지와 콘텐츠 수정
|
||||||
|
|
||||||
|
파일:
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/content/LanguageDetectEvent.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/admin/content/AdminContentService.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/creator/admin/content/CreatorAdminContentService.kt`
|
||||||
|
- 직접 생성자를 쓰는 해당 기능의 테스트 fixture.
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/content/`의 감지 트랜잭션 통합 테스트 및 관련 관리자 수정 테스트.
|
||||||
|
|
||||||
|
계약: 일반 메타데이터 감지 성공 후 ResourceTranslationJobScheduler를 같은 트랜잭션에서 직접 호출한다.
|
||||||
|
커뮤니티의 기존 revision/hash 검증과 after-commit 경로는 보존한다.
|
||||||
|
관리자 제목/설명 변경과 크리에이터 관리자 태그 없는 제목/설명 변경도 커밋 후 번역 이벤트를 발행한다.
|
||||||
|
|
||||||
|
- [x] **RED:** 실제 DB로 감지 후 작업 존재/롤백, 태그 없는 관리자 텍스트 수정의 작업 요청 누락을 재현.
|
||||||
|
- [x] **RED 확인:** 해당 신규 감지 테스트와 관련 관리자 기능 테스트에서 의도한 실패 확인.
|
||||||
|
- [x] **GREEN:** 기존 서비스/리스너에 최소 연결 수정.
|
||||||
|
- [x] **GREEN 확인:** 감지·관리자 수정 focused 테스트 통과.
|
||||||
|
- [x] **REFACTOR:** 커뮤니티 감지/동시성 기능 회귀를 별도 실행하고 기존 보호 확인.
|
||||||
|
|
||||||
|
### 작업 C: 공급자 기본 순서
|
||||||
|
|
||||||
|
파일:
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderSpringConfigurationTest.kt`
|
||||||
|
- 필요한 production 기본값 소유 테스트.
|
||||||
|
- `docs/20261109_감지번역공급자공통화/provider-guide.md`
|
||||||
|
|
||||||
|
계약: 번역 AWS/Papago, 감지 Papago/AWS. 기존 캐시와 fallback 유지.
|
||||||
|
|
||||||
|
- [x] **RED:** 기본 Spring 설정에서 실제 coordinator가 AWS 번역을 선택하고 감지는 Papago를 선택하는 실패 테스트.
|
||||||
|
- [x] **RED 확인:** `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest'`의 선택 결과 실패 확인.
|
||||||
|
- [x] **GREEN:** production 순서와 현재 가이드 변경.
|
||||||
|
- [x] **GREEN 확인:** 같은 테스트 및 provider/coordinator 관련 기능 회귀 통과.
|
||||||
|
- [x] **REFACTOR:** 과거 이력은 보존하고 현재 실행 안내만 정합성 확인.
|
||||||
|
|
||||||
|
### 작업 D: 조회 시 실패 재개
|
||||||
|
|
||||||
|
파일:
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/content/series/ContentSeriesService.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/content/theme/AudioContentThemeService.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/content/category/CategoryService.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/chat/character/controller/ChatCharacterController.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/chat/original/service/OriginalWorkTranslationService.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/community/translation/application/CreatorCommunityTranslationService.kt`
|
||||||
|
- 해당 기능의 기존/신규 focused 테스트.
|
||||||
|
|
||||||
|
최종 HTTP/DB 연결 확인 파일:
|
||||||
|
`src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataTranslationHttpIntegrationTest.kt`.
|
||||||
|
실제 관리자 controller multipart 요청과 Spring 서비스/이벤트/DB를 실행하고 동일 FAILED 행 재개와 필드별 작업 저장을 검증한다.
|
||||||
|
외부 공급자는 호출하지 않고 비동기 executor를 테스트에서 동기 실행하여 커밋 후 동작을 결정적으로 확인한다.
|
||||||
|
|
||||||
|
계약: 기존 번역 요청 진입점에서 현재 원문과 대상 locale의 FAILED를 재개한다. 이전 번역 행이 있어도 요청이 전달된다.
|
||||||
|
원문 fallback과 기존 번역 응답을 유지하고, 관계없는 목록 전체에 번역 요청을 추가하지 않는다.
|
||||||
|
|
||||||
|
추가 공통 파일: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/ResourceTranslationJobScheduler.kt`.
|
||||||
|
읽기 전용 상위 트랜잭션에서도 저장 가능한 `restartFailedResourceTranslations(resourceType, resourceIds: Collection<Long>, targetLanguage)`
|
||||||
|
REQUIRES_NEW 진입점을 사용한다. FAILED 후보가 없으면 원문을 불필요하게 추출하지 않으며, 현재 원문에 해당하는 작업만 재개한다.
|
||||||
|
커뮤니티 쓰기 잠금 안에서는 이 REQUIRES_NEW 읽기 진입점을 호출하지 않고 기존 REQUIRED 예약으로 처리한다.
|
||||||
|
계획 검토에서 제안된 모든 projection/list의 광범위한 변경은 채택하지 않고 PRD의 기존 번역 요청 경계로 한정한다.
|
||||||
|
|
||||||
|
- [x] **RED:** 이전 번역이 존재하는 상태에서도 조회가 현재 원문의 FAILED를 재개하는 실패 테스트.
|
||||||
|
- [x] **RED 확인:** 변경 기능의 focused 테스트에서 의도한 실패 확인.
|
||||||
|
- [x] **GREEN:** 기존 요청 분기의 예약 위치를 조정한다.
|
||||||
|
- [x] **GREEN 확인:** 각 기능 focused 테스트 통과.
|
||||||
|
- [x] **REFACTOR:** 실제 DB 재개 주기와 기존 응답 유지 확인.
|
||||||
|
|
||||||
|
### Phase 1 Gate
|
||||||
|
|
||||||
|
**Goal P1-GATE:** MT-001~007과 직접 영향 기능의 검증/리뷰 증거를 판정한다.
|
||||||
|
|
||||||
|
- 시작 조건: P1-T1의 구현과 focused RED/GREEN 완료.
|
||||||
|
- TDD 예외 사유: Gate는 기존 구현 검증/리뷰이며 새 동작을 추가하지 않는다.
|
||||||
|
- 완료 증거: 기능별 테스트, lint/bootJar, DB 동작 QA, 단일 독립 리뷰와 문서 갱신.
|
||||||
|
- 범위 밖: 전체 테스트, 실 AWS/Papago/IAM 및 운영 MySQL/배포 검증.
|
||||||
|
|
||||||
|
- [x] 번역 공통 패키지 및 언어 감지 캐시 기능 회귀.
|
||||||
|
- [x] 콘텐츠/관리자 수정·시리즈·테마·카테고리·캐릭터/원작·커뮤니티의 직접 영향 기능별 회귀.
|
||||||
|
- [x] `./gradlew --no-daemon ktlintCheck bootJar` 통과.
|
||||||
|
- [x] 실제 트랜잭션의 저장/롤백, 실패 소진 후 조회/수정 재개, 캐시 재사용 QA.
|
||||||
|
- [x] 한 명의 리뷰어가 요구사항/동시성/테스트 증거 검토, 지적 사항 해결.
|
||||||
|
- [x] PRD/계획 완료 상태와 미검증 범위 기록.
|
||||||
|
|
||||||
|
## 검증 기록
|
||||||
|
|
||||||
|
### 후속 Goal P1-T4: 콘텐츠 상세 조회의 언어 감지 선행
|
||||||
|
|
||||||
|
- 시작 조건: MT-010 확정, getDetail의 null/blank 언어 분기 누락과 기존 감지 후 번역 경로 확인.
|
||||||
|
- 목표: 미감지 콘텐츠 상세 조회가 커밋 후 언어 감지를 거쳐 기존 번역 job 등록으로 이어진다.
|
||||||
|
- 완료 증거: null/빈 문자열/공백 회귀 RED/GREEN, 실제 트랜잭션의 언어/job 저장, 기존 상세 번역 회귀 통과.
|
||||||
|
- 범위 밖: API/DB 스키마 변경, 새 감지 job 시스템, 다른 리소스 조회 수정, 운영 일괄 복구, 관련 없는 리팩터링.
|
||||||
|
- 구현 파일: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`.
|
||||||
|
- 테스트 파일: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataTranslationHttpIntegrationTest.kt`.
|
||||||
|
- 기존 회귀: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/AudioContentReadRetryTest.kt`, `src/test/kotlin/kr/co/vividnext/sodalive/content/MetadataLanguageDetectTransactionTest.kt`, `src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt`.
|
||||||
|
- [x] **RED:** 기존 HTTP/DB 테스트에 미감지 상세 조회 시나리오를 추가한다.
|
||||||
|
- [x] **RED 확인:** focused test에서 언어/job 미저장 assertion 실패를 확인한다.
|
||||||
|
- [x] **GREEN:** 기존 이벤트와 활성 tag 값을 사용하는 미감지 분기를 추가한다.
|
||||||
|
- [x] **GREEN 확인:** 동일 focused test에서 상세 원문 응답과 감지 후 번역 job 저장을 확인한다.
|
||||||
|
- [x] **REFACTOR:** 불필요한 정리 없이 관련 회귀 및 ktlintCheck/bootJar 결과를 기록한다.
|
||||||
|
|
||||||
|
진행 기록:
|
||||||
|
- 2026-11-17 변경 전: 아래 4개 클래스 focused 명령 exit 0(42초), 28건 실패/skip 0. 기존 동작의 baseline을 확인했다.
|
||||||
|
- 2026-11-17 RED: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest.shouldDetectMissingLanguageAfterDetailHttpGetCommits*' --console=plain` — exit 1(32초). 3개 입력 모두 HTTP 200과 원문 응답을 유지하지만 커밋 후 감지 언어가 저장되지 않아 실패했다. 증거: `build/detail-language-evidence/red.xml`, `red.log`.
|
||||||
|
- 2026-11-17 GREEN: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' --console=plain` — exit 0(42초), 4건 통과. 증거: `build/detail-language-evidence/green.xml`, `green.log`.
|
||||||
|
- 2026-11-17 관련 회귀: 아래 4개 클래스 focused 명령에 `ktlintCheck bootJar --console=plain`을 함께 실행했다. 테스트 31건 실패/skip 0과 bootJar 성공 후, 새 테스트의 인자 줄바꿈 2곳에서 lint가 실패했다(exit 1, 62초). 해당 줄바꿈만 수정했다.
|
||||||
|
- 2026-11-17 최종 변경 검증: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' ktlintCheck --console=plain` — exit 0(40초), HTTP 4건 통과, Kotlin 테스트 컴파일과 전체 ktlintCheck 성공. production 변경은 없어 bootJar를 반복 실행하지 않았다.
|
||||||
|
- HTTP/DB 관찰: 실제 `GET /audio-content/{id}?timezone=Asia/Seoul`을 MockMvc로 실행했다. null/빈 문자열/공백 각각 HTTP 200, 원문 제목·미리보기 설명·활성 태그 응답을 확인했다. 커밋 전 감지 호출/번역 job 0건, 커밋 후 별도 트랜잭션 재조회에서 `ko`와 title/detail/tags × en/ja의 PENDING job 6건을 확인했다. 감지 stub은 전체 설명과 활성 태그가 정확히 전달될 때만 성공한다.
|
||||||
|
- 검증 한계: 테스트 executor는 동기 실행으로 커밋 경계를 결정적으로 검증하며 실제 외부 AWS/Papago와 운영 MySQL은 호출하지 않았다. LSP 진단 도구가 제공되지 않아 Kotlin 컴파일과 ktlint를 사용했다. 전체 테스트는 미실행, 사용자 실행 명령은 `./gradlew test`다. 독립 리뷰 결과 대기.
|
||||||
|
|
||||||
|
검증 명령:
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest'
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
### 후속 Gate P1-T4-GATE
|
||||||
|
|
||||||
|
- 시작 조건: P1-T4의 RED/GREEN과 관련 회귀 완료.
|
||||||
|
- 완료 증거: HTTP 응답/DB 저장 결과, 변경 diff 확인, 단일 독립 리뷰, 임시 자원 정리.
|
||||||
|
- 범위 밖: 전체 테스트(사용자 실행 `./gradlew test`), 실제 AWS/Papago 호출, 운영 MySQL/배포.
|
||||||
|
- TDD 예외 사유: 구현 후 증거 검토이며 신규 동작은 추가하지 않는다.
|
||||||
|
- [x] 기능 검증·lint/build·리뷰 결과와 미검증 범위를 기록한다.
|
||||||
|
- 2026-11-17 Gate: 단일 독립 리뷰 APPROVE, 차단 사유 없음. 실제 트랜잭션/이벤트 연결, null/empty/blank HTTP 회귀, 전체 설명·활성 태그 사용, 기존 번역 재개와 롤백 보존을 확인했다. `git diff --check` 통과. 프로덕션 변경은 상세 조회 조건문 한 곳이며, 커밋·배포는 하지 않았다.
|
||||||
|
- 2026-11-17 커밋 전 재검증: 위 4개 클래스 focused 명령에 `ktlintCheck --console=plain`을 함께 실행해 exit 0(82초), 테스트 31건 실패/오류/skip 0을 확인했다. ktlintCheck는 UP-TO-DATE, `git diff --check` 통과. 전체 테스트와 외부 AWS/Papago·운영 MySQL은 미검증이며, 전체 테스트 사용자 실행 명령은 `./gradlew test`다.
|
||||||
|
|
||||||
|
### 후속 Goal P1-T3: 콘텐츠 태그 미번역 fallback과 기존 완료 작업 복구
|
||||||
|
|
||||||
|
- 시작 조건: MT-008/009 및 Papago 동일 결과 성공 정책 확정.
|
||||||
|
- 완료 증거: AWS 동일/쉼표 공백 결과와 캐시 배제, Papago 결과 저장, 기존 완료 작업 재개 후 재요청 안정성, 비대상 필드 보호.
|
||||||
|
- 범위 밖: 일반 문장 번역 품질 판단, # 제거/태그 형식 변경, AWS 실계정 비교, 운영 일괄 재번역, 원문 hash 변경.
|
||||||
|
- 공통 결과 검증 파일: `i18n/translation/{TranslateRequest,TranslationCoordinator,SourceTextNormalizer,TranslationJobWorker,TranslationReadModelMaterializer}.kt` (루트 `src/main/kotlin/kr/co/vividnext/sodalive/`).
|
||||||
|
- 캐시 갱신 파일: 같은 패키지의 `TranslationMemory.kt`. 기존 AWS 미번역 캐시가 있는데 새 AWS 결과가 정상인 경우 같은 행의 번역 텍스트만 갱신한다. 정상 캐시와 Papago 확인 결과는 덮어쓰지 않는다.
|
||||||
|
- 복구 파일: 같은 패키지의 `TranslationJobScheduler.kt`, `TranslationJobRepository.kt`, `ResourceTranslationJobScheduler.kt` 및 직접 생성자 fixture.
|
||||||
|
- scoped flag: `TranslateRequest.rejectUnchangedAwsResult: Boolean = false`, `TranslationCoordinator.findCached(..., rejectUnchangedAwsResult: Boolean = false)`. worker/materializer에서 CONTENT/tags만 true로 전달한다.
|
||||||
|
- 비교 함수: `SourceTextNormalizer.hasSameCommaSeparatedText(first: String, second: String): Boolean`; 기존 normalize를 각 쉼표 요소에 적용하고 순서대로 비교한다. 기존 normalize/hash 동작은 그대로다.
|
||||||
|
- 복구 판단: 현재 job 언어/hash 일치, CONTENT/tags/COMPLETED, 저장된 content_translation tags가 원문과 동일한 경우만 검사한다. scoped cache가 저장된 rendered tags와 정확히 같으면 이미 확인된 정상 결과로 보존하고, 그 외에는 조건부 COMPLETED→PENDING으로 복구한다. 작업 ID를 보존하고 retryCount/error/nextRetryAt를 초기화한다.
|
||||||
|
- 현재 원문 태그가 비어 있지 않은데 저장된 응답 행 또는 tags가 누락된 완료 작업도 워커 재조립 대상으로 처리한다. 캐시가 있으면 외부 호출 없이 복구하며 정상 번역된 응답은 유지한다.
|
||||||
|
- read 복구는 기존 ResourceTranslationJobScheduler 재개 경계에서 COMPLETED CONTENT/tags 후보만 추가 조회해 현재 source와 대조한다. 다른 리소스/필드와 PENDING/RUNNING을 초기화하지 않는다.
|
||||||
|
- [x] **RED:** coordinator의 scoped 동일 결과/캐시, 실제 worker+materializer 경계, 이전 완료 작업과 Papago 동일 결과 보존 회귀를 작성하고 실패 확인.
|
||||||
|
- [x] **GREEN:** 최소 결과 판정과 조건부 완료 작업 복구 구현, 같은 focused 테스트 통과.
|
||||||
|
- [x] **REFACTOR:** 직접 영향 번역/감지/read/관리자/커뮤니티 테스트, ktlintCheck/bootJar, DB 시나리오와 단일 gate 리뷰 완료.
|
||||||
|
|
||||||
|
### 후속 Goal P1-T2: 감지도 AWS 우선으로 전환
|
||||||
|
|
||||||
|
- 시작 조건: 사용자가 기존 감지 캐시 유지와 AWS/Papago 순서를 승인했다.
|
||||||
|
- 완료 증거: Spring 기본 감지 AWS 선택, 실제 AWS adapter SDK 응답 처리, AWS 실패 시 Papago, 기존 Papago 캐시 무호출 재사용.
|
||||||
|
- 범위 밖: 감지 알고리즘/confidence/지원 언어/캐시 무효화/번역·재시도 재설계.
|
||||||
|
- production 파일: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt`.
|
||||||
|
- 테스트 파일: 같은 i18n/translation 테스트 패키지의 `LanguageProviderSpringConfigurationTest.kt`, `LanguageProviderIdTest.kt`, `LanguageDetectionProviderTest.kt`, `LanguageProviderCacheEndToEndTest.kt`.
|
||||||
|
- 문서: 기존 PRD 및 `docs/20261109_감지번역공급자공통화/provider-guide.md`.
|
||||||
|
- [x] **RED:** 기본 설정의 AWS 감지와 fallback/cache 회귀 기대를 작성하고 의도한 실패 확인.
|
||||||
|
- [x] **GREEN:** detectionOrder만 AWS/Papago로 변경하고 관련 감지·설정·캐시 테스트 통과.
|
||||||
|
- [x] **REFACTOR:** 현재 가이드 갱신, ktlintCheck/bootJar, 후속 delta 리뷰와 임시 자원 정리.
|
||||||
|
- 검증 명령: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProvider*Test' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'`.
|
||||||
|
|
||||||
|
### 후속 회귀 Goal P1-R1: 다른 원문 언어의 FAILED 보존
|
||||||
|
|
||||||
|
- 시작 조건: gate reviewer가 MT-003의 현재 원문 한정 재개 누락을 확인했다.
|
||||||
|
- 완료 증거: 같은 해시/다른 원문 언어 작업은 직접 예약과 번역 행 없는 조회 모두에서 재개되지 않는다.
|
||||||
|
- 범위 밖: 작업 고유 키/스키마 변경, 이전 언어 데이터 변환, materializer 재설계.
|
||||||
|
- 파일: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobScheduler.kt`,
|
||||||
|
`src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobRetryIntegrationTest.kt`,
|
||||||
|
`src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/OriginalWorkReadRetryTest.kt`.
|
||||||
|
- [x] **RED:** 두 경로의 다른 원문 언어 FAILED 보존 회귀 테스트 추가.
|
||||||
|
- [x] **RED 확인:** 두 테스트 클래스에서 FAILED 기대/PENDING 실제 실패 확인.
|
||||||
|
- [x] **GREEN:** FAILED 재개 조건에 정규화된 현재 원문 언어 일치 추가.
|
||||||
|
- [x] **GREEN 확인:** 두 테스트 클래스 및 직접 영향 scheduler/read/HTTP 테스트 통과.
|
||||||
|
- [x] **REFACTOR:** lint/build 및 차단 사항 delta 재검토 완료.
|
||||||
|
|
||||||
|
- 2026-11-16 기준 상태: Java 17.0.15, 작업 트리 깨끗함, 기존 브랜치 test에서 작업한다.
|
||||||
|
- 구현 전 `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest'`: exit 0, 16초. 기존 Gradle 9 호환성 deprecation 안내가 출력됐다.
|
||||||
|
- 전체 테스트는 미실행이며 사용자 실행 명령은 `./gradlew test`다.
|
||||||
|
- 2026-11-16 RED: worker/scheduler/retry DB/provider Spring/provider ID/coordinator 43건 중 14건이 의도한 assertion으로 실패했다. 기본 600000ms, 조기 FAILED, 기존 FAILED 미재개, Papago 우선이 각 실패 원인이며 컴파일은 성공했다.
|
||||||
|
- 2026-11-16 공급자 GREEN: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderSpringConfigurationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderIdTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProviderCacheEndToEndTest'`: exit 0, 37초. 기본 AWS 선택, Papago 감지 유지, fallback와 실제 H2 캐시/조회 결과 보존을 확인했다.
|
||||||
|
- 2026-11-16 연결 RED와 큐 GREEN: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.content.LegacyCreatorAdminAudioContentCharacterizationTest.shouldRequestTranslationAfterCommitWhenMetadataIsUpdatedWithoutTags*' --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest'`: exit 1, 감지 10건·조회 10건·관리자 수정 8건이 의도한 assertion으로 실패했다. 같은 실행의 worker 13건/scheduler 3건/retry DB 9건은 모두 통과했다. H2에서 기존 FAILED 재개, 동시 요청, RUNNING 선점 뒤 오래된 요청 보호, 자동 재개 금지를 확인했다. H2 claim은 운영 쿼리의 SKIP LOCKED 옵션만 제거한 테스트이며 MySQL 잠금 동작 검증이 아니다.
|
||||||
|
- 2026-11-16 연결 GREEN: 감지 10건, 조회 15건, 관리자 수정 8건, HTTP 1건 통과. 이후 번역/감지 회귀 191건과 직접 영향 기능 회귀 67건(HTTP 1건 중복)을 실행해 총 257개 고유 사례에서 실패/오류/skip 0을 확인했다.
|
||||||
|
- 2026-11-16 최종 lint/build: 첫 main/test 인자 줄바꿈 위반을 변경 부분에서 수정한 뒤 ktlintCheck/bootJar 및 직접 수정 기능 49건을 함께 실행해 exit 0을 확인했다. HTTP test는 이벤트 발행을 끊는 변이로 DB assertion RED도 확인하고 원상 복구했다.
|
||||||
|
- 정확한 회귀 명령·QA 관찰값·원본 증거 경로·H2/Redis 로그 한계는 [검증 기록](reviews/verification.md)에 보존한다. 현재 단일 독립 reviewer 판정 대기다.
|
||||||
|
- 2026-11-16 P1-R1: reviewer가 일반 예약 경로에서 이전 원문 언어의 FAILED도 재개하는 누락을 확인했다. 직접 scheduler와 번역 행 없는 원작 조회 2건의 RED를 확인하고 원문 언어 일치 guard를 추가했다. 직접 영향 74건과 ktlintCheck/bootJar는 exit 0이며 추가 2건을 포함한 고유 검증 사례는 259건이다. delta 재검토 대기.
|
||||||
|
- 2026-11-16 최종 Gate: 동일 독립 reviewer가 P1-R1 수정과 RED/GREEN/XML 74건 및 lint/build 증거를 대조해 APPROVE했다. 차단 사항 없음. 전체 테스트와 운영 MySQL/외부 공급자 검증은 별도이며 커밋·배포는 하지 않았다.
|
||||||
|
- 2026-11-16 P1-T2: 감지 AWS 우선 변경 전 기본값/실제 SDK adapter/기존 캐시 관련 7개 assertion RED를 확인했다. detectionOrder 한 줄 변경 후 명시된 감지·공급자·캐시 기능 테스트 49건(8개 클래스, 실패/오류/skip 0) 및 ktlintCheck/bootJar가 exit 0이다. 후속 delta 리뷰 대기.
|
||||||
|
- 2026-11-16 P1-T2 최종: 독립 reviewer APPROVE. 현재 가이드의 잔여 PAPAGO 우선 테스트 설명도 AWS로 정정했다. 이전 기능 검증 기록과 완료 상태를 보존하며, 후속 감지 변경까지 완료했다.
|
||||||
|
- 2026-11-16 P1-T3 forward RED: H2 JSON을 로딩하는 fixture cleanup 실패를 bulk cleanup으로 고친 뒤, ContentTagTranslationIntegrationTest 8건 중 6건이 AWS 원문 동일 결과/캐시를 성공으로 인정하는 원인으로 실패했다. 설정 오류를 RED 증거로 간주하지 않았다.
|
||||||
|
- 2026-11-16 P1-T3 forward GREEN: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest'`: exit 0, 29건. 콘텐츠 태그에만 적용한 판정과 Papago 결과 저장/캐시 조립을 확인했다.
|
||||||
|
- 2026-11-16 P1-T3 repair RED: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.CompletedContentTagRepairTest'`: 27건 중 11건이 COMPLETED 재개 누락으로 실패했다. 정상 번역/다른 필드/다른 언어/진행 상태/Papago 동일 결과 보호 16건은 통과했다.
|
||||||
|
- 2026-11-16 P1-T3 repair GREEN: 완료 작업 복구 27건과 forward 9건 통과. 이후 기존 미번역 AWS 캐시 뒤 정상 AWS 결과 갱신 실패를 추가 RED로 확인하고 같은 캐시 행의 translatedText만 갱신했다.
|
||||||
|
- 2026-11-16 P1-T3 최종 검증: 공통 회귀 232건 통과 후 새 조건문 braces lint 3건을 수정했다. 조회→worker→재조회 연속 DB 사례까지 추가한 최종 직접 영향 회귀 104건과 ktlintCheck/bootJar가 exit 0이다. 고유 사례 277건이며 명령/증거/한계는 [태그 fallback 검증 기록](reviews/tag-fallback-review.md)에 있다. 독립 리뷰 대기.
|
||||||
|
- 2026-11-16 P1-T3 최종 Gate: 단일 독립 reviewer가 MT-008/009와 전체 태그 처리/캐시/완료 복구/경합 보호 및 실행 증거를 확인해 APPROVE했다. 차단 사항 없음. 이번 태그 후속 변경은 커밋·배포하지 않았다.
|
||||||
|
- 2026-11-16 커밋 전 검증: 사용자 커밋 요청에 따라 번역·감지 및 직접 영향 기능을 함께 재실행했다. 33개 클래스 261건의 실패/오류/skip 0, ktlintCheck/bootJar는 UP-TO-DATE, 전체 명령은 exit 0(2분 3초)이다. 정확한 명령은 [검증 기록](reviews/verification.md)의 커밋 전 재검증 절에 남긴다. 전체 테스트는 미실행이며 사용자 실행 명령은 `./gradlew test`다.
|
||||||
|
- 2026-11-17 P1-T3 커밋 전 재검증: 번역 패키지와 직접 영향 감지·커뮤니티·OSIV 기능 32개 클래스 277건을 실행해 실패/오류/skip 0을 확인했다. ktlintCheck/bootJar는 UP-TO-DATE, 명령은 exit 0(1분 17초), `git diff --check`도 통과했다. 정확한 명령은 [태그 검증 기록](reviews/tag-fallback-review.md)의 커밋 전 재검증 절에 남긴다. 전체 테스트와 실제 외부 공급자·운영 MySQL은 미검증이며 전체 테스트는 사용자 실행 `./gradlew test`로 구분한다.
|
||||||
|
|
||||||
|
### Phase 2: 콘텐츠 상세의 동기 번역
|
||||||
|
|
||||||
|
- [x] **Task 2.1: 최초 상세 응답에 번역 결과 제공**
|
||||||
|
|
||||||
|
**Goal P2-T1:** 미번역 콘텐츠 상세 조회가 요청 언어의 제목·설명·태그를 동기 번역해 저장하고 같은 HTTP 응답으로 제공하며, 실패해도 원문과 기존 재시도를 유지한다.
|
||||||
|
|
||||||
|
- 시작 조건: MT-011~014 사용자 승인, 변경 전 상세/worker/tag 테스트 통과.
|
||||||
|
- 완료 증거: 아래 RED/GREEN 및 직접 영향 회귀, 실제 HTTP 응답과 별도 DB 재조회.
|
||||||
|
- 범위 밖: 목록·다른 리소스의 처리 변경, 새로운 큐/의존성/스키마, 운영 데이터 및 유료 공급자 호출, 커밋/배포, 공급자 timeout 설정 변경.
|
||||||
|
- 실행: `subagent-driven-development`의 단일 구현 단위로 순차 TDD. 파일/DB를 공유하므로 구현자를 병렬 실행하지 않는다. 부모가 후속 실제 HTTP QA와 단일 gate 리뷰를 담당한다.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`의 상세 번역 분기와 응답 languageCode 매핑.
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentDetailTranslationService.kt`의 상세 전용 동기 조립 경계.
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationMemoryService.kt`에 worker의 기존 캐시·번역·저장 로직 이동.
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorker.kt`의 공용 메모리 서비스 사용.
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationReadModelMaterializer.kt`의 CONTENT 저장에 짧은 row lock을 사용하고, `TranslationSourceExtractor.kt`의 콘텐츠 원문 태그를 상세의 활성 태그 기준과 일치시킨다.
|
||||||
|
- 필요 시 저장 경합의 최소 보정: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationMemoryRepository.kt`, `src/main/kotlin/kr/co/vividnext/sodalive/content/translation/ContentTranslationRepository.kt`.
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentDetailTranslationHttpIntegrationTest.kt` 신규 Spring HTTP/DB 통합 테스트.
|
||||||
|
- Test fixture: 같은 테스트 디렉터리의 `ContentDetailTranslationTestConfiguration.kt`에 전용 profile의 HTTP/DB 구성과 외부 공급자 대체를 둔다.
|
||||||
|
- Update: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataTranslationHttpIntegrationTest.kt`의 비동기 감지 기대를 승인된 동기 계약으로 변경한다. 관리자 수정 사례를 보존한다.
|
||||||
|
- Update: 위 번역 테스트 패키지의 `AudioContentReadRetryTest.kt`, `TranslationJobWorkerTest.kt`, `TranslationJobRetryIntegrationTest.kt`, `ContentTagTranslationIntegrationTest.kt`, `LanguageProviderCacheEndToEndTest.kt` 및 `src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt` 등 영향받는 직접 생성자/Spring import fixture만 갱신한다.
|
||||||
|
|
||||||
|
**Interfaces 및 구현 기준:**
|
||||||
|
|
||||||
|
- `AudioContentDetailTranslationService.resolve(contentId: Long, targetLanguage: String): AudioContentDetailTranslationResult`는 원문 언어와 nullable `TranslatedContent`를 반환한다. HTTP DTO는 변경하지 않는다.
|
||||||
|
- `TranslationMemoryService.ensureMemory(resourceType, fieldKey, sourceText, sourceLanguage, targetLanguage)`는 기존 `TranslationJobWorker.ensureMemory`의 의미를 보존한다. 캐시/태그 판정을 복제하지 않는다.
|
||||||
|
- 상세 번역은 Spring proxy의 `NOT_SUPPORTED` 경계로 상세 트랜잭션과 분리하고 짧은 별도 트랜잭션에서 감지 결과/메모리/최종 payload를 저장한다. commit 오류는 트랜잭션 밖에서 처리한다. 외부 번역 중 DB write lock을 유지하지 않는다.
|
||||||
|
- 감지는 전체 제목·설명·활성 태그로 기존 `LanguageDetectionCacheService`를 호출한다. 언어 저장 시 현재 값과 원문을 재확인하며 다른 요청이 저장한 언어를 덮어쓰지 않는다. 외부 트랜잭션의 managed entity에는 따로 저장한 언어를 다시 할당하지 않고 반환값을 응답에 사용한다.
|
||||||
|
- 기존 번역이 있으면 반환하고 기존 FAILED/태그 복구 의미를 유지한다. 없으면 요청 언어의 누락 필드만 동기 번역하고 `TranslationReadModelMaterializer`로 완성한다. 동일 언어/미지원 언어·빈 필드는 기존 규칙대로 처리한다.
|
||||||
|
- 동기 성공에 새 요청 언어 job은 필수로 만들지 않는다. 동기 실패 시 기존 scheduler로 등록/재개하고 원문 반환한다. 언어 감지 실패는 기존 after-commit 이벤트를 이용한다. 새로운 감지 재시도 체계는 만들지 않는다.
|
||||||
|
- 동시 요청/worker의 유일키 경쟁은 별도 트랜잭션의 canonical winner 재조회 또는 기존 DB 원자 연산으로 처리한다. 일반 무결성 오류를 성공으로 처리하지 않는다. 중복 provider 호출 자체를 막는 새 분산 lock은 추가하지 않는다.
|
||||||
|
- worker의 claim/상태 변경/6회 시도/backoff는 변경하지 않는다. materialize의 false를 완성된 번역으로 반환하지 않는다.
|
||||||
|
|
||||||
|
**시나리오 계약:**
|
||||||
|
|
||||||
|
| 사례 | 통과 조건 | 검증 표면 |
|
||||||
|
|---|---|---|
|
||||||
|
| 최초 조회와 재조회 | 첫 HTTP 200의 translated.title/detail/tags와 저장 payload 일치, 재조회는 공급자 재호출 없이 같은 결과 | RANDOM_PORT 상세 GET, 별도 DB 트랜잭션 |
|
||||||
|
| 언어 미감지와 경계 | null/empty/blank 언어를 감지 후 같은 요청에서 번역, 동일 언어/미지원 언어는 원문, 빈 필드는 빈 문자열 | 상세 GET 및 감지 캐시/콘텐츠 DB |
|
||||||
|
| 실패와 복구 | 공급자/저장 실패 시 원문 HTTP 200, outer commit 성공, 기존 job 등록 후 worker로 복구 | 상세 GET, 실제 persistence 실패, job/worker/재조회 |
|
||||||
|
| 인접 동작과 경합 | 기존 AWS 태그 fallback·캐시·worker 정책 보존, 동시 요청 저장 후 고유 키당 한 행과 재사용 가능한 번역 | 기존 focused tests, latch 기반 별도 트랜잭션 |
|
||||||
|
|
||||||
|
- [x] **RED:** 최초 동기 응답, 언어 감지, 실패 fallback을 실제 서비스/DB에 연결한 HTTP 테스트로 작성한다. 공급자만 대체하며 로직은 실제로 실행한다.
|
||||||
|
- [x] **RED 확인:** `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --console=plain`에서 번역 없는 응답의 의도한 assertion 실패를 확인한다.
|
||||||
|
- [x] **GREEN:** 공유 메모리 로직과 상세 전용 경계로 최소 구현한다. 필요 경합/실패 회귀를 먼저 RED로 확인한다.
|
||||||
|
- [x] **GREEN 확인:** 같은 focused 명령에서 첫 응답/저장/재사용/실패/경합을 통과한다.
|
||||||
|
- [x] **REFACTOR:** 생성자 fixture와 기존 비동기 감지 계약만 갱신하고 직접 영향 회귀를 실행한다. 승인 범위 밖 파일 정리는 하지 않는다.
|
||||||
|
|
||||||
|
### Phase 2 Gate
|
||||||
|
|
||||||
|
**Goal P2-GATE:** 상세 API의 승인된 동작과 기존 번역 회귀, 빌드/포맷, 단일 독립 리뷰 및 임시 자원 정리를 완료한다.
|
||||||
|
|
||||||
|
- 시작 조건: P2-T1 체크박스와 RED/GREEN 증거 완료.
|
||||||
|
- 완료 증거: 아래 명령과 HTTP 관찰 결과, 단일 리뷰에 차단 사유 없음, 소유 임시 디렉터리/프로세스 제거.
|
||||||
|
- TDD 예외 사유: 검증/리뷰 Goal이며 새 기능을 구현하지 않는다.
|
||||||
|
- 범위 밖: 전체 테스트, 실제 외부 공급자·운영 MySQL·배포 검증.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --console=plain
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' --console=plain
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar --console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
- [x] 실제 상세 GET 응답과 committed DB/재시도 결과를 기록한다.
|
||||||
|
- [x] 직접 영향 회귀 및 ktlintCheck/bootJar 성공 또는 외부 제한의 근거를 기록한다. LSP 도구는 제공되지 않아 Kotlin 컴파일과 ktlint로 대체한다.
|
||||||
|
- [x] 단일 reviewer의 요구사항/트랜잭션/동시성/테스트 검토를 완료한다.
|
||||||
|
- [x] 임시 RUN_TMP, 테스트/QA 자원을 정리하고 PRD/계획 상태를 완료로 기록한다.
|
||||||
|
- 전체 테스트는 에이전트 미실행이며 사용자 실행 명령은 `./gradlew test`다.
|
||||||
|
|
||||||
|
### P2 진행 기록
|
||||||
|
|
||||||
|
- 2026-11-17 baseline: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' --console=plain` — exit 0, 37초. 기존 상세/worker/tag 동작이 통과했다. Gradle 9 호환 deprecation 안내는 기존 상태다.
|
||||||
|
- 2026-11-17 계획 결정: 같은 상세 감지 기능의 연속 작업이므로 신규 문서 디렉터리 대신 이 PRD/계획에 P2를 추가했다. 기존 완료 기록은 보존한다. 계획 agent 제안 중 성공 시 무조건 job 예약·여러 리뷰·추가 추상화는 채택하지 않고 승인된 최소 범위로 제한한다.
|
||||||
|
- 2026-11-17 P2-T1 RED: 신규 RANDOM_PORT HTTP 테스트 7건 중 5건이 `expected: <English title> but was: <null>`로 실패했다(exit 1, 34초). production 변경 전 최초 응답·감지 null/empty/blank·cache-only 요구 부재를 확인했다. 테스트 구성 오류 3회는 RED 근거에 포함하지 않는다.
|
||||||
|
- 2026-11-17 P2-T1 추가 RED: `AudioContentDetailTranslationHttpIntegrationTest.shouldRestartOnlyExistingFailedJobAfterSynchronousSuccess`에서 번역 성공 후 기존 FAILED가 유지되어 `expected: <PENDING> but was: <FAILED>`로 실패했다(exit 1, 38초). 성공 시에도 새 job 없이 기존 FAILED/태그 유지보수만 수행하도록 보완했다.
|
||||||
|
- 2026-11-17 P2-T1 GREEN: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' --tests 'kr.co.vividnext.sodalive.osiv.OsivLazyLoadingRegressionTest' --console=plain` — exit 0, 3분 5초. 30개 클래스 277건, 실패/오류/skip 0. 부모가 `build/reports/tests/test/index.html` 및 신규 HTTP 15건/worker 13건 XML을 직접 확인했다.
|
||||||
|
- 2026-11-17 P2-GATE 1차 lint/build: `./gradlew --no-daemon ktlintCheck bootJar --console=plain` — exit 1, 21초. 새 Kotlin 코드의 인자 줄바꿈/130자 초과로 ktlintMainSourceSetCheck 실패. bootJar 완료로 간주하지 않으며 변경된 파일의 포맷만 수정한다.
|
||||||
|
- 구현 상세: NOT_SUPPORTED 상세 경계와 짧은 REQUIRES_NEW 저장으로 commit 실패를 격리한다. 실제 CHECK 제약 위반에서 원문 HTTP 200과 job 복구를 확인했다. 동시 상세 2건/worker 1건은 실제 H2 유일키 충돌 후 메모리 3행·payload 1행으로 수렴했다. H2 JSON fixture는 converter 문자열 재조회용 varchar이며 운영 MySQL JSON/잠금 검증은 아니다.
|
||||||
|
- 2026-11-17 포맷/정리: 변경 파일의 줄바꿈·130자 제한만 수정했다. 상세 변경으로 고아가 된 AudioContentService의 ResourceTranslationJobScheduler 생성자 의존성을 제거하고 직접 생성자 테스트 2곳을 맞췄다. ContentTranslationRepository는 목록 사용처가 있어 유지했다. `./gradlew --no-daemon ktlintCheck --console=plain` — exit 0, 21초.
|
||||||
|
- 2026-11-17 부모 QA/빌드: 임시 Gradle init task로 기존 테스트 context와 fixture를 띄우고 Java HttpClient에서 상세 GET을 직접 호출했다. 최초 번역·DB 저장·재조회, 미감지 언어, 공급자 실패→worker 복구, 실제 DB CHECK 실패→worker 복구가 모두 HTTP 200과 기대 번역으로 확인됐다. 첫 실행은 bootJar/컴파일과 모든 기능 assertion은 성공했으나 임시 QA runner의 afterTestClass 호출을 context 종료 뒤에 둬 종료 코드 1이었다. runner 종료 순서만 수정했다.
|
||||||
|
- 2026-11-17 최종 QA/생성자 회귀: `./gradlew --no-daemon -I "$RUN_TMP/qa.init.gradle" runContentDetailQa test --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --console=plain` — exit 0. 실제 HTTP QA 전체 통과, 생성자 정리 영향 테스트 17건 실패/skip 0. 277건 전체 기능 범위는 앞선 실행 결과이며 포맷/미사용 생성자 제거 후 변경 영향만 재검증했다.
|
||||||
|
- 최종 실제 HTTP 응답·QA 관찰·리뷰 판정은 [동기 상세 검증 기록](reviews/synchronous-detail-review.md)에 보존한다. LSP 도구·실제 공급자·운영 MySQL은 미검증, 전체 테스트는 사용자 실행 `./gradlew test`다.
|
||||||
|
- 2026-11-17 P2-GATE 리뷰: 단일 Oracle reviewer APPROVE. MT-011~014 충족, API/DB/worker 정책 보존과 실제 HTTP/DB 실패·경합 증거를 확인했고 차단 사항이 없다. 구매 전 translated.detail이 전체 payload인 기존 계약을 변경하지 않았음을 확인했다. 운영 MySQL JSON/1062/잠금 및 실제 공급자 지연은 미검증 범위다. 신규 테스트 명령 예시는 `docs/agent-guides/실행명령어.md`에 추가했다.
|
||||||
|
- 2026-11-17 P2-GATE 정리 완료: 부모 QA runner/test worker/Gradle wrapper가 없고 HTTP 포트 58600에 listener가 없음을 확인했다. 검증 결과와 응답 발췌를 문서에 보존한 뒤 부모 RUN_TMP의 Java/init script·class·로그·notepad를 삭제하고 디렉터리 부재를 확인했다(exit 0). 구현자 임시 root 2개도 제거했으며 공유 캐시/기존 IDE daemon은 건드리지 않았다. 커밋·배포는 하지 않았다.
|
||||||
|
- 2026-11-17 P2 커밋 전 재검증: 사용자 커밋 요청에 따라 상세 동기 번역·번역 패키지·감지·OSIV 직접 영향 범위 30개 클래스 277건을 재실행해 실패/오류/skip 0을 확인했다. `ktlintCheck`와 `bootJar`는 UP-TO-DATE, 전체 명령은 exit 0(2분 22초), `git diff --check`도 통과했다. 정확한 명령은 [동기 상세 검증 기록](reviews/synchronous-detail-review.md)의 커밋 전 재검증 절에 남긴다. 전체 테스트·실제 공급자·운영 MySQL은 미검증이며 전체 테스트는 사용자 실행 `./gradlew test`다.
|
||||||
|
|
||||||
|
## Phase 3: 상세 연관 콘텐츠의 저장된 번역 제목
|
||||||
|
|
||||||
|
**목표:** 상세의 이전화/다음화와 두 추천 목록에서 요청 언어에 맞는 저장된 제목이 표시된다.
|
||||||
|
**설계:** 기존 조회 결과의 ID를 모아 ContentTranslationRepository로 한 번 조회하고 OtherContentResponse를 copy한다.
|
||||||
|
원문 기반 탐색·정렬과 DTO 스키마를 보존하며, 공통 서비스나 새 의존성을 추가하지 않는다.
|
||||||
|
**기준:** PRD MT-015~016. 기존 상세 번역 작업의 연속 수정이므로 문서를 재사용한다.
|
||||||
|
|
||||||
|
- [x] **Task 3.1: 연관 콘텐츠 제목 번역 누락 수정**
|
||||||
|
|
||||||
|
**Goal P3-T1:** 네 응답 필드의 title은 현재 언어의 비어 있지 않은 저장 번역이며 없으면 기존 원문이다.
|
||||||
|
- 시작 조건: 사용자 최소 범위 승인, 기존 코드 및 HTTP 테스트 확인.
|
||||||
|
- 완료 증거: 실제 결함의 RED, 동일 HTTP 테스트 GREEN, 직접 영향 회귀.
|
||||||
|
- 범위 밖: 새 번역 생성, 공급자/작업 큐 변경, navigation 정렬 변경, DTO 확장, 전체 테스트.
|
||||||
|
|
||||||
|
Files:
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentDetailTranslationHttpIntegrationTest.kt`
|
||||||
|
- Test configuration: `src/test/kotlin/kr/co/vividnext/sodalive/content/ContentDetailTranslationTestConfiguration.kt`
|
||||||
|
|
||||||
|
Interfaces: `findByContentIdInAndLocale(contentIds, locale)`와 기존 `OtherContentResponse(contentId, title, coverUrl)`를 사용한다.
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 HTTP 테스트를 먼저 실행한 뒤 네 필드의 번역 선택과 fallback 회귀를 같은 테스트 클래스에 추가한다.
|
||||||
|
- [x] **RED 확인:** 새 번역 시나리오가 원문 제목 반환 assertion으로 실패함을 확인한다.
|
||||||
|
- [x] **GREEN:** getDetail에서 중복 제거한 관련 ID의 번역을 일괄 조회하고 비어 있지 않은 제목만 응답에 적용한다.
|
||||||
|
- [x] **GREEN 확인:** 같은 HTTP 테스트를 실행해 모든 필드가 기대 번역 또는 원문인 것을 확인한다.
|
||||||
|
- [x] **REFACTOR:** 직접 영향 기능 테스트 및 Kotlin 컴파일/ktlint 검증을 수행한다. 새 추상화나 무관한 정리는 하지 않는다.
|
||||||
|
|
||||||
|
### 시나리오 계약
|
||||||
|
|
||||||
|
1. 저장된 en/ja 제목: 실제 `GET /audio-content/{id}?timezone=UTC`를 en→ja→en으로 호출할 때 네 필드의 제목이 각 locale 값과 정확히 일치한다. ID·순서·coverUrl은 변하지 않는다.
|
||||||
|
2. fallback: 번역 없음·다른 locale만 존재·빈 제목·공백 제목에서 해당 항목은 원문이다. 연관 콘텐츠 때문에 공급자 호출 또는 번역 job이 추가되지 않는다.
|
||||||
|
3. 인접 회귀: 시리즈 없는 콘텐츠는 previousContent/nextContent가 null이고 관련 콘텐츠가 없으면 목록은 비어 있다. 본문 상세 번역과 기존 언어 감지·실패 복구 테스트는 통과한다.
|
||||||
|
|
||||||
|
### Phase 3 Gate
|
||||||
|
|
||||||
|
**Goal P3-GATE:** 승인된 네 필드의 HTTP 동작과 최소 변경 범위를 독립 검토하고 종료한다.
|
||||||
|
- 시작 조건: P3-T1 완료.
|
||||||
|
- 완료 증거: 아래 focused tests, 실제 HTTP JSON 관찰, lint/build, 단일 리뷰 판정과 임시 자원 정리 기록.
|
||||||
|
- 범위 밖: 운영 데이터 변경, 전체 테스트, 유료 공급자 호출.
|
||||||
|
- TDD 예외 사유: Gate는 구현이 아니라 결과 검증이다.
|
||||||
|
- 대체 검증 방법: HTTP 응답/테스트 결과/변경 diff 대조.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --console=plain
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar --console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
- [x] 실제 HTTP 응답에서 세 시나리오의 결과를 확인하고 기록한다.
|
||||||
|
- [x] 직접 영향 테스트와 ktlintCheck/bootJar 결과를 기록한다. LSP 도구가 제공되지 않으면 Kotlin 컴파일/ktlint 대체 사실을 명시한다.
|
||||||
|
- [x] 단일 독립 리뷰에서 차단 사항이 없음을 확인한다.
|
||||||
|
- [x] 작업 소유 임시 파일과 QA 자원을 정리하고 문서 상태를 갱신한다.
|
||||||
|
- 종료 조건: 위 시나리오가 실제 HTTP로 확인되고 관련 테스트 통과, 가능한 진단/빌드의 결과 및 한계 기록, 리뷰 승인과 임시 자원 정리가 끝나면 즉시 종료한다.
|
||||||
|
- 전체 테스트는 사용자 실행 `./gradlew test`이며 기능 범위 완료와 구분한다.
|
||||||
|
|
||||||
|
### P3 진행 기록
|
||||||
|
|
||||||
|
- 2026-11-17 조사/승인: 네 projection이 원문 title을 반환하고 상세 조립에 번역 적용이 없음을 확인했다. 기존 목록의 batch lookup 및 blank fallback을 재사용한다. 사용자가 저장된 번역만 적용하는 범위를 승인했다. 시작 작업 트리는 깨끗하다.
|
||||||
|
- 2026-11-17 baseline: 기존 `AudioContentDetailTranslationHttpIntegrationTest` 15건 통과(exit 0, 29초).
|
||||||
|
- 2026-11-17 P3-T1 RED: 테스트만 추가한 뒤 같은 HTTP 클래스 21건 중 1건 실패(exit 1, 38초). `shouldLocalizeRelatedTitlesForEachRequestedLanguageWithoutChangingNavigation`에서 previousContent의 기대 제목 `en 가 이전` 대신 `가 이전` 반환을 확인했다. ID와 coverUrl은 일치했다.
|
||||||
|
- 2026-11-17 P3-T1 GREEN: 위 Gate의 세 클래스 focused 명령 exit 0(51초). 상세 HTTP 21건, AudioContentServiceTest 16건, AudioContentReadRetryTest 1건으로 38건 전부 통과(실패/오류/skip 0). 부모가 XML 세 파일을 직접 확인했다. en→ja→en, 네 필드의 fallback·ID·cover·null/빈 목록, distinct 배치 1회/빈 경우 0회, 관련 공급자 호출·job 추가 없음이 검증됐다. 랜덤 추천 목록은 ID별로 대조하고, 각 요청의 순서는 서비스 map이 보존한다.
|
||||||
|
- 2026-11-17 lint/build 1차: `./gradlew --no-daemon ktlintCheck bootJar --console=plain` exit 1(25초). 신규 HTTP 테스트 두 표현식의 130자 초과 및 인자 줄바꿈 오류로 ktlintTestSourceSetCheck 실패. 제품 로직의 실패는 아니며 bootJar 성공으로 기록하지 않는다. 해당 표현식의 포맷만 수정하고 재검증한다.
|
||||||
|
- 2026-11-17 P3-GATE 부모 QA/lint/build: 인자 줄바꿈만 수정 후 `./gradlew --no-daemon -I "$TMPDIR/qa.init.gradle" runRelatedContentQa ktlintCheck bootJar --console=plain` exit 0(50초). Kotlin 테스트 재컴파일, ktlintCheck 및 bootJar 성공. 임시 Java HttpClient에서 실제 Tomcat 포트 59748로 GET 5회를 호출해 en→ja→en, 혼합 fallback, 빈 관계와 본문 번역 보존을 확인했다. 기존 38건의 동작 검증은 그대로 유효하며 포맷 수정 후 실제 HTTP QA로 추가 확인했다. 상세 증거는 [연관 콘텐츠 검증 기록](reviews/related-content-title-review.md)에 보존한다.
|
||||||
|
- 2026-11-17 P3-GATE 리뷰: 단일 Oracle reviewer APPROVE(신뢰도 높음), 차단 사항 없음. 네 필드의 요청 언어/fallback·조회 계약·번역 부작용 없음과 XML/실제 HTTP 증거를 확인했다. 부모가 QA PID 85049 부재, TCP 59748 listener 없음, 구현자 임시 root 부재를 확인했다.
|
||||||
|
- 2026-11-17 P3-GATE 완료: 실제 응답 및 리뷰 결과를 문서에 보존한 뒤 부모 `content-translation.TfjAph` root의 QA Java/init script·class·보고서와 별도 ulw 노트를 삭제했다(exit 0). 경로 부재를 확인했으며 공유 캐시와 작업 외 파일은 유지했다. 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이다. 전체 테스트는 사용자 실행 `./gradlew test`다. 커밋은 하지 않았다.
|
||||||
|
- 2026-11-17 P3 커밋 전 재검증: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' ktlintCheck bootJar --console=plain` exit 0(1분 1초). XML 세 파일에서 38건(21/16/1) 성공, 실패/오류/skip 0을 확인했다. `ktlintCheck`와 `bootJar`는 UP-TO-DATE이며 `git diff --check`도 통과했다. 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이며 전체 테스트는 사용자 실행 `./gradlew test`다.
|
||||||
|
|
||||||
|
## Phase 4: 시리즈 상세의 동기 감지·번역
|
||||||
|
|
||||||
|
**목표:** 첫 시리즈 상세 응답에 요청 언어의 제목·소개·키워드가 저장 후 반환된다.
|
||||||
|
**기준:** PRD MT-017~018, 사용자 "시리즈 자체만" 승인. 열린 요구사항 없음.
|
||||||
|
**설계:** 콘텐츠 상세의 NOT_SUPPORTED + REQUIRES_NEW 패턴을 시리즈 resolver에 적용한다.
|
||||||
|
기존 감지 캐시, TranslationMemoryService, TranslationReadModelMaterializer와 SERIES 이벤트/재시도 경로를 재사용한다.
|
||||||
|
새 worktree 없이 깨끗한 `test` 브랜치의 기존 작업 위치에서 수행하며 커밋은 하지 않는다.
|
||||||
|
|
||||||
|
- [x] **Task 4.1: 시리즈 상세 동기 번역 연결**
|
||||||
|
|
||||||
|
**Goal P4-T1:** 시리즈 메타데이터의 미감지·미번역을 같은 HTTP 응답 전에 처리하고 실패 시 원문과 기존 복구를 유지한다.
|
||||||
|
- 시작 조건: 승인된 MT-017~018 및 콘텐츠 상세의 구현·HTTP 테스트 조사 완료.
|
||||||
|
- 완료 증거: 요구 동작의 RED/GREEN, 실제 HTTP 및 DB 재조회, 직접 영향 회귀 통과.
|
||||||
|
- 범위 밖: 하위 콘텐츠 신규 번역, 공개 스키마/공급자 설정/DB 변경, 콘텐츠 resolver 리팩터링, 전체 테스트.
|
||||||
|
|
||||||
|
Files:
|
||||||
|
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/content/series/ContentSeriesDetailTranslationService.kt`
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/series/ContentSeriesService.kt`
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationReadModelMaterializer.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/content/ContentSeriesDetailTranslationHttpIntegrationTest.kt`
|
||||||
|
- Test configuration: `src/test/kotlin/kr/co/vividnext/sodalive/content/ContentDetailTranslationTestConfiguration.kt`
|
||||||
|
- Test fixture: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/ContentSeriesReadRetryTest.kt`
|
||||||
|
- Test command guide: `docs/agent-guides/실행명령어.md`
|
||||||
|
|
||||||
|
Interfaces:
|
||||||
|
- `ContentSeriesDetailTranslationService.resolve(seriesId: Long, targetLanguage: String): ContentSeriesDetailTranslationResult`
|
||||||
|
- 결과는 `languageCode: String?`, `translated: TranslatedSeries?`, `detectionQuery: String?`를 가진다.
|
||||||
|
- snapshot은 기존 extractor와 동일하게 title/introduction/keywords(`joinToString(", ")`)를 사용한다.
|
||||||
|
- 감지 query는 제목·전체 소개·공백으로 이은 키워드의 비어 있지 않은 텍스트를 합친다.
|
||||||
|
- 외부 호출은 쓰기 잠금 밖에서 수행한다. 감지 저장과 materialize 직전에 Series 잠금 및 snapshot 비교로 원문 경합을 막는다.
|
||||||
|
- materializer의 `upsertSeries`도 기존 content와 같은 부모 row 잠금으로 worker/상세의 upsert를 직렬화한다.
|
||||||
|
- 기존 서비스의 번역 블록을 resolver 호출로 교체하고 감지 실패는 기존 SERIES LanguageDetectEvent로 넘긴다.
|
||||||
|
- 기존 empty keywords의 원문 fallback, 하위 콘텐츠의 batch 조회, 장르·권한·원문 응답을 보존한다.
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 상세 HTTP baseline을 확인하고 시리즈 첫 응답/언어 미감지의 HTTP·DB 회귀 테스트를 작성한다.
|
||||||
|
- [x] **RED 확인:** 아래 새 클래스 실행에서 translated 누락 및 languageCode 미저장 assertion 실패를 확인한다.
|
||||||
|
- [x] **GREEN:** resolver와 상세 조립 연결, materializer 잠금 및 직접 생성자 fixture만 최소 수정한다.
|
||||||
|
- [x] **GREEN 확인:** 같은 클래스에서 캐시/빈 필드/동일·미지원 언어/실패 복구/경합/하위 목록 보존을 검증한다.
|
||||||
|
- [x] **REFACTOR:** 새 코드의 불필요한 부분만 정리하고 아래 직접 영향 회귀 및 lint/build를 검증한다.
|
||||||
|
|
||||||
|
### 시나리오 계약
|
||||||
|
|
||||||
|
1. 첫 응답·재사용: 실제 GET에서 200과 요청 locale의 translated가 반환되고 별도 DB 재조회와 일치한다. 두 번째 조회는 공급자 추가 호출이 없다.
|
||||||
|
2. 감지·경계: null/빈 문자열/공백 언어는 감지 결과를 커밋하고 같은 응답에서 번역한다. 동일/미지원 언어는 번역하지 않고 캐시/빈 필드는 기존 정책을 따른다.
|
||||||
|
3. 실패·경합: 공급자/실제 저장 실패에도 원문 200과 복구 job이 남고 worker 후 재조회가 성공한다. 동시 원문 수정은 덮어쓰거나 오래된 번역으로 저장하지 않는다. worker/상세가 하나의 번역 행으로 수렴한다.
|
||||||
|
4. 인접 회귀: 시리즈 원문/장르/응답 스키마와 하위 콘텐츠의 저장 번역/원문 선택은 그대로이며 하위 콘텐츠 신규 번역 호출·job은 없다. 콘텐츠 상세와 기존 FAILED 재개 테스트가 통과한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest' --console=plain
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentSeriesReadRetryTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorkerTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --console=plain
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar --console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
### Phase 4 Gate
|
||||||
|
|
||||||
|
**Goal P4-GATE:** 실제 시리즈 상세 HTTP/DB 결과, 직접 영향 회귀와 최소 변경 범위를 검증하고 종료한다.
|
||||||
|
- 시작 조건: P4-T1 완료.
|
||||||
|
- 완료 증거: 부모가 직접 Java HttpClient로 실제 테스트 서버 호출, 응답/DB 대조, 테스트 XML, lint/build, 단일 독립 리뷰.
|
||||||
|
- 범위 밖: 운영 MySQL/실제 유료 공급자/실제 인증/배포 검증 및 전체 테스트.
|
||||||
|
- TDD 예외 사유: 구현이 아닌 검증 작업. 실제 HTTP/DB 결과와 diff/명령 출력을 대조한다.
|
||||||
|
- [x] 실제 HTTP에서 첫 응답·재사용, 감지, 실패·worker 복구 및 하위 목록 보존을 확인한다.
|
||||||
|
- [x] 관련 테스트 XML 및 ktlintCheck/bootJar 확인. LSP 도구 미제공 시 Kotlin 컴파일 대체를 기록한다.
|
||||||
|
- [x] 단일 독립 리뷰의 차단 사항을 해소하고 승인받는다.
|
||||||
|
- [x] 소유 임시 파일·QA 서버·캐시를 정리하고 부재를 확인한다.
|
||||||
|
- 종료 조건: 위 시나리오의 HTTP/DB 결과와 관련 테스트가 통과하고 빌드/진단 한계, 리뷰 승인, 임시 자원 정리가 기록되면 즉시 종료한다.
|
||||||
|
- 전체 테스트는 사용자 실행 `./gradlew test`로 분리한다.
|
||||||
|
|
||||||
|
### P4 진행 기록
|
||||||
|
|
||||||
|
- 2026-11-17 조사/승인: 시리즈 상세에는 감지 없이 저장 번역 조회 또는 job 예약만 있음을 확인했다. 사용자는 시리즈 자체만 동기 처리하도록 승인했다. 명확성 Goal/Scope/Constraints/Success/Context 모두 1.0, 최종 모호성 0.00, 열린 질문 없음. 기존 P1~P3 완료 기록을 보존하고 후속 goal로 추가했다.
|
||||||
|
- 2026-11-17 P4-T1 TDD: 기존 콘텐츠 HTTP baseline 21건 성공. 최초 시리즈 fixture의 필수 theme 누락을 수정한 뒤 production 수정 전 15건 중 12건의 의도한 RED를 확인했다. 첫 번역 null 및 미감지 언어 미저장이 원인이었다. 최소 구현 후 15건 GREEN, 지정 회귀 7개 클래스 총 82건 성공(exit 0, 1분 1초). 부모가 XML의 실패/오류/skip 0을 확인했다. 첫 GREEN의 컴파일 시간 제한은 성공으로 처리하지 않았으며 종료 확인 후 300초로 재실행했다.
|
||||||
|
- 2026-11-17 P4-GATE HTTP/lint 1차: 임시 Java HttpClient로 실제 서버 GET 8회/5개 시나리오를 확인했다. 최초 번역·재사용, 하위 저장 제목, 미감지 언어 저장, 공급자 실패 및 실제 CHECK 실패의 원문 200/worker 복구가 모두 PASS. 이어진 ktlintTestSourceSetCheck는 테스트 3파일의 포맷 14건으로 실패했고 bootJar는 미실행이다. 구현자가 포맷만 보정 중이다. [실제 응답과 테스트 증거](reviews/series-detail-review.md).
|
||||||
|
- 2026-11-17 P4-T1 완료/P4-GATE lint/build: 테스트 3파일의 줄바꿈/import 순서만 보정한 뒤 `./gradlew --no-daemon ktlintCheck bootJar --console=plain` 성공(exit 0, 26초). `git diff --check` 통과. 제품 코드와 테스트 동작 변경이 없어 82건과 실제 HTTP 증거는 유지한다. LSP 도구는 없으며 기존 Kotlin 컴파일/ktlint로 대체했다. 최종 독립 리뷰와 부모 임시 경로 정리가 남았다.
|
||||||
|
- 2026-11-17 P4-GATE 완료: 단일 Oracle 리뷰 APPROVE(신뢰도 높음), 차단 사항 없음. MT-017/018·원문 경합·실패 격리·하위 목록 보존과 XML 82건/부모 HTTP 증거의 일치를 확인했다. QA PID 1275/TCP 61019 종료와 구현자 root 부재 확인 후 부모 `series-translation.AH2ekJ`의 runner/classes/report/cache 및 별도 ulw 노트를 삭제하고 경로 부재를 확인했다(exit 0). 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이며 사용자 전체 테스트 명령은 `./gradlew test`다. 커밋하지 않았다.
|
||||||
|
- 2026-11-17 P4 커밋 전 재검증: `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentSeriesReadRetryTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' ktlintCheck bootJar --console=plain` exit 0(45초). XML 세 파일에서 38건(15/2/21) 성공, 실패/오류/skip 0을 확인했다. `ktlintCheck`와 `bootJar`는 UP-TO-DATE이며 `git diff --check`도 통과했다. 전체 테스트·운영 MySQL·실제 공급자/인증·배포는 미검증이며 전체 테스트는 사용자 실행 `./gradlew test`다.
|
||||||
@@ -0,0 +1,71 @@
|
|||||||
|
# 메타데이터 자동 번역 신속 반영 PRD
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 작성일 | 2026-11-16 |
|
||||||
|
| 상태 | 콘텐츠·시리즈 상세 동기 번역 및 연관 제목 번역 구현·기능 검증·독립 리뷰 완료 |
|
||||||
|
| 구현 계획 | [plan-task.md](plan-task.md) |
|
||||||
|
| 결정권자 | 사용자 |
|
||||||
|
|
||||||
|
## 목적과 현재 문제
|
||||||
|
|
||||||
|
콘텐츠, 시리즈, 테마 등 기존 메타데이터 번역의 작업 등록 누락과 10분 대기를 줄인다.
|
||||||
|
언어 감지 결과 저장 전 별도 비동기 번역 이벤트가 실행될 수 있고, 관리자 콘텐츠 수정에는 이벤트 미발행 경로가 있다.
|
||||||
|
기존 FAILED 작업은 같은 원문으로 요청해도 재개되지 않으며, 워커는 기본 10분 간격이다.
|
||||||
|
|
||||||
|
## 확정 요구사항
|
||||||
|
|
||||||
|
| ID | 요구사항 | 수용 기준 |
|
||||||
|
|---|---|---|
|
||||||
|
| MT-001 | 언어 감지 성공 후 번역 작업을 등록한다. | 기존 일반 메타데이터 감지 경로는 감지된 languageCode와 translation_job을 같은 트랜잭션에 저장한다. 작업 등록 실패 시 언어 저장도 롤백한다. 커뮤니티의 기존 revision/hash 검증은 보존한다. |
|
||||||
|
| MT-002 | 최초 번역 후 최대 5회 재시도한다. | 한 주기는 최초 시도 1회와 재시도 5회, 총 6회다. 6번째 실패 후 FAILED로 멈춘다. 자동 재시도 지연은 1분, 5분, 이후 15분이다. |
|
||||||
|
| MT-003 | 소진 후 조회/수정 요청으로 다시 최대 5회 재시도한다. | 현재 원문에 해당하는 기존 FAILED 행을 PENDING, retryCount=0, lastErrorMessage=null, nextRetryAt=요청 시각으로 재개한다. PENDING/RUNNING/COMPLETED는 요청으로 초기화하지 않는다. 중복 요청이 실행 중 재시도 예산을 늘리지 않는다. |
|
||||||
|
| MT-004 | AWS 감지와 번역을 먼저 사용한다. | 새 외부 감지·번역은 모두 AWS 다음 Papago다. 기존 Papago 포함 유효 캐시를 우선 재사용한다. |
|
||||||
|
| MT-005 | 번역을 빠르게 반영한다. | 워커 기본 fixedDelay는 1000ms, 실행당 최대 5개 그룹을 유지한다. 실제 완료 시간은 대기량과 외부 API 처리 시간에 좌우된다. |
|
||||||
|
| MT-006 | 콘텐츠 수정과 기존 조회 흐름을 연결한다. | 일반 관리자 제목/상세 수정과 크리에이터 관리자 태그 없는 제목/상세 수정도 작업을 요청한다. 기존 번역 응답이 남아 있어도 관련 조회 요청은 현재 원문의 FAILED 작업을 재개할 수 있다. |
|
||||||
|
| MT-007 | 기존 계약과 경쟁 처리를 유지한다. | ko/en/ja, 공개 API/원문 fallback, provider별 캐시, SKIP LOCKED 작업 claim, 커뮤니티 revision 보호를 유지한다. job 등록/재개와 워커의 상태 경쟁을 DB 조건 또는 잠금으로 보호한다. |
|
||||||
|
| MT-008 | 콘텐츠 태그의 AWS 미번역 결과는 Papago로 넘긴다. | CONTENT/tags에 한정하여 원문과 NFC/공백 정규화 및 쉼표 요소별 trim 후 같은 AWS 결과를 거부한다. 새 응답과 캐시에 같은 기준을 적용한다. Papago 동일 결과는 사용자 승인에 따라 성공이다. |
|
||||||
|
| MT-009 | 기존 잘못 완료된 콘텐츠 태그를 요청 시 복구한다. | 현재 원문/언어에 해당하는 COMPLETED 태그 중 저장된 응답이 원문과 동일하고 유효 캐시 결과와 일치하지 않는 작업을 기존 조회/수정 요청에서 재개한다. 정상 번역 및 Papago로 확인된 동일 결과는 반복 재개하지 않는다. 운영 일괄 변경은 하지 않는다. |
|
||||||
|
| MT-010 | 콘텐츠 상세 조회에서 언어 미감지를 복구한다. | languageCode가 null/빈 문자열/공백이면 제목·전체 설명·활성 태그로 기존 LanguageDetectEvent를 발행한다. 커밋 후 감지 성공 시 기존 리스너가 언어와 번역 job을 저장한다. 현재 응답의 원문 fallback과 이미 감지된 콘텐츠의 번역 동작을 유지한다. |
|
||||||
|
| MT-011 | 콘텐츠 상세의 미번역 데이터를 같은 응답에서 제공한다. | 저장된 요청 언어 번역이 없으면 title/detail/tags를 동기 번역하고 기존 캐시와 ContentTranslation에 저장한 뒤 기존 translated 필드로 반환한다. 이미 번역된 데이터는 재사용하고 같은 언어·미지원 언어는 번역하지 않는다. |
|
||||||
|
| MT-012 | 상세 조회의 원문 언어 감지도 동기로 완료한다. | null/빈 문자열/공백 언어는 제목·전체 설명·활성 태그를 기존 감지 캐시 서비스에 전달하고, 감지 성공 시 같은 요청에서 언어 저장과 요청 언어 번역을 수행한다. 상세 조회에 한해 MT-010의 비동기 선행 정책을 대체한다. |
|
||||||
|
| MT-013 | 동기 번역 실패에도 원문 상세와 기존 재시도를 유지한다. | 공급자 실패 시 원문 응답을 반환하며 요청 언어의 기존 job을 등록/재개한다. 실패한 번역 트랜잭션이 상세 조회 트랜잭션을 rollback-only로 만들지 않는다. 감지 실패는 기존 감지 이벤트 경로를 보존하며 새 감지 큐는 만들지 않는다. |
|
||||||
|
| MT-014 | 동기 경로와 worker가 같은 번역 정책을 사용한다. | worker의 캐시 조회·공급자 fallback·태그 정책·메모리 저장을 공유한다. 빈 필드, 기존 캐시, 동시 상세 요청과 worker의 저장 경합을 처리하며 다른 리소스의 큐 처리 의미는 유지한다. |
|
||||||
|
| MT-015 | 상세 연관 콘텐츠 제목에 현재 요청 언어의 저장된 번역을 표시한다. | previousContent, nextContent, creatorOtherContentList, sameThemeOtherContentList의 title에 LangContext 언어의 저장된 번역을 적용한다. 번역 행 없음·빈 제목·공백 제목은 원문이며 다른 언어 번역을 대신 사용하지 않는다. |
|
||||||
|
| MT-016 | 연관 콘텐츠의 조회 계약을 보존한다. | ID·순서·개수·coverUrl·null/빈 목록·기존 조회 조건을 유지한다. 이전/다음 선택은 원문 제목 기준이다. 연관 콘텐츠 번역을 새로 생성하거나 작업을 등록하지 않고, ID를 중복 제거하여 최대 한 번 일괄 조회한다. 본문 상세의 기존 동기 번역은 유지한다. |
|
||||||
|
| MT-017 | 시리즈 상세도 같은 응답 전에 언어 감지와 누락 번역을 완료한다. | `GET /audio-content/series/{id}`에서 null/빈 문자열/공백 언어는 제목·소개·키워드로 감지하고 저장한다. 요청 언어의 title/introduction/keywords 번역이 없으면 기존 감지 캐시·번역 메모리·materializer를 사용해 동기로 저장하고 기존 translated 필드에 반환한다. 저장된 번역은 재사용하고 같은 언어·미지원 언어는 번역하지 않는다. |
|
||||||
|
| MT-018 | 시리즈 동기 처리의 실패 격리와 조회 계약을 보존한다. | 감지·번역 실패에도 원문 상세를 반환하고 기존 감지 이벤트/번역 job 복구 경로를 사용한다. 시리즈 원문 필드, 장르, 권한, 응답 스키마를 유지한다. 하위 콘텐츠 목록은 저장된 제목 번역만 사용하며 신규 동기 번역을 생성하지 않는다. 동시 원문 변경을 덮어쓰지 않는다. |
|
||||||
|
|
||||||
|
## 구현 결정
|
||||||
|
|
||||||
|
- 새 메시지 브로커, 외부 API, 의존성, DB 스키마를 추가하지 않고 기존 scheduler/worker를 사용한다.
|
||||||
|
- 최초 시도와 별도로 재시도 5회를 부여하는 것으로 사용자 문구를 해석한다. 이 해석은 실행 시작 시 사용자에게 명시했다.
|
||||||
|
- 감지 실패 시 번역은 실행하지 않는다. 감지 자체의 새 재시도 시스템과 운영 데이터 일괄 복구는 이번 범위가 아니다.
|
||||||
|
- 기존 번역을 즉시 삭제하지 않고 작업 완료 시 교체한다. 원문 변경 후 조회 fallback 계약은 유지한다.
|
||||||
|
- 조회/수정은 기존 번역 기능 진입점에서 처리한다. 관계없는 모든 목록 API에 새 번역 작업 생성을 강제하지 않는다.
|
||||||
|
- 주기적 워커는 FAILED를 자동으로 되살리지 않는다. 현재 원문에 대한 명시적인 조회/수정 요청만 새 주기를 연다.
|
||||||
|
|
||||||
|
## 검증
|
||||||
|
|
||||||
|
- 재시도 경계, 소진 후 요청 재개, 진행 중 작업 예산 보존, 동시 요청, 1초 설정과 AWS 우선/fallback/cache를 검증한다.
|
||||||
|
- 실제 DB 트랜잭션으로 언어 감지 이후 job 저장과 실패 시 롤백을 검증한다.
|
||||||
|
- 관련 콘텐츠/시리즈/테마 및 직접 영향받는 번역 조회 기능을 기능별로 검증한다.
|
||||||
|
- 실제 유료 AWS/Papago 호출, 운영 DB/배포, 전체 테스트는 실행하지 않는다. 전체 테스트는 사용자 명령 `./gradlew test`로 구분한다.
|
||||||
|
|
||||||
|
## 결정 기록
|
||||||
|
|
||||||
|
- 2026-11-16: 사용자가 언어 감지 후 번역, FAILED 재시도, AWS 번역 우선, 빠른 반영을 요청했다.
|
||||||
|
- 2026-11-16: 기존 DB 큐와 1초 워커, 동일 트랜잭션 작업 등록안을 제시했다. 사용자가 재시도는 5회로 제한하고 소진 후 조회/수정 요청 때 다시 5회로 재개하도록 확정했다.
|
||||||
|
- 2026-11-16: 구현 후 기능별 고유 사례 259건, ktlintCheck/bootJar를 검증했다. 독립 리뷰의 원문 언어 일치 누락을 회귀 테스트로 보완한 뒤 APPROVE 판정을 받았다. 상세 명령과 미검증 범위는 [검증 기록](reviews/verification.md)에 있다.
|
||||||
|
- 2026-11-16 후속 승인: 사용자가 감지도 AWS 우선으로 변경하는 데 동의했다. 초기의 Papago 우선 감지 정책을 정정하고, 기존 감지 캐시는 그대로 재사용한다. P1-T2로 검증한다.
|
||||||
|
- 2026-11-16 태그 후속: 사용자가 AWS가 쉼표 공백만 바꾸는 태그를 성공 처리하는 문제를 보고하고 Papago fallback을 요청했다. Papago도 같은 값을 반환하면 성공으로 인정하기로 선택했다. 원문 해시/일반 텍스트 정책은 변경하지 않는다.
|
||||||
|
- 2026-11-16 태그 후속 완료: 신규/기존 AWS 미번역 캐시와 완료 작업 복구를 구현했다. 고유 기능 사례 277건, lint/build 및 단일 독립 리뷰 APPROVE를 확인했다. [태그 검증 기록](reviews/tag-fallback-review.md).
|
||||||
|
- 2026-11-17 상세 조회 후속: 사용자가 언어 미감지 콘텐츠의 감지 선행을 최소 수정으로 요청했다. 상세 조회에 기존 감지 이벤트 분기만 추가하며, 새 감지 큐·재시도 정책은 추가하지 않는다. P1-T4로 추적한다.
|
||||||
|
- 2026-11-17 상세 조회 후속 완료: null/빈 문자열/공백 HTTP 회귀 3건의 RED/GREEN, 관련 테스트 31건, ktlintCheck/bootJar 및 독립 리뷰 APPROVE를 확인했다. 기존 원문 응답을 유지하며 감지 후 번역 job을 등록한다.
|
||||||
|
- 2026-11-17 동기 번역 후속 승인: 사용자가 상세 조회에서 번역 완료를 기다려 같은 응답에 표시하는 최소 수정안을 승인했다. 기존 번역 재사용, 요청 언어의 제목·설명·태그 번역 및 저장, 미감지 언어 동기 감지, 실패 시 원문+기존 job 재시도를 포함한다. P2-T1로 추적한다. 목록과 다른 리소스의 비동기 처리, API 스키마, 공급자 설정과 DB 스키마는 변경하지 않는다.
|
||||||
|
- 2026-11-17 정책 정정: MT-012는 상세 조회에서만 MT-010의 비동기 감지 선행을 대체한다. 기존 완료 기록은 당시 검증 이력으로 보존한다. 첫 조회에 외부 감지/번역 시간이 추가되고 공급자 설정에 명시적인 요청 제한 시간이 없다는 위험은 승인 전 설명했다.
|
||||||
|
- 2026-11-17 동기 번역 완료: 관련 277건 및 최종 생성자 정리 영향 17건, 실제 HTTP QA 4개 시나리오, Kotlin 컴파일·ktlintCheck·bootJar를 확인했다. 단일 독립 리뷰 APPROVE, 차단 사항 없음. [동기 상세 검증 기록](reviews/synchronous-detail-review.md)에 실제 응답·실패 복구·동시성 증거와 운영 MySQL/실제 공급자/전체 테스트의 미검증 범위를 구분했다.
|
||||||
|
- 2026-11-17 연관 콘텐츠 후속 승인: 사용자가 네 필드의 기존 title에 저장된 번역만 적용하고 번역 없음·공백은 원문으로 반환하는 최소 범위를 선택했다. 새 번역 생성과 응답 스키마 확장은 제외한다. P3-T1로 추적한다.
|
||||||
|
- 2026-11-17 연관 콘텐츠 후속 완료: 관련 테스트 38건, 실제 HTTP 5회/3개 시나리오, Kotlin 컴파일·ktlintCheck·bootJar 통과 및 단일 독립 리뷰 APPROVE를 확인했다. 작업 임시 자원은 정리했다. [연관 콘텐츠 검증 기록](reviews/related-content-title-review.md)에 응답·fallback·원문 탐색 보존과 미검증 범위를 기록했다.
|
||||||
|
- 2026-11-17 시리즈 상세 후속 승인: 사용자가 콘텐츠 상세와 같은 감지·동기 번역을 최소 구현으로 요청하고 인터뷰에서 "시리즈 자체만"을 선택했다. 제목·소개·키워드만 동기 처리하고 하위 콘텐츠는 저장 번역 조회를 유지한다. 콘텐츠 상세의 캐시 재사용·실패 시 원문과 기존 재시도 정책을 따른다. 추가 공급자 호출에 따른 첫 응답 대기는 동기 번역 범위에 한정한다. P4-T1/P4-GATE로 추적한다.
|
||||||
|
- 2026-11-17 시리즈 상세 후속 완료: 새 시리즈 HTTP 15건 포함 직접 영향 회귀 82건, 부모의 실제 HTTP 8회/5개 시나리오, ktlintCheck/bootJar 및 단일 독립 리뷰 APPROVE를 확인했다. 소유 QA 서버·임시 파일/캐시/노트를 정리했다. [시리즈 상세 검증 기록](reviews/series-detail-review.md)에 실패 이력과 미검증 범위를 구분했다.
|
||||||
@@ -0,0 +1,99 @@
|
|||||||
|
# 상세 연관 콘텐츠 제목 번역 검증과 리뷰
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 대상 | MT-015~016 / P3-T1, P3-GATE / 미커밋 working tree |
|
||||||
|
| 일자 | 2026-11-17 |
|
||||||
|
| 기준 | [PRD](../prd.md), [계획](../plan-task.md) |
|
||||||
|
| 상태 | 기능 검증 완료, 독립 리뷰 APPROVE |
|
||||||
|
|
||||||
|
## 범위와 구현 근거
|
||||||
|
|
||||||
|
`AudioContentService.getDetail`에서 네 관련 필드의 ID를 중복 제거하고 현재 LangContext locale의 저장 번역을 한 번 조회한다.
|
||||||
|
비어 있지 않은 title만 immutable DTO copy로 반영하고 원문 기반 navigation/쿼리/ID/cover/각 요청의 목록 순서를 유지한다.
|
||||||
|
새 번역 생성·job·스키마·의존성·공개 API는 추가하지 않는다. 제품 변경은 서비스 18줄 추가와 응답 할당 4줄 교체다.
|
||||||
|
|
||||||
|
## 자동 검증
|
||||||
|
|
||||||
|
- 기존 HTTP baseline: 15건 성공.
|
||||||
|
- RED: 신규 HTTP 포함 21건 중 1건 실패. expected `title=en 가 이전`, actual `title=가 이전`, ID와 cover 일치.
|
||||||
|
- GREEN: 아래 focused 명령에서 38건 성공(HTTP 21, service 16, retry 1), 실패/오류/skip 0. 부모가 XML 세 파일을 직접 확인했다.
|
||||||
|
- 테스트 두 표현식의 포맷 실패를 수정한 뒤 실제 HTTP QA 및 `ktlintCheck`, `bootJar`를 실행해 exit 0을 확인했다. 테스트 동작은 변경하지 않았다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --console=plain
|
||||||
|
./gradlew --no-daemon -I "$TMPDIR/qa.init.gradle" runRelatedContentQa ktlintCheck bootJar --console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
자동 검증 산출물: `build/test-results/test/TEST-kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest.xml`,
|
||||||
|
`TEST-kr.co.vividnext.sodalive.content.AudioContentServiceTest.xml`, `TEST-kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest.xml`.
|
||||||
|
HTTP 테스트 timestamp는 `2026-11-17T03:26:24`이며 이후 변경은 인자 줄바꿈뿐이다.
|
||||||
|
|
||||||
|
## 부모가 직접 실행한 HTTP QA
|
||||||
|
|
||||||
|
위 두 번째 명령은 임시 Java runner가 기존 Spring test context와 fixture를 사용하고 Java HttpClient로 실제 Tomcat 서버를 호출한다.
|
||||||
|
외부 공급자·principal은 테스트 대체이며 controller/service/JPA/트랜잭션은 실제 코드다. H2 DB에서 fixture를 커밋한 후 요청했다.
|
||||||
|
검증 시 원본 runner: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/content-translation.TfjAph/RelatedContentQa.java`.
|
||||||
|
임시 runner는 종료 시 삭제하며 실제 응답 발췌와 판정은 이 문서에 보존한다.
|
||||||
|
|
||||||
|
| 시나리오 | 실행 | 기대/관찰 | 판정 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 현재 언어 저장 번역 | 같은 `/audio-content/1?timezone=UTC`에 en→ja→en GET | 모두 200. 네 필드의 제목이 각 locale로 전환되고 ID·cover가 유지됨 | PASS |
|
||||||
|
| 혼합 fallback | en 제목 삭제/빈 문자열/공백, ja만 남은 항목을 함께 GET | 모두 원문 제목. 공급자는 본문 최초 번역 3회만, job 0개 | PASS |
|
||||||
|
| 인접/빈 관계 | `/audio-content/6?timezone=UTC` GET | 200, 이전/다음 null, 두 목록 [], 본문 translated.title은 English title | PASS |
|
||||||
|
|
||||||
|
실제 호출과 응답 발췌:
|
||||||
|
|
||||||
|
```text
|
||||||
|
QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=en status=200
|
||||||
|
previousContent={"contentId":2,"title":"en 가 이전","coverUrl":"https://cdn.test/related-0.png"}
|
||||||
|
nextContent={"contentId":3,"title":"en 하 다음","coverUrl":"https://cdn.test/related-1.png"}
|
||||||
|
creatorOtherContentList=[{"contentId":3,"title":"en 하 다음"},{"contentId":4,"title":"en creator only"},{"contentId":2,"title":"en 가 이전"}]
|
||||||
|
sameThemeOtherContentList=[{"contentId":5,"title":"en theme only"},{"contentId":2,"title":"en 가 이전"},{"contentId":3,"title":"en 하 다음"}]
|
||||||
|
translated={"title":"English title","detail":"English detail","tags":"#Healing"}
|
||||||
|
|
||||||
|
QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=ja status=200
|
||||||
|
previousContent={"contentId":2,"title":"ja 가 이전","coverUrl":"https://cdn.test/related-0.png"}
|
||||||
|
nextContent={"contentId":3,"title":"ja 하 다음","coverUrl":"https://cdn.test/related-1.png"}
|
||||||
|
creatorOtherContentList=[{"contentId":4,"title":"ja creator only"},{"contentId":2,"title":"ja 가 이전"},{"contentId":3,"title":"ja 하 다음"}]
|
||||||
|
sameThemeOtherContentList=[{"contentId":5,"title":"ja theme only"},{"contentId":3,"title":"ja 하 다음"},{"contentId":2,"title":"ja 가 이전"}]
|
||||||
|
translated={"title":"Japanese title","detail":"Japanese detail","tags":"#Japanese"}
|
||||||
|
|
||||||
|
QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=en status=200
|
||||||
|
QA PASS locale switching: all four fields, IDs/covers, main translation
|
||||||
|
|
||||||
|
QA GET http://localhost:59748/audio-content/1?timezone=UTC locale=en status=200
|
||||||
|
previousContent.title="가 이전", nextContent.title="하 다음"
|
||||||
|
creatorOtherContentList titles=["가 이전","하 다음","creator only"]
|
||||||
|
sameThemeOtherContentList titles=["하 다음","theme only","가 이전"]
|
||||||
|
QA PASS mixed fallback: originals, no related provider calls/jobs
|
||||||
|
|
||||||
|
QA GET http://localhost:59748/audio-content/6?timezone=UTC locale=en status=200
|
||||||
|
{"previousContent":null,"nextContent":null,"creatorOtherContentList":[],"sameThemeOtherContentList":[],"translated":{"title":"English title","detail":"English detail","tags":"#Healing"}}
|
||||||
|
QA PASS empty relations: null neighbors, empty lists, translated main
|
||||||
|
QA CLEANUP: Spring HTTP server and database context closed
|
||||||
|
BUILD SUCCESSFUL in 50s
|
||||||
|
```
|
||||||
|
|
||||||
|
목록은 기존 rand 정렬이므로 서로 다른 요청 사이 순서는 달라질 수 있다. 각 요청에서 조회된 순서를 바꾸지 않는 것은 코드의 map/copy와 대조했다.
|
||||||
|
배치 1회/중복 ID 제거/빈 관계 조회 0회는 실제 repository spy로 반환을 stub하지 않고 HTTP 테스트에서 검증했다.
|
||||||
|
|
||||||
|
## 실행 한계 및 자원
|
||||||
|
|
||||||
|
- LSP 도구가 제공되지 않아 Kotlin 컴파일과 ktlint로 대체했다.
|
||||||
|
- 전체 테스트, 운영 MySQL JSON, 실제 AWS/Papago, 실제 로그인·배포는 실행하지 않았다. 전체 테스트는 사용자 실행 `./gradlew test`다.
|
||||||
|
- 기존 Gradle 9 deprecation, duplicate JSONObject, macOS Netty DNS 경고를 변경하거나 suppress하지 않았다.
|
||||||
|
- 임시 QA Java 컴파일에는 runtime classpath에 없는 API guardian annotation 관련 경고 4건이 있었지만 컴파일/실행은 성공했다. 제품 의존성은 변경하지 않았다.
|
||||||
|
- Tomcat 종료 시 Hikari housekeeper 경고 뒤 JPA close와 Hikari Shutdown completed가 출력됐고 QA JVM이 정상 종료했다. 별도 상주 서버는 만들지 않았다.
|
||||||
|
- 구현자의 `p3-t1.JgkJkn` 임시 root 부재를 확인했다. QA PID 85049 부재 및 TCP 59748 listener 없음도 확인했다.
|
||||||
|
- 승인 후 부모 `content-translation.TfjAph` root의 QA 실행기·init script·class·임시 보고서와 별도 ulw 노트를 삭제하고 경로 부재를 확인했다(exit 0). 검증 응답/리뷰 결과는 이 문서에 보존했으며 공유 캐시·작업 외 파일은 변경하지 않았다.
|
||||||
|
|
||||||
|
## 독립 리뷰
|
||||||
|
|
||||||
|
2026-11-17 단일 Oracle reviewer 판정: **APPROVE**, 신뢰도 높음, 차단 사항 없음.
|
||||||
|
|
||||||
|
- MT-015/016: 네 필드의 요청 언어 번역과 fallback, 지역 번역 맵을 통한 요청 간 격리, distinct 배치 조회를 확인했다.
|
||||||
|
- ID·cover·개수·null 및 각 조회 결과의 순서, 원문 제목 navigation을 보존하며 관련 공급자 호출/job/API/DB/의존성 변경이 없음을 확인했다.
|
||||||
|
- 테스트는 실제 HTTP/JPA 계약을 검증하며 mock echo·prose pin·테스트 전용 제품 seam이 없다. 배치 횟수 spy는 PRD의 명시적 제약을 검증한다.
|
||||||
|
- reviewer가 XML의 38건 성공과 구현 보고서 RED, QA 문서·Java runner·Gradle init script를 직접 대조했다. 리뷰에서 테스트를 재실행하지 않았다.
|
||||||
|
- 잔여 한계: H2는 운영 MySQL 검증을 대체하지 않으며 실제 공급자·인증·전체 테스트는 미검증이다.
|
||||||
@@ -0,0 +1,102 @@
|
|||||||
|
# 시리즈 상세 동기 번역 검증과 리뷰
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 대상 | MT-017~018 / P4-T1, P4-GATE / 미커밋 working tree |
|
||||||
|
| 일자 | 2026-11-17 |
|
||||||
|
| 기준 | [PRD](../prd.md), [계획](../plan-task.md) |
|
||||||
|
| 상태 | HTTP/기능/lint/build 검증 완료, 독립 리뷰 APPROVE |
|
||||||
|
|
||||||
|
## 범위
|
||||||
|
|
||||||
|
시리즈 제목·소개·키워드의 언어 감지와 요청 언어 번역을 같은 상세 응답 전에 저장한다.
|
||||||
|
기존 콘텐츠 상세와 같은 트랜잭션 격리, 감지 캐시·번역 메모리·materializer·복구 job을 사용한다.
|
||||||
|
시리즈 원문·장르·권한·DTO와 하위 콘텐츠의 저장된 제목 번역 조회는 유지한다.
|
||||||
|
공급자 설정·의존성·DB 스키마·콘텐츠 상세 resolver는 변경하지 않았다.
|
||||||
|
|
||||||
|
## TDD와 기능별 검증
|
||||||
|
|
||||||
|
- 변경 전 콘텐츠 상세 HTTP baseline 21건 성공(exit 0, 27초).
|
||||||
|
- 최초 새 테스트 실행은 fixture의 필수 theme 누락으로 실패했다. fixture를 수정했으며 제품 RED로 인정하지 않았다.
|
||||||
|
- production 수정 전 시리즈 HTTP 15건 중 12건 실패(exit 1, 37초). 첫 translated.title은 기대 `English title` 대신 null, 미감지 3종은 DB의 기대 `ko` 대신 null/빈 문자열/공백이었다.
|
||||||
|
- 첫 GREEN 실행은 compileTestKotlin 중 도구 120초 제한으로 종료됐다. 종료 확인 후 300초 제한으로 실행하여 15건 모두 성공(exit 0, 2분 22초).
|
||||||
|
- 직접 영향 7개 클래스 82건 성공(exit 0, 1분 1초). 부모가 최종 XML 7개의 tests/failures/errors/skipped를 직접 확인했다.
|
||||||
|
|
||||||
|
| 테스트 클래스 | 성공 건수 | 실패/오류/skip |
|
||||||
|
|---|---:|---|
|
||||||
|
| AudioContentDetailTranslationHttpIntegrationTest | 21 | 0/0/0 |
|
||||||
|
| ContentSeriesDetailTranslationHttpIntegrationTest | 15 | 0/0/0 |
|
||||||
|
| MetadataLanguageDetectTransactionTest | 10 | 0/0/0 |
|
||||||
|
| ContentSeriesReadRetryTest | 2 | 0/0/0 |
|
||||||
|
| ContentTagTranslationIntegrationTest | 11 | 0/0/0 |
|
||||||
|
| TranslationJobRetryIntegrationTest | 10 | 0/0/0 |
|
||||||
|
| TranslationJobWorkerTest | 13 | 0/0/0 |
|
||||||
|
|
||||||
|
명령은 계획의 P4 검증 블록에 있다. XML은 `build/test-results/test/TEST-kr.co.vividnext.sodalive.` 접두사의 각 클래스 경로에 있다.
|
||||||
|
새 HTTP 테스트는 실제 응답과 별도 트랜잭션의 저장 결과를 비교한다. 감지 캐시, 빈 필드, 동일/미지원 언어,
|
||||||
|
감지 실패의 SERIES 이벤트, 원문 변경, 상세 2건/worker 1건의 저장 경합, 하위 제목 en→ja→en도 포함한다.
|
||||||
|
|
||||||
|
## 부모의 실제 HTTP QA
|
||||||
|
|
||||||
|
명령: `./gradlew --no-daemon -I "$TMPDIR/qa.init.gradle" runSeriesQa ktlintCheck bootJar --console=plain`.
|
||||||
|
임시 `SeriesQa.java`가 기존 테스트 context와 DB fixture를 사용해 Java HttpClient로 실제 Tomcat에 GET 8회를 보냈다.
|
||||||
|
인증 principal·외부 공급자만 테스트 대역이며 controller/service/JPA/트랜잭션은 실제 구현이다.
|
||||||
|
아래 응답 및 assertion 결과는 2026-11-17 13:58 KST 실행 출력에서 보존했다.
|
||||||
|
|
||||||
|
| 시나리오 | 관찰한 응답/DB 결과 | 판정 |
|
||||||
|
|---|---|---|
|
||||||
|
| 첫 번역·재사용 | series/1 GET 2회 200, 세 translated 필드 일치, 별도 repository 조회 title 일치, 공급자 총 3회/job 0개 | PASS |
|
||||||
|
| 하위 콘텐츠 저장 번역 | 첫 응답의 `기본 child`가 저장 번역 추가 후 `Stored child`, 부모 원문은 유지, 공급자 총 3회/job 0개 유지 | PASS |
|
||||||
|
| 미감지 원문 | series/2 GET 200, 같은 응답에 세 번역 필드, JDBC 재조회 language_code=ko, 전체 감지 query 일치 | PASS |
|
||||||
|
| 공급자 실패·복구 | series/3 GET 200/translated=null/원문 title, job 3개, worker 실행 후 GET 200/세 번역 필드 | PASS |
|
||||||
|
| 실제 저장 실패·복구 | series/4 CHECK 23513 후 GET 200/translated=null, 번역 0행/메모리 3행/job 3개, 제약 해제와 worker 후 GET 번역, 공급자 총 3회 | PASS |
|
||||||
|
|
||||||
|
실제 응답 발췌:
|
||||||
|
|
||||||
|
```text
|
||||||
|
QA PID=1275 PORT=61019
|
||||||
|
GET http://localhost:61019/audio-content/series/1 locale=en
|
||||||
|
status=200 content-type=application/json
|
||||||
|
title="원문 제목", introduction="원문 설명"
|
||||||
|
translated={"title":"English title","introduction":"English detail","keywords":["#Healing","#Calm"]}
|
||||||
|
translatedGenre="Stored genre"
|
||||||
|
QA PASS first-response/DB/reuse calls=3 jobs=0
|
||||||
|
QA PASS child stored-only/original preserved calls=3 jobs=0
|
||||||
|
QA PASS missing-language committed before response
|
||||||
|
GET http://localhost:61019/audio-content/series/3 locale=en
|
||||||
|
status=200 translated=null
|
||||||
|
worker 후 status=200 translated={"title":"English title","introduction":"English detail","keywords":["#Healing","#Calm"]}
|
||||||
|
QA PASS provider-failure original 200/jobs=3/worker recovery
|
||||||
|
SQL Error: 23513 / constraint qa_reject_series
|
||||||
|
QA PASS database-rollback isolation/worker cached recovery calls=3
|
||||||
|
QA CLEANUP context closed active=false
|
||||||
|
```
|
||||||
|
|
||||||
|
이 실행은 HTTP QA 이후 ktlintTestSourceSetCheck의 새 테스트 포맷 14건에서 exit 1로 종료됐다.
|
||||||
|
HTTP 결과는 PASS지만 전체 명령 또는 bootJar 성공으로 기록하지 않는다. 줄바꿈/import 정렬만 보정한다.
|
||||||
|
|
||||||
|
포맷 보정 뒤 `./gradlew --no-daemon ktlintCheck bootJar --console=plain`는 exit 0, 26초로 성공했다.
|
||||||
|
`git diff --check`도 통과했다. 테스트 3파일의 줄바꿈과 import 순서만 바뀌었으며 제품 동작/assertion은 동일하다.
|
||||||
|
기존 82건과 HTTP 증거를 재실행한 것으로 기록하지 않는다.
|
||||||
|
|
||||||
|
## 한계 및 정리
|
||||||
|
|
||||||
|
- 운영 MySQL JSON/잠금, 실제 AWS/Papago, 실제 로그인·배포·전체 테스트는 미검증이다. 전체 테스트는 사용자 실행 `./gradlew test`다.
|
||||||
|
- H2 JSON 래핑은 기존 테스트와 같은 varchar 변환기 왕복으로 검증한다. worker claim은 기존 H2 대역이며 운영 SKIP LOCKED를 재현하지 않는다.
|
||||||
|
- LSP 도구가 없어 Kotlin compileKotlin/compileTestKotlin과 ktlint로 대체한다. 첫 조회 대기 시간은 공급자 응답 시간에 좌우되며 동시 요청의 중복 공급자 호출은 가능하다.
|
||||||
|
- 기존 중복 JSONObject/Netty macOS DNS/Gradle deprecation 경고와 임시 Java runner의 apiguardian annotation 경고는 변경하지 않았다.
|
||||||
|
- 종료 시 Tomcat의 Hikari housekeeper 경고 이후 JPA 종료와 Hikari Shutdown completed를 확인했다. 부모가 PID 1275 부재와 TCP 61019 listener 부재를 확인했다(exit 0).
|
||||||
|
- 구현자 임시 root `p4-t1.5u5PX9` 부재를 부모가 확인했다. 리뷰 승인 후 부모 `series-translation.AH2ekJ`의 QA runner/init/classes/report/cache와 별도 ulw 노트를 삭제하고 두 경로 부재를 확인했다(exit 0). 응답·검증 기록은 이 문서와 계획에 보존했다. 공유 캐시는 삭제하지 않았다.
|
||||||
|
|
||||||
|
## 독립 리뷰
|
||||||
|
|
||||||
|
2026-11-17 단일 Oracle 리뷰: **APPROVE**, 신뢰도 높음, 차단 사항 없음.
|
||||||
|
|
||||||
|
- MT-017: 세 메타데이터 필드, 동기 감지/저장, 캐시 및 기존 번역 재사용, 동일·미지원 언어 제외를 확인했다.
|
||||||
|
- MT-018: 서비스 간 NOT_SUPPORTED와 REQUIRES_NEW, 실제 저장 rollback 후 원문 200과 복구, FAILED 재개 assertion 보존을 확인했다.
|
||||||
|
- 감지 저장·materialize의 snapshot/부모 잠금, 외부 managed entity 미갱신, worker/상세 수렴과 하위 저장 제목 계약을 확인했다.
|
||||||
|
- XML 7개의 82건과 부모 Java HttpClient의 8회/5개 시나리오 및 DB assertion을 대조했다. 포맷 보정 전후 증거 구분과 실행 한계에 불일치가 없었다.
|
||||||
|
- 리뷰어는 settled 테스트를 재실행하지 않았다. 확정 발견 사항 및 회귀 수정 Goal 전환 항목 없음.
|
||||||
|
|
||||||
|
관련 이력: `ff30ebac` 콘텐츠 상세 동기 번역, `081f22b2` 현재 원문 FAILED 재개, `f7fadf7a` 공급자/캐시 공통화.
|
||||||
|
새 시리즈 resolver는 이 정책들을 재사용하며 `d82185e9`의 시리즈 정책 호출/권한 흐름은 보존한다.
|
||||||
@@ -0,0 +1,90 @@
|
|||||||
|
# 콘텐츠 상세 동기 번역 검증과 리뷰
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 대상 | MT-011~014 / P2-T1, P2-GATE / 미커밋 working tree |
|
||||||
|
| 일자 | 2026-11-17 |
|
||||||
|
| 기준 | [PRD](../prd.md), [계획](../plan-task.md) |
|
||||||
|
| 상태 | 기능 검증 완료, 독립 리뷰 APPROVE |
|
||||||
|
|
||||||
|
## 범위와 구현
|
||||||
|
|
||||||
|
상세 조회가 요청 언어의 title/detail/tags를 동기로 번역·저장해 기존 translated 필드에 반환한다. 기존 번역과 메모리를 재사용하고 미감지 언어는 같은 요청에서 감지한다. 실패는 원문 응답과 기존 job/감지 이벤트 복구를 유지한다.
|
||||||
|
공유 TranslationMemoryService에 기존 worker 정책을 이동했고 상세 전용 서비스가 트랜잭션 실패를 격리한다. 공개 API, DB 스키마, 의존성, 공급자 설정과 다른 리소스 호출 경로는 변경하지 않는다.
|
||||||
|
|
||||||
|
## 자동 검증 증거
|
||||||
|
|
||||||
|
- 신규 RANDOM_PORT 상세 HTTP/DB 15건 포함, 관련 30개 클래스 277건 통과(실패/오류/skip 0). 정확한 필터와 RED/GREEN 결과는 계획의 P2 진행 기록에 있다.
|
||||||
|
- 실제 유일키 경합: 상세 GET 2건과 worker 1건을 latch로 동기화해 H2 23505 충돌을 만들고 메모리 3행·번역 1행·COMPLETED job으로 수렴시켰다.
|
||||||
|
- 실제 CHECK 위반: payload insert와 메모리 UPDATE commit 실패에서도 원문 HTTP 200과 기존 job 복구가 유지됐다. 기존 번역의 retry-maintenance 실패도 응답을 막지 않았다.
|
||||||
|
- 마지막 포맷/미사용 생성자 제거 후 관련 17건 통과. `ktlintCheck` exit 0, production/test Kotlin 컴파일과 bootJar task 성공, `git diff --check` 통과.
|
||||||
|
- 기존 Gradle 9 deprecation, macOS Netty DNS, 작업 밖 Kotlin 불필요 `!!`/unchecked cast 경고는 suppress하거나 수정하지 않았다.
|
||||||
|
|
||||||
|
## 부모가 직접 실행한 HTTP QA
|
||||||
|
|
||||||
|
명령: `./gradlew --no-daemon -I "$RUN_TMP/qa.init.gradle" runContentDetailQa test --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.AudioContentReadRetryTest' --console=plain`.
|
||||||
|
임시 Java runner가 Spring 테스트 context와 기존 fixture를 재사용하되 Java HttpClient로 localhost 실제 Tomcat 서버를 호출했다. 테스트 principal과 외부 번역 provider만 대체했으며 controller/service/트랜잭션/JPA는 실제 코드다. 종료 코드 0.
|
||||||
|
|
||||||
|
| 시나리오 | 기대 | 실제 관찰 | 판정 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 최초 조회·재조회 | 첫 응답 번역 저장, 재조회 외부 재호출 없음 | GET 2회 모두 200, 번역 3필드 일치, provider 총 3회, 새 job 0개, DB title 일치 | PASS |
|
||||||
|
| 원문 언어 없음 | 같은 응답에서 언어 감지 및 번역 | GET 200, languageCode=ko, translated.title=English title, content DB language_code=ko | PASS |
|
||||||
|
| 공급자 실패와 복구 | 원문 200, job 등록 후 worker가 번역 | 첫 GET translated=null, 요청 언어 job 3개, worker 후 GET 번역 3필드 반환 | PASS |
|
||||||
|
| 저장 실패 격리와 복구 | 상세 commit 성공, 저장된 메모리 재사용 | 실제 CHECK 23513 후 GET 200/translated=null, job 3개, 제약 해제 및 worker 후 번역, provider 총 3회 | PASS |
|
||||||
|
|
||||||
|
실제 응답 발췌(테스트 데이터):
|
||||||
|
|
||||||
|
```text
|
||||||
|
GET http://localhost:58600/audio-content/1?timezone=UTC
|
||||||
|
200 content-type=application/json
|
||||||
|
languageCode="ko"
|
||||||
|
translated={"title":"English title","detail":"English detail","tags":"#Healing"}
|
||||||
|
|
||||||
|
GET http://localhost:58600/audio-content/3?timezone=UTC
|
||||||
|
200 content-type=application/json languageCode="ko" translated=null
|
||||||
|
worker 복구 후 같은 GET:
|
||||||
|
200 content-type=application/json
|
||||||
|
translated={"title":"English title","detail":"English detail","tags":"#Healing"}
|
||||||
|
|
||||||
|
QA PASS first-response/persist/reuse: provider=3 jobs=0
|
||||||
|
QA PASS unknown-language: detected and committed before response
|
||||||
|
QA PASS provider-failure/recovery: original 200, jobs=3, worker restored translation
|
||||||
|
QA PASS persistence-failure/isolation: original 200, worker reused committed memories
|
||||||
|
QA CLEANUP: HTTP server, JPA and Hikari context closed
|
||||||
|
```
|
||||||
|
|
||||||
|
## 실행 한계와 정리
|
||||||
|
|
||||||
|
- H2에서 실제 저장·커밋·경합을 검증했다. JSON fixture는 converter 텍스트 왕복용 varchar이며 운영 MySQL JSON 및 1062 경합/잠금 검증을 대체하지 않는다.
|
||||||
|
- 실제 AWS/Papago, 운영 DB, 실제 로그인, 전체 테스트, 배포는 실행하지 않았다. 전체 테스트 명령: `./gradlew test`.
|
||||||
|
- LSP 도구가 없어 Kotlin 컴파일/ktlint로 확인했다. 공급자 timeout 설정은 유지했으므로 첫 조회 지연은 외부 API 처리 시간에 좌우되며 경합 시 중복 공급자 호출은 가능하다.
|
||||||
|
- 첫 임시 QA 실행의 종료 순서 오류는 runner에서만 수정했다. 기능은 모두 성공했지만 그 실행의 전체 exit 1을 성공으로 기록하지 않는다.
|
||||||
|
- 최종 runner의 Tomcat 종료 직후 Hikari housekeeper 경고가 있었으나 뒤이어 JPA와 Hikari의 Shutdown completed가 출력됐고 프로세스가 exit 0으로 종료됐다.
|
||||||
|
- 구현자 소유 임시 root 2개 및 부모 RUN_TMP의 runner/init script/class/log/notepad는 제거 완료다. 부모가 디렉터리 부재(exit 0), QA runner/test worker/Gradle wrapper 없음, 포트 58600 listener 없음을 확인했다. 위 응답 발췌와 결과는 원본 임시 로그 삭제 전에 대조·보존했다. 공유 캐시/기존 IDE daemon은 유지했다.
|
||||||
|
|
||||||
|
## 독립 리뷰
|
||||||
|
|
||||||
|
2026-11-17 단일 Oracle reviewer 판정: **APPROVE**, 차단 사항 없음.
|
||||||
|
|
||||||
|
- MT-011~014: 기존 번역/메모리 재사용, 요청 언어의 즉시 응답, 동기 언어 감지, commit 실패 격리, 원문+기존 복구 경로와 동시 저장 수렴을 코드/증거로 확인했다.
|
||||||
|
- worker의 claim/6회 시도/backoff/1초 주기, AWS 태그 fallback 및 FAILED/완료 태그 복구를 보존했다. 공개 API/DB 스키마/의존성/공급자 설정/목록 진입점 변경은 없다.
|
||||||
|
- 현재 XML의 16+1건과 앞선 277건 기록을 구분했으며, 이전 XML을 다시 확인한 것으로 주장하지 않았다. 임시 runner 첫 실행의 종료 오류와 최종 성공도 구분했다.
|
||||||
|
- 새 테스트는 실제 응답·committed DB·제약 위반을 검증하고 경합 spy는 실제 저장을 위임한다. production 테스트 전용 hook이나 mock 결과만 반복하는 검증은 발견하지 못했다.
|
||||||
|
- 참고: 구매 전 원문 설명은 잘리지만 translated.detail은 전체 payload를 반환하는 기존 계약이 유지된다. 변경 전에도 같은 동작이므로 이번 변경의 신규 회귀는 아니다.
|
||||||
|
- 미검증: 운영 MySQL JSON/1062/잠금, 실제 공급자와 지연, 전체 테스트. 동시 외부 번역의 중복 호출 가능성은 남는다.
|
||||||
|
|
||||||
|
확정 발견 사항 없음. 회귀 수정 Goal 전환 항목 없음.
|
||||||
|
|
||||||
|
## 커밋 전 재검증
|
||||||
|
|
||||||
|
2026-11-17 사용자 커밋 요청에 따라 다음 명령을 실행했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.*' --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' --tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' --tests 'kr.co.vividnext.sodalive.osiv.OsivLazyLoadingRegressionTest' ktlintCheck bootJar --console=plain
|
||||||
|
git diff --check
|
||||||
|
```
|
||||||
|
|
||||||
|
- Gradle exit 0, `BUILD SUCCESSFUL in 2m 22s`.
|
||||||
|
- 현재 HTML 보고서와 XML 30개에서 277건, 실패/오류/skip 0을 확인했다. 신규 상세 HTTP 15건이 포함된다.
|
||||||
|
- `test`는 실제 재실행했으며 `ktlintCheck`와 `bootJar`는 UP-TO-DATE다. `git diff --check`는 exit 0이다.
|
||||||
|
- 전체 테스트·실제 외부 공급자·운영 MySQL 검증은 실행하지 않았다. 전체 테스트 사용자 실행 명령은 `./gradlew test`다.
|
||||||
@@ -0,0 +1,100 @@
|
|||||||
|
# 콘텐츠 태그 미번역 fallback 검증 및 리뷰
|
||||||
|
|
||||||
|
## 범위와 판정 기준
|
||||||
|
|
||||||
|
2026-11-16 P1-T3, MT-008/009. 콘텐츠 `tags`에 한정해 AWS가 원문을 그대로 반환하거나 쉼표 요소의 공백만 바꾼 경우 Papago를 사용한다.
|
||||||
|
사용자는 Papago도 같은 값을 반환하면 성공으로 인정한다고 명시했다. 일반 제목/본문과 다른 리소스 태그에는 적용하지 않는다.
|
||||||
|
기존 AWS 캐시를 일괄 삭제하지 않으며 현재 콘텐츠 조회/수정 시 해당 완료 작업만 복구한다.
|
||||||
|
실제 AWS에서 # 문자가 원인인지는 검증하지 않았다. 보고된 응답 형태를 외부 공급자 대역으로 재현하고 실제 coordinator/worker/JPA 동작을 검증했다.
|
||||||
|
|
||||||
|
## QA 증거
|
||||||
|
|
||||||
|
| 시나리오 | 실행/저장 경계 | 결과 |
|
||||||
|
|---|---|---|
|
||||||
|
| AWS 원문 동일·쉼표 공백 결과 | ContentTagTranslationIntegrationTest, 실제 worker/coordinator/materializer/H2 | Papago 호출 및 Papago 결과 저장, job COMPLETED |
|
||||||
|
| 기존 AWS 미번역 캐시 | 같은 테스트 | AWS 캐시를 무시하고 Papago 결과로 content_translation 조립 |
|
||||||
|
| AWS 캐시만 있는 조립 | 같은 테스트 | materialize=false, 잘못된 응답 행 생성 없음 |
|
||||||
|
| Papago 동일 결과 | 같은 테스트 | provider=papago, 동일 태그 저장 및 COMPLETED |
|
||||||
|
| AWS 정상 결과/일반 제목 | 같은 테스트 | 기존 AWS 성공 정책 유지, Papago 미호출 |
|
||||||
|
| Papago 장애 | 같은 테스트 | 잘못된 AWS 결과로 완료하지 않고 PENDING/retryCount=1, 캐시·응답 저장 없음 |
|
||||||
|
| 기존 잘못된 AWS 캐시 뒤 정상 AWS 결과 | 같은 테스트 | 같은 cache ID의 translatedText 갱신 및 정상 응답 조립 |
|
||||||
|
| 과거 완료 작업 복구 | CompletedContentTagRepairTest, H2 | 같은 작업 ID를 조건부 COMPLETED→PENDING, count0/error null/due now |
|
||||||
|
| 정상/비대상/경합 보호 | 같은 테스트 | Papago 확인 동일 태그, 정상 AWS 번역, 다른 원문/언어/리소스/필드, PENDING/RUNNING 보호 |
|
||||||
|
| 조회→worker→재조회 연속 흐름 | ContentTagTranslationIntegrationTest.shouldRepairCompletedTagsOnceAcrossReadWorkerAndRead | 동일 ID 복구 후 Papago 동일 결과를 저장하고 다음 조회에서는 COMPLETED 유지 |
|
||||||
|
|
||||||
|
연속 흐름의 실제 테스트 출력:
|
||||||
|
|
||||||
|
```text
|
||||||
|
Tag repair QA: same job=3, AWS unchanged rejected, Papago identical accepted, next read remains COMPLETED
|
||||||
|
```
|
||||||
|
|
||||||
|
최종 XML: `build/test-results/test/TEST-kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest.xml`.
|
||||||
|
태그 원문 추출은 이 통합 테스트의 고정 fixture이며 worker/coordinator/repository/materializer는 실제 구현이다.
|
||||||
|
공급자 응답만 통제하고 H2 JSON의 문자열 감싸기 차이는 테스트에서 JSON 객체로 맞춘다. 운영 저장 변환은 변경하지 않았다.
|
||||||
|
|
||||||
|
## RED/GREEN
|
||||||
|
|
||||||
|
- 최초 테스트 cleanup이 H2 JSON 변환으로 실패한 것은 setup 문제로 분류하고 bulk cleanup으로 수정했다.
|
||||||
|
- forward 8건 중 6건 RED: AWS 동일 결과/캐시가 성공으로 처리되는 assertion 실패. 구현 후 forward/coordinator/worker 29건 GREEN.
|
||||||
|
- completed repair 27건 중 11건 RED: 현재 COMPLETED 중복 가드로 재개되지 않음. 구현 후 27건 GREEN.
|
||||||
|
- cache refresh 추가 RED 1건: 정상 AWS 결과가 와도 기존 미번역 캐시가 갱신되지 않음. 같은 행의 translatedText 갱신으로 GREEN.
|
||||||
|
- 일반 회귀 실행은 번역 패키지+감지 원자성+감지 캐시 232건 모두 통과했으나 lint에서 새 multiline 조건 braces 누락이 발견됐다. 변경 줄만 수정했다.
|
||||||
|
|
||||||
|
## 실행 명령
|
||||||
|
|
||||||
|
공통 회귀:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' --continue
|
||||||
|
```
|
||||||
|
|
||||||
|
테스트 232건은 실패/오류/skip 0, 이 실행의 비정상 종료 원인은 위 lint 3건이었다.
|
||||||
|
|
||||||
|
보완 후 직접 영향 회귀 및 최종 lint/build:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.CompletedContentTagRepairTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationCoordinatorTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.osiv.OsivLazyLoadingRegressionTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
exit 0, 10개 클래스 104건 실패/오류/skip 0. 두 실행의 중복을 제외한 고유 기능 검증은 277건이다.
|
||||||
|
최종 `git diff --check`도 통과했다. Kotlin 컴파일·ktlint를 사용했으며 LSP 도구는 제공되지 않았다.
|
||||||
|
|
||||||
|
## 미검증과 최종 상태
|
||||||
|
|
||||||
|
- 실제 AWS/Papago 호출·번역 품질/과금/IAM 및 운영 MySQL 잠금은 미검증이다. 원문 동일 판정은 번역 품질 전반이나 일부 태그만 미번역인 상황을 판정하지 않는다.
|
||||||
|
- 전체 테스트는 사용자 실행 `./gradlew test`로 구분한다. 운영 DB 일괄 변경과 커밋/배포는 하지 않았다.
|
||||||
|
- 단일 독립 gate review APPROVE. MT-008/009, 태그 전용 결과/캐시 판정, 같은 캐시 행 갱신, 완료 작업 조건부 복구, Papago 동일 결과의 반복 재개 방지, 상태 경쟁 보호와 104건 최종 XML/lint/build 증거를 확인했다. 차단 사항 없음.
|
||||||
|
- 정리 완료: reviewer가 원본 실행 로그를 확인한 뒤 소유 임시 루트 `tag-fallback.UmKdRY`와 하위 로그/메모를 삭제하고 경로 부재를 확인했다. 소유 Gradle test worker/Redis 프로세스 없음, 공유 캐시 보존. 검증 이력은 이 문서와 계획에 유지한다.
|
||||||
|
|
||||||
|
## 2026-11-17 커밋 전 재검증
|
||||||
|
|
||||||
|
사용자 커밋 요청에 따라 태그 처리와 직접 영향 기능을 재검증했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.osiv.OsivLazyLoadingRegressionTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
- exit 0, 1분 17초. XML 32개 클래스 277건, 실패/오류/skip 0.
|
||||||
|
- 테스트는 실행됐고 ktlintCheck/bootJar는 UP-TO-DATE다. `git diff --check`도 통과했다.
|
||||||
|
- 전체 테스트는 미실행이며 사용자 실행 명령은 `./gradlew test`다. 실제 AWS/Papago 및 운영 MySQL 검증은 포함하지 않는다.
|
||||||
@@ -0,0 +1,166 @@
|
|||||||
|
# 메타데이터 번역 검증 기록
|
||||||
|
|
||||||
|
## 환경과 범위
|
||||||
|
|
||||||
|
- 2026-11-16, macOS x64, Java 17.0.15, Gradle Wrapper 8.1.1.
|
||||||
|
- 커밋하지 않은 작업 트리의 구현을 부모 세션에서 검증했다.
|
||||||
|
- 실제 Spring/JPA/H2 및 MockMvc controller 요청을 실행했다. 외부 AWS/Papago 호출은 SDK/공급자 경계의 테스트 대역으로 대체했다.
|
||||||
|
- 실제 운영 DB, 배포 환경변수, IAM, 외부 공급자의 지연/품질/과금은 미검증이다.
|
||||||
|
- LSP 도구가 없어 Kotlin 컴파일과 ktlint로 진단했다. 전체 테스트는 저장소 정책대로 사용자 실행 `./gradlew test`다.
|
||||||
|
|
||||||
|
## QA 결과
|
||||||
|
|
||||||
|
| 시나리오 | 실행 경계 | 기대 결과 | 관찰 결과 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 감지 후 작업 등록 | MetadataLanguageDetectTransactionTest, Spring/JPA | 콘텐츠/캐릭터/시리즈/원작/카테고리의 languageCode와 en/ja 필드 작업이 함께 저장 | 5개 대상 모두 커밋 전/후 저장 일치 |
|
||||||
|
| 작업 저장 실패 | 같은 테스트, H2 CHECK로 ja INSERT 거부 | 선행 en 작업과 languageCode 함께 롤백 | 5개 대상 모두 null 언어/작업 0개 |
|
||||||
|
| 최초+5회 재시도 | TranslationJobWorkerTest | 실패 1~5회 PENDING, 1/5/15/15/15분, 실패 6회 FAILED | 경계 6사례 및 마지막 재시도 성공 사례 통과 |
|
||||||
|
| FAILED 요청 재개 | TranslationJobRetryIntegrationTest, H2 | 동일 ID 재개, count 0/error null/due now, active/completed 보호 | 기존 3회/6회 FAILED 및 동시 요청/오래된 조회 후 RUNNING 보호 통과 |
|
||||||
|
| 조회 응답 유지 | 6개 ReadRetryTest 클래스, H2 | 기존 번역/원문 fallback 유지하며 현재 원문의 FAILED만 재개 | 15건 통과, 이전 해시/다른 언어/다른 대상 locale/제외 테마 보호 |
|
||||||
|
| 관리자 HTTP 수정 | MetadataTranslationHttpIntegrationTest, MockMvc + 실제 서비스/이벤트/JPA | HTTP 200, 커밋 후 동일 FAILED 행 재개와 4개 필드 작업 | 아래 실제 출력, PENDING/count 0/error null 및 title/detail × en/ja 4개 확인 |
|
||||||
|
| 공급자 기본값 | LanguageProviderSpringConfigurationTest/TranslationCoordinatorTest | 감지 Papago 우선, 번역 AWS 우선, 실패 시 Papago, 기존 캐시 재사용 | 실제 Spring 기본 설정과 공급자 선택/캐시 모두 통과 |
|
||||||
|
| 워커 주기 | TranslationJobWorkerTest | 기본 1000ms, 실행당 최대 5개 그룹 | 기본 스케줄 계약과 실행 상한 통과 |
|
||||||
|
|
||||||
|
HTTP QA 출력:
|
||||||
|
|
||||||
|
```text
|
||||||
|
HTTP QA: status=200, body={"success":true,"message":null,"data":{},"errorProperty":null}, contentId=1, restartedJobId=1
|
||||||
|
```
|
||||||
|
|
||||||
|
HTTP 증거 파일은 `build/test-results/test/TEST-kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest.xml`이다.
|
||||||
|
MockMvc standalone controller는 인증 필터 검증이 아니라 multipart 입력부터 실제 서비스/커밋 이벤트/DB까지의 연결 검증이다.
|
||||||
|
동기 테스트 executor로 커밋 후 실행을 결정적으로 검증했으며 실제 스레드 스케줄링 지연은 측정하지 않았다.
|
||||||
|
H2 worker claim 검증은 운영 SQL에서 SKIP LOCKED 옵션만 제거했으므로 MySQL 잠금 동시성 검증으로 해석하지 않는다.
|
||||||
|
|
||||||
|
## 실패를 잡는 증거
|
||||||
|
|
||||||
|
- 변경 전 기준 worker/scheduler/provider 테스트는 통과했다.
|
||||||
|
- 최초 RED: 43건 중 14건 실패. 기존 10분 기본값, 3회 실패 종료, FAILED 미재개, Papago 우선이 예상 assertion 실패로 나타났다.
|
||||||
|
- 연결 RED: 감지 10건, 조회 10건, 관리자 수정 8건이 예상 assertion으로 실패했고 컴파일은 성공했다.
|
||||||
|
- HTTP 테스트 추가 검증: 관리자 이벤트 발행 조건만 일시적으로 false로 바꾸자 HTTP 요청은 성공하더라도 `PENDING` 기대에서 실패했다. 조건을 원래 수정본으로 복원한 뒤 같은 테스트가 통과했다. 변이는 남기지 않았다.
|
||||||
|
|
||||||
|
## 통과한 실행
|
||||||
|
|
||||||
|
### 번역·언어 감지 회귀: 191건
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
25개 클래스, failures/errors/skipped 모두 0. 공급자 adapter/캐시, retry, read, HTTP, 감지 원자성 포함.
|
||||||
|
|
||||||
|
### 직접 영향 기능 회귀: 67건
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.admin.content.AdminContentServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.chat.character.controller.ChatCharacterControllerTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.content.LegacyCreatorAdminAudioContentCharacterizationTest.shouldRequestTranslationAfterCommitWhenMetadataIsUpdatedWithoutTags*'
|
||||||
|
```
|
||||||
|
|
||||||
|
9개 클래스, failures/errors/skipped 모두 0. 위 191건과 HTTP 1건이 중복되므로 합계는 257개 고유 사례다.
|
||||||
|
|
||||||
|
### 포맷 수정 후 최종 체크: 49건 + lint/build
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.content.LegacyCreatorAdminAudioContentCharacterizationTest.shouldRequestTranslationAfterCommitWhenMetadataIsUpdatedWithoutTags*'
|
||||||
|
```
|
||||||
|
|
||||||
|
exit 0. 앞선 lint 실행에서 새 호출의 인자 줄바꿈과 테스트 한 줄 길이 위반을 발견해 변경 줄만 수정했다.
|
||||||
|
운영/테스트 Kotlin 컴파일, ktlintCheck, bootJar 및 수정된 기능 49건이 통과했다. Gradle 9 호환성 deprecation 안내는 기존 상태다.
|
||||||
|
|
||||||
|
기능 회귀의 전체 Spring context에서는 기존 MySQL 전용 SKIP LOCKED 쿼리를 H2 스케줄러가 실행해 SQL 구문 오류가 로그에 남았다.
|
||||||
|
테스트 assertion 실패는 없지만 이 실행을 운영 MySQL 워커 claim 검증으로 간주하지 않는다. 쿼리는 이번 변경에서 수정하지 않았다.
|
||||||
|
embedded Redis 종료 시 기존 연결의 재접속 WARN도 출력됐다. 실행 후 Gradle test worker/redis-server 잔존 프로세스는 없었다.
|
||||||
|
별도의 기존 Gradle daemon PID 1396은 이번 --no-daemon 실행의 소유 프로세스가 아니므로 종료하지 않았다.
|
||||||
|
|
||||||
|
## P1-R1 리뷰 후 회귀 보완
|
||||||
|
|
||||||
|
reviewer는 공통 예약 경로에서 이전 원문 언어의 FAILED도 재개하는 누락을 확인했다.
|
||||||
|
직접 예약 및 기존 번역 행 없는 원작 조회의 2개 테스트가 FAILED 기대/PENDING 실제로 실패하는 것을 확인했다.
|
||||||
|
`TranslationJobScheduler`의 FAILED 재개 조건에 `existingJob.sourceLanguage == normalizedSourceLanguage`를 추가했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobSchedulerTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
14개 클래스 74건, failures/errors/skipped 모두 0, lint/build exit 0.
|
||||||
|
원문 언어 불일치 직접 예약/번역 없는 조회 2건이 추가되어 이번 작업의 고유 검증 사례는 259건이다.
|
||||||
|
마지막 XML에서도 HTTP 200과 동일 ID FAILED 재개를 재확인했다. 차단 사항 delta 재검토 대기.
|
||||||
|
|
||||||
|
## 최종 판정과 운영 확인 범위
|
||||||
|
|
||||||
|
- 독립 gate reviewer의 첫 판정은 원문 언어 불일치 재개의 P1 차단 사항으로 REJECT였다. 두 회귀 테스트와 guard 추가 후 delta 재검토는 APPROVE다. 최종 차단 사항 없음.
|
||||||
|
- 운영의 `sodalive.translation-job.fixed-delay-ms` override가 있으면 새 기본값을 덮어쓴다. 운영 설정과 실제 공급자 지연/쿼터는 배포 시 확인 대상이다.
|
||||||
|
- 큐가 비어 있을 때의 1초 polling 기준을 바꿨으며 번역 완료 1초 SLA를 주장하지 않는다.
|
||||||
|
- 정리 완료: 독립 리뷰가 원본 로그를 읽고 승인한 후 이번 실행의 임시 디렉터리 `translation-ulw.jWBKaK`와 하위 로그/메모를 삭제하고 경로 부재를 확인했다. 영속 검증 기록은 이 문서와 계획에 남겼다. 소유 test worker/Redis 프로세스는 남아 있지 않으며 공유 캐시와 기존 Gradle daemon은 건드리지 않았다. 최종 `git diff --check`도 통과했다.
|
||||||
|
|
||||||
|
## 후속 P1-T2: 감지 AWS 우선
|
||||||
|
|
||||||
|
사용자 후속 승인에 따라 감지도 AWS/Papago 순서로 정정했다. 이전 절의 Papago 감지 유지 검증은 초기 요구사항에 대한 이력이다.
|
||||||
|
새 기본값의 Spring 감지 선택, 실제 AWS adapter의 SDK 응답 사용, AWS 예외/null/blank 뒤 Papago 전환,
|
||||||
|
기존 Papago 감지 캐시의 외부 호출 없는 재사용을 검증했다. 번역 우선순위와 명시적 테스트 순서 설정은 유지했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageProvider*Test' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProviderTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoLanguageDetectionProviderTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
변경 전 7개 assertion RED, 변경 후 8개 클래스 49건의 실패/오류/skip 0 및 lint/build exit 0.
|
||||||
|
H2 E2E는 전체 원문별 AWS 감지 캐시 2개 저장 및 반복 요청의 SDK 무호출을 검증한다.
|
||||||
|
실제 외부 API 호출/정확도 비교/IAM과 전체 테스트는 실행하지 않았다. 후속 delta 리뷰 대기.
|
||||||
|
|
||||||
|
후속 delta 최종 판정은 APPROVE다. reviewer가 코드·Spring/SDK 경계·H2 캐시·RED/GREEN과 49건 XML을 확인했다.
|
||||||
|
비차단 지적이었던 현재 가이드의 테스트 설명도 AWS 우선으로 정정했다.
|
||||||
|
승인 후 `detection-aws.4a18xV` 임시 루트와 로그/메모를 삭제하고 경로 부재를 확인했다.
|
||||||
|
소유 test worker/Redis 프로세스는 없으며, 공유 캐시는 보존했다. 후속 `git diff --check`도 통과했다.
|
||||||
|
|
||||||
|
## 커밋 전 재검증
|
||||||
|
|
||||||
|
2026-11-16 사용자 커밋 요청에 따라 최종 변경 상태에서 다음 명령을 실행했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintCheck bootJar test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.i18n.translation.*' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.LanguageDetectionCacheServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.AudioContentServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.admin.content.AdminContentServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.chat.character.controller.ChatCharacterControllerTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.content.CreatorCommunityLanguageDetectionCacheConcurrencyTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.community.translation.CreatorCommunityTranslationServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityTranslationEndToEndTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.content.LegacyCreatorAdminAudioContentCharacterizationTest.shouldRequestTranslationAfterCommitWhenMetadataIsUpdatedWithoutTags*'
|
||||||
|
```
|
||||||
|
|
||||||
|
- exit 0, `BUILD SUCCESSFUL in 2m 3s`. 테스트를 새로 실행했고 ktlintCheck/bootJar는 UP-TO-DATE다.
|
||||||
|
- `build/test-results/test/TEST-*.xml` 33개 클래스 261건에서 failures/errors/skipped 모두 0을 확인했다.
|
||||||
|
- 전체 테스트와 운영 MySQL/외부 공급자 검증은 미실행이다. 전체 테스트 사용자 실행 명령은 `./gradlew test`다.
|
||||||
@@ -0,0 +1,362 @@
|
|||||||
|
# 관리자 번역 선택 API 계약
|
||||||
|
|
||||||
|
> **상태: 서버 구현과 P7 자동 등록 변경의 로컬 검증·부모 직접 검토 완료.** 이 문서의 9개 endpoint와 typed DTO·오류·저장 계약을 구현했다. DEC-11에 따라 controller와 후보 worker는 활성화 설정 없이 애플리케이션 기동 시 등록된다. 기존 외부 최종 APPROVE는 P1~P5 기록이며 P7은 사용자 지시에 따라 부모가 직접 검토·빌드해 종결했다. 운영 MySQL 검증, DDL 실행과 배포는 수행하지 않았다.
|
||||||
|
|
||||||
|
배포된 코드에서는 별도 기능 활성화 단계가 없다. 신규 writer가 작업을 생성하기 전에 세 신규 테이블과 source-language 포함 queue unique index를 준비하고, 구 writer와 in-flight 작업 종료 및 구 unique index 제거를 완료해야 한다. 애플리케이션은 DDL을 자동 적용하지 않는다. 후보 worker의 기본 fixed delay 1000ms와 기존 Redisson `lock:translation-selection` 잠금은 유지한다.
|
||||||
|
|
||||||
|
## 1. 목적 및 문서 기준
|
||||||
|
|
||||||
|
이 문서는 관리자 다중 제공자 번역 후보의 생성·검토·선택·적용을 위한 서버와 프론트엔드 간 계약을 제안한다. 사용자 동작 기준은 [prd.md](prd.md), 구현 순서와 검증 기준은 [plan-task.md](plan-task.md)를 따른다.
|
||||||
|
|
||||||
|
이 API는 기존 CONTENT 번역 응답과 `ContentTranslation.renderedPayload` 구조를 변경하지 않는다. 후보 및 승인 출처 정보는 이 제안의 신규 테이블에 저장한다. 신규 경로는 기존 ADMIN 인증 경계 아래 추가하며, 프론트엔드 구현은 범위 밖이다.
|
||||||
|
|
||||||
|
## 2. 용어와 상태
|
||||||
|
|
||||||
|
| 용어 | 의미 |
|
||||||
|
|---|---|
|
||||||
|
| Request | 관리자 1회 생성 요청. 적용은 한 번의 부분 선택으로 종료한다. |
|
||||||
|
| Scope | 단일 콘텐츠 `CONTENT` 또는 하나의 시리즈 `SERIES`와 요청 생성 시점의 모든 활성 연결 콘텐츠. 시리즈의 비활성 콘텐츠는 제외한다. |
|
||||||
|
| Candidate | 원본 단위·제공자·대상 언어에 대한 신규 번역 결과 또는 그 제공자별 실패. 기존 번역 메모리와 별도다. |
|
||||||
|
| Field unit | 콘텐츠 하나의 `title`, `detail`, `tags` 전체 텍스트 후보. |
|
||||||
|
| Title group | 관리자가 번역 생성 전에 검토한 공통 제목 구간과 구성원. 그룹과 언어별 적용은 원자적이다. |
|
||||||
|
| Residual | 제목 템플릿에서 공통 구간 및 원문 literal 외의 원문 구간. 구성원 단위로 제공자 후보를 만든다. |
|
||||||
|
|
||||||
|
### 2.1 Request 상태
|
||||||
|
|
||||||
|
| 상태 | 설명 | 허용 전이 |
|
||||||
|
|---|---|---|
|
||||||
|
| `PREPARING` | 대상 스냅샷과 원본 언어를 준비한다. | `REVIEW_REQUIRED`, `READY_TO_GENERATE`, `FAILED`, `CANCELLED` |
|
||||||
|
| `REVIEW_REQUIRED` | 시리즈 그룹 분석을 관리자 검토에 제공한다. 모든 항목을 개별 처리하는 결과도 검토가 필수다. | `READY_TO_GENERATE`, `CANCELLED` |
|
||||||
|
| `READY_TO_GENERATE` | 단일 콘텐츠이거나 그룹 검토가 완료됐다. | `GENERATING`, `CANCELLED` |
|
||||||
|
| `GENERATING` | 확정 manifest의 제공자별 후보 요청을 수행한다. | `READY`, `CANCELLED` |
|
||||||
|
| `READY` | 각 후보 작업이 성공 또는 실패로 종결됐다. | `APPLIED`, `CANCELLED` |
|
||||||
|
| `APPLIED` | 선택한 일부 값이 원자 적용됐고 나머지 후보는 폐기됐다. | 종료 |
|
||||||
|
| `CANCELLED` | 취소가 확정됐다. 진행 중 이미 전송된 외부 호출은 되돌릴 수 없다. | 종료 |
|
||||||
|
| `FAILED` | 후보 생성 전 준비가 복구 불가능한 오류로 실패했다. | 종료 |
|
||||||
|
|
||||||
|
### 2.2 Candidate 상태
|
||||||
|
|
||||||
|
`PENDING → RUNNING → SUCCEEDED | FAILED`. 취소 또는 성공적 부분 적용으로 미선택된 작업은 `DISCARDED`로 종료한다. 제공자 실패는 해당 후보의 `FAILED`일 뿐이며 다른 제공자 결과를 대체하지 않는다. 모든 제공자가 실패해도 요청은 후보 작업 종결 후 `READY`가 된다.
|
||||||
|
|
||||||
|
## 3. 공통 API 규칙
|
||||||
|
|
||||||
|
### 3.1 인증과 응답
|
||||||
|
|
||||||
|
- 모든 endpoint는 **`ADMIN` role** 전용이다. `CONTENT_MANAGER`, creator 관리자 role은 이 API의 권한이 아니다.
|
||||||
|
- 기존 인증 주체 및 null guard를 사용한다. 신규 controller의 권한 규칙은 기존 `@PreAuthorize("hasRole('ADMIN')")` 관례를 따른다.
|
||||||
|
- 성공과 business error는 기존 `ApiResponse<T>` envelope(`success`, `message`, `data`, `errorProperty`)를 사용한다. Controller는 `ApiResponse.ok(...)`를 반환하고 business 오류는 `SodaException(messageKey, errorProperty)`로 전달한다.
|
||||||
|
- 오류 envelope의 HTTP 동작은 현재 `SodaExceptionHandler` 계약을 따른다. 이 기능 때문에 공통 exception handler를 바꾸지 않는다. 인증/접근 거부도 기존 Security 및 handler 동작을 유지한다.
|
||||||
|
- 이 경로의 모든 오류는 `errorProperty`에 아래 안정 코드를 전달하도록 제안한다. 사용자 표시문은 기존 message key/localization 흐름에 둔다. 제공자 raw exception/body는 반환하지 않는다.
|
||||||
|
|
||||||
|
### 3.2 타입과 정규화
|
||||||
|
|
||||||
|
| 타입 | 표현 및 제약 |
|
||||||
|
|---|---|
|
||||||
|
| ID | JSON signed 64-bit integer로 제안. 기존 Kotlin/JPA `Long` 식별자 관례를 유지한다. |
|
||||||
|
| UUID | 표준 소문자 UUID 문자열. `clientRequestId`, `operationId`에 사용한다. |
|
||||||
|
| `FieldKey` | `title`, `detail`, `tags` |
|
||||||
|
| `LanguageCode` | 현재 `TranslationLanguages` 기준 `ko`, `en`, `ja`. source language는 target에서 제외한다. |
|
||||||
|
| `ProviderId` | 서버가 알려주는 기존 `TranslationProvider.providerId.code`; 고정 후보 목록을 API가 추가로 만들지 않는다. |
|
||||||
|
| Timestamp | UTC ISO-8601, 초 정밀도. 새 DB timestamp는 MySQL `TIMESTAMP` 소수초 미지정 기준으로 정규화해 DB와 응답에 같은 값을 쓴다. |
|
||||||
|
| Fingerprint | 정확한 원문·언어 fingerprint를 식별하는 불투명 버전 포함 문자열. 클라이언트가 생성하거나 수정하지 않는다. |
|
||||||
|
|
||||||
|
선택 요청은 번역문을 보내지 않는다. 입력 경계에서 scope, ID, target language, group/range, UUID, revision, 선택의 중복 및 상호 일관성을 검증한다. 무제한 전체 결과 반환 대신 cursor page를 쓴다.
|
||||||
|
|
||||||
|
### 3.3 공통 오류 코드 제안
|
||||||
|
|
||||||
|
| `errorProperty` | 의미 |
|
||||||
|
|---|---|
|
||||||
|
| `INVALID_REQUEST` | 필드, 언어, UUID, ID 또는 범위 형식이 올바르지 않음 |
|
||||||
|
| `RESOURCE_NOT_FOUND` | 요청·콘텐츠·시리즈를 찾을 수 없거나 접근 가능한 scope가 아님 |
|
||||||
|
| `EMPTY_SCOPE` | 시리즈에 현재 연결된 콘텐츠가 없음 |
|
||||||
|
| `UNSUPPORTED_SOURCE_LANGUAGE` | 감지/지정된 원본 언어가 지원되지 않음 |
|
||||||
|
| `LANGUAGE_DETECTION_FAILED` | 원본 언어를 준비할 수 없음 |
|
||||||
|
| `REVIEW_REQUIRED` | 시리즈 그룹 검토 전에 생성 요청 |
|
||||||
|
| `INVALID_GROUPING` | 중복·누락 구성원, 유효하지 않은 range 또는 서버 규칙 위반 |
|
||||||
|
| `REVISION_CONFLICT` | 편집·생성 요청 revision이 최신 값과 다름 |
|
||||||
|
| `REQUEST_NOT_READY` | 현재 상태에서 수행할 수 없는 요청 |
|
||||||
|
| `REQUEST_CLOSED` | 취소·적용·준비 실패 상태에 mutation 요청 |
|
||||||
|
| `CANDIDATE_NOT_SELECTABLE` | 다른 요청·단위·언어·제공자이거나 성공하지 않은 후보 |
|
||||||
|
| `INCOMPLETE_TITLE_GROUP` | 그룹 공통/구성원 residual 선택이 완전하지 않음 |
|
||||||
|
| `SOURCE_CHANGED` | 선택 적용 대상 필드의 원본이 생성 snapshot과 달라짐 |
|
||||||
|
| `MEMBERSHIP_CHANGED` | 선택한 제목 그룹의 현재 시리즈 구성원이 생성 snapshot과 달라짐 |
|
||||||
|
| `IDEMPOTENCY_CONFLICT` | 동일 idempotency key가 다른 body와 재사용됨 |
|
||||||
|
|
||||||
|
오류 코드와 message key는 P3-P5 구현에 추가됐다. P5는 후보 선택 불가·불완전 그룹·원문 변경·구성원 변경의 한국어/영어/일본어 메시지를 연결했다.
|
||||||
|
|
||||||
|
## 4. 신규 endpoint 제안
|
||||||
|
|
||||||
|
Base path: **`/admin/audio-content/translation-requests`** (P5 종료 시 아래 모든 경로 로컬 구현 완료)
|
||||||
|
|
||||||
|
| Method와 경로 | 목적 | 접근 가능 상태 |
|
||||||
|
|---|---|---|
|
||||||
|
| `POST /` | 새 scope 요청 및 후보 준비 예약 | 새 요청 생성 |
|
||||||
|
| `GET /{requestId}` | 상태, 요약, revision 및 적용 영수증 조회 | 모든 상태 |
|
||||||
|
| `GET /{requestId}/contents` | snapshot 콘텐츠와 현재 값 페이지 조회 | 모든 상태 |
|
||||||
|
| `GET /{requestId}/grouping` | 제안/검토된 그룹 템플릿 조회 | `REVIEW_REQUIRED` 이후 |
|
||||||
|
| `PUT /{requestId}/grouping` | 전체 그룹/개별 목록 교체 및 리뷰 확정·수정 | `REVIEW_REQUIRED`, `READY_TO_GENERATE` |
|
||||||
|
| `POST /{requestId}/generate` | manifest 고정, 생성 작업 시작 | `READY_TO_GENERATE` |
|
||||||
|
| `GET /{requestId}/candidates` | 단위별 후보/제공자 상태 cursor 조회 | `GENERATING`, `READY`, terminal |
|
||||||
|
| `POST /{requestId}/apply` | 선택한 subset을 한 트랜잭션에 적용하고 종료 | `READY` |
|
||||||
|
| `POST /{requestId}/cancel` | 미적용 요청 취소 | 모든 nonterminal 상태 및 `READY` |
|
||||||
|
|
||||||
|
`APPLIED` 요청은 취소할 수 없다. 같은 취소의 재시도는 이미 취소됐다는 terminal 응답을 반환한다. 그룹이나 원문 변경 후 재생성을 위한 update/restart endpoint는 제공하지 않는다. 기존 요청을 취소하고 새 요청을 생성한다.
|
||||||
|
|
||||||
|
## 5. Request DTO와 응답
|
||||||
|
|
||||||
|
### 5.1 요청 생성
|
||||||
|
|
||||||
|
`POST /` body:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"clientRequestId": "d7c2f4e1-1e4f-4ac2-a6ed-85f2f8102101",
|
||||||
|
"scope": { "type": "CONTENT", "contentId": 4102 }
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
`scope`는 다음 합 타입 중 하나다.
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "type": "CONTENT", "contentId": 4102 }
|
||||||
|
{ "type": "SERIES", "seriesId": 981 }
|
||||||
|
```
|
||||||
|
|
||||||
|
Response `data`는 `TranslationSelectionRequestResponse`:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"requestId": 710,
|
||||||
|
"scope": { "type": "SERIES", "seriesId": 981 },
|
||||||
|
"status": "PREPARING",
|
||||||
|
"revision": 1,
|
||||||
|
"createdAt": "2026-11-17T07:00:00Z",
|
||||||
|
"providerManifest": [],
|
||||||
|
"targetLanguages": [],
|
||||||
|
"contentCount": 0,
|
||||||
|
"progress": { "total": 0, "terminal": 0, "succeeded": 0, "failed": 0 },
|
||||||
|
"errorCode": null,
|
||||||
|
"applyReceipt": null
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
예시 숫자와 UUID는 schema 설명용 값이며 실제 자원이나 구현된 ID를 지칭하지 않는다. 생성 transaction에서 요청을 `PREPARING`으로 저장하며 현재 활성 series membership의 content ID 집합도 고정한다. 활성 연결 콘텐츠가 없으면 저장된 요청을 `FAILED/EMPTY_SCOPE`로 종결한다. 원본 언어와 필드 snapshot은 비동기 preparation에서 확정한다. 이 시간 구분은 최종 snapshot을 만들기 전에 이미 번역이 시작됐다는 뜻이 아니다.
|
||||||
|
|
||||||
|
동일 feature poller가 `PREPARING` request를 lease/fence로 claim한다. 기존 source language를 사용하고 누락된 경우에만 감지한다. 감지 호출 전후 취소를 확인하며 최종 source snapshot 저장 전에 잠금 안에서 원문·언어·활성 membership을 재검증한다. 원문이 달라졌으면 해당 준비를 `FAILED/SOURCE_CHANGED`, membership이 달라졌으면 `FAILED/MEMBERSHIP_CHANGED`로 종결하고 재요청을 안내한다. 준비 중 crash는 lease 만료 후 한 번만 복구하며 두 번째 만료는 `FAILED/PREPARATION_INTERRUPTED`로 종결한다.
|
||||||
|
|
||||||
|
Idempotency: `(authenticatedAdminId, clientRequestId)` unique. 동일 UUID와 canonical body hash면 원래 요청을 반환한다. 다른 body hash면 `IDEMPOTENCY_CONFLICT`. 클라이언트는 retry에 같은 UUID와 같은 body를 보낸다.
|
||||||
|
|
||||||
|
### 5.2 Request 요약 조회
|
||||||
|
|
||||||
|
`GET /{requestId}`는 위 response를 반환한다. `PREPARING`와 `GENERATING` progress는 상태 조회 시점의 단순 snapshot이다. `READY`는 모든 candidate 작업이 terminal인 뜻이며, 일부/전부 실패도 포함한다. `APPLIED`는 receipt를 포함한다. 원시 provider 예외나 credential/요청 body는 포함하지 않는다.
|
||||||
|
|
||||||
|
### 5.3 콘텐츠 페이지
|
||||||
|
|
||||||
|
`GET /{requestId}/contents?afterContentId={id}&size=50` (`size` 기본 50, 최대 100)
|
||||||
|
|
||||||
|
Response data는 `{items: List<ContentSnapshotResponse>, nextAfterContentId: Long?}`다.
|
||||||
|
|
||||||
|
| `ContentSnapshotResponse` 필드 | 타입·의미 |
|
||||||
|
|---|---|
|
||||||
|
| `contentId`, `active`, `eligible` | `Long`, 조회 시 현재 활성 여부 `Boolean`, 해당 scope의 현재 적용 자격 `Boolean` |
|
||||||
|
| `sourceLanguage` | 고정 snapshot의 `LanguageCode` |
|
||||||
|
| `sourceFields` | `Map<FieldKey, String>`; title/detail/tags가 모두 존재 |
|
||||||
|
| `sourceFingerprints`, `currentSourceFingerprints` | 고정 `Map<FieldKey, String>`과 현재 `Map<FieldKey, String>?` |
|
||||||
|
| `emptyFields` | `List<FieldKey>`; 번역할 텍스트가 없어 후보를 만들지 않은 필드 |
|
||||||
|
| `currentTranslations` | `List<{targetLanguage: LanguageCode, fields: Map<FieldKey, String>, approvalOrigins: Map<FieldKey, ADMIN/UNKNOWN>, approvalProvenance: Map<FieldKey, ApprovalProvenance>}>` |
|
||||||
|
|
||||||
|
시리즈 scope는 생성 시 활성 member만 포함한다. `sourceLanguage`, `sourceFields`, `sourceFingerprints`는 준비 완료 시 고정된 snapshot이다. `currentTranslations`, `active`는 조회 시점 값이다. 각 item은 `currentSourceFingerprints: Map<FieldKey, String>?`, `eligible: Boolean`도 반환한다. 삭제된 콘텐츠는 현재 fingerprint가 null이고 eligible=false이며 snapshot은 남는다. 프론트엔드는 변경 여부를 표시할 수 있지만 최종 적용 가능 여부는 서버가 잠금 안에서 판정한다.
|
||||||
|
|
||||||
|
`approvalOrigins` 값은 `ADMIN` 또는 `UNKNOWN`이다. 유효한 field override row가 있는 값만 `ADMIN`으로 표시한다. 해당 승인 필드에는 `approvalProvenance: Map<FieldKey, {requestId: Long, candidateIds: List<Long>, providers: List<{id: String, version: String}>, approvedBy: Long, approvedAt: Timestamp}>`도 반환한다. 기존 값의 provider는 추정하지 않는다. 현재 translation row가 없으면 현재 원문 fallback을 제공한다. 마지막 페이지의 `nextAfterContentId`는 null이다. `PREPARING`에서는 아직 확정되지 않은 items를 반환하지 않는다.
|
||||||
|
|
||||||
|
### 5.4 Grouping 읽기 및 저장
|
||||||
|
|
||||||
|
`GET /{requestId}/grouping`의 `data`는 아래 타입이다. `groups`와 `templates`는 저장된 현재 분석/검토 결과이며, generation 이후에는 동결된 동일 값을 반환한다. 그룹 검토 전후 모두 source text를 재구성할 수 있어야 한다.
|
||||||
|
|
||||||
|
| 타입 | 필수 필드 |
|
||||||
|
|---|---|
|
||||||
|
| `GroupingResponse` | `requestId: Long`, `revision: Long`, `reviewed: Boolean`, `indexUnit: "UNICODE_CODE_POINT"`, `groups: List<TitleGroup>`, `individualContentIds: List<Long>`, `templates: List<TitleTemplate>` |
|
||||||
|
| `TitleGroup` | `groupId: String`, `sourceLanguage: LanguageCode`, `memberContentIds: List<Long>`, `sharedParts: List<SharedPart>` |
|
||||||
|
| `SharedPart` | `partId: String`, `sourceText: String`, `occurrences: List<{contentId: Long, startCodePoint: Int, endCodePoint: Int}>` |
|
||||||
|
| `TitleTemplate` | `contentId: Long`, `groupId: String`, `sourceFingerprint: String`, `segments: List<TitleSegment>` |
|
||||||
|
| `TitleSegment` | `segmentId: String`, `kind: LITERAL/SHARED/RESIDUAL`, `startCodePoint: Int`, `endCodePoint: Int`, `sourceText: String`, `partId: String?`, `valueIndex: Int?` |
|
||||||
|
|
||||||
|
`segments`는 원문 순서다. SHARED의 `partId`와 `valueIndex`는 해당 그룹 `sharedParts` 배열 항목을 가리킨다. RESIDUAL의 `partId`는 null이고 `valueIndex`는 해당 콘텐츠 residual 입력 배열의 0-based 순번이다. LITERAL은 두 값이 null이며 `sourceText`를 그대로 출력한다. Grouped member의 residual 입력 순서는 segments에서 RESIDUAL만 추린 순서와 같다. 하나의 provider 후보 `translatedValues[i]`는 해당 입력 배열의 i번째 구간과 대응한다. 이 계약으로 frontend와 apply 서비스가 동일한 전체 제목 preview를 재구성한다.
|
||||||
|
|
||||||
|
`PUT /{requestId}/grouping` body:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"expectedRevision": 1,
|
||||||
|
"groups": [{
|
||||||
|
"groupId": "g-1",
|
||||||
|
"memberContentIds": [4102, 4103],
|
||||||
|
"sharedParts": [{
|
||||||
|
"partId": "p-1",
|
||||||
|
"occurrences": [
|
||||||
|
{ "contentId": 4102, "startCodePoint": 0, "endCodePoint": 5 },
|
||||||
|
{ "contentId": 4103, "startCodePoint": 0, "endCodePoint": 5 }
|
||||||
|
]
|
||||||
|
}]
|
||||||
|
}],
|
||||||
|
"individualContentIds": [4104]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
이 JSON은 제안 DTO 형태를 보여주는 예시일 뿐 특정 데이터의 결정된 값이 아니다. body는 요청 전체 scope를 빠짐/중복 없이 그룹 또는 individual에 한 번씩 배정해야 한다. 각 group은 2개 이상 멤버로 구성되고 하나의 source language만 포함한다. 각 part는 모든 group member에 같은 nonempty 원문 substring이 존재해야 한다. 서버는 offset 범위 원문으로 공통 텍스트를 유도한다. 원문 문자열 대체 입력은 받지 않는다.
|
||||||
|
|
||||||
|
Index는 Unicode code point 기준 0부터 시작하는 inclusive start, exclusive end다. UTF-16 code unit 인덱스가 아니며 Java grapheme boundary를 자르는 범위는 거부한다. Group ID와 part ID는 요청 안에서 중복될 수 없다. 제출 성공 시 grouping을 저장하고 `revision`을 증가시킨다. 첫 확정은 `REVIEW_REQUIRED`에서 `READY_TO_GENERATE`로 전이한다. 생성 전에는 `READY_TO_GENERATE`에서도 같은 endpoint로 재수정할 수 있고 상태는 유지한다. 모든 individual도 관리자가 검토·확정해야 한다. `GENERATING` 전이 이후에는 grouping을 바꿀 수 없다.
|
||||||
|
|
||||||
|
Group read model의 segment 타입은 `LITERAL`, `SHARED`, `RESIDUAL`이다. 원문을 순서대로 이어 붙였을 때 원문 제목과 code point 단위로 완전히 일치해야 한다. literal은 번역 대상이 아닌 공백/구두점/숫자 구간을 그대로 보존한다. 단순한 프론트엔드 수정 또는 잘못된 offset은 `INVALID_GROUPING`이다.
|
||||||
|
|
||||||
|
공통 구간 사이의 gap에 문자가 있으면 바깥 공백·구두점만 LITERAL로 분리하고 내부 공백·구두점·숫자를 포함한 구문 전체를 하나의 RESIDUAL로 보낸다. 예를 들어 `비 오는 날`은 세 단어가 아닌 하나의 입력이다. 문자가 전혀 없는 gap은 전체를 LITERAL로 보존한다.
|
||||||
|
|
||||||
|
## 6. 후보 생성과 조회
|
||||||
|
|
||||||
|
### 6.1 후보 생성
|
||||||
|
|
||||||
|
`POST /{requestId}/generate` body:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "expectedRevision": 2 }
|
||||||
|
```
|
||||||
|
|
||||||
|
응답은 request 요약이다. Request는 모든 콘텐츠의 `title`, `detail`, `tags` 및 해당 source language 외 현재 지원 언어(`ko`, `en`, `ja`) 전체를 대상으로 삼는다. 생성 시 field/language 선택을 받지 않는다. 등록된 모든 `TranslationProvider`가 각 nonempty generation unit을 독립적으로 새로 호출한다. 대상 언어는 provider configuration이나 기존 번역 메모리에서 추정하지 않는다.
|
||||||
|
|
||||||
|
request 잠금 안에서 먼저 저장된 accepted generation revision과 요청 revision의 일치 여부를 확인한다. 이미 수락된 동일 요청이면 현재 state/revision이 달라졌어도 기존 결과를 반환하며 후보를 다시 만들지 않는다. 최초 generate에만 `READY_TO_GENERATE`, 현재 revision, 검토 상태를 검사하고 generation manifest와 candidate 작업을 원자 생성해 `GENERATING`으로 전이한다. 이후 grouping 수정은 허용하지 않는다.
|
||||||
|
|
||||||
|
### 6.2 Candidate 페이지
|
||||||
|
|
||||||
|
`GET /{requestId}/candidates?afterCandidateId={id}&size=50` (`size` 기본 50, 최대 100)
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"items": [{
|
||||||
|
"candidateId": 811,
|
||||||
|
"unit": { "kind": "FIELD", "contentId": 4102, "field": "detail" },
|
||||||
|
"provider": { "id": "aws", "version": "translate-2017-07-01" },
|
||||||
|
"targetLanguage": "ko",
|
||||||
|
"status": "SUCCEEDED",
|
||||||
|
"translatedValues": ["달빛 아래에서 나눈 약속입니다."],
|
||||||
|
"failureCode": null
|
||||||
|
}],
|
||||||
|
"nextAfterCandidateId": 811
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
실패 candidate에는 `translatedValues: null`, 안정화된 `failureCode`를 제공한다. 실패 원문/외부 response/secret은 숨긴다. 동등한 translated values의 다중 provider 결과는 별도 후보 출처들을 유지한 채 응답에서 동등 그룹으로 묶어 보여줄 수 있다. 동일 후보 비교는 정확한 반환 문자열 기준이며, 원본 provenance는 UNKNOWN 허용이다.
|
||||||
|
|
||||||
|
Unit 합 타입:
|
||||||
|
|
||||||
|
| `kind` | 필드 | 의미 |
|
||||||
|
|---|---|---|
|
||||||
|
| `FIELD` | `contentId`, `field` | 단일 title/detail/tags 전체 문자열 후보 |
|
||||||
|
| `GROUP_COMMON` | `groupId` | 그룹 내 모든 shared title part의 순서 보존 배열 |
|
||||||
|
| `TITLE_RESIDUAL` | `groupId`, `contentId` | 해당 member의 residual segment 번역 배열 |
|
||||||
|
|
||||||
|
각 candidate는 `inputValues: List<String>`도 반환한다. FIELD 입력/결과는 길이 1이며 `translatedValues[0]`가 최종 해당 필드 값이다. GROUP_COMMON은 grouping.sharedParts 순서, TITLE_RESIDUAL은 해당 template의 residual 순서다. 제공자 응답의 개수가 입력과 다르거나 nonempty 입력의 결과가 공백이면 `FAILED/INVALID_PROVIDER_RESULT`이며 선택할 수 없다. 제공자 ID/version이 동결 manifest와 달라졌거나 사라지면 `FAILED/PROVIDER_CHANGED`로 기록하고 다른 provider/version으로 대체하지 않는다. 마지막 페이지의 `nextAfterCandidateId`는 null이다.
|
||||||
|
|
||||||
|
빈 원문과 전부 literal residual은 paid call candidate가 없다. 빈 FIELD는 contents의 `emptyFields: List<FieldKey>`로 표시하고 새 승인 대상에서 제외한다. literal-only residual은 template로 조립하고 선택 candidateId는 null이다. 후보 저장은 global translation memory를 읽거나 갱신하는 행위가 아니다. 상세 문서는 준비 실패의 `PREPARATION_INTERRUPTED`, provider 작업 실패의 `PROVIDER_FAILED`, `PROVIDER_CHANGED`, `INVALID_PROVIDER_RESULT`, `EXECUTION_INTERRUPTED`를 안정 failureCode로 사용한다.
|
||||||
|
|
||||||
|
## 7. Apply와 cancel 계약
|
||||||
|
|
||||||
|
### 7.1 부분 apply
|
||||||
|
|
||||||
|
`POST /{requestId}/apply` body:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"operationId": "3b3887e6-60c5-42d7-a310-cf0cbd6d0a84",
|
||||||
|
"expectedRevision": 3,
|
||||||
|
"selections": [
|
||||||
|
{ "kind": "FIELD", "contentId": 4102, "field": "detail", "targetLanguage": "ko", "candidateId": 811 },
|
||||||
|
{
|
||||||
|
"kind": "TITLE_GROUP",
|
||||||
|
"groupId": "g-1",
|
||||||
|
"targetLanguage": "ko",
|
||||||
|
"commonCandidateId": 901,
|
||||||
|
"residualChoices": [
|
||||||
|
{ "contentId": 4102, "candidateId": 902 },
|
||||||
|
{ "contentId": 4103, "candidateId": null }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
예시는 합 타입 DTO 구성을 보여준다. `selections`는 비어 있으면 안 된다. client가 translated text를 보내는 자유 형식 override는 지원하지 않는다. Server는 모든 ID가 같은 request의 성공 candidate이며 unit/provider/target과 맞는지 확인한다.
|
||||||
|
|
||||||
|
`FIELD`는 콘텐츠·필드·언어마다 하나만 선택 가능하다. `TITLE_GROUP`는 그룹+언어 선택 하나를 뜻하며 `commonCandidateId`와 모든 member residual choice를 완전하게 제공한다. residual이 전부 literal이면 그 member의 `candidateId`는 null이어야 한다. 공통 번역은 선택된 한 provider candidate가 모든 group member에 적용되고, member별 residual은 서로 다른 provider가 선택될 수 있다. 단 하나의 그룹 안에서 member를 omit하거나 공통 provider를 나눌 수 없다. 일부 구성원을 따로 적용하려면 생성 전 grouping을 수정한다.
|
||||||
|
|
||||||
|
Apply 처리 규칙:
|
||||||
|
|
||||||
|
1. request 행을 잠그고 저장된 operationId/body hash를 먼저 검사한다. 동일 요청의 replay면 기존 receipt를 반환한다. 새 apply에만 READY 상태와 현재 revision 검증을 적용한다.
|
||||||
|
2. 필요한 Series 부모, CONTENT 부모를 ID 오름차순으로 잠근다. 시리즈 그룹 적용은 활성 membership을 안정적으로 확인할 수 있도록 현재 연결 CONTENT 부모도 잠그며, 구성원 추가/제거는 동일 Series 잠금으로 직렬화한다.
|
||||||
|
3. 잠금 이후 최신 source·활성 membership·override·payload를 다시 읽고 최종 검증한다. 잠금 전 JPA entity나 로딩된 연관 컬렉션을 그대로 신뢰하지 않는다. FIELD는 선택 필드 fingerprint와 content 존재 여부를 검사하며, SERIES scope일 때 현재 연결·활성 자격도 요구한다. 제목 그룹은 모든 member title fingerprint/language와 고정된 활성 membership 전체를 검사한다. 선택되지 않은 다른 필드 변경은 거부 조건이 아니다.
|
||||||
|
4. 모든 선택 값을 하나의 DB transaction으로 저장한다. 실패가 하나라도 있으면 어떤 값도 적용하지 않고 request는 `READY` 상태에 남는다.
|
||||||
|
5. 적용 값만 field-scoped override와 기존 CONTENT rendered payload에 쓴다. 미선택 payload 값은 byte-for-byte 보존한다. Locale row가 없으면 미선택 필드는 현재 source fallback으로 초기화한다.
|
||||||
|
6. Request를 `APPLIED`로 닫고 선택되지 않은 candidate를 `DISCARDED`로 표시한다. 적용 결과 receipt를 저장한다.
|
||||||
|
|
||||||
|
같은 `operationId`와 canonical request body hash는 저장된 receipt를 반환한다. 동일 operation ID를 다른 body에 재사용하면 `IDEMPOTENCY_CONFLICT`. 요청이 APPLIED인데 다른 operation ID로 호출하면 `REQUEST_CLOSED`다. Operation ID는 관리자+request 범위에서 유일하다.
|
||||||
|
|
||||||
|
Response `ApplyTranslationSelectionResponse`의 필수 필드는 `requestId: Long`, `operationId: UUID`, `status: "APPLIED"`, `appliedAt: Timestamp`, `appliedFields: List<AppliedField>`, `discardedCandidateCount: Int`다. `AppliedField`는 `contentId: Long`, `field: FieldKey`, `targetLanguage: LanguageCode`, `translatedValue: String`, `candidateIds: List<Long>`, `providers: List<{id: String, version: String}>`다. Group title은 공통·residual 출처를 모두 남긴다. Receipt는 override/payload와 같은 transaction에서 저장하며 재전송에도 불변이다.
|
||||||
|
|
||||||
|
### 7.2 취소
|
||||||
|
|
||||||
|
`POST /{requestId}/cancel` body 없음. `PREPARING`, `REVIEW_REQUIRED`, `READY_TO_GENERATE`, `GENERATING`, `READY`를 취소할 수 있다. APPLIED에서는 `REQUEST_CLOSED`로 거부한다. Cancel은 새 revision이 없는 stale browser에서도 동작해야 한다.
|
||||||
|
|
||||||
|
취소의 선형화 지점은 request 행 gate에서 CANCELLED를 commit하는 시점이다. 이후 새 provider chunk dispatch 승인을 금지한다. 취소보다 먼저 승인을 받은 호출은 이미 진행 중인 작업으로 취급하며, 실제 네트워크 전송이 취소 commit 뒤에 일어나더라도 비용이 발생할 수 있다. 취소 응답은 외부 호출 종료를 기다리지 않고 DB 취소 확정 후 반환한다. 늦은 응답은 candidate로 publish하거나 적용할 수 없다. Network I/O 동안 DB transaction을 유지하지 않는다.
|
||||||
|
|
||||||
|
Phase4 transport 기술 확인: 설치된 AWS SDK 2.57.11에서 요청별 execution attribute와 `beforeTransmission`으로 SDK retry마다 같은 gate를 적용한다. AWS는 요청별 남은 15초 API-call/attempt timeout을 사용한다. Apache5의 요청별 connect/read 및 공개 요청별 retryStrategy 설정은 지원되지 않으므로 기존 공유 socket/retry 설정을 유지한다. Papago admin 경로만 기존 RestTemplate 방식으로 connect 3초/read 15초를 제한한다. 15초 dispatch budget과 read timeout을 절대적인 전체 wall-clock 중단 정밀도로 해석하지 않는다. 일반 요청에는 admin control을 적용하지 않는다.
|
||||||
|
|
||||||
|
## 8. 프론트엔드 상호작용 명세
|
||||||
|
|
||||||
|
이 절은 UI 동작 계약만 정의하며 route/page/component/style을 구현하거나 시각 디자인을 지정하지 않는다.
|
||||||
|
|
||||||
|
1. 관리자는 콘텐츠 또는 시리즈 ID로 요청을 만든다. `PREPARING`/`GENERATING` 상태는 1초 간격 polling으로 조회한다.
|
||||||
|
2. 시리즈는 grouping 분석 화면으로 전이하고 관리자가 모든 콘텐츠를 그룹 또는 개별 상태로 분류해 확정하기 전 generate action을 보내지 않는다. 원문 구간은 code point 인덱스로 변환하고 후보 생성 뒤에는 grouping 편집 대신 cancel 후 재요청을 제공한다.
|
||||||
|
3. 최초 활성 콘텐츠 snapshot의 title/detail/tags, 언어, 현재 값과 활성 자격, fingerprint 기반 변경 가능성을 request/content pages에서 검토한다. source 언어를 target language로 제시하지 않는다.
|
||||||
|
4. 생성 완료 후 field candidate를 필드·언어별로 비교한다. 제공자 이름·버전·실패 상태를 확인 가능하게 하고 같은 text 후보를 출처 손실 없이 접어 보여줄 수 있다. 기존 translation origin `UNKNOWN`을 실제 provider처럼 표기하지 않는다.
|
||||||
|
5. grouped title은 group+language로 공통 선택 하나와 member별 residual 선택을 만든다. 불완전 group은 apply할 수 없으며, 그룹 구성원의 결과를 분리하려면 새 request 전에 group을 나눈다.
|
||||||
|
6. 사용자가 apply할 선택 subset을 review한 후 operation UUID를 생성해 한번 전송한다. 성공 receipt 이후 같은 request에서 새 선택을 추가할 수 없다. server의 SOURCE_CHANGED/MEMBERSHIP_CHANGED 오류면 이전 후보 재적용 대신 새 request를 시작한다.
|
||||||
|
7. 검토 전·진행 중·READY 상태에서 cancel할 수 있음을 표시한다. 이미 전송된 외부 호출의 비용은 취소로 되돌릴 수 없다는 점과 적용 미확정 값을 유지하는 동작을 설명한다.
|
||||||
|
|
||||||
|
Candidate 문자열은 HTML로 해석하지 않고 text로 표시한다. 화면 시각 규칙, 로딩 애니메이션, responsive layout은 본 계약의 범위가 아니다.
|
||||||
|
|
||||||
|
## 9. 내부 데이터 및 변경 불변식
|
||||||
|
|
||||||
|
세 테이블과 저장 불변식, worker·writer·rollout 설계는 [plan-task.md §설계 제안](plan-task.md#설계-제안)에 정의한다. Entity/store/controller와 로컬 H2 검증은 구현했으며 운영 schema 적용과 rollout은 별도 승인 대상이다.
|
||||||
|
|
||||||
|
필수 동작 불변식:
|
||||||
|
|
||||||
|
- `ContentTranslation.renderedPayload`의 기존 schema, API response는 변경하지 않는다.
|
||||||
|
- 새 candidate는 `TranslationCoordinator`의 first-success fallback, translation memory 조회/갱신을 사용하지 않는다. 모든 등록 provider를 직접 독립 호출한다.
|
||||||
|
- 기존 translated payload는 명시 적용 때까지 유지한다. 관리 승인 값의 provenance는 override row에 보관하며 과거 provider는 UNKNOWN이다.
|
||||||
|
- 기존 CONTENT materializer는 Content lock 안에서 최신 원본과 override를 재조회한다. 일치하는 approval은 자동 결과보다 우선한다. 다른 리소스 materialization에는 변경을 적용하지 않는다.
|
||||||
|
- 원본 mutation은 변경된 field의 override만 제거하고 해당 locale field를 source fallback으로 바꾸며 정상 자동 번역을 schedule한다. Source language 변경은 모든 field를 변경된 것으로 취급한다. 원본이 A→B→A로 되돌아와도 삭제한 이전 approval은 살아나지 않는다.
|
||||||
|
- 제목 그룹 apply는 선택 그룹 전체 fingerprint와 고정 membership을 검증한다. 개별 field apply는 선택한 field fingerprint만 검증한다.
|
||||||
|
- 취소 gate, lease/fence, candidate publish 검사로 취소 후 새로운 outbound dispatch 승인이나 late publication/apply를 막는다. 취소 전 승인된 provider 요청에 exactly-once 과금을 보장하지 않는다.
|
||||||
|
|
||||||
|
## 10. 계약 상태, 추적 및 검증
|
||||||
|
|
||||||
|
| 구분 | 상태 |
|
||||||
|
|---|---|
|
||||||
|
| PRD 인터뷰 product decisions | 확정 |
|
||||||
|
| 이 API endpoint/DTO/error contract | 승인, P1-P5 로컬 구현·집중 검증 완료 |
|
||||||
|
| persistence 및 server architecture | 로컬 구현 완료, 운영 MySQL 검증 대기 |
|
||||||
|
| Frontend implementation | 미착수, 범위 밖 |
|
||||||
|
| Backend implementation | P1~P5 및 최종 gate 보정 완료, APPROVE |
|
||||||
|
|
||||||
|
| PRD requirement | 계약 범위 |
|
||||||
|
|---|---|
|
||||||
|
| TR-01~TR-02 | Scope 및 contents snapshot |
|
||||||
|
| TR-03~TR-06, TR-14~TR-15 | Grouping review, generation gate 및 group atomic apply |
|
||||||
|
| TR-07~TR-13 | Provider manifest, candidate 생성·조회, provenance와 언어 |
|
||||||
|
| TR-16~TR-17 | One-shot apply, omitted discard 및 cancel |
|
||||||
|
| TR-18~TR-20 | Content override, field invalidation, selected-field freshness |
|
||||||
|
|
||||||
|
실행한 focused test·RED/GREEN·회귀 보정과 명령은 `plan-task.md`의 Progress에 기록했다. 부모가 보정된 최종 코드의 실제 HTTP 27개와 bootJar를 실행해 통과했으며 최종 gate는 APPROVE다. 전체 테스트 `./gradlew test`는 사용자가 실행한다. 실제 MySQL·provider 품질·운영 적용은 별도 검증이다.
|
||||||
|
|
||||||
|
### 승인 및 실행 기록 — 2026-11-17
|
||||||
|
|
||||||
|
사용자가 설계 승인에 이어 구현 시작을 명시적으로 승인했다. 승인 당시 endpoint와 schema 구현은 없었다. 이후 P1-P5 로컬 구현·집중 검증을 완료했으며 현재 증거와 미완료 운영 검증은 [plan-task.md](plan-task.md)의 Progress 실행 ledger에서 관리한다. Production DDL/deploy/git commit은 승인·실행 범위에 포함되지 않는다.
|
||||||
@@ -0,0 +1,266 @@
|
|||||||
|
# 관리자 번역 후보 선택 프론트엔드 구현 지시
|
||||||
|
|
||||||
|
별도 프론트엔드 저장소에서 이 기능을 실제로 구현하라. 이 파일, 사용자가 별도로 제공하는 API 계약 파일, 그리고 네가 작업하는 프론트엔드 저장소만 근거로 삼는다. 제공된 API 계약 외의 백엔드 저장소 PRD·계획·검증 기록·소스, 다른 컴퓨터의 절대 경로, 이전 대화나 숨은 세션 지식에 의존하지 않는다. 아래 지시로 프론트엔드 저장소 안에 새로 만드는 문서는 이후 작업의 기준으로 사용한다. API 계약이 없으면 파일 위치만 물어보고 네트워크 계약을 추측하지 않는다. 계약과 아래 제품 요구가 충돌하면 충돌한 항목만 구체적으로 기록하고 해당 작업을 멈춘 뒤 질문한다.
|
||||||
|
|
||||||
|
## 1. 목표와 경계
|
||||||
|
|
||||||
|
- 관리자 콘텐츠 상세와 시리즈 상세에 각각 진입 버튼을 두고, 하나의 공유 요청 생성·검토·후보 선택 workflow를 구현한다.
|
||||||
|
- 기존 프론트엔드의 접근성, 라우팅, API client, 캐시, 상태 관리, 디자인 구성요소, 테스트 관례를 재사용한다. 새 의존성 및 무관한 리팩터링은 피한다.
|
||||||
|
- 일반 관리자 화면에서 동작하는 완성 기능을 만든다. 스텁, 빈 동작, 가짜 성공, 운영용 mock fallback은 허용하지 않는다.
|
||||||
|
- 서버 API는 ADMIN 전용이며 별도 feature flag 없이 배포된 애플리케이션 기동 시 등록된다. 프론트엔드에 서버 기능 활성화 토글이나 설정 단계를 만들지 않는다. 버튼 표시만으로 해당 환경의 배포·연결 준비를 완료했다고 판단하지 않는다.
|
||||||
|
- 사용자가 제공하는 API 계약이 endpoint, DTO, envelope, 오류 및 타입의 기준이다. 아래 요약은 사용 흐름과 제품 요구를 자립적으로 전달한다.
|
||||||
|
- 서버의 9개 endpoint는 구현됐고 기존 backend 최종 검토에서 승인됐다. 이후 사용자 요청으로 활성화 플래그를 제거했다. 이 기록을 이 저장소의 구현이나 검증 결과로 주장하지 않는다.
|
||||||
|
- 운영 DDL 반영과 배포는 완료되지 않았다. 새 writer의 작업 생성 전 세 신규 테이블, 원문 언어 포함 queue unique index, 구 writer·in-flight 작업 종료 및 구 unique index 제거가 필요하다. 자동 DDL이나 별도 활성화 단계는 없다. 이 운영 전제는 백엔드 운영자가 처리하며 프론트엔드에서 실행하지 않는다. 실제 UI와 프론트엔드 구현도 아직 없다.
|
||||||
|
|
||||||
|
## 2. 구현 전 필수 문서와 조사
|
||||||
|
|
||||||
|
### 2.1 저장소 파악
|
||||||
|
|
||||||
|
코드를 수정하기 전에 프론트엔드 저장소의 AGENTS.md, README, package/build 설정, 테스트 및 개발 명령을 읽는다. 실제 버튼이 놓일 콘텐츠 상세·시리즈 상세, 기존 API client/envelope/auth, 관리자 role 처리, base URL 환경변수, query/cache 패턴, 번역 언어 및 Unicode 유틸리티, 디자인 구성요소, 테스트 명령을 찾는다. 파일 경로와 명령은 실제 확인한 값만 쓴다.
|
||||||
|
|
||||||
|
기존 diff를 먼저 확인해 사용자·다른 작업의 변경과 이번 변경을 구분한다. 자신이 만들지 않은 변경을 덮어쓰거나 되돌리지 않는다.
|
||||||
|
|
||||||
|
사용자가 제공한 API 계약 파일을 찾아 읽는다. 파일명이 정해져 있다고 가정하지 않는다. 없다면 구현 전 파일 위치를 요청한다. endpoint나 DTO를 상상해 진행하지 않는다.
|
||||||
|
|
||||||
|
### 2.2 코드 작성 전 문서 다섯 개
|
||||||
|
|
||||||
|
실제 프론트엔드 저장소의 기존 문서 규칙을 우선 확인한다. 아래 산출물을 그 규칙을 따르는 한 곳에 만들거나 기존 것을 재사용한다. 기존 규칙이 다른 경로를 요구하면 실제 경로를 사용하고 다섯 문서의 canonical mapping을 한 번 기록한다. 중복 계획을 만들지 않는다.
|
||||||
|
|
||||||
|
1. `docs/20261118_관리자번역언어선택/api-contract.md`
|
||||||
|
- 제공된 계약을 의미 변경 없이 그대로 복사한다. 이미 존재하면 내용과 provenance를 확인해 재사용한다.
|
||||||
|
- 사용자 파일을 덮어쓰지 않는다. 원본 경로와 provenance는 `progress.md`에 기록하고 계약 문서 본문에는 추가하지 않는다.
|
||||||
|
2. `docs/20261118_관리자번역언어선택/prd.md`
|
||||||
|
- 이 프롬프트의 제품 요구에서 생성한다. 외부 PRD가 필요하다고 가정하지 않는다.
|
||||||
|
3. `docs/20261118_관리자번역언어선택/plan-task.md`
|
||||||
|
- 실제 발견한 프론트엔드 파일 경로, 라우트, 명령을 포함하는 작은 단계와 의존성, acceptance criteria, 증거를 쓴다.
|
||||||
|
- 체크박스와 고유 Goal ID를 사용하고 활성 Goal은 하나만 둔다. 각 작업에 정확한 경로, focused 검증과 기대 결과를 적는다.
|
||||||
|
- 알 수 없는 값은 placeholder로 채우거나 이미 확인한 것처럼 쓰지 않는다.
|
||||||
|
4. `docs/20261118_관리자번역언어선택/verification.md`
|
||||||
|
- 코드 작성 전에 검증 행렬을 만든다. 각 행은 `NOT_RUN`, `BLOCKED`, `PASS`, `FAIL` 중 하나로 표시하며 기대 assertion, 환경, 명령/증거 경로를 적는다.
|
||||||
|
- 기존 API client와 envelope, 인증, 관리자 역할, base URL 환경변수, schema availability, connectivity, Unicode 범위 도구, query/cache, 디자인 요소, 테스트 명령을 사전 조사한다.
|
||||||
|
- 사전 connectivity 확인은 안전한 read-only 요청만 사용한다. 유료 provider 요청, 생성·적용·취소 같은 mutation, 배포나 운영 변경을 사전 점검으로 실행하지 않는다. 알려진 테스트 requestId가 없으면 임의 ID나 존재하지 않는 목록 endpoint로 API 준비 완료를 판단하지 않는다.
|
||||||
|
- 실제 API 연동 준비가 확인되지 않으면 해당 항목은 `BLOCKED`로 둔다. UI와 단위 테스트 작업은 계속한다.
|
||||||
|
- fixture/mock 테스트와 실제 서버 검증을 별도 행으로 구분한다.
|
||||||
|
5. `docs/20261118_관리자번역언어선택/progress.md`
|
||||||
|
- 승인 범위, 확정 결정, 현재 및 다음 Goal, 완료 Goal, 변경 파일, 가정·결정·차단 요소, 스크린샷 경로를 기록한다.
|
||||||
|
- 실행한 정확한 명령과 결과, 실제 API 대 fixture 구분을 누적한다. 마지막 requestId는 테스트용만 허용하며 secret은 절대 기록하지 않는다.
|
||||||
|
|
||||||
|
다섯 문서가 작성되고 최초 계획 및 검증 기준이 기록될 때까지 production code를 수정하지 않는다. 이후 각 milestone마다 계획 체크박스, progress, verification을 갱신한다. 이미 완료한 목표와 근거는 삭제하거나 과거 PASS를 현재 코드의 증거로 재사용하지 않는다.
|
||||||
|
|
||||||
|
장기 작업 재개 시 다섯 문서를 모두 읽고 현재 diff와 테스트 산출물을 확인한다. 실제 evidence에 맞는 첫 미완료 Goal부터 이어가며, 이미 확인된 인터뷰나 완료 작업을 반복하지 않는다. 기존 계획과 사용자 지시가 다르면 사용자 지시가 우선이다. 충돌 우선순위는 사용자 지시, API HTTP 계약, 제품 요구, 실행 계획 순서다. 충돌한 작업만 멈춰 기록한다.
|
||||||
|
|
||||||
|
## 3. API 사용 요약
|
||||||
|
|
||||||
|
Base path는 `/admin/audio-content/translation-requests`다. Endpoint·필드명·타입은 제공된 API 계약을 기준으로 한다. 아래 제품 동작과 실질적인 충돌이 있으면 요구사항을 임의로 바꾸지 말고 해당 항목을 기록해 확인한다.
|
||||||
|
|
||||||
|
| Method | Path | 역할 |
|
||||||
|
|---|---|---|
|
||||||
|
| POST | `/` | CONTENT 또는 SERIES 요청 생성 |
|
||||||
|
| GET | `/{requestId}` | 상태, revision, progress, receipt 조회 |
|
||||||
|
| GET | `/{requestId}/contents` | snapshot 및 현재 데이터 cursor 조회 |
|
||||||
|
| GET | `/{requestId}/grouping` | 제목 그룹과 template 조회 |
|
||||||
|
| PUT | `/{requestId}/grouping` | 전체 grouping 검토·교체 |
|
||||||
|
| POST | `/{requestId}/generate` | 동결 manifest의 후보 생성 시작 |
|
||||||
|
| GET | `/{requestId}/candidates` | 후보 cursor 조회 |
|
||||||
|
| POST | `/{requestId}/apply` | 선택 subset을 한 번 적용 |
|
||||||
|
| POST | `/{requestId}/cancel` | 미적용 요청 취소, body 없음 |
|
||||||
|
|
||||||
|
- 모든 호출은 ADMIN 권한을 요구한다. 기존 auth를 쓰고 role이 없으면 버튼을 숨기며 직접 진입도 차단한다. 서버 설정을 변경하지 않는다.
|
||||||
|
- 성공 및 business failure는 `success`, `message`, `data`, `errorProperty` envelope를 사용한다. HTTP 200만으로 성공 처리하지 말고 `success`도 확인한다.
|
||||||
|
- ID는 API의 signed 64-bit numeric Long과 저장소 관례를 따른다. 정밀도를 잃는 JS number 처리를 피하되, 계약/기존 repo가 정한 안전한 직렬화 방식을 사용한다. 임의 string 변환 계약을 만들지 않는다.
|
||||||
|
- 생성 body는 `clientRequestId: UUID`와 scope 합 타입 `{type: CONTENT, contentId}` 또는 `{type: SERIES, seriesId}`다.
|
||||||
|
- grouping PUT은 `expectedRevision`, 전체 `groups`(groupId, memberContentIds, sharedParts의 partId 및 contentId/startCodePoint/endCodePoint occurrences), 전체 `individualContentIds`를 보낸다.
|
||||||
|
- generate body는 `{expectedRevision}`이다. 최초 요청 body와 revision을 보존한다.
|
||||||
|
- apply body는 `operationId: UUID`, `expectedRevision`, selections 배열이다. FIELD 선택은 `kind: "FIELD"`, contentId, `field: "title" | "detail" | "tags"`, targetLanguage, candidateId를 가진다. 그룹 선택은 `kind: "TITLE_GROUP"`, groupId, targetLanguage, commonCandidateId와 모든 member의 `{contentId, candidateId: 후보 ID 또는 null}` residualChoices를 가진다. 이 표기는 타입 요약이며 실제 JSON은 계약에 맞춰 생성한다.
|
||||||
|
- 콘텐츠 페이지는 `afterContentId`, 후보 페이지는 `afterCandidateId`, 기본 size 50, 최대 100을 사용한다. `nextAfter...`가 null일 때만 끝이다. 한 페이지를 전체로 간주하지 않는다.
|
||||||
|
- 후보 ID는 고정이고 같은 ID의 상태·결과가 갱신된다. READY 진입 때 이미 읽은 페이지를 다시 받아 ID 기준으로 갱신한다. revision, cursor, 요청 ID를 임의로 섞지 않는다.
|
||||||
|
|
||||||
|
## 4. 제품 동작과 상태 흐름
|
||||||
|
|
||||||
|
요청 scope는 콘텐츠 하나 또는 생성 시점의 활성 시리즈 구성원 전체다. 비활성 구성원은 제외한다. 필드는 제목, 상세, 태그다. 대상 언어는 `ko`, `en`, `ja`에서 각 콘텐츠의 source language를 제외한다. 요청 본문에서 필드·언어를 골라 서버 작업을 줄이지 않는다.
|
||||||
|
|
||||||
|
source language가 이미 있으면 사용하며 프론트에서 재감지·전환하지 않는다. 준비 중에는 기존 번역이 보존된다. 모든 nonblank 필드, 모든 대상 언어, 서버 manifest의 모든 provider에 대해 fresh generation을 수행한다. provider 목록은 동적 manifest를 사용한다. 현재 backend context에 알려진 AWS와 Papago를 하드코딩하거나 둘만 가정하지 않는다. API key를 프론트에 두지 않고 cache flush나 startup blocking을 추가하지 않는다.
|
||||||
|
|
||||||
|
요청 상태 전이:
|
||||||
|
|
||||||
|
```text
|
||||||
|
PREPARING -> READY_TO_GENERATE
|
||||||
|
PREPARING -> REVIEW_REQUIRED (series)
|
||||||
|
PREPARING -> FAILED | CANCELLED
|
||||||
|
REVIEW_REQUIRED -> READY_TO_GENERATE | CANCELLED
|
||||||
|
READY_TO_GENERATE -> GENERATING | CANCELLED
|
||||||
|
GENERATING -> READY | CANCELLED
|
||||||
|
READY -> APPLIED | CANCELLED
|
||||||
|
APPLIED, FAILED, CANCELLED are terminal
|
||||||
|
```
|
||||||
|
|
||||||
|
- 요청 생성 시 intent마다 UUID를 한 번 만든다. 생성 POST의 결과가 불확실하고 requestId도 받지 못했다면 같은 UUID와 원래 body로 재시도한다. requestId가 있으면 기존 요청 상태를 조회할 수 있다. UUID 검색이나 생성 receipt 조회 API를 새로 가정하지 않으며 UUID를 자동 교체하지 않는다.
|
||||||
|
- `PREPARING`은 요약 조회를 polling한다. 한 요청당 중복 polling은 금지한다. 1초 간격으로 겹치지 않게 실행하고 unmount, request 변경, terminal 상태에서 멈춘다.
|
||||||
|
- 단건은 `READY_TO_GENERATE`가 되면 명시적인 generate 버튼을 제공한다. 시리즈는 분석 그룹을 조회하고 관리자가 전체 구성을 확인·확정해야 한다. 모두 개별 처리로 분류한 경우도 review PUT이 필수다.
|
||||||
|
- 시리즈 grouping은 서버 분석을 그대로 검토·수정한다. 전체 활성 scope를 빠짐없이 한 번씩 그룹 또는 individual에 배치한다. 그룹은 최소 2명, 단일 source language이며 모든 멤버가 정확히 같은 원문 substring을 가져야 한다.
|
||||||
|
- 관리자는 그룹, 공통 구간, span을 조정하고 멤버를 individual로 제외하거나 요청을 취소할 수 있다. 고정 EP 정규식, 자체 regroup 알고리즘, 서버 분석을 대체하는 프론트 분석을 만들지 않는다.
|
||||||
|
- span은 Unicode code point 기준 0-based start inclusive/end exclusive다. JavaScript UTF-16 offset과 동일하다고 가정하지 않는다. 브라우저 선택 offset은 기존 변환 유틸 또는 지원 target의 `Intl.Segmenter` 등으로 grapheme 경계를 확인하며, emoji ZWJ와 combining mark를 시험한다. 임의의 오프셋을 제출하지 않는다.
|
||||||
|
- 그룹 편집이 저장되면 최신 revision을 쓴다. `GENERATING` 진입 후 편집은 금지이며, 변경하려면 취소 후 새 요청을 만든다.
|
||||||
|
- generate 호출이 불확실하면 같은 원래 `expectedRevision`과 body를 재전송한다. accepted replay는 최신 revision으로 새 요청처럼 바꾸지 않는다. 현재 새 mutation만 최신 revision을 쓴다.
|
||||||
|
- `GENERATING`은 요약과 필요한 후보 페이지를 polling하며 progress를 표시한다. READY 진입 시 이미 읽은 후보 페이지를 갱신하고 나머지는 필요에 따라 cursor로 읽는다. 모든 후보를 매초 전부 내려받지 않는다. 선택할 그룹의 모든 구성원과 필수 후보를 확보하기 전에는 그 그룹 적용을 허용하지 않는다. polling 중 generate를 다시 보내거나 READY 상태를 자동 적용하지 않는다.
|
||||||
|
- READY는 모두 성공했다는 뜻이 아니다. 모든 후보 실패 또는 빈 결과여도 READY일 수 있다. `emptyFields`는 paid candidate가 없는 명시 상태로 표시한다.
|
||||||
|
- 생성 이후 grouping 변경은 안 된다. 재검토가 필요하면 cancel 후 새 요청을 시작한다.
|
||||||
|
|
||||||
|
## 5. 비교, 미리보기와 적용
|
||||||
|
|
||||||
|
- 콘텐츠 snapshot의 제목·상세·태그, source language, 기존 번역, 현재 활성/eligible 여부, source fingerprint 변경 가능성을 보여준다. snapshot 값과 조회 시점 current 값은 구별한다.
|
||||||
|
- 후보를 필드, 대상 언어, provider 단위로 비교한다. 원문, 현재 값, AWS/Papago 등 manifest에 포함된 provider 후보를 나란히 확인할 수 있게 한다.
|
||||||
|
- 기존 번역 출처는 실제 provenance가 없으면 `UNKNOWN`으로 표시한다. 기존 값을 provider에 귀속시키지 않는다.
|
||||||
|
- 동일 문자열 dedup은 같은 unit과 target language 안에서만 허용한다. 모든 provider ID/version provenance와 실제 selectable candidateId를 보존한다. 다른 unit/언어의 문자열은 합치지 않는다.
|
||||||
|
- 선택 가능한 것은 `SUCCEEDED` 후보뿐이다. pending, running, failed, discarded는 비활성화한다. 값이 같은 provider 결과를 묶어 보여도 선택되는 실제 candidate ID를 분명히 한다.
|
||||||
|
- `FIELD`는 콘텐츠·필드·언어마다 후보 하나를 고른다. grouped title을 FIELD로 우회해 apply하지 않는다.
|
||||||
|
- `GROUP_COMMON`은 group+language 단위 공통 후보 하나를 선택하고 모든 멤버 residual 선택을 완전하게 제공한다. 전부 literal인 멤버는 candidateId null을 사용한다. residual은 멤버마다 다른 provider를 선택할 수 있다.
|
||||||
|
- 그룹의 일부 멤버만 적용하는 선택은 불가하다. 일부만 분리하려면 generation 전 grouping에서 제외한다.
|
||||||
|
- candidate의 전체 `translatedValues` 배열을 타입에 맞춰 보존한다. 임의 boolean 조합 상태로 여러 unit 타입을 섞지 않는다.
|
||||||
|
- 그룹 제목 미리보기는 API `templates.segments`의 순서대로 이어 붙인다. LITERAL은 `sourceText`, SHARED는 선택 공통 후보의 `translatedValues[valueIndex]`, RESIDUAL은 해당 멤버 선택의 같은 인덱스를 쓴다.
|
||||||
|
- 미리보기에서 trim, 공백 삽입, 값 대체, 문자열 전체 replace를 하지 않는다. residual 구문 내부 공백을 유지한다. 모든 segments를 연결한 원문 재구성이 정확한지 확인한다.
|
||||||
|
- 후보 문자열은 HTML로 해석하지 않고 text로 출력한다. 긴 제목과 큰 body가 잘리지 않게 검토·비교할 수 있어야 한다.
|
||||||
|
- 자유 형식 번역 텍스트 편집은 만들지 않는다. 원문 그룹과 spans 편집은 제공한다.
|
||||||
|
- apply 전에 선택한 그룹의 전체 구성원과 미선택 필드·언어를 포함해 정확한 영향 범위를 확인시킨다. 그룹 내부의 일부 구성원만 미선택으로 두는 적용은 허용하지 않는다. 확인 화면에 다음 문구를 그대로 표시한다: `선택한 항목만 적용하고 이 요청을 종료합니다. 선택하지 않은 후보는 폐기되며, 해당 필드의 기존 번역은 유지됩니다.`
|
||||||
|
- apply는 one-shot이며 비어 있지 않은 selections만 보낸다. `operationId`는 사용자 확정 직전에 UUID로 만든다. 적용 결과가 불확실하면 requestId로 상태·applyReceipt를 조회하거나 원래 operationId·expectedRevision·선택 body 전체를 보존해 재전송한다. polling에서 새 revision을 받았다는 이유로 재시도 body를 바꾸지 않는다. 적용 결과가 불확실한 동안 선택 편집을 잠근다.
|
||||||
|
- 성공 후 receipt를 표시하고 request를 닫는다. 생략된 값은 기존 값을 유지한다. 서버가 부분 적용을 원자적으로 처리하며, 성공한 경우에만 해당 콘텐츠/시리즈 query cache를 무효화 또는 재조회한다. 낙관적으로 원본을 덮어쓰지 않는다.
|
||||||
|
- 적용 뒤 source 변경 시 해당 필드 보호 해제는 서버가 처리한다. 이를 프론트에서 미리 처리하지 않는다.
|
||||||
|
|
||||||
|
## 6. 취소, 오류와 복구
|
||||||
|
|
||||||
|
- 미적용 상태와 READY에서 취소를 제공한다. APPLIED와 FAILED는 취소하지 않는다.
|
||||||
|
- 취소는 요청 취소 확정이지 이미 전송된 provider 비용의 환불이나 외부 요청 중단을 뜻하지 않는다. UI 닫힘을 서버 취소 성공으로 간주하지 않는다.
|
||||||
|
- 화면 이탈 시 기존 앱의 unsaved draft 경고 방식을 재사용한다. requestId를 URL에 보존해 기존 요청을 재개할 수 있게 한다. history list API나 서버 draft API를 새로 만들지 않는다.
|
||||||
|
- 새로고침 뒤 local 미제출 선택은 사라질 수 있음을 알린다. 기존 저장소 draft 방식이 있다면 재사용한다.
|
||||||
|
- 안정 오류는 개별 문구/복구에 매핑한다.
|
||||||
|
- `REVISION_CONFLICT`: 최신 request/grouping을 다시 읽고 사용자 편집을 조용히 덮지 않는다.
|
||||||
|
- `INVALID_GROUPING`, `INCOMPLETE_TITLE_GROUP`: 입력을 유지하고 수정 가능하게 표시한다.
|
||||||
|
- `SOURCE_CHANGED`, `MEMBERSHIP_CHANGED`: 이전 후보를 재사용하지 말고 새 요청을 안내한다. 기존 요청은 nonterminal이면 필요 시 취소한다.
|
||||||
|
- `REQUEST_NOT_READY`, `REQUEST_CLOSED`: 상태를 다시 읽는다.
|
||||||
|
- `CANDIDATE_NOT_SELECTABLE`, `IDEMPOTENCY_CONFLICT`: 잘못된 후보를 자동 대체하지 않고 원인과 재조회 방법을 알린다.
|
||||||
|
- `EMPTY_SCOPE`, `LANGUAGE_DETECTION_FAILED`, `UNSUPPORTED_SOURCE_LANGUAGE`, `PREPARATION_INTERRUPTED`: 요청 준비 실패를 분명히 표시한다.
|
||||||
|
- HTTP 404는 원인을 확정할 수 없다. route 미배포, 네트워크·프록시 경로 또는 base URL·요청 경로를 확인하도록 “API를 사용할 수 없음, 배포·연결 경로 확인 필요”로 표시한다. 기능 OFF 상태나 활성화 설정을 원인으로 안내하지 않는다. fake success/fallback을 만들지 않는다.
|
||||||
|
- 실제 서버가 없는 경우 fixture/mock은 테스트나 명시적 개발 모드에만 격리한다. production fallback으로 쓰거나 live integration PASS라고 주장하지 않는다.
|
||||||
|
|
||||||
|
## 7. 검증 계획과 완료 기준
|
||||||
|
|
||||||
|
문서 `verification.md`를 코드 전에 만들고 아래 다섯 그룹의 예상 assertion을 실제 도구와 파일 경로에 연결한다. 구현 과정의 각 검증을 실행 즉시 기록한다. 기존 실패는 그대로 보고하며 테스트를 삭제·skip·약화하지 않는다. 기대값만 echo하는 mock 테스트는 근거가 아니다.
|
||||||
|
|
||||||
|
1. Lifecycle, idempotency, polling, cancel
|
||||||
|
- 두 scope 생성, 상태 전이, 겹치지 않는 polling과 terminal/unmount stop, 동일 UUID/body 재시도, generate replay, 취소 경계를 검증한다.
|
||||||
|
2. Grouping, coverage, Unicode, preview
|
||||||
|
- scope 완전 분류, 그룹 최소 멤버, source language 동일성, exact shared spans, emoji ZWJ/combining boundary, literal/shared/residual 연결과 내부 공백을 검증한다.
|
||||||
|
3. Field/group selection, partial apply, provenance
|
||||||
|
- selectable 상태, 모든 residual 선택, 그룹 원자성, 일부 필드 적용, 미선택 보존 문구, 같은 결과 dedup 후 provenance/candidate ID 보존, UNKNOWN 출처를 검증한다.
|
||||||
|
4. Errors, races, unknown outcome, HTTP envelope
|
||||||
|
- revision conflict 후 refresh, source/membership 변경, incomplete grouping, HTTP 200 business failure, 네트워크 불확실 retry, apply 잠금, 404 API unavailable 상태를 검증한다.
|
||||||
|
5. 기존 UI 회귀, 접근성, 화면 크기
|
||||||
|
- 상세/시리즈 기존 동작, role guard와 직접 라우트, keyboard/focus, text escaping, 긴 제목 및 큰 body, responsive layout을 검증한다.
|
||||||
|
|
||||||
|
실제 저장소에서 확인한 focused test, lint, typecheck, build 명령만 실행한다. 무필터 전체 테스트와 범위 밖 전체 빌드는 프로젝트 규칙이 허용하지 않으면 실행하지 않는다. 테스트 fixture 검증은 `fixture`로 표기한다. 실제 API E2E는 안전하고 승인된 비운영 테스트 환경과 식별 가능한 fixture가 있을 때만 수행한다. 운영 예시 ID를 넣거나 유료/운영 mutation을 하지 않는다. 환경이 없으면 순수 UI와 unit 작업은 진행하고 실제 연동을 `BLOCKED` 또는 미검증으로 남긴다.
|
||||||
|
|
||||||
|
UI가 변경되면 실제 구현 화면을 desktop과 mobile에서 열어 확인하고 스크린샷 경로를 기록한다. 빈 화면, 겹침, 잘림, 읽기 어려운 상태를 확인한다. 자동 테스트만으로 수동 화면 evidence를 대신하지 않는다.
|
||||||
|
|
||||||
|
완료는 동작 구현, 다섯 문서 갱신, 실제로 실행한 focused 검증 기록, 실제 화면 검토 및 남은 제한 보고를 모두 충족해야 한다. API 미연동을 성공으로 표현하지 않는다. 보고에는 수정 파일, 정확한 명령과 결과, fixture 대 실제 API 구분, 미검증 환경, 남은 blocker와 스크린샷 경로를 포함한다. commit, deploy, 운영 변경은 별도 명시 승인 없이는 하지 않는다.
|
||||||
|
|
||||||
|
## 8. 진행 원칙
|
||||||
|
|
||||||
|
- 먼저 문서와 조사를 완료한 뒤 계획의 첫 Goal을 시작한다. 반복 인터뷰는 저장소나 계약에서 답을 찾을 수 없는 핵심 결정에만 한정하고, 질문도 그 미지수만 묻는다.
|
||||||
|
- 완료한 Goal마다 계획, progress, verification을 같은 시점에 갱신한다. 증거가 없는 체크박스나 PASS는 남기지 않는다.
|
||||||
|
- 정확한 실제 파일, 명령, 결과만 기록한다. backend 역사적 검증을 frontend evidence로 복사하지 않는다.
|
||||||
|
- 이 프롬프트를 또 다른 구현 프롬프트로 바꾸지 않는다. bootstrap 문서를 만들고 그 계획에 따라 실제 frontend 기능을 구현한다.
|
||||||
|
|
||||||
|
## 9. 화면별 acceptance criteria
|
||||||
|
|
||||||
|
### 콘텐츠 상세와 시리즈 상세
|
||||||
|
|
||||||
|
- 두 상세 화면에는 기존 권한 및 버튼 패턴에 맞는 번역 후보 선택 진입점을 둔다.
|
||||||
|
- 콘텐츠 진입은 현재 콘텐츠 ID를 CONTENT scope로 전달한다.
|
||||||
|
- 시리즈 진입은 series ID를 SERIES scope로 전달한다. 개별 활성 멤버를 프론트에서 수집해 요청 대상을 축소하지 않는다.
|
||||||
|
- 하나의 공유 workflow를 열되, 현재 상세 화면의 context와 돌아갈 위치를 잃지 않는다.
|
||||||
|
- ADMIN이 아닌 사용자는 기능 버튼을 보지 못하고, URL을 직접 열어도 인증된 기존 접근 거부 흐름을 따른다.
|
||||||
|
- 요청 진행 중 같은 요청을 여러 번 생성하는 중복 click을 막는다. 생성의 unknown outcome에서는 기존 UUID를 보존한다.
|
||||||
|
|
||||||
|
### 준비 및 grouping 검토
|
||||||
|
|
||||||
|
- `PREPARING` 화면은 준비 중임을 표시하고 서버 요약을 재조회한다. 비어 있는 snapshot을 완성 데이터처럼 보여주지 않는다.
|
||||||
|
- `FAILED`에는 API의 failure code를 사람이 이해할 수 있는 상태로 나타내고 재시작은 새 요청을 통해서만 한다.
|
||||||
|
- 시리즈 `REVIEW_REQUIRED`에서 모든 snapshot 멤버를 식별하고, 그룹/개별 배정이 전체 scope를 덮는지 사용자에게 보여준다.
|
||||||
|
- 그룹 멤버, 원문 제목, 공통 span, residual과 literal 분할을 검토할 수 있어야 한다.
|
||||||
|
- 편집은 원문 구간 선택에 한정한다. 번역문을 직접 편집하는 입력창은 두지 않는다.
|
||||||
|
- span을 제출하기 직전에 code point start/end, nonempty substring, grapheme 경계, 각 멤버의 substring 동등성을 확인한다.
|
||||||
|
- 저장 중에는 중복 PUT을 막고 저장 결과의 최신 revision을 사용한다. 충돌이면 서버 최신 grouping을 읽되 사용자 변경을 자동 폐기하지 않는다.
|
||||||
|
- 검토 완료 버튼은 전체 coverage가 유효할 때만 활성화한다. 모든 individual 구성도 서버에 review PUT을 보내야 한다.
|
||||||
|
- group과 개별 처리의 제외는 서버에 저장된 후에만 확정 표시한다.
|
||||||
|
|
||||||
|
### 후보 생성 및 비교
|
||||||
|
|
||||||
|
- `READY_TO_GENERATE`에서는 시작 전 scope, 필드, source/target language, 동적 provider manifest를 간단히 요약한다.
|
||||||
|
- generate 전송 이후 버튼을 잠그고, progress `total`, `terminal`, `succeeded`, `failed`를 서버 응답 기준으로 표시한다.
|
||||||
|
- `GENERATING`과 READY 간 경합에서도 상태를 최신화한다. 늦게 도착한 이전 polling 응답이 새 상태를 덮지 않도록 request identity를 확인한다.
|
||||||
|
- cursor pagination은 반복 cursor 및 중복 응답에서도 ID 기준 병합으로 안정적이어야 한다. 페이지 로드 실패를 전체 결과 완료로 표시하지 않는다.
|
||||||
|
- 후보 실패는 다른 provider의 성공을 숨기거나 대체하지 않는다. provider/version과 실패 상태를 알 수 있는 곳에 둔다.
|
||||||
|
- 같은 텍스트 결과를 묶었을 때 선택은 정확한 성공 candidate ID 하나에 연결되어야 하며, 출처 표시는 모든 동등 candidate를 포함한다.
|
||||||
|
- `emptyFields`와 literal-only residual에는 후보 선택을 요구하지 않는다. 빈 후보를 성공 상태로 만들어 apply할 수 있게 하지 않는다.
|
||||||
|
- 후보 페이지를 다시 읽을 때 현재 선택 candidate가 더 이상 selectable이 아니면 선택을 해제하고 사용자에게 알린다.
|
||||||
|
|
||||||
|
### 적용 확인, receipt와 종료
|
||||||
|
|
||||||
|
- 선택 누락, 중복, 다른 언어/단위의 후보 ID는 프론트에서 제출하지 않는다. 서버 검증을 대신한다고 가정하지도 않는다.
|
||||||
|
- grouped title 미리보기는 각 그룹 멤버의 template마다 개별적으로 재구성한다. 공통 결과 하나를 모든 전체 제목으로 대체하지 않는다.
|
||||||
|
- 적용 요약은 선택된 콘텐츠·필드·언어, 공통 그룹 전체 멤버, residual source, provider provenance를 구분한다.
|
||||||
|
- 미선택 필드가 유지됨과 선택하지 않은 후보가 폐기됨을 확인 단계에서 함께 알린다.
|
||||||
|
- 확인 취소는 API 호출을 보내지 않고, 확인 후에는 operation ID 및 canonical body를 고정해 한 번 전송한다.
|
||||||
|
- 적용 실패 시 서버가 실패를 반환하면 현재 request 상태와 선택을 유지할 수 있는지 계약에 따라 처리한다. 이미 적용된 receipt를 실패로 표시하지 않는다.
|
||||||
|
- apply 응답의 immutable receipt를 보여주고, 재조회 시에도 같은 결과를 표시한다. receipt의 applied fields와 provider source를 candidate 페이지가 바뀌어도 잃지 않는다.
|
||||||
|
- 성공 이후 영향받은 content 및 series 화면의 기존 query cache만 갱신한다. 실패나 unknown outcome에서 기존 데이터를 낙관적으로 변경하지 않는다.
|
||||||
|
- 취소 요청은 서버 응답 전까지 취소 완료로 표시하지 않는다. 취소 전에 전송 승인을 받은 provider 호출은 계속될 수 있고 이미 발생한 비용을 되돌리지 못함을 사용자에게 설명한다.
|
||||||
|
|
||||||
|
## 10. 문서와 검증 기록 형식
|
||||||
|
|
||||||
|
`plan-task.md`에는 저장소가 지원하는 형식을 따르되 실제 이 구현을 재개할 수 있는 정보를 남긴다.
|
||||||
|
|
||||||
|
- 상단에 현재 상태, 현재 활성 Goal, 다음 Goal을 기록한다.
|
||||||
|
- 각 Phase에는 결과와 선행 의존성을 기록한다.
|
||||||
|
- 각 Task에는 고유 ID, 목적, 시작 조건, 완료 증거, 범위 밖, 실제 파일 경로, 테스트 우선 절차와 focused 명령을 적는다.
|
||||||
|
- 테스트 가능한 작업은 실패하는 assertion부터 작성하고 실패를 확인한 후 최소 구현, 통과 확인과 회귀를 기록한다.
|
||||||
|
- 테스트가 불가능한 작업에는 구체적인 사유와 대체 증거를 적는다.
|
||||||
|
- 하나의 Task 또는 Gate Goal만 active로 둔다. 성공한 Goal은 즉시 체크하고 그 Goal의 검증 결과를 progress에도 남긴다.
|
||||||
|
- 전체 사용자 테스트를 실행하지 않았다면 결과처럼 기록하지 않는다. 프로젝트가 지정한 사용자 실행 명령과 범위를 구분해 둔다.
|
||||||
|
|
||||||
|
`verification.md`의 초기 표에는 적어도 다음 열을 둔다.
|
||||||
|
|
||||||
|
| 검증 대상 | 기대 assertion | 환경·fixture | 실제 명령 또는 수동 절차 | 상태 | 증거 |
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
| 문서 bootstrap | 다섯 문서와 실제 경로가 확인됨 | local repo | 확인 후 입력 | NOT_RUN | 경로 |
|
||||||
|
| API 준비도 | auth, base URL, route/schema 사전조건을 안전하게 확인 | read-only | 실제 확인 명령 | NOT_RUN 또는 BLOCKED | 결과 |
|
||||||
|
| lifecycle 및 retry | 상태·UUID·revision 불변 | fixture 또는 승인된 test API 명시 | focused test | NOT_RUN | 결과 파일 |
|
||||||
|
| grouping 및 Unicode | coverage, span, grapheme, preview 일치 | fixture 명시 | focused test | NOT_RUN | 결과 파일 |
|
||||||
|
| apply와 provenance | 부분 적용 및 source 보존 | fixture 또는 승인된 test API 명시 | focused test | NOT_RUN | 결과 파일 |
|
||||||
|
| 오류와 UI 회귀 | envelope, 오류, role, keyboard, layout | fixture/local UI | 실제 명령·화면 확인 | NOT_RUN | 결과 및 screenshot |
|
||||||
|
| live API 통합 | 실제 서버가 있다면 read-only/승인된 test scope에서 확인 | 환경 이름과 fixture | 정확한 요청 경로 | BLOCKED 또는 NOT_RUN | 결과 |
|
||||||
|
|
||||||
|
표의 행을 모두 실제 환경에 맞게 구체화한다. 행 예시는 완료 증거가 아니다. `PASS`는 assertion 또는 수동 관찰 evidence가 있을 때만 쓴다. `FAIL`은 문제와 재현 절차를 남기고 수정 전 기록을 보존한다. `BLOCKED`에는 무엇이 없어서 막혔는지 쓴다.
|
||||||
|
|
||||||
|
`progress.md`는 실행 가능한 재개 노트로 작성한다.
|
||||||
|
|
||||||
|
- 승인된 범위와 현재 단계, 다음 단계, 활성 Goal을 먼저 보여준다.
|
||||||
|
- 확정 제품 결정과 API 계약 의존성을 간결하게 적는다.
|
||||||
|
- 완료 Goal별 실제 수정 파일과 검증 결과를 연결한다.
|
||||||
|
- 각 명령은 정확한 working directory와 결과/종료 상태를 기록한다.
|
||||||
|
- fixture 테스트와 live API 검증을 구분하고, 미실행 검증을 표시한다.
|
||||||
|
- 미해결 blocker, 가정, 사용자 질문과 답, 스크린샷 경로를 누적한다.
|
||||||
|
- requestId 기록이 필요한 경우 테스트 식별자만 쓰고 토큰, cookie, authorization header, API key, 개인정보를 기록하지 않는다.
|
||||||
|
|
||||||
|
## 11. 구현 완료 보고 형식
|
||||||
|
|
||||||
|
작업 종료 시 사용자에게 결과를 한국어로 짧게 보고한다. 코드 완료와 문서 완료를 구분하고 아래 정보를 빠뜨리지 않는다.
|
||||||
|
|
||||||
|
1. 구현된 동작과 주요 진입 경로.
|
||||||
|
2. 변경 파일 목록과 다섯 문서의 실제 위치.
|
||||||
|
3. 실제 실행한 focused test, lint, typecheck, build 명령 및 각 결과.
|
||||||
|
4. fixture/mock 검증과 실제 API 검증의 구분. 운영이 아닌 실제 서버 확인이 없으면 미검증으로 표시.
|
||||||
|
5. 화면 확인의 desktop/mobile 범위와 스크린샷 경로.
|
||||||
|
6. 남은 blocker, 환경 제약, 실제로 실행하지 않은 검증.
|
||||||
|
|
||||||
|
미완료 항목을 완료로 포장하지 않는다. 전체 검증이 불가능하더라도 안전하게 분리 가능한 UI와 테스트 구현을 마치고, 미검증 범위를 명시한다. backend 과거 검증 숫자나 리뷰 승인 문구를 frontend 성공 증거로 재사용하지 않는다.
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,152 @@
|
|||||||
|
# 관리자 번역 후보 선택 및 시리즈 제목 그룹화 PRD
|
||||||
|
|
||||||
|
## 문서 정보
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 문서 상태 | 서버 구현 및 DEC-11 플래그 제거·로컬 검증·부모 직접 검토 완료, 운영 적용 미실행 |
|
||||||
|
| 작성일 | 2026-11-17 |
|
||||||
|
| 최종 수정일 | 2026-11-18 |
|
||||||
|
| 대상 제품 | 관리자 다중 제공자 번역 후보 선택 및 시리즈 제목 그룹화 |
|
||||||
|
| 작성자·결정권자 | 제품 결정권자: 사용자 인터뷰 확인 사항 |
|
||||||
|
| 관련 API Contract | [api-contract.md](api-contract.md), 9개 endpoint 구현 완료 |
|
||||||
|
| 관련 구현 계획 | [plan-task.md](plan-task.md), P1~P5 완료, P7 자동 등록 변경 및 별도 운영 전제 |
|
||||||
|
| 관련 review | [설계 검토](reviews/design-review.md), [구현 검토·QA](reviews/implementation-review.md) |
|
||||||
|
|
||||||
|
### 요구사항 상태
|
||||||
|
|
||||||
|
이 문서는 제품 동작에 대한 인터뷰 확정사항을 기록한다. API 계약과 기술 설계 제안은 사용자가 승인했으며 서버 구현과 focused tests를 시작하도록 명시적으로 승인했다. 승인 범위는 로컬 서버 구현과 focused tests이며 production DDL/deploy/git commit은 포함하지 않는다. 승인된 활성-only series 구성원, one-shot subset apply, 자유 형식 번역문 제외 결정을 유지한다.
|
||||||
|
|
||||||
|
## 1. 개요
|
||||||
|
|
||||||
|
관리자는 단일 콘텐츠 또는 시리즈의 현재 활성 구성원 전체를 대상으로 번역 후보를 검토하고 선택할 수 있어야 한다. 시리즈에서는 실제 제목을 분석해 반복되는 공통 제목 구간을 묶고, 공통 구간과 개별 제목의 번역을 분리해 관리한다. 선택한 값만 적용하며, 기존 자동 번역과 관리자의 필드별 수정 상태를 보존한다.
|
||||||
|
|
||||||
|
## 2. 문제
|
||||||
|
|
||||||
|
관련 에피소드 제목의 번역이 서로 일관되지 않을 수 있다. 기존 단일 번역 흐름만으로는 여러 번역 제공자의 결과를 비교하거나 시리즈 제목의 공통 부분을 함께 검토하기 어렵다. 관리자가 결과를 검토하기 전에 자동으로 값을 덮어쓰면 원치 않는 번역 변경이 발생할 수 있다.
|
||||||
|
|
||||||
|
## 3. 목표
|
||||||
|
|
||||||
|
- 관리자가 번역 제공자별 후보를 비교하고 대상 필드에 적용할 후보를 선택한다.
|
||||||
|
- 시리즈 구성원 제목에서 공통 구간과 개별 구간을 검토하고, 공통 구간 번역을 그룹 단위로 적용한다.
|
||||||
|
- 분석·생성 결과를 검토하고 명시적으로 선택하기 전까지 기존 번역 결과를 유지한다.
|
||||||
|
- 일부 필드만 적용할 수 있고, 미선택 필드는 현재 값을 유지한다.
|
||||||
|
|
||||||
|
## 4. 범위 제외
|
||||||
|
|
||||||
|
- 자유 형식의 번역문을 직접 입력·편집하는 기능은 현재 요청에 포함되지 않아 설계에서 제외한다. 이는 별도 인터뷰에서 거부된 기능이라는 뜻이 아니다. 원문 그룹과 구간(span)을 조정하는 편집은 포함한다.
|
||||||
|
- 전역 초기화 기능, 새 번역 제공자 추가, 원작 관련 동작, 용어집 또는 LLM 시스템 도입.
|
||||||
|
- 프론트엔드 코드 구현과 UI 시각 스타일 규격.
|
||||||
|
- 실제 운영 환경에서의 번역 정확도 및 처리량 보장. 현재 근거가 확인되지 않았으며 제품 요구 확정을 막는 질문으로 취급하지 않는다.
|
||||||
|
|
||||||
|
## 5. 사용자와 권한
|
||||||
|
|
||||||
|
| 사용자 | 목표 | 주요 작업 |
|
||||||
|
|---|---|---|
|
||||||
|
| 관리자 | 번역 결과의 일관성과 정확성을 통제 | 대상 선택, 분석 검토·수정, 필드별 후보 선택, 취소 및 적용 |
|
||||||
|
|
||||||
|
이 기능은 기존 관리자 권한 경계 안에서 제공한다. 인증·인가의 구체적인 계약은 기존 시스템과의 연동 설계에서 확인한다.
|
||||||
|
|
||||||
|
## 6. 핵심 흐름
|
||||||
|
|
||||||
|
1. 관리자가 단일 콘텐츠 또는 시리즈를 선택한다. 시리즈 대상은 요청 생성 시점의 현재 활성 구성원 전체다.
|
||||||
|
2. 시스템이 시리즈 제목을 분석해 반복되는 공유 구간과 각 제목의 고유 구간을 제시한다. 고정된 EP 표기 규칙을 전제로 하지 않는다.
|
||||||
|
3. 관리자는 생성 전에 분석 결과를 검토하고, 원문 그룹과 구간을 조정하거나 특정 콘텐츠를 그룹에서 제외해 개별 처리 대상으로 바꿀 수 있다. 생성 뒤에는 그룹을 수정할 수 없으며, 수정하려면 요청을 취소하고 새 요청을 만든다.
|
||||||
|
4. 시스템은 제목·상세·태그와 원본 언어를 제외한 지원 언어에 대해 등록된 각 제공자를 독립적으로 새로 호출한다. 이전 결과는 적용 전까지 유지한다.
|
||||||
|
5. 관리자는 제공자 출처를 확인하고 적용할 후보의 필드와 언어를 선택한다. 같은 후보는 제공자 출처를 모두 보존한 채 묶어 표시할 수 있다. 제공자별 실패도 결과에 표시한다.
|
||||||
|
6. 관리자는 검토 또는 생성 중 취소하거나 선택한 일부 후보를 한 번에 적용한다. 적용에서 생략한 후보는 폐기되고, 미선택 번역 값은 그대로 둔다.
|
||||||
|
|
||||||
|
## 7. 기능 요구사항
|
||||||
|
|
||||||
|
### 7.1 대상과 분석
|
||||||
|
|
||||||
|
| ID | 상태 | 요구사항 | 수용 기준 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| TR-01 | 확정 | 단일 콘텐츠 대상은 해당 콘텐츠의 제목, 상세, 태그 번역 필드를 처리할 수 있어야 한다. | 선택한 단일 콘텐츠의 세 필드를 번역 후보 대상으로 지정할 수 있다. |
|
||||||
|
| TR-02 | 확정 | 시리즈 대상은 현재 연결된 활성 구성원 전체의 제목, 상세, 태그 번역 필드를 포함해야 한다. 비활성 구성원은 제외한다. | 요청 생성 시 활성 연결 콘텐츠를 빠짐없이 포함하고 비활성 콘텐츠는 후보 생성과 제목 분석에서 제외한다. |
|
||||||
|
| TR-03 | 확정 | 시리즈 제목 분석은 실제 제목들을 바탕으로 반복되는 공유 구간과 고유 구간을 식별해야 한다. | 임의의 제목 형식에 적용할 수 있으며 고정된 EP 번호 parsing 규칙을 요구하지 않는다. |
|
||||||
|
| TR-04 | 확정 | 관리자는 번역 후보 생성을 시작하기 전에 그룹 분석 결과를 검토하고 원문 그룹과 구간(span)을 수정할 수 있어야 한다. | 생성 전에 분석을 검토하고 수정한 그룹·구간을 기준으로 다음 단계에 진입할 수 있다. 생성 이후 그룹 수정은 취소 후 새 요청에서만 가능하다. |
|
||||||
|
| TR-05 | 확정 | 관리자는 후보 생성을 시작하기 전에 콘텐츠를 공통 제목 그룹에서 제외해 개별 처리 대상으로 바꿀 수 있어야 한다. | 제외된 콘텐츠의 제목은 공통 그룹 적용 대상이 되지 않고 개별 후보로 처리된다. 생성 이후 변경은 취소 후 새 요청에서 가능하다. |
|
||||||
|
| TR-06 | 확정 | 단일 콘텐츠 번역을 먼저 해야 시리즈 번역을 시작할 수 있다는 순서 제약을 두지 않는다. | 시리즈 대상 처리를 단일 콘텐츠 처리 완료 여부에 종속하지 않는다. |
|
||||||
|
|
||||||
|
### 7.2 후보 생성과 검토
|
||||||
|
|
||||||
|
| ID | 상태 | 요구사항 | 수용 기준 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| TR-07 | 확정 | 제목·상세·태그 전체와 원본 언어를 제외한 지원 대상 언어에 대해 등록된 모든 제공자를 각각 새로 호출해야 한다. | 후보 생성은 일부 필드·언어만 선택하도록 요구하지 않는다. 기존 후보를 재사용해 새 요청을 생략하지 않는다. 각 제공자 결과는 출처와 연결된다. |
|
||||||
|
| TR-08 | 확정 | 새 결과가 생성되는 동안 기존 번역 결과를 유지해야 한다. | 관리자가 새 후보를 선택해 적용하기 전에는 기존 결과가 바뀌지 않는다. |
|
||||||
|
| TR-09 | 확정 | 후보는 필드별로 제공자를 선택할 수 있어야 한다. | 제목, 상세, 태그 등 각 필드의 선택이 다른 필드 선택에 종속되지 않는다. |
|
||||||
|
| TR-10 | 확정 | 동일한 후보 텍스트를 제공자 출처를 보존한 채 묶어 표시할 수 있어야 한다. | 묶인 후보의 모든 제공자 출처를 확인할 수 있다. 동일 결과라는 이유로 출처 정보를 버리지 않는다. |
|
||||||
|
| TR-11 | 확정 | 제공자 실패를 관리자에게 표시해야 한다. | 실패한 제공자와 실패 상태를 확인할 수 있고, 다른 제공자의 후보는 계속 검토할 수 있다. |
|
||||||
|
| TR-12 | 확정 | 기존 번역의 제공자 출처가 알려져 있지 않을 수 있음을 허용해야 한다. | 출처 불명인 기존 값에 특정 제공자를 추정해 표시하지 않는다. |
|
||||||
|
| TR-13 | 확정 | 원본 언어가 사용 가능하면 그 값을 사용하고, 정확한 원본 언어를 일상적으로 다시 감지하지 않는다. | 기존 원본 언어 정보를 사용할 수 있는 상황에서 매번 재감지를 요구하지 않는다. |
|
||||||
|
|
||||||
|
### 7.3 적용, 취소 및 데이터 보존
|
||||||
|
|
||||||
|
| ID | 상태 | 요구사항 | 수용 기준 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| TR-14 | 확정 | 공통 제목 후보의 선택과 적용은 그룹 및 언어 단위로 하나의 불가분 작업이어야 한다. | 공통 제목 그룹의 특정 언어에 대해 선택한 공통 후보가 해당 그룹에 함께 적용된다. |
|
||||||
|
| TR-15 | 확정 | 관리자는 후보 생성 전에 개별 콘텐츠를 공통 그룹에서 제외할 수 있어야 한다. | 제외한 콘텐츠는 공통 후보 적용에서 빠지고 나머지 그룹 구성원은 그룹 단위 적용을 유지한다. 생성 후 그룹 편집은 취소와 새 요청이 필요하다. |
|
||||||
|
| TR-16 | 확정 | 관리자는 생성된 전체 후보 중 일부만 선택해 한 번 적용할 수 있어야 한다. 적용은 요청을 닫고 나머지 후보를 폐기한다. | 미선택 필드·언어 값은 기존 값을 유지한다. 요청을 닫은 뒤 누락 후보를 같은 요청에서 다시 적용할 수 없다. |
|
||||||
|
| TR-17 | 확정 | 관리자는 분석, 제공자 요청 실행, 결과 검토 단계까지 취소할 수 있어야 한다. | 각 단계에서 적용을 확정하지 않고 취소할 수 있다. 이미 비용이 발생한 진행 중 외부 요청은 취소로 되돌릴 수 없음을 사용자 흐름에서 알 수 있어야 한다. |
|
||||||
|
| TR-18 | 확정 | 관리자가 적용한 값은 해당 필드의 관리자 재정의로 보호되어야 한다. | 보호는 필드 단위이며 적용하지 않은 필드에는 새 보호 상태를 만들지 않는다. |
|
||||||
|
| TR-19 | 확정 | 보호된 필드의 원본이 변경되면 그 필드의 관리자 재정의만 해제하고 일반 자동 번역을 재개해야 한다. | 원본 변경 시 해당 필드만 보호가 해제된다. 변경되지 않은 다른 필드의 관리자 값은 계속 보호된다. |
|
||||||
|
| TR-20 | 확정 | 후보 생성 후 원본이 변경된 필드에는 해당 필드의 이전 후보를 적용할 수 없어야 한다. | 원본 변경 후 해당 필드의 후보 적용이 거부되거나 무효임을 검토 흐름에서 분명히 확인할 수 있다. |
|
||||||
|
|
||||||
|
## 8. 수용 기준
|
||||||
|
|
||||||
|
- 관리자는 단일 콘텐츠의 제목·상세·태그와 시리즈의 현재 활성 연결 콘텐츠 전체의 같은 번역 필드를 대상으로 선택할 수 있다.
|
||||||
|
- 실제 제목이 정해진 EP 형식과 다르더라도 공유 구간과 고유 구간을 검토할 수 있으며, 관리자는 후보 생성 전 그룹과 구간을 수정하거나 항목을 개별 처리로 제외할 수 있다.
|
||||||
|
- 모든 등록 제공자가 각자 새로 요청되며, 제공자별 결과·실패와 후보 출처가 구분되고, 같은 후보가 묶여도 출처가 보존된다.
|
||||||
|
- 새 후보를 선택하기 전의 기존 번역은 유지되고, 관리자는 필드별로 선택할 수 있다.
|
||||||
|
- 후보 생성은 모든 세 필드와 원본 언어를 제외한 지원 언어를 대상으로 한다. 공통 제목 후보는 그룹 및 언어 단위로 적용되며, 개별 제외와 일부 선택 적용이 가능하다.
|
||||||
|
- 한 번의 일부 적용 후 요청이 닫히고 미선택 후보는 폐기된다.
|
||||||
|
- 분석·요청 실행·검토 중 취소할 수 있다. 취소는 이미 비용이 발생한 진행 중 제공자 요청을 되돌리지 않는다.
|
||||||
|
- 적용된 필드의 관리자 보호는 원본 변경 시 그 필드에 한해 해제되고, 다른 변경되지 않은 필드는 보호 상태를 유지한다.
|
||||||
|
- 후보 생성 후 원본이 변경된 필드에는 이전 후보를 적용할 수 없다.
|
||||||
|
|
||||||
|
## 9. 미결 기술 설계와 확인 경계
|
||||||
|
|
||||||
|
제품 동작 요구와 후속 설계/API 계약은 승인되었으며 9개 서버 endpoint를 구현했다. [plan-task.md](plan-task.md)에 단계별 검증과 최종 gate 보정을 기록했다. DEC-11에 따라 API와 후보 worker는 별도 설정 없이 기동 시 등록한다. 새 writer의 작업 생성 전 스키마·구 writer 종료·구 index 제거가 필요하며 프론트엔드 코드는 이번 범위 밖이다.
|
||||||
|
|
||||||
|
다음은 인터뷰에서 사용자가 선택한 제품 동작이 아니라 기술 제안이다: 제목 구간 분석·경계 규칙, 비동기 작업·부분 실패 표현, source freshness 검증, 관리자 재정의 저장과 materializer 연동, endpoint 및 프론트엔드 interaction. 세부 운영 정확도와 처리량은 실측 전까지 검증되지 않았으며 현재 제품 질문을 열어두는 이유는 아니다.
|
||||||
|
|
||||||
|
기존 번역의 제공자 출처는 불명일 수 있다. 제품 요구는 출처를 추정하지 않는 것이며, 기존 데이터의 출처 복구나 일괄 보정은 범위에 포함하지 않는다.
|
||||||
|
|
||||||
|
## 10. 요구사항 상태 및 준비도
|
||||||
|
|
||||||
|
| 구분 | 상태 |
|
||||||
|
|---|---|
|
||||||
|
| 제품 요구사항 | 인터뷰 결정으로 확정 |
|
||||||
|
| 기술 설계 및 기존 시스템 연동 | 구현·로컬 검증 완료 |
|
||||||
|
| API 계약 | 9개 endpoint 구현, 실제 HTTP 검증 완료 |
|
||||||
|
| 구현 계획/TASK | P1~P5 및 P7-T1 로컬 구현·검증 완료, P7-GATE 대기, 운영 checklist 별도 |
|
||||||
|
| 구현 | P1~P5 최종 gate APPROVE, P7 별도 검토 대기, 운영 DDL/배포 미실행 |
|
||||||
|
|
||||||
|
요구사항 명확도 점수는 인터뷰 단계의 휴리스틱 평가다. 모호성 0.10, 목표 0.95, 범위 0.95, 제약 0.90, 성공 기준 0.90, 기존 맥락 0.75. 이 점수는 기술 설계 완료나 구현 착수를 뜻하지 않는다.
|
||||||
|
|
||||||
|
## 11. 인터뷰 결정 로그
|
||||||
|
|
||||||
|
| 날짜 | ID | 상태 | 결정 | 영향 |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| 2026-11-17 | DEC-01 | 정정 전 제안 | 단일 콘텐츠는 제목·상세·태그, 시리즈는 연결 콘텐츠의 같은 필드를 대상으로 한다. 초안의 비활성 포함은 사용자 확인 없이 추가된 제안이었으며 DEC-09로 정정한다. | TR-01, TR-02 |
|
||||||
|
| 2026-11-17 | DEC-02 | 확정 | 모든 필드와 원본 언어 외 지원 언어의 후보 생성을 요청하고, 등록된 제공자를 독립적으로 새로 호출한다. 적용 전까지 기존 값을 유지한다. 같은 후보는 출처를 보존해 묶을 수 있고, 실패를 표시한다. 기존 출처는 알 수 없을 수 있다. | TR-07~TR-12 |
|
||||||
|
| 2026-11-17 | DEC-03 | 확정 | 원본 언어가 사용 가능하면 사용하고, 맞는 값을 일상적으로 재감지하지 않는다. | TR-13 |
|
||||||
|
| 2026-11-17 | DEC-04 | 확정 | 제목은 고정 EP parsing이 아니라 실제 제목의 반복 공유 구간과 고유 구간을 분석한다. 생성 전에 관리자가 원문 그룹·구간을 수정하고 항목을 개별 처리로 제외할 수 있다. | TR-03~TR-06 |
|
||||||
|
| 2026-11-17 | DEC-05 | 확정 | 후보 생성은 전체 대상 필드·지원 언어를 포함한다. 관리자는 필드별 후보를 선택하며 공통 제목은 그룹 및 언어 단위로 함께 선택·적용한다. 개별 제외는 생성 전에 한다. | TR-07, TR-09, TR-14, TR-15 |
|
||||||
|
| 2026-11-17 | DEC-06 | 확정·보완 | 일부 선택 적용과 적용 전 취소를 허용한다. 미선택 번역 값은 유지하며 이미 전송된 요청 비용은 되돌릴 수 없다. 한 번 적용 후 종료 정책은 후속 DEC-10에서 별도로 확정했다. | TR-16, TR-17 |
|
||||||
|
| 2026-11-17 | DEC-07 | 확정 | 적용된 관리자 보호는 필드별이다. 원본 변경 시 변경된 필드만 보호를 풀고 자동 번역을 재개하며, 변경되지 않은 필드는 보호한다. 후보 생성 후 원본이 바뀐 필드에는 해당 필드의 이전 후보를 적용할 수 없다. | TR-18~TR-20 |
|
||||||
|
| 2026-11-17 | DEC-08 | 확정 | 이번 문서 범위는 요구사항과 별도 제안 설계다. 설계/API 계약/계획은 사용자 검토 전 제안 상태이고 구현은 시작하지 않는다. | 문서 상태, 후속 문서 링크 |
|
||||||
|
| 2026-11-17 | DEC-09 | 확정 | 추가 인터뷰에서 시리즈는 활성 콘텐츠만 포함하기로 선택했다. 비활성 콘텐츠는 제목 분석·후보 생성에서 제외한다. | TR-02, DEC-01 정정 |
|
||||||
|
| 2026-11-17 | DEC-10 | 확정 | 추가 인터뷰에서 한 번 적용하면 요청을 종료하고 미선택 후보는 폐기하기로 선택했다. 다른 결과를 적용하려면 새 요청을 생성한다. | TR-16, DEC-06 보완 |
|
||||||
|
| 2026-11-18 | DEC-11 | 확정 | 사용자가 enabled=false 설정을 제거하고 배포 시 바로 사용할 수 있도록 요청했다. 활성화 property와 controller/worker 조건부 등록, 해당 플래그의 일반 큐 legacy 호환 분기를 제거한다. ADMIN 권한·기존 worker 잠금·주기는 유지한다. | P7-T1, 이전 OFF→ON 운영 안내 대체 |
|
||||||
|
|
||||||
|
DEC-11부터 관리자 번역 기능은 설정 없이 애플리케이션 기동 시 등록한다. 스키마가 자동으로 변경되지는 않는다. 신규 writer가 작업을 생성하기 전 신규 테이블·언어 포함 unique index를 준비하고, 구 writer/in-flight 작업 종료 및 구 unique index 제거를 완료해야 한다. 운영 변경은 이번 코드 수정의 실행 범위가 아니다. 이전 실행 기록의 기본 OFF 안내는 당시 상태이며 현재 정책은 DEC-11이다.
|
||||||
|
|
||||||
|
## 12. 승인 및 실행 기록
|
||||||
|
|
||||||
|
| 날짜 | 상태 | 기록 |
|
||||||
|
|---|---|---|
|
||||||
|
| 2026-11-17 | 설계 승인 및 구현 승인 | 사용자가 설계 승인 후 구현 시작을 명시적으로 선택했다. 승인은 로컬 서버 구현과 focused tests에 한정되며 production DDL/deploy/git commit은 승인 범위가 아니다. 활성-only series 구성원, one-shot subset apply, 자유 형식 번역문 제외 결정을 유지한다. 실행 기준은 기존 plan의 Progress 실행 ledger이며 새 계획이나 workspace를 만들지 않는다. 현재 workspace는 기존 test branch이고 P1 구현 담당자가 source와 plan을 읽는다. 이 문서 갱신 시점에 완료된 구현 Goal은 없다. |
|
||||||
|
| 2026-11-17 | 로컬 구현 완료 | P1~P5·최종 gate 보정 완료. 마지막 실제 HTTP 27개와 bootJar 통과, 관련 회귀와 ktlintCheck 통과, 최종 제한 검토 APPROVE. 운영 적용은 실행하지 않았다. |
|
||||||
|
| 2026-11-18 | DEC-11 로컬 구현·검증 완료 | P7-T1의 등록·언어 identity RED 4개 assertion 실패 후 플래그·legacy 분기·고아 조회를 제거했다. 직접 영향 18개 class 162개 테스트와 ktlintCheck 통과. P7-GATE는 부모 검토 대기이며 운영 DDL·배포·커밋은 미실행이다. |
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
# 관리자 번역 후보 설계 검토
|
||||||
|
|
||||||
|
> 이 문서는 2026-11-17 설계 검토 이력이다. DR-03의 OFF 호환 모드와 flag 전환 정책은 2026-11-18 PRD DEC-11/P7로 대체됐다. 현재는 기동 시 자동 등록하며, 새 writer 작업 생성 전에 세 테이블·언어 포함 unique index 준비, 구 writer/in-flight 종료, 구 index 제거가 필요하다. 아래 과거 판정은 보존한다.
|
||||||
|
|
||||||
|
## 범위와 판정
|
||||||
|
|
||||||
|
- 일자: 2026-11-17.
|
||||||
|
- 대상: [PRD](../prd.md), [API 계약](../api-contract.md), [구현 계획](../plan-task.md).
|
||||||
|
- 독립 검토: Oracle 한 차례, 문서와 관련 기존 코드 읽기만 수행.
|
||||||
|
- 판정: 아래 지적 보정 후 설계 산출물 수용 가능. 제품 구현 완료 또는 사용자 구현 승인을 의미하지 않는다.
|
||||||
|
|
||||||
|
## 지적 및 반영
|
||||||
|
|
||||||
|
| ID | 중요도 | 확인한 문제 | 보정 내용 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| DR-01 | 높음 | 비활성 포함·한 번 적용 후 종료를 인터뷰 확정으로 잘못 기록 | 후속 인터뷰에서 활성 콘텐츠만 포함, 한 번 적용 후 종료를 직접 확인했다. PRD DEC-09/10으로 정정했다. 자유 번역문 입력 제외는 요청 범위 제안으로 구분했다. |
|
||||||
|
| DR-02 | 높음 | API apply 설명이 source 검증 후 잠금을 획득 | request → Series → CONTENT 잠금 후 최신 source·membership·override·payload를 재조회·검증하도록 통일했다. |
|
||||||
|
| DR-03 | 높음 | source-language-aware lookup과 구 unique index가 혼재하면 insert 충돌 | 새 코드의 disabled 호환 모드는 exact-language 조회 후 legacy-key exists 확인으로 기존 mismatch skip을 보존한다. 구 writer 제거와 구 index 삭제 후에만 enabled=true로 활성화한다. 호환 모드도 단일 row legacy 조회를 하지 않는다. |
|
||||||
|
| DR-04 | 중간 | 취소의 실제 전송/dispatch 승인 기준 및 network 대기 설명 충돌 | DB 취소 commit 이후 새 승인·게시 금지로 통일했다. 이미 승인된 호출은 in-flight이고, 취소 응답은 network 종료를 기다리지 않는다. |
|
||||||
|
| DR-05 | 중간 | grouping/segment/candidate 배열 대응 및 preview 계약 부족 | GroupingResponse/TitleTemplate/TitleSegment, code-point index, shared/residual valueIndex, input/output cardinality, receipt 타입을 정의했다. |
|
||||||
|
| DR-06 | 중간 | PREPARING의 durable 실행·재시작·취소가 불명확 | 요청과 활성 member IDs를 먼저 저장하고 동일 poller가 preparation lease/fence를 claim한다. 복구 1회, snapshot 게시 전 취소·source 검증, 반복 만료의 명시 실패를 정의했다. |
|
||||||
|
| DR-07 | 중간 | replay 우선순위 및 frozen provider version 검사가 누락 | 저장된 generation revision/apply operation replay를 최신 revision 거부보다 먼저 확인하고 provider ID/version 변경은 명시 실패로 처리한다. |
|
||||||
|
|
||||||
|
## 추가 정합성 보정
|
||||||
|
|
||||||
|
- CONTENT materializer는 유효한 관리자 override가 있으면 해당 필드의 shared memory가 없어도 승인 값을 사용할 수 있도록 순서를 명시했다.
|
||||||
|
- API의 잘못된 계획 anchor, source snapshot/현재 값 구분, 삭제·비활성화 후 자격 검증을 보완했다.
|
||||||
|
- 위 수정은 문서만 변경했다. 신규 endpoint, DDL, source, test는 구현하지 않았다.
|
||||||
|
|
||||||
|
## 검증 범위
|
||||||
|
|
||||||
|
- 부모 에이전트가 세 문서를 읽고 요구사항·API·계획을 대조했다.
|
||||||
|
- 공백 검사와 최종 변경 파일 확인 결과는 구현 계획의 문서 검증 기록에 남긴다.
|
||||||
|
- 실행하지 않음: 애플리케이션/테스트/빌드, 운영 DB·MySQL 잠금 검증, 실제 AWS·파파고 호출, 프론트엔드 QA.
|
||||||
|
- 남은 항목: 사용자 기술 설계 검토와 별도 구현 승인. 실제 제목 분석 정확도·처리량·provider timeout은 계획의 focused 검증에서 확인한다.
|
||||||
@@ -0,0 +1,74 @@
|
|||||||
|
# 관리자 번역 선택 구현 검토 및 QA
|
||||||
|
|
||||||
|
## 범위와 현재 판정
|
||||||
|
|
||||||
|
- 목표: 관리자 단건/활성 시리즈 콘텐츠의 provider별 새 후보 비교·선택, 제목 공통 구간 검토, 취소, 부분 원자 적용 및 필드별 승인 보호.
|
||||||
|
- 범위: 서버 코드·API 계약·DDL 배포 준비. 실제 프론트엔드·운영 DB 반영·배포·커밋은 제외한다.
|
||||||
|
- P1~P4 작업별 검토와 P5를 포함한 단일 전체 gate, 차단 한 건 보정 후 새 delta 검토를 완료했다.
|
||||||
|
- P1~P5 최종 판정: **APPROVE / HIGH**. 후속 DEC-11/P7은 사용자 지시에 따라 부모가 직접 코드·검증 기록·문서를 검토하고 최신 bootJar를 빌드해 완료했다. P7의 외부 승인으로 표현하지 않는다. 운영 MySQL/cloud 검증은 수행하지 않았다.
|
||||||
|
|
||||||
|
> 아래 2026-11-17 검증·판정은 당시 이력이다. 기본 OFF 및 flag 전환 정책은 PRD DEC-11/P7로 대체됐으며 기존 PASS 기록은 재작성하지 않는다.
|
||||||
|
|
||||||
|
- 후속 P7-T1 로컬 증거: 등록·언어 identity RED 4개 실패 후 직접 영향 18개 class 162개 테스트 및 ktlintCheck 통과. 부모가 직접 검토하고 `./gradlew --offline --no-daemon bootJar`의 BUILD SUCCESSFUL 및 JAR 생성을 확인했다. 상세 명령·이력·한계는 `plan-task.md` P7-GATE 기록에 있다.
|
||||||
|
|
||||||
|
## 최종 트리에서 부모 에이전트가 실행한 검증
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionHttpIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionApplyHttpIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionReceiptHttpIntegrationTest' \
|
||||||
|
bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
- 결과: BUILD SUCCESSFUL in 50s, 종료 코드 0. 실제 로컬 HTTP 서버와 H2/fake providers를 사용한 14+10+3 = 27개 테스트, 실패/오류/skip 0.
|
||||||
|
- 마지막 writer overload 수정 이후 최종 HTTP 흐름을 부모가 직접 실행했다. 브라우저 수동 QA나 실제 AWS/Papago 번역 품질 검증으로 표현하지 않는다.
|
||||||
|
- 산출물: `build/libs/sodalive-0.0.1-SNAPSHOT.jar` 생성 확인.
|
||||||
|
- 증거 root: `build/test-results/test/`. 아래 A/B/C는 그 디렉터리의 XML 파일이다.
|
||||||
|
- A: `TEST-kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionHttpIntegrationTest.xml`
|
||||||
|
- B: `TEST-kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionApplyHttpIntegrationTest.xml`
|
||||||
|
- C: `TEST-kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionReceiptHttpIntegrationTest.xml`
|
||||||
|
|
||||||
|
## 실제 HTTP QA 행렬
|
||||||
|
|
||||||
|
| 시나리오 | 실행/기대 | 관찰 결과 | 판정·증거 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 단건 전체 흐름 | 생성→준비→후보 생성→일부 선택→receipt/출처 재조회 | 선택 필드만 적용되고 출처·receipt가 조회됨 | PASS, A의 실제 HTTP 전체 흐름 case |
|
||||||
|
| 시리즈 여러 그룹·개별 제목 | 그룹 수정·검토→생성→공통 후보+member별 residual 선택 | 그룹별 동일 공통 표기, 선택 언어와 개별 제목만 반영, 미선택 폐기 | PASS, B의 multiple groups case |
|
||||||
|
| 잘못된 그룹 선택 | member residual 누락 후 apply | INCOMPLETE_TITLE_GROUP, override 0건, 정상 선택 재전송은 성공 | PASS, B multiple groups case |
|
||||||
|
| 원문 변경·후보 오류 | 후보 생성 후 raw 공백 변경, 없는 candidate, 잘못된 언어/ID | SOURCE_CHANGED/CANDIDATE_NOT_SELECTABLE/INVALID_REQUEST, 승인 쓰기 0건 | PASS, B의 오류 9개 parameter cases |
|
||||||
|
| 사전 검토·편집 제약 | series 검토 전 generate, all-individual review, 생성 후 편집 | REVIEW_REQUIRED/호출0, 검토 revision 증가, 생성 후 편집 거부 | PASS, A의 review cases |
|
||||||
|
| 권한 | CONTENT_MANAGER/CREATOR/USER로 관리 action | ADMIN 외 역할 거부 | PASS, A의 role 3개 cases |
|
||||||
|
| 취소 | revision 없이 취소 후 재전송 및 취소된 request apply | 같은 terminal 취소 결과, REQUEST_CLOSED, 적용 없음 | PASS, A cancel 및 B closed case |
|
||||||
|
| Unicode/원문 재구성 | code-point/grapheme 범위와 template 조회 | raw 원문·residual 구문 보존, 잘못된 범위 거부 | PASS, A template/group cases |
|
||||||
|
| 시각/재전송 불변성 | 나노초 0/123456789/999999999, DB flush/clear, 원문 변경 뒤 receipt 조회 | DB·HTTP 시각은 초 정밀도로 일치, receipt/replay 불변 | PASS, C 3개 cases |
|
||||||
|
| P5 부분 적용 후 일반 자동 갱신 회귀 | 실제 title/detail apply→일반 title 수정→일반 worker; tags memory 없음·캐시 존재 및 provider 부분 실패 | 성공 title 게시·job 완료, detail 승인·미선택 tags 바이트 보존, 새 payload는 완성 전 job 미완료 | 로컬 회귀 PASS, `TranslationSelectionRefreshIntegrationTest` 3개 RED→4개 GREEN; 직접 회귀 118개 및 최종 lint 통과. 부모 delta 검토·관리 HTTP/bootJar 새 검증 대기. `plan-task.md` P5-R1 참조 |
|
||||||
|
| 실행 산출물 | bootJar | JVM 실행용 jar 생성 | PASS, `build/libs/sodalive-0.0.1-SNAPSHOT.jar` |
|
||||||
|
|
||||||
|
## 기존 집중 회귀 증거
|
||||||
|
|
||||||
|
- 필드 승인 보호·원문 변경·동시 materializer·queue refresh: plan-task.md P2 기록과 해당 통합 테스트.
|
||||||
|
- PREPARING 복구·취소·활성 scope·기본 비활성: P3 68개 focused 증거 및 독립 PASS.
|
||||||
|
- Provider별 fresh 후보·linked dedup·lease/fence·실제 SDK HTTP retry 취소: P4 기록 및 독립 PASS.
|
||||||
|
- P5 추가 source/group/cancel/apply concurrency와 transaction rollback: P5 56개 신규 cases를 포함한 관련 170개 검증 이력. 최초 20개 실패의 원인과 직접 영향 42개 재검증을 구분해 기록했다.
|
||||||
|
- 전체 테스트를 실행하지 않았다. 사용자 전체 테스트 명령은 `./gradlew test`다.
|
||||||
|
|
||||||
|
## 운영 한계
|
||||||
|
|
||||||
|
- H2 테스트는 운영 MySQL REPEATABLE READ·DDL·잠금·timestamp 검증의 대체물이 아니다.
|
||||||
|
- DEC-11에 따라 API와 후보 worker는 설정 없이 기동 시 등록된다. 신규 writer 작업 생성 전 세 테이블·언어 포함 queue unique index를 준비하고 구 writer/in-flight 작업 종료 및 구 queue unique index 제거를 완료해야 한다. 자동 DDL이나 기능 활성화 단계는 없다.
|
||||||
|
- 이미 전송 승인을 받은 provider 호출은 취소 이후에도 비용이 발생할 수 있다. 요청별 timeout은 절대적인 실시간 중단 보장이 아니다.
|
||||||
|
- 운영 DDL 실행·배포 및 커밋은 수행하지 않았다.
|
||||||
|
|
||||||
|
## 최종 gate 보정 후 HTTP 재검증
|
||||||
|
|
||||||
|
- 최초 전체 gate는 TR-19의 부분 승인 후 자동 갱신 결함 한 건으로 REJECT했다. 기존 payload의 명시된 필드만 재료화하는 경계를 추가하고 신규 전체 payload의 엄격한 완료 조건은 유지했다.
|
||||||
|
- 수정자는 실제 apply → 일반 원문 수정 → 일반 worker의 RED 3개를 확인했다. 신규 회귀 4개와 직접 영향 118개가 통과했고 lint도 통과했다. 자세한 범위는 `plan-task.md` P5-R1에 기록했다.
|
||||||
|
- 부모가 보정 후 위와 동일한 실제 HTTP 세 클래스 및 `bootJar` 명령을 직접 실행했다. 결과: BUILD SUCCESSFUL in 2m 7s, 종료 코드 0. 테스트와 jar는 보정된 최종 코드 기준이다.
|
||||||
|
- 최종 판정은 보정 delta와 현재 증거의 새 제한 검토 결과를 아래에 추가한다. 기존 전체 검토에서 통과한 다른 범위를 다시 확대 검토하지 않는다.
|
||||||
|
|
||||||
|
### 최종 판정 기록
|
||||||
|
|
||||||
|
- 새 Oracle의 delta 검토: APPROVE, HIGH. 기존 locale의 명시 필드만 갱신하고 신규/전체 payload의 엄격한 완료 조건은 유지함을 확인했다. CONTENT 게시와 job 완료의 동일 transaction, provider 부분 실패 및 비-CONTENT 분기 보존도 확인했다.
|
||||||
|
- 최신 HTTP XML 14+10+3=27개 오류/실패/skip 0, jar 존재를 검토자가 확인했다. 회귀 4+118와 lint의 근거는 P5-R1 기록으로 구분했다.
|
||||||
|
- 모든 로컬 차단 finding은 해결됐다. 위 QA 행의 재검증 대기 표기는 이 후속 판정으로 종결하며, 운영 검증 대기는 해결했다고 표시하지 않는다.
|
||||||
@@ -0,0 +1,80 @@
|
|||||||
|
-- Schema artifact for the implemented admin translation selection feature.
|
||||||
|
-- Do not execute against production without operator approval; no automatic DDL is performed by the application.
|
||||||
|
-- DEC-11: API and candidate worker register at startup without an activation flag.
|
||||||
|
-- Before new writers create any jobs, prepare all three tables and the language-aware unique index,
|
||||||
|
-- drain every legacy writer and in-flight job, then complete the separate old-index removal below.
|
||||||
|
CREATE TABLE content_translation_override (
|
||||||
|
id BIGINT NOT NULL AUTO_INCREMENT COMMENT '승인 override 식별자',
|
||||||
|
content_id BIGINT NOT NULL COMMENT '기존 콘텐츠 식별자, 삭제 cascade 없음',
|
||||||
|
locale VARCHAR(10) NOT NULL COMMENT '승인 대상 언어',
|
||||||
|
field_key VARCHAR(10) NOT NULL COMMENT 'TITLE, DETAIL, TAGS 중 승인 필드',
|
||||||
|
source_fingerprint VARCHAR(67) NOT NULL COMMENT '원본 언어와 정확한 필드 원문의 버전 포함 fingerprint',
|
||||||
|
approved_text TEXT NOT NULL COMMENT '관리자가 선택한 번역 문자열',
|
||||||
|
provenance TEXT NOT NULL COMMENT 'JSON 출처: requestId, candidateIds 목록, providers id/version 목록, approvedBy; 후보 FK 없음',
|
||||||
|
approved_at TIMESTAMP NOT NULL COMMENT 'UTC 초 정밀도로 한 번 정규화한 승인 시각',
|
||||||
|
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각',
|
||||||
|
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각',
|
||||||
|
PRIMARY KEY (id),
|
||||||
|
UNIQUE KEY uk_content_translation_override_field (content_id, locale, field_key)
|
||||||
|
) COMMENT='콘텐츠 언어별 필드 승인과 출처, 전역 번역 메모리와 독립';
|
||||||
|
|
||||||
|
-- Expand: keep uk_translation_job_resource_field_target_hash until every old writer and in-flight job is drained.
|
||||||
|
ALTER TABLE translation_job
|
||||||
|
ADD UNIQUE KEY uk_translation_job_resource_field_target_hash_language
|
||||||
|
(resource_type, resource_id, field_key, target_language, source_hash, source_language);
|
||||||
|
|
||||||
|
-- Contract (separate operator-approved step after legacy drain, required before new writers start work):
|
||||||
|
-- ALTER TABLE translation_job DROP INDEX uk_translation_job_resource_field_target_hash;
|
||||||
|
-- New writers always use exact source-language identity; there is no legacy-index compatibility mode.
|
||||||
|
-- After the first approval, rollback only to an override-aware application version. No DDL in this file was executed.
|
||||||
|
|
||||||
|
-- Request state, reviewed source/group snapshots, and the atomic apply receipt.
|
||||||
|
CREATE TABLE translation_selection_request (
|
||||||
|
id BIGINT NOT NULL AUTO_INCREMENT COMMENT '관리자 번역 선택 요청 식별자',
|
||||||
|
created_by BIGINT NOT NULL COMMENT '생성한 관리자 식별자',
|
||||||
|
client_request_id VARCHAR(36) NOT NULL COMMENT '관리자 범위 생성 멱등 UUID',
|
||||||
|
body_hash VARCHAR(64) NOT NULL COMMENT '버전 포함 canonical scope 본문 SHA-256',
|
||||||
|
scope TEXT NOT NULL COMMENT 'CONTENT 또는 SERIES 및 Long 식별자의 typed JSON',
|
||||||
|
status VARCHAR(24) NOT NULL COMMENT 'PREPARING REVIEW_REQUIRED READY_TO_GENERATE GENERATING READY APPLIED CANCELLED FAILED',
|
||||||
|
revision BIGINT NOT NULL COMMENT '관리자 의미 변경 revision, 최초 1',
|
||||||
|
snapshot LONGTEXT NOT NULL COMMENT '버전 JSON: 고정 활성 member IDs, 준비 원문, 확정 원문, reviewed 원문 그룹, provider ID/version manifest, 대상 언어, generation units',
|
||||||
|
preparation_attempt INT NOT NULL COMMENT '준비 실행 횟수, 최초 실행과 복구 1회까지',
|
||||||
|
preparation_lease_until TIMESTAMP NULL COMMENT '준비 소유권 UTC 초 만료 시각, lease 60초',
|
||||||
|
preparation_fence BIGINT NOT NULL COMMENT '오래된 실행의 게시와 갱신을 거부하는 단조 fence',
|
||||||
|
error_code VARCHAR(40) NULL COMMENT '준비 실패 안정 코드, 외부 예외 본문 없음',
|
||||||
|
accepted_generate_revision BIGINT NULL COMMENT '후속 후보 생성에서 수락한 revision',
|
||||||
|
apply_operation_id VARCHAR(36) NULL COMMENT '후속 one-shot 적용 멱등 UUID',
|
||||||
|
apply_body_hash VARCHAR(64) NULL COMMENT '후속 적용 canonical 본문 SHA-256',
|
||||||
|
apply_receipt LONGTEXT NULL COMMENT '후속 적용과 동일 transaction에 저장할 버전 JSON 영수증',
|
||||||
|
applied_at TIMESTAMP NULL COMMENT '후속 적용 UTC 초 확정 시각',
|
||||||
|
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각',
|
||||||
|
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각',
|
||||||
|
PRIMARY KEY (id),
|
||||||
|
UNIQUE KEY uk_translation_selection_creation (created_by, client_request_id),
|
||||||
|
KEY ix_translation_selection_prepare (status, preparation_lease_until, id)
|
||||||
|
) COMMENT='관리자 번역 선택 요청과 고정 원문 및 그룹 검토, 일반 번역 작업과 독립';
|
||||||
|
|
||||||
|
CREATE TABLE translation_candidate (
|
||||||
|
id BIGINT NOT NULL AUTO_INCREMENT COMMENT '제공자별 후보 식별자',
|
||||||
|
request_id BIGINT NOT NULL COMMENT '동결 manifest를 소유한 관리자 번역 요청',
|
||||||
|
unit_key VARCHAR(160) NOT NULL COMMENT '요청 안의 결정적 FIELD GROUP_COMMON TITLE_RESIDUAL 단위 키',
|
||||||
|
unit LONGTEXT NOT NULL COMMENT 'JSON: kind, sourceLanguage, 정확한 inputValues 순서, field/content/group 소유권',
|
||||||
|
provider_id VARCHAR(20) NOT NULL COMMENT '동결된 제공자 ID, fallback 대체 없음',
|
||||||
|
provider_version VARCHAR(80) NOT NULL COMMENT '동결된 제공자 버전, dispatch 시 일치 검사',
|
||||||
|
target_language VARCHAR(10) NOT NULL COMMENT 'source를 제외한 ko en ja 대상 언어',
|
||||||
|
status VARCHAR(16) NOT NULL COMMENT 'PENDING RUNNING SUCCEEDED FAILED DISCARDED',
|
||||||
|
translated_values LONGTEXT NULL COMMENT '입력 인덱스와 일치하는 JSON 번역 문자열 배열, 실패/폐기는 NULL',
|
||||||
|
failure_code VARCHAR(40) NULL COMMENT '안정 실패 코드, 외부 응답/예외 원문은 저장하지 않음',
|
||||||
|
attempt INT NOT NULL COMMENT '실제 provider 작업 claim 횟수, 최대 2, linked 결과는 별도 전송 없음',
|
||||||
|
lease_until TIMESTAMP NULL COMMENT '소유권 UTC 초 만료, 60초 lease, 만료 fence의 연장 금지',
|
||||||
|
fence BIGINT NOT NULL COMMENT 'claim/취소의 단조 fencing token',
|
||||||
|
linked_candidate_id BIGINT NULL COMMENT '같은 요청 제공자 언어 원문 배열의 선행 후보, 단위 소유권은 이 row에 보존',
|
||||||
|
terminal_at TIMESTAMP NULL COMMENT '성공 실패 폐기의 UTC 초 확정 시각',
|
||||||
|
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각',
|
||||||
|
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각',
|
||||||
|
PRIMARY KEY (id),
|
||||||
|
UNIQUE KEY uk_translation_candidate_unit (request_id, unit_key, provider_id, target_language),
|
||||||
|
KEY ix_translation_candidate_claim (request_id, status, lease_until, id),
|
||||||
|
CONSTRAINT fk_translation_candidate_request FOREIGN KEY (request_id)
|
||||||
|
REFERENCES translation_selection_request (id) ON DELETE RESTRICT
|
||||||
|
) COMMENT='관리자 요청별 fresh provider 후보와 durable 실행 결과, 게시 번역 및 전역 memory와 독립';
|
||||||
@@ -0,0 +1,124 @@
|
|||||||
|
# 관리자 배너 통합 테스트 컨텍스트 오류 구현 계획
|
||||||
|
|
||||||
|
| 문서 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 상태 | 구현 완료 |
|
||||||
|
| 작성일 | 2026-11-18 |
|
||||||
|
| 요구사항 기준 | [prd.md](prd.md) |
|
||||||
|
| API 기준 | 해당 없음 |
|
||||||
|
| 현재 Phase | Phase 1: 테스트 설정 스캔 범위 수정 |
|
||||||
|
| 현재 활성 Goal | 없음 |
|
||||||
|
|
||||||
|
## 목표
|
||||||
|
|
||||||
|
관리자 배너 통합 테스트가 테스트 전용 설정의 전역 스캔으로 인한 보안 advisor 중복 없이 실행되도록 한다.
|
||||||
|
|
||||||
|
## 현재 상태
|
||||||
|
|
||||||
|
| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|
||||||
|
|---:|---|---:|---|---|
|
||||||
|
| 1 | 완료 | `1/1` | 없음 | 지정 회귀 테스트 통과 |
|
||||||
|
|
||||||
|
## 범위
|
||||||
|
|
||||||
|
### 포함
|
||||||
|
|
||||||
|
- `SelectionCandidateProviderConfiguration`도 전역 스캔에서 제외하되, `TranslationCandidateTestSupport` 등의 명시적 `@Import`는 유지한다.
|
||||||
|
|
||||||
|
- `TranslationSelectionTestConfiguration`을 컴포넌트 스캔에서 제외되는 테스트 컴포넌트로 표시.
|
||||||
|
- 두 관리자 배너 테스트와 해당 설정을 사용하는 번역 선택 테스트 실행.
|
||||||
|
|
||||||
|
### 제외
|
||||||
|
|
||||||
|
- API 또는 애플리케이션 보안 설정 변경.
|
||||||
|
- 테스트 assertion 변경 및 전체 테스트 실행.
|
||||||
|
|
||||||
|
## 기술적 제약 및 검증
|
||||||
|
|
||||||
|
- Spring Boot 2.7.14 및 기존 Kotlin 테스트 설정 패턴을 따른다.
|
||||||
|
- 명시적으로 `TranslationSelectionTestConfiguration`을 지정하는 테스트의 설정 동작을 유지한다.
|
||||||
|
- 테스트는 `--tests`로 대상 클래스를 지정하며 전체 테스트는 사용자가 실행한다.
|
||||||
|
|
||||||
|
### Phase 1: 테스트 설정 스캔 범위 수정
|
||||||
|
|
||||||
|
**Phase 결과:** 테스트 전용 번역 설정이 전역 스캔에 참여하지 않으며, 배너 및 번역 선택 테스트가 통과한다.
|
||||||
|
|
||||||
|
**선행조건:** 제공된 구현 계획의 원인과 수정 지점을 확인한다.
|
||||||
|
|
||||||
|
**Phase 완료 조건:** `P1-T1` 및 `P1-GATE` 완료, 검증 기록 누적.
|
||||||
|
|
||||||
|
### 구현 항목
|
||||||
|
|
||||||
|
- [x] **Task 1.1: 테스트 설정을 컴포넌트 스캔에서 제외**
|
||||||
|
|
||||||
|
**Goal 실행 `P1-T1`:** 두 테스트 전용 설정을 컴포넌트 스캔에서 제외하면서 명시적 테스트 설정 사용은 유지한다.
|
||||||
|
|
||||||
|
- **시작 조건:** 두 관리자 배너 테스트가 컨텍스트 초기화 오류로 실패함을 확인.
|
||||||
|
- **완료 증거:** 최소 설정 변경 및 배너/번역 선택 테스트 통과.
|
||||||
|
- **범위 밖:** API와 보안 설정 변경, 테스트 assertion 완화.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionTestConfiguration.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationCandidateTestSupport.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/admin/chat/AdminChatBannerControllerIntegrationTest.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/admin/content/banner/AdminContentBannerControllerIntegrationTest.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionRequestIntegrationTest.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionWorkerIntegrationTest.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/application/TranslationSelectionCandidateLifecycleIntegrationTest.kt`
|
||||||
|
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/contenttranslation/adapter/in/web`의 `TranslationSelectionHttpTestSupport` 하위 테스트
|
||||||
|
|
||||||
|
**Interfaces:**
|
||||||
|
|
||||||
|
- Consumes: Spring Boot의 `@TestComponent` 스캔 제외 동작.
|
||||||
|
- Produces: 앱 전체 `@SpringBootTest`에는 포함되지 않고 명시적 `classes = [TranslationSelectionTestConfiguration::class]`에서는 계속 로드되는 설정.
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 두 관리자 배너 통합 테스트를 재현 테스트로 사용한다. 추가 테스트 없이 실제 테스트의 컨텍스트 로딩 실패를 확인했다.
|
||||||
|
- [x] **RED 확인:** `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.admin.chat.AdminChatBannerControllerIntegrationTest' --tests 'kr.co.vividnext.sodalive.admin.content.banner.AdminContentBannerControllerIntegrationTest'` 실행 결과 73개가 `BeanDefinitionOverrideException`을 포함한 컨텍스트 초기화 실패로 종료했다.
|
||||||
|
- [x] **GREEN:** `TranslationSelectionTestConfiguration`에 `@TestComponent`를 추가한다.
|
||||||
|
- [x] **GREEN:** `SelectionCandidateProviderConfiguration`에도 `@TestComponent`를 추가하고, 명시적 `@Import` 사용을 유지한다.
|
||||||
|
- [x] **GREEN 확인:** 위 배너 테스트와 설정을 사용하는 번역 선택 테스트를 실행해 통과를 확인한다.
|
||||||
|
- [x] **REFACTOR:** 변경 범위의 직접 영향 회귀 테스트를 실행하고 결과를 아래 Progress에 기록한다.
|
||||||
|
|
||||||
|
### 완료 조건
|
||||||
|
|
||||||
|
- [x] `P1-T1`의 실행 체크박스와 완료 증거가 충족됐다.
|
||||||
|
- [x] 전역 앱 컨텍스트와 명시적 번역 테스트 컨텍스트의 설정 경계가 검증됐다.
|
||||||
|
|
||||||
|
### 검증 방법
|
||||||
|
|
||||||
|
#### Phase 1 Gate
|
||||||
|
|
||||||
|
**Goal 실행 `P1-GATE`:** 배너 테스트와 테스트 전용 설정을 사용하는 번역 선택 회귀 범위를 검증한다.
|
||||||
|
|
||||||
|
- **Objective:** 전역 스캔 제외 및 명시적 테스트 설정 사용이 모두 확인된 상태로 작업을 마친다.
|
||||||
|
- **시작 조건:** `P1-T1` 완료.
|
||||||
|
- **완료 증거:** 두 배너 테스트와 설정 사용 번역 테스트 통과, 검증 결과 기록.
|
||||||
|
- **범위 밖:** 전체 테스트 실행.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.admin.chat.AdminChatBannerControllerIntegrationTest' --tests 'kr.co.vividnext.sodalive.admin.content.banner.AdminContentBannerControllerIntegrationTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRequestIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionWorkerIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionContentsHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.TranslationSelectionActivationHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionApplyHttpIntegrationTest' --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.adapter.in.web.AdminTranslationSelectionReceiptHttpIntegrationTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionCandidateLifecycleIntegrationTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Expected:** 모든 지정 테스트 성공. 전체 테스트는 사용자가 `./gradlew test`로 실행한다.
|
||||||
|
|
||||||
|
## Progress
|
||||||
|
|
||||||
|
- RED: 배너 테스트 73개가 공통으로 컨텍스트 초기화 실패. 구현 전 재현.
|
||||||
|
- GREEN: `TranslationSelectionTestConfiguration`에 `@TestComponent`를 추가. 실행 후 결과를 이어서 기록한다.
|
||||||
|
|
||||||
|
### `P1-T1` 1차 실행 — 2026-11-18
|
||||||
|
|
||||||
|
- 상태: 완료
|
||||||
|
- 무엇을: 두 테스트 전용 설정(`TranslationSelectionTestConfiguration`, `SelectionCandidateProviderConfiguration`)에 `@TestComponent` 추가.
|
||||||
|
- 왜: 1차 수정 후 재실행 시 `metaDataSourceAdvisor` 충돌은 사라졌지만, 전역 스캔된 `SelectionCandidateProviderConfiguration`의 `SelectionPapagoProvider`가 운영 `PapagoTranslationService`와 `PAPAGO` ID가 겹쳐 `LanguageProviderProperties.kt:18`의 `duplicate registered language provider name` 예외가 발생했다.
|
||||||
|
- 어떻게:
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.admin.chat.AdminChatBannerControllerIntegrationTest' --tests 'kr.co.vividnext.sodalive.admin.content.banner.AdminContentBannerControllerIntegrationTest'` (1차 수정만 적용) — 실패, provider ID 중복 예외 및 600초 timeout.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.admin.chat.AdminChatBannerControllerIntegrationTest'` — 성공.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.admin.content.banner.AdminContentBannerControllerIntegrationTest'` — 성공.
|
||||||
|
- Phase 1 Gate의 번역 선택 회귀 6개 클래스 명령 — 성공.
|
||||||
|
- `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionCandidateLifecycleIntegrationTest'` — 성공.
|
||||||
|
- `git diff --check` — 공백 오류 없음.
|
||||||
|
- 남은 항목: 전체 테스트는 미실행. 사용자가 `./gradlew test`로 직접 실행한다.
|
||||||
@@ -0,0 +1,49 @@
|
|||||||
|
# 관리자 배너 통합 테스트 컨텍스트 오류 PRD
|
||||||
|
|
||||||
|
## 문서 정보
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 문서 상태 | 구현 완료 |
|
||||||
|
| 작성일 | 2026-11-18 |
|
||||||
|
| 최종 수정일 | 2026-11-18 |
|
||||||
|
| 대상 제품 | 관리자 배너 통합 테스트 |
|
||||||
|
| 작성자·결정권자 | 사용자 요청 및 제공된 구현 계획 |
|
||||||
|
| 관련 API Contract | 해당 없음 (공개 API 변경 없음) |
|
||||||
|
| 관련 구현 계획 | [plan-task.md](plan-task.md) |
|
||||||
|
| 관련 review | 없음 |
|
||||||
|
|
||||||
|
### 요구사항 상태
|
||||||
|
|
||||||
|
| ID | 상태 | 요구사항 | 구현 처리 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| `REQ-001` | 확정 | 테스트 전용 번역 설정은 앱의 전역 컴포넌트 스캔에서 제외하되, 해당 설정을 지정하는 번역 테스트에서는 계속 사용할 수 있어야 한다. | `plan-task.md`의 `P1-T1` 및 테스트 증거로 추적 |
|
||||||
|
|
||||||
|
## 1. Overview
|
||||||
|
|
||||||
|
관리자 채팅 배너와 콘텐츠 배너 통합 테스트는 테스트 전용 설정들이 전역 컴포넌트 스캔에 참여해 Spring 컨텍스트를 생성하지 못한다. 테스트 전용 설정들을 전역 스캔에서 제외한다.
|
||||||
|
|
||||||
|
## 2. Problem Statement
|
||||||
|
|
||||||
|
- `SelectionCandidateProviderConfiguration`도 테스트 클래스패스에서 전역 스캔되어 `SelectionPapagoProvider`를 등록하고, 운영 `PAPAGO` provider와 ID가 중복된다.
|
||||||
|
|
||||||
|
- 두 배너 통합 테스트는 각 테스트 실행에서 Spring 컨텍스트 초기화 중 `BeanDefinitionOverrideException`으로 실패한다.
|
||||||
|
- 테스트 전용 `TranslationSelectionTestConfiguration`이 앱 패키지 아래의 `@Configuration`으로 탐색되어 애플리케이션 보안 설정과 중복 등록된다.
|
||||||
|
- 해결 여부는 두 배너 테스트와 해당 설정을 명시적으로 사용하는 번역 선택 테스트의 통과로 판단한다.
|
||||||
|
|
||||||
|
## 3. Goals
|
||||||
|
|
||||||
|
- 테스트 전용 설정을 전체 애플리케이션의 컴포넌트 스캔에서 제외한다.
|
||||||
|
- 번역 선택 테스트가 해당 설정을 직접 지정할 때는 기존 테스트 구성을 계속 사용한다.
|
||||||
|
- 관리자 배너 테스트와 영향받는 번역 선택 테스트를 실행해 결과를 확인한다.
|
||||||
|
|
||||||
|
## 4. Non-Goals
|
||||||
|
|
||||||
|
- 공개 API, 보안 정책, 애플리케이션 런타임 설정 변경.
|
||||||
|
- 관리자 배너 테스트의 assertion 또는 테스트 범위 완화.
|
||||||
|
|
||||||
|
## 5. 수용 기준
|
||||||
|
|
||||||
|
- `AdminChatBannerControllerIntegrationTest`와 `AdminContentBannerControllerIntegrationTest`가 통과한다.
|
||||||
|
- `TranslationSelectionTestConfiguration`을 사용하는 지정 테스트가 통과한다.
|
||||||
|
- 수정은 테스트 설정의 스캔 제외에 한정한다.
|
||||||
@@ -0,0 +1,308 @@
|
|||||||
|
# 번역 및 관리자 오디오 테스트 수정 계획
|
||||||
|
|
||||||
|
- 작성일: 2026-11-18
|
||||||
|
- 기준: [prd.md](prd.md)
|
||||||
|
- 상태: P8 fork300 동일 힙 focused 비교·lint·리뷰 승인·정리 완료. 실제 Jenkins와 전체 suite 재실행은 미수행.
|
||||||
|
- 활성 Goal: 없음
|
||||||
|
|
||||||
|
## P1-T1: 실패 원인 재현과 최소 테스트 수정
|
||||||
|
- 시작 조건: 사용자 지정 테스트와 운영 생성자/호출 경로를 읽는다.
|
||||||
|
- 완료 증거: 재현 오류, 테스트 전용 diff, 네 클래스 통과.
|
||||||
|
- 범위 밖: 운영 로직 변경 및 기존 assertion 약화.
|
||||||
|
- 대상 파일:
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderSpringConfigurationTest.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/OriginalWorkReadRetryTest.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentControllerTest.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentOwnershipTest.kt`
|
||||||
|
- TDD 예외: 신규 운영 동작이 아닌 기존 테스트 fixture/config 수정이다. 기존 실패 테스트를 재현 증거로 재사용한다.
|
||||||
|
- [x] 기존 테스트 의도와 운영 의존성 확인.
|
||||||
|
- [x] 실패 오류를 실행으로 확정.
|
||||||
|
- [x] 최소 테스트 설정/fixture 수정.
|
||||||
|
- [x] 같은 테스트 통과 확인.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests '*LanguageProviderSpringConfigurationTest' --tests '*OriginalWorkReadRetryTest' --tests '*AiCharacterAdminAudioContentControllerTest' --tests '*AiCharacterAdminAudioContentOwnershipTest' --console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
## P1-GATE: 회귀와 변경 범위 확인
|
||||||
|
- 시작 조건: P1-T1 통과.
|
||||||
|
- 완료 증거: 직접 관련 회귀, 변경 파일 lint/컴파일, 리뷰, 임시 자원 정리.
|
||||||
|
- [x] 번역 provider/read retry 및 관리자 오디오 직접 관련 회귀 통과.
|
||||||
|
- [x] 변경 범위와 기존 assertion 보존 리뷰.
|
||||||
|
- [x] 임시 자원 정리 및 결과 기록.
|
||||||
|
- 전체 테스트는 사용자 실행: `./gradlew test`. focused 성공을 전체 성공으로 보고하지 않는다.
|
||||||
|
|
||||||
|
## 검증 기록
|
||||||
|
- 최초 focused 실행: LanguageProviderSpringConfigurationTest startupFailure 6건, OriginalWorkReadRetryTest `single()` IllegalArgumentException 1건 확인. 200초 명령 제한으로 종료되어 관리자 테스트 및 XML 생성은 미완료.
|
||||||
|
- 수정 전 완전 재현: 같은 네 클래스, 3분 27초, exit 1. 총 77개 중 71개 실패, skip 0. LanguageProvider 7개 중 6개는 `PlatformTransactionManager` 빈 누락, OriginalWork 6개 중 1개는 `List has more than one element`, 관리자 Controller 30개와 Ownership 34개는 `CreatorAdminContentService.applicationEventPublisher` 필드가 없어 준비 단계 실패.
|
||||||
|
- 최소 수정: provider context에 기존 단위 테스트와 같은 transaction manager mock을 등록한다. 원작 테스트는 기존 ja FAILED 작업의 모든 상태 보존을 유지하면서 새 ko→en PENDING 작업의 정확한 개수·식별자·원문·초기 상태도 검증한다. 관리자 테스트는 실제 이벤트 소유 서비스와 현재 번역 무효화 경계를 검증한다.
|
||||||
|
- 관리자 두 테스트: 삭제된 CreatorAdminContentService publisher reflection만 제거하고, 실제 ContentTranslationSourceInvalidationService를 SpyBean으로 관찰해 거부 요청의 무호출을 검증한다. 정상 서비스 동작을 stub하지 않는다.
|
||||||
|
- 정적 검사: 변경 diff 공백 검사 통과. Kotlin LSP는 미설치이며 기존 설치 거부 설정 때문에 실행 불가. Gradle compileTestKotlin으로 타입/컴파일 검증을 수행한다.
|
||||||
|
- 수정 후 focused: 위 네 클래스 명령 exit 0, 6분 25초. 77/77 통과(LanguageProvider 7, OriginalWork 6, Controller 30, Ownership 34), failures/errors/skipped 모두 0. `compileTestKotlin` 실제 실행 성공, 운영 컴파일 UP-TO-DATE. 부모가 네 XML 헤더를 직접 확인했다. 보고서: `build/reports/tests/test/index.html`, XML: `build/test-results/test/`.
|
||||||
|
- 확장 회귀: 아래 명령은 `:test` 진입 후 600초 제한 초과. 최종 종료 코드·건수·새 XML이 없어 통과/실패를 판정하지 않는다. 컴파일은 UP-TO-DATE이며 새 assertion 실패는 수집되지 않았다. 전체 테스트는 미실행.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --tests '*LanguageProviderPropertiesTest' --tests '*TranslationCoordinatorTest' --tests '*LanguageDetectionCacheServiceTest' --tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.content.*' --console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
- 소유 검증 자원: 재현·검증 자식의 전용 임시 디렉터리 삭제 영수증 확인. 작업 시작 전부터 있던 사용자 worker/daemon은 변경하지 않았다. 부모 초기 임시 루트는 정리 확인 시 이미 존재하지 않았다.
|
||||||
|
- 최종 독립 리뷰: APPROVE, 차단 사유 없음. 네 테스트의 전체 변경 hunk를 운영 계약과 대조하여 assertion 보존과 실제 invalidation spy 동작을 확인했다. 기존 staged 변경은 보존했고, 운영 코드 변경 및 테스트 삭제/skip은 없다.
|
||||||
|
- 임시 작업 노트 삭제 완료. 추가 운영·테스트 코드 변경 없이 종료한다. P1-T1은 완료이고 확장 회귀 통과 체크는 미확인 상태로 남긴다. 전체 검증은 사용자가 `./gradlew test`로 수행한다.
|
||||||
|
|
||||||
|
## 재개 검증 (2026-11-18)
|
||||||
|
- 사용자가 미완료 지점부터 재개를 요청했다. 기존 77개 통과·리뷰 결과를 유지하고 전체 테스트로 남은 확장 회귀와 suite 결과를 함께 확인한다. 이번 실행은 재개 요청에 따른 명시적 검증이며 평상시 자동 전체 실행 규칙을 변경하지 않는다.
|
||||||
|
- 추가 코드 변경 없이 `./gradlew --no-daemon test --console=plain`을 한 번 실행한다. 이전의 600초 실행 제한 대신 긴 실행 시간을 허용한다. 실패하면 오류와 실제 종료 상태를 기록하고 운영 로직은 변경하지 않는다.
|
||||||
|
- [x] 전체 테스트 XML 집계 확인. 최종 원본 종료 코드 소실은 아래 검증 한계로 기록.
|
||||||
|
- [x] 실행 소유 임시 자원 정리 및 결과 보고.
|
||||||
|
|
||||||
|
### 지연 원인 확인 및 사용자 승인 조치
|
||||||
|
- 전체 실행 약 47분 시점에 `ps`, `jstat -gcutil`, 현재 worker의 `jstack`을 확인했다. 작업 전부터 있던 worker PID 97636은 약 2시간 48분 실행, CPU 1046.6%, Old 99.98%, Full GC 2207회·8588.794초, 총 GC 8652.617초였다. 기존 프로세스가 GC를 반복하며 자원을 점유했다.
|
||||||
|
- 현재 전체 검증 worker PID 21732는 해당 시점 CPU 141.9%, Old 97.77%, 총 GC 71.327초였다. thread dump는 Spring context 초기화의 클래스 파일 탐색을 실행 중이었다. 전체 지연의 모든 원인을 확정한 것은 아니며 두 프로세스의 자원 경합은 관찰됐다.
|
||||||
|
- 사용자가 기존 worker 종료를 명시적으로 승인했다. PID 97636에 TERM을 보냈으나 잔존하여 KILL로 종료했다. 이후 `ps`에서 PID 97636 부재와 현재 검증 PID 21732 생존을 확인했다. IDE와 현재 검증 프로세스는 유지했다.
|
||||||
|
- 전체 실행은 3,600,000ms 제한으로 중단됐다. Gradle 자체 종료 코드와 신규 XML은 없으므로 suite 결과는 미확정이다. 실행 소유 PID 21675/21732는 정리됐고 전용 임시 루트 `verify-suite.USElvm`도 삭제 확인했다. 제한 시간만 늘리는 반복 대신 context 캐시와 마지막 실행 위치를 조사한다.
|
||||||
|
|
||||||
|
## P2: 승인된 테스트 자원 수명 개선
|
||||||
|
- 시작 조건: 사용자 `진행한다` 승인. 기존 수정과 사용자 staged 변경은 보존한다.
|
||||||
|
- 관측: 별도 IDE worker 31728도 Old 99.97%, 약 42초간 Full GC 11회·GC 시간 약 43초 증가. GC 과부하는 재현됐으나 retained object별 기여는 아직 미확인이다.
|
||||||
|
- 수정 경로: `build.gradle.kts`, `src/test/resources/application.yml`, 조사로 확정한 test datasource override, `src/test/kotlin/kr/co/vividnext/sodalive/support/H2DatabaseLifecycleTest.kt`, `docs/agent-guides/테스트스타일.md`, `docs/agent-guides/실행명령어.md`.
|
||||||
|
- 범위 밖: 운영 코드 변경, 무관한 테스트 재작성, 기존 staged 파일 수정, commit/push.
|
||||||
|
|
||||||
|
### P2-T1: H2 DB 수명 검증과 정리
|
||||||
|
- [x] 실제 test 설정을 읽는 lifecycle 테스트로 pool 종료 후 DB 잔존 실패 재현.
|
||||||
|
- [x] H2 마지막 연결 종료 정책을 적용하고, 별도 override의 의존성을 확인해 필요한 것만 정리.
|
||||||
|
- [x] 같은 lifecycle 테스트 및 직접 관련 연결/동시성 회귀 통과.
|
||||||
|
|
||||||
|
### P2-T2: context 상한과 진행 진단
|
||||||
|
- [x] 테스트 클래스 진행과 제한된 크기의 GC 로그를 확보.
|
||||||
|
- [x] test worker의 Spring context 캐시 상한 4개를 초기 실험값으로 적용하고 실제 캐시/GC와 실행 결과 확인.
|
||||||
|
- [x] 필요 시에만 worker 교체 주기를 별도 비교. 근거 없이 기본 적용하지 않는다.
|
||||||
|
|
||||||
|
### P2-GATE: 전체 실행과 회귀 방지
|
||||||
|
- [x] 전체 테스트 실행 결과와 GC 로그 비교. 진행 종료와 통과 여부를 각각 기록.
|
||||||
|
- [x] 신규 테스트 자원 관리 규칙과 IDE Gradle runner 사용법 문서화.
|
||||||
|
- [x] 변경 리뷰 및 실행 소유 자원 정리.
|
||||||
|
- 기존 IDE worker 31728이 실행 중이므로 새로운 테스트 실행 전 사용자에게 종료 승인을 받고 동일 build 출력 경합을 제거한다.
|
||||||
|
- 사용자가 실행 중인 worker 정리를 승인했다. PID 31728은 종료 전 57분 실행, CPU 1102.3%, Old 99.98%, Full GC 697회·1741.342초였다. TERM 후에도 잔존하여 KILL로 종료했고 `jps -l`에서 테스트 worker 부재를 확인했다. IDE와 Gradle daemon은 유지했다.
|
||||||
|
- 먼저 진단만 추가: `build.gradle.kts`에서 클래스 시작 로그, PID별 GC 로그(`build/test-gc/test/gc-PID.log`, 파일당 10MB·회전 3개), 명시적 단일 test worker를 설정했다. H2/cache 정책은 아직 변경하지 않았다. `./gradlew --no-daemon help --console=plain` exit 0으로 Gradle Kotlin DSL 확인(20초).
|
||||||
|
- H2 lifecycle RED: `./gradlew --no-daemon test --tests '*H2DatabaseLifecycleTest' --console=plain`, exit 1, 29초. 풀 종료 후 `IFEXISTS=TRUE` 재접속이 성공하여 `Expected java.sql.SQLException to be thrown, but nothing was thrown.` 실패. 연결 간 marker 데이터 공유와 pool 종료 assertion은 통과했다. 기존 YAML의 DB 잔존을 독립적으로 재현했다.
|
||||||
|
- 1차 수정: 기본 YAML의 `DB_CLOSE_DELAY=-1`만 `0`으로 변경한다. DB 고유 이름·나머지 옵션·운영 설정은 유지한다. 개별 override 29곳은 별도 단계로 검증한다.
|
||||||
|
- H2 기본 설정 GREEN: `./gradlew --no-daemon test --tests '*H2DatabaseLifecycleTest' --tests '*AiCharacterAdminAudioContentControllerTest' --tests '*AiCharacterAdminAudioContentOwnershipTest' --console=plain`, exit 0, 약 1분, 65개 통과. context cache는 이 실행까지 기본 32를 유지했다. pool 종료 후 실제 DB 부재와 기존 DB/HTTP 동작을 확인했다.
|
||||||
|
- 다음 단계: dedicated Hikari pool 소유이며 종료 후 재사용 근거가 없는 개별 테스트 override 29곳의 지연값만 0으로 바꾼다. 별도로 context cache 상한 4를 test worker systemProperty로 설정하고 context 재생성/동시성 회귀 및 전체 실행으로 확인한다. `forkEvery`는 아직 도입하지 않는다.
|
||||||
|
- 개별 override 29곳은 옵션 값만 변경했고 부모가 전체 diff를 확인했다. 연결 재오픈으로 DB 보존을 요구하는 사용처는 발견되지 않았다. `git diff --check` 통과.
|
||||||
|
- `./gradlew --no-daemon ktlintKotlinScriptCheck ktlintTestSourceSetCheck --console=plain` exit 0, 54초. 최초 Kotlin DSL closure 줄바꿈 오류 2건은 수정 후 통과했다.
|
||||||
|
- `./gradlew --no-daemon test --tests '*H2DatabaseLifecycleTest' --tests '*ContentSeriesBannerServiceIntegrationTest' --tests '*ServiceNoticeQueryRepositoryTest' --tests '*ServiceNoticeConcurrencyIntegrationTest' --console=plain` exit 0, 2분 16초. XML 집계 20/20 통과(4+9+6+1), failures/errors/skipped 모두 0. context 매 테스트 재생성, 실제 DB 잠금·동시성, JPA 조회와 DB 수명을 검증했다.
|
||||||
|
- 승인된 전체 실행: `./gradlew --no-daemon test --console=plain` 진행 중. 결과와 GC 효과는 아직 확정하지 않는다.
|
||||||
|
- 전체 실행 결과: exit 1, 17분 47.442초, 신규 XML 398개/3,752 tests/6 failures/0 skipped/0 errors. 실패는 OriginalWorkReadRetryTest 6개로 모두 H2 `TRANSLATION_JOB` 또는 `ORIGINAL_WORK_TRANSLATION` 테이블 부재였다. 캐시 축소 시 공유 고정 DB 이름과 context 종료의 충돌 여부를 추적한다.
|
||||||
|
- 전체 실행 GC(PID 55797): Full GC 2회/3.719242초, GC pause 총 1,359회/24.221353초. 마지막 GC 후 4,085MiB, 최대 GC 후 4,089MiB로 4,096MiB 한도 근접. 완주는 확인했지만 테스트 증가에 대한 여유가 충분하지 않아 worker 주기적 교체 실험이 필요하다. 어떤 객체가 잔존 힙 대부분을 보유하는지는 아직 미확인이다.
|
||||||
|
- 1차 변경 리뷰 APPROVE. 이후 발견한 suite 실패와 worker 정책 변경은 별도 delta 리뷰 대상으로 남긴다.
|
||||||
|
|
||||||
|
### P2-R1: suite에서 드러난 DB 격리와 누적 메모리 보호
|
||||||
|
- [x] MetadataReadRetryTestSupport의 고정 DB 이름 충돌을 runtime chronology로 확인하고 focused 재현/수정.
|
||||||
|
- [x] worker 50클래스 단위 교체를 초기 실험값으로 적용하여 JVM별 누적을 제한하고 GC 로그로 효과 확인.
|
||||||
|
- [x] 전체 재검증, 추가 변경 delta 리뷰와 최종 기록.
|
||||||
|
- worker 교체는 잔존 객체의 root cause 수정으로 주장하지 않으며, 프로세스 수명에 의한 보호 장치로 구분한다.
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataReadRetryContextIsolationTest.kt`에서 실제 원작·커뮤니티 test context를 함께 로드하고, 커뮤니티 context 종료 후 원작 repository의 저장 작업 보존을 검증한다. CreatorCommunityReadRetryTest는 추가 `@Import`와 `@MockBean` 때문에 별도 context를 만들지만 공통 support의 고정 DB 이름을 공유한다.
|
||||||
|
- 번역 패키지 단독 실행은 1분 3초에 통과했지만, Gradle이 직전 실패 OriginalWork 클래스를 맨 먼저 실행했다. 따라서 이 성공만으로 전체 실행 순서에서 발생한 격리 오류가 해결됐다고 판단하지 않는다. 새 회귀 테스트는 순서에 의존하지 않고 context 충돌을 직접 재현한다.
|
||||||
|
- 격리 RED: `./gradlew --no-daemon test --tests '*MetadataReadRetryContextIsolationTest' --console=plain`, exit 1, 50초. 커뮤니티 context를 닫은 뒤 원작 repository 조회가 `InvalidDataAccessResourceUsageException → SQLGrammarException → JdbcSQLSyntaxErrorException`로 실패했다. 실제 두 context 종료 경계에서 테이블 손실을 재현했다.
|
||||||
|
- 최소 수정은 `MetadataReadRetryTestSupport.kt`의 DB 이름에 `\${random.uuid}`를 붙이는 것이다. 기존 상속 context 구성과 transaction/fixture/assertion은 유지한다.
|
||||||
|
- 격리 GREEN: `./gradlew --no-daemon test --tests '*MetadataReadRetryContextIsolationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --console=plain`, exit 0, 1분 24초. 재현 테스트와 관련 6개 클래스가 함께 통과했다. 이 실행까지 `forkEvery`를 적용하지 않아 프로세스 분리로 격리 문제를 감추지 않았다.
|
||||||
|
- `forkEvery = 50`을 이제 적용한다. 한 JVM을 무제한 재사용한 실행의 마지막 GC 후 힙 4,085MiB를 근거로 누적 기간을 제한하는 초기 실험값이다. 전체 실행에서 실제 PID 교체·최대 GC 후 힙·완료 시간을 확인하고 유지 여부를 판단한다.
|
||||||
|
- 격리 수정 후 lint 재검증은 단독 명령 120초 제한에 걸렸다. `jps -l`에서 소유 프로세스가 남지 않았음을 확인했다. 다음 단일 명령에서 lint와 전체 suite를 함께 검증한다: `./gradlew --no-daemon ktlintKotlinScriptCheck ktlintTestSourceSetCheck test --console=plain`.
|
||||||
|
|
||||||
|
### 최종 산출물 확인
|
||||||
|
- 최종 명령의 background session 결과가 연결 복구 후 사라져 원본 종료 코드와 전체 wall-clock 시간은 복구하지 못했다. 이미 완료된 테스트를 다시 실행하지 않고 남아 있는 HTML/XML/GC 산출물을 직접 대조했다.
|
||||||
|
- `build/reports/tests/test/index.html`: 3,753 tests, 0 failures, 0 ignored, 100% successful. XML 399개 독립 집계도 3,753 tests/0 failures/0 errors/0 skipped. 기존 실패 OriginalWork 6개와 새 DB 수명·context 격리 테스트 모두 전체 실행에서 통과했다.
|
||||||
|
- HTML의 `2m41.62s`는 테스트 duration 합계이며 context 초기화 등을 포함한 전체 명령 시간으로 보고하지 않는다.
|
||||||
|
- 최종 Kotlin script/test source lint 보고서 둘 다 위반 항목 0개. 최종 command exit 원본은 없으며, 이전 단계의 lint exit 0 기록과 구분한다. `git diff --check`도 통과했다.
|
||||||
|
- 최종 worker PID: 62402, 62915, 63240, 63535, 63748, 63967, 64349, 64724, 64965, 65131, 65315, 65472, 65570. 13개 GC 로그 모두 `heap,exit`가 있고 Full GC 0회다.
|
||||||
|
- PID별 최대 GC 후 힙(MiB): 1130, 886, 1257, 722, 861, 1392, 1464, 1112, 540, 630, 730, 379, 720. 전체 최대 1,464MiB로 교체 전 실행의 4,089MiB보다 낮다. heap 한도 4,096MiB는 증가시키지 않았다. GC 전후 힙 값이 있는 pause 행 합계는 18.963초이며, 이 값은 heap 전후 값 없는 pause를 포함한 전체 GC 시간과 구분한다.
|
||||||
|
- worker 50클래스 교체는 관측된 누적을 제한하는 보호 장치로 유지한다. 모든 향후 단일 테스트의 메모리/무한 대기까지 보장하거나, 잔존 객체의 근본 원인이 모두 밝혀졌다고 주장하지 않는다.
|
||||||
|
- 현재 `jps -l`에 테스트 worker가 없고 작업용 승인 temp parent 디렉터리는 비어 있다. 작업 노트와 소유 temp root는 삭제했다. XML/HTML과 GC 로그는 검증 근거로 build 아래 보존한다.
|
||||||
|
- 최종 delta 리뷰 재확인: APPROVE, 차단 사유 없음. UUID DB 격리, 실제 두 context 생성·종료 회귀와 finally 정리, worker 50클래스 교체와 캐시 4개 정책을 확인했다. 고정 DB RED/UUID GREEN을 fork 도입 전에 증명한 점을 확인했다. 최종 suite 및 GC 결과와 함께 완료 처리하며 추가 테스트 재실행은 하지 않는다.
|
||||||
|
- 운영 코드 변경, 테스트 삭제/skip/검증 완화, commit/push는 없다. 기존 사용자 staged 변경은 보존했다. Kotlin LSP는 기존 미설치 상태여서 사용하지 않았으며 실제 Gradle 테스트 컴파일·실행과 lint 산출물로 검증했다.
|
||||||
|
|
||||||
|
## P3: 승인된 SQL 출력 및 context 재사용 최적화 (2026-11-19)
|
||||||
|
- 관측 기준: 최종 전체 worker 구간 1,399.703초, Spring 시작 182회. 중복 제거한 실제 Starting→Started 구간 합계 1,158.593초. stdout 227,792,396 bytes 중 SQL 블록 추정 179,790,139 bytes. 세 클래스 추가 초기화 14회/81.541초는 절감 후보이며 확정 절감량이 아니다.
|
||||||
|
- 수정 경로: `src/test/resources/application.yml`, `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/content/all/adapter/in/web/MainContentAllEndToEndTest.kt`, `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/content/overview/adapter/in/web/ContentOverviewEndToEndTest.kt`, `src/test/kotlin/kr/co/vividnext/sodalive/content/series/main/banner/ContentSeriesBannerServiceIntegrationTest.kt`.
|
||||||
|
- 범위 밖: 운영 코드, 기존 assertion 삭제/완화, 테스트 전체 Transactional 적용, 캐시/worker/heap 조정, 기존 사용자 staged 변경, commit/push.
|
||||||
|
|
||||||
|
### P3-T1: SQL 출력 비교
|
||||||
|
- [x] 변경 전 동일 focused 4클래스 실행으로 GREEN baseline과 시간/stdout/context 횟수 기록.
|
||||||
|
- [x] SQL 출력과 포맷만 끈 뒤 동일 명령으로 통과와 실제 출력 감소 확인.
|
||||||
|
|
||||||
|
### P3-T2: context 재사용과 상태 정리
|
||||||
|
- [x] 세 클래스의 DB FK/직접·간접 side effect를 확인한다.
|
||||||
|
- [x] 메서드별 context 재생성을 해당 클래스의 fixture 정리로 바꾼다. HTTP/서비스 호출의 트랜잭션 경계와 OSIV off는 그대로 둔다.
|
||||||
|
- [x] 같은 focused 실행으로 25개 기존 테스트 통과, 시작 횟수 감소, 누적 데이터 없음과 성능 비교를 확인한다.
|
||||||
|
- [x] 정리 실패가 기존 assertion에서 드러나는지 검토하고 관련 회귀·lint·단일 게이트 리뷰를 수행한다.
|
||||||
|
|
||||||
|
### 검증 명령
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --tests '*MainContentAllEndToEndTest' --tests '*ContentOverviewEndToEndTest' --tests '*ContentSeriesBannerServiceIntegrationTest' --tests '*AdminTranslationSelectionContentsHttpIntegrationTest' --console=plain
|
||||||
|
```
|
||||||
|
- SQL 집중 클래스는 설정 영향 측정 대상으로만 실행하며 소스는 수정하지 않는다.
|
||||||
|
- 전체 테스트는 이번 최적화의 자동 검증으로 반복하지 않는다. 직접 영향 기능별 검증을 수행하고 전체 재실행 여부는 최종 보고에 구분한다.
|
||||||
|
- [x] 비교 기록과 소유 임시 자원 정리 완료.
|
||||||
|
|
||||||
|
### P3 측정 기록
|
||||||
|
- 변경 전 baseline: 위 focused 명령 exit 0, shell wall 526초(Gradle 8분 45초), 25 tests/0 failures. stdout 104,015,806 bytes, `Hibernate:` 140,318회, Spring 시작 18회/시작 로그 시간 합계 376.851초, testcase 시간 합계 66.206초.
|
||||||
|
- SQL-only 변경은 공통 YAML의 `hibernate.show_sql`, `hibernate.format_sql` 두 값을 false로 바꾼다. 테스트 소스와 worker/cache 설정은 이 단계에서 변경하지 않는다. 다음 실행에서 실제 SQL 출력이 사라졌는지 확인한다.
|
||||||
|
- SQL-only 결과: 동일 명령 exit 0, shell wall 373초(Gradle 6분 12초), 25/25 통과. stdout 4,655,102 bytes, `Hibernate:` 0회, Spring 시작 18회/288.724초, testcase 합계 28.514초. 출력 감소를 실제로 확인했다. 시간은 같은 환경 연속 실행의 단일 관측이며 캐시/부하 변동을 배제한 보장값으로 해석하지 않는다.
|
||||||
|
- context 변경: 세 클래스의 method-level DirtiesContext를 제거하고 AfterEach에서 각 전용 DB의 fixture 테이블만 FK 자식→부모 순서로 삭제한다. `series_published_days_of_week`는 series보다 먼저 제거한다. overview 응답에 items 정확히 1개 assertion을 추가해 이전 fixture 노출도 감지한다. 기존 HTTP/서비스 호출은 테스트 transaction 밖에 유지한다.
|
||||||
|
- 첫 reuse 실행 exit 1, 227초, overview 6개 실패. 인증 조회의 `MemberContentPreferenceService.resolveForQuery/getStoredPreference`가 기본 preference를 저장하는 실제 부작용을 정리 목록에서 놓쳤다. `member_content_preference.member_id → member.id` FK 위반으로 정리 transaction이 rollback됐고 새 items=1 assertion이 누적된 3/5개 항목을 검출했다. 해당 테이블을 member보다 먼저 정리하도록 보완한다. 기존 조회/OSIV/트랜잭션 동작은 바꾸지 않는다.
|
||||||
|
- 보완 후 reuse 결과: 같은 focused 명령 exit 0, shell wall 282초(Gradle 4분 42초), 25/25 통과. stdout 872,482 bytes, `Hibernate:` 0회, Spring 시작 4회/168.083초, testcase 합계 28.979초. 대상 세 클래스가 각각 한 번만 시작했다.
|
||||||
|
- baseline/SQL-only는 worker PID 95648/97025 한 개씩, 최종 reuse는 98759/98894/99190/99357 네 개였다. CLI와 fork/cache/heap 설정은 동일하지만 Gradle의 직전 실패 우선 실행과 class 배치가 달라 단일 wall-time 차이를 통제된 인과 추정으로 주장하지 않는다. 출력 제거와 14회 context 재생성 제거는 로그로 직접 확인했다.
|
||||||
|
- 추가 검증: owned temp init script에서 JUnit MethodOrderer.Random 및 seed 20261119를 적용해 세 클래스의 메서드 순서를 변경한다. committed fixture cleanup이 순서 독립성을 유지하는지 확인하며 script는 종료 시 제거한다.
|
||||||
|
- 순서 변경·lint 실행: `./gradlew --no-daemon -I /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/test-speed.slsAQM/random-method-order.gradle ktlintKotlinScriptCheck ktlintTestSourceSetCheck test --tests '*MainContentAllEndToEndTest' --tests '*ContentOverviewEndToEndTest' --tests '*ContentSeriesBannerServiceIntegrationTest' --console=plain`, exit 0, 4분 44초. XML 3개/17 tests/0 failures/0 errors/0 skipped. 순서 변경과 병행한 lint 실행은 성능 비교 표본으로 사용하지 않는다. 해당 임시 script는 검증 후 제거했다.
|
||||||
|
- 독립 P3 리뷰 APPROVE: FK 삭제 순서, 간접 생성 preference 정리, 전용 datasource, 기존 statistics/HTTP/commit/OSIV 경계 보존 확인. 정리 실패 때 기존/추가 assertion이 누적 데이터를 검출한 실행 근거도 유지했다.
|
||||||
|
- P3 후 전체 테스트는 재실행하지 않았다. 앞선 P2의 3,753개 통과와 현재 focused 25개/순서 변경 17개를 구분한다. 사용자 전체 검증 명령: `./gradlew test`.
|
||||||
|
- 최종 `jps -l`에 테스트 worker가 없음을 확인했다. 임시 init script·노트·owned root를 정리하고 측정값은 이 문서에 보존한다. 코드·assertion 삭제/skip, 운영 코드 변경, commit/push는 없다.
|
||||||
|
|
||||||
|
| P3 단계 | shell wall | tests | stdout bytes | Hibernate 표식 | Spring 시작 |
|
||||||
|
|---|---:|---:|---:|---:|---:|
|
||||||
|
| 변경 전 | 526초 | 25 PASS | 104,015,806 | 140,318 | 18 |
|
||||||
|
| SQL 출력 off | 373초 | 25 PASS | 4,655,102 | 0 | 18 |
|
||||||
|
| context 재사용·fixture 정리 | 282초 | 25 PASS | 872,482 | 0 | 4 |
|
||||||
|
|
||||||
|
동일 명령의 관측 결과로 244초 단축됐지만, 단일 연속 실행과 worker 배치 차이가 있어 전체 suite 단축률이나 동일 환경 반복 실행의 보장값으로 확대하지 않는다.
|
||||||
|
|
||||||
|
## P4: 승인된 실행 시 테스트 힙 자동 산정
|
||||||
|
- 시작 조건: 사용자 적용 승인. 기존 변경과 staged 사용자 파일은 보존한다.
|
||||||
|
- OS 관측: 실제 Liberica17 probe에서 total 34,359,738,368 bytes, free 1,110,003,712 bytes. Darwin JDK 구현은 free_count만 사용해 inactive/speculative를 가용 추정에 반영하지 않는다. `vm_stat`은 4,096-byte page, free 282,532 pages, inactive 3,161,273 pages, speculative 5,015 pages를 별도로 보고했다.
|
||||||
|
- [x] OS별 관측 의미와 보수적 예산 계산 정책 확정 및 테스트 가능한 최소 build logic 위치 결정.
|
||||||
|
- [x] 산정 경계, worker 분배, 잘못된 관측, 부족 예산에 대한 자동 테스트 RED/GREEN.
|
||||||
|
- [x] Test task 실행 직전 산정과 명시적 maxHeapSize 연결. 실제 worker launch/GC maximum 확인.
|
||||||
|
- [x] 메모리 부족 거부 경로를 실제 시스템 메모리 압박 없이 검증.
|
||||||
|
- [x] focused/lint/리뷰, 사용법·한계 문서, 소유 임시 probe와 노트/root 정리.
|
||||||
|
- 범위 밖: 운영 코드·앱 의존성 변경, 테스트 누락/skip/실패 무시, 전체 suite 자동 반복, 실시간 heap resize, worker 동시성 확대, commit/push.
|
||||||
|
|
||||||
|
### P4 확정 설계
|
||||||
|
- build logic는 Java-only `buildSrc`의 단일 `buildlogic.TestHeapPolicy`와 JUnit 5.8.2 경계 테스트로 분리한다. 애플리케이션 classpath에 넣지 않고 Kotlin DSL 플러그인도 추가하지 않는다. 파일은 `buildSrc/build.gradle.kts`, `buildSrc/src/main/java/buildlogic/TestHeapPolicy.java`, `buildSrc/src/test/java/buildlogic/TestHeapPolicyTest.java`, 루트 `build.gradle.kts`, 실행 가이드와 기존 작업 문서다.
|
||||||
|
- macOS 가용 추정은 `vm_stat`의 `(Pages free + Pages inactive) × page size`다. psutil 7.0.0 `_psosx.py` 원문을 직접 대조해 `avail = inactive + free` 계산이 `free -= speculative`보다 먼저 수행됨을 확인했다. speculative/file-backed를 별도로 더하거나 speculative을 빼지 않는다. 출처: https://github.com/giampaolo/psutil/blob/release-7.0.0/psutil/_psosx.py . 이는 회수 가능량의 추정이지 OS의 할당 보장이 아니다.
|
||||||
|
- macOS 외에는 JDK 17 OperatingSystemMXBean의 free memory를 보수적 관측값으로 사용한다. 해당 JDK/OS의 container 인식 범위를 넘는 host 추정을 추가하지 않는다. 이 경로의 실제 OS별 실행 검증은 현재 Mac에서 수행할 수 없다는 한계를 기록한다.
|
||||||
|
- 정책: 가용 추정 A의 절반을 시스템 여유로 남긴다. 유효 worker F=`min(maxParallelForks, maxWorkers)`로 나눈 뒤 worker당 힙 외 1GiB를 제외하고 MiB 단위로 내린다. `heapMiB = floor((floor(floor(A/2)/F) - 1GiB)/1MiB)`. 4,096MiB 미만이면 올려 할당하지 않고 명시적 실패다.
|
||||||
|
- 메모리 관측은 Test task doFirst에서 한 번 수행한다. 이후 forkEvery로 교체한 worker도 그 task의 동일한 계산값을 사용한다. 구성만 읽는 help 작업은 OS 관측을 실행하지 않는다.
|
||||||
|
- 경계 검증: 10GiB/worker1과 20GiB/worker2의 정확한 하한, 1 byte 부족, fractional MiB 내림, 유효 worker cap, 4K/16K vm_stat page·누락/중복/음수/overflow, 잘못된 관측·worker 수를 검증한다.
|
||||||
|
- 실제 부족 예산 검증은 임시 init script로 root test task의 worker 요구량만 64로 높이고 `--max-workers=64` 및 경량 테스트 한 클래스만 선택한다. 32GiB 호스트에서는 64개 worker의 각 4GiB 하한을 충족할 수 없어 시작 전에 실패해야 한다. 실제 메모리를 소모해 시스템 압박을 만드는 방식은 사용하지 않는다. 임시 설정은 검증 후 삭제한다.
|
||||||
|
|
||||||
|
### P4 검증 기록
|
||||||
|
- buildSrc TDD: `./gradlew --no-daemon -p buildSrc test --tests 'buildlogic.TestHeapPolicyTest' --offline`. 최소 구현 RED exit 1(51개 중 50개 assertion 실패), 구현 후 GREEN exit 0/6초/51 tests/0 failures/0 errors/0 skipped. 실제 macOS vm_stat 읽기도 포함한다. XML: `buildSrc/build/test-results/test/TEST-buildlogic.TestHeapPolicyTest.xml`.
|
||||||
|
- root `./gradlew --no-daemon --offline help --console=plain` exit 0/31초. Test task를 실행하지 않아 메모리 산정 로그와 vm_stat 실행이 없다.
|
||||||
|
- 최초 실제 worker 검증은 buildSrc 추가로 Kotlin/KAPT task classpath가 바뀌어 재컴파일 중 300초 제한에 걸렸다. worker 시작 전이며, `jps -l`에서 소유 프로세스 잔존이 없음을 확인하고 재개했다. 기존 소스의 컴파일 경고는 수정하거나 숨기지 않았다.
|
||||||
|
- 재개: `./gradlew --no-daemon --offline test --tests '*H2DatabaseLifecycleTest' --tests '*MetadataReadRetryContextIsolationTest' --info --console=plain`, exit 0/5분 4초. 두 테스트 모두 통과, failures/errors/skipped 0.
|
||||||
|
- 실제 task-start 로그 `available estimate=13432 MiB, workers=1, maxHeap=5692 MiB`. worker 실행 인자 `-Xmx5692m`와 PID 21951의 `build/test-gc/test/gc-21951.log`의 `Heap Max Capacity: 5692M`가 일치한다. 교체된 worker에도 동일한 상한이 전달됐다. 기본 512MB 또는 이전 고정 4GB로 실행되지 않았다.
|
||||||
|
- 부족 예산 검증: 임시 init script와 `--max-workers=64`, `--tests '*CodePointTextSplitterTest'`로 실행. 예상대로 exit 1/16초, `Insufficient test memory: availableBytes=15350431744, effectiveWorkers=64, minimumHeapMiB=4096`가 출력됐고 root Test Executor/class 시작 없이 종료했다. 실제 메모리 압박은 만들지 않았다.
|
||||||
|
- 현재 macOS 실행만 검증했다. 비macOS JDK free-memory 경로 및 vm_stat timeout/interruption 강제 재현은 미검증이다. 전체 애플리케이션 suite는 P4 후 재실행하지 않는다.
|
||||||
|
- `./gradlew --no-daemon --offline ktlintKotlinScriptCheck --console=plain` exit 0/17초. `git diff --check` 통과. 실제 실행 후 `jps -l`에 소유 테스트 worker가 없음을 확인했다. 기존 Gradle daemon과 IDE는 유지한다.
|
||||||
|
- 임시 JVM 관측 probe, 부족 예산 init script와 실행 노트를 삭제하고 owned root를 정리한다. 계산식/검증 결과는 이 문서에 남긴다. 앱 코드 및 기존 테스트 파일은 P4에서 수정하지 않았다.
|
||||||
|
- 최종 독립 리뷰 APPROVE: raw free+inactive 계산, 예산/worker cap/내림/4GiB 하한, parser 오류와 프로세스 정리, doFirst 연결 및 별도 buildSrc 테스트 범위를 확인했다. 비macOS와 강제 timeout/interruption은 미검증으로 유지한다.
|
||||||
|
- 소유 임시 root 삭제와 부재 확인 완료. 추가 재검증 없이 종료하며 commit/push는 수행하지 않았다.
|
||||||
|
|
||||||
|
## P5: 고정 힙 하한·예약량 제거
|
||||||
|
- 시작 조건: 사용자 승인과 Jenkins 오류 `availableBytes=2460004352, effectiveWorkers=1, minimumHeapMiB=4096`.
|
||||||
|
- 대상 파일: `buildSrc/src/main/java/buildlogic/TestHeapPolicy.java`, `buildSrc/src/test/java/buildlogic/TestHeapPolicyTest.java`, 루트 `build.gradle.kts` 로그, 실행 가이드와 기존 문서.
|
||||||
|
- 정책 변경: F=`min(maxParallelForks,maxWorkers)`, P=`floor(floor(A/2)/F)`, native reserve=`ceil(P/4)`, heapMiB=`floor((P-native reserve)/1MiB)`. 고정 1GiB 차감과 4GiB 정책 하한을 제거한다. 양수 입력·overflow 안전성은 유지한다.
|
||||||
|
- 기술 한계 관측: 로컬 Java17에서 `java -Xmx2m -version`은 성공하고 `java -Xmx1m -version`은 `Too small maximum heap`로 실패했다. 따라서 2MiB 미만만 JVM 실행 불가로 거부하며 상향 보정하지 않는다.
|
||||||
|
- [x] Jenkins 실제 값, sub-GiB/4GiB 미만 예산, worker 분배, rounding과 JVM 극소 경계의 새 계약을 테스트에서 먼저 RED 확인.
|
||||||
|
- [x] 비율 계산 구현 후 전체 buildSrc 정책 테스트 GREEN.
|
||||||
|
- [x] 실제 root worker에 동적 Xmx 전달, script lint·단일 리뷰 확인.
|
||||||
|
- [x] 현재 정책/미검증 범위 문서와 소유 임시 자원 정리.
|
||||||
|
- 실제 Jenkins/AWS 실행, 전체 앱 suite, OS 메모리 조회 변경은 범위 밖이다. 이번 회귀는 4GiB 사전 거부를 해결하며 작은 힙에서 모든 테스트가 통과한다고 보장하지 않는다.
|
||||||
|
- RED: `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.TestHeapPolicyTest' --console=plain`, exit 1/8초. 58개 중 21개 실패. 실제 Jenkins 값과 1/2/8GiB 입력은 기존 fixed floor 예외를 재현했고, 다른 예산/반올림은 새 비율 계약과 불일치했다. 기존 parser/invalid-input 검사들은 그대로 유지했다.
|
||||||
|
- 최소 구현: 1GiB 상수를 없애고 `ceil(perWorkerBytes/4)`를 native reserve로 사용한다. 4GiB 정책 하한 대신 JVM 실행 가능 여부만 검사한다. root 로그와 실행 가이드도 비율 정책으로 갱신했다.
|
||||||
|
- GREEN: 같은 buildSrc focused 명령 exit 0/8초, 58 tests/0 failures/0 errors/0 skipped. Jenkins 제공값 2,460,004,352 bytes가 879MiB를 반환함을 검증했다.
|
||||||
|
- 실제 root 검증: `./gradlew --no-daemon --offline --max-workers=1 ktlintKotlinScriptCheck test --tests '*CodePointTextSplitterTest' --info --console=plain`, exit 0/9분 11초. buildSrc 변경에 따른 기존 Kotlin/KAPT 재컴파일을 포함했다. CodePointTextSplitterTest 33개 통과와 script lint 성공 확인. 기존 애플리케이션/테스트 컴파일 경고는 숨기거나 변경하지 않았다.
|
||||||
|
- task 시작 시 관측 13,160MiB, worker 1개, 선택 4,935MiB였고 실제 worker 명령 `-Xmx4935m`과 일치했다. 이 로컬 실행을 Jenkins 노드의 실행 결과로 해석하지 않는다.
|
||||||
|
- 독립 P5 리뷰 APPROVE. 고정 4GiB·1GiB 값 제거, 비율 예약의 overflow 안전성, 실제 Jenkins 입력과 sub-GiB/rounding 경계, OS reader/기존 보호 설정 유지 및 작은 힙의 한계를 확인했다.
|
||||||
|
- `git diff --check` 통과, 소유 테스트 worker 없음 확인. 실행 노트·owned temp root 삭제 및 부재 확인 후 종료한다. commit/push는 수행하지 않았다.
|
||||||
|
|
||||||
|
## P6: buildSrc Kotlin 통일
|
||||||
|
- 사용자 승인에 따른 언어 전환이며 정책 변경이 아니다. P5의 Java 58개 GREEN을 baseline으로 사용한다.
|
||||||
|
- 의존 경계: root build.gradle.kts → TestHeapPolicy public static calculateHeapMiB/readAvailableBytes. parser는 buildSrc 테스트에서만 호출한다. 앱 코드 의존은 없다.
|
||||||
|
- 변경 파일: `buildSrc/build.gradle.kts`, Java helper/test를 각각 `buildSrc/src/main/kotlin/buildlogic/TestHeapPolicy.kt`, `buildSrc/src/test/kotlin/buildlogic/TestHeapPolicyTest.kt`로 이동, 기존 작업 문서와 사용법 필요 부분.
|
||||||
|
- 플러그인: Gradle 버전에 맞는 `kotlin-dsl`, Java toolchain 17, 기존 JUnit 5.8.2 유지. 앱 Kotlin 1.6.21은 변경하지 않는다. 로컬에 kotlin-dsl 플러그인이 캐시돼 있지 않아 최초 의존성 해석은 네트워크가 필요할 수 있다.
|
||||||
|
- [x] Kotlin 전환과 Java 중복 제거. 모든 동작·케이스 보존.
|
||||||
|
- [x] buildSrc clean focused test에서 58/58 통과, Kotlin 소스 lint와 public JVM signature 확인.
|
||||||
|
- [x] root Gradle에서 helper를 호출하고 선택된 Xmx가 실제 worker에 전달되는지 확인.
|
||||||
|
- [x] 독립 리뷰, 문서 기록, 소유 임시 자원 정리.
|
||||||
|
- `javap` baseline: `public static long calculateHeapMiB(long,int,int)`, `public static long readAvailableBytes()`. 기존 parser는 Java package-private이다. Kotlin에서는 module 내부로 한정한다.
|
||||||
|
- Java baseline XML: 58 tests/0 failures, 정렬한 testcase 이름 JSON의 SHA-256 `6ba55b03a872659fedbca5419274eeaf42b38c2e219cd01fa34725f7b2447642`. 언어 이동 후 case 보존 확인에만 사용하며 구현 의미는 실제 assertion과 리뷰로 대조한다.
|
||||||
|
- `./gradlew --no-daemon -p buildSrc help --console=plain` exit 0/52초. 새 kotlin-dsl 플러그인 해석과 Java17/JUnit 설정 로딩을 확인했다. 앱 Kotlin 플러그인 버전은 유지했다.
|
||||||
|
- buildSrc의 새 Kotlin 소스도 검증하도록 루트와 동일한 ktlint 11.5.0 플러그인을 해당 build에 적용한다. 테스트와 정책의 포맷 검사 범위를 빠뜨리지 않으며 앱 의존성은 바꾸지 않는다.
|
||||||
|
- `./gradlew --no-daemon -p buildSrc clean test --tests 'buildlogic.TestHeapPolicyTest' ktlintCheck --console=plain` exit 0/52초. Kotlin 컴파일 후 58 tests/0 failures/0 errors/0 skipped와 buildSrc의 script/main/test lint 통과. compileJava/compileTestJava NO-SOURCE로 이전 Java 산출물에 의존하지 않음을 확인했다.
|
||||||
|
- 변환 후 testcase 이름 digest는 baseline과 동일하다. `javap -classpath buildSrc/build/classes/kotlin/main buildlogic.TestHeapPolicy`는 `.kt`에서 생성된 두 public static 메서드를 확인했다. parser는 internal 메서드로 컴파일된다.
|
||||||
|
- root 연결: `./gradlew --no-daemon --offline --max-workers=1 ktlintKotlinScriptCheck test --tests '*CodePointTextSplitterTest' --info --console=plain`, exit 0/11분 32초. buildSrc classpath 변경에 따른 기존 Kotlin/KAPT 재컴파일을 포함한다. 기존 컴파일 경고는 변경하거나 숨기지 않았다. CodePointTextSplitterTest 33개, root script lint 통과.
|
||||||
|
- 실제 root task 로그는 가용 추정 12,099MiB/worker1/선택4,537MiB이고 worker 명령에 `-Xmx4537m`이 전달됐다. Java→Kotlin 이동 후에도 기존 public 호출과 실행 시 산정 연결이 작동했다.
|
||||||
|
- 독립 P6 리뷰 APPROVE: 계산식/OS reader/parser·예외·프로세스 종료와 58개 case 보존, static API 및 buildSrc Kotlin 설정을 확인했다. `git diff --check` 통과, 소유 테스트 worker 없음 확인. 노트와 owned temp root를 제거했다.
|
||||||
|
- P6에서 전체 앱 테스트나 실제 Jenkins/AWS 실행은 수행하지 않았다. commit/push도 수행하지 않았다. 기존 P5의 비율 정책과 앱 Kotlin 1.6.21은 유지했다.
|
||||||
|
|
||||||
|
## P7: Linux MemAvailable와 JDK 인식 cgroup 상한
|
||||||
|
- 승인된 수정 범위: `buildSrc/src/main/kotlin/buildlogic/TestHeapPolicy.kt`, Linux parser/resolver 회귀 테스트, 실행 가이드와 기존 작업 문서. 앱 테스트/운영 로직/힙 비율/cache/fork/parallel/commit/push는 변경하지 않는다.
|
||||||
|
- 관측: 실제 Jenkins는 가용 1315MiB → 힙 493MiB를 선택했고 AdminMemberServiceTest 실행 중 OOM이 발생했다. 최초 OOM 세부 메시지와 실제 MemAvailable/cgroup 원본은 아직 제공되지 않아 원격 자원 여유량·전체 성공을 추정하지 않는다.
|
||||||
|
- Java17 OpenJDK 소스에서 컨테이너 인식 시 total은 유효 제한, free는 제한-사용량이며 미인식 시 host 지표로 돌아감을 확인했다. 따라서 host MemAvailable와 JVM free의 min을 무조건 취하지 않고, JVM total < host MemTotal인 경우에만 제한을 적용한다.
|
||||||
|
- [x] MemFree는 작고 MemAvailable는 큰 host fixture 및 quota가 더 작은 fixture를 기존 free-only 동작에서 RED로 확인.
|
||||||
|
- [x] MemTotal/MemAvailable kB 파싱과 quota resolver 구현. 누락·중복·잘못된 단위/숫자/overflow·관측 실패 경계를 검증.
|
||||||
|
- [x] 기존 58개 정책/OS 테스트와 새 Linux 테스트 GREEN, Kotlin lint 및 root 연결 검증.
|
||||||
|
- [x] 단일 gate 리뷰, 사용자 진단 로그/제약 문서, 소유 temp 정리.
|
||||||
|
- fixture 기반 Linux 검증과 실제 macOS Gradle 연결 결과를 실제 Jenkins/AWS 실행과 구분한다. JVM이 인식하지 못한 cgroup을 완전히 탐지한다고 주장하지 않는다.
|
||||||
|
- RED: Linux 분기를 분리하되 기존 JVM free-only 반환을 유지한 상태에서 `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.*' --console=plain` 실행. exit 1/16초, 86개 중 새 Linux 회귀 24개 실패. 기존 58개는 유지됐다. Host MemAvailable 사용·컨테이너/host pressure cap·잘못된 proc 카운터 거부의 누락을 확인했다.
|
||||||
|
- 구현은 Linux의 MemTotal/MemAvailable만 엄격하게 kB 단위로 파싱하고, JVM total이 host total보다 작을 때만 JVM free/total로 상한한다. quota 여유 0을 host 값으로 덮지 않는다. 실제 Linux 실행 시 JVM total/free/effective available 진단 로그를 남긴다.
|
||||||
|
- GREEN: `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.*' ktlintCheck --console=plain`, exit 0/33초. 기존 58개와 Linux 28개를 합친 86개 통과, buildSrc script/main/test lint 통과. Host MemFree=1315MiB지만 MemAvailable=10GiB인 테스트 fixture는 10GiB를 선택해 힙 3840MiB를 계산한다. 이는 실제 Jenkins의 MemAvailable 측정값이 아니다.
|
||||||
|
- root 연결 확인: `./gradlew --no-daemon --offline help ktlintKotlinScriptCheck --console=plain`, exit 0/35초. 공개 API를 참조하는 root Kotlin DSL과 buildSrc classpath 구성이 정상 로딩되고 root script lint가 통과했다. root 앱 테스트/worker를 실행한 검증과 구분한다.
|
||||||
|
- 사용자 요청에 따라 실행 가이드에 Jenkins `clean build` 명령을 기록했다. 기존 Gradle JVM 2GB/Metaspace768MB와 worker1은 유지하고 `--no-parallel`, `--console=plain`만 명시적으로 추가한다. 테스트 heap은 코드가 산정하며 별도 미구현 CLI 옵션을 제시하지 않는다.
|
||||||
|
- XML로 기존 정책 58개와 Linux 회귀 28개 모두 failures/errors/skipped 0을 확인했다. `git diff --check` 통과, 소유 테스트 worker 없음 확인. 임시 노트·owned root는 제거하며 기존 Gradle/IDE 프로세스는 건드리지 않는다.
|
||||||
|
- 독립 P7 리뷰 APPROVE: Linux kB 파싱, recognized quota/host pressure 제한, zero 보존, 기존 비율 정책 유지와 원격 미검증 한계를 확인했다. 노트·owned root 삭제와 부재 확인 완료. commit/push는 수행하지 않았다.
|
||||||
|
|
||||||
|
## P8: worker 재시작 비용 조정
|
||||||
|
- 사용자 관측: Jenkins `available estimate=5152 MiB, workers=1, maxHeap=1932 MiB`, OOM 없음, 약 두 배 느림. 로컬에서도 비슷한 지연을 보고했다.
|
||||||
|
- Oracle 권고에 따라 먼저 `forkEvery=50→100`만 비교한다. cache4/parallel1/힙 비율은 그대로다. 무제한 재사용은 이전 4GiB 포화 증거 때문에 사용하지 않는다.
|
||||||
|
- Gradle8.1.1은 JUnit Platform의 실제 실행 테스트 수와 별도로 전달된 class candidate를 fork 카운터에 반영하므로 필터 실행에도 빈 worker가 생길 수 있다. 테스트 파일명 include로 후보를 임의 제외하지 않는다.
|
||||||
|
- [x] 현재 설정의 동일 focused 기준 실행/메모리/worker 비용 확보.
|
||||||
|
- [x] 교체 간격100만 적용하고 같은 1932MiB 조건으로 비교. 테스트 누락·실패·OOM 없어야 한다.
|
||||||
|
- [x] 이번 실험 채택 기준: worker 구간 10% 이상 단축, 최대 GC 후 힙 Xmx80% 이하, GC pause 비율5% 이하. 이 수치는 실험 판정 기준이지 보편적 보장은 아니다.
|
||||||
|
- [x] 필요 시에만 힙 비율을 별도 단계로 검토. 압박 근거가 없으면 확대하지 않는다.
|
||||||
|
- [x] 단일 리뷰, 측정 한계/실행 명령 기록, owned 자원 정리.
|
||||||
|
- 비교 범위: MainContentAllEndToEndTest, ContentOverviewEndToEndTest, ContentSeriesBannerServiceIntegrationTest, AdminTranslationSelectionContentsHttpIntegrationTest, AdminMemberServiceTest. 기존 25개에 문제 보고된 관리자 회원 테스트7개를 포함한다.
|
||||||
|
- 임시 init script는 root의 기존 doFirst 예산 산정 뒤 QA용 힙1932m을 지정한다. 실제 worker 실행 인자/GC MaxCapacity로 적용을 확인한다. 배포할 기본 힙 설정은 바꾸지 않으며 script는 종료 시 제거한다.
|
||||||
|
- 컴파일 비용은 전체 shell 시간과 별도로 기록하고, 성능 비교는 worker 첫 시작~마지막 종료 구간을 사용한다. 전체 suite 자동 실행 대신 직접 영향 범위 focused 검증을 수행한다. Jenkins 실제 전체 비교는 사용자 실행으로 남긴다.
|
||||||
|
|
||||||
|
### P8 측정 기록
|
||||||
|
- baseline 명령: `./gradlew --no-daemon --offline --max-workers=1 -I /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/fork-speed.Uj34CC/jenkins-heap.gradle test --tests '*MainContentAllEndToEndTest' --tests '*ContentOverviewEndToEndTest' --tests '*ContentSeriesBannerServiceIntegrationTest' --tests '*AdminTranslationSelectionContentsHttpIntegrationTest' --tests '*AdminMemberServiceTest' --console=plain`.
|
||||||
|
- `*AdminMemberServiceTest`는 CreatorAdminMemberServiceTest도 포함하여 실제 비교 범위는 6클래스/33개다. 동일 패턴을 그대로 유지해 전후 테스트 집합을 바꾸지 않는다.
|
||||||
|
- fork50 baseline: exit 0, shell 652초(기존 Kotlin/KAPT 재컴파일 포함). QA override가 실제 GC MaxCapacity 1932MiB로 적용됨을 확인했다. 33 tests/0 failures, Spring 시작6회.
|
||||||
|
- baseline worker PID 91319,91435,91443,91587,91596,91605,91613,91750,91759,91866,91874,91882,91891. worker 구간232.828초, GC pause2.695초(1.157%), Full GC0, 최대 GC 후 힙339MiB(17.547% Xmx). 모든 worker heap exit 기록이 있다.
|
||||||
|
- root `forkEvery`만 100으로 변경하여 다음 측정을 수행한다. 기본 힙 산정·캐시4·parallel1은 변경하지 않는다. 기존 H2 `SKIP LOCKED` 스케줄러 오류와 종료 중 Redis 재연결 경고가 baseline에서도 관측됐으며, 이번 설정 비교를 위해 숨기거나 별도 운영 로직을 수정하지 않는다.
|
||||||
|
- fork100 결과: 같은 1932MiB/동일6클래스33개 모두 통과. shell296초(컴파일 UP-TO-DATE)와 별도로 worker구간255.806초. worker7개지만 실제 Spring context를 띄운 worker는 여전히4개, 시작6회였다. GC pause2.859초(1.118%), FullGC0, 최대 GC 후 힙329MiB(17.029%). baseline보다 빠르지 않아 100은 채택하지 않는다. shell652→296초 차이는 재컴파일 포함 여부가 달라 최적화 효과로 사용하지 않는다.
|
||||||
|
- 다음 실험은 fork200이다. 100은 빈 worker만 줄이고 실제 Spring 기동 그룹을 합치지 못했으므로, bounded 간격을 한 단계 늘려 실제 기동 재사용 효과를 확인한다. baseline50과 동일 테스트·힙·cache·parallel 및 기존 채택 기준을 유지한다. GC 압박이 없어 힙 비율이나 cache 크기는 올리지 않는다. 이것을 전체 Jenkins의 안전성 보장으로 확대하지 않는다.
|
||||||
|
- fork200 결과: 33/33 통과, shell242초, worker4개(실제 Spring기동3개), worker구간213.198초. GC pause2.475초(1.161%), FullGC0, 최대 GC 후434MiB(22.464%). baseline 대비 약8.43% 단축으로10% 채택 기준에는 못 미친다. 테스트 집합과1932MiB cap은 동일하다.
|
||||||
|
- 마지막 교체 간격 후보로 fork300을 비교한다. 앞선 그룹 재사용 효과가 실제 기동 worker수에서 확인됐고 메모리 압박은 없어, 힙/cache 확대 없이 기동 그룹을 추가로 합치는 실험이다. 여전히 bounded이며 같은 기준을 적용한다. 300도 기준에 못 미치면 이번 간격 변경은 되돌리고 측정된 한계를 보고한다.
|
||||||
|
- fork300 결과: exit 0, shell204초, 동일33개 통과. worker3개(실제 Spring기동2개), worker구간181.903초. GC pause2.095초(1.152%), FullGC0, 최대 GC 후472MiB(24.431%). 모든 worker MaxCapacity1932MiB와 heap exit를 확인했다. baseline 대비 worker구간21.87% 단축으로 이번 focused 채택 기준을 충족했다.
|
||||||
|
- fork300을 채택하고 힙 산정·cache4·parallel1은 그대로 유지한다. 메모리 압박이 관측되지 않았으므로 힙60% 확대 실험은 하지 않는다. 기존 모든33개 case와 Spring 시작6회를 유지했고 파일 include/exclude나 테스트 삭제를 추가하지 않았다.
|
||||||
|
- 비교는 동일 Mac/JDK/CLI/heap에 대한 순차 단일 실행이다. 전체 shell652→204초에는 최초 컴파일 여부 차이가 있으므로 이 차이를 성능 향상으로 제시하지 않는다. worker구간의 관측 개선도 실제 Jenkins 전체 suite 또는 통계적 반복 성능을 보장하지 않는다.
|
||||||
|
|
||||||
|
| forkEvery | 테스트 | worker 수 | worker 구간 | GC pause 비중 | 최대 GC 후 힙 | Full GC |
|
||||||
|
|---:|---:|---:|---:|---:|---:|---:|
|
||||||
|
| 50 | 33 PASS | 13 | 232.828초 | 1.157% | 339MiB | 0 |
|
||||||
|
| 100 | 33 PASS | 7 | 255.806초 | 1.118% | 329MiB | 0 |
|
||||||
|
| 200 | 33 PASS | 4 | 213.198초 | 1.161% | 434MiB | 0 |
|
||||||
|
| 300 | 33 PASS | 3 | 181.903초 | 1.152% | 472MiB | 0 |
|
||||||
|
|
||||||
|
- 최종 설정의 `./gradlew --no-daemon --offline ktlintKotlinScriptCheck --console=plain` exit 0/11초. 전후 측정에 사용한 임시1932m override는 배포 코드에 포함하지 않는다.
|
||||||
|
- 독립 P8 gate APPROVE. 기능 diff 한 줄, 네 실행 GC 로그의 heap/worker/시간/정상 종료와 최종 XML 6클래스33개 통과를 대조했다. 21.87%는 이 로컬 focused 단일 비교의 관측값이며, 실제 Jenkins 전체 suite의 속도/OOM 또는 보편적 향상률로 주장하지 않는다.
|
||||||
|
- `git diff --check` 통과, 소유 테스트 worker 없음 확인. 임시1932m init script와 노트·owned root를 삭제한다. 기본 힙 산정은 기존 정책 그대로이며 commit/push는 수행하지 않았다.
|
||||||
|
|
||||||
|
## 커밋 전 검증 (2026-11-19)
|
||||||
|
- 사용자 `/commit-with-validation` 요청으로 P5/P6 변경을 커밋한다.
|
||||||
|
- `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.TestHeapPolicyTest' --rerun ktlintCheck --console=plain` exit 0/9초. 정책 테스트를 재실행해 XML의 58 tests/0 failures/0 errors/0 skipped를 확인했다. buildSrc lint는 UP-TO-DATE였다.
|
||||||
|
- 이번 커밋 검증에서 root focused test와 실제 Jenkins/AWS 실행은 반복하지 않았다. 전체 앱 테스트도 미실행이며 사용자 실행 명령은 `./gradlew test`다.
|
||||||
|
|
||||||
|
## P7 커밋 전 검증 (2026-11-19)
|
||||||
|
- 사용자 `/commit-with-validation` 요청으로 Linux 메모리 관측 변경과 관련 문서를 커밋한다.
|
||||||
|
- `./gradlew --no-daemon --offline -p buildSrc test --tests 'buildlogic.*' --rerun ktlintCheck --console=plain` exit 0/8초. XML에서 기존 정책 58개와 Linux 회귀 28개, 총 86개 tests/0 failures/0 errors/0 skipped를 확인했다. buildSrc lint는 UP-TO-DATE였다.
|
||||||
|
- `git diff --check` 통과. 실제 Jenkins/Linux 환경 실행과 전체 앱 테스트는 미실행이며 사용자 전체 테스트 명령은 `./gradlew test`다.
|
||||||
|
|
||||||
|
## P8 커밋 전 검증 (2026-11-19)
|
||||||
|
- 사용자 `/commit-with-validation` 요청으로 worker 교체 간격 변경과 관련 문서를 커밋한다.
|
||||||
|
- `./gradlew --no-daemon --offline ktlintKotlinScriptCheck --console=plain` exit 0/9초, 모든 task는 UP-TO-DATE였다. `git diff --check` 통과.
|
||||||
|
- 기존 root 테스트 XML 6개에서 총 33 tests/0 failures/0 errors/0 skipped를 확인했다. 이번 커밋 검증에서는 focused 성능 비교를 반복하지 않았다.
|
||||||
|
- 실제 Jenkins 실행과 전체 앱 테스트는 미실행이며 사용자 전체 테스트 명령은 `./gradlew test`다.
|
||||||
@@ -0,0 +1,62 @@
|
|||||||
|
# 번역 및 관리자 오디오 테스트 수정
|
||||||
|
|
||||||
|
- 작성일: 2026-11-18
|
||||||
|
- 상태: P8 worker 간격 조정·동일 힙 focused 비교·lint·리뷰 승인·정리 완료. 실제 Jenkins와 전체 suite는 P8 후 미실행.
|
||||||
|
- 구현 계획: [plan-task.md](plan-task.md)
|
||||||
|
|
||||||
|
## 목표와 범위
|
||||||
|
운영 로직을 변경하지 않고 사용자가 지정한 네 테스트의 설정·fixture 불일치를 수정한다. 기존 assertion의 의미와 검증 강도를 유지한다. 전체 테스트 통과가 사용자 목표이며, 저장소 실행 규칙에 따라 에이전트는 focused 및 관련 회귀를 검증하고 전체 실행은 사용자에게 안내한다.
|
||||||
|
|
||||||
|
## 수용 기준
|
||||||
|
| ID | 확정 요구사항 | 검증 |
|
||||||
|
|---|---|---|
|
||||||
|
| TEST-01 | 기본 AWS 우선과 독립적인 기능 순서, 잘못된 순서 거부를 유지한다. | LanguageProviderSpringConfigurationTest |
|
||||||
|
| TEST-02 | 현재 FAILED 작업 재개와 다른 언어 작업의 보존을 검증한다. 번역이 없으면 현재 언어 작업을 예약하는 기존 계약을 반영한다. | OriginalWorkReadRetryTest |
|
||||||
|
| TEST-03 | 관리자 오디오 정상 응답·소유권·인증·입력 검증과 거부 요청의 부작용 없음 검증을 유지한다. | AiCharacterAdminAudioContentControllerTest, AiCharacterAdminAudioContentOwnershipTest |
|
||||||
|
| TEST-04 | 운영 코드 변경, 테스트 삭제/skip/검증 완화 없이 관련 회귀를 통과한다. | diff 및 focused test 결과 리뷰 |
|
||||||
|
|
||||||
|
## 제외
|
||||||
|
운영 코드와 API 계약 변경, 무관한 리팩터링, 기존 staged 변경 수정, 커밋은 제외한다.
|
||||||
|
|
||||||
|
## 추가 승인: 테스트 자원 수명 관리
|
||||||
|
- 사용자가 공통 테스트 실행 설정·H2 수명 설정·직접 관련 테스트 변경을 승인했다. 운영 코드와 assertion 강도는 유지하고 commit/push는 수행하지 않는다.
|
||||||
|
- H2의 마지막 연결 종료 시 DB 해제와 열린 연결 간 데이터 공유를 실제 JDBC/connection pool로 검증한다. context별 DB 격리는 유지한다.
|
||||||
|
- Spring context 캐시 상한을 작은 값부터 비교하고, 진행 위치와 GC 로그를 남겨 조용한 장시간 정지를 진단할 수 있어야 한다.
|
||||||
|
- 전체 테스트가 정상 종료하여 종료 코드/XML을 생성하고 후반 GC 과부하가 재현되지 않는지 확인한다. 필요 시 worker 교체는 원인 수정과 별도 보호 장치로 평가한다.
|
||||||
|
- 신규 테스트 작성 규칙에 context 재사용, H2/fixture 수명, 비동기 자원 종료를 기록한다. 테스트 누락/skip/검증 완화로 완료 처리하지 않는다.
|
||||||
|
|
||||||
|
## 추가 승인: SQL 출력과 세 클래스 초기화 비용 최적화
|
||||||
|
- 2026-11-19 사용자 승인: SQL 상세 출력·포맷팅 비활성화와 세 클래스의 메서드별 context 폐기를 명시적 fixture 정리로 대체한다.
|
||||||
|
- 대상: MainContentAllEndToEndTest, ContentOverviewEndToEndTest, ContentSeriesBannerServiceIntegrationTest. DB/HTTP/commit/OSIV 및 기존 assertion을 유지한다.
|
||||||
|
- 캐시 4개, worker 50클래스 교체, 동시 worker 1개, heap 4GB는 유지한다. 공통 context 재설계·테스트 순서 강제·운영 코드 변경은 제외한다.
|
||||||
|
- 동일 focused 실행으로 변경 전, SQL 출력 변경 후, context 재사용 후 결과를 따로 비교한다. 출력 감소와 실제 시간 단축은 구분하며 실측 결과만 보고한다.
|
||||||
|
|
||||||
|
## 추가 승인: 실행 시 테스트 힙 자동 산정
|
||||||
|
- 2026-11-19 사용자가 고정 4GB 대신 시작 시 가용 메모리를 기반으로 테스트 worker 힙을 계산하는 방식을 승인했다.
|
||||||
|
- Gradle 8.1.1의 기본 512MB 상한으로 돌아가지 않도록 계산한 `maxHeapSize`를 명시적으로 전달한다. 계산은 설정 로딩 때가 아닌 Test task 실행 직전에 수행한다.
|
||||||
|
- OS의 현재 메모리 관측값에 안전 여유와 JVM 힙 외 메모리 예산을 남기고 동시 worker 수로 나눈다. 기존에 검증한 4GiB를 보수적 실행 하한으로 유지하며, 하한 미달 또는 유효한 관측 불가 시 worker 시작 전에 이유를 알리고 중단한다. 하한은 수학적으로 입증된 최소 필요량이라는 뜻이 아니다.
|
||||||
|
- macOS JDK의 free-only 값은 전체 가용량이 아니므로 회수 가능한 메모리 추정 규칙을 출처와 함께 명시한다. 실행 도중 가용량 변화에 따른 실시간 heap 재조정이나 무제한 할당은 제외한다.
|
||||||
|
- 기존 cache 4개, 50클래스 worker 교체, 동시 worker 1개는 유지한다. 운영 코드 변경, commit/push는 제외한다.
|
||||||
|
|
||||||
|
## 추가 승인: 고정 하한과 고정 예약량 제거
|
||||||
|
- Jenkins가 보고한 `availableBytes=2460004352`를 4GiB 하한 때문에 거부한 뒤, 사용자가 하한도 고정하지 말고 현재 관측값으로 결정하도록 승인했다.
|
||||||
|
- 4GiB 정책 하한과 worker당 고정 1GiB 예약을 제거한다. 전체 관측값의 50%를 worker에 배분하고 그 예산의 25%를 힙 외 용도로 남겨, 나머지 75%를 힙 상한으로 사용한다. worker 수와 MiB 내림을 유지한다.
|
||||||
|
- 정책상의 최소 힙을 임의로 올려 할당하지 않는다. 현재 JDK가 실행 자체를 거부하는 1MiB 이하만 명시적으로 거부한다. 이는 앱 테스트의 필요 힙을 보장하는 하한이 아니다.
|
||||||
|
- OS 관측 구현·기존 cache/fork/parallel 설정은 유지한다. Linux MemAvailable/cgroup 관측 변경, 운영 코드·commit·push는 이번 범위에 포함하지 않는다.
|
||||||
|
|
||||||
|
## 추가 승인: buildSrc Kotlin 통일
|
||||||
|
- 사용자가 힙 정책과 테스트를 프로젝트 관례에 맞게 Kotlin으로 통일하도록 승인했다.
|
||||||
|
- Java helper/test를 Kotlin 소스로 이동하고 중복 Java 파일을 제거한다. 현재 P5 계산식·OS 관측·오류·자원 정리와 58개 테스트 케이스를 보존한다.
|
||||||
|
- buildSrc에는 Gradle 8.1.1에 맞는 `kotlin-dsl`을 적용하고 Java 17/JUnit 5.8.2를 유지한다. 앱의 Kotlin 1.6.21 버전과 운영 코드, root Test 정책은 변경하지 않는다.
|
||||||
|
- public static 호출 호환성과 실제 루트 Gradle 연결을 검증한다. commit/push와 전체 앱 suite 자동 실행은 제외한다.
|
||||||
|
|
||||||
|
## 추가 승인: Linux 가용 메모리 관측 보정
|
||||||
|
- Jenkins에서 `available estimate=1315 MiB, maxHeap=493 MiB` 선택 뒤 실제 OOM이 보고됐다. 사용자가 Linux MemAvailable와 cgroup 제한을 반영하는 수정에 동의했다.
|
||||||
|
- Linux는 `/proc/meminfo`의 MemAvailable를 사용한다. JDK가 보고한 total memory가 proc MemTotal보다 작으면 JDK가 인식한 제한으로 판단하고, 그 free memory와 total memory를 넘지 않도록 가용량을 제한한다.
|
||||||
|
- cgroup v1/v2 파싱을 새로 만들지 않고 Java 17의 컨테이너 인식 API를 재사용한다. `UseContainerSupport` 비활성화·미지원/발견 실패·일부 상위 계층 제한은 JDK 인식 범위를 벗어날 수 있음을 명시한다.
|
||||||
|
- 고정 4GiB 하한을 복원하거나 힙 비율·캐시·worker 정책을 변경하지 않는다. 작은 실제 예산에서도 모든 테스트가 성공한다는 보장은 하지 않는다. 실제 Jenkins 성공 여부는 원격 재실행 전까지 미검증이다.
|
||||||
|
|
||||||
|
## 추가 승인: 안정성을 유지한 실행 속도 설정 조정
|
||||||
|
- 사용자가 Jenkins와 로컬에서 약 두 배 느려졌다고 보고하고 속도 설정 수정을 승인했다. Jenkins는 가용 5152MiB/worker1/힙1932MiB를 보고하며 OOM은 없다고 확인했다.
|
||||||
|
- 첫 실험은 worker 교체 간격 50→100만 변경한다. 캐시4·동시worker1·힙 산정은 유지해 효과를 분리한다. 단일 focused 비교로 실제 Jenkins 전체 속도를 보장하지 않는다.
|
||||||
|
- 기존 테스트 누락 없이 동일 범위와 실제 Jenkins 힙 1932MiB를 맞춘 로컬 비교를 수행한다. 메모리 압박이 확인될 때만 별도 힙 비율 실험을 검토한다. 무제한 JVM 재사용이나 근거 없는 병렬 확대는 제외한다.
|
||||||
@@ -18,6 +18,16 @@
|
|||||||
./gradlew tasks --all
|
./gradlew tasks --all
|
||||||
./gradlew bootRun
|
./gradlew bootRun
|
||||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*'
|
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.CodePointTextSplitterTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageDetectionProviderTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsTranslationServiceTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.AwsLanguageProviderConfigurationTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.TranslationJobRetryIntegrationTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.ContentTagTranslationIntegrationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.CompletedContentTagRepairTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.MetadataLanguageDetectTransactionTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.MetadataTranslationHttpIntegrationTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.AudioContentDetailTranslationHttpIntegrationTest'
|
||||||
|
./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.content.ContentSeriesDetailTranslationHttpIntegrationTest'
|
||||||
./gradlew bootJar
|
./gradlew bootJar
|
||||||
./gradlew ktlintCheck
|
./gradlew ktlintCheck
|
||||||
./gradlew ktlintFormat
|
./gradlew ktlintFormat
|
||||||
@@ -33,3 +43,46 @@
|
|||||||
```
|
```
|
||||||
|
|
||||||
위 명령은 목적에 맞게 하나를 선택한다. 전체 테스트 확인만 필요하면 `./gradlew test`로 충분하다.
|
위 명령은 목적에 맞게 하나를 선택한다. 전체 테스트 확인만 필요하면 `./gradlew test`로 충분하다.
|
||||||
|
|
||||||
|
## 테스트 메모리와 진행 진단
|
||||||
|
- IntelliJ의 `Build, Execution, Deployment > Build Tools > Gradle > Run tests using`을 `Gradle`로 맞추면 CLI와 같은 테스트 JVM 설정을 사용한다. IDE 자체 JUnit runner는 Gradle의 heap/worker 설정을 적용하지 않는다.
|
||||||
|
- 테스트 JVM heap은 Test task 실행 직전에 가용 메모리로 계산한다. 가용 추정의 50%를 유효 동시 worker 수(`min(maxParallelForks, maxWorkers)`)로 나누고, 그 worker 예산의 25%를 힙 외 용도로 남긴다. 나머지 75%를 MiB 단위로 내려 명시적 `maxHeapSize`로 전달한다. 고정 4GiB 정책 하한이나 고정 1GiB 예약은 사용하지 않는다. 단, JVM 실행 자체가 불가능한 2MiB 미만 결과는 상향 보정하지 않고 명시적으로 거부한다.
|
||||||
|
- macOS 가용 추정은 `vm_stat`의 `(Pages free + Pages inactive) × page size`이며 speculative/file-backed를 별도로 더하지 않는다. Linux는 `/proc/meminfo`의 `MemAvailable`을 사용해 회수 가능한 메모리를 반영한다. `MemTotal`과 `MemAvailable`은 kB(1024 bytes)로 읽고 잘못되거나 누락된 값은 추정으로 대체하지 않는다.
|
||||||
|
- Linux에서 JDK의 total memory가 host `MemTotal`보다 작으면 JDK가 인식한 더 작은 제한으로 판단한다. 이 경우에만 host `MemAvailable`, JDK free memory, JDK total memory 중 가장 작은 값을 사용한다. cgroup v1/v2는 Java 17의 컨테이너 인식에 의존하며, `UseContainerSupport` 비활성화·발견 실패·미지원 구성이나 JDK가 인식하지 못한 상위 제한까지 탐지한다고 보장하지 않는다.
|
||||||
|
- macOS/Linux 외에는 JDK의 free-memory 값을 보수적으로 사용한다. 모든 관측은 시작 시점의 추정이며 이후 사용량 변화나 앱 테스트에 충분한 메모리를 보장하지 않는다.
|
||||||
|
- 콘솔의 `Test heap:`에서 관측값·유효 worker 수·선택한 상한을 확인한다. task 시작 때 한 번 계산하며 교체된 worker도 동일한 상한을 사용한다. 메모리 부족 오류가 나면 다른 프로그램/중복 테스트를 정리한 뒤 다시 실행한다. 기존 `maxHeapSize`만 지워 Gradle 기본 512MB로 돌아가거나, 비율 옵션만 추가하는 방식은 사용하지 않는다.
|
||||||
|
- Linux는 `Test memory (Linux):`에 JVM total/free와 최종 가용량도 기록한다. Jenkins 메모리 문제를 조사할 때 이 줄과 `Test heap:`, 최초 OOM 전체 메시지를 함께 확인한다. 전체 빌드 명령의 `org.gradle.jvmargs`는 Gradle JVM 설정이며 테스트 worker heap과 별개다.
|
||||||
|
- 예를 들어 관측값 2,460,004,352 bytes와 worker 1개는 879MiB 힙을 선택한다. 4GiB 미만이라는 이유만으로 중단하지 않지만, 선택된 예산이 앱 테스트의 실제 메모리 요구량보다 작으면 JVM에서 OOM이 발생할 수 있다. 계산 성공을 전체 테스트 통과 보장으로 해석하지 않는다.
|
||||||
|
- 동시 worker 1개, Spring context 캐시 최대 4개, `forkEvery=300`을 사용한다. Gradle이 처리하는 class candidate 수 기준이므로 실제 테스트 개수와 같지 않으며, JUnit Platform 필터 실행에서도 빈 worker가 생길 수 있다. 단일 클래스의 과도한 메모리 사용까지 방지하지는 않는다. Gradle daemon heap과 테스트 worker heap은 별개다. 같은 저장소의 전체 테스트를 IDE와 CLI/에이전트에서 동시에 시작하지 않는다.
|
||||||
|
- 실행 콘솔의 `Test class:`는 클래스 시작 위치이며 완료 또는 성공 표시가 아니다. 최종 종료 코드와 `build/test-results/test/`의 해당 실행 XML을 함께 확인한다.
|
||||||
|
- GC 로그는 `build/test-gc/<task 이름>/gc-<PID>.log`에 기록한다. PID별 10MB 파일과 회전 로그 최대 3개를 사용한다. 오래된 실행 로그는 조사 후 정리한다.
|
||||||
|
- 후반에 진행이 멈추면 해당 worker PID의 `jstat -gcutil <PID>`와 GC 로그를 확인한다. Old 사용률이 높고 Full GC 시간만 증가하는 상태에서는 실행 제한만 늘리지 않는다. 타인이 시작한 worker는 승인 없이 종료하지 않는다.
|
||||||
|
- 힙 예산 build logic를 변경하면 `./gradlew --no-daemon -p buildSrc test --tests 'buildlogic.*'`로 산정·OS 파싱·Linux/container 경계를 검증한다. 이 테스트는 애플리케이션의 root `test`와 별도이며, 일반 root 실행에서 buildSrc 컴파일만 됐다고 테스트까지 통과한 것으로 보지 않는다.
|
||||||
|
- 힙 정책과 테스트는 `buildSrc/src/main/kotlin/buildlogic/TestHeapPolicy.kt`, `buildSrc/src/test/kotlin/buildlogic/TestHeapPolicyTest.kt`에 둔다. buildSrc는 Gradle 버전에 맞는 `kotlin-dsl`과 Java 17 toolchain을 사용하며 앱의 Kotlin 버전과 별도로 관리한다. 해당 Kotlin 소스의 포맷 검사는 `./gradlew --no-daemon -p buildSrc ktlintCheck`로 실행한다.
|
||||||
|
|
||||||
|
## Jenkins 전체 빌드 명령
|
||||||
|
수정된 build logic가 Jenkins workspace에 반영된 뒤 아래 명령을 사용한다. 테스트를 생략하지 않으며, Gradle JVM의 2GB 한도와 테스트 worker의 자동 힙 산정은 별개다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew clean build \
|
||||||
|
--no-daemon \
|
||||||
|
--no-parallel \
|
||||||
|
--max-workers=1 \
|
||||||
|
--console=plain \
|
||||||
|
--stacktrace \
|
||||||
|
'-Dorg.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=768m -Dfile.encoding=UTF-8'
|
||||||
|
```
|
||||||
|
|
||||||
|
별도의 테스트 heap 옵션은 필요하지 않다. Linux에서는 `Test memory (Linux):`와 `Test heap:` 두 로그를 함께 확인한다. 이 명령은 Jenkins/사용자의 전체 검증용이며 에이전트가 자동 실행하는 명령이 아니다.
|
||||||
|
|
||||||
|
빌드 시간이 길면 같은 명령에 `--profile`을 추가해 `build/reports/profile/`에서 컴파일과 테스트 시간을 구분한다. `forkEvery=300`은 1932MiB 힙에서 관련 33개 테스트의 로컬 비교를 거쳐 적용했으며, 실제 Jenkins 전체 suite의 시간·OOM 여부까지 보장한 값은 아니다. 재시작 간격을 추가로 늘리거나 힙/캐시/병렬 수를 함께 바꾸기 전에 해당 환경의 GC와 실행시간을 비교한다.
|
||||||
|
|
||||||
|
## AWS 의존성 확인
|
||||||
|
|
||||||
|
기존 SDK v1은 유지하고 Comprehend/Translate만 SDK v2 BOM `2.57.11`을 사용한다. 기본 동기 HTTP runtime은 전이 의존성이다.
|
||||||
|
Spring Boot 2.7의 HTTP5 하향 관리를 피하도록 SDK POM 기준 `httpclient5.version=5.6.4`, `httpcore5.version=5.4.3`을 맞춘다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon dependencyInsight --dependency org.apache.httpcomponents --configuration runtimeClasspath
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|||||||
@@ -19,6 +19,14 @@
|
|||||||
- Redis가 필요한 통합 테스트만 `@ContextConfiguration(initializers = [EmbeddedRedisInitializer::class])`로 명시적으로 opt-in 한다.
|
- Redis가 필요한 통합 테스트만 `@ContextConfiguration(initializers = [EmbeddedRedisInitializer::class])`로 명시적으로 opt-in 한다.
|
||||||
- Redis가 필요 없는 JPA/QueryDSL 슬라이스 테스트는 기존 관례처럼 `@DataJpaTest(properties = ["spring.cache.type=none"])`로 캐시를 끈다.
|
- Redis가 필요 없는 JPA/QueryDSL 슬라이스 테스트는 기존 관례처럼 `@DataJpaTest(properties = ["spring.cache.type=none"])`로 캐시를 끈다.
|
||||||
|
|
||||||
|
## 테스트 자원 수명과 context 재사용
|
||||||
|
- 같은 종류의 통합 테스트는 기존 properties, profile, initializer, bean override 구성을 우선 재사용한다. 불필요한 클래스별 `@MockBean`/`@SpyBean`·설정 차이는 별도 context를 만든다. 격리를 위한 차이는 유지한다.
|
||||||
|
- Hikari가 관리하는 테스트 H2는 context별 DB 이름을 유지하고 `DB_CLOSE_DELAY=0`을 사용한다. 마지막 연결 종료 뒤에도 DB를 유지해야 하는 테스트는 그 이유와 명시적인 종료 책임을 증명한다. `create-drop`만으로 DB 엔진 종료를 대신하지 않는다.
|
||||||
|
- 상속한 test support에서 서로 다른 Spring context를 만들 수 있다면 H2 이름에 `${random.uuid}`처럼 context별 고유 값을 사용한다. 고정 이름을 공유하면 한 context의 `create-drop` 종료가 다른 context의 테이블을 삭제할 수 있다.
|
||||||
|
- 단순 DB fixture 정리에 `@DirtiesContext`를 추가하지 않는다. rollback 범위 밖의 commit·`REQUIRES_NEW`·비동기 데이터는 테스트가 정리하고, context 상태 복구가 불가능한 경우에만 context를 폐기한다.
|
||||||
|
- 테스트가 만든 executor, client, 임시 서버와 비동기 작업은 실패 경로에서도 정리한다. latch/Future 대기에 제한을 두고, 작업 해제·취소 후 executor 종료 완료를 확인한다.
|
||||||
|
- 메모리 부족을 테스트 skip, assertion 완화, 무조건적인 heap 증설로 해결하지 않는다. GC 로그와 실제 보유 객체, context 수명부터 확인한다. worker 교체는 별도 보호 장치이며 누적 원인 수정의 대체물이 아니다.
|
||||||
|
|
||||||
## 저장 시각·응답 왕복 검증 규칙
|
## 저장 시각·응답 왕복 검증 규칙
|
||||||
- DB 재조회 시각과 API 응답을 비교하는 테스트는 OS의 현재 시각만 사용하지 않는다. 기존 시각 주입 seam을 재사용해
|
- DB 재조회 시각과 API 응답을 비교하는 테스트는 OS의 현재 시각만 사용하지 않는다. 기존 시각 주입 seam을 재사용해
|
||||||
나노초 `0`, `123456789`, `999999999`와 `23:59:59` 같은 초/날짜 경계 입력을 고정한다.
|
나노초 `0`, `123456789`, `999999999`와 `23:59:59` 같은 초/날짜 경계 입력을 고정한다.
|
||||||
|
|||||||
@@ -10,11 +10,16 @@ import kr.co.vividnext.sodalive.aws.s3.S3Uploader
|
|||||||
import kr.co.vividnext.sodalive.common.SodaException
|
import kr.co.vividnext.sodalive.common.SodaException
|
||||||
import kr.co.vividnext.sodalive.content.main.tab.GetContentMainTabItem
|
import kr.co.vividnext.sodalive.content.main.tab.GetContentMainTabItem
|
||||||
import kr.co.vividnext.sodalive.utils.generateFileName
|
import kr.co.vividnext.sodalive.utils.generateFileName
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.toContentSourceSnapshot
|
||||||
import org.springframework.beans.factory.annotation.Value
|
import org.springframework.beans.factory.annotation.Value
|
||||||
import org.springframework.data.domain.Pageable
|
import org.springframework.data.domain.Pageable
|
||||||
import org.springframework.data.repository.findByIdOrNull
|
import org.springframework.data.repository.findByIdOrNull
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
|
import org.springframework.transaction.PlatformTransactionManager
|
||||||
|
import org.springframework.transaction.TransactionDefinition
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
|
import org.springframework.transaction.support.TransactionTemplate
|
||||||
import org.springframework.web.multipart.MultipartFile
|
import org.springframework.web.multipart.MultipartFile
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
@@ -26,9 +31,14 @@ class AdminContentService(
|
|||||||
private val contentMainTabRepository: AdminContentMainTabRepository,
|
private val contentMainTabRepository: AdminContentMainTabRepository,
|
||||||
private val objectMapper: ObjectMapper,
|
private val objectMapper: ObjectMapper,
|
||||||
private val s3Uploader: S3Uploader,
|
private val s3Uploader: S3Uploader,
|
||||||
|
private val sourceInvalidation: ContentTranslationSourceInvalidationService,
|
||||||
|
transactionManager: PlatformTransactionManager,
|
||||||
@Value("\${cloud.aws.s3.bucket}")
|
@Value("\${cloud.aws.s3.bucket}")
|
||||||
private val bucket: String
|
private val bucket: String
|
||||||
) {
|
) {
|
||||||
|
private val uploadTransaction = TransactionTemplate(transactionManager).apply {
|
||||||
|
propagationBehavior = TransactionDefinition.PROPAGATION_NOT_SUPPORTED
|
||||||
|
}
|
||||||
fun getAudioContentList(status: ContentReleaseStatus, pageable: Pageable): GetAdminContentListResponse {
|
fun getAudioContentList(status: ContentReleaseStatus, pageable: Pageable): GetAdminContentListResponse {
|
||||||
val totalCount = repository.getAudioContentTotalCount(status = status)
|
val totalCount = repository.getAudioContentTotalCount(status = status)
|
||||||
val audioContentAndThemeList = repository.getAudioContentList(
|
val audioContentAndThemeList = repository.getAudioContentList(
|
||||||
@@ -95,24 +105,30 @@ class AdminContentService(
|
|||||||
fun updateAudioContent(coverImage: MultipartFile?, requestString: String) {
|
fun updateAudioContent(coverImage: MultipartFile?, requestString: String) {
|
||||||
val requestNode = objectMapper.readTree(requestString)
|
val requestNode = objectMapper.readTree(requestString)
|
||||||
val request = objectMapper.treeToValue(requestNode, UpdateAdminContentRequest::class.java)
|
val request = objectMapper.treeToValue(requestNode, UpdateAdminContentRequest::class.java)
|
||||||
val audioContent = repository.findByIdOrNull(id = request.id)
|
val audioContent = repository.findByIdOrNull(request.id) ?: throw SodaException(messageKey = "admin.content.not_found")
|
||||||
?: throw SodaException(messageKey = "admin.content.not_found")
|
|
||||||
|
|
||||||
if (coverImage != null) {
|
val uploadedCover = if (coverImage != null) {
|
||||||
val metadata = ObjectMetadata()
|
val metadata = ObjectMetadata()
|
||||||
metadata.contentLength = coverImage.size
|
metadata.contentLength = coverImage.size
|
||||||
|
|
||||||
val fileName = generateFileName(prefix = "${request.id}-cover")
|
val fileName = generateFileName(prefix = "${request.id}-cover")
|
||||||
val imagePath = s3Uploader.upload(
|
uploadTransaction.execute {
|
||||||
|
s3Uploader.upload(
|
||||||
inputStream = coverImage.inputStream,
|
inputStream = coverImage.inputStream,
|
||||||
bucket = bucket,
|
bucket = bucket,
|
||||||
filePath = "audio_content_cover/${request.id}/$fileName",
|
filePath = "audio_content_cover/${request.id}/$fileName",
|
||||||
metadata = metadata
|
metadata = metadata
|
||||||
)
|
)
|
||||||
audioContent.coverImage = imagePath
|
|
||||||
} else if (request.isDefaultCoverImage) {
|
|
||||||
audioContent.coverImage = "profile/default_profile.png"
|
|
||||||
}
|
}
|
||||||
|
} else if (request.isDefaultCoverImage) {
|
||||||
|
"profile/default_profile.png"
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
sourceInvalidation.lock(audioContent)
|
||||||
|
val before = audioContent.toContentSourceSnapshot()
|
||||||
|
if (uploadedCover != null) audioContent.coverImage = uploadedCover
|
||||||
|
|
||||||
if (request.isActive != null) {
|
if (request.isActive != null) {
|
||||||
if (!request.isActive) {
|
if (!request.isActive) {
|
||||||
@@ -158,6 +174,8 @@ class AdminContentService(
|
|||||||
}
|
}
|
||||||
audioContent.settlementRatio = request.settlementRatio
|
audioContent.settlementRatio = request.settlementRatio
|
||||||
}
|
}
|
||||||
|
|
||||||
|
sourceInvalidation.invalidateChanged(audioContent, before)
|
||||||
}
|
}
|
||||||
|
|
||||||
fun getContentMainTabList(): List<GetContentMainTabItem> {
|
fun getContentMainTabList(): List<GetContentMainTabItem> {
|
||||||
|
|||||||
+5
@@ -186,6 +186,11 @@ class ChatCharacterController(
|
|||||||
|
|
||||||
var translated: TranslatedAiCharacterDetail? = null
|
var translated: TranslatedAiCharacterDetail? = null
|
||||||
if (langContext.lang.code != character.languageCode) {
|
if (langContext.lang.code != character.languageCode) {
|
||||||
|
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||||
|
LanguageTranslationTargetType.CHARACTER,
|
||||||
|
listOf(characterId),
|
||||||
|
langContext.lang.code
|
||||||
|
)
|
||||||
val existing = aiCharacterTranslationRepository
|
val existing = aiCharacterTranslationRepository
|
||||||
.findByCharacterIdAndLocale(character.id!!, langContext.lang.code)
|
.findByCharacterIdAndLocale(character.id!!, langContext.lang.code)
|
||||||
|
|
||||||
|
|||||||
+9
-2
@@ -28,8 +28,15 @@ class OriginalWorkTranslationService(
|
|||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
|
|
||||||
|
val originalWorkId = requireNotNull(originalWork.id)
|
||||||
|
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||||
|
LanguageTranslationTargetType.ORIGINAL_WORK,
|
||||||
|
listOf(originalWorkId),
|
||||||
|
target
|
||||||
|
)
|
||||||
|
|
||||||
// 기존 번역 조회
|
// 기존 번역 조회
|
||||||
val existed = translationRepository.findByOriginalWorkIdAndLocale(originalWork.id!!, target)
|
val existed = translationRepository.findByOriginalWorkIdAndLocale(originalWorkId, target)
|
||||||
val existedPayload = existed?.renderedPayload
|
val existedPayload = existed?.renderedPayload
|
||||||
if (existedPayload != null) {
|
if (existedPayload != null) {
|
||||||
val t = existedPayload.title.trim()
|
val t = existedPayload.title.trim()
|
||||||
@@ -51,7 +58,7 @@ class OriginalWorkTranslationService(
|
|||||||
|
|
||||||
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
||||||
resourceType = LanguageTranslationTargetType.ORIGINAL_WORK,
|
resourceType = LanguageTranslationTargetType.ORIGINAL_WORK,
|
||||||
resourceId = originalWork.id!!,
|
resourceId = originalWorkId,
|
||||||
targetLanguage = target
|
targetLanguage = target
|
||||||
)
|
)
|
||||||
return null
|
return null
|
||||||
|
|||||||
@@ -157,6 +157,13 @@ class SecurityConfig(
|
|||||||
JwtFilter::class.java
|
JwtFilter::class.java
|
||||||
)
|
)
|
||||||
.authorizeRequests()
|
.authorizeRequests()
|
||||||
|
.antMatchers("/internal/api/subtitle-jobs/**")
|
||||||
|
.access(
|
||||||
|
"hasRole('BOT') and " +
|
||||||
|
"principal instanceof T(kr.co.vividnext.sodalive.member.MemberAdapter) and " +
|
||||||
|
"principal.member.role == T(kr.co.vividnext.sodalive.member.MemberRole).BOT and " +
|
||||||
|
"principal.member.isActive"
|
||||||
|
)
|
||||||
.antMatchers("/readyz").permitAll()
|
.antMatchers("/readyz").permitAll()
|
||||||
.requestMatchers(EndpointRequest.toAnyEndpoint()).permitAll()
|
.requestMatchers(EndpointRequest.toAnyEndpoint()).permitAll()
|
||||||
.antMatchers("/member/check/email").permitAll()
|
.antMatchers("/member/check/email").permitAll()
|
||||||
|
|||||||
@@ -52,6 +52,9 @@ data class AudioContent(
|
|||||||
var content: String? = null
|
var content: String? = null
|
||||||
var coverImage: String? = null
|
var coverImage: String? = null
|
||||||
|
|
||||||
|
@Column(length = 36)
|
||||||
|
var latestSubtitleJobId: String? = null
|
||||||
|
|
||||||
@OneToOne(fetch = FetchType.EAGER)
|
@OneToOne(fetch = FetchType.EAGER)
|
||||||
@JoinColumn(name = "theme_id", nullable = false)
|
@JoinColumn(name = "theme_id", nullable = false)
|
||||||
var theme: AudioContentTheme? = null
|
var theme: AudioContentTheme? = null
|
||||||
|
|||||||
+143
@@ -0,0 +1,143 @@
|
|||||||
|
package kr.co.vividnext.sodalive.content
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslationPayload
|
||||||
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
||||||
|
import kr.co.vividnext.sodalive.content.translation.TranslatedContent
|
||||||
|
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.v2.contenttranslation.application.ContentTranslationLanguageService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationWriteService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.toContentSourceSnapshot
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentSourceSnapshot
|
||||||
|
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 AudioContentDetailTranslationResult(
|
||||||
|
val languageCode: String?,
|
||||||
|
val translated: TranslatedContent? = null,
|
||||||
|
val detectionQuery: String? = null
|
||||||
|
)
|
||||||
|
|
||||||
|
@Service
|
||||||
|
class AudioContentDetailTranslationService(
|
||||||
|
private val repository: AudioContentRepository,
|
||||||
|
private val translations: ContentTranslationRepository,
|
||||||
|
private val languageService: ContentTranslationLanguageService,
|
||||||
|
private val sourceInvalidation: ContentTranslationSourceInvalidationService,
|
||||||
|
private val writer: ContentTranslationWriteService,
|
||||||
|
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(contentId: Long, targetLanguage: String): AudioContentDetailTranslationResult {
|
||||||
|
var source = transaction.execute { snapshot(contentId) } ?: return AudioContentDetailTranslationResult(null)
|
||||||
|
if (source.sourceLanguage.isNullOrBlank()) {
|
||||||
|
try {
|
||||||
|
source = languageService.detectMissing(contentId) ?: return AudioContentDetailTranslationResult(null)
|
||||||
|
} catch (ex: Exception) {
|
||||||
|
log.warn("Content detail language detection failed. contentId={}, error={}", contentId, ex.message)
|
||||||
|
return AudioContentDetailTranslationResult(source.sourceLanguage, detectionQuery = source.detectionQuery)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
val target = targetLanguage.lowercase()
|
||||||
|
val existing = transaction.execute {
|
||||||
|
val content = writer.lockContent(contentId) ?: return@execute null
|
||||||
|
sourceInvalidation.invalidateStale(content)
|
||||||
|
source = content.toContentSourceSnapshot()
|
||||||
|
translations.findByContentIdAndLocale(contentId, target)?.let {
|
||||||
|
entityManager.refresh(it, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
it.renderedPayload
|
||||||
|
}
|
||||||
|
}
|
||||||
|
val language = source.sourceLanguage
|
||||||
|
if (language.isNullOrBlank()) return AudioContentDetailTranslationResult(language, detectionQuery = source.detectionQuery)
|
||||||
|
if (
|
||||||
|
!TranslationLanguages.isSupported(language) || !TranslationLanguages.isSupported(target) ||
|
||||||
|
language.lowercase() == target
|
||||||
|
) {
|
||||||
|
return AudioContentDetailTranslationResult(language)
|
||||||
|
}
|
||||||
|
if (existing != null) {
|
||||||
|
maintainRetries(contentId, target, scheduleMissing = false)
|
||||||
|
return result(language, existing)
|
||||||
|
}
|
||||||
|
|
||||||
|
return try {
|
||||||
|
source.fields.forEach { field ->
|
||||||
|
val approved = transaction.execute { writer.hasCurrentApproval(contentId, target, field.fieldKey) } == true
|
||||||
|
if (!approved) {
|
||||||
|
memories.ensureMemory(
|
||||||
|
LanguageTranslationTargetType.CONTENT,
|
||||||
|
field.fieldKey,
|
||||||
|
field.sourceText,
|
||||||
|
language,
|
||||||
|
target
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
val payload = transaction.execute {
|
||||||
|
writer.lockContent(contentId)
|
||||||
|
check(snapshot(contentId) == source) { "content translation source changed" }
|
||||||
|
check(materializer.materialize(LanguageTranslationTargetType.CONTENT, contentId, target)) {
|
||||||
|
"content translation is incomplete"
|
||||||
|
}
|
||||||
|
requireNotNull(translations.findByContentIdAndLocale(contentId, target)).renderedPayload
|
||||||
|
}
|
||||||
|
maintainRetries(contentId, target, scheduleMissing = false)
|
||||||
|
result(language, requireNotNull(payload))
|
||||||
|
} catch (ex: Exception) {
|
||||||
|
log.warn("Content detail translation failed. contentId={}, locale={}, error={}", contentId, target, ex.message)
|
||||||
|
maintainRetries(contentId, target, scheduleMissing = true)
|
||||||
|
AudioContentDetailTranslationResult(language)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun maintainRetries(contentId: Long, target: String, scheduleMissing: Boolean) {
|
||||||
|
try {
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
scheduler.restartFailedResourceTranslationsInCurrentTransaction(
|
||||||
|
LanguageTranslationTargetType.CONTENT,
|
||||||
|
listOf(contentId),
|
||||||
|
target
|
||||||
|
)
|
||||||
|
if (scheduleMissing) {
|
||||||
|
scheduler.scheduleResourceTranslation(LanguageTranslationTargetType.CONTENT, contentId, target)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (ex: Exception) {
|
||||||
|
log.warn(
|
||||||
|
"Content detail translation retry request failed. contentId={}, locale={}, error={}",
|
||||||
|
contentId,
|
||||||
|
target,
|
||||||
|
ex.message
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun result(language: String, payload: ContentTranslationPayload) = AudioContentDetailTranslationResult(
|
||||||
|
language,
|
||||||
|
TranslatedContent(payload.title, payload.detail, payload.tags)
|
||||||
|
)
|
||||||
|
|
||||||
|
private fun snapshot(contentId: Long): ContentSourceSnapshot? =
|
||||||
|
repository.findById(contentId).orElse(null)?.toContentSourceSnapshot()
|
||||||
|
}
|
||||||
@@ -23,7 +23,6 @@ import kr.co.vividnext.sodalive.content.pin.PinContentRepository
|
|||||||
import kr.co.vividnext.sodalive.content.theme.AudioContentThemeQueryRepository
|
import kr.co.vividnext.sodalive.content.theme.AudioContentThemeQueryRepository
|
||||||
import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslationRepository
|
import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslationRepository
|
||||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
||||||
import kr.co.vividnext.sodalive.content.translation.TranslatedContent
|
|
||||||
import kr.co.vividnext.sodalive.explorer.ExplorerQueryRepository
|
import kr.co.vividnext.sodalive.explorer.ExplorerQueryRepository
|
||||||
import kr.co.vividnext.sodalive.extensions.convertLocalDateTime
|
import kr.co.vividnext.sodalive.extensions.convertLocalDateTime
|
||||||
import kr.co.vividnext.sodalive.fcm.FcmDeepLinkValue
|
import kr.co.vividnext.sodalive.fcm.FcmDeepLinkValue
|
||||||
@@ -34,24 +33,30 @@ import kr.co.vividnext.sodalive.i18n.LangContext
|
|||||||
import kr.co.vividnext.sodalive.i18n.SodaMessageSource
|
import kr.co.vividnext.sodalive.i18n.SodaMessageSource
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationEvent
|
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationEvent
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
|
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.ResourceTranslationJobScheduler
|
|
||||||
import kr.co.vividnext.sodalive.member.Member
|
import kr.co.vividnext.sodalive.member.Member
|
||||||
import kr.co.vividnext.sodalive.member.MemberRepository
|
import kr.co.vividnext.sodalive.member.MemberRepository
|
||||||
import kr.co.vividnext.sodalive.member.block.BlockMemberRepository
|
import kr.co.vividnext.sodalive.member.block.BlockMemberRepository
|
||||||
import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
|
import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
|
||||||
import kr.co.vividnext.sodalive.utils.generateFileName
|
import kr.co.vividnext.sodalive.utils.generateFileName
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.toContentSourceSnapshot
|
||||||
import kr.co.vividnext.sodalive.v2.creatorname.application.CreatorLocalizedNameService
|
import kr.co.vividnext.sodalive.v2.creatorname.application.CreatorLocalizedNameService
|
||||||
import kr.co.vividnext.sodalive.v2.home.following.application.HomeFollowingNewsPublishService
|
import kr.co.vividnext.sodalive.v2.home.following.application.HomeFollowingNewsPublishService
|
||||||
import kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryService
|
import kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryService
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.application.SubtitleJobService
|
||||||
import org.slf4j.LoggerFactory
|
import org.slf4j.LoggerFactory
|
||||||
import org.springframework.beans.factory.annotation.Value
|
import org.springframework.beans.factory.annotation.Value
|
||||||
import org.springframework.cache.annotation.Cacheable
|
import org.springframework.cache.annotation.Cacheable
|
||||||
import org.springframework.context.ApplicationEventPublisher
|
import org.springframework.context.ApplicationEventPublisher
|
||||||
import org.springframework.data.repository.findByIdOrNull
|
import org.springframework.data.repository.findByIdOrNull
|
||||||
import org.springframework.stereotype.Service
|
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.annotation.Transactional
|
||||||
import org.springframework.transaction.support.TransactionSynchronization
|
import org.springframework.transaction.support.TransactionSynchronization
|
||||||
import org.springframework.transaction.support.TransactionSynchronizationManager
|
import org.springframework.transaction.support.TransactionSynchronizationManager
|
||||||
|
import org.springframework.transaction.support.TransactionTemplate
|
||||||
import org.springframework.web.multipart.MultipartFile
|
import org.springframework.web.multipart.MultipartFile
|
||||||
import java.text.SimpleDateFormat
|
import java.text.SimpleDateFormat
|
||||||
import java.time.LocalDateTime
|
import java.time.LocalDateTime
|
||||||
@@ -78,8 +83,8 @@ class AudioContentService(
|
|||||||
private val pinContentRepository: PinContentRepository,
|
private val pinContentRepository: PinContentRepository,
|
||||||
private val memberRepository: MemberRepository,
|
private val memberRepository: MemberRepository,
|
||||||
|
|
||||||
private val resourceTranslationJobScheduler: ResourceTranslationJobScheduler,
|
|
||||||
private val contentTranslationRepository: ContentTranslationRepository,
|
private val contentTranslationRepository: ContentTranslationRepository,
|
||||||
|
private val detailTranslationService: AudioContentDetailTranslationService,
|
||||||
|
|
||||||
private val s3Uploader: S3Uploader,
|
private val s3Uploader: S3Uploader,
|
||||||
private val objectMapper: ObjectMapper,
|
private val objectMapper: ObjectMapper,
|
||||||
@@ -93,6 +98,9 @@ class AudioContentService(
|
|||||||
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
||||||
private val homeFollowingNewsPublishService: HomeFollowingNewsPublishService,
|
private val homeFollowingNewsPublishService: HomeFollowingNewsPublishService,
|
||||||
private val memberContentPreferenceService: MemberContentPreferenceService,
|
private val memberContentPreferenceService: MemberContentPreferenceService,
|
||||||
|
private val subtitleJobService: SubtitleJobService,
|
||||||
|
private val sourceInvalidation: ContentTranslationSourceInvalidationService,
|
||||||
|
transactionManager: PlatformTransactionManager,
|
||||||
|
|
||||||
@Value("\${cloud.aws.s3.content-bucket}")
|
@Value("\${cloud.aws.s3.content-bucket}")
|
||||||
private val audioContentBucket: String,
|
private val audioContentBucket: String,
|
||||||
@@ -104,6 +112,12 @@ class AudioContentService(
|
|||||||
private val coverImageHost: String
|
private val coverImageHost: String
|
||||||
) {
|
) {
|
||||||
private val log = LoggerFactory.getLogger(javaClass)
|
private val log = LoggerFactory.getLogger(javaClass)
|
||||||
|
private val registrationTransaction = TransactionTemplate(transactionManager).apply {
|
||||||
|
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
|
||||||
|
}
|
||||||
|
private val uploadTransaction = TransactionTemplate(transactionManager).apply {
|
||||||
|
propagationBehavior = TransactionDefinition.PROPAGATION_NOT_SUPPORTED
|
||||||
|
}
|
||||||
|
|
||||||
@Transactional
|
@Transactional
|
||||||
fun audioContentLike(request: PutAudioContentLikeRequest, member: Member): PutAudioContentLikeResponse {
|
fun audioContentLike(request: PutAudioContentLikeRequest, member: Member): PutAudioContentLikeResponse {
|
||||||
@@ -137,13 +151,7 @@ class AudioContentService(
|
|||||||
val audioContent = repository.findByIdAndCreatorId(request.contentId, member.id!!)
|
val audioContent = repository.findByIdAndCreatorId(request.contentId, member.id!!)
|
||||||
?: throw SodaException(messageKey = "content.error.invalid_content_retry")
|
?: throw SodaException(messageKey = "content.error.invalid_content_retry")
|
||||||
|
|
||||||
if (request.title != null) audioContent.title = request.title
|
val uploadedCover = if (coverImage != null) {
|
||||||
if (request.detail != null) audioContent.detail = request.detail
|
|
||||||
if (request.isPointAvailable != null) audioContent.isPointAvailable = request.isPointAvailable
|
|
||||||
audioContent.isCommentAvailable = request.isCommentAvailable
|
|
||||||
audioContent.isAdult = request.isAdult
|
|
||||||
|
|
||||||
if (coverImage != null) {
|
|
||||||
val metadata = ObjectMetadata()
|
val metadata = ObjectMetadata()
|
||||||
metadata.contentLength = coverImage.size
|
metadata.contentLength = coverImage.size
|
||||||
|
|
||||||
@@ -151,15 +159,27 @@ class AudioContentService(
|
|||||||
val coverImageFileName = generateFileName(prefix = "${audioContent.id}-cover")
|
val coverImageFileName = generateFileName(prefix = "${audioContent.id}-cover")
|
||||||
|
|
||||||
// 커버 이미지 업로드
|
// 커버 이미지 업로드
|
||||||
val coverImagePath = s3Uploader.upload(
|
uploadTransaction.execute {
|
||||||
|
s3Uploader.upload(
|
||||||
inputStream = coverImage.inputStream,
|
inputStream = coverImage.inputStream,
|
||||||
bucket = coverImageBucket,
|
bucket = coverImageBucket,
|
||||||
filePath = "audio_content_cover/${audioContent.id}/$coverImageFileName",
|
filePath = "audio_content_cover/${audioContent.id}/$coverImageFileName",
|
||||||
metadata = metadata
|
metadata = metadata
|
||||||
)
|
)
|
||||||
|
|
||||||
audioContent.coverImage = coverImagePath
|
|
||||||
}
|
}
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
sourceInvalidation.lock(audioContent)
|
||||||
|
if (audioContent.member?.id != member.id) throw SodaException(messageKey = "content.error.invalid_content_retry")
|
||||||
|
val before = audioContent.toContentSourceSnapshot()
|
||||||
|
if (request.title != null) audioContent.title = request.title
|
||||||
|
if (request.detail != null) audioContent.detail = request.detail
|
||||||
|
if (request.isPointAvailable != null) audioContent.isPointAvailable = request.isPointAvailable
|
||||||
|
audioContent.isCommentAvailable = request.isCommentAvailable
|
||||||
|
audioContent.isAdult = request.isAdult
|
||||||
|
if (uploadedCover != null) audioContent.coverImage = uploadedCover
|
||||||
|
|
||||||
if (!request.tags.isNullOrBlank()) {
|
if (!request.tags.isNullOrBlank()) {
|
||||||
val normalizedTags = request.tags
|
val normalizedTags = request.tags
|
||||||
@@ -193,22 +213,18 @@ class AudioContentService(
|
|||||||
audioContentHashTag
|
audioContentHashTag
|
||||||
}
|
}
|
||||||
|
|
||||||
audioContent.audioContentHashTags.addAll(newAudioContentHashTagList)
|
val added = newAudioContentHashTagList.filter { it !in audioContent.audioContentHashTags }
|
||||||
|
audioContent.audioContentHashTags.addAll(added)
|
||||||
}
|
}
|
||||||
|
sourceInvalidation.invalidateChanged(audioContent, before)
|
||||||
applicationEventPublisher.publishEvent(
|
|
||||||
LanguageTranslationEvent(
|
|
||||||
id = request.contentId,
|
|
||||||
targetType = LanguageTranslationTargetType.CONTENT,
|
|
||||||
waitTransactionCommit = true
|
|
||||||
)
|
|
||||||
)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Transactional
|
@Transactional
|
||||||
fun deleteAudioContent(audioContentId: Long, member: Member) {
|
fun deleteAudioContent(audioContentId: Long, member: Member) {
|
||||||
val audioContent = repository.findByIdAndCreatorId(audioContentId, member.id!!)
|
val audioContent = repository.findByIdAndCreatorId(audioContentId, member.id!!)
|
||||||
?: throw SodaException(messageKey = "content.error.invalid_content_retry")
|
?: throw SodaException(messageKey = "content.error.invalid_content_retry")
|
||||||
|
sourceInvalidation.lock(audioContent)
|
||||||
|
if (audioContent.member?.id != member.id) throw SodaException(messageKey = "content.error.invalid_content_retry")
|
||||||
|
|
||||||
val pinContent = pinContentRepository.findByContentIdAndMemberId(
|
val pinContent = pinContentRepository.findByContentIdAndMemberId(
|
||||||
contentId = audioContentId,
|
contentId = audioContentId,
|
||||||
@@ -220,7 +236,7 @@ class AudioContentService(
|
|||||||
pinContent?.isActive = false
|
pinContent?.isActive = false
|
||||||
}
|
}
|
||||||
|
|
||||||
@Transactional
|
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||||
fun createAudioContent(
|
fun createAudioContent(
|
||||||
contentFile: MultipartFile?,
|
contentFile: MultipartFile?,
|
||||||
coverImage: MultipartFile?,
|
coverImage: MultipartFile?,
|
||||||
@@ -245,7 +261,7 @@ class AudioContentService(
|
|||||||
return createAudioContent(contentFile, coverImage, request, releaseDate, member)
|
return createAudioContent(contentFile, coverImage, request, releaseDate, member)
|
||||||
}
|
}
|
||||||
|
|
||||||
@Transactional
|
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||||
fun createAudioContent(
|
fun createAudioContent(
|
||||||
contentFile: MultipartFile?,
|
contentFile: MultipartFile?,
|
||||||
coverImage: MultipartFile?,
|
coverImage: MultipartFile?,
|
||||||
@@ -260,6 +276,8 @@ class AudioContentService(
|
|||||||
throw SodaException(messageKey = "content.error.content_required")
|
throw SodaException(messageKey = "content.error.content_required")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
val registration = requireNotNull(
|
||||||
|
registrationTransaction.execute {
|
||||||
validatePreviewTime(request.previewStartTime, request.previewEndTime)
|
validatePreviewTime(request.previewStartTime, request.previewEndTime)
|
||||||
|
|
||||||
// 테마 체크
|
// 테마 체크
|
||||||
@@ -348,7 +366,7 @@ class AudioContentService(
|
|||||||
audioContent.audioContentHashTags.addAll(tags)
|
audioContent.audioContentHashTags.addAll(tags)
|
||||||
}
|
}
|
||||||
|
|
||||||
var metadata = ObjectMetadata()
|
val metadata = ObjectMetadata()
|
||||||
metadata.contentLength = coverImage.size
|
metadata.contentLength = coverImage.size
|
||||||
|
|
||||||
// 커버 이미지 파일명 생성
|
// 커버 이미지 파일명 생성
|
||||||
@@ -363,12 +381,13 @@ class AudioContentService(
|
|||||||
)
|
)
|
||||||
|
|
||||||
audioContent.coverImage = coverImagePath
|
audioContent.coverImage = coverImagePath
|
||||||
|
audioContent to subtitleJobService.register(audioContent, contentFile.originalFilename)
|
||||||
// 콘텐츠 파일명 생성
|
}
|
||||||
val contentFileName = generateFileName(prefix = "${audioContent.id}-content")
|
)
|
||||||
|
val (audioContent, subtitleJob) = registration
|
||||||
|
|
||||||
// 콘텐츠 파일 업로드
|
// 콘텐츠 파일 업로드
|
||||||
metadata = ObjectMetadata()
|
val metadata = ObjectMetadata()
|
||||||
metadata.contentLength = contentFile.size
|
metadata.contentLength = contentFile.size
|
||||||
metadata.addUserMetadata(
|
metadata.addUserMetadata(
|
||||||
"generate_preview",
|
"generate_preview",
|
||||||
@@ -384,24 +403,25 @@ class AudioContentService(
|
|||||||
metadata.addUserMetadata("preview_end_time", request.previewEndTime)
|
metadata.addUserMetadata("preview_end_time", request.previewEndTime)
|
||||||
}
|
}
|
||||||
|
|
||||||
val contentPath = s3Uploader.upload(
|
try {
|
||||||
inputStream = contentFile.inputStream,
|
contentFile.inputStream.use { inputStream ->
|
||||||
|
s3Uploader.upload(
|
||||||
|
inputStream = inputStream,
|
||||||
bucket = audioContentBucket,
|
bucket = audioContentBucket,
|
||||||
filePath = "input/${audioContent.id}/$contentFileName",
|
filePath = subtitleJob.sourceKey,
|
||||||
metadata = metadata
|
metadata = metadata
|
||||||
)
|
)
|
||||||
|
}
|
||||||
|
} catch (exception: Exception) {
|
||||||
|
subtitleJobService.recordUploadError(subtitleJob.jobId)
|
||||||
|
throw exception
|
||||||
|
}
|
||||||
|
|
||||||
audioContent.content = contentPath
|
registrationTransaction.executeWithoutResult {
|
||||||
|
|
||||||
// 언어 코드가 지정되지 않은 경우, 파파고 언어 감지 API를 통해 비동기로 언어를 식별한다.
|
// 언어 코드가 지정되지 않은 경우, 파파고 언어 감지 API를 통해 비동기로 언어를 식별한다.
|
||||||
if (audioContent.languageCode.isNullOrBlank()) {
|
if (audioContent.languageCode.isNullOrBlank()) {
|
||||||
val papagoQuery = listOf(
|
val papagoQuery = repository.findByIdOrNull(requireNotNull(audioContent.id))
|
||||||
request.title.trim(),
|
?.toContentSourceSnapshot()?.detectionQuery ?: return@executeWithoutResult
|
||||||
request.detail.trim(),
|
|
||||||
request.tags.trim()
|
|
||||||
)
|
|
||||||
.filter { it.isNotBlank() }
|
|
||||||
.joinToString(" ")
|
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
applicationEventPublisher.publishEvent(
|
||||||
LanguageDetectEvent(
|
LanguageDetectEvent(
|
||||||
@@ -417,6 +437,7 @@ class AudioContentService(
|
|||||||
)
|
)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
return CreateAudioContentResponse(contentId = audioContent.id!!)
|
return CreateAudioContentResponse(contentId = audioContent.id!!)
|
||||||
}
|
}
|
||||||
@@ -481,11 +502,13 @@ class AudioContentService(
|
|||||||
|
|
||||||
@Transactional
|
@Transactional
|
||||||
fun uploadComplete(contentId: Long, content: String, duration: String) {
|
fun uploadComplete(contentId: Long, content: String, duration: String) {
|
||||||
val keyFileName = content.split("/").last()
|
val registeredOutputMatches = subtitleJobService.matchesOutput(contentId, content)
|
||||||
if (!keyFileName.startsWith(contentId.toString())) throw SodaException(messageKey = "common.error.invalid_request")
|
val validOutput = registeredOutputMatches ?: content.substringAfterLast("/").startsWith(contentId.toString())
|
||||||
|
if (!validOutput) throw SodaException(messageKey = "common.error.invalid_request")
|
||||||
|
|
||||||
val audioContent = repository.findByIdOrNull(contentId)
|
val audioContent = repository.findByIdOrNull(contentId)
|
||||||
?: throw SodaException(messageKey = "common.error.invalid_request")
|
?: throw SodaException(messageKey = "common.error.invalid_request")
|
||||||
|
sourceInvalidation.lock(audioContent)
|
||||||
|
|
||||||
audioContent.content = content
|
audioContent.content = content
|
||||||
audioContent.duration = duration
|
audioContent.duration = duration
|
||||||
@@ -537,7 +560,14 @@ class AudioContentService(
|
|||||||
fun releaseContent() {
|
fun releaseContent() {
|
||||||
val notReleasedAudioContent = repository.getNotReleaseContent()
|
val notReleasedAudioContent = repository.getNotReleaseContent()
|
||||||
|
|
||||||
for (audioContent in notReleasedAudioContent) {
|
for (audioContent in notReleasedAudioContent.sortedBy { it.id }) {
|
||||||
|
sourceInvalidation.lock(audioContent)
|
||||||
|
if (
|
||||||
|
audioContent.isActive || audioContent.releaseDate == null || audioContent.releaseDate!! > LocalDateTime.now() ||
|
||||||
|
audioContent.duration == null
|
||||||
|
) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
audioContent.isActive = true
|
audioContent.isActive = true
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
applicationEventPublisher.publishEvent(
|
||||||
@@ -781,6 +811,24 @@ class AudioContentService(
|
|||||||
isAdult = isAdult
|
isAdult = isAdult
|
||||||
)
|
)
|
||||||
|
|
||||||
|
val relatedContentIds = listOfNotNull(previousContent, nextContent)
|
||||||
|
.plus(creatorOtherContentList)
|
||||||
|
.plus(sameThemeOtherContentList)
|
||||||
|
.map { it.contentId }
|
||||||
|
.distinct()
|
||||||
|
val relatedTranslations = if (relatedContentIds.isNotEmpty()) {
|
||||||
|
contentTranslationRepository
|
||||||
|
.findByContentIdInAndLocale(contentIds = relatedContentIds, locale = langContext.lang.code)
|
||||||
|
.associateBy { it.contentId }
|
||||||
|
} else {
|
||||||
|
emptyMap()
|
||||||
|
}
|
||||||
|
|
||||||
|
fun translateRelatedContent(item: OtherContentResponse): OtherContentResponse {
|
||||||
|
val translatedTitle = relatedTranslations[item.contentId]?.renderedPayload?.title
|
||||||
|
return if (translatedTitle.isNullOrBlank()) item else item.copy(title = translatedTitle)
|
||||||
|
}
|
||||||
|
|
||||||
val likeCount = audioContentLikeRepository.totalCountAudioContentLike(contentId = id)
|
val likeCount = audioContentLikeRepository.totalCountAudioContentLike(contentId = id)
|
||||||
val isLike = audioContentLikeRepository.findByMemberIdAndContentId(
|
val isLike = audioContentLikeRepository.findByMemberIdAndContentId(
|
||||||
memberId = member.id!!,
|
memberId = member.id!!,
|
||||||
@@ -854,45 +902,15 @@ class AudioContentService(
|
|||||||
listOf()
|
listOf()
|
||||||
}
|
}
|
||||||
|
|
||||||
var translated: TranslatedContent? = null
|
val translation = detailTranslationService.resolve(id, langContext.lang.code)
|
||||||
|
if (translation.detectionQuery != null) {
|
||||||
/**
|
applicationEventPublisher.publishEvent(
|
||||||
* audioContent.languageCode != languageCode
|
LanguageDetectEvent(
|
||||||
*
|
id = id,
|
||||||
* 번역 콘텐츠를 조회한다. - contentId, locale
|
query = translation.detectionQuery
|
||||||
* 번역 콘텐츠가 있으면
|
|
||||||
* TranslatedContent로 가공한다
|
|
||||||
*
|
|
||||||
* 번역 콘텐츠가 없으면
|
|
||||||
* 누락 번역 job을 예약하고 원문 응답을 유지한다.
|
|
||||||
*
|
|
||||||
* 번역 대상: title, detail, tags
|
|
||||||
*
|
|
||||||
* 파파고로 번역한 데이터를 TranslatedContent로 가공한다
|
|
||||||
*/
|
|
||||||
if (
|
|
||||||
audioContent.languageCode != null &&
|
|
||||||
audioContent.languageCode!!.isNotBlank() &&
|
|
||||||
audioContent.languageCode != langContext.lang.code
|
|
||||||
) {
|
|
||||||
val existing = contentTranslationRepository
|
|
||||||
.findByContentIdAndLocale(audioContent.id!!, langContext.lang.code)
|
|
||||||
|
|
||||||
if (existing != null) {
|
|
||||||
val payload = existing.renderedPayload
|
|
||||||
translated = TranslatedContent(
|
|
||||||
title = payload.title,
|
|
||||||
detail = payload.detail,
|
|
||||||
tags = payload.tags
|
|
||||||
)
|
)
|
||||||
} else {
|
|
||||||
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
|
||||||
resourceType = LanguageTranslationTargetType.CONTENT,
|
|
||||||
resourceId = audioContent.id!!,
|
|
||||||
targetLanguage = langContext.lang.code
|
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* themeStr 번역 처리
|
* themeStr 번역 처리
|
||||||
@@ -933,7 +951,7 @@ class AudioContentService(
|
|||||||
contentId = audioContent.id!!,
|
contentId = audioContent.id!!,
|
||||||
title = audioContent.title,
|
title = audioContent.title,
|
||||||
detail = contentDetail,
|
detail = contentDetail,
|
||||||
languageCode = audioContent.languageCode,
|
languageCode = translation.languageCode,
|
||||||
coverImageUrl = "$coverImageHost/${audioContent.coverImage!!}",
|
coverImageUrl = "$coverImageHost/${audioContent.coverImage!!}",
|
||||||
contentUrl = audioContentUrl,
|
contentUrl = audioContentUrl,
|
||||||
themeStr = themeStrTranslated,
|
themeStr = themeStrTranslated,
|
||||||
@@ -953,8 +971,8 @@ class AudioContentService(
|
|||||||
purchaseOption = purchaseOption,
|
purchaseOption = purchaseOption,
|
||||||
orderType = orderType,
|
orderType = orderType,
|
||||||
remainingTime = remainingTime,
|
remainingTime = remainingTime,
|
||||||
creatorOtherContentList = creatorOtherContentList,
|
creatorOtherContentList = creatorOtherContentList.map(::translateRelatedContent),
|
||||||
sameThemeOtherContentList = sameThemeOtherContentList,
|
sameThemeOtherContentList = sameThemeOtherContentList.map(::translateRelatedContent),
|
||||||
isCommentAvailable = audioContent.isCommentAvailable,
|
isCommentAvailable = audioContent.isCommentAvailable,
|
||||||
isLike = isLike,
|
isLike = isLike,
|
||||||
likeCount = likeCount,
|
likeCount = likeCount,
|
||||||
@@ -974,11 +992,23 @@ class AudioContentService(
|
|||||||
isFollow = creatorFollowing?.isFollow ?: false,
|
isFollow = creatorFollowing?.isFollow ?: false,
|
||||||
isNotify = creatorFollowing?.isNotify ?: false
|
isNotify = creatorFollowing?.isNotify ?: false
|
||||||
),
|
),
|
||||||
previousContent = previousContent,
|
previousContent = previousContent?.let(::translateRelatedContent),
|
||||||
nextContent = nextContent,
|
nextContent = nextContent?.let(::translateRelatedContent),
|
||||||
buyerList = buyerList,
|
buyerList = buyerList,
|
||||||
isAvailableUsePoint = audioContent.isPointAvailable && audioContent.price > 0,
|
isAvailableUsePoint = audioContent.isPointAvailable && audioContent.price > 0,
|
||||||
translated = translated
|
translated = translation.translated,
|
||||||
|
subtitle = if (
|
||||||
|
(isExistsAudioContent || creatorId == member.id || audioContent.price <= 0) &&
|
||||||
|
(audioContent.releaseDate == null || audioContent.releaseDate!! <= LocalDateTime.now() || creatorId == member.id)
|
||||||
|
) {
|
||||||
|
subtitleJobService.subtitle(
|
||||||
|
audioContent,
|
||||||
|
langContext.lang,
|
||||||
|
1000 * 60 * 60 * ((audioContent.duration ?: "00:00:00").split(":")[0].toLong() + 2)
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1302,16 +1332,25 @@ class AudioContentService(
|
|||||||
contentId = audioContent.id!!
|
contentId = audioContent.id!!
|
||||||
)
|
)
|
||||||
|
|
||||||
val contentUrl = if (isExistsAudioContent) {
|
return if (isExistsAudioContent) {
|
||||||
audioContentCloudFront.generateSignedURL(
|
val expirationTime = 1000 * 60 * 60 * (audioContent.duration!!.split(":")[0].toLong() + 2)
|
||||||
|
GenerateUrlResponse(
|
||||||
|
contentUrl = audioContentCloudFront.generateSignedURL(
|
||||||
resourcePath = audioContent.content!!,
|
resourcePath = audioContent.content!!,
|
||||||
expirationTime = 1000 * 60 * 60 * (audioContent.duration!!.split(":")[0].toLong() + 2)
|
expirationTime = expirationTime
|
||||||
|
),
|
||||||
|
subtitle = if (
|
||||||
|
audioContent.releaseDate == null || audioContent.releaseDate!! <= LocalDateTime.now() ||
|
||||||
|
audioContent.member!!.id == member.id
|
||||||
|
) {
|
||||||
|
subtitleJobService.subtitle(audioContent, langContext.lang, expirationTime)
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
)
|
)
|
||||||
} else {
|
} else {
|
||||||
""
|
GenerateUrlResponse("")
|
||||||
}
|
}
|
||||||
|
|
||||||
return GenerateUrlResponse(contentUrl)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Transactional(readOnly = true)
|
@Transactional(readOnly = true)
|
||||||
|
|||||||
@@ -1,5 +1,8 @@
|
|||||||
package kr.co.vividnext.sodalive.content
|
package kr.co.vividnext.sodalive.content
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.ContentSubtitleResponse
|
||||||
|
|
||||||
data class GenerateUrlResponse(
|
data class GenerateUrlResponse(
|
||||||
val contentUrl: String
|
val contentUrl: String,
|
||||||
|
val subtitle: ContentSubtitleResponse? = null
|
||||||
)
|
)
|
||||||
|
|||||||
@@ -4,6 +4,7 @@ import com.querydsl.core.annotations.QueryProjection
|
|||||||
import kr.co.vividnext.sodalive.content.comment.GetAudioContentCommentListItem
|
import kr.co.vividnext.sodalive.content.comment.GetAudioContentCommentListItem
|
||||||
import kr.co.vividnext.sodalive.content.order.OrderType
|
import kr.co.vividnext.sodalive.content.order.OrderType
|
||||||
import kr.co.vividnext.sodalive.content.translation.TranslatedContent
|
import kr.co.vividnext.sodalive.content.translation.TranslatedContent
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.ContentSubtitleResponse
|
||||||
|
|
||||||
data class GetAudioContentDetailResponse(
|
data class GetAudioContentDetailResponse(
|
||||||
val contentId: Long,
|
val contentId: Long,
|
||||||
@@ -42,7 +43,8 @@ data class GetAudioContentDetailResponse(
|
|||||||
val nextContent: OtherContentResponse?,
|
val nextContent: OtherContentResponse?,
|
||||||
val buyerList: List<ContentBuyer>,
|
val buyerList: List<ContentBuyer>,
|
||||||
val isAvailableUsePoint: Boolean,
|
val isAvailableUsePoint: Boolean,
|
||||||
val translated: TranslatedContent?
|
val translated: TranslatedContent?,
|
||||||
|
val subtitle: ContentSubtitleResponse? = null
|
||||||
)
|
)
|
||||||
|
|
||||||
data class OtherContentResponse @QueryProjection constructor(
|
data class OtherContentResponse @QueryProjection constructor(
|
||||||
|
|||||||
@@ -8,32 +8,29 @@ import kr.co.vividnext.sodalive.content.comment.AudioContentCommentRepository
|
|||||||
import kr.co.vividnext.sodalive.content.series.ContentSeriesRepository
|
import kr.co.vividnext.sodalive.content.series.ContentSeriesRepository
|
||||||
import kr.co.vividnext.sodalive.explorer.profile.CreatorCheersRepository
|
import kr.co.vividnext.sodalive.explorer.profile.CreatorCheersRepository
|
||||||
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationEvent
|
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
|
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationService.Companion.getTranslatableLanguageCodes
|
import kr.co.vividnext.sodalive.i18n.translation.ResourceTranslationJobScheduler
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationLanguages.getTranslatableLanguageCodes
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationLanguageService
|
||||||
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.application.CreatorCommunityTranslationService
|
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.application.CreatorCommunityTranslationService
|
||||||
import org.slf4j.LoggerFactory
|
import org.slf4j.LoggerFactory
|
||||||
import org.springframework.beans.factory.annotation.Value
|
|
||||||
import org.springframework.context.ApplicationEventPublisher
|
|
||||||
import org.springframework.data.repository.findByIdOrNull
|
import org.springframework.data.repository.findByIdOrNull
|
||||||
import org.springframework.http.HttpEntity
|
|
||||||
import org.springframework.http.HttpHeaders
|
|
||||||
import org.springframework.http.MediaType
|
|
||||||
import org.springframework.scheduling.annotation.Async
|
import org.springframework.scheduling.annotation.Async
|
||||||
import org.springframework.stereotype.Component
|
import org.springframework.stereotype.Component
|
||||||
|
import org.springframework.transaction.PlatformTransactionManager
|
||||||
|
import org.springframework.transaction.TransactionDefinition
|
||||||
import org.springframework.transaction.annotation.Propagation
|
import org.springframework.transaction.annotation.Propagation
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
import org.springframework.transaction.event.TransactionPhase
|
import org.springframework.transaction.event.TransactionPhase
|
||||||
import org.springframework.transaction.event.TransactionalEventListener
|
import org.springframework.transaction.event.TransactionalEventListener
|
||||||
import org.springframework.transaction.support.TransactionSynchronization
|
import org.springframework.transaction.support.TransactionSynchronization
|
||||||
import org.springframework.transaction.support.TransactionSynchronizationManager
|
import org.springframework.transaction.support.TransactionSynchronizationManager
|
||||||
import org.springframework.util.LinkedMultiValueMap
|
import org.springframework.transaction.support.TransactionTemplate
|
||||||
import org.springframework.web.client.RestTemplate
|
|
||||||
import javax.persistence.EntityManager
|
import javax.persistence.EntityManager
|
||||||
import javax.persistence.LockModeType
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 텍스트 기반 데이터(콘텐츠, 댓글 등)에 대해 파파고 언어 감지를 요청하기 위한 이벤트.
|
* 텍스트 기반 데이터(콘텐츠, 댓글 등)에 대해 언어 감지를 요청하기 위한 이벤트.
|
||||||
*/
|
*/
|
||||||
enum class LanguageDetectTargetType {
|
enum class LanguageDetectTargetType {
|
||||||
CONTENT,
|
CONTENT,
|
||||||
@@ -56,13 +53,8 @@ class LanguageDetectEvent(
|
|||||||
val targetLanguage: String? = null
|
val targetLanguage: String? = null
|
||||||
)
|
)
|
||||||
|
|
||||||
data class PapagoLanguageDetectResponse(
|
|
||||||
val langCode: String?
|
|
||||||
)
|
|
||||||
|
|
||||||
@Component
|
@Component
|
||||||
class LanguageDetectListener(
|
class LanguageDetectListener(
|
||||||
private val audioContentRepository: AudioContentRepository,
|
|
||||||
private val audioContentCommentRepository: AudioContentCommentRepository,
|
private val audioContentCommentRepository: AudioContentCommentRepository,
|
||||||
private val chatCharacterRepository: ChatCharacterRepository,
|
private val chatCharacterRepository: ChatCharacterRepository,
|
||||||
private val characterCommentRepository: CharacterCommentRepository,
|
private val characterCommentRepository: CharacterCommentRepository,
|
||||||
@@ -74,33 +66,32 @@ class LanguageDetectListener(
|
|||||||
private val languageDetectionCacheService: LanguageDetectionCacheService,
|
private val languageDetectionCacheService: LanguageDetectionCacheService,
|
||||||
private val creatorCommunityTranslationService: CreatorCommunityTranslationService,
|
private val creatorCommunityTranslationService: CreatorCommunityTranslationService,
|
||||||
private val entityManager: EntityManager,
|
private val entityManager: EntityManager,
|
||||||
|
private val resourceTranslationJobScheduler: ResourceTranslationJobScheduler,
|
||||||
private val applicationEventPublisher: ApplicationEventPublisher,
|
private val contentLanguageService: ContentTranslationLanguageService,
|
||||||
|
transactionManager: PlatformTransactionManager
|
||||||
@Value("\${cloud.naver.papago-client-id}")
|
|
||||||
private val papagoClientId: String,
|
|
||||||
|
|
||||||
@Value("\${cloud.naver.papago-client-secret}")
|
|
||||||
private val papagoClientSecret: String
|
|
||||||
) {
|
) {
|
||||||
|
|
||||||
private val log = LoggerFactory.getLogger(LanguageDetectListener::class.java)
|
private val log = LoggerFactory.getLogger(LanguageDetectListener::class.java)
|
||||||
|
private val transaction = TransactionTemplate(transactionManager).apply {
|
||||||
private val restTemplate: RestTemplate = RestTemplate()
|
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
|
||||||
|
}
|
||||||
private val papagoDetectUrl = "https://papago.apigw.ntruss.com/langs/v1/dect"
|
|
||||||
|
|
||||||
@Async
|
@Async
|
||||||
@TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
|
@TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
|
||||||
@Transactional(propagation = Propagation.REQUIRES_NEW)
|
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||||
fun detectLanguage(event: LanguageDetectEvent) {
|
fun detectLanguage(event: LanguageDetectEvent) {
|
||||||
if (event.query.isBlank()) {
|
if (event.query.isBlank()) {
|
||||||
log.debug("[PapagoLanguageDetect] query is blank. Skip language detection. event={}", event)
|
log.debug("[LanguageDetect] query is blank. Skip language detection. targetId={}", event.id)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (event.targetType == LanguageDetectTargetType.CONTENT) {
|
||||||
|
contentLanguageService.detectMissing(event.id, event.query)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
transaction.executeWithoutResult {
|
||||||
when (event.targetType) {
|
when (event.targetType) {
|
||||||
LanguageDetectTargetType.CONTENT -> handleContentLanguageDetect(event)
|
LanguageDetectTargetType.CONTENT -> error("CONTENT detection uses the source guard")
|
||||||
LanguageDetectTargetType.COMMENT -> handleCommentLanguageDetect(event)
|
LanguageDetectTargetType.COMMENT -> handleCommentLanguageDetect(event)
|
||||||
LanguageDetectTargetType.CHARACTER -> handleCharacterLanguageDetect(event)
|
LanguageDetectTargetType.CHARACTER -> handleCharacterLanguageDetect(event)
|
||||||
LanguageDetectTargetType.CHARACTER_COMMENT -> handleCharacterCommentLanguageDetect(event)
|
LanguageDetectTargetType.CHARACTER_COMMENT -> handleCharacterCommentLanguageDetect(event)
|
||||||
@@ -111,111 +102,70 @@ class LanguageDetectListener(
|
|||||||
LanguageDetectTargetType.CREATOR_COMMUNITY -> handleCreatorCommunityLanguageDetect(event)
|
LanguageDetectTargetType.CREATOR_COMMUNITY -> handleCreatorCommunityLanguageDetect(event)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
private fun handleCharacterLanguageDetect(event: LanguageDetectEvent) {
|
private fun handleCharacterLanguageDetect(event: LanguageDetectEvent) {
|
||||||
val characterId = event.id
|
val characterId = event.id
|
||||||
|
|
||||||
val character = chatCharacterRepository.findById(characterId).orElse(null)
|
val character = chatCharacterRepository.findById(characterId).orElse(null)
|
||||||
if (character == null) {
|
if (character == null) {
|
||||||
log.warn("[PapagoLanguageDetect] ChatCharacter not found. characterId={}", characterId)
|
log.warn("[LanguageDetect] ChatCharacter not found. characterId={}", characterId)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||||
if (!character.languageCode.isNullOrBlank()) {
|
if (!character.languageCode.isNullOrBlank()) {
|
||||||
log.debug(
|
log.debug(
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. characterId={}, languageCode={}",
|
"[LanguageDetect] languageCode already set. Skip language detection. characterId={}, languageCode={}",
|
||||||
characterId,
|
characterId,
|
||||||
character.languageCode
|
character.languageCode
|
||||||
)
|
)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, characterId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
character.languageCode = langCode
|
character.languageCode = langCode
|
||||||
chatCharacterRepository.save(character)
|
chatCharacterRepository.save(character)
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||||
LanguageTranslationEvent(
|
resourceType = LanguageTranslationTargetType.CHARACTER,
|
||||||
id = characterId,
|
resourceId = characterId
|
||||||
targetType = LanguageTranslationTargetType.CHARACTER
|
|
||||||
)
|
|
||||||
)
|
)
|
||||||
|
|
||||||
log.info(
|
log.info(
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. characterId={}, langCode={}",
|
"[LanguageDetect] languageCode updated. characterId={}, langCode={}",
|
||||||
characterId,
|
characterId,
|
||||||
langCode
|
langCode
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun handleContentLanguageDetect(event: LanguageDetectEvent) {
|
|
||||||
val contentId = event.id
|
|
||||||
|
|
||||||
val audioContent = audioContentRepository.findById(contentId).orElse(null)
|
|
||||||
if (audioContent == null) {
|
|
||||||
log.warn("[PapagoLanguageDetect] AudioContent not found. contentId={}", contentId)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
|
||||||
if (!audioContent.languageCode.isNullOrBlank()) {
|
|
||||||
log.debug(
|
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. contentId={}, languageCode={}",
|
|
||||||
contentId,
|
|
||||||
audioContent.languageCode
|
|
||||||
)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, contentId) ?: return
|
|
||||||
|
|
||||||
audioContent.languageCode = langCode
|
|
||||||
|
|
||||||
// REQUIRES_NEW 트랜잭션 내에서 변경 내용을 저장한다.
|
|
||||||
audioContentRepository.save(audioContent)
|
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
|
||||||
LanguageTranslationEvent(
|
|
||||||
id = contentId,
|
|
||||||
targetType = LanguageTranslationTargetType.CONTENT
|
|
||||||
)
|
|
||||||
)
|
|
||||||
|
|
||||||
log.info(
|
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. contentId={}, langCode={}",
|
|
||||||
contentId,
|
|
||||||
langCode
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun handleCommentLanguageDetect(event: LanguageDetectEvent) {
|
private fun handleCommentLanguageDetect(event: LanguageDetectEvent) {
|
||||||
val commentId = event.id
|
val commentId = event.id
|
||||||
|
|
||||||
val comment = audioContentCommentRepository.findById(commentId).orElse(null)
|
val comment = audioContentCommentRepository.findById(commentId).orElse(null)
|
||||||
if (comment == null) {
|
if (comment == null) {
|
||||||
log.warn("[PapagoLanguageDetect] AudioContentComment not found. commentId={}", commentId)
|
log.warn("[LanguageDetect] AudioContentComment not found. commentId={}", commentId)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||||
if (!comment.languageCode.isNullOrBlank()) {
|
if (!comment.languageCode.isNullOrBlank()) {
|
||||||
log.debug(
|
log.debug(
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. commentId={}, languageCode={}",
|
"[LanguageDetect] languageCode already set. Skip language detection. commentId={}, languageCode={}",
|
||||||
commentId,
|
commentId,
|
||||||
comment.languageCode
|
comment.languageCode
|
||||||
)
|
)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, commentId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
comment.languageCode = langCode
|
comment.languageCode = langCode
|
||||||
audioContentCommentRepository.save(comment)
|
audioContentCommentRepository.save(comment)
|
||||||
|
|
||||||
log.info(
|
log.info(
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. commentId={}, langCode={}",
|
"[LanguageDetect] languageCode updated. commentId={}, langCode={}",
|
||||||
commentId,
|
commentId,
|
||||||
langCode
|
langCode
|
||||||
)
|
)
|
||||||
@@ -226,14 +176,14 @@ class LanguageDetectListener(
|
|||||||
|
|
||||||
val comment = characterCommentRepository.findById(commentId).orElse(null)
|
val comment = characterCommentRepository.findById(commentId).orElse(null)
|
||||||
if (comment == null) {
|
if (comment == null) {
|
||||||
log.warn("[PapagoLanguageDetect] CharacterComment not found. commentId={}", commentId)
|
log.warn("[LanguageDetect] CharacterComment not found. commentId={}", commentId)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||||
if (!comment.languageCode.isNullOrBlank()) {
|
if (!comment.languageCode.isNullOrBlank()) {
|
||||||
log.debug(
|
log.debug(
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. " +
|
"[LanguageDetect] languageCode already set. Skip language detection. " +
|
||||||
"characterCommentId={}, languageCode={}",
|
"characterCommentId={}, languageCode={}",
|
||||||
commentId,
|
commentId,
|
||||||
comment.languageCode
|
comment.languageCode
|
||||||
@@ -241,13 +191,13 @@ class LanguageDetectListener(
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, commentId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
comment.languageCode = langCode
|
comment.languageCode = langCode
|
||||||
characterCommentRepository.save(comment)
|
characterCommentRepository.save(comment)
|
||||||
|
|
||||||
log.info(
|
log.info(
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. characterCommentId={}, langCode={}",
|
"[LanguageDetect] languageCode updated. characterCommentId={}, langCode={}",
|
||||||
commentId,
|
commentId,
|
||||||
langCode
|
langCode
|
||||||
)
|
)
|
||||||
@@ -258,27 +208,27 @@ class LanguageDetectListener(
|
|||||||
|
|
||||||
val cheers = creatorCheersRepository.findById(cheersId).orElse(null)
|
val cheers = creatorCheersRepository.findById(cheersId).orElse(null)
|
||||||
if (cheers == null) {
|
if (cheers == null) {
|
||||||
log.warn("[PapagoLanguageDetect] CreatorCheers not found. cheersId={}", cheersId)
|
log.warn("[LanguageDetect] CreatorCheers not found. cheersId={}", cheersId)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||||
if (!cheers.languageCode.isNullOrBlank()) {
|
if (!cheers.languageCode.isNullOrBlank()) {
|
||||||
log.debug(
|
log.debug(
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. cheersId={}, languageCode={}",
|
"[LanguageDetect] languageCode already set. Skip language detection. cheersId={}, languageCode={}",
|
||||||
cheersId,
|
cheersId,
|
||||||
cheers.languageCode
|
cheers.languageCode
|
||||||
)
|
)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, cheersId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
cheers.languageCode = langCode
|
cheers.languageCode = langCode
|
||||||
creatorCheersRepository.save(cheers)
|
creatorCheersRepository.save(cheers)
|
||||||
|
|
||||||
log.info(
|
log.info(
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. cheersId={}, langCode={}",
|
"[LanguageDetect] languageCode updated. cheersId={}, langCode={}",
|
||||||
cheersId,
|
cheersId,
|
||||||
langCode
|
langCode
|
||||||
)
|
)
|
||||||
@@ -289,34 +239,32 @@ class LanguageDetectListener(
|
|||||||
|
|
||||||
val series = seriesRepository.findByIdOrNull(seriesId)
|
val series = seriesRepository.findByIdOrNull(seriesId)
|
||||||
if (series == null) {
|
if (series == null) {
|
||||||
log.warn("[PapagoLanguageDetect] Series not found. seriesId={}", seriesId)
|
log.warn("[LanguageDetect] Series not found. seriesId={}", seriesId)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||||
if (!series.languageCode.isNullOrBlank()) {
|
if (!series.languageCode.isNullOrBlank()) {
|
||||||
log.debug(
|
log.debug(
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. seriesId={}, languageCode={}",
|
"[LanguageDetect] languageCode already set. Skip language detection. seriesId={}, languageCode={}",
|
||||||
seriesId,
|
seriesId,
|
||||||
series.languageCode
|
series.languageCode
|
||||||
)
|
)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, seriesId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
series.languageCode = langCode
|
series.languageCode = langCode
|
||||||
seriesRepository.save(series)
|
seriesRepository.save(series)
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||||
LanguageTranslationEvent(
|
resourceType = LanguageTranslationTargetType.SERIES,
|
||||||
id = seriesId,
|
resourceId = seriesId
|
||||||
targetType = LanguageTranslationTargetType.SERIES
|
|
||||||
)
|
|
||||||
)
|
)
|
||||||
|
|
||||||
log.info(
|
log.info(
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. seriesId={}, langCode={}",
|
"[LanguageDetect] languageCode updated. seriesId={}, langCode={}",
|
||||||
seriesId,
|
seriesId,
|
||||||
langCode
|
langCode
|
||||||
)
|
)
|
||||||
@@ -327,35 +275,32 @@ class LanguageDetectListener(
|
|||||||
|
|
||||||
val originalWork = originalWorkRepository.findByIdOrNull(originalWorkId)
|
val originalWork = originalWorkRepository.findByIdOrNull(originalWorkId)
|
||||||
if (originalWork == null) {
|
if (originalWork == null) {
|
||||||
log.warn("[PapagoLanguageDetect] OriginalWork not found. originalWorkId={}", originalWorkId)
|
log.warn("[LanguageDetect] OriginalWork not found. originalWorkId={}", originalWorkId)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||||
if (!originalWork.languageCode.isNullOrBlank()) {
|
if (!originalWork.languageCode.isNullOrBlank()) {
|
||||||
log.debug(
|
log.debug(
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. originalWorkId={}, languageCode={}",
|
"[LanguageDetect] languageCode already set. Skip language detection. originalWorkId={}, languageCode={}",
|
||||||
originalWorkId,
|
originalWorkId,
|
||||||
originalWork.languageCode
|
originalWork.languageCode
|
||||||
)
|
)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, originalWorkId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
originalWork.languageCode = langCode
|
originalWork.languageCode = langCode
|
||||||
originalWorkRepository.save(originalWork)
|
originalWorkRepository.save(originalWork)
|
||||||
|
|
||||||
// 언어 감지가 완료된 후 언어 번역 이벤트 호출
|
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||||
applicationEventPublisher.publishEvent(
|
resourceType = LanguageTranslationTargetType.ORIGINAL_WORK,
|
||||||
LanguageTranslationEvent(
|
resourceId = originalWorkId
|
||||||
id = originalWorkId,
|
|
||||||
targetType = LanguageTranslationTargetType.ORIGINAL_WORK
|
|
||||||
)
|
|
||||||
)
|
)
|
||||||
|
|
||||||
log.info(
|
log.info(
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. originalWorkId={}, langCode={}",
|
"[LanguageDetect] languageCode updated. originalWorkId={}, langCode={}",
|
||||||
originalWorkId,
|
originalWorkId,
|
||||||
langCode
|
langCode
|
||||||
)
|
)
|
||||||
@@ -367,16 +312,14 @@ class LanguageDetectListener(
|
|||||||
val category = categoryRepository.findByIdOrNull(categoryId) ?: return
|
val category = categoryRepository.findByIdOrNull(categoryId) ?: return
|
||||||
if (!category.languageCode.isNullOrBlank()) return
|
if (!category.languageCode.isNullOrBlank()) return
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, categoryId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
category.languageCode = langCode
|
category.languageCode = langCode
|
||||||
categoryRepository.save(category)
|
categoryRepository.save(category)
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||||
LanguageTranslationEvent(
|
resourceType = LanguageTranslationTargetType.CREATOR_CONTENT_CATEGORY,
|
||||||
id = categoryId,
|
resourceId = categoryId
|
||||||
targetType = LanguageTranslationTargetType.CREATOR_CONTENT_CATEGORY
|
|
||||||
)
|
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -395,7 +338,7 @@ class LanguageDetectListener(
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val languageCode = detectLanguageCode(event, event.id) ?: return
|
val languageCode = detectLanguageCode(event) ?: return
|
||||||
if (languageCode !in getTranslatableLanguageCodes(null)) return
|
if (languageCode !in getTranslatableLanguageCodes(null)) return
|
||||||
|
|
||||||
val currentCreatorCommunity = creatorCommunityRepository.findByIdAndIsActiveTrueForUpdate(event.id) ?: return
|
val currentCreatorCommunity = creatorCommunityRepository.findByIdAndIsActiveTrueForUpdate(event.id) ?: return
|
||||||
@@ -427,60 +370,7 @@ class LanguageDetectListener(
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun detectLanguageCode(event: LanguageDetectEvent, targetIdForLog: Long): String? {
|
private fun detectLanguageCode(event: LanguageDetectEvent): String? {
|
||||||
return languageDetectionCacheService.detectWithCache(event.query) {
|
return languageDetectionCacheService.detectWithCache(event.query)?.detectedLanguage
|
||||||
requestPapagoLanguageCode(event.query, targetIdForLog)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun requestPapagoLanguageCode(query: String, targetIdForLog: Long): String? {
|
|
||||||
return try {
|
|
||||||
val headers = HttpHeaders().apply {
|
|
||||||
contentType = MediaType.APPLICATION_FORM_URLENCODED
|
|
||||||
set("X-NCP-APIGW-API-KEY-ID", papagoClientId)
|
|
||||||
set("X-NCP-APIGW-API-KEY", papagoClientSecret)
|
|
||||||
}
|
|
||||||
|
|
||||||
val body = LinkedMultiValueMap<String, String>().apply {
|
|
||||||
// 파파고 스펙에 따라 query 파라미터에 텍스트를 공백으로 구분하여 전달
|
|
||||||
add("query", query)
|
|
||||||
}
|
|
||||||
|
|
||||||
val requestEntity = HttpEntity(body, headers)
|
|
||||||
|
|
||||||
val response = restTemplate.postForEntity(
|
|
||||||
papagoDetectUrl,
|
|
||||||
requestEntity,
|
|
||||||
PapagoLanguageDetectResponse::class.java
|
|
||||||
)
|
|
||||||
|
|
||||||
if (!response.statusCode.is2xxSuccessful) {
|
|
||||||
log.warn(
|
|
||||||
"[PapagoLanguageDetect] Non-success status from Papago. status={}, targetId={}",
|
|
||||||
response.statusCode,
|
|
||||||
targetIdForLog
|
|
||||||
)
|
|
||||||
return null
|
|
||||||
}
|
|
||||||
|
|
||||||
val langCode = response.body?.langCode?.takeIf { it.isNotBlank() }
|
|
||||||
if (langCode == null) {
|
|
||||||
log.warn(
|
|
||||||
"[PapagoLanguageDetect] langCode is null or blank in Papago response. targetId={}",
|
|
||||||
targetIdForLog
|
|
||||||
)
|
|
||||||
return null
|
|
||||||
}
|
|
||||||
|
|
||||||
langCode
|
|
||||||
} catch (ex: Exception) {
|
|
||||||
// 언어 감지는 부가 기능이므로, 실패 시 예외를 전파하지 않고 로그만 남긴다.
|
|
||||||
log.error(
|
|
||||||
"[PapagoLanguageDetect] Failed to detect language via Papago. targetId={}",
|
|
||||||
targetIdForLog,
|
|
||||||
ex
|
|
||||||
)
|
|
||||||
null
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,50 +1,87 @@
|
|||||||
package kr.co.vividnext.sodalive.content
|
package kr.co.vividnext.sodalive.content
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.DetectedLanguage
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.LanguageDetectionProvider
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.LanguageProviderProperties
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.SourceTextNormalizer
|
import kr.co.vividnext.sodalive.i18n.translation.SourceTextNormalizer
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationCallControl
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.translationCallStop
|
||||||
import org.springframework.stereotype.Service
|
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.annotation.Transactional
|
||||||
|
import org.springframework.transaction.support.TransactionTemplate
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
class LanguageDetectionCacheService(
|
class LanguageDetectionCacheService(
|
||||||
private val languageDetectionResultRepository: LanguageDetectionResultRepository
|
private val languageDetectionResultRepository: LanguageDetectionResultRepository,
|
||||||
|
providers: List<LanguageDetectionProvider>,
|
||||||
|
properties: LanguageProviderProperties,
|
||||||
|
transactionManager: PlatformTransactionManager
|
||||||
) {
|
) {
|
||||||
@Transactional
|
private val providers = properties.orderedProviders(properties.detectionOrder, providers) { it.providerId }
|
||||||
fun detectWithCache(
|
private val transaction = TransactionTemplate(transactionManager).apply {
|
||||||
query: String,
|
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
|
||||||
provider: String = DEFAULT_PROVIDER,
|
}
|
||||||
detector: () -> String?
|
|
||||||
): String? {
|
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||||
|
fun detectWithCache(query: String): DetectedLanguage? = detect(query, null)
|
||||||
|
|
||||||
|
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||||
|
fun detectWithCache(query: String, authorizeDispatch: () -> Boolean): DetectedLanguage? {
|
||||||
|
return detect(query, TranslationCallControl(authorizeDispatch))
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun detect(query: String, control: TranslationCallControl?): DetectedLanguage? {
|
||||||
val normalizedQuery = SourceTextNormalizer.normalize(query)
|
val normalizedQuery = SourceTextNormalizer.normalize(query)
|
||||||
if (normalizedQuery.isBlank()) return null
|
if (normalizedQuery.isBlank()) return null
|
||||||
|
|
||||||
val sourceHash = SourceTextNormalizer.hash(normalizedQuery)
|
val sourceHash = SourceTextNormalizer.hash(normalizedQuery)
|
||||||
val cached = languageDetectionResultRepository.findBySourceHashAndProviderAndNormalizationVersion(
|
providers.forEach { provider ->
|
||||||
|
val cached = transaction.execute {
|
||||||
|
languageDetectionResultRepository.findBySourceHashAndProviderAndNormalizationVersion(
|
||||||
sourceHash = sourceHash,
|
sourceHash = sourceHash,
|
||||||
provider = provider,
|
provider = provider.providerId.code,
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
)
|
)
|
||||||
if (cached != null) return cached.detectedLanguage
|
}
|
||||||
|
if (cached != null && cached.detectedLanguage.isNotBlank()) {
|
||||||
|
return DetectedLanguage(cached.detectedLanguage, provider.providerId)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
val detectedLanguage = detector()?.takeIf { it.isNotBlank() }?.lowercase() ?: return null
|
providers.forEach { provider ->
|
||||||
|
val detectedLanguage = try {
|
||||||
|
control?.beforeCall()
|
||||||
|
if (control == null) provider.detect(query) else provider.detect(query, control)
|
||||||
|
} catch (error: Exception) {
|
||||||
|
if (error.translationCallStop() != null) return null
|
||||||
|
null
|
||||||
|
}?.takeIf { it.isNotBlank() }?.lowercase() ?: return@forEach
|
||||||
|
val winner = transaction.execute {
|
||||||
languageDetectionResultRepository.insertIfAbsent(
|
languageDetectionResultRepository.insertIfAbsent(
|
||||||
sourceHash = sourceHash,
|
sourceHash = sourceHash,
|
||||||
sourceTextSample = normalizedQuery.take(MAX_SAMPLE_LENGTH),
|
sourceTextSample = normalizedQuery.take(MAX_SAMPLE_LENGTH),
|
||||||
detectedLanguage = detectedLanguage,
|
detectedLanguage = detectedLanguage,
|
||||||
provider = provider,
|
provider = provider.providerId.code,
|
||||||
confidence = null,
|
confidence = null,
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
)
|
)
|
||||||
return requireNotNull(
|
requireNotNull(
|
||||||
languageDetectionResultRepository.findDetectedLanguageForUpdate(
|
languageDetectionResultRepository.findDetectedLanguageForUpdate(
|
||||||
sourceHash = sourceHash,
|
sourceHash = sourceHash,
|
||||||
provider = provider,
|
provider = provider.providerId.code,
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
return DetectedLanguage(requireNotNull(winner), provider.providerId)
|
||||||
|
}
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
const val DEFAULT_PROVIDER = "papago"
|
|
||||||
private const val MAX_SAMPLE_LENGTH = 500
|
private const val MAX_SAMPLE_LENGTH = 500
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -141,6 +141,11 @@ class CategoryService(
|
|||||||
val categoryIds = baseList.map { it.categoryId }
|
val categoryIds = baseList.map { it.categoryId }
|
||||||
val entities = repository.findAllById(categoryIds)
|
val entities = repository.findAllById(categoryIds)
|
||||||
val entityMap = entities.associateBy { it.id!! }
|
val entityMap = entities.associateBy { it.id!! }
|
||||||
|
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||||
|
LanguageTranslationTargetType.CREATOR_CONTENT_CATEGORY,
|
||||||
|
categoryIds,
|
||||||
|
locale
|
||||||
|
)
|
||||||
|
|
||||||
// 요청 로케일로 이미 저장된 번역 일괄 조회
|
// 요청 로케일로 이미 저장된 번역 일괄 조회
|
||||||
val translations = categoryTranslationRepository
|
val translations = categoryTranslationRepository
|
||||||
|
|||||||
+146
@@ -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.common.SodaException
|
||||||
import kr.co.vividnext.sodalive.content.ContentType
|
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.OrderRepository
|
||||||
import kr.co.vividnext.sodalive.content.order.OrderType
|
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.ContentSeriesContentRepository
|
||||||
import kr.co.vividnext.sodalive.content.series.content.GetSeriesContentListResponse
|
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.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.content.translation.ContentTranslationRepository
|
||||||
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesPublishedDaysOfWeek
|
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesPublishedDaysOfWeek
|
||||||
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesSortType
|
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.block.BlockMemberRepository
|
||||||
import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
|
import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
|
||||||
import org.springframework.beans.factory.annotation.Value
|
import org.springframework.beans.factory.annotation.Value
|
||||||
|
import org.springframework.context.ApplicationEventPublisher
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
import java.time.ZoneId
|
import java.time.ZoneId
|
||||||
@@ -36,7 +37,8 @@ class ContentSeriesService(
|
|||||||
|
|
||||||
private val langContext: LangContext,
|
private val langContext: LangContext,
|
||||||
|
|
||||||
private val seriesTranslationRepository: SeriesTranslationRepository,
|
private val detailTranslationService: ContentSeriesDetailTranslationService,
|
||||||
|
private val applicationEventPublisher: ApplicationEventPublisher,
|
||||||
private val seriesGenreTranslationRepository: SeriesGenreTranslationRepository,
|
private val seriesGenreTranslationRepository: SeriesGenreTranslationRepository,
|
||||||
private val contentTranslationRepository: ContentTranslationRepository,
|
private val contentTranslationRepository: ContentTranslationRepository,
|
||||||
private val resourceTranslationJobScheduler: ResourceTranslationJobScheduler,
|
private val resourceTranslationJobScheduler: ResourceTranslationJobScheduler,
|
||||||
@@ -98,6 +100,11 @@ class ContentSeriesService(
|
|||||||
if (currentLang == Lang.EN || currentLang == Lang.JA) {
|
if (currentLang == Lang.EN || currentLang == Lang.JA) {
|
||||||
val targetLocale = currentLang.code
|
val targetLocale = currentLang.code
|
||||||
val ids = genres.map { it.id }
|
val ids = genres.map { it.id }
|
||||||
|
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||||
|
LanguageTranslationTargetType.SERIES_GENRE,
|
||||||
|
ids,
|
||||||
|
targetLocale
|
||||||
|
)
|
||||||
|
|
||||||
// 기존 번역 일괄 조회
|
// 기존 번역 일괄 조회
|
||||||
val existing = if (ids.isNotEmpty()) {
|
val existing = if (ids.isNotEmpty()) {
|
||||||
@@ -254,47 +261,16 @@ class ContentSeriesService(
|
|||||||
limit = 5
|
limit = 5
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
|
||||||
* series.languageCode != null && series.languageCode != languageCode
|
|
||||||
*
|
|
||||||
* 번역 시리즈를 조회한다. - series, locale
|
|
||||||
* 번역 콘텐츠가 있으면
|
|
||||||
* TranslatedSeries로 가공한다
|
|
||||||
*
|
|
||||||
* 번역 콘텐츠가 없으면
|
|
||||||
* 누락 번역 job을 예약하고 원문 응답을 유지한다.
|
|
||||||
*
|
|
||||||
* 번역 대상: title, introduction, keywordList
|
|
||||||
*
|
|
||||||
* 파파고로 번역한 데이터를 TranslatedSeries 가공한다
|
|
||||||
*/
|
|
||||||
|
|
||||||
val dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy.MM.dd")
|
val dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy.MM.dd")
|
||||||
|
|
||||||
// 요청된 언어(locale)에 대한 시리즈 번역을 조회하거나, 없으면 동기 번역 후 저장한다.
|
val translation = detailTranslationService.resolve(seriesId, langContext.lang.code)
|
||||||
var translated: TranslatedSeries? = null
|
if (translation.detectionQuery != null) {
|
||||||
run {
|
applicationEventPublisher.publishEvent(
|
||||||
val locale = langContext.lang.code
|
LanguageDetectEvent(seriesId, translation.detectionQuery, LanguageDetectTargetType.SERIES)
|
||||||
val languageCode = series.languageCode
|
|
||||||
// 원본 언어가 존재하고, 요청 언어와 다를 때만 번역 처리
|
|
||||||
if (!languageCode.isNullOrBlank() && languageCode != 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 translated = translation.translated?.let {
|
||||||
|
it.copy(keywords = it.keywords.ifEmpty { keywordList })
|
||||||
}
|
}
|
||||||
|
|
||||||
// 장르 번역 조회 (있으면 반환)
|
// 장르 번역 조회 (있으면 반환)
|
||||||
|
|||||||
@@ -58,6 +58,11 @@ class AudioContentThemeService(
|
|||||||
val targetLocale = currentLang.code
|
val targetLocale = currentLang.code
|
||||||
// 1) 기존 번역을 한 번에 조회
|
// 1) 기존 번역을 한 번에 조회
|
||||||
val ids = themesWithIds.map { it.id }
|
val ids = themesWithIds.map { it.id }
|
||||||
|
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||||
|
LanguageTranslationTargetType.CONTENT_THEME,
|
||||||
|
ids,
|
||||||
|
targetLocale
|
||||||
|
)
|
||||||
val existingTranslations = if (ids.isNotEmpty()) {
|
val existingTranslations = if (ids.isNotEmpty()) {
|
||||||
contentThemeTranslationRepository.findByContentThemeIdInAndLocale(ids, targetLocale)
|
contentThemeTranslationRepository.findByContentThemeIdInAndLocale(ids, targetLocale)
|
||||||
} else {
|
} else {
|
||||||
|
|||||||
+14
@@ -1,9 +1,23 @@
|
|||||||
package kr.co.vividnext.sodalive.content.translation
|
package kr.co.vividnext.sodalive.content.translation
|
||||||
|
|
||||||
import org.springframework.data.jpa.repository.JpaRepository
|
import org.springframework.data.jpa.repository.JpaRepository
|
||||||
|
import org.springframework.data.jpa.repository.Lock
|
||||||
|
import org.springframework.data.jpa.repository.Query
|
||||||
|
import org.springframework.data.repository.query.Param
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
interface ContentTranslationRepository : JpaRepository<ContentTranslation, Long> {
|
interface ContentTranslationRepository : JpaRepository<ContentTranslation, Long> {
|
||||||
fun findByContentIdAndLocale(contentId: Long, locale: String): ContentTranslation?
|
fun findByContentIdAndLocale(contentId: Long, locale: String): ContentTranslation?
|
||||||
|
|
||||||
|
@Lock(LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
fun findByContentId(contentId: Long): List<ContentTranslation>
|
||||||
|
|
||||||
|
@Lock(LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
@Query("select t from ContentTranslation t where t.contentId = :contentId and t.locale = :locale")
|
||||||
|
fun findByContentIdAndLocaleForUpdate(
|
||||||
|
@Param("contentId") contentId: Long,
|
||||||
|
@Param("locale") locale: String
|
||||||
|
): ContentTranslation?
|
||||||
|
|
||||||
fun findByContentIdInAndLocale(contentIds: List<Long>, locale: String): List<ContentTranslation>
|
fun findByContentIdInAndLocale(contentIds: List<Long>, locale: String): List<ContentTranslation>
|
||||||
}
|
}
|
||||||
|
|||||||
+25
-16
@@ -10,15 +10,17 @@ import kr.co.vividnext.sodalive.content.ContentPriceChangeLogRepository
|
|||||||
import kr.co.vividnext.sodalive.content.hashtag.AudioContentHashTag
|
import kr.co.vividnext.sodalive.content.hashtag.AudioContentHashTag
|
||||||
import kr.co.vividnext.sodalive.content.hashtag.HashTag
|
import kr.co.vividnext.sodalive.content.hashtag.HashTag
|
||||||
import kr.co.vividnext.sodalive.content.hashtag.HashTagRepository
|
import kr.co.vividnext.sodalive.content.hashtag.HashTagRepository
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationEvent
|
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
|
|
||||||
import kr.co.vividnext.sodalive.member.Member
|
import kr.co.vividnext.sodalive.member.Member
|
||||||
import kr.co.vividnext.sodalive.utils.generateFileName
|
import kr.co.vividnext.sodalive.utils.generateFileName
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationSourceInvalidationService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.toContentSourceSnapshot
|
||||||
import org.springframework.beans.factory.annotation.Value
|
import org.springframework.beans.factory.annotation.Value
|
||||||
import org.springframework.context.ApplicationEventPublisher
|
|
||||||
import org.springframework.data.domain.Pageable
|
import org.springframework.data.domain.Pageable
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
|
import org.springframework.transaction.PlatformTransactionManager
|
||||||
|
import org.springframework.transaction.TransactionDefinition
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
|
import org.springframework.transaction.support.TransactionTemplate
|
||||||
import org.springframework.web.multipart.MultipartFile
|
import org.springframework.web.multipart.MultipartFile
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
@@ -30,7 +32,8 @@ class CreatorAdminContentService(
|
|||||||
private val objectMapper: ObjectMapper,
|
private val objectMapper: ObjectMapper,
|
||||||
private val s3Uploader: S3Uploader,
|
private val s3Uploader: S3Uploader,
|
||||||
|
|
||||||
private val applicationEventPublisher: ApplicationEventPublisher,
|
private val sourceInvalidation: ContentTranslationSourceInvalidationService,
|
||||||
|
transactionManager: PlatformTransactionManager,
|
||||||
|
|
||||||
@Value("\${cloud.aws.s3.bucket}")
|
@Value("\${cloud.aws.s3.bucket}")
|
||||||
private val bucket: String,
|
private val bucket: String,
|
||||||
@@ -38,6 +41,9 @@ class CreatorAdminContentService(
|
|||||||
@Value("\${cloud.aws.cloud-front.host}")
|
@Value("\${cloud.aws.cloud-front.host}")
|
||||||
private val coverImageHost: String
|
private val coverImageHost: String
|
||||||
) {
|
) {
|
||||||
|
private val uploadTransaction = TransactionTemplate(transactionManager).apply {
|
||||||
|
propagationBehavior = TransactionDefinition.PROPAGATION_NOT_SUPPORTED
|
||||||
|
}
|
||||||
fun getAudioContentList(pageable: Pageable, member: Member): GetCreatorAdminContentListResponse {
|
fun getAudioContentList(pageable: Pageable, member: Member): GetCreatorAdminContentListResponse {
|
||||||
val totalCount = repository.getAudioContentTotalCount(memberId = member.id!!)
|
val totalCount = repository.getAudioContentTotalCount(memberId = member.id!!)
|
||||||
val audioContentAndThemeList = repository.getAudioContentList(
|
val audioContentAndThemeList = repository.getAudioContentList(
|
||||||
@@ -115,19 +121,27 @@ class CreatorAdminContentService(
|
|||||||
val audioContent = repository.getAudioContent(memberId = member.id!!, audioContentId = request.id)
|
val audioContent = repository.getAudioContent(memberId = member.id!!, audioContentId = request.id)
|
||||||
?: throw SodaException(messageKey = "creator.admin.content.invalid_content")
|
?: throw SodaException(messageKey = "creator.admin.content.invalid_content")
|
||||||
|
|
||||||
if (coverImage != null) {
|
val uploadedCover = if (coverImage != null) {
|
||||||
val metadata = ObjectMetadata()
|
val metadata = ObjectMetadata()
|
||||||
metadata.contentLength = coverImage.size
|
metadata.contentLength = coverImage.size
|
||||||
|
|
||||||
val fileName = generateFileName()
|
val fileName = generateFileName()
|
||||||
val imagePath = s3Uploader.upload(
|
uploadTransaction.execute {
|
||||||
|
s3Uploader.upload(
|
||||||
inputStream = coverImage.inputStream,
|
inputStream = coverImage.inputStream,
|
||||||
bucket = bucket,
|
bucket = bucket,
|
||||||
filePath = "audio_content_cover/${request.id}/$fileName",
|
filePath = "audio_content_cover/${request.id}/$fileName",
|
||||||
metadata = metadata
|
metadata = metadata
|
||||||
)
|
)
|
||||||
audioContent.coverImage = imagePath
|
|
||||||
}
|
}
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
sourceInvalidation.lock(audioContent)
|
||||||
|
if (audioContent.member?.id != member.id) throw SodaException(messageKey = "creator.admin.content.invalid_content")
|
||||||
|
val before = audioContent.toContentSourceSnapshot()
|
||||||
|
if (uploadedCover != null) audioContent.coverImage = uploadedCover
|
||||||
|
|
||||||
if (request.isActive != null) {
|
if (request.isActive != null) {
|
||||||
if (!request.isActive) {
|
if (!request.isActive) {
|
||||||
@@ -198,15 +212,10 @@ class CreatorAdminContentService(
|
|||||||
audioContentHashTag
|
audioContentHashTag
|
||||||
}
|
}
|
||||||
|
|
||||||
audioContent.audioContentHashTags.addAll(newAudioContentHashTagList)
|
val added = newAudioContentHashTagList.filter { it !in audioContent.audioContentHashTags }
|
||||||
|
audioContent.audioContentHashTags.addAll(added)
|
||||||
|
}
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
sourceInvalidation.invalidateChanged(audioContent, before)
|
||||||
LanguageTranslationEvent(
|
|
||||||
id = request.id,
|
|
||||||
targetType = LanguageTranslationTargetType.CONTENT,
|
|
||||||
waitTransactionCommit = true
|
|
||||||
)
|
|
||||||
)
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
+7
@@ -24,6 +24,8 @@ import org.springframework.data.repository.findByIdOrNull
|
|||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
import org.springframework.web.multipart.MultipartFile
|
import org.springframework.web.multipart.MultipartFile
|
||||||
|
import javax.persistence.EntityManager
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
@Transactional(readOnly = true)
|
@Transactional(readOnly = true)
|
||||||
@@ -32,6 +34,7 @@ class CreatorAdminContentSeriesService(
|
|||||||
private val genreRepository: CreatorAdminContentSeriesGenreRepository,
|
private val genreRepository: CreatorAdminContentSeriesGenreRepository,
|
||||||
private val hashTagRepository: HashTagRepository,
|
private val hashTagRepository: HashTagRepository,
|
||||||
private val audioContentRepository: AudioContentRepository,
|
private val audioContentRepository: AudioContentRepository,
|
||||||
|
private val entityManager: EntityManager,
|
||||||
|
|
||||||
private val s3Uploader: S3Uploader,
|
private val s3Uploader: S3Uploader,
|
||||||
private val objectMapper: ObjectMapper,
|
private val objectMapper: ObjectMapper,
|
||||||
@@ -275,6 +278,8 @@ class CreatorAdminContentSeriesService(
|
|||||||
fun addingContentToTheSeries(request: AddingContentToTheSeriesRequest, memberId: Long) {
|
fun addingContentToTheSeries(request: AddingContentToTheSeriesRequest, memberId: Long) {
|
||||||
val series = repository.findByIdAndCreatorId(id = request.seriesId, creatorId = memberId)
|
val series = repository.findByIdAndCreatorId(id = request.seriesId, creatorId = memberId)
|
||||||
?: throw SodaException(messageKey = "creator.admin.series.invalid_access")
|
?: throw SodaException(messageKey = "creator.admin.series.invalid_access")
|
||||||
|
entityManager.refresh(series, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
if (series.member?.id != memberId) throw SodaException(messageKey = "creator.admin.series.invalid_access")
|
||||||
|
|
||||||
val seriesContentList = mutableListOf<SeriesContent>()
|
val seriesContentList = mutableListOf<SeriesContent>()
|
||||||
|
|
||||||
@@ -299,6 +304,8 @@ class CreatorAdminContentSeriesService(
|
|||||||
fun removeContentInTheSeries(request: RemoveContentToTheSeriesRequest, memberId: Long) {
|
fun removeContentInTheSeries(request: RemoveContentToTheSeriesRequest, memberId: Long) {
|
||||||
val series = repository.findByIdAndCreatorId(id = request.seriesId, creatorId = memberId)
|
val series = repository.findByIdAndCreatorId(id = request.seriesId, creatorId = memberId)
|
||||||
?: throw SodaException(messageKey = "creator.admin.series.invalid_access")
|
?: throw SodaException(messageKey = "creator.admin.series.invalid_access")
|
||||||
|
entityManager.refresh(series, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
if (series.member?.id != memberId) throw SodaException(messageKey = "creator.admin.series.invalid_access")
|
||||||
|
|
||||||
series.contentList.removeIf { it.content!!.id == request.contentId }
|
series.contentList.removeIf { it.content!!.id == request.contentId }
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -40,6 +40,56 @@ class SodaMessageSource {
|
|||||||
Lang.EN to "Invalid request.",
|
Lang.EN to "Invalid request.",
|
||||||
Lang.JA to "無効なリクエストです。"
|
Lang.JA to "無効なリクエストです。"
|
||||||
),
|
),
|
||||||
|
"translation.selection.not_found" to mapOf(
|
||||||
|
Lang.KO to "번역 요청 또는 대상을 찾을 수 없습니다.",
|
||||||
|
Lang.EN to "Translation request or scope was not found.",
|
||||||
|
Lang.JA to "翻訳リクエストまたは対象が見つかりません。"
|
||||||
|
),
|
||||||
|
"translation.selection.invalid_grouping" to mapOf(
|
||||||
|
Lang.KO to "제목 그룹의 구성원과 원문 구간을 확인해 주세요.",
|
||||||
|
Lang.EN to "Check title group members and source ranges.",
|
||||||
|
Lang.JA to "タイトルグループのメンバーと原文の範囲を確認してください。"
|
||||||
|
),
|
||||||
|
"translation.selection.revision_conflict" to mapOf(
|
||||||
|
Lang.KO to "번역 요청이 변경되었습니다. 최신 상태를 조회해 주세요.",
|
||||||
|
Lang.EN to "The translation request changed. Reload its current state.",
|
||||||
|
Lang.JA to "翻訳リクエストが変更されました。最新の状態を取得してください。"
|
||||||
|
),
|
||||||
|
"translation.selection.idempotency_conflict" to mapOf(
|
||||||
|
Lang.KO to "같은 요청 식별자를 다른 내용에 사용할 수 없습니다.",
|
||||||
|
Lang.EN to "The same request identifier cannot be used with a different body.",
|
||||||
|
Lang.JA to "同じリクエスト識別子を異なる内容には使用できません。"
|
||||||
|
),
|
||||||
|
"translation.selection.closed" to mapOf(
|
||||||
|
Lang.KO to "이미 종료된 번역 요청입니다.",
|
||||||
|
Lang.EN to "The translation request is already closed.",
|
||||||
|
Lang.JA to "翻訳リクエストは既に終了しています。"
|
||||||
|
),
|
||||||
|
"translation.selection.not_ready" to mapOf(
|
||||||
|
Lang.KO to "현재 번역 요청 상태에서는 수행할 수 없습니다.",
|
||||||
|
Lang.EN to "This operation is unavailable in the current translation request state.",
|
||||||
|
Lang.JA to "現在の翻訳リクエストの状態では実行できません。"
|
||||||
|
),
|
||||||
|
"translation.selection.candidate_not_selectable" to mapOf(
|
||||||
|
Lang.KO to "선택할 수 없는 번역 후보입니다. 요청과 필드, 언어를 확인해 주세요.",
|
||||||
|
Lang.EN to "This translation candidate cannot be selected. Check its request, field and language.",
|
||||||
|
Lang.JA to "選択できない翻訳候補です。リクエスト、フィールド、言語を確認してください。"
|
||||||
|
),
|
||||||
|
"translation.selection.incomplete_title_group" to mapOf(
|
||||||
|
Lang.KO to "공통 제목과 모든 구성원의 개별 구간 후보를 선택해 주세요.",
|
||||||
|
Lang.EN to "Select the common title and residual choices for every group member.",
|
||||||
|
Lang.JA to "共通タイトルと全メンバーの個別部分の候補を選択してください。"
|
||||||
|
),
|
||||||
|
"translation.selection.source_changed" to mapOf(
|
||||||
|
Lang.KO to "선택한 필드의 원문이 변경되었습니다. 새 번역 요청을 만들어 주세요.",
|
||||||
|
Lang.EN to "The selected source field changed. Create a new translation request.",
|
||||||
|
Lang.JA to "選択したフィールドの原文が変更されました。新しい翻訳リクエストを作成してください。"
|
||||||
|
),
|
||||||
|
"translation.selection.membership_changed" to mapOf(
|
||||||
|
Lang.KO to "시리즈의 활성 구성원이 변경되었습니다. 새 번역 요청을 만들어 주세요.",
|
||||||
|
Lang.EN to "The active series membership changed. Create a new translation request.",
|
||||||
|
Lang.JA to "シリーズの有効なメンバーが変更されました。新しい翻訳リクエストを作成してください。"
|
||||||
|
),
|
||||||
"chat.error.room_not_found" to mapOf(
|
"chat.error.room_not_found" to mapOf(
|
||||||
Lang.KO to "채팅방을 찾을 수 없습니다.",
|
Lang.KO to "채팅방을 찾을 수 없습니다.",
|
||||||
Lang.EN to "Chat room not found.",
|
Lang.EN to "Chat room not found.",
|
||||||
|
|||||||
+36
@@ -0,0 +1,36 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.springframework.stereotype.Component
|
||||||
|
import software.amazon.awssdk.services.comprehend.ComprehendClient
|
||||||
|
import software.amazon.awssdk.services.comprehend.model.DetectDominantLanguageRequest
|
||||||
|
|
||||||
|
@Component
|
||||||
|
class AwsLanguageDetectionProvider(private val client: ComprehendClient) : LanguageDetectionProvider {
|
||||||
|
override val providerId = LanguageProviderId.AWS
|
||||||
|
|
||||||
|
override fun detect(query: String): String? = detect(query, null)
|
||||||
|
|
||||||
|
override fun detect(query: String, control: TranslationCallControl?): String? {
|
||||||
|
if (query.isBlank()) return null
|
||||||
|
|
||||||
|
return try {
|
||||||
|
// shortcut: 감지는 앞 100000 UTF-8 바이트만 판정하므로 전체 본문과 결과가 다를 수 있음, 전체 본문 기준 품질이 요구되면 별도 감지 정책 승인 후 업그레이드
|
||||||
|
val text = takeTextPrefixByCodePoint(query, MAX_REQUEST_TEXT_BYTES, ::utf8CodePointSize)
|
||||||
|
val request = DetectDominantLanguageRequest.builder().text(text)
|
||||||
|
control?.let { call ->
|
||||||
|
request.overrideConfiguration {
|
||||||
|
it.putExecutionAttribute(AwsTranslationCallInterceptor.CONTROL, call)
|
||||||
|
.apiCallTimeout(call.remainingTimeout()).apiCallAttemptTimeout(call.remainingTimeout())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
client.detectDominantLanguage(request.build()).languages().firstOrNull()?.languageCode()?.takeIf { it.isNotBlank() }
|
||||||
|
} catch (error: Exception) {
|
||||||
|
error.translationCallStop()?.let { throw it }
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
private const val MAX_REQUEST_TEXT_BYTES = 100000
|
||||||
|
}
|
||||||
|
}
|
||||||
+34
@@ -0,0 +1,34 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.springframework.beans.factory.annotation.Value
|
||||||
|
import org.springframework.context.annotation.Bean
|
||||||
|
import org.springframework.context.annotation.Configuration
|
||||||
|
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials
|
||||||
|
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider
|
||||||
|
import software.amazon.awssdk.regions.Region
|
||||||
|
import software.amazon.awssdk.services.comprehend.ComprehendClient
|
||||||
|
import software.amazon.awssdk.services.translate.TranslateClient
|
||||||
|
|
||||||
|
@Configuration
|
||||||
|
class AwsLanguageProviderConfiguration(
|
||||||
|
@Value("\${cloud.aws.credentials.access-key}") accessKey: String,
|
||||||
|
@Value("\${cloud.aws.credentials.secret-key}") secretKey: String,
|
||||||
|
@Value("\${cloud.aws.region.static}") region: String
|
||||||
|
) {
|
||||||
|
private val credentialsProvider = StaticCredentialsProvider.create(AwsBasicCredentials.create(accessKey, secretKey))
|
||||||
|
private val region = Region.of(region)
|
||||||
|
|
||||||
|
@Bean(destroyMethod = "close")
|
||||||
|
fun comprehendClient(): ComprehendClient = ComprehendClient.builder()
|
||||||
|
.credentialsProvider(credentialsProvider)
|
||||||
|
.region(region)
|
||||||
|
.overrideConfiguration { it.addExecutionInterceptor(AwsTranslationCallInterceptor()) }
|
||||||
|
.build()
|
||||||
|
|
||||||
|
@Bean(destroyMethod = "close")
|
||||||
|
fun translateClient(): TranslateClient = TranslateClient.builder()
|
||||||
|
.credentialsProvider(credentialsProvider)
|
||||||
|
.region(region)
|
||||||
|
.overrideConfiguration { it.addExecutionInterceptor(AwsTranslationCallInterceptor()) }
|
||||||
|
.build()
|
||||||
|
}
|
||||||
+16
@@ -0,0 +1,16 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import software.amazon.awssdk.core.interceptor.Context
|
||||||
|
import software.amazon.awssdk.core.interceptor.ExecutionAttribute
|
||||||
|
import software.amazon.awssdk.core.interceptor.ExecutionAttributes
|
||||||
|
import software.amazon.awssdk.core.interceptor.ExecutionInterceptor
|
||||||
|
|
||||||
|
class AwsTranslationCallInterceptor : ExecutionInterceptor {
|
||||||
|
override fun beforeTransmission(context: Context.BeforeTransmission, executionAttributes: ExecutionAttributes) {
|
||||||
|
executionAttributes.getAttribute(CONTROL)?.beforeCall()
|
||||||
|
}
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
val CONTROL = ExecutionAttribute<TranslationCallControl>("TranslationSelectionCallControl")
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,55 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.springframework.stereotype.Service
|
||||||
|
import software.amazon.awssdk.services.translate.TranslateClient
|
||||||
|
import software.amazon.awssdk.services.translate.model.TranslateTextRequest
|
||||||
|
|
||||||
|
@Service
|
||||||
|
class AwsTranslationService(private val client: TranslateClient) : TranslationProvider {
|
||||||
|
override val providerId = LanguageProviderId.AWS
|
||||||
|
override val providerVersion = "translate-2017-07-01"
|
||||||
|
|
||||||
|
override fun translate(request: TranslateRequest): TranslateResult {
|
||||||
|
if (request.texts.isEmpty() || request.sourceLanguage == request.targetLanguage) {
|
||||||
|
return TranslateResult(emptyList())
|
||||||
|
}
|
||||||
|
if (
|
||||||
|
!TranslationLanguages.isSupported(request.sourceLanguage) ||
|
||||||
|
!TranslationLanguages.isSupported(request.targetLanguage)
|
||||||
|
) {
|
||||||
|
return TranslateResult(emptyList())
|
||||||
|
}
|
||||||
|
|
||||||
|
val translatedTexts = mutableListOf<String>()
|
||||||
|
try {
|
||||||
|
for (text in request.texts) {
|
||||||
|
val translatedText = StringBuilder()
|
||||||
|
for (chunk in splitTextByCodePoint(text, MAX_REQUEST_TEXT_BYTES, ::utf8CodePointSize)) {
|
||||||
|
val builder = TranslateTextRequest.builder()
|
||||||
|
.sourceLanguageCode(request.sourceLanguage)
|
||||||
|
.targetLanguageCode(request.targetLanguage)
|
||||||
|
.text(chunk)
|
||||||
|
request.callControl?.let { control ->
|
||||||
|
builder.overrideConfiguration {
|
||||||
|
it.putExecutionAttribute(AwsTranslationCallInterceptor.CONTROL, control)
|
||||||
|
.apiCallTimeout(control.remainingTimeout()).apiCallAttemptTimeout(control.remainingTimeout())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
val translated = client.translateText(builder.build())?.translatedText()
|
||||||
|
if (translated.isNullOrBlank()) return TranslateResult(emptyList())
|
||||||
|
translatedText.append(translated)
|
||||||
|
}
|
||||||
|
translatedTexts.add(translatedText.toString())
|
||||||
|
}
|
||||||
|
} catch (error: Exception) {
|
||||||
|
error.translationCallStop()?.let { throw it }
|
||||||
|
if (request.callControl != null) throw TranslationProviderFailed()
|
||||||
|
return TranslateResult(emptyList())
|
||||||
|
}
|
||||||
|
return TranslateResult(translatedTexts)
|
||||||
|
}
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
private const val MAX_REQUEST_TEXT_BYTES = 10000
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,41 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
internal fun splitTextByCodePoint(text: String, maxSize: Int, codePointSize: (Int) -> Int): List<String> {
|
||||||
|
val chunks = mutableListOf<String>()
|
||||||
|
var start = 0
|
||||||
|
do {
|
||||||
|
val end = findChunkEnd(text, start, maxSize, codePointSize)
|
||||||
|
chunks.add(text.substring(start, end))
|
||||||
|
start = end
|
||||||
|
} while (start < text.length)
|
||||||
|
return chunks
|
||||||
|
}
|
||||||
|
|
||||||
|
internal fun takeTextPrefixByCodePoint(text: String, maxSize: Int, codePointSize: (Int) -> Int): String {
|
||||||
|
return text.substring(0, findChunkEnd(text, 0, maxSize, codePointSize))
|
||||||
|
}
|
||||||
|
|
||||||
|
internal fun utf8CodePointSize(codePoint: Int): Int {
|
||||||
|
return when {
|
||||||
|
codePoint <= 0x7F -> 1
|
||||||
|
codePoint <= 0x7FF -> 2
|
||||||
|
codePoint in 0xD800..0xDFFF -> 1
|
||||||
|
codePoint <= 0xFFFF -> 3
|
||||||
|
else -> 4
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun findChunkEnd(text: String, start: Int, maxSize: Int, codePointSize: (Int) -> Int): Int {
|
||||||
|
var end = start
|
||||||
|
var size = 0
|
||||||
|
while (end < text.length) {
|
||||||
|
val codePoint = text.codePointAt(end)
|
||||||
|
val nextSize = codePointSize(codePoint)
|
||||||
|
if (size + nextSize > maxSize) {
|
||||||
|
break
|
||||||
|
}
|
||||||
|
size += nextSize
|
||||||
|
end += Character.charCount(codePoint)
|
||||||
|
}
|
||||||
|
return end
|
||||||
|
}
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
data class DetectedLanguage(val detectedLanguage: String, val providerId: LanguageProviderId)
|
||||||
+12
@@ -0,0 +1,12 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
interface LanguageDetectionProvider {
|
||||||
|
val providerId: LanguageProviderId
|
||||||
|
|
||||||
|
fun detect(query: String): String?
|
||||||
|
|
||||||
|
fun detect(query: String, control: TranslationCallControl?): String? {
|
||||||
|
control?.beforeCall()
|
||||||
|
return detect(query)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
enum class LanguageProviderId(val code: String) {
|
||||||
|
PAPAGO("papago"),
|
||||||
|
AWS("aws")
|
||||||
|
}
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
object LanguageProviderOrder {
|
||||||
|
val detectionOrder = listOf(LanguageProviderId.AWS, LanguageProviderId.PAPAGO)
|
||||||
|
val translationOrder = listOf(LanguageProviderId.AWS, LanguageProviderId.PAPAGO)
|
||||||
|
}
|
||||||
+22
@@ -0,0 +1,22 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.springframework.beans.factory.annotation.Autowired
|
||||||
|
import org.springframework.stereotype.Component
|
||||||
|
|
||||||
|
@Component
|
||||||
|
class LanguageProviderProperties(
|
||||||
|
val detectionOrder: List<LanguageProviderId>,
|
||||||
|
val translationOrder: List<LanguageProviderId>
|
||||||
|
) {
|
||||||
|
@Autowired
|
||||||
|
constructor() : this(LanguageProviderOrder.detectionOrder, LanguageProviderOrder.translationOrder)
|
||||||
|
|
||||||
|
fun <T> orderedProviders(order: List<LanguageProviderId>, providers: List<T>, id: (T) -> LanguageProviderId): List<T> {
|
||||||
|
require(order.isNotEmpty()) { "language provider order must not be empty" }
|
||||||
|
require(order.distinct().size == order.size) { "duplicate language provider order" }
|
||||||
|
val byId = providers.associateBy(id)
|
||||||
|
require(byId.size == providers.size) { "duplicate registered language provider name" }
|
||||||
|
require(order.all { it in byId }) { "unknown language provider in order" }
|
||||||
|
return order.map { byId.getValue(it) }
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.springframework.http.client.SimpleClientHttpRequestFactory
|
||||||
|
import org.springframework.web.client.RestTemplate
|
||||||
|
|
||||||
|
internal fun papagoAdminTransport(connectTimeoutMs: Int, readTimeoutMs: Int): RestTemplate =
|
||||||
|
RestTemplate(
|
||||||
|
SimpleClientHttpRequestFactory().apply {
|
||||||
|
setConnectTimeout(connectTimeoutMs)
|
||||||
|
setReadTimeout(readTimeoutMs)
|
||||||
|
}
|
||||||
|
)
|
||||||
+48
@@ -0,0 +1,48 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.springframework.beans.factory.annotation.Value
|
||||||
|
import org.springframework.http.HttpEntity
|
||||||
|
import org.springframework.http.HttpHeaders
|
||||||
|
import org.springframework.http.MediaType
|
||||||
|
import org.springframework.stereotype.Component
|
||||||
|
import org.springframework.util.LinkedMultiValueMap
|
||||||
|
import org.springframework.web.client.RestTemplate
|
||||||
|
|
||||||
|
@Component
|
||||||
|
class PapagoLanguageDetectionProvider(
|
||||||
|
@Value("\${cloud.naver.papago-client-id}")
|
||||||
|
private val papagoClientId: String,
|
||||||
|
@Value("\${cloud.naver.papago-client-secret}")
|
||||||
|
private val papagoClientSecret: String,
|
||||||
|
@Value("\${sodalive.translation-selection.connect-timeout-ms:3000}")
|
||||||
|
private val adminConnectTimeoutMs: Int = 3000,
|
||||||
|
@Value("\${sodalive.translation-selection.read-timeout-ms:15000}")
|
||||||
|
private val adminReadTimeoutMs: Int = 15000
|
||||||
|
) : LanguageDetectionProvider {
|
||||||
|
private val restTemplate = RestTemplate()
|
||||||
|
private val adminRestTemplate = papagoAdminTransport(adminConnectTimeoutMs, adminReadTimeoutMs)
|
||||||
|
private val papagoDetectUrl = "https://papago.apigw.ntruss.com/langs/v1/dect"
|
||||||
|
override val providerId = LanguageProviderId.PAPAGO
|
||||||
|
|
||||||
|
override fun detect(query: String): String? = detect(query, null)
|
||||||
|
|
||||||
|
override fun detect(query: String, control: TranslationCallControl?): String? {
|
||||||
|
val headers = HttpHeaders().apply {
|
||||||
|
contentType = MediaType.APPLICATION_FORM_URLENCODED
|
||||||
|
set("X-NCP-APIGW-API-KEY-ID", papagoClientId)
|
||||||
|
set("X-NCP-APIGW-API-KEY", papagoClientSecret)
|
||||||
|
}
|
||||||
|
val body = LinkedMultiValueMap<String, String>().apply { add("query", query) }
|
||||||
|
control?.beforeCall()
|
||||||
|
val transport = if (control == null) restTemplate else adminRestTemplate
|
||||||
|
val response = transport.postForEntity(
|
||||||
|
papagoDetectUrl,
|
||||||
|
HttpEntity(body, headers),
|
||||||
|
PapagoLanguageDetectResponse::class.java
|
||||||
|
)
|
||||||
|
if (!response.statusCode.is2xxSuccessful) return null
|
||||||
|
return response.body?.langCode?.takeIf { it.isNotBlank() }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
data class PapagoLanguageDetectResponse(val langCode: String?)
|
||||||
+15
-38
@@ -14,13 +14,18 @@ class PapagoTranslationService(
|
|||||||
private val papagoClientId: String,
|
private val papagoClientId: String,
|
||||||
|
|
||||||
@Value("\${cloud.naver.papago-client-secret}")
|
@Value("\${cloud.naver.papago-client-secret}")
|
||||||
private val papagoClientSecret: String
|
private val papagoClientSecret: String,
|
||||||
|
@Value("\${sodalive.translation-selection.connect-timeout-ms:3000}")
|
||||||
|
private val adminConnectTimeoutMs: Int = 3000,
|
||||||
|
@Value("\${sodalive.translation-selection.read-timeout-ms:15000}")
|
||||||
|
private val adminReadTimeoutMs: Int = 15000
|
||||||
) : TranslationProvider {
|
) : TranslationProvider {
|
||||||
private val restTemplate: RestTemplate = RestTemplate()
|
private val restTemplate: RestTemplate = RestTemplate()
|
||||||
|
private val adminRestTemplate = papagoAdminTransport(adminConnectTimeoutMs, adminReadTimeoutMs)
|
||||||
|
|
||||||
private val papagoTranslateUrl = "https://papago.apigw.ntruss.com/nmt/v1/translation"
|
private val papagoTranslateUrl = "https://papago.apigw.ntruss.com/nmt/v1/translation"
|
||||||
|
|
||||||
override val providerName: String = "papago"
|
override val providerId: LanguageProviderId = LanguageProviderId.PAPAGO
|
||||||
|
|
||||||
override val providerVersion: String = "nmt-v1"
|
override val providerVersion: String = "nmt-v1"
|
||||||
|
|
||||||
@@ -53,7 +58,9 @@ class PapagoTranslationService(
|
|||||||
|
|
||||||
val requestEntity = HttpEntity(body, headers)
|
val requestEntity = HttpEntity(body, headers)
|
||||||
|
|
||||||
val response = restTemplate.postForEntity<PapagoTranslationResponse>(
|
request.callControl?.beforeCall()
|
||||||
|
val transport = if (request.callControl == null) restTemplate else adminRestTemplate
|
||||||
|
val response = transport.postForEntity<PapagoTranslationResponse>(
|
||||||
papagoTranslateUrl,
|
papagoTranslateUrl,
|
||||||
requestEntity
|
requestEntity
|
||||||
)
|
)
|
||||||
@@ -69,7 +76,9 @@ class PapagoTranslationService(
|
|||||||
translatedText.append(translated)
|
translatedText.append(translated)
|
||||||
}
|
}
|
||||||
translatedTexts.add(translatedText.toString())
|
translatedTexts.add(translatedText.toString())
|
||||||
} catch (_: Exception) {
|
} catch (error: Exception) {
|
||||||
|
error.translationCallStop()?.let { throw it }
|
||||||
|
if (request.callControl != null) throw TranslationProviderFailed()
|
||||||
return TranslateResult(emptyList())
|
return TranslateResult(emptyList())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -78,46 +87,14 @@ class PapagoTranslationService(
|
|||||||
}
|
}
|
||||||
|
|
||||||
private fun splitText(text: String): List<String> {
|
private fun splitText(text: String): List<String> {
|
||||||
val chunks = mutableListOf<String>()
|
return splitTextByCodePoint(text, MAX_REQUEST_TEXT_LENGTH, Character::charCount)
|
||||||
var start = 0
|
|
||||||
do {
|
|
||||||
var end = minOf(start + MAX_REQUEST_TEXT_LENGTH, text.length)
|
|
||||||
if (end < text.length && text[end - 1].isHighSurrogate() && text[end].isLowSurrogate()) {
|
|
||||||
end -= 1
|
|
||||||
}
|
|
||||||
chunks.add(text.substring(start, end))
|
|
||||||
start = end
|
|
||||||
} while (start < text.length)
|
|
||||||
return chunks
|
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun validateLanguages(sourceLanguage: String, targetLanguage: String): Boolean {
|
private fun validateLanguages(sourceLanguage: String, targetLanguage: String): Boolean {
|
||||||
return requireSupportedLanguage(sourceLanguage) && requireSupportedLanguage(targetLanguage)
|
return TranslationLanguages.isSupported(sourceLanguage) && TranslationLanguages.isSupported(targetLanguage)
|
||||||
}
|
|
||||||
|
|
||||||
private fun requireSupportedLanguage(language: String): Boolean {
|
|
||||||
val normalized = language.lowercase()
|
|
||||||
return SUPPORTED_LANGUAGE_CODES.contains(normalized)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
private const val MAX_REQUEST_TEXT_LENGTH = 5000
|
private const val MAX_REQUEST_TEXT_LENGTH = 5000
|
||||||
|
|
||||||
private val SUPPORTED_LANGUAGE_CODES = setOf(
|
|
||||||
"ko",
|
|
||||||
"en",
|
|
||||||
"ja"
|
|
||||||
)
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 번역 대상 언어 코드 집합을 반환한다.
|
|
||||||
*
|
|
||||||
* @param excludedLanguageCode 번역 대상에서 제외할 언어 코드(대소문자 무시)
|
|
||||||
* @return 지원되는 언어 코드 중 [excludedLanguageCode]를 제외한 집합
|
|
||||||
*/
|
|
||||||
fun getTranslatableLanguageCodes(excludedLanguageCode: String?): Set<String> {
|
|
||||||
val normalized = excludedLanguageCode?.lowercase()
|
|
||||||
return SUPPORTED_LANGUAGE_CODES.filterNot { it == normalized }.toSet()
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,7 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
data class ProviderTranslationResult(
|
||||||
|
val result: TranslateResult,
|
||||||
|
val providerId: LanguageProviderId,
|
||||||
|
val providerVersion: String
|
||||||
|
)
|
||||||
+60
-2
@@ -1,13 +1,16 @@
|
|||||||
package kr.co.vividnext.sodalive.i18n.translation
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationService.Companion.getTranslatableLanguageCodes
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationLanguages.getTranslatableLanguageCodes
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
|
import org.springframework.transaction.annotation.Propagation
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
class ResourceTranslationJobScheduler(
|
class ResourceTranslationJobScheduler(
|
||||||
private val sourceExtractor: TranslationSourceExtractor,
|
private val sourceExtractor: TranslationSourceExtractor,
|
||||||
private val translationJobScheduler: TranslationJobScheduler
|
private val translationJobScheduler: TranslationJobScheduler,
|
||||||
|
private val translationJobRepository: TranslationJobRepository
|
||||||
) {
|
) {
|
||||||
@Transactional
|
@Transactional
|
||||||
fun scheduleResourceTranslations(resourceType: LanguageTranslationTargetType, resourceId: Long) {
|
fun scheduleResourceTranslations(resourceType: LanguageTranslationTargetType, resourceId: Long) {
|
||||||
@@ -27,6 +30,61 @@ class ResourceTranslationJobScheduler(
|
|||||||
scheduleSource(source, targetLanguage)
|
scheduleSource(source, targetLanguage)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Transactional(propagation = Propagation.REQUIRES_NEW)
|
||||||
|
fun restartFailedResourceTranslations(
|
||||||
|
resourceType: LanguageTranslationTargetType,
|
||||||
|
resourceIds: Collection<Long>,
|
||||||
|
targetLanguage: String
|
||||||
|
) {
|
||||||
|
restartFailedResourceTranslationsInCurrentTransaction(resourceType, resourceIds, targetLanguage)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Transactional
|
||||||
|
fun restartFailedResourceTranslationsInCurrentTransaction(
|
||||||
|
resourceType: LanguageTranslationTargetType,
|
||||||
|
resourceIds: Collection<Long>,
|
||||||
|
targetLanguage: String
|
||||||
|
) {
|
||||||
|
if (resourceIds.isEmpty()) return
|
||||||
|
|
||||||
|
val target = targetLanguage.lowercase()
|
||||||
|
val candidates = translationJobRepository.findByResourceTypeAndResourceIdInAndTargetLanguageAndStatus(
|
||||||
|
resourceType,
|
||||||
|
resourceIds,
|
||||||
|
target,
|
||||||
|
TranslationJobStatus.FAILED
|
||||||
|
) + if (resourceType == LanguageTranslationTargetType.CONTENT) {
|
||||||
|
translationJobRepository.findCompletedContentTagJobs(resourceIds, target)
|
||||||
|
} else {
|
||||||
|
emptyList()
|
||||||
|
}
|
||||||
|
val now = LocalDateTime.now()
|
||||||
|
candidates.groupBy { it.resourceId }.forEach { (resourceId, resourceJobs) ->
|
||||||
|
val source = sourceExtractor.extract(resourceType, resourceId) ?: return@forEach
|
||||||
|
val sourceLanguage = source.sourceLanguage.lowercase()
|
||||||
|
if (!TranslationLanguages.isSupported(sourceLanguage) || sourceLanguage == target) return@forEach
|
||||||
|
|
||||||
|
val sourceFields = source.fields.associateBy { it.fieldKey }
|
||||||
|
resourceJobs.filter { job ->
|
||||||
|
job.sourceLanguage == sourceLanguage &&
|
||||||
|
job.sourceHash == sourceFields[job.fieldKey]?.let { SourceTextNormalizer.hash(it.sourceText) }
|
||||||
|
}.forEach { job ->
|
||||||
|
when (job.status) {
|
||||||
|
TranslationJobStatus.FAILED -> translationJobRepository.restartFailedJob(requireNotNull(job.id), now)
|
||||||
|
TranslationJobStatus.COMPLETED -> translationJobScheduler.scheduleMissingTranslation(
|
||||||
|
resourceType = resourceType,
|
||||||
|
resourceId = resourceId,
|
||||||
|
fieldKey = job.fieldKey,
|
||||||
|
sourceText = sourceFields.getValue(job.fieldKey).sourceText,
|
||||||
|
sourceLanguage = sourceLanguage,
|
||||||
|
targetLanguage = target
|
||||||
|
)
|
||||||
|
TranslationJobStatus.PENDING, TranslationJobStatus.RUNNING -> Unit
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
private fun scheduleSource(source: TranslationSource, targetLanguage: String) {
|
private fun scheduleSource(source: TranslationSource, targetLanguage: String) {
|
||||||
source.fields.forEach { field ->
|
source.fields.forEach { field ->
|
||||||
translationJobScheduler.scheduleMissingTranslation(
|
translationJobScheduler.scheduleMissingTranslation(
|
||||||
|
|||||||
@@ -20,4 +20,8 @@ object SourceTextNormalizer {
|
|||||||
.digest(normalized.toByteArray(Charsets.UTF_8))
|
.digest(normalized.toByteArray(Charsets.UTF_8))
|
||||||
return digest.joinToString("") { "%02x".format(it) }
|
return digest.joinToString("") { "%02x".format(it) }
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fun hasSameCommaSeparatedText(first: String, second: String): Boolean {
|
||||||
|
return first.split(',').map(::normalize) == second.split(',').map(::normalize)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -3,7 +3,9 @@ package kr.co.vividnext.sodalive.i18n.translation
|
|||||||
data class TranslateRequest(
|
data class TranslateRequest(
|
||||||
val texts: List<String>,
|
val texts: List<String>,
|
||||||
val sourceLanguage: String,
|
val sourceLanguage: String,
|
||||||
val targetLanguage: String
|
val targetLanguage: String,
|
||||||
|
val rejectUnchangedAwsResult: Boolean = false,
|
||||||
|
val callControl: TranslationCallControl? = null
|
||||||
)
|
)
|
||||||
|
|
||||||
data class TranslateResult(
|
data class TranslateResult(
|
||||||
|
|||||||
@@ -0,0 +1,29 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import java.time.Duration
|
||||||
|
|
||||||
|
enum class TranslationCallStopReason { OWNERSHIP_LOST, BUDGET_EXCEEDED }
|
||||||
|
class TranslationCallStopped(val reason: TranslationCallStopReason) : RuntimeException(reason.name)
|
||||||
|
class TranslationProviderFailed : RuntimeException("PROVIDER_FAILED")
|
||||||
|
|
||||||
|
class TranslationCallControl(
|
||||||
|
private val authorizeDispatch: () -> Boolean,
|
||||||
|
budget: Duration = Duration.ofSeconds(15),
|
||||||
|
private val nanoTime: () -> Long = System::nanoTime
|
||||||
|
) {
|
||||||
|
private val deadline = nanoTime() + budget.toNanos()
|
||||||
|
|
||||||
|
fun beforeCall() {
|
||||||
|
remainingTimeout()
|
||||||
|
if (!authorizeDispatch()) throw TranslationCallStopped(TranslationCallStopReason.OWNERSHIP_LOST)
|
||||||
|
}
|
||||||
|
|
||||||
|
fun remainingTimeout(): Duration {
|
||||||
|
val remaining = deadline - nanoTime()
|
||||||
|
if (remaining <= 0) throw TranslationCallStopped(TranslationCallStopReason.BUDGET_EXCEEDED)
|
||||||
|
return Duration.ofNanos(remaining)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fun Throwable.translationCallStop(): TranslationCallStopped? =
|
||||||
|
generateSequence(this) { it.cause }.filterIsInstance<TranslationCallStopped>().firstOrNull()
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.springframework.stereotype.Service
|
||||||
|
|
||||||
|
@Service
|
||||||
|
class TranslationCoordinator(
|
||||||
|
providers: List<TranslationProvider>,
|
||||||
|
properties: LanguageProviderProperties,
|
||||||
|
private val translationMemoryRepository: TranslationMemoryRepository
|
||||||
|
) {
|
||||||
|
private val providers = properties.orderedProviders(properties.translationOrder, providers) { it.providerId }
|
||||||
|
|
||||||
|
fun findCached(
|
||||||
|
sourceHash: String,
|
||||||
|
sourceLanguage: String,
|
||||||
|
targetLanguage: String,
|
||||||
|
rejectUnchangedAwsResult: Boolean = false
|
||||||
|
): TranslationMemory? {
|
||||||
|
providers.forEach { provider ->
|
||||||
|
val memory = translationMemoryRepository
|
||||||
|
.findBySourceHashAndSourceLanguageAndTargetLanguageAndProviderAndNormalizationVersion(
|
||||||
|
sourceHash,
|
||||||
|
sourceLanguage,
|
||||||
|
targetLanguage,
|
||||||
|
provider.providerId.code,
|
||||||
|
SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
|
)
|
||||||
|
if (memory == null || memory.translatedText.isBlank()) return@forEach
|
||||||
|
if (
|
||||||
|
rejectUnchangedAwsResult && provider.providerId == LanguageProviderId.AWS &&
|
||||||
|
SourceTextNormalizer.hasSameCommaSeparatedText(memory.sourceText, memory.translatedText)
|
||||||
|
) {
|
||||||
|
return@forEach
|
||||||
|
}
|
||||||
|
return memory
|
||||||
|
}
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
fun translate(request: TranslateRequest): ProviderTranslationResult {
|
||||||
|
require(
|
||||||
|
request.texts.isNotEmpty() && request.texts.none { it.isBlank() } &&
|
||||||
|
request.sourceLanguage.lowercase() != request.targetLanguage.lowercase() &&
|
||||||
|
TranslationLanguages.isSupported(request.sourceLanguage) &&
|
||||||
|
TranslationLanguages.isSupported(request.targetLanguage)
|
||||||
|
) { "invalid translation request" }
|
||||||
|
providers.forEach { provider ->
|
||||||
|
val result = try {
|
||||||
|
provider.translate(request)
|
||||||
|
} catch (_: Exception) {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
if (
|
||||||
|
result != null && result.translatedText.size == request.texts.size &&
|
||||||
|
result.translatedText.none { it.isBlank() }
|
||||||
|
) {
|
||||||
|
if (
|
||||||
|
request.rejectUnchangedAwsResult && provider.providerId == LanguageProviderId.AWS &&
|
||||||
|
request.texts.zip(result.translatedText).any { (source, translated) ->
|
||||||
|
SourceTextNormalizer.hasSameCommaSeparatedText(source, translated)
|
||||||
|
}
|
||||||
|
) {
|
||||||
|
return@forEach
|
||||||
|
}
|
||||||
|
return ProviderTranslationResult(result, provider.providerId, provider.providerVersion)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
throw IllegalStateException("all translation providers failed")
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -21,8 +21,8 @@ enum class TranslationJobStatus {
|
|||||||
name = "translation_job",
|
name = "translation_job",
|
||||||
uniqueConstraints = [
|
uniqueConstraints = [
|
||||||
UniqueConstraint(
|
UniqueConstraint(
|
||||||
name = "uk_translation_job_resource_field_target_hash",
|
name = "uk_translation_job_resource_field_target_hash_language",
|
||||||
columnNames = ["resource_type", "resource_id", "field_key", "target_language", "source_hash"]
|
columnNames = ["resource_type", "resource_id", "field_key", "target_language", "source_hash", "source_language"]
|
||||||
)
|
)
|
||||||
]
|
]
|
||||||
)
|
)
|
||||||
|
|||||||
+83
-4
@@ -1,19 +1,95 @@
|
|||||||
package kr.co.vividnext.sodalive.i18n.translation
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
import org.springframework.data.jpa.repository.JpaRepository
|
import org.springframework.data.jpa.repository.JpaRepository
|
||||||
|
import org.springframework.data.jpa.repository.Lock
|
||||||
|
import org.springframework.data.jpa.repository.Modifying
|
||||||
import org.springframework.data.jpa.repository.Query
|
import org.springframework.data.jpa.repository.Query
|
||||||
import org.springframework.data.repository.query.Param
|
import org.springframework.data.repository.query.Param
|
||||||
import java.time.LocalDateTime
|
import java.time.LocalDateTime
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
||||||
fun findByResourceTypeAndResourceIdAndFieldKeyAndTargetLanguageAndSourceHash(
|
fun findByResourceTypeAndResourceIdAndFieldKeyAndTargetLanguageAndSourceHashAndSourceLanguage(
|
||||||
resourceType: LanguageTranslationTargetType,
|
resourceType: LanguageTranslationTargetType,
|
||||||
resourceId: Long,
|
resourceId: Long,
|
||||||
fieldKey: String,
|
fieldKey: String,
|
||||||
targetLanguage: String,
|
targetLanguage: String,
|
||||||
sourceHash: String
|
sourceHash: String,
|
||||||
|
sourceLanguage: String
|
||||||
): TranslationJob?
|
): TranslationJob?
|
||||||
|
|
||||||
|
@Lock(LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
@Query(
|
||||||
|
"""
|
||||||
|
select j from TranslationJob j
|
||||||
|
where j.resourceType = kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType.CONTENT
|
||||||
|
and j.resourceId = :contentId
|
||||||
|
and j.fieldKey = :fieldKey
|
||||||
|
and j.targetLanguage = :targetLanguage
|
||||||
|
and j.sourceHash = :sourceHash
|
||||||
|
and j.sourceLanguage = :sourceLanguage
|
||||||
|
order by j.id
|
||||||
|
"""
|
||||||
|
)
|
||||||
|
fun findContentFieldJobsForUpdate(
|
||||||
|
@Param("contentId") contentId: Long,
|
||||||
|
@Param("fieldKey") fieldKey: String,
|
||||||
|
@Param("targetLanguage") targetLanguage: String,
|
||||||
|
@Param("sourceHash") sourceHash: String,
|
||||||
|
@Param("sourceLanguage") sourceLanguage: String
|
||||||
|
): List<TranslationJob>
|
||||||
|
|
||||||
|
fun findByResourceTypeAndResourceIdInAndTargetLanguageAndStatus(
|
||||||
|
resourceType: LanguageTranslationTargetType,
|
||||||
|
resourceIds: Collection<Long>,
|
||||||
|
targetLanguage: String,
|
||||||
|
status: TranslationJobStatus
|
||||||
|
): List<TranslationJob>
|
||||||
|
|
||||||
|
@Query(
|
||||||
|
"""
|
||||||
|
select j from TranslationJob j
|
||||||
|
where j.resourceType = kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType.CONTENT
|
||||||
|
and j.resourceId in :resourceIds
|
||||||
|
and j.targetLanguage = :targetLanguage
|
||||||
|
and j.fieldKey = 'tags'
|
||||||
|
and j.status = kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.COMPLETED
|
||||||
|
"""
|
||||||
|
)
|
||||||
|
fun findCompletedContentTagJobs(
|
||||||
|
@Param("resourceIds") resourceIds: Collection<Long>,
|
||||||
|
@Param("targetLanguage") targetLanguage: String
|
||||||
|
): List<TranslationJob>
|
||||||
|
|
||||||
|
@Modifying
|
||||||
|
@Query(
|
||||||
|
"""
|
||||||
|
update TranslationJob j
|
||||||
|
set j.status = kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.PENDING,
|
||||||
|
j.retryCount = 0,
|
||||||
|
j.lastErrorMessage = null,
|
||||||
|
j.nextRetryAt = :now
|
||||||
|
where j.id = :jobId
|
||||||
|
and j.status = kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.FAILED
|
||||||
|
"""
|
||||||
|
)
|
||||||
|
fun restartFailedJob(@Param("jobId") jobId: Long, @Param("now") now: LocalDateTime): Int
|
||||||
|
|
||||||
|
@Modifying
|
||||||
|
@Query(
|
||||||
|
"""
|
||||||
|
update TranslationJob j
|
||||||
|
set j.status = kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.PENDING,
|
||||||
|
j.retryCount = 0,
|
||||||
|
j.lastErrorMessage = null,
|
||||||
|
j.nextRetryAt = :now
|
||||||
|
where j.id = :jobId
|
||||||
|
and j.resourceType = kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType.CONTENT
|
||||||
|
and j.status = kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.COMPLETED
|
||||||
|
"""
|
||||||
|
)
|
||||||
|
fun restartCompletedContentFieldJob(@Param("jobId") jobId: Long, @Param("now") now: LocalDateTime): Int
|
||||||
|
|
||||||
@Query(
|
@Query(
|
||||||
"""
|
"""
|
||||||
select j from TranslationJob j
|
select j from TranslationJob j
|
||||||
@@ -22,6 +98,7 @@ interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
|||||||
and j.fieldKey = :fieldKey
|
and j.fieldKey = :fieldKey
|
||||||
and j.targetLanguage = :targetLanguage
|
and j.targetLanguage = :targetLanguage
|
||||||
and j.sourceHash = :sourceHash
|
and j.sourceHash = :sourceHash
|
||||||
|
and j.sourceLanguage = :sourceLanguage
|
||||||
and j.status in (kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.PENDING, kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.RUNNING)
|
and j.status in (kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.PENDING, kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.RUNNING)
|
||||||
"""
|
"""
|
||||||
)
|
)
|
||||||
@@ -30,7 +107,8 @@ interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
|||||||
@Param("resourceId") resourceId: Long,
|
@Param("resourceId") resourceId: Long,
|
||||||
@Param("fieldKey") fieldKey: String,
|
@Param("fieldKey") fieldKey: String,
|
||||||
@Param("targetLanguage") targetLanguage: String,
|
@Param("targetLanguage") targetLanguage: String,
|
||||||
@Param("sourceHash") sourceHash: String
|
@Param("sourceHash") sourceHash: String,
|
||||||
|
@Param("sourceLanguage") sourceLanguage: String
|
||||||
): TranslationJob?
|
): TranslationJob?
|
||||||
|
|
||||||
@Query(
|
@Query(
|
||||||
@@ -38,7 +116,7 @@ interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
|||||||
select j.id
|
select j.id
|
||||||
from translation_job j
|
from translation_job j
|
||||||
join (
|
join (
|
||||||
select resource_type, resource_id, target_language
|
select resource_type, resource_id, target_language, source_language
|
||||||
from translation_job
|
from translation_job
|
||||||
where status = 'PENDING'
|
where status = 'PENDING'
|
||||||
and next_retry_at <= :now
|
and next_retry_at <= :now
|
||||||
@@ -47,6 +125,7 @@ interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
|||||||
) g on j.resource_type = g.resource_type
|
) g on j.resource_type = g.resource_type
|
||||||
and j.resource_id = g.resource_id
|
and j.resource_id = g.resource_id
|
||||||
and j.target_language = g.target_language
|
and j.target_language = g.target_language
|
||||||
|
and j.source_language = g.source_language
|
||||||
where j.status = 'PENDING'
|
where j.status = 'PENDING'
|
||||||
and j.next_retry_at <= :now
|
and j.next_retry_at <= :now
|
||||||
order by j.created_at asc
|
order by j.created_at asc
|
||||||
|
|||||||
+66
-10
@@ -1,12 +1,18 @@
|
|||||||
package kr.co.vividnext.sodalive.i18n.translation
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
import java.time.LocalDateTime
|
import java.time.LocalDateTime
|
||||||
|
import javax.persistence.EntityManager
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
class TranslationJobScheduler(
|
class TranslationJobScheduler(
|
||||||
private val translationJobRepository: TranslationJobRepository
|
private val translationJobRepository: TranslationJobRepository,
|
||||||
|
private val translationCoordinator: TranslationCoordinator,
|
||||||
|
private val contentTranslationRepository: ContentTranslationRepository,
|
||||||
|
private val entityManager: EntityManager
|
||||||
) {
|
) {
|
||||||
@Transactional
|
@Transactional
|
||||||
fun scheduleMissingTranslation(
|
fun scheduleMissingTranslation(
|
||||||
@@ -15,26 +21,80 @@ class TranslationJobScheduler(
|
|||||||
fieldKey: String,
|
fieldKey: String,
|
||||||
sourceText: String,
|
sourceText: String,
|
||||||
sourceLanguage: String,
|
sourceLanguage: String,
|
||||||
targetLanguage: String
|
targetLanguage: String,
|
||||||
|
refreshCompletedContentField: Boolean = false
|
||||||
) {
|
) {
|
||||||
val normalizedText = SourceTextNormalizer.normalize(sourceText)
|
val normalizedText = SourceTextNormalizer.normalize(sourceText)
|
||||||
if (normalizedText.isBlank()) return
|
if (normalizedText.isBlank()) return
|
||||||
|
|
||||||
val normalizedSourceLanguage = sourceLanguage.lowercase()
|
val normalizedSourceLanguage = sourceLanguage.lowercase()
|
||||||
if (!SUPPORTED_SOURCE_LANGUAGE_CODES.contains(normalizedSourceLanguage)) return
|
if (!TranslationLanguages.isSupported(normalizedSourceLanguage)) return
|
||||||
|
|
||||||
val normalizedTargetLanguage = targetLanguage.lowercase()
|
val normalizedTargetLanguage = targetLanguage.lowercase()
|
||||||
if (normalizedSourceLanguage == normalizedTargetLanguage) return
|
if (normalizedSourceLanguage == normalizedTargetLanguage) return
|
||||||
|
|
||||||
val sourceHash = SourceTextNormalizer.hash(normalizedText)
|
val sourceHash = SourceTextNormalizer.hash(normalizedText)
|
||||||
val existingJob = translationJobRepository.findByResourceTypeAndResourceIdAndFieldKeyAndTargetLanguageAndSourceHash(
|
val forceContentRefresh = resourceType == LanguageTranslationTargetType.CONTENT && refreshCompletedContentField
|
||||||
|
val existingJob = if (forceContentRefresh) {
|
||||||
|
translationJobRepository.findContentFieldJobsForUpdate(
|
||||||
|
resourceId,
|
||||||
|
fieldKey,
|
||||||
|
normalizedTargetLanguage,
|
||||||
|
sourceHash,
|
||||||
|
normalizedSourceLanguage
|
||||||
|
).singleOrNull()?.also { entityManager.refresh(it, LockModeType.PESSIMISTIC_WRITE) }
|
||||||
|
} else {
|
||||||
|
translationJobRepository.findByResourceTypeAndResourceIdAndFieldKeyAndTargetLanguageAndSourceHashAndSourceLanguage(
|
||||||
resourceType = resourceType,
|
resourceType = resourceType,
|
||||||
resourceId = resourceId,
|
resourceId = resourceId,
|
||||||
fieldKey = fieldKey,
|
fieldKey = fieldKey,
|
||||||
targetLanguage = normalizedTargetLanguage,
|
targetLanguage = normalizedTargetLanguage,
|
||||||
sourceHash = sourceHash
|
sourceHash = sourceHash,
|
||||||
|
sourceLanguage = normalizedSourceLanguage
|
||||||
)
|
)
|
||||||
if (existingJob != null) return
|
}
|
||||||
|
if (existingJob != null) {
|
||||||
|
if (forceContentRefresh) {
|
||||||
|
when (existingJob.status) {
|
||||||
|
TranslationJobStatus.FAILED, TranslationJobStatus.COMPLETED -> {
|
||||||
|
existingJob.status = TranslationJobStatus.PENDING
|
||||||
|
existingJob.retryCount = 0
|
||||||
|
existingJob.lastErrorMessage = null
|
||||||
|
existingJob.nextRetryAt = LocalDateTime.now()
|
||||||
|
}
|
||||||
|
TranslationJobStatus.PENDING, TranslationJobStatus.RUNNING -> Unit
|
||||||
|
}
|
||||||
|
return
|
||||||
|
}
|
||||||
|
when (existingJob.status) {
|
||||||
|
TranslationJobStatus.FAILED ->
|
||||||
|
translationJobRepository.restartFailedJob(requireNotNull(existingJob.id), LocalDateTime.now())
|
||||||
|
TranslationJobStatus.COMPLETED -> {
|
||||||
|
if (resourceType != LanguageTranslationTargetType.CONTENT || fieldKey != "tags") return
|
||||||
|
|
||||||
|
val renderedTags = contentTranslationRepository.findByContentIdAndLocale(resourceId, normalizedTargetLanguage)
|
||||||
|
?.renderedPayload?.tags
|
||||||
|
if (
|
||||||
|
!renderedTags.isNullOrBlank() &&
|
||||||
|
!SourceTextNormalizer.hasSameCommaSeparatedText(normalizedText, renderedTags)
|
||||||
|
) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
val cached = translationCoordinator.findCached(
|
||||||
|
sourceHash,
|
||||||
|
normalizedSourceLanguage,
|
||||||
|
normalizedTargetLanguage,
|
||||||
|
rejectUnchangedAwsResult = true
|
||||||
|
)
|
||||||
|
if (cached != null && cached.translatedText == renderedTags) return
|
||||||
|
|
||||||
|
translationJobRepository.restartCompletedContentFieldJob(requireNotNull(existingJob.id), LocalDateTime.now())
|
||||||
|
}
|
||||||
|
TranslationJobStatus.PENDING, TranslationJobStatus.RUNNING -> Unit
|
||||||
|
}
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
translationJobRepository.save(
|
translationJobRepository.save(
|
||||||
TranslationJob(
|
TranslationJob(
|
||||||
@@ -49,8 +109,4 @@ class TranslationJobScheduler(
|
|||||||
)
|
)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
|
||||||
private val SUPPORTED_SOURCE_LANGUAGE_CODES = setOf("ko", "en", "ja")
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -10,15 +10,14 @@ import java.time.LocalDateTime
|
|||||||
@Component
|
@Component
|
||||||
class TranslationJobWorker(
|
class TranslationJobWorker(
|
||||||
private val translationJobRepository: TranslationJobRepository,
|
private val translationJobRepository: TranslationJobRepository,
|
||||||
private val translationMemoryRepository: TranslationMemoryRepository,
|
private val translationMemoryService: TranslationMemoryService,
|
||||||
private val translationProvider: TranslationProvider,
|
|
||||||
private val materializer: TranslationReadModelMaterializer,
|
private val materializer: TranslationReadModelMaterializer,
|
||||||
transactionManager: PlatformTransactionManager
|
transactionManager: PlatformTransactionManager
|
||||||
) {
|
) {
|
||||||
private val log = LoggerFactory.getLogger(javaClass)
|
private val log = LoggerFactory.getLogger(javaClass)
|
||||||
private val transactionTemplate = TransactionTemplate(transactionManager)
|
private val transactionTemplate = TransactionTemplate(transactionManager)
|
||||||
|
|
||||||
@Scheduled(fixedDelayString = "\${sodalive.translation-job.fixed-delay-ms:600000}")
|
@Scheduled(fixedDelayString = "\${sodalive.translation-job.fixed-delay-ms:1000}")
|
||||||
fun runPendingJobs() {
|
fun runPendingJobs() {
|
||||||
repeat(MAX_GROUPS_PER_TICK) {
|
repeat(MAX_GROUPS_PER_TICK) {
|
||||||
if (!processNextGroup()) return
|
if (!processNextGroup()) return
|
||||||
@@ -34,25 +33,47 @@ class TranslationJobWorker(
|
|||||||
val failedJobs = mutableListOf<Pair<TranslationJob, Exception>>()
|
val failedJobs = mutableListOf<Pair<TranslationJob, Exception>>()
|
||||||
jobs.forEach { job ->
|
jobs.forEach { job ->
|
||||||
try {
|
try {
|
||||||
ensureMemory(job)
|
if (job.resourceType != LanguageTranslationTargetType.CONTENT || !materializer.hasCurrentContentApproval(job)) {
|
||||||
|
translationMemoryService.ensureMemory(
|
||||||
|
job.resourceType,
|
||||||
|
job.fieldKey,
|
||||||
|
job.sourceText,
|
||||||
|
job.sourceLanguage,
|
||||||
|
job.targetLanguage
|
||||||
|
)
|
||||||
|
}
|
||||||
succeededJobs.add(job)
|
succeededJobs.add(job)
|
||||||
} catch (ex: Exception) {
|
} catch (ex: Exception) {
|
||||||
failedJobs.add(job to ex)
|
failedJobs.add(job to ex)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if (failedJobs.isNotEmpty()) {
|
if (failedJobs.isNotEmpty() && firstJob.resourceType != LanguageTranslationTargetType.CONTENT) {
|
||||||
succeededJobs.forEach { completeJob(it.id!!) }
|
succeededJobs.forEach { completeJob(it.id!!) }
|
||||||
failedJobs.forEach { (job, ex) -> failJob(job.id!!, ex) }
|
failedJobs.forEach { (job, ex) -> failJob(job.id!!, ex) }
|
||||||
return true
|
return true
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (succeededJobs.isNotEmpty()) {
|
||||||
try {
|
try {
|
||||||
|
transactionTemplate.executeWithoutResult {
|
||||||
|
val materialized = if (firstJob.resourceType == LanguageTranslationTargetType.CONTENT) {
|
||||||
|
materializer.materializeContentFields(
|
||||||
|
firstJob.resourceId,
|
||||||
|
firstJob.targetLanguage,
|
||||||
|
succeededJobs.map { it.fieldKey }.toSet()
|
||||||
|
)
|
||||||
|
} else {
|
||||||
materializer.materialize(firstJob.resourceType, firstJob.resourceId, firstJob.targetLanguage)
|
materializer.materialize(firstJob.resourceType, firstJob.resourceId, firstJob.targetLanguage)
|
||||||
|
}
|
||||||
|
check(materialized) { "translation materialization is incomplete" }
|
||||||
succeededJobs.forEach { completeJob(it.id!!) }
|
succeededJobs.forEach { completeJob(it.id!!) }
|
||||||
|
}
|
||||||
} catch (ex: Exception) {
|
} catch (ex: Exception) {
|
||||||
succeededJobs.forEach { failJob(it.id!!, ex) }
|
succeededJobs.forEach { failJob(it.id!!, ex) }
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
failedJobs.forEach { (job, ex) -> failJob(job.id!!, ex) }
|
||||||
return true
|
return true
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -68,52 +89,6 @@ class TranslationJobWorker(
|
|||||||
}.orEmpty()
|
}.orEmpty()
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun ensureMemory(job: TranslationJob) {
|
|
||||||
val existing = translationMemoryRepository
|
|
||||||
.findBySourceHashAndSourceLanguageAndTargetLanguageAndProviderAndNormalizationVersion(
|
|
||||||
sourceHash = job.sourceHash,
|
|
||||||
sourceLanguage = job.sourceLanguage,
|
|
||||||
targetLanguage = job.targetLanguage,
|
|
||||||
provider = translationProvider.providerName,
|
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
|
||||||
)
|
|
||||||
if (existing != null) return
|
|
||||||
|
|
||||||
val response = translationProvider.translate(
|
|
||||||
TranslateRequest(
|
|
||||||
texts = listOf(job.sourceText),
|
|
||||||
sourceLanguage = job.sourceLanguage,
|
|
||||||
targetLanguage = job.targetLanguage
|
|
||||||
)
|
|
||||||
)
|
|
||||||
val translated = response.translatedText.firstOrNull()?.takeIf { it.isNotBlank() }
|
|
||||||
?: throw IllegalStateException("empty translation result")
|
|
||||||
|
|
||||||
transactionTemplate.executeWithoutResult {
|
|
||||||
val memory = translationMemoryRepository
|
|
||||||
.findBySourceHashAndSourceLanguageAndTargetLanguageAndProviderAndNormalizationVersion(
|
|
||||||
sourceHash = job.sourceHash,
|
|
||||||
sourceLanguage = job.sourceLanguage,
|
|
||||||
targetLanguage = job.targetLanguage,
|
|
||||||
provider = translationProvider.providerName,
|
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
|
||||||
)
|
|
||||||
if (memory == null) {
|
|
||||||
translationMemoryRepository.save(
|
|
||||||
TranslationMemory(
|
|
||||||
sourceHash = job.sourceHash,
|
|
||||||
sourceText = job.sourceText,
|
|
||||||
sourceLanguage = job.sourceLanguage,
|
|
||||||
targetLanguage = job.targetLanguage,
|
|
||||||
translatedText = translated,
|
|
||||||
provider = translationProvider.providerName,
|
|
||||||
providerVersion = translationProvider.providerVersion
|
|
||||||
)
|
|
||||||
)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun completeJob(jobId: Long) {
|
private fun completeJob(jobId: Long) {
|
||||||
transactionTemplate.executeWithoutResult {
|
transactionTemplate.executeWithoutResult {
|
||||||
val job = translationJobRepository.findById(jobId).orElse(null) ?: return@executeWithoutResult
|
val job = translationJobRepository.findById(jobId).orElse(null) ?: return@executeWithoutResult
|
||||||
@@ -129,7 +104,7 @@ class TranslationJobWorker(
|
|||||||
val job = translationJobRepository.findById(jobId).orElse(null) ?: return@executeWithoutResult
|
val job = translationJobRepository.findById(jobId).orElse(null) ?: return@executeWithoutResult
|
||||||
job.retryCount += 1
|
job.retryCount += 1
|
||||||
job.lastErrorMessage = ex.message?.take(MAX_ERROR_LENGTH)
|
job.lastErrorMessage = ex.message?.take(MAX_ERROR_LENGTH)
|
||||||
if (job.retryCount >= MAX_RETRY_COUNT) {
|
if (job.retryCount >= MAX_ATTEMPTS) {
|
||||||
job.status = TranslationJobStatus.FAILED
|
job.status = TranslationJobStatus.FAILED
|
||||||
} else {
|
} else {
|
||||||
job.status = TranslationJobStatus.PENDING
|
job.status = TranslationJobStatus.PENDING
|
||||||
@@ -150,6 +125,6 @@ class TranslationJobWorker(
|
|||||||
companion object {
|
companion object {
|
||||||
private const val MAX_GROUPS_PER_TICK = 5
|
private const val MAX_GROUPS_PER_TICK = 5
|
||||||
private const val MAX_ERROR_LENGTH = 1000
|
private const val MAX_ERROR_LENGTH = 1000
|
||||||
private const val MAX_RETRY_COUNT = 3
|
private const val MAX_ATTEMPTS = 6
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,12 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
object TranslationLanguages {
|
||||||
|
private val supportedLanguageCodes = setOf("ko", "en", "ja")
|
||||||
|
|
||||||
|
fun isSupported(language: String): Boolean = language.lowercase() in supportedLanguageCodes
|
||||||
|
|
||||||
|
fun getTranslatableLanguageCodes(excludedLanguageCode: String?): Set<String> {
|
||||||
|
val normalized = excludedLanguageCode?.lowercase()
|
||||||
|
return supportedLanguageCodes.filterNot { it == normalized }.toSet()
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -30,7 +30,7 @@ class TranslationMemory(
|
|||||||
val targetLanguage: String,
|
val targetLanguage: String,
|
||||||
|
|
||||||
@Column(name = "translated_text", nullable = false, columnDefinition = "text")
|
@Column(name = "translated_text", nullable = false, columnDefinition = "text")
|
||||||
val translatedText: String,
|
var translatedText: String,
|
||||||
|
|
||||||
@Column(name = "provider", nullable = false, length = 50)
|
@Column(name = "provider", nullable = false, length = 50)
|
||||||
val provider: String,
|
val provider: String,
|
||||||
|
|||||||
@@ -0,0 +1,88 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
import org.hibernate.exception.ConstraintViolationException
|
||||||
|
import org.springframework.dao.DataIntegrityViolationException
|
||||||
|
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 java.sql.SQLException
|
||||||
|
|
||||||
|
@Service
|
||||||
|
class TranslationMemoryService(
|
||||||
|
private val translationMemoryRepository: TranslationMemoryRepository,
|
||||||
|
private val translationCoordinator: TranslationCoordinator,
|
||||||
|
transactionManager: PlatformTransactionManager
|
||||||
|
) {
|
||||||
|
private val transaction = TransactionTemplate(transactionManager).apply {
|
||||||
|
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
|
||||||
|
}
|
||||||
|
|
||||||
|
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||||
|
fun ensureMemory(
|
||||||
|
resourceType: LanguageTranslationTargetType,
|
||||||
|
fieldKey: String,
|
||||||
|
sourceText: String,
|
||||||
|
sourceLanguage: String,
|
||||||
|
targetLanguage: String
|
||||||
|
) {
|
||||||
|
val text = SourceTextNormalizer.normalize(sourceText)
|
||||||
|
if (text.isBlank()) return
|
||||||
|
val sourceHash = SourceTextNormalizer.hash(text)
|
||||||
|
val source = sourceLanguage.lowercase()
|
||||||
|
val target = targetLanguage.lowercase()
|
||||||
|
val rejectUnchangedAwsResult = resourceType == LanguageTranslationTargetType.CONTENT && fieldKey == "tags"
|
||||||
|
val existing = transaction.execute {
|
||||||
|
translationCoordinator.findCached(sourceHash, source, target, rejectUnchangedAwsResult)
|
||||||
|
}
|
||||||
|
if (existing != null) return
|
||||||
|
|
||||||
|
val response = translationCoordinator.translate(
|
||||||
|
TranslateRequest(listOf(text), source, target, rejectUnchangedAwsResult)
|
||||||
|
)
|
||||||
|
val translated = response.result.translatedText.single()
|
||||||
|
try {
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
val memory = translationMemoryRepository
|
||||||
|
.findBySourceHashAndSourceLanguageAndTargetLanguageAndProviderAndNormalizationVersion(
|
||||||
|
sourceHash,
|
||||||
|
source,
|
||||||
|
target,
|
||||||
|
response.providerId.code,
|
||||||
|
SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
|
)
|
||||||
|
if (memory == null) {
|
||||||
|
translationMemoryRepository.save(
|
||||||
|
TranslationMemory(
|
||||||
|
sourceHash,
|
||||||
|
text,
|
||||||
|
source,
|
||||||
|
target,
|
||||||
|
translated,
|
||||||
|
response.providerId.code,
|
||||||
|
response.providerVersion
|
||||||
|
)
|
||||||
|
)
|
||||||
|
} else if (
|
||||||
|
rejectUnchangedAwsResult && response.providerId == LanguageProviderId.AWS &&
|
||||||
|
SourceTextNormalizer.hasSameCommaSeparatedText(memory.sourceText, memory.translatedText)
|
||||||
|
) {
|
||||||
|
memory.translatedText = translated
|
||||||
|
translationMemoryRepository.save(memory)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (ex: DataIntegrityViolationException) {
|
||||||
|
val constraint = generateSequence<Throwable>(ex) { it.cause }
|
||||||
|
.filterIsInstance<ConstraintViolationException>().firstOrNull()?.constraintName
|
||||||
|
if (constraint?.contains("uk_translation_memory_source_target_provider", ignoreCase = true) != true) throw ex
|
||||||
|
val sql = generateSequence<Throwable>(ex) { it.cause }.filterIsInstance<SQLException>().firstOrNull()
|
||||||
|
if (sql?.sqlState != "23505" && sql?.errorCode != 1062) throw ex
|
||||||
|
val winner = transaction.execute {
|
||||||
|
translationCoordinator.findCached(sourceHash, source, target, rejectUnchangedAwsResult)
|
||||||
|
}
|
||||||
|
if (winner == null) throw ex
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
package kr.co.vividnext.sodalive.i18n.translation
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
interface TranslationProvider {
|
interface TranslationProvider {
|
||||||
val providerName: String
|
val providerId: LanguageProviderId
|
||||||
val providerVersion: String
|
val providerVersion: String
|
||||||
|
|
||||||
fun translate(request: TranslateRequest): TranslateResult
|
fun translate(request: TranslateRequest): TranslateResult
|
||||||
|
|||||||
+26
-31
@@ -15,10 +15,10 @@ import kr.co.vividnext.sodalive.content.series.translation.SeriesTranslationPayl
|
|||||||
import kr.co.vividnext.sodalive.content.series.translation.SeriesTranslationRepository
|
import kr.co.vividnext.sodalive.content.series.translation.SeriesTranslationRepository
|
||||||
import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslation
|
import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslation
|
||||||
import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslationRepository
|
import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslationRepository
|
||||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslation
|
import kr.co.vividnext.sodalive.creator.admin.content.series.Series
|
||||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslationPayload
|
|
||||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
|
||||||
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.ContentTranslationWriteService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentSourceFieldKey
|
||||||
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.CreatorCommunityTranslation
|
||||||
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.CreatorCommunityTranslationRepository
|
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.CreatorCommunityTranslationRepository
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
@@ -29,8 +29,7 @@ import javax.persistence.LockModeType
|
|||||||
@Service
|
@Service
|
||||||
class TranslationReadModelMaterializer(
|
class TranslationReadModelMaterializer(
|
||||||
private val sourceExtractor: TranslationSourceExtractor,
|
private val sourceExtractor: TranslationSourceExtractor,
|
||||||
private val translationMemoryRepository: TranslationMemoryRepository,
|
private val translationCoordinator: TranslationCoordinator,
|
||||||
private val contentTranslationRepository: ContentTranslationRepository,
|
|
||||||
private val aiCharacterTranslationRepository: AiCharacterTranslationRepository,
|
private val aiCharacterTranslationRepository: AiCharacterTranslationRepository,
|
||||||
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
||||||
private val seriesTranslationRepository: SeriesTranslationRepository,
|
private val seriesTranslationRepository: SeriesTranslationRepository,
|
||||||
@@ -39,15 +38,32 @@ class TranslationReadModelMaterializer(
|
|||||||
private val categoryTranslationRepository: CategoryTranslationRepository,
|
private val categoryTranslationRepository: CategoryTranslationRepository,
|
||||||
private val creatorCommunityRepository: CreatorCommunityRepository,
|
private val creatorCommunityRepository: CreatorCommunityRepository,
|
||||||
private val creatorCommunityTranslationRepository: CreatorCommunityTranslationRepository,
|
private val creatorCommunityTranslationRepository: CreatorCommunityTranslationRepository,
|
||||||
private val entityManager: EntityManager
|
private val entityManager: EntityManager,
|
||||||
|
private val contentWriter: ContentTranslationWriteService
|
||||||
) {
|
) {
|
||||||
|
@Transactional
|
||||||
|
fun hasCurrentContentApproval(job: TranslationJob): Boolean = contentWriter.hasCurrentApproval(
|
||||||
|
job.resourceId,
|
||||||
|
job.targetLanguage,
|
||||||
|
job.fieldKey
|
||||||
|
)
|
||||||
|
|
||||||
|
@Transactional
|
||||||
|
fun materializeContentFields(resourceId: Long, targetLanguage: String, fieldKeys: Set<String>): Boolean =
|
||||||
|
contentWriter.materialize(
|
||||||
|
resourceId,
|
||||||
|
targetLanguage,
|
||||||
|
fieldKeys.map { key -> ContentSourceFieldKey.values().single { it.key == key } }.toSet()
|
||||||
|
)
|
||||||
|
|
||||||
@Transactional
|
@Transactional
|
||||||
fun materialize(resourceType: LanguageTranslationTargetType, resourceId: Long, targetLanguage: String): Boolean {
|
fun materialize(resourceType: LanguageTranslationTargetType, resourceId: Long, targetLanguage: String): Boolean {
|
||||||
|
if (resourceType == LanguageTranslationTargetType.CONTENT) return contentWriter.materialize(resourceId, targetLanguage)
|
||||||
val source = sourceExtractor.extract(resourceType, resourceId) ?: return false
|
val source = sourceExtractor.extract(resourceType, resourceId) ?: return false
|
||||||
val translations = resolveTranslatedFields(source, targetLanguage.lowercase()) ?: return false
|
val translations = resolveTranslatedFields(source, targetLanguage.lowercase()) ?: return false
|
||||||
|
|
||||||
when (resourceType) {
|
when (resourceType) {
|
||||||
LanguageTranslationTargetType.CONTENT -> upsertContent(resourceId, targetLanguage, translations)
|
LanguageTranslationTargetType.CONTENT -> error("CONTENT uses the locked field writer")
|
||||||
LanguageTranslationTargetType.CHARACTER -> upsertCharacter(resourceId, targetLanguage, translations)
|
LanguageTranslationTargetType.CHARACTER -> upsertCharacter(resourceId, targetLanguage, translations)
|
||||||
LanguageTranslationTargetType.CONTENT_THEME -> upsertContentTheme(resourceId, targetLanguage, translations)
|
LanguageTranslationTargetType.CONTENT_THEME -> upsertContentTheme(resourceId, targetLanguage, translations)
|
||||||
LanguageTranslationTargetType.SERIES -> upsertSeries(resourceId, targetLanguage, translations)
|
LanguageTranslationTargetType.SERIES -> upsertSeries(resourceId, targetLanguage, translations)
|
||||||
@@ -71,13 +87,10 @@ class TranslationReadModelMaterializer(
|
|||||||
return@forEach
|
return@forEach
|
||||||
}
|
}
|
||||||
|
|
||||||
val memory = translationMemoryRepository
|
val memory = translationCoordinator.findCached(
|
||||||
.findBySourceHashAndSourceLanguageAndTargetLanguageAndProviderAndNormalizationVersion(
|
|
||||||
sourceHash = SourceTextNormalizer.hash(normalizedText),
|
sourceHash = SourceTextNormalizer.hash(normalizedText),
|
||||||
sourceLanguage = source.sourceLanguage.lowercase(),
|
sourceLanguage = source.sourceLanguage.lowercase(),
|
||||||
targetLanguage = targetLanguage,
|
targetLanguage = targetLanguage
|
||||||
provider = DEFAULT_PROVIDER,
|
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
|
||||||
) ?: return null
|
) ?: return null
|
||||||
|
|
||||||
result[field.fieldKey] = memory.translatedText
|
result[field.fieldKey] = memory.translatedText
|
||||||
@@ -85,21 +98,6 @@ class TranslationReadModelMaterializer(
|
|||||||
return result
|
return result
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun upsertContent(resourceId: Long, targetLanguage: String, translations: Map<String, String>) {
|
|
||||||
val payload = ContentTranslationPayload(
|
|
||||||
title = translations["title"].orEmpty(),
|
|
||||||
detail = translations["detail"].orEmpty(),
|
|
||||||
tags = translations["tags"].orEmpty()
|
|
||||||
)
|
|
||||||
val existing = contentTranslationRepository.findByContentIdAndLocale(resourceId, targetLanguage)
|
|
||||||
if (existing == null) {
|
|
||||||
contentTranslationRepository.save(ContentTranslation(resourceId, targetLanguage, payload))
|
|
||||||
} else {
|
|
||||||
existing.renderedPayload = payload
|
|
||||||
contentTranslationRepository.save(existing)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun upsertCharacter(resourceId: Long, targetLanguage: String, translations: Map<String, String>) {
|
private fun upsertCharacter(resourceId: Long, targetLanguage: String, translations: Map<String, String>) {
|
||||||
val payload = AiCharacterTranslationRenderedPayload(
|
val payload = AiCharacterTranslationRenderedPayload(
|
||||||
name = translations["name"].orEmpty(),
|
name = translations["name"].orEmpty(),
|
||||||
@@ -140,6 +138,7 @@ class TranslationReadModelMaterializer(
|
|||||||
.map { it.trim() }
|
.map { it.trim() }
|
||||||
.filter { it.isNotBlank() }
|
.filter { it.isNotBlank() }
|
||||||
)
|
)
|
||||||
|
entityManager.find(Series::class.java, resourceId, LockModeType.PESSIMISTIC_WRITE)
|
||||||
val existing = seriesTranslationRepository.findBySeriesIdAndLocale(resourceId, targetLanguage)
|
val existing = seriesTranslationRepository.findBySeriesIdAndLocale(resourceId, targetLanguage)
|
||||||
if (existing == null) {
|
if (existing == null) {
|
||||||
seriesTranslationRepository.save(SeriesTranslation(resourceId, targetLanguage, payload))
|
seriesTranslationRepository.save(SeriesTranslation(resourceId, targetLanguage, payload))
|
||||||
@@ -231,8 +230,4 @@ class TranslationReadModelMaterializer(
|
|||||||
}
|
}
|
||||||
return true
|
return true
|
||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
|
||||||
const val DEFAULT_PROVIDER = "papago"
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|||||||
+4
-9
@@ -8,6 +8,7 @@ import kr.co.vividnext.sodalive.content.AudioContentRepository
|
|||||||
import kr.co.vividnext.sodalive.content.category.CategoryRepository
|
import kr.co.vividnext.sodalive.content.category.CategoryRepository
|
||||||
import kr.co.vividnext.sodalive.content.theme.AudioContentThemeQueryRepository
|
import kr.co.vividnext.sodalive.content.theme.AudioContentThemeQueryRepository
|
||||||
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.toContentSourceSnapshot
|
||||||
import org.springframework.data.repository.findByIdOrNull
|
import org.springframework.data.repository.findByIdOrNull
|
||||||
import org.springframework.stereotype.Component
|
import org.springframework.stereotype.Component
|
||||||
|
|
||||||
@@ -50,19 +51,13 @@ class TranslationSourceExtractor(
|
|||||||
|
|
||||||
private fun extractContent(resourceId: Long): TranslationSource? {
|
private fun extractContent(resourceId: Long): TranslationSource? {
|
||||||
val content = audioContentRepository.findByIdOrNull(resourceId) ?: return null
|
val content = audioContentRepository.findByIdOrNull(resourceId) ?: return null
|
||||||
val sourceLanguage = content.languageCode?.takeIf { it.isNotBlank() } ?: return null
|
val snapshot = content.toContentSourceSnapshot()
|
||||||
val tags = content.audioContentHashTags
|
val sourceLanguage = snapshot.sourceLanguage?.takeIf { it.isNotBlank() } ?: return null
|
||||||
.mapNotNull { it.hashTag?.tag }
|
|
||||||
.joinToString(",")
|
|
||||||
return TranslationSource(
|
return TranslationSource(
|
||||||
resourceType = LanguageTranslationTargetType.CONTENT,
|
resourceType = LanguageTranslationTargetType.CONTENT,
|
||||||
resourceId = resourceId,
|
resourceId = resourceId,
|
||||||
sourceLanguage = sourceLanguage,
|
sourceLanguage = sourceLanguage,
|
||||||
fields = listOf(
|
fields = snapshot.fields
|
||||||
TranslationSourceField("title", content.title),
|
|
||||||
TranslationSourceField("detail", content.detail),
|
|
||||||
TranslationSourceField("tags", tags)
|
|
||||||
)
|
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
+2
-1
@@ -19,6 +19,7 @@ import kr.co.vividnext.sodalive.v2.api.admin.aicharacter.error.AiCharacterAdminA
|
|||||||
import org.springframework.data.domain.PageRequest
|
import org.springframework.data.domain.PageRequest
|
||||||
import org.springframework.http.HttpStatus
|
import org.springframework.http.HttpStatus
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
|
import org.springframework.transaction.annotation.Propagation
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
import org.springframework.web.multipart.MultipartFile
|
import org.springframework.web.multipart.MultipartFile
|
||||||
import java.time.DateTimeException
|
import java.time.DateTimeException
|
||||||
@@ -158,7 +159,7 @@ class AiCharacterAdminAudioContentFacade(
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
@Transactional
|
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||||
fun create(
|
fun create(
|
||||||
characterId: Long,
|
characterId: Long,
|
||||||
coverImage: MultipartFile,
|
coverImage: MultipartFile,
|
||||||
|
|||||||
+90
@@ -0,0 +1,90 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.contenttranslation.adapter.`in`.web
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.common.ApiResponse
|
||||||
|
import kr.co.vividnext.sodalive.member.Member
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionApplyService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionCandidateQueryService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionContentsService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionGenerationService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionGroupingService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.application.TranslationSelectionRequestService
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.TranslationSelectionError
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.dto.ApplyTranslationSelectionRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.dto.CreateTranslationSelectionRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.dto.GenerateTranslationSelectionRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.dto.ReviewTranslationSelectionGroupingRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.dto.response
|
||||||
|
import org.springframework.security.access.prepost.PreAuthorize
|
||||||
|
import org.springframework.security.core.annotation.AuthenticationPrincipal
|
||||||
|
import org.springframework.web.bind.annotation.GetMapping
|
||||||
|
import org.springframework.web.bind.annotation.PathVariable
|
||||||
|
import org.springframework.web.bind.annotation.PostMapping
|
||||||
|
import org.springframework.web.bind.annotation.PutMapping
|
||||||
|
import org.springframework.web.bind.annotation.RequestBody
|
||||||
|
import org.springframework.web.bind.annotation.RequestMapping
|
||||||
|
import org.springframework.web.bind.annotation.RequestParam
|
||||||
|
import org.springframework.web.bind.annotation.RestController
|
||||||
|
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/admin/audio-content/translation-requests")
|
||||||
|
@PreAuthorize("hasRole('ADMIN')")
|
||||||
|
class AdminTranslationSelectionController(
|
||||||
|
private val requests: TranslationSelectionRequestService,
|
||||||
|
private val grouping: TranslationSelectionGroupingService,
|
||||||
|
private val contents: TranslationSelectionContentsService,
|
||||||
|
private val generation: TranslationSelectionGenerationService,
|
||||||
|
private val candidates: TranslationSelectionCandidateQueryService,
|
||||||
|
private val applyService: TranslationSelectionApplyService
|
||||||
|
) {
|
||||||
|
@PostMapping
|
||||||
|
fun create(
|
||||||
|
@AuthenticationPrincipal(expression = "#this == 'anonymousUser' ? null : member") member: Member?,
|
||||||
|
@RequestBody body: CreateTranslationSelectionRequest
|
||||||
|
) = ApiResponse.ok(
|
||||||
|
requests.create(
|
||||||
|
member?.id ?: throw TranslationSelectionError.INVALID_REQUEST.exception(),
|
||||||
|
body.clientRequestId,
|
||||||
|
body.scope
|
||||||
|
).response()
|
||||||
|
)
|
||||||
|
|
||||||
|
@GetMapping("/{requestId}")
|
||||||
|
fun summary(@PathVariable requestId: Long) = ApiResponse.ok(requests.get(requestId).response())
|
||||||
|
|
||||||
|
@GetMapping("/{requestId}/contents")
|
||||||
|
fun contents(
|
||||||
|
@PathVariable requestId: Long,
|
||||||
|
@RequestParam(required = false) afterContentId: Long?,
|
||||||
|
@RequestParam(defaultValue = "50") size: Int
|
||||||
|
) = ApiResponse.ok(contents.contents(requestId, afterContentId, size))
|
||||||
|
|
||||||
|
@GetMapping("/{requestId}/grouping")
|
||||||
|
fun grouping(@PathVariable requestId: Long) = ApiResponse.ok(grouping.get(requestId))
|
||||||
|
|
||||||
|
@PutMapping("/{requestId}/grouping")
|
||||||
|
fun review(@PathVariable requestId: Long, @RequestBody body: ReviewTranslationSelectionGroupingRequest) =
|
||||||
|
ApiResponse.ok(grouping.review(requestId, body))
|
||||||
|
|
||||||
|
@PostMapping("/{requestId}/cancel")
|
||||||
|
fun cancel(@PathVariable requestId: Long) = ApiResponse.ok(requests.cancel(requestId).response())
|
||||||
|
|
||||||
|
@PostMapping("/{requestId}/generate")
|
||||||
|
fun generate(@PathVariable requestId: Long, @RequestBody body: GenerateTranslationSelectionRequest) =
|
||||||
|
ApiResponse.ok(generation.generate(requestId, body.expectedRevision).response())
|
||||||
|
|
||||||
|
@GetMapping("/{requestId}/candidates")
|
||||||
|
fun candidates(
|
||||||
|
@PathVariable requestId: Long,
|
||||||
|
@RequestParam(required = false) afterCandidateId: Long?,
|
||||||
|
@RequestParam(defaultValue = "50") size: Int
|
||||||
|
) = ApiResponse.ok(candidates.page(requestId, afterCandidateId, size))
|
||||||
|
|
||||||
|
@PostMapping("/{requestId}/apply")
|
||||||
|
fun apply(
|
||||||
|
@PathVariable requestId: Long,
|
||||||
|
@AuthenticationPrincipal(expression = "#this == 'anonymousUser' ? null : member") member: Member?,
|
||||||
|
@RequestBody body: ApplyTranslationSelectionRequest
|
||||||
|
) = ApiResponse.ok(
|
||||||
|
applyService.apply(requestId, member?.id ?: throw TranslationSelectionError.INVALID_REQUEST.exception(), body)
|
||||||
|
)
|
||||||
|
}
|
||||||
+17
@@ -0,0 +1,17 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.contenttranslation.adapter.`in`.web
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.common.SodaExceptionHandler
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.TranslationSelectionError
|
||||||
|
import org.springframework.core.Ordered
|
||||||
|
import org.springframework.core.annotation.Order
|
||||||
|
import org.springframework.http.converter.HttpMessageNotReadableException
|
||||||
|
import org.springframework.web.bind.annotation.ExceptionHandler
|
||||||
|
import org.springframework.web.bind.annotation.RestControllerAdvice
|
||||||
|
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException
|
||||||
|
|
||||||
|
@RestControllerAdvice(assignableTypes = [AdminTranslationSelectionController::class])
|
||||||
|
@Order(Ordered.HIGHEST_PRECEDENCE)
|
||||||
|
class TranslationSelectionInputExceptionHandler(private val handler: SodaExceptionHandler) {
|
||||||
|
@ExceptionHandler(HttpMessageNotReadableException::class, MethodArgumentTypeMismatchException::class)
|
||||||
|
fun invalidInput() = handler.handleSodaException(TranslationSelectionError.INVALID_REQUEST.exception())
|
||||||
|
}
|
||||||
+63
@@ -0,0 +1,63 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.contenttranslation.adapter.out.persistence
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.module.kotlin.jacksonObjectMapper
|
||||||
|
import com.fasterxml.jackson.module.kotlin.readValue
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ApprovalProvenance
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentSourceFieldKey
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import javax.persistence.AttributeConverter
|
||||||
|
import javax.persistence.Column
|
||||||
|
import javax.persistence.Convert
|
||||||
|
import javax.persistence.Converter
|
||||||
|
import javax.persistence.Entity
|
||||||
|
import javax.persistence.EnumType
|
||||||
|
import javax.persistence.Enumerated
|
||||||
|
import javax.persistence.GeneratedValue
|
||||||
|
import javax.persistence.GenerationType
|
||||||
|
import javax.persistence.Id
|
||||||
|
import javax.persistence.Table
|
||||||
|
import javax.persistence.UniqueConstraint
|
||||||
|
|
||||||
|
@Entity
|
||||||
|
@Table(
|
||||||
|
name = "content_translation_override",
|
||||||
|
uniqueConstraints = [
|
||||||
|
UniqueConstraint(name = "uk_content_translation_override_field", columnNames = ["content_id", "locale", "field_key"])
|
||||||
|
]
|
||||||
|
)
|
||||||
|
class ContentTranslationOverrideEntity(
|
||||||
|
@Column(name = "content_id", nullable = false)
|
||||||
|
val contentId: Long,
|
||||||
|
@Column(nullable = false, length = 10)
|
||||||
|
val locale: String,
|
||||||
|
@Enumerated(EnumType.STRING)
|
||||||
|
@Column(name = "field_key", nullable = false, length = 10)
|
||||||
|
val fieldKey: ContentSourceFieldKey,
|
||||||
|
@Column(nullable = false, length = 67)
|
||||||
|
var sourceFingerprint: String,
|
||||||
|
@Column(nullable = false, columnDefinition = "text")
|
||||||
|
var approvedText: String,
|
||||||
|
@Convert(converter = ApprovalProvenanceConverter::class)
|
||||||
|
@Column(nullable = false, columnDefinition = "text")
|
||||||
|
var provenance: ApprovalProvenance,
|
||||||
|
@Column(nullable = false, columnDefinition = "timestamp")
|
||||||
|
var approvedAt: LocalDateTime,
|
||||||
|
@Column(nullable = false, columnDefinition = "timestamp")
|
||||||
|
val createdAt: LocalDateTime = approvedAt,
|
||||||
|
@Column(nullable = false, columnDefinition = "timestamp")
|
||||||
|
var updatedAt: LocalDateTime = approvedAt
|
||||||
|
) {
|
||||||
|
@Id
|
||||||
|
@GeneratedValue(strategy = GenerationType.IDENTITY)
|
||||||
|
var id: Long? = null
|
||||||
|
}
|
||||||
|
|
||||||
|
@Converter
|
||||||
|
class ApprovalProvenanceConverter : AttributeConverter<ApprovalProvenance, String> {
|
||||||
|
override fun convertToDatabaseColumn(attribute: ApprovalProvenance): String = mapper.writeValueAsString(attribute)
|
||||||
|
override fun convertToEntityAttribute(dbData: String): ApprovalProvenance = mapper.readValue(dbData)
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
private val mapper = jacksonObjectMapper()
|
||||||
|
}
|
||||||
|
}
|
||||||
+10
@@ -0,0 +1,10 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.contenttranslation.adapter.out.persistence
|
||||||
|
|
||||||
|
import org.springframework.data.jpa.repository.JpaRepository
|
||||||
|
import org.springframework.data.jpa.repository.Lock
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
|
interface ContentTranslationOverrideRepository : JpaRepository<ContentTranslationOverrideEntity, Long> {
|
||||||
|
@Lock(LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
fun findByContentId(contentId: Long): List<ContentTranslationOverrideEntity>
|
||||||
|
}
|
||||||
+56
@@ -0,0 +1,56 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.contenttranslation.adapter.out.persistence
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentFieldApproval
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentSourceFieldKey
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ContentTranslationOverride
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.port.ContentTranslationOverrideStore
|
||||||
|
import org.springframework.stereotype.Component
|
||||||
|
import javax.persistence.EntityManager
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
|
@Component
|
||||||
|
class JpaContentTranslationOverrideStore(
|
||||||
|
private val repository: ContentTranslationOverrideRepository,
|
||||||
|
private val entityManager: EntityManager
|
||||||
|
) : ContentTranslationOverrideStore {
|
||||||
|
override fun findByContentId(contentId: Long): List<ContentTranslationOverride> = rows(contentId).map {
|
||||||
|
ContentTranslationOverride(
|
||||||
|
it.contentId,
|
||||||
|
it.locale,
|
||||||
|
ContentFieldApproval(it.fieldKey, it.sourceFingerprint, it.approvedText, it.provenance),
|
||||||
|
it.approvedAt
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun save(override: ContentTranslationOverride) {
|
||||||
|
val approval = override.approval
|
||||||
|
val existing = rows(override.contentId).singleOrNull { it.locale == override.locale && it.fieldKey == approval.field }
|
||||||
|
if (existing == null) {
|
||||||
|
repository.save(
|
||||||
|
ContentTranslationOverrideEntity(
|
||||||
|
override.contentId,
|
||||||
|
override.locale,
|
||||||
|
approval.field,
|
||||||
|
approval.sourceFingerprint,
|
||||||
|
approval.translatedText,
|
||||||
|
approval.provenance,
|
||||||
|
override.approvedAt
|
||||||
|
)
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
existing.sourceFingerprint = approval.sourceFingerprint
|
||||||
|
existing.approvedText = approval.translatedText
|
||||||
|
existing.provenance = approval.provenance
|
||||||
|
existing.approvedAt = override.approvedAt
|
||||||
|
existing.updatedAt = override.approvedAt
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun deleteFields(contentId: Long, fields: Set<ContentSourceFieldKey>, locale: String?) {
|
||||||
|
rows(contentId).filter { it.fieldKey in fields && (locale == null || it.locale == locale) }.forEach(repository::delete)
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun rows(contentId: Long): List<ContentTranslationOverrideEntity> = repository.findByContentId(contentId).onEach {
|
||||||
|
entityManager.refresh(it, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
}
|
||||||
|
}
|
||||||
+137
@@ -0,0 +1,137 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.contenttranslation.adapter.out.persistence
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.ApprovalProvider
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.SelectionCandidateProgress
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.TranslationCandidate
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.TranslationCandidateStatus
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.TranslationSelectionStatus
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.port.TranslationCandidateStore
|
||||||
|
import org.springframework.stereotype.Component
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import javax.persistence.EntityManager
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
|
@Component
|
||||||
|
class JpaTranslationCandidateStore(private val entityManager: EntityManager) : TranslationCandidateStore {
|
||||||
|
override fun save(candidate: TranslationCandidate): TranslationCandidate {
|
||||||
|
val row = if (candidate.candidateId == 0L) {
|
||||||
|
TranslationCandidateEntity(
|
||||||
|
entityManager.getReference(TranslationSelectionRequestEntity::class.java, candidate.requestId),
|
||||||
|
candidate.unit.key, candidate.unit, candidate.provider.id, candidate.provider.version, candidate.targetLanguage,
|
||||||
|
candidate.status, candidate.translatedValues, candidate.failureCode, candidate.attempt, candidate.leaseUntil,
|
||||||
|
candidate.fence, candidate.createdAt, candidate.updatedAt, candidate.terminalAt, candidate.linkedCandidateId
|
||||||
|
).also { entityManager.persist(it) }
|
||||||
|
} else {
|
||||||
|
entityManager.getReference(TranslationCandidateEntity::class.java, candidate.candidateId).apply {
|
||||||
|
status = candidate.status
|
||||||
|
translatedValues = candidate.translatedValues
|
||||||
|
failureCode = candidate.failureCode
|
||||||
|
attempt = candidate.attempt
|
||||||
|
leaseUntil = candidate.leaseUntil
|
||||||
|
fence = candidate.fence
|
||||||
|
updatedAt = candidate.updatedAt
|
||||||
|
terminalAt = candidate.terminalAt
|
||||||
|
}
|
||||||
|
}
|
||||||
|
entityManager.flush()
|
||||||
|
return row.domain()
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun nextRequest(now: LocalDateTime): Long? = entityManager.createQuery(
|
||||||
|
"select c.request.id from TranslationCandidateEntity c where c.request.status = :generating and " +
|
||||||
|
"c.linkedCandidateId is null and (c.status = :pending or (c.status = :running and c.leaseUntil <= :now)) " +
|
||||||
|
"order by c.id",
|
||||||
|
java.lang.Long::class.java
|
||||||
|
).setParameter("generating", TranslationSelectionStatus.GENERATING)
|
||||||
|
.setParameter("pending", TranslationCandidateStatus.PENDING).setParameter("running", TranslationCandidateStatus.RUNNING)
|
||||||
|
.setParameter("now", now)
|
||||||
|
.setMaxResults(1).resultList.firstOrNull()?.toLong()
|
||||||
|
|
||||||
|
override fun lockNext(requestId: Long, now: LocalDateTime): TranslationCandidate? = entityManager.createQuery(
|
||||||
|
"select c from TranslationCandidateEntity c where c.request.id = :requestId and " +
|
||||||
|
"c.linkedCandidateId is null and (c.status = :pending or (c.status = :running and c.leaseUntil <= :now)) " +
|
||||||
|
"order by c.id",
|
||||||
|
TranslationCandidateEntity::class.java
|
||||||
|
).setParameter("requestId", requestId).setParameter("pending", TranslationCandidateStatus.PENDING)
|
||||||
|
.setParameter("running", TranslationCandidateStatus.RUNNING).setParameter("now", now)
|
||||||
|
.setLockMode(LockModeType.PESSIMISTIC_WRITE).setMaxResults(1).resultList.firstOrNull()
|
||||||
|
?.let { lock(requireNotNull(it.id)) }
|
||||||
|
|
||||||
|
override fun find(candidateId: Long): TranslationCandidate? =
|
||||||
|
entityManager.find(TranslationCandidateEntity::class.java, candidateId)?.domain()
|
||||||
|
|
||||||
|
override fun lock(candidateId: Long): TranslationCandidate? {
|
||||||
|
val row = entityManager.find(TranslationCandidateEntity::class.java, candidateId, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
?: return null
|
||||||
|
entityManager.refresh(row, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
return row.domain()
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun page(requestId: Long, afterId: Long, limit: Int): List<TranslationCandidate> = entityManager.createQuery(
|
||||||
|
"select c from TranslationCandidateEntity c where c.request.id = :requestId and c.id > :afterId order by c.id",
|
||||||
|
TranslationCandidateEntity::class.java
|
||||||
|
).setParameter("requestId", requestId).setParameter("afterId", afterId).setMaxResults(limit).resultList.map { it.domain() }
|
||||||
|
|
||||||
|
override fun progress(requestId: Long): SelectionCandidateProgress {
|
||||||
|
val counts = entityManager.createQuery(
|
||||||
|
"select new kr.co.vividnext.sodalive.v2.contenttranslation.adapter.out.persistence.TranslationCandidateCount" +
|
||||||
|
"(c.status, count(c)) from TranslationCandidateEntity c where c.request.id = :requestId group by c.status",
|
||||||
|
TranslationCandidateCount::class.java
|
||||||
|
).setParameter("requestId", requestId).resultList.associate { it.status to it.count.toInt() }
|
||||||
|
val succeeded = counts[TranslationCandidateStatus.SUCCEEDED] ?: 0
|
||||||
|
val failed = counts[TranslationCandidateStatus.FAILED] ?: 0
|
||||||
|
return SelectionCandidateProgress(
|
||||||
|
counts.values.sum(),
|
||||||
|
succeeded + failed + (counts[TranslationCandidateStatus.DISCARDED] ?: 0),
|
||||||
|
succeeded,
|
||||||
|
failed
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun discard(requestId: Long, now: LocalDateTime) {
|
||||||
|
discardUnselected(requestId, emptySet(), now)
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun discardUnselected(requestId: Long, selectedIds: Set<Long>, now: LocalDateTime): Int {
|
||||||
|
val rows = entityManager.createQuery(
|
||||||
|
"select c from TranslationCandidateEntity c where c.request.id = :requestId order by c.id",
|
||||||
|
TranslationCandidateEntity::class.java
|
||||||
|
).setParameter("requestId", requestId).setLockMode(LockModeType.PESSIMISTIC_WRITE).resultList
|
||||||
|
val discarded = rows.filter { it.id !in selectedIds }
|
||||||
|
discarded.forEach {
|
||||||
|
it.status = TranslationCandidateStatus.DISCARDED
|
||||||
|
it.translatedValues = null
|
||||||
|
it.failureCode = null
|
||||||
|
it.leaseUntil = null
|
||||||
|
it.fence++
|
||||||
|
it.updatedAt = now
|
||||||
|
it.terminalAt = now
|
||||||
|
}
|
||||||
|
entityManager.flush()
|
||||||
|
return discarded.size
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun completeLinked(source: TranslationCandidate) {
|
||||||
|
val rows = entityManager.createQuery(
|
||||||
|
"select c from TranslationCandidateEntity c where c.request.id = :requestId " +
|
||||||
|
"and c.linkedCandidateId = :sourceId order by c.id",
|
||||||
|
TranslationCandidateEntity::class.java
|
||||||
|
).setParameter("requestId", source.requestId).setParameter("sourceId", source.candidateId)
|
||||||
|
.setLockMode(LockModeType.PESSIMISTIC_WRITE).resultList
|
||||||
|
rows.forEach {
|
||||||
|
it.status = source.status
|
||||||
|
it.translatedValues = source.translatedValues
|
||||||
|
it.failureCode = source.failureCode
|
||||||
|
it.updatedAt = source.updatedAt
|
||||||
|
it.terminalAt = source.terminalAt
|
||||||
|
}
|
||||||
|
entityManager.flush()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun TranslationCandidateEntity.domain() = TranslationCandidate(
|
||||||
|
requireNotNull(id), requireNotNull(request.id), unit, ApprovalProvider(providerId, providerVersion), targetLanguage,
|
||||||
|
status, translatedValues, failureCode, attempt, leaseUntil, fence, createdAt, updatedAt, terminalAt, linkedCandidateId
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
data class TranslationCandidateCount(val status: TranslationCandidateStatus, val count: Long)
|
||||||
+73
@@ -0,0 +1,73 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.contenttranslation.adapter.out.persistence
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.TranslationSelectionRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.domain.TranslationSelectionStatus
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.port.TranslationCandidateStore
|
||||||
|
import kr.co.vividnext.sodalive.v2.contenttranslation.port.TranslationSelectionStore
|
||||||
|
import org.springframework.stereotype.Component
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import java.time.ZoneOffset
|
||||||
|
import java.util.UUID
|
||||||
|
import javax.persistence.EntityManager
|
||||||
|
import javax.persistence.LockModeType
|
||||||
|
|
||||||
|
@Component
|
||||||
|
class JpaTranslationSelectionStore(
|
||||||
|
private val repository: TranslationSelectionRequestRepository,
|
||||||
|
private val entityManager: EntityManager,
|
||||||
|
private val candidates: TranslationCandidateStore
|
||||||
|
) : TranslationSelectionStore {
|
||||||
|
override fun find(requestId: Long): TranslationSelectionRequest? = repository.findById(requestId).orElse(null)?.domain()
|
||||||
|
|
||||||
|
override fun findCreation(adminId: Long, clientRequestId: UUID): TranslationSelectionRequest? =
|
||||||
|
repository.findByCreatedByAndClientRequestId(adminId, clientRequestId.toString())?.domain()
|
||||||
|
|
||||||
|
override fun lock(requestId: Long): TranslationSelectionRequest? {
|
||||||
|
val row = entityManager.find(TranslationSelectionRequestEntity::class.java, requestId, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
?: return null
|
||||||
|
entityManager.refresh(row, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
return row.domain()
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun nextPreparation(now: LocalDateTime): TranslationSelectionRequest? = entityManager.createQuery(
|
||||||
|
"select r from TranslationSelectionRequestEntity r where r.status = :status " +
|
||||||
|
"and (r.preparationLeaseUntil is null or r.preparationLeaseUntil <= :now) order by r.id",
|
||||||
|
TranslationSelectionRequestEntity::class.java
|
||||||
|
).setParameter("status", TranslationSelectionStatus.PREPARING).setParameter("now", now)
|
||||||
|
.setLockMode(LockModeType.PESSIMISTIC_WRITE).setMaxResults(1).resultList.firstOrNull()
|
||||||
|
?.let { lock(requireNotNull(it.id)) }
|
||||||
|
|
||||||
|
override fun save(request: TranslationSelectionRequest): TranslationSelectionRequest {
|
||||||
|
val row = if (request.requestId == 0L) {
|
||||||
|
TranslationSelectionRequestEntity(
|
||||||
|
request.createdBy, request.clientRequestId.toString(), request.bodyHash, request.scope,
|
||||||
|
request.status, request.revision, request.snapshot, request.preparationAttempt,
|
||||||
|
request.preparationLeaseUntil, request.preparationFence, request.errorCode, request.createdAt, request.updatedAt
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
entityManager.getReference(TranslationSelectionRequestEntity::class.java, request.requestId).apply {
|
||||||
|
status = request.status
|
||||||
|
revision = request.revision
|
||||||
|
snapshot = request.snapshot
|
||||||
|
preparationAttempt = request.preparationAttempt
|
||||||
|
preparationLeaseUntil = request.preparationLeaseUntil
|
||||||
|
preparationFence = request.preparationFence
|
||||||
|
errorCode = request.errorCode
|
||||||
|
updatedAt = request.updatedAt
|
||||||
|
}
|
||||||
|
}
|
||||||
|
row.acceptedGenerateRevision = request.acceptedGenerateRevision
|
||||||
|
row.applyOperationId = request.applyOperationId?.toString()
|
||||||
|
row.applyBodyHash = request.applyBodyHash
|
||||||
|
row.applyReceipt = request.applyReceipt
|
||||||
|
row.appliedAt = request.applyReceipt?.appliedAt?.atOffset(ZoneOffset.UTC)?.toLocalDateTime()
|
||||||
|
return repository.saveAndFlush(row).domain()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun TranslationSelectionRequestEntity.domain() = TranslationSelectionRequest(
|
||||||
|
requireNotNull(id), createdBy, UUID.fromString(clientRequestId), bodyHash, scope, status, revision, snapshot,
|
||||||
|
preparationAttempt, preparationLeaseUntil, preparationFence, errorCode, createdAt, updatedAt,
|
||||||
|
acceptedGenerateRevision, candidates.progress(requireNotNull(id)), applyOperationId?.let(UUID::fromString),
|
||||||
|
applyBodyHash, applyReceipt
|
||||||
|
)
|
||||||
|
}
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user