Compare commits
516
Commits
64b52db208
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
1ab4086740 | ||
|
|
d436fd6bff | ||
|
|
536a5a6fe5 | ||
|
|
9cadaa919b | ||
|
|
0796b2b4fb | ||
|
|
85d6a14c40 | ||
|
|
ff30ebacc5 | ||
|
|
2da499f716 | ||
|
|
ecace9ba67 | ||
|
|
f7f6ab6864 | ||
|
|
55669c4465 | ||
|
|
cd4667813a | ||
|
|
d62980bff7 | ||
|
|
ba7bc81ac7 | ||
|
|
081f22b2c0 | ||
|
|
d1c9f3a3d8 | ||
|
|
3ed79f2acb | ||
|
|
ed37990e2b | ||
|
|
309f794168 | ||
|
|
eec5a80284 | ||
|
|
5eee580aaf | ||
|
|
c3e5f19cb3 | ||
|
|
cf31c5702c | ||
|
|
4c1d876d5e | ||
|
|
9c1c544e45 | ||
|
|
e097e27ac6 | ||
|
|
cc85322eb5 | ||
|
|
b6edd442a4 | ||
|
|
fe620aa9c0 | ||
|
|
9d29355bf2 | ||
|
|
992844df66 | ||
|
|
7cac09e39c | ||
|
|
a8e4cbac28 | ||
|
|
2bd2328548 | ||
|
|
ec890047a5 | ||
|
|
6093b37747 | ||
|
|
9136b0e3bb | ||
|
|
eae0c41cea | ||
|
|
f3a558f659 | ||
|
|
f7fadf7ac7 | ||
|
|
320adb037c | ||
|
|
55b6aa35e2 | ||
|
|
b3c9b9bb2e | ||
|
|
93f2631267 | ||
|
|
1578503072 | ||
|
|
8ea767e592 | ||
|
|
3b35ab17e7 | ||
|
|
790ce48531 | ||
|
|
8a94c1f20e | ||
|
|
882ac30046 | ||
|
|
8788d87fa2 | ||
|
|
ff7987b8a1 | ||
|
|
d2aa0937c3 | ||
|
|
234de8c7c8 | ||
|
|
5ad2e0cc34 | ||
|
|
7982a11288 | ||
|
|
037b3440d8 | ||
|
|
9aa8547ee3 | ||
|
|
7e32593af5 | ||
|
|
b9dad40c43 | ||
|
|
3e979cd8c4 | ||
|
|
1bef5c2bcd | ||
|
|
a59b840674 | ||
|
|
2a741fe891 | ||
|
|
0abbd3ea72 | ||
|
|
41314ef797 | ||
|
|
200dc6264a | ||
|
|
6f48aa156a | ||
|
|
c1000a6c68 | ||
|
|
b978f5bc8d | ||
|
|
3f660e81f9 | ||
|
|
c9b0bd13b5 | ||
|
|
92402419c5 | ||
|
|
c4fa2fa2f8 | ||
|
|
b4027fdee7 | ||
|
|
eb262b8d53 | ||
|
|
f5397df65e | ||
|
|
0c6aeb5c8a | ||
|
|
d8083e34ea | ||
|
|
8eeade49d1 | ||
|
|
b36764abff | ||
|
|
7844ea74d7 | ||
|
|
e04fa67d1d | ||
|
|
bd1ec54d36 | ||
|
|
4442fa6d91 | ||
|
|
795c25159f | ||
|
|
cdc7cb8612 | ||
|
|
efefef51f4 | ||
|
|
e2b9eb8bf3 | ||
|
|
1aa7a89f7b | ||
|
|
45aa26f1cb | ||
|
|
626f02b45e | ||
|
|
540c5cb317 | ||
|
|
3aa6a35adb | ||
|
|
81c0d2586c | ||
|
|
965bb068fc | ||
|
|
d082e0b745 | ||
|
|
c8b83272a3 | ||
|
|
1939fdcb33 | ||
|
|
f521a240c2 | ||
|
|
0c35624dfb | ||
|
|
5c24addf31 | ||
|
|
8671c8efc7 | ||
|
|
16c17f4bfa | ||
|
|
0e821fae1b | ||
|
|
6a10eff15f | ||
|
|
fea329e637 | ||
|
|
681e4a4036 | ||
|
|
c23f574162 | ||
|
|
c884d7d6c9 | ||
|
|
116e8cbca3 | ||
|
|
c8187ba147 | ||
|
|
676bd0b79e | ||
|
|
7522f06bf3 | ||
|
|
a9d2d1ab48 | ||
|
|
e0e371cdc9 | ||
|
|
b49344d0e9 | ||
|
|
5cc152307a | ||
|
|
1fd3d41d7e | ||
|
|
c1b9dd730d | ||
|
|
d40cd32c50 | ||
|
|
0289607fd9 | ||
|
|
1bec644372 | ||
|
|
f8a6d1b221 | ||
|
|
ec769a1307 | ||
|
|
8e4fb0d313 | ||
|
|
cc3a620642 | ||
|
|
be0884e974 | ||
|
|
34456395fd | ||
|
|
26ddeb9591 | ||
|
|
cd535a628c | ||
|
|
de32b537f4 | ||
|
|
9c271fc1f6 | ||
|
|
2ddbfbccd6 | ||
|
|
80786deb72 | ||
|
|
8ca2e185ac | ||
|
|
484711ad1b | ||
|
|
e80ceca0c5 | ||
|
|
33293a6533 | ||
|
|
f0c1d4e32a | ||
|
|
6cd319ec76 | ||
|
|
6557ec2aed | ||
|
|
f2f8a34319 | ||
|
|
c50ac6ed2c | ||
|
|
11b9c349d1 | ||
|
|
ef9f8d65e1 | ||
|
|
299f2100e9 | ||
|
|
fd5c794480 | ||
|
|
68197de095 | ||
|
|
587f3d6b58 | ||
|
|
9b6167d46d | ||
|
|
008ee3b4e5 | ||
|
|
3a57ad23bb | ||
|
|
729552335a | ||
|
|
02ae507c87 | ||
|
|
5818abf69d | ||
|
|
ee403915f0 | ||
|
|
1a660088de | ||
|
|
5196c80ca8 | ||
|
|
c9c09c2998 | ||
|
|
3ea33c4c7b | ||
|
|
451a1aa4f2 | ||
|
|
90555fd34f | ||
|
|
0dc430b098 | ||
|
|
1f2103c7fa | ||
|
|
062c17c51e | ||
|
|
de169b79a1 | ||
|
|
aa24de0a5a | ||
|
|
e5937d573a | ||
|
|
6da86e12bd | ||
|
|
9049022a74 | ||
|
|
7b6f3a7a5f | ||
|
|
53e9678efa | ||
|
|
e4f547fa92 | ||
|
|
b69756ef81 | ||
|
|
1a3a9149a2 | ||
|
|
ce120a6d5d | ||
|
|
08b5fd23ab | ||
|
|
eb18e2d009 | ||
|
|
a27852ed44 | ||
|
|
c7925c1706 | ||
|
|
be59bd7e89 | ||
|
|
51ce143fc2 | ||
|
|
89eb11f808 | ||
|
|
30d89987a4 | ||
|
|
7959d3e5ed | ||
|
|
1e29573ef7 | ||
|
|
cc2f533dc6 | ||
|
|
32b0c19f9d | ||
|
|
9af2d768e8 | ||
|
|
5677824cde | ||
|
|
e8f1bc09f9 | ||
|
|
d1a936d55b | ||
|
|
dc97eaa835 | ||
|
|
dcbe57806c | ||
|
|
b14438cc15 | ||
|
|
b27d3bd5c6 | ||
|
|
03ebc9cfe9 | ||
|
|
24841b9850 | ||
|
|
d35a3d1a8c | ||
|
|
60c4e0b528 | ||
|
|
84f33d1bc2 | ||
|
|
c4e1709b99 | ||
|
|
e7a5fd5819 | ||
|
|
4bde03643c | ||
|
|
1bc52b56af | ||
|
|
9c33fd93f7 | ||
|
|
3c087bc275 | ||
|
|
8ad13c289e | ||
|
|
7577f48a09 | ||
|
|
0251906964 | ||
|
|
2723a5f134 | ||
|
|
c3c60605fd | ||
|
|
238f704b22 | ||
|
|
5639d8ac8e | ||
|
|
9aac591591 | ||
|
|
ffa8e5aebb | ||
|
|
cbbfe014cc | ||
|
|
83028f7817 | ||
|
|
70d1795557 | ||
|
|
8c6c681424 | ||
|
|
50bc9f4ff3 | ||
|
|
f00ea03fad | ||
|
|
f22e7b9ad1 | ||
|
|
c7ec95f4bb | ||
|
|
229e7a8ccc | ||
|
|
3c616474ff | ||
|
|
56eb6b3ce3 | ||
|
|
545836d43c | ||
|
|
219f83dec0 | ||
|
|
a76a841238 | ||
|
|
c26680de84 | ||
|
|
8fffad9d3a | ||
|
|
f4f0f203a2 | ||
|
|
b7196f5a0c | ||
|
|
5d33a18890 | ||
|
|
96186a1a50 | ||
|
|
bc8bc479d1 | ||
|
|
47595b1291 | ||
|
|
01a88964df | ||
|
|
3a2b77379f | ||
|
|
dc4e5f75cd | ||
|
|
d0178d551c | ||
|
|
827333108d | ||
|
|
587b90bd27 | ||
|
|
4dc20c5e90 | ||
|
|
ac25782f2b | ||
|
|
20437d56e7 | ||
|
|
f0b412828a | ||
|
|
367faac5c3 | ||
|
|
84deaaa970 | ||
|
|
a2b39466c2 | ||
|
|
03586c4005 | ||
|
|
6ea69e1510 | ||
|
|
553c6dc539 | ||
|
|
6cc22f5b6d | ||
|
|
9103d67cc1 | ||
|
|
25083fb0e4 | ||
|
|
d2dc045255 | ||
|
|
b8621dfbb0 | ||
|
|
93633940dd | ||
|
|
b6f5325351 | ||
|
|
7c32c08f1f | ||
|
|
1d268da08d | ||
|
|
797666ae0d | ||
|
|
dcf470997e | ||
|
|
0974d1dbf8 | ||
|
|
12a35db6cd | ||
|
|
9abbb05ad8 | ||
|
|
1ecaf69b0b | ||
|
|
e334d1e5d9 | ||
|
|
b735e861d0 | ||
|
|
4eb433d372 | ||
|
|
2416ae61f3 | ||
|
|
01fb336985 | ||
|
|
b6af88a732 | ||
|
|
58a2a17d6d | ||
|
|
79f5a0f520 | ||
|
|
7f6c0f7f04 | ||
|
|
f658df4dca | ||
|
|
9d43b8e23a | ||
|
|
4270aef79b | ||
|
|
1c0dc82d44 | ||
|
|
c1e325aadf | ||
|
|
cec87da69d | ||
|
|
f68f24cb2c | ||
|
|
ed094347fc | ||
|
|
b8afdffbe1 | ||
|
|
f6ba79f31c | ||
|
|
5f3b1663d2 | ||
|
|
66e786b4bb | ||
|
|
f671114574 | ||
|
|
ce37060d94 | ||
|
|
7d19a4d184 | ||
|
|
22f28a2f8a | ||
|
|
ceef9ca979 | ||
|
|
efe8f4f939 | ||
|
|
ba692a1195 | ||
|
|
d732bad042 | ||
|
|
4c935c3bee | ||
|
|
c160dd791f | ||
|
|
23cd1b4601 | ||
|
|
031fc8ba1b | ||
|
|
c6853289ad | ||
|
|
2497bb69bc | ||
|
|
a58a67e0a2 | ||
|
|
4315fe12a5 | ||
|
|
42f10a8899 | ||
|
|
1e4b47f989 | ||
|
|
ff255dbfae | ||
|
|
dbe9b72feb | ||
|
|
95a714b391 | ||
|
|
28f58c7f56 | ||
|
|
8bd46d8f21 | ||
|
|
e1bb8e54ed | ||
|
|
1de705b063 | ||
|
|
f6926ad356 | ||
|
|
2cdbbb1b37 | ||
|
|
4dce8c8f03 | ||
|
|
97a5bace6f | ||
|
|
d4d51ec48f | ||
|
|
fb91398462 | ||
|
|
105dadd798 | ||
|
|
2abf2837d3 | ||
|
|
422aa67af6 | ||
|
|
7fffab6985 | ||
|
|
5a4be3d2c1 | ||
|
|
f39a7681db | ||
|
|
c60a7580ba | ||
|
|
97edb56edc | ||
|
|
6ebca8d22b | ||
|
|
95371ad934 | ||
|
|
2c176825fd | ||
|
|
fae7de48d3 | ||
|
|
b8230646a2 | ||
|
|
43279541dd | ||
|
|
b4791977c1 | ||
|
|
ef917ecc25 | ||
|
|
a93faad951 | ||
|
|
fd001d24d3 | ||
|
|
7aa5884797 | ||
|
|
5b237a1547 | ||
|
|
2e37990d87 | ||
|
|
dd07d724a8 | ||
|
|
03ce8618e7 | ||
|
|
db1a7a7fd6 | ||
|
|
36a82d7f53 | ||
|
|
3a34401113 | ||
|
|
9927268330 | ||
|
|
c45c97e29d | ||
|
|
c64a315226 | ||
|
|
a4cafca6ab | ||
|
|
46284a0660 | ||
|
|
05df86e15a | ||
|
|
8b433027e2 | ||
|
|
5bd4ff7610 | ||
|
|
d693c397ea | ||
|
|
1d8d1ec9a5 | ||
|
|
5e491f11ee | ||
|
|
7cedea06ac | ||
|
|
2e5f750e50 | ||
|
|
20289cad10 | ||
|
|
e0d64c31c7 | ||
|
|
8c1b95dc97 | ||
|
|
fb5641343e | ||
|
|
87765941eb | ||
|
|
1809862c16 | ||
|
|
300f784f7d | ||
|
|
67a045eae6 | ||
|
|
2a79903a28 | ||
|
|
d3222ce083 | ||
|
|
406a421742 | ||
|
|
10bf728faf | ||
|
|
607617747c | ||
|
|
f0a69eb1a2 | ||
|
|
6b307a6e17 | ||
|
|
08d08a934a | ||
|
|
c500c12668 | ||
|
|
62060adeba | ||
|
|
b2fc75edb8 | ||
|
|
a999dd2085 | ||
|
|
49f95ab100 | ||
|
|
1a84d5b30c | ||
|
|
3b65050632 | ||
|
|
d0df31674c | ||
|
|
1fe88402e2 | ||
|
|
67097696e6 | ||
|
|
8e7e77067a | ||
|
|
9899390b61 | ||
|
|
80c476a908 | ||
|
|
59da1d6e49 | ||
|
|
5aef7dac33 | ||
|
|
faf7aa06b6 | ||
|
|
38ef6e5583 | ||
|
|
c0b15b5d94 | ||
|
|
2cfc067ea1 | ||
|
|
a91db4f956 | ||
|
|
8a09780a02 | ||
|
|
45e8ec6505 | ||
|
|
4554b85914 | ||
|
|
8aa79c4a9c | ||
|
|
c8d3210b57 | ||
|
|
2282a49563 | ||
|
|
b82fdfb2c8 | ||
|
|
2d17eac199 | ||
|
|
e482bc3aad | ||
|
|
ec022b74d1 | ||
|
|
dc42c09ce3 | ||
|
|
046a34d2a4 | ||
|
|
9ff6ec1888 | ||
|
|
d2950106ec | ||
|
|
962f800d2e | ||
|
|
962107e507 | ||
|
|
039bd11963 | ||
|
|
5c250ea4ae | ||
|
|
e3405bcec6 | ||
|
|
0fd1c2235f | ||
|
|
b20c29b022 | ||
|
|
12d5dcd298 | ||
|
|
2c305dc6c6 | ||
|
|
62f76f7433 | ||
|
|
858ce524f9 | ||
|
|
3795fb4a40 | ||
|
|
0c01aeec50 | ||
|
|
892206744d | ||
|
|
9e2c1474db | ||
|
|
16328f73d9 | ||
|
|
e0d4f53cf4 | ||
|
|
e09a59c5b4 | ||
|
|
049e654535 | ||
|
|
c927dc4ecd | ||
|
|
fe4ecd0ad8 | ||
|
|
78d476fe80 | ||
|
|
a11c8465d5 | ||
|
|
366304a9b7 | ||
|
|
4356663688 | ||
|
|
26b55e6fcf | ||
|
|
0d743f7204 | ||
|
|
6cbe113b3e | ||
|
|
6409b69d6c | ||
|
|
c5164c76fc | ||
|
|
baade8e138 | ||
|
|
b848d6b4e0 | ||
|
|
d8139d2ab0 | ||
|
|
e96d8f7469 | ||
|
|
2acffd8afc | ||
|
|
3c8e72073c | ||
|
|
724d7a9d9b | ||
|
|
2da3b0db78 | ||
|
|
685ad7afaf | ||
|
|
264cf75964 | ||
|
|
c773dbc7b5 | ||
|
|
37cbc64f52 | ||
|
|
cb1dde17bb | ||
|
|
c29988acf4 | ||
|
|
eadbf56dae | ||
|
|
4b3b455135 | ||
|
|
e6ac177396 | ||
|
|
3d0e29003f | ||
|
|
78b9b00f77 | ||
|
|
0ee7faa551 | ||
|
|
e5fdced681 | ||
|
|
afb99fef64 | ||
|
|
7dfaa36024 | ||
|
|
0496f665aa | ||
|
|
0d19e1be74 | ||
|
|
4aff0111aa | ||
|
|
63b3ba2bb2 | ||
|
|
7444b41f60 | ||
|
|
8e90dbc8b6 | ||
|
|
9f70722521 | ||
|
|
52fae596fa | ||
|
|
ccb67957bc | ||
|
|
fb82538d0d | ||
|
|
72ee39612e | ||
|
|
51fd5408dc | ||
|
|
3fae40fbef | ||
|
|
0745890af0 | ||
|
|
4abe1730a7 | ||
|
|
626f0e6989 | ||
|
|
9f42d9d173 | ||
|
|
f90a93c4bc | ||
|
|
8000ad6c6a | ||
|
|
1f1f1bea1a | ||
|
|
d95460c7cd | ||
|
|
a3d93d4b08 | ||
|
|
07a92af982 | ||
|
|
f4618877d4 | ||
|
|
2b914fd222 | ||
|
|
109e42a5a3 | ||
|
|
fa515ad39c | ||
|
|
f09673a795 | ||
|
|
f71536c614 | ||
|
|
7bdddc7ae8 | ||
|
|
aa8926a624 | ||
|
|
be71e59be2 | ||
|
|
4d7753378f | ||
|
|
60257c4ef4 | ||
|
|
1e0b79bf62 | ||
|
|
6883434d0d | ||
|
|
eda2193e64 | ||
|
|
99bf829c88 | ||
|
|
5feafe1b48 | ||
|
|
c9292b7d04 | ||
|
|
ae7e1a91c1 | ||
|
|
3e1887e0d1 | ||
|
|
474646db47 | ||
|
|
56f7b6c449 | ||
|
|
76b2b5f7e3 | ||
|
|
e918d809eb | ||
|
|
7af059e543 | ||
|
|
897726e1ec | ||
|
|
8b98a2dd07 | ||
|
|
cca75420f0 | ||
|
|
86c627ed1d | ||
|
|
d55514e3a7 |
@@ -16,6 +16,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 +58,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")
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,110 @@
|
|||||||
|
# 국가 강제 지정 테스트 fixture 격리 구현 계획
|
||||||
|
|
||||||
|
> 실행: subagent-driven-development. 기존 승인 범위를 구현하며 추가 인터뷰 없이 진행한다.
|
||||||
|
|
||||||
|
## 현재 상태와 목표
|
||||||
|
- 작성일: 2026-11-06
|
||||||
|
- 상태: 구현 완료 (기능 범위 검증 완료, 전체 테스트는 사용자 실행)
|
||||||
|
- 요구사항: [prd.md](prd.md)
|
||||||
|
- 활성 Goal: 없음 (P1-T1, P1-GATE 완료)
|
||||||
|
- 목표: 운영 국가 ID 추가 시 일반 회원 fixture의 목록을 수정하지 않아도 되고, 기존 독립된 정책 검증은 유지된다.
|
||||||
|
- 기술: Kotlin 1.6.21, JDK 17, JUnit 5, Spring Boot 2.7.14, Gradle Wrapper.
|
||||||
|
- 시작 조건: 사용자 수정 승인, 관련 테스트/가이드 읽기 완료.
|
||||||
|
- 범위 밖: production, API, DB schema, dependency, 사용자 기존 변경, 전체 테스트 자동 실행, commit/push.
|
||||||
|
|
||||||
|
### Phase 1: 목록 복제 없는 fixture
|
||||||
|
|
||||||
|
- [x] **Task 1.1: 공통 fixture 판별과 세 호출부 전환 (P1-T1)**
|
||||||
|
|
||||||
|
**Objective:** 세 테스트가 강제 지정 ID 목록을 복사하지 않고 일반 회원을 준비한다.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/support/CountryMemberFixtures.kt`
|
||||||
|
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/support/CountryMemberFixturesTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/member/contentpreference/MemberContentPreferenceIntegrationTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt`
|
||||||
|
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/content/recommendation/adapter/in/web/AudioRecommendationEndToEndTest.kt`
|
||||||
|
- Verify unchanged: `src/test/kotlin/kr/co/vividnext/sodalive/member/contentpreference/MemberContentPreferenceServiceTest.kt`
|
||||||
|
|
||||||
|
**Interface:** test-only `internal fun Member.hasForcedCountryMapping(): Boolean`. 기존 resolver에 KR/JP를 각각 전달해 요청 국가가 유지되는지 확인하며, 어느 한 결과라도 다르면 true. 예상 응답 계산에는 사용 금지.
|
||||||
|
|
||||||
|
- [x] **Baseline:** 기존 service/integration 테스트와 아래 두 HTTP 메서드가 수정 전 통과하는지 확인한다.
|
||||||
|
- [x] **RED:** helper와 리터럴 기대값의 parameterized test를 작성한다. 기존 통합 테스트의 복제 목록 동작을 helper로 옮긴 상태에서 17958이 제외되지 않는 실패를 재현한다.
|
||||||
|
- [x] **RED 확인:** `CountryMemberFixturesTest`에서 17958의 expected true / actual false를 확인한다.
|
||||||
|
- [x] **GREEN:** helper를 resolver 기반 판별로 바꾸고 16/17958/29721은 true, 100은 false인지 확인한다.
|
||||||
|
- [x] **GREEN 확인:** helper focused test 통과.
|
||||||
|
- [x] **REFACTOR:** 세 호출부 조건을 helper로 교체하고 목록 복사본을 제거한다. 기존 저장 루프와 정책/응답 assertions는 보존한다.
|
||||||
|
|
||||||
|
**완료 증거:** 다음 세 시나리오 PASS 및 아래 명령 결과 기록.
|
||||||
|
|
||||||
|
| 시나리오 | PASS 조건 | 실제 검증 표면 |
|
||||||
|
|---|---|---|
|
||||||
|
| 일반 회원 | 100은 강제 지정 아님, 기존 US/JP/기본값 처리 보존 | helper JUnit + H2 integration |
|
||||||
|
| 강제 지정/누락 경계 | 16/17958/29721 제외, 헤더보다 강제 지정 우선 | helper JUnit + 기존 service policy assertions |
|
||||||
|
| 인접 HTTP 회귀 | 홈/오디오의 기존 8개 국가·인증 조합별 상태/스키마/이벤트 ID assertion 통과 | 기존 Spring MockMvc 요청과 실제 H2 persistence |
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.support.CountryMemberFixturesTest' --console=plain
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceServiceTest' --tests 'kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceIntegrationTest' --console=plain
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest.shouldApplyEventBannerDetailPolicyForHomeAggregate' --tests 'kr.co.vividnext.sodalive.v2.api.content.recommendation.adapter.in.web.AudioRecommendationEndToEndTest.shouldApplyEventBannerDetailPolicyAndKeepAudioResponseSchema' --console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
**P1-T1 실행 결과 (2026-11-06):**
|
||||||
|
- 모든 실제 Gradle 실행은 `JAVA_HOME`을 Liberica 17.0.15로 지정하고 `--no-daemon --console=plain`을 사용했다. Baseline은 기존 두 클래스와 위 HTTP 두 메서드를 한 번에 선택해 74건 통과했다(service 36, integration 22, 홈 8, 오디오 8).
|
||||||
|
- RED/GREEN 명령은 `./gradlew --no-daemon test --tests 'kr.co.vividnext.sodalive.support.CountryMemberFixturesTest' --console=plain`이다. 기존 통합 테스트의 복제 목록 동작에서는 4건 중 17958만 expected true / actual false로 실패했고(exit 1), KR/JP resolver probe 전환 후 4건 모두 통과했다(exit 0).
|
||||||
|
- 최종 focused 회귀는 baseline의 네 `--tests` 선택자에 helper를 추가해 78건 통과했다(실패/오류/skip 0). 실제 H2 persistence와 홈/오디오 MockMvc의 기존 국가·인증별 상태/스키마/이벤트 ID assertion을 유지한 채 검증했다. 세 시나리오 모두 PASS다.
|
||||||
|
- `compileTestKotlin`이 변경 후 실제 실행되어 통과했다. `./gradlew --no-daemon ktlintTestSourceSetCheck -PinternalKtlintGitFilter=... --console=plain`은 변경한 다섯 Kotlin 파일을 줄바꿈으로 지정해 통과했다(빈 위반 보고서). LSP 도구가 없어 `lsp_diagnostics`는 미실행이다.
|
||||||
|
- production 전체 diff가 시작 시점과 같고 resolver/service test/PRD의 SHA-256도 보존됐다. 저장 재시도 루프와 기존 assertion은 변경하지 않았다. 작업 소유 Gradle/Kotlin/test JVM 및 Redis 잔류 프로세스는 없었다. 전체 테스트, build/check, 독립 리뷰, 임시 증거 삭제는 실행하지 않았고 P1-GATE는 변경하지 않았다. 전체 테스트는 사용자가 `./gradlew test`로 실행한다.
|
||||||
|
|
||||||
|
실제 전체 명령·결과·RED 상세: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/country-fixture.zPNREy/implementation-report.md`.
|
||||||
|
로그와 단계별 원본 JUnit XML: 같은 경로의 `implementation.igrAaj/{baseline,red,green,focused}-test-results/` 및 `*.log`. Baseline과 최종 회귀에서 Redis 종료 중 Lettuce 재연결 경고가 있었고, Gradle deprecation 경고도 보존했다. 해당 경고로 인한 테스트 실패는 없었다.
|
||||||
|
|
||||||
|
- [x] **Phase Gate (P1-GATE): 검증과 독립 리뷰**
|
||||||
|
- 시작 조건: P1-T1 검증 통과.
|
||||||
|
- 완료 증거: 변경 test Kotlin compile 및 scoped lint, diff 검사, 독립 리뷰 승인, 소유 임시 자원 정리.
|
||||||
|
- TDD 예외 사유: Gate는 읽기 전용 검증이다. 기존 테스트/XML과 코드 diff로 판정한다.
|
||||||
|
- LSP 도구는 현재 미등록이므로 실행 불가를 기록하고 Kotlin test compilation/scoped lint로 대체한다.
|
||||||
|
- 전체 테스트는 미실행이며 사용자 명령은 `./gradlew test`이다. 전체 성공으로 표시하지 않는다.
|
||||||
|
- 종료 조건: 세 시나리오와 focused tests 통과, 독립 reviewer 승인, 범위 밖 변경 없음, 검증 기록과 QA 자원 정리 완료 시 즉시 종료한다.
|
||||||
|
|
||||||
|
## 검증 기록
|
||||||
|
- 시작 시 production resolver에 사용자 수정 `45459L`이 있었다. 이번 작업은 해당 파일을 변경하지 않는다.
|
||||||
|
- 기본 macOS Java 검색은 실패했지만 `$JAVA_HOME/bin/java -version`은 Liberica 17.0.15로 성공했다.
|
||||||
|
|
||||||
|
### 부모 세션 재검증 (2026-11-06)
|
||||||
|
|
||||||
|
아래 명령으로 캐시된 test 결과를 사용하지 않고 같은 78건을 직접 재실행했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon test --rerun \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.support.CountryMemberFixturesTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceServiceTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceIntegrationTest' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest.shouldApplyEventBannerDetailPolicyForHomeAggregate' \
|
||||||
|
--tests 'kr.co.vividnext.sodalive.v2.api.content.recommendation.adapter.in.web.AudioRecommendationEndToEndTest.shouldApplyEventBannerDetailPolicyAndKeepAudioResponseSchema' \
|
||||||
|
--console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
- 결과: exit 0, `BUILD SUCCESSFUL in 2m 30s`, test task 실제 실행. 원본 `build/test-results/test/TEST-*.xml`의 4/36/22/8/8건 합계 78건, 실패/오류/skip 모두 0을 직접 확인했다.
|
||||||
|
- 홈/오디오 두 메서드의 MockMvc 요청과 H2 persistence가 실제 실행됐다. 운영 서버 호출이나 외부 DB 접근은 없다.
|
||||||
|
- 변경된 Kotlin 다섯 파일을 모두 읽고 diff를 대조했다. 기존 assertions와 저장 루프는 그대로이고 세 조건만 공통 helper를 사용한다.
|
||||||
|
- 운영 resolver SHA-256은 시작과 동일한 `5b562826c7cef1da40406c49c5105a534afb39a64fb915ea2a4ca9ac44dab9df`다.
|
||||||
|
- `git diff --check` 통과. 테스트 후 Gradle/test/Kotlin JVM과 Redis 프로세스 검색 결과 0건.
|
||||||
|
- scoped lint 재현 명령(다섯 변경 파일 전체 포함):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon ktlintTestSourceSetCheck \
|
||||||
|
-PinternalKtlintGitFilter=$'src/test/kotlin/kr/co/vividnext/sodalive/support/CountryMemberFixtures.kt\nsrc/test/kotlin/kr/co/vividnext/sodalive/support/CountryMemberFixturesTest.kt\nsrc/test/kotlin/kr/co/vividnext/sodalive/member/contentpreference/MemberContentPreferenceIntegrationTest.kt\nsrc/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt\nsrc/test/kotlin/kr/co/vividnext/sodalive/v2/api/content/recommendation/adapter/in/web/AudioRecommendationEndToEndTest.kt' \
|
||||||
|
--console=plain
|
||||||
|
```
|
||||||
|
|
||||||
|
- 위 lint는 구현 세션에서 exit 0, `BUILD SUCCESSFUL in 1m 11s`; 원본 로그와 빈 위반 보고서를 부모가 확인했다.
|
||||||
|
- 기존 종료 시 Lettuce 재연결 경고와 Gradle deprecation 경고가 재현됐다. 테스트 실패는 없으며 이번 범위 밖 코드는 수정하지 않았다.
|
||||||
|
- 전체 테스트와 LSP는 미실행이다. 전체 테스트 사용자 실행 명령: `./gradlew test`.
|
||||||
|
|
||||||
|
### 독립 리뷰 (2026-11-06)
|
||||||
|
- [fixture 격리 리뷰](reviews/fixture격리-review.md): 명세 준수 및 코드 품질 승인. 차단 사항/수정 권고 없음.
|
||||||
|
- reviewer가 코드/diff와 원본 RED/GREEN/XML/lint 로그를 직접 대조했다. 부모의 fresh 78건 재실행 결과도 위에 기록했다.
|
||||||
|
- P1-T1에 적힌 임시 증거 경로는 실행 당시 기록이다. 소유 임시 파일 정리 후에는 위 재현 명령·결과와 리뷰 문서를 영구 기록으로 사용한다. 마지막 JUnit XML/HTML은 `build/test-results/test/`와 `build/reports/tests/test/`에 있으며 다음 Gradle 실행으로 갱신될 수 있다.
|
||||||
|
- QA 정리 완료: Gradle/test/Kotlin JVM 및 Redis 프로세스 0건을 확인한 뒤 이번 작업의 `country-fixture.zPNREy` 디렉터리(하위 implementation/review 포함)와 임시 notepad만 삭제했다. 두 경로의 부재를 `test ! -e`로 재확인했다. 공유 cache와 작업 트리는 변경하지 않았으며 commit/push는 하지 않았다.
|
||||||
|
- Gate 판정: 세 시나리오와 focused 78건, scoped lint, 독립 리뷰, 사용자 변경 보존 및 임시 자원 정리 완료. LSP와 전체 suite 미실행 범위는 위와 같다.
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
# 국가 강제 지정 테스트 fixture 격리 PRD
|
||||||
|
|
||||||
|
## 문서 정보
|
||||||
|
- 상태: 구현 완료
|
||||||
|
- 작성일: 2026-11-06
|
||||||
|
- 결정권자: 사용자. 기존 리뷰의 권장 방향으로 수정 승인.
|
||||||
|
- 구현 계획: [plan-task.md](plan-task.md)
|
||||||
|
|
||||||
|
## 문제와 목표
|
||||||
|
일반 회원 fixture를 만드는 세 테스트가 운영 국가 강제 지정 ID 목록을 복사한다.
|
||||||
|
복사본 누락으로 일반 회원이 강제 지정 회원으로 선택될 수 있으며, 운영 목록 추가가 관련 없는 테스트 수정으로 이어진다.
|
||||||
|
목표는 세 fixture가 운영 ID를 중복 관리하지 않고 일반 회원을 선택하면서 독립된 정책/응답 기대값을 유지하는 것이다.
|
||||||
|
|
||||||
|
## 요구사항
|
||||||
|
| ID | 상태 | 요구사항 | 수용 기준 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| COUNTRY-FIXTURE-001 | 확정 | 운영 ID 목록 복제 제거 | 세 fixture가 공통 test-only 판별 함수를 사용하고 목록 복사본이 없다. |
|
||||||
|
| COUNTRY-FIXTURE-002 | 확정 | 일반 회원과 강제 지정 회원 구분 | 일반 회원 100은 허용하고 KR 16/17958 및 JP 29721은 제외한다. 17958은 기존 통합 테스트 복사본 누락 회귀 사례다. |
|
||||||
|
| COUNTRY-FIXTURE-003 | 확정 | 독립된 검증 유지 | 기존 강제 지정 우선순위, 정규화, 기본값 및 홈/오디오 응답 assertion을 변경하지 않는다. |
|
||||||
|
| COUNTRY-FIXTURE-004 | 확정 | 운영 정책 보존 | production 파일/API/DB/config 변경이 없고 사용자의 기존 JP 45459 추가를 보존한다. |
|
||||||
|
|
||||||
|
## 구현 결정과 범위 밖
|
||||||
|
- test-only `Member.hasForcedCountryMapping()`은 서로 다른 KR/JP 헤더에 대해 기존 resolver가 헤더를 그대로 반환하는지 판별한다. 어느 하나라도 다르면 일반 회원 후보에서 제외한다.
|
||||||
|
- 이 함수는 fixture 선택용이다. 국가 정책과 응답의 기대값 계산에는 사용하지 않는다.
|
||||||
|
- 기존 세 후보 생성 반복문과 persistence 경로는 유지한다. 신규 dependency, 설정, production 추상화는 만들지 않는다.
|
||||||
|
- 개별 운영 ID 전체를 테스트에 열거하지 않는다. 회귀 입력 ID는 대표 사례이지 동기화할 운영 목록이 아니다.
|
||||||
|
- 전체 테스트는 저장소 규칙에 따라 사용자가 실행한다. 이번 작업은 focused policy 및 직접 영향받는 HTTP 테스트를 실행한다.
|
||||||
|
|
||||||
|
## 완료 기준
|
||||||
|
- [x] 세 fixture의 운영 목록 복사본 제거.
|
||||||
|
- [x] 누락 ID 회귀 RED/GREEN과 일반/강제 회원 판별 검증.
|
||||||
|
- [x] 기존 policy/DB 및 홈/오디오 MockMvc 검증 통과.
|
||||||
|
- [x] production 보존, 독립 리뷰, 검증 한계 기록 및 소유 QA 자원 정리.
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
# 국가 fixture 격리 리뷰
|
||||||
|
|
||||||
|
## 리뷰 정보
|
||||||
|
- 일자: 2026-11-06
|
||||||
|
- 범위: P1-T1의 test-only Kotlin 5개 파일과 기존 정책/HTTP 검증 보존.
|
||||||
|
- 기준: [PRD](../prd.md), [구현 계획](../plan-task.md), working tree diff.
|
||||||
|
- 리뷰어: 별도 read-only reviewer (`ses_e4f9ca68effegn7SKxWexCfjMl`).
|
||||||
|
- 판정: 명세 준수 승인, 코드 품질 승인. 확정 발견 사항 없음, 회귀 수정 Task 전환 항목 없음.
|
||||||
|
|
||||||
|
## 근거
|
||||||
|
- 세 호출부에서 운영 ID 복사본을 제거했다. 저장·재시도·index·flush/clear와 기존 assertion은 변경하지 않았다.
|
||||||
|
- test-only helper는 KR/JP 요청값 유지 여부로 강제 지정을 판별한다. 일반 회원 100, KR 16, JP 29721, 기존 복사본 누락 17958을 독립 리터럴 기대값으로 검증한다.
|
||||||
|
- helper 결과는 일반 회원 fixture 선택에만 쓰인다. 국가 우선순위·정규화·기본값 및 HTTP 응답의 기대값은 resolver에서 계산하지 않는다.
|
||||||
|
- production diff는 시작 시점과 동일한 사용자의 JP 45459 추가뿐이다. Resolver SHA-256 `5b562826c7cef1da40406c49c5105a534afb39a64fb915ea2a4ca9ac44dab9df` 일치를 직접 확인했다.
|
||||||
|
- 원본 XML/log에서 baseline 74 PASS, RED 4 중 17958만 expected true / actual false 실패, GREEN 4 PASS, 최종 78 PASS 및 scoped lint 5파일 PASS를 대조했다.
|
||||||
|
- 부모도 동일 78건을 `test --rerun`으로 재실행하여 PASS를 확인했다. 상세 명령과 결과는 구현 계획에 보존한다.
|
||||||
|
|
||||||
|
## 한계
|
||||||
|
- reviewer는 읽기 전용으로 검토했으며 테스트를 중복 실행하지 않았다.
|
||||||
|
- LSP 도구는 미등록이다. 실제 Kotlin test compilation과 scoped lint를 확인했다.
|
||||||
|
- 전체 suite는 미실행이다. 사용자 실행 명령은 `./gradlew test`.
|
||||||
@@ -0,0 +1,88 @@
|
|||||||
|
# 이벤트 수정 누락 필드 보존 구현 계획
|
||||||
|
|
||||||
|
## 목표와 상태
|
||||||
|
- 작성일: 2026-11-06
|
||||||
|
- 요구사항: [prd.md](prd.md)
|
||||||
|
- 상태: 기능 범위 구현 및 검증 완료
|
||||||
|
- 현재 활성 Goal: 없음
|
||||||
|
- 기술: Kotlin 1.6.21, Java 17, Spring Boot 2.7.14, JUnit 5, MockMvc, H2.
|
||||||
|
- 구조: 기존 두 서비스의 대입 조건에 null 가드만 추가한다. API 시그니처와 명시값 처리 방식은 바꾸지 않는다.
|
||||||
|
- 실행: subagent-driven-development. 기존 작업 디렉터리를 사용하고 worktree는 생성하지 않는다.
|
||||||
|
|
||||||
|
### Phase 1: 두 API의 누락 값 보존
|
||||||
|
|
||||||
|
- [x] **Task 1.1: 요청 누락 회귀 테스트와 최소 수정 (P1-T1)**
|
||||||
|
|
||||||
|
**Objective:** 두 이벤트 수정 API가 누락된 link/isAdult를 보존하면서 명시값은 기존대로 저장한다.
|
||||||
|
- 시작 조건: EVENT-001~005 확정, 기존 코드·테스트 확인 완료.
|
||||||
|
- 완료 증거: RED assertion 실패, GREEN 통합 테스트 통과, DB 재조회 검증.
|
||||||
|
- 범위 밖: 다른 필드 처리 변경, 공개 스키마 변경, 운영 데이터 접근.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/event/EventService.kt`
|
||||||
|
- `src/main/kotlin/kr/co/vividnext/sodalive/admin/event/banner/AdminEventBannerService.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/event/EventControllerIntegrationTest.kt`
|
||||||
|
- `src/test/kotlin/kr/co/vividnext/sodalive/admin/event/banner/AdminEventBannerControllerIntegrationTest.kt`
|
||||||
|
|
||||||
|
- [x] **RED:** 기존 통합 테스트에 관리자 인증 PUT 요청과 DB 재조회 assertion을 추가한다.
|
||||||
|
- [x] **RED 확인:** 아래 focused 명령으로 기존 link/isAdult가 null로 바뀌어 실패하는지 확인한다.
|
||||||
|
- [x] **GREEN:** 두 서비스의 link/isAdult 대입 조건에 각 인자 `!= null` 가드를 추가한다.
|
||||||
|
- [x] **GREEN 확인:** 동일 focused 테스트에서 모든 시나리오가 통과한다.
|
||||||
|
- [x] **REFACTOR:** 불필요한 리팩터링 없이 기존 테스트를 포함한 직접 영향 회귀를 확인한다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export TMPDIR=/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-omission.qeHSia/implementer.ZukrpN
|
||||||
|
export NODE_COMPILE_CACHE=$TMPDIR/node-compile-cache BUN_RUNTIME_TRANSPILER_CACHE_PATH=$TMPDIR/bun-transpiler
|
||||||
|
./gradlew test --no-daemon --tests 'kr.co.vividnext.sodalive.event.EventControllerIntegrationTest' --tests 'kr.co.vividnext.sodalive.admin.event.banner.AdminEventBannerControllerIntegrationTest'
|
||||||
|
```
|
||||||
|
|
||||||
|
**P1-T1 검증 결과 (2026-11-06):**
|
||||||
|
- RED: production 변경 전 위 명령 exit 1, 2분 23초. 23개 중 10개 assertion 실패, error/skip 0. 일반 클래스 12개 중 5개, 관리자 클래스 11개 중 5개 실패했다. 각 API의 제목만 수정한 true/false/null 3개 사례에서 기존 링크 대신 null이 저장됐으며 true/false도 null이 됐다. 빈 문자열/공백 링크 2개 사례에서는 링크의 기존 처리 방식은 맞았지만 생략한 isAdult가 true 대신 null이 됐다. 기존 테스트 9개와 명시값 변경 4개는 통과했다.
|
||||||
|
- GREEN: 네 비교문에만 `link != null &&`, `isAdult != null &&`를 추가한 뒤 동일 명령 exit 0, 3분 35초. 일반 12개와 관리자 11개, 총 23개 모두 통과하고 failure/error/skip은 0이었다. 기존 테스트를 삭제·변경하지 않았고 리팩터링하지 않았다.
|
||||||
|
- S1~S3는 실제 컨트롤러·보안·서비스와 기존 S3 mock을 사용했다. 모든 요청의 HTTP 200 및 `success=true`를 확인한 뒤 별도 repository 호출로 H2를 재조회했다. 제목만 수정하는 사례는 이미지 3종·isPopup·기간·lang·isActive까지 Event 스냅샷으로 완전 비교했다. 명시값은 Boolean을 반대 값에서 true/false로 각각 변경했고, 빈 문자열/공백 링크는 일반 API의 원문 저장과 관리자 API의 null 저장을 확인했다. 시각은 `2099-01-01T00:00:00`, `2099-01-02T23:59:59`로 고정했다.
|
||||||
|
- 임시 RED/GREEN 보고서: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/event-omission.qeHSia/implementer.ZukrpN/p1-t1-red-green.md`. GREEN XML에서도 각 클래스의 test/failure/error/skip 수를 확인했다. LSP 진단 도구가 제공되지 않아 실행하지 못했으며 Gradle의 production/test Kotlin 컴파일이 성공했다. 변경 파일의 컴파일 경고는 없고, 기존 다른 파일의 불필요한 `!!`·unchecked cast·미사용 인자 및 Gradle deprecation 경고는 남아 있다.
|
||||||
|
- 한계: MockMvc/H2 통합 검증이며 실제 네트워크·운영 MySQL 검증은 아니다. 전체 테스트는 미실행이며 사용자 실행 명령은 `./gradlew test`이다. QA·변경 범위 lint·빌드·리뷰·임시 리소스 정리는 상위 에이전트의 P1-GATE에 남겼다. 커밋·스테이징·푸시와 운영 앱/서비스 실행은 하지 않았다.
|
||||||
|
|
||||||
|
## 시나리오 계약
|
||||||
|
| 시나리오 | PASS 조건 | 검증 표면 |
|
||||||
|
|---|---|---|
|
||||||
|
| S1 누락 보존 | 제목만 수정해도 link와 isAdult=true/false/null 및 다른 생략 필드가 DB 재조회에서 유지된다. | 두 실제 컨트롤러의 MockMvc PUT + H2 |
|
||||||
|
| S2 명시값 반영 | 새 링크, isAdult=true/false가 저장되고 응답 success=true이다. | 두 컨트롤러 + H2 |
|
||||||
|
| S3 빈값 호환 | 빈 문자열·공백 link는 일반 API에서 원문, 관리자 API에서 null로 저장된다. isAdult 생략값은 유지된다. | 두 컨트롤러 + H2 |
|
||||||
|
| S4 인접 회귀 | 기존 이벤트 조회·언어·생성 테스트가 통과한다. | 기존 focused 테스트 |
|
||||||
|
|
||||||
|
- [x] **Phase Gate (P1-GATE): 검증 및 리뷰**
|
||||||
|
- 시작 조건: P1-T1 완료.
|
||||||
|
- 완료 증거: focused 회귀, `./gradlew bootJar`, 변경 diff 리뷰, 검증 한계 기록, 임시 리소스 정리.
|
||||||
|
- 범위 밖: 전체 테스트 자동 실행, 관련 없는 lint 수정, 커밋/푸시.
|
||||||
|
- TDD 예외 사유: Gate는 구현이 아닌 검증 단계이다.
|
||||||
|
- 대체 검증: 실제 HTTP QA가 가능한 로컬 테스트 환경이면 endpoint 응답과 DB 결과를 확인한다. 불가하면 MockMvc와 실제 네트워크 검증을 구분해 기록한다.
|
||||||
|
- LSP 도구가 제공되지 않으면 그 사실을 명시하고 Kotlin 컴파일과 변경 범위 lint를 대체 증거로 남긴다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.event.*' --tests 'kr.co.vividnext.sodalive.admin.event.banner.*'
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
## 종료 조건
|
||||||
|
S1~S4의 관찰 가능한 동작과 focused 테스트가 통과하고, 빌드·변경 리뷰·임시 리소스 정리가 완료되면 즉시 종료한다. 전체 테스트는 저장소 규칙에 따라 사용자가 `./gradlew test`로 실행하며, 미검증 범위를 명시한다.
|
||||||
|
|
||||||
|
## 검증 기록
|
||||||
|
- 초기 조사: 두 서비스에서 link/isAdult만 누락 null을 대입하고, 기존 세 테스트 클래스에 update 검증이 없음을 확인했다.
|
||||||
|
- 계획 에이전트 후속 호출은 timeout으로 종료됐다. 기존 조사와 승인된 요구사항으로 위 최소 변경을 확정했다.
|
||||||
|
|
||||||
|
### P1-GATE 검증 결과 (2026-11-06)
|
||||||
|
- 실제 HTTP QA: 임시 `EventOmissionHttpQaTest`를 별도 Gradle init script로 테스트 소스에 연결했다. `./gradlew --no-daemon --console=plain -I "$TMPDIR/http-qa.init.gradle" test --tests 'kr.co.vividnext.sodalive.event.EventOmissionHttpQaTest'` exit 0. RANDOM_PORT 서버와 TestRestTemplate, 실제 TokenProvider 관리자 JWT, H2·embedded Redis를 사용했다. MockMvc 요청으로 대체하지 않았다.
|
||||||
|
- 실제 네트워크: 두 경로 각각 기존 성인 여부 true/false/null에서 제목만 수정, 링크만 수정, isAdult=true, isAdult=false, 빈 링크, 공백 링크를 차례로 전송했다. 총 36개 PUT 모두 HTTP 200, `{"success":true,"message":"수정되었습니다.","data":{},"errorProperty":null}` 응답이며, 6개 조합 모두 DB 재조회 assertion을 통과했다. 제목 외 필드 보존·독립 필드 수정·빈값 호환을 확인했다.
|
||||||
|
- 1차 Gate: `./gradlew --no-daemon --console=plain test --tests 'kr.co.vividnext.sodalive.event.*' --tests 'kr.co.vividnext.sodalive.admin.event.banner.*' ktlintCheck bootJar --continue` exit 0, 1분 30초. 저장소 39개 및 앞선 임시 QA 컴파일 클래스 2개가 실행됐다. `ktlintCheck` 실제 실행 통과, `bootJar` 생성 및 `build/libs/sodalive-0.0.1-SNAPSHOT.jar` 확인.
|
||||||
|
- 임시 QA 컴파일 클래스가 일반 실행에도 남은 것을 확인해 해당 소유 class 파일만 제거했다. 이후 임시 init script 없이 아래 명령으로 저장소 테스트만 재실행했다.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./gradlew --no-daemon --console=plain test --rerun --tests 'kr.co.vividnext.sodalive.event.*' --tests 'kr.co.vividnext.sodalive.admin.event.banner.*' ktlintCheck bootJar --continue
|
||||||
|
```
|
||||||
|
|
||||||
|
- 최종 결과: exit 0, 2분 57초. XML 5개에서 일반 컨트롤러 12 + 관리자 컨트롤러 11 + 언어 통합 7 + 저장소 5 + 서비스 4 = **39개**, 실패·오류·skip 모두 0. XML 시각은 `2026-11-06T04:14:52`~`04:15:19`. 임시 QA class는 최종 결과에 없다. Kotlin test 컴파일 및 테스트는 실제 실행됐고, 동일 입력의 lint·bootJar는 직전 통과 결과를 재사용한 UP-TO-DATE였다.
|
||||||
|
- 독립 리뷰: `bg_8220e32c`가 PRD EVENT-001~005, 실제 diff, 연결 코드와 테스트, HTTP/DB 원본을 대조해 **APPROVE**. 차단 사항 없음. [리뷰 기록](reviews/event-omission-review.md).
|
||||||
|
- 진단: LSP 도구가 제공되지 않아 미실행이며 Kotlin 컴파일·ktlintCheck로 대체했다. `git diff --check` 통과. 기존 무관 코드 경고와 테스트 context 종료 경고는 이번 수정 범위 밖이다.
|
||||||
|
- 검증 한계: 전체 테스트와 운영 MySQL·실제 관리자 UI는 미검증이다. 전체 검증은 사용자가 `./gradlew test`로 실행한다. 운영 데이터 복원·접속 및 커밋·푸시는 하지 않았다.
|
||||||
|
- 정리: Gradle wrapper/daemon/test worker·embedded Redis 프로세스가 남아 있지 않음을 확인했다. 이번 작업 소유 `event-omission.qeHSia` 루트와 두 자식 루트, 임시 HTTP QA 소스·init script·로그를 삭제했고, 루트·임시 class·임시 XML 부재 검사 `CLEANUP_PASS`를 확인했다. 앞서 기록된 임시 보고서 경로는 실행 당시 경로이며 현재는 위 문서와 리뷰에 요약 근거를 보존한다. 공유 캐시·기존 worktree·운영 리소스는 건드리지 않았다.
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
# 이벤트 수정 누락 필드 보존 PRD
|
||||||
|
|
||||||
|
## 문서 정보
|
||||||
|
- 작성일: 2026-11-06
|
||||||
|
- 상태: 구현 및 기능 범위 검증 완료
|
||||||
|
- 결정권자: 사용자. 두 API 모두 파라미터 미전송 시 기존 값을 유지하도록 명시 승인.
|
||||||
|
- 구현 계획: [plan-task.md](plan-task.md)
|
||||||
|
|
||||||
|
## 문제와 목표
|
||||||
|
`PUT /event`, `PUT /admin/event/banner`에서 `link`, `isAdult`를 생략하면 기존 값이 null로 덮어써진다. 부분 수정 시 생략된 값을 보존하고, 명시적으로 전달한 값은 기존 방식으로 반영한다.
|
||||||
|
|
||||||
|
## 요구사항과 수용 기준
|
||||||
|
| ID | 상태 | 요구사항 | 수용 기준 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| EVENT-001 | 확정 | 두 API의 link 생략은 변경하지 않는다. | 제목만 수정한 뒤 DB 재조회에서 기존 링크가 유지된다. |
|
||||||
|
| EVENT-002 | 확정 | 두 API의 isAdult 생략은 변경하지 않는다. | 기존 true, false, null 각각이 유지된다. |
|
||||||
|
| EVENT-003 | 확정 | 명시한 값의 기존 동작을 유지한다. | 새 링크 및 isAdult=true/false가 저장된다. |
|
||||||
|
| EVENT-004 | 확정 | 빈 링크의 기존 API별 동작을 유지한다. | /event는 빈 문자열·공백을 그대로 저장하고 관리자 API는 null로 저장한다. |
|
||||||
|
| EVENT-005 | 확정 | 다른 생략 필드와 API 계약을 유지한다. | 이미지·isPopup·기간·lang·isActive는 제목만 수정해도 유지되고 응답 성공 형식과 ADMIN 권한은 변하지 않는다. |
|
||||||
|
|
||||||
|
## 범위 밖
|
||||||
|
- 새 삭제 파라미터, JSON PATCH, DTO·스키마 변경, 서비스 통합/리팩터링.
|
||||||
|
- 기존 데이터 복원, 관리자 프런트엔드 변경, 운영 DB 접근, 날짜 처리 변경.
|
||||||
|
- isAdult를 null로 초기화하는 새 기능. 생략은 이제 보존이며 true/false 전송은 기존대로 지원한다.
|
||||||
|
|
||||||
|
## 검증 경계
|
||||||
|
기존 SpringBootTest/MockMvc와 H2 재조회로 요청 바인딩부터 저장까지 검증한다. S3는 기존 mock을 유지한다. 실제 관리자 UI 및 운영 MySQL 검증과 전체 테스트는 별도이며, 전체 테스트 실행 명령은 `./gradlew test`이다.
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
# 이벤트 수정 누락 필드 보존 리뷰
|
||||||
|
|
||||||
|
## 리뷰 정보
|
||||||
|
- 일자: 2026-11-06
|
||||||
|
- 대상: 현재 working tree의 서비스 2개·통합 테스트 2개, P1-T1/P1-GATE
|
||||||
|
- 기준: [PRD](../prd.md), [구현 계획](../plan-task.md)
|
||||||
|
- 리뷰어: 독립 검토 에이전트 `bg_8220e32c` 및 상위 에이전트 실행 검증
|
||||||
|
- 상태: 판정 완료, APPROVE
|
||||||
|
|
||||||
|
## 검토 근거
|
||||||
|
- `EventService.update`, `AdminEventBannerService.update`의 production 변경은 null 가드 네 곳뿐이다.
|
||||||
|
- 두 컨트롤러의 선택 파라미터, ADMIN 권한, 응답 구조, Event 엔티티·저장소를 대조했다.
|
||||||
|
- 기존 통합 테스트에 추가한 14개 사례는 실제 컨트롤러와 서비스 및 별도 H2 재조회로 누락·명시값·빈값 처리를 확인한다.
|
||||||
|
- nullable Boolean 세 상태 및 다른 생략 필드는 Event 스냅샷으로 비교한다. 명시한 false도 별도 값으로 반영한다.
|
||||||
|
- 빈 링크는 기존대로 일반 API에서 원문을 저장하고 관리자 API에서 null로 저장한다.
|
||||||
|
|
||||||
|
## 실행 증거
|
||||||
|
| 검증 | 결과 |
|
||||||
|
|---|---|
|
||||||
|
| TDD RED | 구현자 기록: 23개 중 의도한 assertion 실패 10개. 리뷰어가 RED 원본을 별도로 재실행하지는 않았다. |
|
||||||
|
| focused GREEN | 리뷰어가 원본 XML의 일반 12개·관리자 11개, 실패·오류·skip 0을 확인했다. |
|
||||||
|
| 실제 HTTP/DB | 부모가 실제 관리자 JWT로 36개 PUT·6개 DB 상태 조합을 실행했고 리뷰어가 QA 소스와 XML을 대조했다. 모두 PASS. |
|
||||||
|
| 최종 인접 회귀 | 부모가 임시 QA class 제거 후 저장소 5개 클래스 39개를 재실행, 실패·오류·skip 0 확인. |
|
||||||
|
| 빌드·정적 검사 | 부모의 Kotlin 컴파일, ktlintCheck, bootJar, diff 공백 검사 통과. |
|
||||||
|
|
||||||
|
## 판정
|
||||||
|
확정 발견 사항 없음. EVENT-001~005에 부합하고 API 스키마·권한 변경이나 범위 확장이 없다. 독립 리뷰의 명세 준수 및 코드 품질 판정은 APPROVE다.
|
||||||
|
|
||||||
|
전체 테스트, 운영 MySQL, 실제 관리자 UI, LSP는 미검증이다. 전체 테스트는 사용자 실행 항목이며 위 검증을 전체 성공으로 표현하지 않는다.
|
||||||
@@ -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,154 @@
|
|||||||
|
# 파파고 번역 길이 분할 구현 계획
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 상태 | 구현·기능 범위 검증·리소스 정리 완료 |
|
||||||
|
| 요구사항 | [prd.md](prd.md), PC-001~005 |
|
||||||
|
| 현재 Phase | 1: 분할 호출과 완전한 결과 반환 |
|
||||||
|
| 활성 Goal | 없음 |
|
||||||
|
|
||||||
|
## 목표와 제약
|
||||||
|
|
||||||
|
긴 필드도 Papago 요청 길이를 넘지 않고 전체 번역 결과로 반환한다.
|
||||||
|
Kotlin 1.6.21, Java 17, Spring Boot 2.7.14와 기존 RestTemplate을 사용한다.
|
||||||
|
서비스 내부에 최소 분할 로직만 추가하며 인터페이스, 의존성, 언어 감지, AWS, DB, 워커는 변경하지 않는다.
|
||||||
|
작업 시작 시 트리는 깨끗했으며 기존 디렉터리에서 작업한다. 별도 worktree·배포·push는 하지 않는다.
|
||||||
|
사용자의 ULW Commit Discipline에 따라 검증 후 코드·테스트와 관련 문서를 각각 원자적으로 커밋한다.
|
||||||
|
|
||||||
|
### Phase 1: 분할 번역
|
||||||
|
|
||||||
|
- [x] **Task 1.1: 파파고 분할 호출 구현 (P1-T1)**
|
||||||
|
|
||||||
|
**Objective:** 요청당 5,000 이하, 입력 손실 없음, 결과 순서 유지, 부분 실패 시 성공 결과 없음.
|
||||||
|
**시작 조건:** PRD 확정 및 기존 테스트 확인.
|
||||||
|
**완료 증거:** RED/GREEN, focused 회귀, HTTP 표면 QA, 빌드, 변경 파일 정적 검사.
|
||||||
|
**범위 밖:** 문장 경계 최적화, AWS, 감지, 재시도 정책·공개 API 변경.
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/PapagoTranslationService.kt`
|
||||||
|
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/PapagoTranslationServiceTest.kt`
|
||||||
|
- Verify: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobWorkerTest.kt`
|
||||||
|
- Verify: `src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/TranslationJobSchedulerTest.kt`
|
||||||
|
|
||||||
|
**Interfaces:** `TranslationProvider.translate(TranslateRequest): TranslateResult` 유지. 성공 시 원문별 결과 한 개,
|
||||||
|
조각 실패 시 빈 결과로 기존 워커의 실패 처리를 사용한다.
|
||||||
|
|
||||||
|
- [x] **RED:** 요청 길이 경계, 이모지 경계, 입력 순서, 중간 HTTP 실패·빈 응답 회귀 테스트 작성.
|
||||||
|
- [x] **RED 확인:** 새 focused test에서 미분할/부분 성공으로 인한 assertion 실패 확인.
|
||||||
|
- [x] **GREEN:** 최대 5,000 UTF-16 길이 및 서로게이트 보존 분할, 순차 호출·결합, 부분 결과 폐기.
|
||||||
|
- [x] **GREEN 확인:** 동일 focused test 통과.
|
||||||
|
- [x] **REFACTOR:** 이번 변경의 중복만 정리하고 직접 영향 테스트·빌드·정적 검사 수행.
|
||||||
|
|
||||||
|
**시나리오 계약:**
|
||||||
|
1. S1: 짧은 원문 및 5,000/5,001/10,001 길이에서 요청당 상한을 지키고 입력 전체와 결과 순서를 보존한다.
|
||||||
|
2. S2: 한글·경계 이모지·다중 입력에서 문자를 손상시키지 않고 결과 개수와 대응을 보존한다.
|
||||||
|
3. S3: 중간 HTTP 오류·빈 번역은 부분 성공이 되지 않으며 기존 무호출 가드는 유지된다.
|
||||||
|
|
||||||
|
**P1-T1 실행 증거:**
|
||||||
|
- RED (production 수정 전):
|
||||||
|
`./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'`
|
||||||
|
→ exit 1, `17 tests completed, 11 failed`, XML `tests="17" failures="11" errors="0" skipped="0"`.
|
||||||
|
5,001/10,001자·한글·서로게이트·다중 원문의 미분할 JSON 요청이 assertion으로 실패했다.
|
||||||
|
짧은 원문의 HTTP 오류 뒤 `No further requests expected`로 불필요한 후속 호출을 재현했고,
|
||||||
|
본문 없는 응답에서는 빈 전체 결과 대신 앞선 번역과 빈 문자열을 반환했다. 가드·짧은 입력 6건은 통과했다.
|
||||||
|
- 구현: UTF-16 인덱스로 최대 5,000씩 자르되 high/low surrogate 사이의 경계는 한 단위 앞당긴다.
|
||||||
|
각 원문의 번역을 순차 누적해 한 결과로 반환하며, HTTP 오류·예외·null/blank 번역은 전체 빈 결과로 즉시 반환한다.
|
||||||
|
빈 원문 요소도 기존처럼 한 번 요청하도록 분할 helper의 `do/while`을 사용한다.
|
||||||
|
- GREEN:
|
||||||
|
`./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'`
|
||||||
|
→ exit 0, `BUILD SUCCESSFUL in 1m 42s`, XML `tests="17" failures="0" errors="0" skipped="0"`.
|
||||||
|
모든 기대 JSON 요청을 순서대로 검증하고, 미등록 후속 요청은 assertion 실패로 처리하므로 실패 후 호출 중단도 검증했다.
|
||||||
|
- 변경 파일 정적 검사:
|
||||||
|
`./gradlew --no-daemon --offline -I "$run_dir/papago-lint.init.gradle" ktlintMainSourceSetCheck ktlintTestSourceSetCheck`
|
||||||
|
→ exit 0, `BUILD SUCCESSFUL in 2m 39s`. 소유 임시 init script에서 `ktlint.filter.include`를
|
||||||
|
`**/PapagoTranslationService.kt`, `**/PapagoTranslationServiceTest.kt`로 제한했다.
|
||||||
|
LSP는 이 구현 세션에도 제공되지 않아 실행하지 못했다. Kotlin production/test 컴파일과 파일 한정 ktlint로 보완했다.
|
||||||
|
- 회귀·빌드:
|
||||||
|
`./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' bootJar`
|
||||||
|
→ exit 0, `BUILD SUCCESSFUL in 1m 38s`, `:bootJar`와 `:test` 모두 실행됐다.
|
||||||
|
XML 합계 28건 통과, 실패/오류/skip 0건: Papago 17, Worker 7, Scheduler 3, Normalizer 1.
|
||||||
|
`build/libs/sodalive-0.0.1-SNAPSHOT.jar` 생성을 확인했다. 범위 밖 리팩터링은 하지 않았다.
|
||||||
|
위임 범위인 구현·자동 검증으로 P1-T1을 완료하며, loopback HTTP 수동 QA와 독립 리뷰는 부모 세션의 P1-GATE에 남긴다.
|
||||||
|
|
||||||
|
**실행 명령:**
|
||||||
|
```bash
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.PapagoTranslationServiceTest'
|
||||||
|
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*'
|
||||||
|
./gradlew bootJar
|
||||||
|
```
|
||||||
|
|
||||||
|
**수동 표면 검증:** 실제 서비스와 loopback HTTP 서버를 연결해 S1~S3의 요청 JSON·결과를 검증한다.
|
||||||
|
임시 driver 사용 시 작업 소유 디렉터리에만 두고 서버·파일을 종료/정리한다. 유료 외부 API는 호출하지 않는다.
|
||||||
|
|
||||||
|
- [x] **Phase Gate (P1-GATE): 리뷰·증거·정리**
|
||||||
|
|
||||||
|
**Objective:** 요구사항과 diff를 독립 리뷰하고 모든 실행 결과·미검증 범위를 기록한다.
|
||||||
|
**시작 조건:** P1-T1의 focused 검증 완료.
|
||||||
|
**완료 증거:** 리뷰의 차단 이슈 0개, 범위 외 변경 없음, 임시 리소스 정리 확인.
|
||||||
|
**TDD 예외:** 읽기 전용 리뷰와 정리이며 코드 변경이 아니다.
|
||||||
|
**대체 검증:** diff/파일 직접 확인과 테스트 결과 대조.
|
||||||
|
|
||||||
|
## 검증 기록
|
||||||
|
|
||||||
|
- 초기 상태: `git status --short` 출력 없음. 기존 Papago 전용 테스트는 검색에서 발견되지 않았다.
|
||||||
|
- 전체 테스트는 실행하지 않는다. 사용자 실행 명령: `./gradlew test`.
|
||||||
|
- LSP 도구는 현재 세션 도구 목록에 없어 실행할 수 없다. Kotlin 컴파일과 가능한 정적 검사로 보완하고 한계를 보고한다.
|
||||||
|
- 구현 실행 소유 디렉터리: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/papago-chunk.3apfr5/implement.j3Yd7s`.
|
||||||
|
첫 shell에서 `mktemp -d`로 생성했으며 모든 shell 명령은 `TMPDIR`, `NODE_COMPILE_CACHE`,
|
||||||
|
`BUN_RUNTIME_TRANSPILER_CACHE_PATH`를 이 디렉터리로 export한다. 공유 캐시·부모 디렉터리는 정리하지 않는다.
|
||||||
|
- 테스트는 서비스만 로드하는 `@SpringBootTest(classes = [PapagoTranslationService::class])`와
|
||||||
|
기존 `ReflectionTestUtils.setField(..., "restTemplate", ...)` seam을 사용한다.
|
||||||
|
`MockRestServiceServer`에서 실제 RestTemplate의 JSON·헤더·순서를 검증하므로 외부 Papago/AWS 요청은 없다.
|
||||||
|
별도 loopback HTTP 수동 QA와 독립 리뷰/P1-GATE 판정은 부모 세션이 수행한다.
|
||||||
|
- RED/GREEN/회귀/빌드 결과는 위 P1-T1 실행 증거에 기록했다. 전체 테스트와 실서비스 호출은 실행하지 않았다.
|
||||||
|
- GREEN 및 파일 한정 lint의 첫 실행은 각각 shell 도구의 120,000ms 제한으로 종료됐다.
|
||||||
|
테스트 실패나 컴파일 오류로 판정하지 않았으며, 제한을 600,000ms로 늘린 재실행에서 위 GREEN/정적 검사 성공을 확인했다.
|
||||||
|
기존 Gradle deprecation 경고(Gradle 9 비호환 안내)는 남아 있으며 이번 범위에서 수정하지 않는다.
|
||||||
|
- 리소스 정리 영수증: 모든 실행 명령 종료 후 `lsof +D "$run_dir"` 출력 없음으로 열린 파일이 없음을 확인했다.
|
||||||
|
소유 init script를 삭제하고 `rmdir "$run_dir" && test ! -e "$run_dir"`가 exit 0으로 끝났다.
|
||||||
|
최종 출력: `REMOVED owned directory: .../papago-chunk.3apfr5/implement.j3Yd7s; shared parent and caches untouched`.
|
||||||
|
공유 캐시·부모 디렉터리·다른 작업의 프로세스는 건드리지 않았다. 커밋·staging·push·worktree·subagent는 사용하지 않았다.
|
||||||
|
|
||||||
|
### P1-GATE 부모 세션 검증 — 2026-11-09
|
||||||
|
|
||||||
|
- 초기 부모 `./gradlew ktlintCheck`는 새 테스트의 import 순서로 exit 1이었다.
|
||||||
|
구현자가 `ReflectionTestUtils` import 순서를 바로잡았고 변경 파일 검사 성공을 확인했다.
|
||||||
|
- 부모 최종 `./gradlew --no-daemon --offline test --tests 'kr.co.vividnext.sodalive.i18n.translation.*' ktlintCheck bootJar`
|
||||||
|
→ exit 0, `BUILD SUCCESSFUL in 43s`, 19개 작업 UP-TO-DATE. 캐시 확인과 실제 재실행을 구분한다.
|
||||||
|
- 부모 fresh 실행 `./gradlew --no-daemon --offline test --rerun --tests 'kr.co.vividnext.sodalive.i18n.translation.*'`
|
||||||
|
→ exit 0, `BUILD SUCCESSFUL in 57s`, `:test` 실제 실행, 다른 9개 작업 UP-TO-DATE.
|
||||||
|
- 로컬 수동 QA: Java 17 임시 `PapagoChunkQa` driver에서 실제 `PapagoTranslationService`를 생성하고,
|
||||||
|
test-only reflection으로 endpoint를 `127.0.0.1` HTTP 서버로 바꾸었다. 가짜 인증 정보만 사용했다.
|
||||||
|
JSON 요청의 길이·원문 전체 복원·POST·언어·헤더와 결과 순서를 검사했다.
|
||||||
|
초기 기존 컴파일 결과는 5,001자에서 미분할로 실패했고, 수정된 컴파일 결과는 아래 9건 모두 통과했다.
|
||||||
|
|
||||||
|
| 시나리오 | 관측 요청 길이 (UTF-16) | 결과 |
|
||||||
|
|---|---|---|
|
||||||
|
| 짧은 원문 | 5 | PASS, 결과 1개 |
|
||||||
|
| 정확히 상한 | 5000 | PASS, 결과 1개 |
|
||||||
|
| 상한 초과 | 5000, 1 | PASS, 순서대로 결합 |
|
||||||
|
| 세 조각 | 5000, 5000, 1 | PASS, 순서대로 결합 |
|
||||||
|
| 한글 | 5000, 1 | PASS, 원문 복원 |
|
||||||
|
| 경계 이모지 | 4999, 3 | PASS, 서로게이트 보존 |
|
||||||
|
| 다중 입력 | 5000, 1, 4 | PASS, 원문별 결과 2개 |
|
||||||
|
| 중간 HTTP 500 | 5000, 5000 | PASS, 빈 전체 결과·후속 호출 없음 |
|
||||||
|
| 중간 빈 번역 | 5000, 5000 | PASS, 빈 전체 결과·후속 호출 없음 |
|
||||||
|
|
||||||
|
- driver 출력: `QA PASS: 9 scenarios; all loopback servers stopped; no external API calls`.
|
||||||
|
모든 서버를 `finally`에서 `stop(0)`으로 종료했고 driver 프로세스 exit 0을 확인했다.
|
||||||
|
- 독립 리뷰 1차: PC-001~005 정적 검토 통과, 기능·보안 차단 이슈 없음.
|
||||||
|
당시 미확인이던 import 정렬과 실행 결과는 위 부모 검증으로 보완했다. 최종 확인은 별도 기록한다.
|
||||||
|
- 미검증: 도구 미제공으로 LSP 실행 불가. 전체 테스트는 사용자 실행(`./gradlew test`).
|
||||||
|
실제 Papago 번역 품질·유료 API·운영 DB·이미 FAILED인 작업 재처리는 이번 범위가 아니다.
|
||||||
|
- 커밋 방침 정정: 초기 문서의 커밋 제외는 기본 정책 적용이었으나, 현재 사용자 ULW 지시에 명시된
|
||||||
|
검증 단위 커밋 요청을 반영한다. 구현 에이전트는 커밋하지 않았고 부모 세션이 검증 후 진행한다.
|
||||||
|
- fresh XML 확인: Papago 17, Normalizer 1, Scheduler 3, Worker 7, 합계 28건 모두 실패·오류·skip 0건.
|
||||||
|
- [독립 리뷰와 부모 검증 판정](reviews/phase-1-review.md): 기능·보안 차단 사항 없음.
|
||||||
|
리뷰 세션 재연결 도구 실패로 추가 독립 승인 응답은 받지 못했다. 최초 정적 리뷰와 부모 fresh 증거를 구분해 기록했다.
|
||||||
|
- 최종 리소스 영수증: 소유 Gradle daemon PID 99003의 TMPDIR가 작업 root와 일치함을 확인한 후 종료했다.
|
||||||
|
`ps -p 99003`은 프로세스가 없음을 확인했고 `lsof +D`는 열린 파일이 없었다.
|
||||||
|
소유 `papago-chunk.3apfr5` root(로컬 driver·class·추출 라이브러리 포함)를 제거하고 `test ! -e` exit 0을 확인했다.
|
||||||
|
출력: `CLEANUP PASS: owned run root removed; owned daemon absent; loopback servers stopped`.
|
||||||
|
노트의 필요한 근거는 이 문서에 옮겼고 임시 노트도 삭제한다. 공유 캐시·다른 프로세스는 유지했다.
|
||||||
|
- 코드·테스트 커밋: `b3c9b9bb`, `fix(i18n): 파파고 번역 요청을 길이 제한에 맞춰 분할한다`.
|
||||||
|
pre-commit hook의 변경 파일 ktlint와 커밋 메시지 사전·사후 검증을 통과했다. push는 하지 않는다.
|
||||||
@@ -0,0 +1,44 @@
|
|||||||
|
# 파파고 번역 요청 길이 분할 PRD
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 상태 | 구현·기능 범위 검증 완료 |
|
||||||
|
| 작성일 | 2026-11-09 |
|
||||||
|
| 범위 승인 | 사용자: 파파고 번역만 요청당 길이 제한에 맞춰 분할 호출 |
|
||||||
|
| 구현 계획 | [plan-task.md](plan-task.md) |
|
||||||
|
|
||||||
|
## 목적과 범위
|
||||||
|
|
||||||
|
현재 `PapagoTranslationService`는 각 필드를 한 번에 전송하여 5,000자를 넘으면 번역에 실패한다.
|
||||||
|
서비스 내부에서 긴 원문을 순서대로 분할 호출하고 결과를 하나로 합쳐 기존 호출자가 그대로 사용하게 한다.
|
||||||
|
AWS 추가, 언어 감지, DB 구조, 워커 재시도 정책, 공개 API, 새 의존성은 변경하지 않는다.
|
||||||
|
|
||||||
|
## 요구사항
|
||||||
|
|
||||||
|
| ID | 요구사항과 수용 기준 |
|
||||||
|
|---|---|
|
||||||
|
| PC-001 | 각 HTTP 요청의 `text`는 최대 5,000 UTF-16 코드 단위이다. 5,000 이하는 한 번, 5,001 이상은 여러 번 호출한다. |
|
||||||
|
| PC-002 | 분할은 원문 순서와 모든 문자를 보존하며 유효한 서로게이트 쌍을 끊지 않는다. 요청 텍스트를 결합하면 원문과 정확히 같다. |
|
||||||
|
| PC-003 | 각 입력 텍스트의 번역 조각을 순서대로 구분자 없이 결합하여 기존 `TranslateResult`의 텍스트별 대응을 유지한다. |
|
||||||
|
| PC-004 | 어느 조각이든 HTTP 오류 또는 빈 번역 결과이면 부분 번역을 성공 결과로 반환하지 않는다. 기존 워커가 실패로 판단할 빈 결과를 반환하고 이후 조각은 호출하지 않는다. |
|
||||||
|
| PC-005 | 빈 입력 목록, 동일 언어, 미지원 언어의 기존 무호출 동작 및 짧은 텍스트 호출 형식을 유지한다. |
|
||||||
|
|
||||||
|
## 기술 결정과 한계
|
||||||
|
|
||||||
|
- 공식 문서는 요청당 최대 5,000 characters를 명시하지만 Unicode 계산 방식은 명시하지 않는다.
|
||||||
|
구현은 보수적으로 UTF-16 길이를 제한하고 서로게이트 경계만 조정한다.
|
||||||
|
- 길이 기준 고정 분할을 사용한다. 문장 분석, 문맥 품질 보정, 조각 캐시, 병렬 호출은 이번 범위가 아니다.
|
||||||
|
- 모든 조각 성공 후에만 기존 전체 원문 기준 번역 캐시에 저장할 수 있도록 한다.
|
||||||
|
- 분할 시 HTTP 호출 수가 증가하며 중간 실패 후 기존 워커 재시도에서는 앞선 조각도 다시 호출될 수 있다.
|
||||||
|
- 원문과 자격증명을 오류 로그나 문서에 기록하지 않는다.
|
||||||
|
|
||||||
|
## 검증 기준
|
||||||
|
|
||||||
|
- 실제 서비스의 HTTP 요청 경계에서 5,000/5,001/10,001자, 한글, 이모지, 여러 입력, 중간 오류와 빈 응답을 검증한다.
|
||||||
|
- 기존 번역 워커·스케줄러 회귀 테스트와 `bootJar`를 실행한다. 전체 테스트는 저장소 정책대로 사용자 실행이다.
|
||||||
|
- 실제 유료 Papago 호출 대신 가짜 자격증명과 로컬 HTTP 서버를 사용하며 실서비스 번역 품질 검증과 구분한다.
|
||||||
|
|
||||||
|
## 근거
|
||||||
|
|
||||||
|
- [Papago Text Translation 요청 규격](https://api.ncloud-docs.com/docs/en/ai-naver-papagonmt-translation)
|
||||||
|
- [Papago 오류 코드](https://api.ncloud-docs.com/docs/en/ai-naver-papagonmt): `N2MT08`, `text parameter exceeds max length`.
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
# 파파고 분할 번역 리뷰
|
||||||
|
|
||||||
|
## 리뷰 정보
|
||||||
|
|
||||||
|
| 항목 | 내용 |
|
||||||
|
|---|---|
|
||||||
|
| 대상 | P1-T1, 작업 트리의 서비스·테스트 변경 |
|
||||||
|
| 기준 | [PRD](../prd.md) PC-001~005, [계획](../plan-task.md) |
|
||||||
|
| 날짜 | 2026-11-09 |
|
||||||
|
| 리뷰어 | 독립 읽기 전용 에이전트, 실행 증거 확인은 부모 세션 |
|
||||||
|
| 상태 | 정적 리뷰 통과, 부모 세션 실행 검증 완료 |
|
||||||
|
|
||||||
|
## 범위와 판정
|
||||||
|
|
||||||
|
- `PapagoTranslationService.kt`: UTF-16 상한 5,000, 서로게이트 보존, 조각 순서와 원문 전체 보존을 확인했다.
|
||||||
|
- `PapagoTranslationServiceTest.kt`: 정확한 요청 JSON·헤더·순서, 5,000/5,001/10,001 경계,
|
||||||
|
한글·공백·이모지·다중 입력·HTTP 오류·빈 결과·기존 가드의 의미 있는 assertion을 확인했다.
|
||||||
|
- `TranslateRequest.kt`, `TranslationJobWorker.kt`: 기존 타입과 호출 계약을 유지하며 빈 결과는 저장 전에 실패 처리된다.
|
||||||
|
- HTTP 오류 또는 빈 조각이면 전체 빈 결과를 즉시 반환하여 앞선 입력·조각의 부분 결과가 성공으로 저장되지 않는다.
|
||||||
|
- 새 원문·인증정보 로그, 의존성, AWS·감지·DB·워커 변경은 없다.
|
||||||
|
|
||||||
|
**확정 기능·보안 차단 발견 사항 없음. 회귀 수정 Task 전환 항목 없음.**
|
||||||
|
|
||||||
|
## 실행 증거와 열린 항목 해소
|
||||||
|
|
||||||
|
| 검증 | 결과 |
|
||||||
|
|---|---|
|
||||||
|
| TDD RED | production 변경 전 17건 중 11건 assertion 실패, errors 0 |
|
||||||
|
| focused GREEN | 17건 통과 |
|
||||||
|
| 부모 fresh 번역 패키지 테스트 | `test --rerun --tests 'kr.co.vividnext.sodalive.i18n.translation.*'`, 28건 통과 |
|
||||||
|
| 로컬 HTTP QA | 실제 RestTemplate과 loopback 서버로 9개 시나리오 통과, 모든 서버 종료 |
|
||||||
|
| 정적 검사 | 초기 import 순서 오류 수정 후 변경 파일 ktlint 통과, 부모 최종 ktlintCheck 성공 |
|
||||||
|
| 빌드 | 구현 세션 bootJar 실제 생성, 부모 최종 bootJar UP-TO-DATE 성공 |
|
||||||
|
|
||||||
|
리뷰 당시 미확인이던 import 정렬과 실행 결과는 부모 세션이 최종 파일·XML·실행 출력으로 확인했다.
|
||||||
|
같은 리뷰 세션에 최종 증거를 전달하려 했으나 background continuation은 `Task not found`,
|
||||||
|
synchronous continuation은 inactivity timeout으로 응답하지 않았다. 이를 새 독립 승인으로 표기하지 않는다.
|
||||||
|
독립 정적 리뷰의 차단 사항은 없으며, 실행 증거 종결은 부모 세션 판정이다.
|
||||||
|
|
||||||
|
## 범위 밖과 한계
|
||||||
|
|
||||||
|
- 문장·문단 경계 최적화와 자동 구분자 삽입은 이번 요구 범위가 아니므로 고정 분할·무구분자 결합을 유지했다.
|
||||||
|
- 실제 유료 Papago 번역 품질과 운영 DB는 검증하지 않았다.
|
||||||
|
- LSP 도구 미제공으로 진단을 실행하지 못했다. Kotlin 컴파일과 ktlint로 보완했다.
|
||||||
|
- 전체 테스트는 저장소 정책에 따라 사용자 실행(`./gradlew test`)으로 남긴다.
|
||||||
@@ -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`다.
|
||||||
@@ -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,13 @@
|
|||||||
```
|
```
|
||||||
|
|
||||||
위 명령은 목적에 맞게 하나를 선택한다. 전체 테스트 확인만 필요하면 `./gradlew test`로 충분하다.
|
위 명령은 목적에 맞게 하나를 선택한다. 전체 테스트 확인만 필요하면 `./gradlew test`로 충분하다.
|
||||||
|
|
||||||
|
## 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
|
||||||
|
```
|
||||||
|
|||||||
@@ -9,8 +9,11 @@ import kr.co.vividnext.sodalive.aws.cloudfront.AudioContentCloudFront
|
|||||||
import kr.co.vividnext.sodalive.aws.s3.S3Uploader
|
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.i18n.translation.LanguageTranslationEvent
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
|
||||||
import kr.co.vividnext.sodalive.utils.generateFileName
|
import kr.co.vividnext.sodalive.utils.generateFileName
|
||||||
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.data.repository.findByIdOrNull
|
import org.springframework.data.repository.findByIdOrNull
|
||||||
import org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
@@ -26,6 +29,7 @@ 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 applicationEventPublisher: ApplicationEventPublisher,
|
||||||
@Value("\${cloud.aws.s3.bucket}")
|
@Value("\${cloud.aws.s3.bucket}")
|
||||||
private val bucket: String
|
private val bucket: String
|
||||||
) {
|
) {
|
||||||
@@ -158,6 +162,16 @@ class AdminContentService(
|
|||||||
}
|
}
|
||||||
audioContent.settlementRatio = request.settlementRatio
|
audioContent.settlementRatio = request.settlementRatio
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (request.title != null || request.detail != null) {
|
||||||
|
applicationEventPublisher.publishEvent(
|
||||||
|
LanguageTranslationEvent(
|
||||||
|
id = request.id,
|
||||||
|
targetType = LanguageTranslationTargetType.CONTENT,
|
||||||
|
waitTransactionCommit = true
|
||||||
|
)
|
||||||
|
)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
fun getContentMainTabList(): List<GetContentMainTabItem> {
|
fun getContentMainTabList(): List<GetContentMainTabItem> {
|
||||||
|
|||||||
+2
-2
@@ -167,7 +167,7 @@ class AdminEventBannerService(
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
if (event.link != link) {
|
if (link != null && event.link != link) {
|
||||||
event.link = if (link.isNullOrBlank()) null else link
|
event.link = if (link.isNullOrBlank()) null else link
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -179,7 +179,7 @@ class AdminEventBannerService(
|
|||||||
event.isPopup = isPopup
|
event.isPopup = isPopup
|
||||||
}
|
}
|
||||||
|
|
||||||
if (isAdult != event.isAdult) {
|
if (isAdult != null && isAdult != event.isAdult) {
|
||||||
event.isAdult = isAdult
|
event.isAdult = isAdult
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
+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
|
||||||
|
|||||||
+144
@@ -0,0 +1,144 @@
|
|||||||
|
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.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 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 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(contentId: Long, targetLanguage: String): AudioContentDetailTranslationResult {
|
||||||
|
var source = transaction.execute { snapshot(contentId) } ?: return AudioContentDetailTranslationResult(null)
|
||||||
|
if (source.languageCode.isNullOrBlank()) {
|
||||||
|
val beforeDetection = source
|
||||||
|
try {
|
||||||
|
val detected = detector.detectWithCache(source.query)?.detectedLanguage
|
||||||
|
?: return AudioContentDetailTranslationResult(source.languageCode, detectionQuery = source.query)
|
||||||
|
source = transaction.execute {
|
||||||
|
val content = entityManager.find(AudioContent::class.java, contentId, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
?: return@execute null
|
||||||
|
val current = snapshot(contentId) ?: return@execute null
|
||||||
|
if (current == beforeDetection) content.languageCode = detected
|
||||||
|
snapshot(contentId)
|
||||||
|
} ?: return AudioContentDetailTranslationResult(null)
|
||||||
|
} catch (ex: Exception) {
|
||||||
|
log.warn("Content detail language detection failed. contentId={}, error={}", contentId, ex.message)
|
||||||
|
return AudioContentDetailTranslationResult(source.languageCode, detectionQuery = source.query)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
val language = source.languageCode
|
||||||
|
if (language.isNullOrBlank()) return AudioContentDetailTranslationResult(language, detectionQuery = source.query)
|
||||||
|
val target = targetLanguage.lowercase()
|
||||||
|
if (
|
||||||
|
!TranslationLanguages.isSupported(language) || !TranslationLanguages.isSupported(target) ||
|
||||||
|
language.lowercase() == target
|
||||||
|
) {
|
||||||
|
return AudioContentDetailTranslationResult(language)
|
||||||
|
}
|
||||||
|
|
||||||
|
val existing = transaction.execute { translations.findByContentIdAndLocale(contentId, target)?.renderedPayload }
|
||||||
|
if (existing != null) {
|
||||||
|
maintainRetries(contentId, target, scheduleMissing = false)
|
||||||
|
return result(language, existing)
|
||||||
|
}
|
||||||
|
|
||||||
|
return try {
|
||||||
|
source.fields.forEach { field ->
|
||||||
|
memories.ensureMemory(LanguageTranslationTargetType.CONTENT, field.fieldKey, field.sourceText, language, target)
|
||||||
|
}
|
||||||
|
val payload = transaction.execute {
|
||||||
|
entityManager.find(AudioContent::class.java, contentId, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
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): DetailSource? {
|
||||||
|
val content = repository.findById(contentId).orElse(null) ?: return null
|
||||||
|
val tags = content.audioContentHashTags.filter { it.isActive }.mapNotNull { it.hashTag?.tag }
|
||||||
|
return DetailSource(
|
||||||
|
content.languageCode,
|
||||||
|
listOf(
|
||||||
|
TranslationSourceField("title", content.title),
|
||||||
|
TranslationSourceField("detail", content.detail),
|
||||||
|
TranslationSourceField("tags", tags.joinToString(","))
|
||||||
|
),
|
||||||
|
listOf(content.title.trim(), content.detail.trim(), tags.joinToString(" ").trim())
|
||||||
|
.filter { it.isNotBlank() }.joinToString(" ")
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
private data class DetailSource(val languageCode: String?, val fields: List<TranslationSourceField>, val query: String)
|
||||||
|
}
|
||||||
@@ -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,7 +33,6 @@ 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
|
||||||
@@ -43,15 +41,20 @@ import kr.co.vividnext.sodalive.utils.generateFileName
|
|||||||
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 +81,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 +96,8 @@ 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,
|
||||||
|
transactionManager: PlatformTransactionManager,
|
||||||
|
|
||||||
@Value("\${cloud.aws.s3.content-bucket}")
|
@Value("\${cloud.aws.s3.content-bucket}")
|
||||||
private val audioContentBucket: String,
|
private val audioContentBucket: String,
|
||||||
@@ -104,6 +109,9 @@ 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
|
||||||
|
}
|
||||||
|
|
||||||
@Transactional
|
@Transactional
|
||||||
fun audioContentLike(request: PutAudioContentLikeRequest, member: Member): PutAudioContentLikeResponse {
|
fun audioContentLike(request: PutAudioContentLikeRequest, member: Member): PutAudioContentLikeResponse {
|
||||||
@@ -220,7 +228,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 +253,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,115 +268,118 @@ class AudioContentService(
|
|||||||
throw SodaException(messageKey = "content.error.content_required")
|
throw SodaException(messageKey = "content.error.content_required")
|
||||||
}
|
}
|
||||||
|
|
||||||
validatePreviewTime(request.previewStartTime, request.previewEndTime)
|
val registration = requireNotNull(
|
||||||
|
registrationTransaction.execute {
|
||||||
|
validatePreviewTime(request.previewStartTime, request.previewEndTime)
|
||||||
|
|
||||||
// 테마 체크
|
// 테마 체크
|
||||||
val theme = themeQueryRepository.findThemeByIdAndActive(id = request.themeId)
|
val theme = themeQueryRepository.findThemeByIdAndActive(id = request.themeId)
|
||||||
?: throw SodaException(messageKey = "content.error.invalid_theme")
|
?: throw SodaException(messageKey = "content.error.invalid_theme")
|
||||||
|
|
||||||
if ((request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) && request.price < 5) {
|
if ((request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) && request.price < 5) {
|
||||||
throw SodaException(messageKey = "content.error.alarm_theme_price_min")
|
throw SodaException(messageKey = "content.error.alarm_theme_price_min")
|
||||||
}
|
}
|
||||||
|
|
||||||
if (request.price in 1..4) throw SodaException(messageKey = "content.error.minimum_price")
|
if (request.price in 1..4) throw SodaException(messageKey = "content.error.minimum_price")
|
||||||
|
|
||||||
val isFullDetailVisible = if (request.price >= 50) {
|
val isFullDetailVisible = if (request.price >= 50) {
|
||||||
request.isFullDetailVisible
|
request.isFullDetailVisible
|
||||||
} else {
|
} else {
|
||||||
true
|
true
|
||||||
}
|
}
|
||||||
|
|
||||||
val purchaseOption = if (request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) {
|
val purchaseOption = if (request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) {
|
||||||
PurchaseOption.BUY_ONLY
|
PurchaseOption.BUY_ONLY
|
||||||
} else {
|
} else {
|
||||||
request.purchaseOption
|
request.purchaseOption
|
||||||
}
|
}
|
||||||
|
|
||||||
val isOnlyRental = if (
|
val isOnlyRental = if (
|
||||||
(request.limited != null && request.limited > 0) ||
|
(request.limited != null && request.limited > 0) ||
|
||||||
purchaseOption == PurchaseOption.BUY_ONLY
|
purchaseOption == PurchaseOption.BUY_ONLY
|
||||||
) {
|
) {
|
||||||
false
|
false
|
||||||
} else if (request.purchaseOption == PurchaseOption.RENT_ONLY) {
|
} else if (request.purchaseOption == PurchaseOption.RENT_ONLY) {
|
||||||
true
|
true
|
||||||
} else {
|
} else {
|
||||||
request.isOnlyRental
|
request.isOnlyRental
|
||||||
}
|
}
|
||||||
|
|
||||||
// DB에 값 추가
|
// DB에 값 추가
|
||||||
val audioContent = AudioContent(
|
val audioContent = AudioContent(
|
||||||
title = request.title.trim(),
|
title = request.title.trim(),
|
||||||
detail = request.detail.trim(),
|
detail = request.detail.trim(),
|
||||||
languageCode = request.languageCode,
|
languageCode = request.languageCode,
|
||||||
price = if (request.price > 0) {
|
price = if (request.price > 0) {
|
||||||
request.price
|
request.price
|
||||||
} else {
|
|
||||||
0
|
|
||||||
},
|
|
||||||
releaseDate = releaseDate,
|
|
||||||
limited = request.limited,
|
|
||||||
remaining = request.limited,
|
|
||||||
isAdult = request.isAdult,
|
|
||||||
purchaseOption = purchaseOption,
|
|
||||||
isGeneratePreview = request.isGeneratePreview,
|
|
||||||
isOnlyRental = isOnlyRental,
|
|
||||||
isPointAvailable = request.isPointAvailable,
|
|
||||||
isCommentAvailable = request.isCommentAvailable,
|
|
||||||
isFullDetailVisible = isFullDetailVisible
|
|
||||||
)
|
|
||||||
audioContent.theme = theme
|
|
||||||
audioContent.member = member
|
|
||||||
repository.save(audioContent)
|
|
||||||
|
|
||||||
// 태그 분리, #추가, 등록
|
|
||||||
if (request.tags.isNotBlank()) {
|
|
||||||
val tags = request.tags
|
|
||||||
.replace("#", " #")
|
|
||||||
.split(" ")
|
|
||||||
.asSequence()
|
|
||||||
.map { it.trim() }
|
|
||||||
.filter { it.isNotBlank() }
|
|
||||||
.map {
|
|
||||||
val tag = if (!it.startsWith("#")) {
|
|
||||||
"#$it"
|
|
||||||
} else {
|
} else {
|
||||||
it
|
0
|
||||||
}
|
},
|
||||||
|
releaseDate = releaseDate,
|
||||||
|
limited = request.limited,
|
||||||
|
remaining = request.limited,
|
||||||
|
isAdult = request.isAdult,
|
||||||
|
purchaseOption = purchaseOption,
|
||||||
|
isGeneratePreview = request.isGeneratePreview,
|
||||||
|
isOnlyRental = isOnlyRental,
|
||||||
|
isPointAvailable = request.isPointAvailable,
|
||||||
|
isCommentAvailable = request.isCommentAvailable,
|
||||||
|
isFullDetailVisible = isFullDetailVisible
|
||||||
|
)
|
||||||
|
audioContent.theme = theme
|
||||||
|
audioContent.member = member
|
||||||
|
repository.save(audioContent)
|
||||||
|
|
||||||
val hashTag = hashTagRepository.findByTag(tag)
|
// 태그 분리, #추가, 등록
|
||||||
?: hashTagRepository.save(HashTag(tag))
|
if (request.tags.isNotBlank()) {
|
||||||
|
val tags = request.tags
|
||||||
|
.replace("#", " #")
|
||||||
|
.split(" ")
|
||||||
|
.asSequence()
|
||||||
|
.map { it.trim() }
|
||||||
|
.filter { it.isNotBlank() }
|
||||||
|
.map {
|
||||||
|
val tag = if (!it.startsWith("#")) {
|
||||||
|
"#$it"
|
||||||
|
} else {
|
||||||
|
it
|
||||||
|
}
|
||||||
|
|
||||||
val audioContentHashTag = AudioContentHashTag()
|
val hashTag = hashTagRepository.findByTag(tag)
|
||||||
audioContentHashTag.audioContent = audioContent
|
?: hashTagRepository.save(HashTag(tag))
|
||||||
audioContentHashTag.hashTag = hashTag
|
|
||||||
|
|
||||||
audioContentHashTag
|
val audioContentHashTag = AudioContentHashTag()
|
||||||
}.toList()
|
audioContentHashTag.audioContent = audioContent
|
||||||
|
audioContentHashTag.hashTag = hashTag
|
||||||
|
|
||||||
audioContent.audioContentHashTags.addAll(tags)
|
audioContentHashTag
|
||||||
}
|
}.toList()
|
||||||
|
|
||||||
var metadata = ObjectMetadata()
|
audioContent.audioContentHashTags.addAll(tags)
|
||||||
metadata.contentLength = coverImage.size
|
}
|
||||||
|
|
||||||
// 커버 이미지 파일명 생성
|
val metadata = ObjectMetadata()
|
||||||
val coverImageFileName = generateFileName(prefix = "${audioContent.id}-cover")
|
metadata.contentLength = coverImage.size
|
||||||
|
|
||||||
// 커버 이미지 업로드
|
// 커버 이미지 파일명 생성
|
||||||
val coverImagePath = s3Uploader.upload(
|
val coverImageFileName = generateFileName(prefix = "${audioContent.id}-cover")
|
||||||
inputStream = coverImage.inputStream,
|
|
||||||
bucket = coverImageBucket,
|
// 커버 이미지 업로드
|
||||||
filePath = "audio_content_cover/${audioContent.id}/$coverImageFileName",
|
val coverImagePath = s3Uploader.upload(
|
||||||
metadata = metadata
|
inputStream = coverImage.inputStream,
|
||||||
|
bucket = coverImageBucket,
|
||||||
|
filePath = "audio_content_cover/${audioContent.id}/$coverImageFileName",
|
||||||
|
metadata = metadata
|
||||||
|
)
|
||||||
|
|
||||||
|
audioContent.coverImage = coverImagePath
|
||||||
|
audioContent to subtitleJobService.register(audioContent, contentFile.originalFilename)
|
||||||
|
}
|
||||||
)
|
)
|
||||||
|
val (audioContent, subtitleJob) = registration
|
||||||
audioContent.coverImage = coverImagePath
|
|
||||||
|
|
||||||
// 콘텐츠 파일명 생성
|
|
||||||
val contentFileName = generateFileName(prefix = "${audioContent.id}-content")
|
|
||||||
|
|
||||||
// 콘텐츠 파일 업로드
|
// 콘텐츠 파일 업로드
|
||||||
metadata = ObjectMetadata()
|
val metadata = ObjectMetadata()
|
||||||
metadata.contentLength = contentFile.size
|
metadata.contentLength = contentFile.size
|
||||||
metadata.addUserMetadata(
|
metadata.addUserMetadata(
|
||||||
"generate_preview",
|
"generate_preview",
|
||||||
@@ -384,38 +395,45 @@ 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 ->
|
||||||
bucket = audioContentBucket,
|
s3Uploader.upload(
|
||||||
filePath = "input/${audioContent.id}/$contentFileName",
|
inputStream = inputStream,
|
||||||
metadata = metadata
|
bucket = audioContentBucket,
|
||||||
)
|
filePath = subtitleJob.sourceKey,
|
||||||
|
metadata = metadata
|
||||||
audioContent.content = contentPath
|
|
||||||
|
|
||||||
// 언어 코드가 지정되지 않은 경우, 파파고 언어 감지 API를 통해 비동기로 언어를 식별한다.
|
|
||||||
if (audioContent.languageCode.isNullOrBlank()) {
|
|
||||||
val papagoQuery = listOf(
|
|
||||||
request.title.trim(),
|
|
||||||
request.detail.trim(),
|
|
||||||
request.tags.trim()
|
|
||||||
)
|
|
||||||
.filter { it.isNotBlank() }
|
|
||||||
.joinToString(" ")
|
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
|
||||||
LanguageDetectEvent(
|
|
||||||
id = audioContent.id!!,
|
|
||||||
query = papagoQuery
|
|
||||||
)
|
)
|
||||||
)
|
}
|
||||||
} else {
|
} catch (exception: Exception) {
|
||||||
applicationEventPublisher.publishEvent(
|
subtitleJobService.recordUploadError(subtitleJob.jobId)
|
||||||
LanguageTranslationEvent(
|
throw exception
|
||||||
id = audioContent.id!!,
|
}
|
||||||
targetType = LanguageTranslationTargetType.CONTENT
|
|
||||||
|
registrationTransaction.executeWithoutResult {
|
||||||
|
// 언어 코드가 지정되지 않은 경우, 파파고 언어 감지 API를 통해 비동기로 언어를 식별한다.
|
||||||
|
if (audioContent.languageCode.isNullOrBlank()) {
|
||||||
|
val papagoQuery = listOf(
|
||||||
|
request.title.trim(),
|
||||||
|
request.detail.trim(),
|
||||||
|
request.tags.trim()
|
||||||
)
|
)
|
||||||
)
|
.filter { it.isNotBlank() }
|
||||||
|
.joinToString(" ")
|
||||||
|
|
||||||
|
applicationEventPublisher.publishEvent(
|
||||||
|
LanguageDetectEvent(
|
||||||
|
id = audioContent.id!!,
|
||||||
|
query = papagoQuery
|
||||||
|
)
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
applicationEventPublisher.publishEvent(
|
||||||
|
LanguageTranslationEvent(
|
||||||
|
id = audioContent.id!!,
|
||||||
|
targetType = LanguageTranslationTargetType.CONTENT
|
||||||
|
)
|
||||||
|
)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return CreateAudioContentResponse(contentId = audioContent.id!!)
|
return CreateAudioContentResponse(contentId = audioContent.id!!)
|
||||||
@@ -481,8 +499,9 @@ 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")
|
||||||
@@ -781,6 +800,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,44 +891,14 @@ 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
|
|
||||||
)
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -933,7 +940,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 +960,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 +981,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 +1321,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)
|
||||||
resourcePath = audioContent.content!!,
|
GenerateUrlResponse(
|
||||||
expirationTime = 1000 * 60 * 60 * (audioContent.duration!!.split(":")[0].toLong() + 2)
|
contentUrl = audioContentCloudFront.generateSignedURL(
|
||||||
|
resourcePath = audioContent.content!!,
|
||||||
|
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,17 +8,12 @@ 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.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.annotation.Propagation
|
import org.springframework.transaction.annotation.Propagation
|
||||||
@@ -27,13 +22,11 @@ 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.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,10 +49,6 @@ 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 audioContentRepository: AudioContentRepository,
|
||||||
@@ -74,28 +63,17 @@ 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,
|
|
||||||
|
|
||||||
@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 restTemplate: RestTemplate = RestTemplate()
|
|
||||||
|
|
||||||
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.REQUIRES_NEW)
|
||||||
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
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -117,34 +95,32 @@ class LanguageDetectListener(
|
|||||||
|
|
||||||
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
|
||||||
)
|
)
|
||||||
@@ -155,36 +131,34 @@ class LanguageDetectListener(
|
|||||||
|
|
||||||
val audioContent = audioContentRepository.findById(contentId).orElse(null)
|
val audioContent = audioContentRepository.findById(contentId).orElse(null)
|
||||||
if (audioContent == null) {
|
if (audioContent == null) {
|
||||||
log.warn("[PapagoLanguageDetect] AudioContent not found. contentId={}", contentId)
|
log.warn("[LanguageDetect] AudioContent not found. contentId={}", contentId)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||||
if (!audioContent.languageCode.isNullOrBlank()) {
|
if (!audioContent.languageCode.isNullOrBlank()) {
|
||||||
log.debug(
|
log.debug(
|
||||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. contentId={}, languageCode={}",
|
"[LanguageDetect] languageCode already set. Skip language detection. contentId={}, languageCode={}",
|
||||||
contentId,
|
contentId,
|
||||||
audioContent.languageCode
|
audioContent.languageCode
|
||||||
)
|
)
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
val langCode = detectLanguageCode(event, contentId) ?: return
|
val langCode = detectLanguageCode(event) ?: return
|
||||||
|
|
||||||
audioContent.languageCode = langCode
|
audioContent.languageCode = langCode
|
||||||
|
|
||||||
// REQUIRES_NEW 트랜잭션 내에서 변경 내용을 저장한다.
|
// REQUIRES_NEW 트랜잭션 내에서 변경 내용을 저장한다.
|
||||||
audioContentRepository.save(audioContent)
|
audioContentRepository.save(audioContent)
|
||||||
|
|
||||||
applicationEventPublisher.publishEvent(
|
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||||
LanguageTranslationEvent(
|
resourceType = LanguageTranslationTargetType.CONTENT,
|
||||||
id = contentId,
|
resourceId = contentId
|
||||||
targetType = LanguageTranslationTargetType.CONTENT
|
|
||||||
)
|
|
||||||
)
|
)
|
||||||
|
|
||||||
log.info(
|
log.info(
|
||||||
"[PapagoLanguageDetect] languageCode updated from Papago. contentId={}, langCode={}",
|
"[LanguageDetect] languageCode updated. contentId={}, langCode={}",
|
||||||
contentId,
|
contentId,
|
||||||
langCode
|
langCode
|
||||||
)
|
)
|
||||||
@@ -195,27 +169,27 @@ class LanguageDetectListener(
|
|||||||
|
|
||||||
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 +200,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 +215,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 +232,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 +263,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 +299,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 +336,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 +362,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 +394,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,64 @@
|
|||||||
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 org.springframework.stereotype.Service
|
import org.springframework.stereotype.Service
|
||||||
import org.springframework.transaction.annotation.Transactional
|
import org.springframework.transaction.annotation.Transactional
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
class LanguageDetectionCacheService(
|
class LanguageDetectionCacheService(
|
||||||
private val languageDetectionResultRepository: LanguageDetectionResultRepository
|
private val languageDetectionResultRepository: LanguageDetectionResultRepository,
|
||||||
|
providers: List<LanguageDetectionProvider>,
|
||||||
|
properties: LanguageProviderProperties
|
||||||
) {
|
) {
|
||||||
|
private val providers = properties.orderedProviders(properties.detectionOrder, providers) { it.providerId }
|
||||||
|
|
||||||
@Transactional
|
@Transactional
|
||||||
fun detectWithCache(
|
fun detectWithCache(query: String): DetectedLanguage? {
|
||||||
query: String,
|
|
||||||
provider: String = DEFAULT_PROVIDER,
|
|
||||||
detector: () -> String?
|
|
||||||
): String? {
|
|
||||||
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 ->
|
||||||
sourceHash = sourceHash,
|
val cached = languageDetectionResultRepository.findBySourceHashAndProviderAndNormalizationVersion(
|
||||||
provider = provider,
|
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
|
||||||
)
|
|
||||||
if (cached != null) return cached.detectedLanguage
|
|
||||||
|
|
||||||
val detectedLanguage = detector()?.takeIf { it.isNotBlank() }?.lowercase() ?: return null
|
|
||||||
languageDetectionResultRepository.insertIfAbsent(
|
|
||||||
sourceHash = sourceHash,
|
|
||||||
sourceTextSample = normalizedQuery.take(MAX_SAMPLE_LENGTH),
|
|
||||||
detectedLanguage = detectedLanguage,
|
|
||||||
provider = provider,
|
|
||||||
confidence = null,
|
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
|
||||||
)
|
|
||||||
return requireNotNull(
|
|
||||||
languageDetectionResultRepository.findDetectedLanguageForUpdate(
|
|
||||||
sourceHash = sourceHash,
|
sourceHash = sourceHash,
|
||||||
provider = provider,
|
provider = provider.providerId.code,
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
)
|
)
|
||||||
)
|
if (cached != null && cached.detectedLanguage.isNotBlank()) {
|
||||||
|
return DetectedLanguage(cached.detectedLanguage, provider.providerId)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
providers.forEach { provider ->
|
||||||
|
val detectedLanguage = try {
|
||||||
|
provider.detect(query)
|
||||||
|
} catch (_: Exception) {
|
||||||
|
null
|
||||||
|
}?.takeIf { it.isNotBlank() }?.lowercase() ?: return@forEach
|
||||||
|
languageDetectionResultRepository.insertIfAbsent(
|
||||||
|
sourceHash = sourceHash,
|
||||||
|
sourceTextSample = normalizedQuery.take(MAX_SAMPLE_LENGTH),
|
||||||
|
detectedLanguage = detectedLanguage,
|
||||||
|
provider = provider.providerId.code,
|
||||||
|
confidence = null,
|
||||||
|
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
|
)
|
||||||
|
val winner = requireNotNull(
|
||||||
|
languageDetectionResultRepository.findDetectedLanguageForUpdate(
|
||||||
|
sourceHash = sourceHash,
|
||||||
|
provider = provider.providerId.code,
|
||||||
|
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
||||||
|
)
|
||||||
|
)
|
||||||
|
return DetectedLanguage(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 translated = translation.translated?.let {
|
||||||
val existing = seriesTranslationRepository.findBySeriesIdAndLocale(seriesId = seriesId, locale = locale)
|
it.copy(keywords = it.keywords.ifEmpty { keywordList })
|
||||||
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
|
|
||||||
)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// 장르 번역 조회 (있으면 반환)
|
// 장르 번역 조회 (있으면 반환)
|
||||||
|
|||||||
@@ -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 {
|
||||||
|
|||||||
+11
@@ -1,9 +1,20 @@
|
|||||||
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)
|
||||||
|
@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>
|
||||||
}
|
}
|
||||||
|
|||||||
+2
@@ -199,7 +199,9 @@ class CreatorAdminContentService(
|
|||||||
}
|
}
|
||||||
|
|
||||||
audioContent.audioContentHashTags.addAll(newAudioContentHashTagList)
|
audioContent.audioContentHashTags.addAll(newAudioContentHashTagList)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (request.title != null || request.detail != null || !request.tags.isNullOrBlank()) {
|
||||||
applicationEventPublisher.publishEvent(
|
applicationEventPublisher.publishEvent(
|
||||||
LanguageTranslationEvent(
|
LanguageTranslationEvent(
|
||||||
id = request.id,
|
id = request.id,
|
||||||
|
|||||||
@@ -228,7 +228,7 @@ class EventService(
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
if (event.link != link) {
|
if (link != null && event.link != link) {
|
||||||
event.link = link
|
event.link = link
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -240,7 +240,7 @@ class EventService(
|
|||||||
event.isPopup = isPopup
|
event.isPopup = isPopup
|
||||||
}
|
}
|
||||||
|
|
||||||
if (isAdult != event.isAdult) {
|
if (isAdult != null && isAdult != event.isAdult) {
|
||||||
event.isAdult = isAdult
|
event.isAdult = isAdult
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
+27
@@ -0,0 +1,27 @@
|
|||||||
|
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? {
|
||||||
|
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).build()
|
||||||
|
client.detectDominantLanguage(request).languages().firstOrNull()?.languageCode()?.takeIf { it.isNotBlank() }
|
||||||
|
} catch (_: Exception) {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
private const val MAX_REQUEST_TEXT_BYTES = 100000
|
||||||
|
}
|
||||||
|
}
|
||||||
+32
@@ -0,0 +1,32 @@
|
|||||||
|
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)
|
||||||
|
.build()
|
||||||
|
|
||||||
|
@Bean(destroyMethod = "close")
|
||||||
|
fun translateClient(): TranslateClient = TranslateClient.builder()
|
||||||
|
.credentialsProvider(credentialsProvider)
|
||||||
|
.region(region)
|
||||||
|
.build()
|
||||||
|
}
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
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 sdkRequest = TranslateTextRequest.builder()
|
||||||
|
.sourceLanguageCode(request.sourceLanguage)
|
||||||
|
.targetLanguageCode(request.targetLanguage)
|
||||||
|
.text(chunk)
|
||||||
|
.build()
|
||||||
|
val translated = client.translateText(sdkRequest)?.translatedText()
|
||||||
|
if (translated.isNullOrBlank()) return TranslateResult(emptyList())
|
||||||
|
translatedText.append(translated)
|
||||||
|
}
|
||||||
|
translatedTexts.add(translatedText.toString())
|
||||||
|
}
|
||||||
|
} catch (_: Exception) {
|
||||||
|
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)
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
package kr.co.vividnext.sodalive.i18n.translation
|
||||||
|
|
||||||
|
interface LanguageDetectionProvider {
|
||||||
|
val providerId: LanguageProviderId
|
||||||
|
|
||||||
|
fun detect(query: String): String?
|
||||||
|
}
|
||||||
@@ -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) }
|
||||||
|
}
|
||||||
|
}
|
||||||
+38
@@ -0,0 +1,38 @@
|
|||||||
|
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
|
||||||
|
) : LanguageDetectionProvider {
|
||||||
|
private val restTemplate = RestTemplate()
|
||||||
|
override val providerId = LanguageProviderId.PAPAGO
|
||||||
|
|
||||||
|
override fun detect(query: String): 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) }
|
||||||
|
val response = restTemplate.postForEntity(
|
||||||
|
"https://papago.apigw.ntruss.com/langs/v1/dect",
|
||||||
|
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?)
|
||||||
+29
-37
@@ -20,7 +20,7 @@ class PapagoTranslationService(
|
|||||||
|
|
||||||
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"
|
||||||
|
|
||||||
@@ -43,57 +43,49 @@ class PapagoTranslationService(
|
|||||||
|
|
||||||
request.texts.forEach { text ->
|
request.texts.forEach { text ->
|
||||||
try {
|
try {
|
||||||
val body = mapOf(
|
val translatedText = StringBuilder()
|
||||||
"source" to request.sourceLanguage,
|
for (chunk in splitText(text)) {
|
||||||
"target" to request.targetLanguage,
|
val body = mapOf(
|
||||||
"text" to text
|
"source" to request.sourceLanguage,
|
||||||
)
|
"target" to request.targetLanguage,
|
||||||
|
"text" to chunk
|
||||||
|
)
|
||||||
|
|
||||||
val requestEntity = HttpEntity(body, headers)
|
val requestEntity = HttpEntity(body, headers)
|
||||||
|
|
||||||
val response = restTemplate.postForEntity<PapagoTranslationResponse>(
|
val response = restTemplate.postForEntity<PapagoTranslationResponse>(
|
||||||
papagoTranslateUrl,
|
papagoTranslateUrl,
|
||||||
requestEntity
|
requestEntity
|
||||||
)
|
)
|
||||||
|
|
||||||
if (!response.statusCode.is2xxSuccessful) {
|
if (!response.statusCode.is2xxSuccessful) {
|
||||||
return@forEach
|
return TranslateResult(emptyList())
|
||||||
|
}
|
||||||
|
|
||||||
|
val translated = response.body?.message?.result?.translatedText
|
||||||
|
if (translated.isNullOrBlank()) {
|
||||||
|
return TranslateResult(emptyList())
|
||||||
|
}
|
||||||
|
translatedText.append(translated)
|
||||||
}
|
}
|
||||||
|
translatedTexts.add(translatedText.toString())
|
||||||
val translated = response.body?.message?.result?.translatedText
|
|
||||||
translatedTexts.add(translated ?: "")
|
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
|
return TranslateResult(emptyList())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return TranslateResult(translatedTexts)
|
return TranslateResult(translatedTexts)
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun validateLanguages(sourceLanguage: String, targetLanguage: String): Boolean {
|
private fun splitText(text: String): List<String> {
|
||||||
return requireSupportedLanguage(sourceLanguage) && requireSupportedLanguage(targetLanguage)
|
return splitTextByCodePoint(text, MAX_REQUEST_TEXT_LENGTH, Character::charCount)
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun requireSupportedLanguage(language: String): Boolean {
|
private fun validateLanguages(sourceLanguage: String, targetLanguage: String): Boolean {
|
||||||
val normalized = language.lowercase()
|
return TranslationLanguages.isSupported(sourceLanguage) && TranslationLanguages.isSupported(targetLanguage)
|
||||||
return SUPPORTED_LANGUAGE_CODES.contains(normalized)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
private val SUPPORTED_LANGUAGE_CODES = setOf(
|
private const val MAX_REQUEST_TEXT_LENGTH = 5000
|
||||||
"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,8 @@ 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
|
||||||
)
|
)
|
||||||
|
|
||||||
data class TranslateResult(
|
data class TranslateResult(
|
||||||
|
|||||||
@@ -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")
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,6 +1,7 @@
|
|||||||
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.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
|
||||||
@@ -14,6 +15,58 @@ interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
|||||||
sourceHash: String
|
sourceHash: String
|
||||||
): TranslationJob?
|
): 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.fieldKey = 'tags'
|
||||||
|
and j.status = kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus.COMPLETED
|
||||||
|
"""
|
||||||
|
)
|
||||||
|
fun restartCompletedContentTagsJob(@Param("jobId") jobId: Long, @Param("now") now: LocalDateTime): Int
|
||||||
|
|
||||||
@Query(
|
@Query(
|
||||||
"""
|
"""
|
||||||
select j from TranslationJob j
|
select j from TranslationJob j
|
||||||
|
|||||||
+37
-7
@@ -1,12 +1,15 @@
|
|||||||
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
|
||||||
|
|
||||||
@Service
|
@Service
|
||||||
class TranslationJobScheduler(
|
class TranslationJobScheduler(
|
||||||
private val translationJobRepository: TranslationJobRepository
|
private val translationJobRepository: TranslationJobRepository,
|
||||||
|
private val translationCoordinator: TranslationCoordinator,
|
||||||
|
private val contentTranslationRepository: ContentTranslationRepository
|
||||||
) {
|
) {
|
||||||
@Transactional
|
@Transactional
|
||||||
fun scheduleMissingTranslation(
|
fun scheduleMissingTranslation(
|
||||||
@@ -21,7 +24,7 @@ class TranslationJobScheduler(
|
|||||||
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
|
||||||
@@ -34,7 +37,38 @@ class TranslationJobScheduler(
|
|||||||
targetLanguage = normalizedTargetLanguage,
|
targetLanguage = normalizedTargetLanguage,
|
||||||
sourceHash = sourceHash
|
sourceHash = sourceHash
|
||||||
)
|
)
|
||||||
if (existingJob != null) return
|
if (existingJob != null) {
|
||||||
|
if (existingJob.sourceLanguage != normalizedSourceLanguage) 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.restartCompletedContentTagsJob(requireNotNull(existingJob.id), LocalDateTime.now())
|
||||||
|
}
|
||||||
|
TranslationJobStatus.PENDING, TranslationJobStatus.RUNNING -> Unit
|
||||||
|
}
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
translationJobRepository.save(
|
translationJobRepository.save(
|
||||||
TranslationJob(
|
TranslationJob(
|
||||||
@@ -49,8 +83,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,7 +33,13 @@ class TranslationJobWorker(
|
|||||||
val failedJobs = mutableListOf<Pair<TranslationJob, Exception>>()
|
val failedJobs = mutableListOf<Pair<TranslationJob, Exception>>()
|
||||||
jobs.forEach { job ->
|
jobs.forEach { job ->
|
||||||
try {
|
try {
|
||||||
ensureMemory(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)
|
||||||
@@ -68,52 +73,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 +88,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 +109,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
|
||||||
|
|||||||
+13
-14
@@ -6,6 +6,7 @@ import kr.co.vividnext.sodalive.chat.character.translate.AiCharacterTranslationR
|
|||||||
import kr.co.vividnext.sodalive.chat.original.translation.OriginalWorkTranslation
|
import kr.co.vividnext.sodalive.chat.original.translation.OriginalWorkTranslation
|
||||||
import kr.co.vividnext.sodalive.chat.original.translation.OriginalWorkTranslationPayload
|
import kr.co.vividnext.sodalive.chat.original.translation.OriginalWorkTranslationPayload
|
||||||
import kr.co.vividnext.sodalive.chat.original.translation.OriginalWorkTranslationRepository
|
import kr.co.vividnext.sodalive.chat.original.translation.OriginalWorkTranslationRepository
|
||||||
|
import kr.co.vividnext.sodalive.content.AudioContent
|
||||||
import kr.co.vividnext.sodalive.content.category.CategoryTranslation
|
import kr.co.vividnext.sodalive.content.category.CategoryTranslation
|
||||||
import kr.co.vividnext.sodalive.content.category.CategoryTranslationRepository
|
import kr.co.vividnext.sodalive.content.category.CategoryTranslationRepository
|
||||||
import kr.co.vividnext.sodalive.content.series.translation.SeriesGenreTranslation
|
import kr.co.vividnext.sodalive.content.series.translation.SeriesGenreTranslation
|
||||||
@@ -18,6 +19,7 @@ import kr.co.vividnext.sodalive.content.theme.translation.ContentThemeTranslatio
|
|||||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslation
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslation
|
||||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslationPayload
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslationPayload
|
||||||
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.Series
|
||||||
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
||||||
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.CreatorCommunityTranslation
|
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.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
|
||||||
@@ -29,7 +31,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 contentTranslationRepository: ContentTranslationRepository,
|
||||||
private val aiCharacterTranslationRepository: AiCharacterTranslationRepository,
|
private val aiCharacterTranslationRepository: AiCharacterTranslationRepository,
|
||||||
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
||||||
@@ -71,14 +73,13 @@ 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,
|
rejectUnchangedAwsResult = source.resourceType == LanguageTranslationTargetType.CONTENT &&
|
||||||
provider = DEFAULT_PROVIDER,
|
field.fieldKey == "tags"
|
||||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
) ?: return null
|
||||||
) ?: return null
|
|
||||||
|
|
||||||
result[field.fieldKey] = memory.translatedText
|
result[field.fieldKey] = memory.translatedText
|
||||||
}
|
}
|
||||||
@@ -91,7 +92,8 @@ class TranslationReadModelMaterializer(
|
|||||||
detail = translations["detail"].orEmpty(),
|
detail = translations["detail"].orEmpty(),
|
||||||
tags = translations["tags"].orEmpty()
|
tags = translations["tags"].orEmpty()
|
||||||
)
|
)
|
||||||
val existing = contentTranslationRepository.findByContentIdAndLocale(resourceId, targetLanguage)
|
entityManager.find(AudioContent::class.java, resourceId, LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
val existing = contentTranslationRepository.findByContentIdAndLocaleForUpdate(resourceId, targetLanguage)
|
||||||
if (existing == null) {
|
if (existing == null) {
|
||||||
contentTranslationRepository.save(ContentTranslation(resourceId, targetLanguage, payload))
|
contentTranslationRepository.save(ContentTranslation(resourceId, targetLanguage, payload))
|
||||||
} else {
|
} else {
|
||||||
@@ -140,6 +142,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 +234,4 @@ class TranslationReadModelMaterializer(
|
|||||||
}
|
}
|
||||||
return true
|
return true
|
||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
|
||||||
const val DEFAULT_PROVIDER = "papago"
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|||||||
+1
@@ -52,6 +52,7 @@ class TranslationSourceExtractor(
|
|||||||
val content = audioContentRepository.findByIdOrNull(resourceId) ?: return null
|
val content = audioContentRepository.findByIdOrNull(resourceId) ?: return null
|
||||||
val sourceLanguage = content.languageCode?.takeIf { it.isNotBlank() } ?: return null
|
val sourceLanguage = content.languageCode?.takeIf { it.isNotBlank() } ?: return null
|
||||||
val tags = content.audioContentHashTags
|
val tags = content.audioContentHashTags
|
||||||
|
.filter { it.isActive }
|
||||||
.mapNotNull { it.hashTag?.tag }
|
.mapNotNull { it.hashTag?.tag }
|
||||||
.joinToString(",")
|
.joinToString(",")
|
||||||
return TranslationSource(
|
return TranslationSource(
|
||||||
|
|||||||
+1
-1
@@ -3,7 +3,7 @@ package kr.co.vividnext.sodalive.member.contentpreference
|
|||||||
import kr.co.vividnext.sodalive.member.Member
|
import kr.co.vividnext.sodalive.member.Member
|
||||||
|
|
||||||
private val FORCED_KR_MEMBER_IDS = setOf(16L, 17L, 17958L, 44144L)
|
private val FORCED_KR_MEMBER_IDS = setOf(16L, 17L, 17958L, 44144L)
|
||||||
private val FORCED_JP_MEMBER_IDS = setOf(29721L, 32050L, 37543L, 40850L)
|
private val FORCED_JP_MEMBER_IDS = setOf(29721L, 32050L, 37543L, 40850L, 45459L)
|
||||||
|
|
||||||
fun resolveCountryCodeWithForcedMapping(member: Member?, requestCountryCode: String?): String {
|
fun resolveCountryCodeWithForcedMapping(member: Member?, requestCountryCode: String?): String {
|
||||||
val memberId = member?.id
|
val memberId = member?.id
|
||||||
|
|||||||
+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,
|
||||||
|
|||||||
+17
-1
@@ -5,9 +5,9 @@ import kr.co.vividnext.sodalive.content.LanguageDetectTargetType
|
|||||||
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunity
|
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunity
|
||||||
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.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.ResourceTranslationJobScheduler
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.SourceTextNormalizer
|
import kr.co.vividnext.sodalive.i18n.translation.SourceTextNormalizer
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationLanguages.getTranslatableLanguageCodes
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.TranslationReadModelMaterializer
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationReadModelMaterializer
|
||||||
import kr.co.vividnext.sodalive.i18n.translation.TranslationSourceExtractor
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationSourceExtractor
|
||||||
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
|
||||||
@@ -35,6 +35,17 @@ class CreatorCommunityTranslationService(
|
|||||||
|
|
||||||
val normalizedLocale = locale.lowercase()
|
val normalizedLocale = locale.lowercase()
|
||||||
val posts = creatorCommunityRepository.findAllById(postIds).filter { it.isActive }
|
val posts = creatorCommunityRepository.findAllById(postIds).filter { it.isActive }
|
||||||
|
val translationPostIds = posts.filter { post ->
|
||||||
|
val sourceLanguage = post.languageCode?.lowercase()
|
||||||
|
!sourceLanguage.isNullOrBlank() && sourceLanguage != normalizedLocale
|
||||||
|
}.mapNotNull { it.id }
|
||||||
|
if (translationPostIds.isNotEmpty()) {
|
||||||
|
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||||
|
LanguageTranslationTargetType.CREATOR_COMMUNITY,
|
||||||
|
translationPostIds,
|
||||||
|
normalizedLocale
|
||||||
|
)
|
||||||
|
}
|
||||||
val translations = creatorCommunityTranslationRepository
|
val translations = creatorCommunityTranslationRepository
|
||||||
.findByCreatorCommunityIdInAndLocale(posts.mapNotNull { it.id }, normalizedLocale)
|
.findByCreatorCommunityIdInAndLocale(posts.mapNotNull { it.id }, normalizedLocale)
|
||||||
.associateBy { it.creatorCommunityId }
|
.associateBy { it.creatorCommunityId }
|
||||||
@@ -62,6 +73,11 @@ class CreatorCommunityTranslationService(
|
|||||||
targetLanguages
|
targetLanguages
|
||||||
.filter { it != sourceLanguage }
|
.filter { it != sourceLanguage }
|
||||||
.forEach { language ->
|
.forEach { language ->
|
||||||
|
resourceTranslationJobScheduler.restartFailedResourceTranslationsInCurrentTransaction(
|
||||||
|
LanguageTranslationTargetType.CREATOR_COMMUNITY,
|
||||||
|
listOf(postId),
|
||||||
|
language
|
||||||
|
)
|
||||||
if (!materializer.materialize(LanguageTranslationTargetType.CREATOR_COMMUNITY, postId, language)) {
|
if (!materializer.materialize(LanguageTranslationTargetType.CREATOR_COMMUNITY, postId, language)) {
|
||||||
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
||||||
resourceType = LanguageTranslationTargetType.CREATOR_COMMUNITY,
|
resourceType = LanguageTranslationTargetType.CREATOR_COMMUNITY,
|
||||||
|
|||||||
@@ -0,0 +1,28 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence
|
||||||
|
|
||||||
|
import javax.persistence.Column
|
||||||
|
import javax.persistence.Entity
|
||||||
|
import javax.persistence.GeneratedValue
|
||||||
|
import javax.persistence.GenerationType
|
||||||
|
import javax.persistence.Id
|
||||||
|
import javax.persistence.Table
|
||||||
|
import javax.persistence.UniqueConstraint
|
||||||
|
|
||||||
|
@Entity
|
||||||
|
@Table(name = "subtitle", uniqueConstraints = [UniqueConstraint(columnNames = ["job_id", "language"])])
|
||||||
|
class Subtitle(
|
||||||
|
@Column(name = "job_id", nullable = false, length = 36)
|
||||||
|
val jobId: String,
|
||||||
|
@Column(nullable = false, length = 35)
|
||||||
|
val language: String,
|
||||||
|
@Column(nullable = false, length = 16)
|
||||||
|
val format: String,
|
||||||
|
@Column(name = "s3_bucket", nullable = false, length = 255)
|
||||||
|
val s3Bucket: String,
|
||||||
|
@Column(name = "s3_key", nullable = false, length = 255)
|
||||||
|
val s3Key: String
|
||||||
|
) {
|
||||||
|
@Id
|
||||||
|
@GeneratedValue(strategy = GenerationType.IDENTITY)
|
||||||
|
var id: Long? = null
|
||||||
|
}
|
||||||
+31
@@ -0,0 +1,31 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence
|
||||||
|
|
||||||
|
import org.springframework.data.domain.Persistable
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import java.time.ZoneOffset
|
||||||
|
import java.time.temporal.ChronoUnit
|
||||||
|
import javax.persistence.Column
|
||||||
|
import javax.persistence.Entity
|
||||||
|
import javax.persistence.Id
|
||||||
|
import javax.persistence.Table
|
||||||
|
import javax.persistence.Transient
|
||||||
|
|
||||||
|
@Entity
|
||||||
|
@Table(name = "subtitle_callback_receipt")
|
||||||
|
class SubtitleCallbackReceipt(
|
||||||
|
@Id
|
||||||
|
@Column(length = 255)
|
||||||
|
val eventId: String,
|
||||||
|
@Column(nullable = false, length = 36)
|
||||||
|
val jobId: String,
|
||||||
|
@Column(nullable = false, length = 64)
|
||||||
|
val bodyHash: String
|
||||||
|
) : Persistable<String> {
|
||||||
|
@Column(nullable = false, columnDefinition = "TIMESTAMP")
|
||||||
|
val createdAt: LocalDateTime = LocalDateTime.now(ZoneOffset.UTC).truncatedTo(ChronoUnit.SECONDS)
|
||||||
|
|
||||||
|
override fun getId(): String = eventId
|
||||||
|
|
||||||
|
@Transient
|
||||||
|
override fun isNew(): Boolean = true
|
||||||
|
}
|
||||||
+5
@@ -0,0 +1,5 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence
|
||||||
|
|
||||||
|
import org.springframework.data.jpa.repository.JpaRepository
|
||||||
|
|
||||||
|
interface SubtitleCallbackReceiptRepository : JpaRepository<SubtitleCallbackReceipt, String>
|
||||||
+47
@@ -0,0 +1,47 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.domain.SubtitleJobStatus
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import java.time.ZoneOffset
|
||||||
|
import java.time.temporal.ChronoUnit
|
||||||
|
import javax.persistence.Column
|
||||||
|
import javax.persistence.Entity
|
||||||
|
import javax.persistence.EnumType
|
||||||
|
import javax.persistence.Enumerated
|
||||||
|
import javax.persistence.Id
|
||||||
|
import javax.persistence.Table
|
||||||
|
import javax.persistence.UniqueConstraint
|
||||||
|
|
||||||
|
@Entity
|
||||||
|
@Table(name = "subtitle_job", uniqueConstraints = [UniqueConstraint(columnNames = ["source_bucket", "source_key"])])
|
||||||
|
class SubtitleJob(
|
||||||
|
@Id
|
||||||
|
@Column(length = 36)
|
||||||
|
val jobId: String,
|
||||||
|
@Column(nullable = false)
|
||||||
|
val contentId: Long,
|
||||||
|
@Column(name = "source_bucket", nullable = false)
|
||||||
|
val sourceBucket: String,
|
||||||
|
@Column(name = "source_key", nullable = false)
|
||||||
|
val sourceKey: String,
|
||||||
|
@Column(nullable = false)
|
||||||
|
val outputKey: String,
|
||||||
|
@Enumerated(EnumType.STRING)
|
||||||
|
@Column(nullable = false, length = 32)
|
||||||
|
var status: SubtitleJobStatus = SubtitleJobStatus.PENDING
|
||||||
|
) {
|
||||||
|
var errorCode: String? = null
|
||||||
|
|
||||||
|
@Column(columnDefinition = "TEXT")
|
||||||
|
var errorMessage: String? = null
|
||||||
|
var sourceUploadErrorCode: String? = null
|
||||||
|
|
||||||
|
@Column(columnDefinition = "TIMESTAMP")
|
||||||
|
var sourceUploadErrorAt: LocalDateTime? = null
|
||||||
|
|
||||||
|
@Column(nullable = false, columnDefinition = "TIMESTAMP")
|
||||||
|
val createdAt: LocalDateTime = LocalDateTime.now(ZoneOffset.UTC).truncatedTo(ChronoUnit.SECONDS)
|
||||||
|
|
||||||
|
@Column(nullable = false, columnDefinition = "TIMESTAMP")
|
||||||
|
var updatedAt: LocalDateTime = createdAt
|
||||||
|
}
|
||||||
+16
@@ -0,0 +1,16 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence
|
||||||
|
|
||||||
|
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 SubtitleJobRepository : JpaRepository<SubtitleJob, String> {
|
||||||
|
fun findBySourceBucketAndSourceKey(sourceBucket: String, sourceKey: String): SubtitleJob?
|
||||||
|
fun findFirstByContentIdOrderByCreatedAtAsc(contentId: Long): SubtitleJob?
|
||||||
|
|
||||||
|
@Lock(LockModeType.PESSIMISTIC_WRITE)
|
||||||
|
@Query("select j from SubtitleJob j where j.jobId = :jobId")
|
||||||
|
fun findForUpdate(@Param("jobId") jobId: String): SubtitleJob?
|
||||||
|
}
|
||||||
+8
@@ -0,0 +1,8 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence
|
||||||
|
|
||||||
|
import org.springframework.data.jpa.repository.JpaRepository
|
||||||
|
|
||||||
|
interface SubtitleRepository : JpaRepository<Subtitle, Long> {
|
||||||
|
fun findAllByJobId(jobId: String): List<Subtitle>
|
||||||
|
fun findByJobIdAndLanguage(jobId: String, language: String): Subtitle?
|
||||||
|
}
|
||||||
+25
@@ -0,0 +1,25 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.web
|
||||||
|
|
||||||
|
import org.springframework.core.Ordered
|
||||||
|
import org.springframework.core.annotation.Order
|
||||||
|
import org.springframework.http.ResponseEntity
|
||||||
|
import org.springframework.http.converter.HttpMessageNotReadableException
|
||||||
|
import org.springframework.web.bind.annotation.ExceptionHandler
|
||||||
|
import org.springframework.web.bind.annotation.RestControllerAdvice
|
||||||
|
import org.springframework.web.server.ResponseStatusException
|
||||||
|
|
||||||
|
@Order(Ordered.HIGHEST_PRECEDENCE)
|
||||||
|
@RestControllerAdvice(assignableTypes = [SubtitleJobController::class])
|
||||||
|
class SubtitleExceptionHandler {
|
||||||
|
@ExceptionHandler(ResponseStatusException::class)
|
||||||
|
fun handle(exception: ResponseStatusException): ResponseEntity<Map<String, String>> =
|
||||||
|
ResponseEntity.status(exception.status).body(mapOf("error" to "Subtitle request rejected"))
|
||||||
|
|
||||||
|
@ExceptionHandler(HttpMessageNotReadableException::class)
|
||||||
|
fun handleUnreadableBody(): ResponseEntity<Map<String, String>> =
|
||||||
|
ResponseEntity.unprocessableEntity().body(mapOf("error" to "Subtitle request rejected"))
|
||||||
|
|
||||||
|
@ExceptionHandler(Exception::class)
|
||||||
|
fun handleUnexpectedException(): ResponseEntity<Map<String, String>> =
|
||||||
|
ResponseEntity.internalServerError().body(mapOf("error" to "Subtitle request failed"))
|
||||||
|
}
|
||||||
+32
@@ -0,0 +1,32 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.web
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.application.SubtitleJobService
|
||||||
|
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.RequestBody
|
||||||
|
import org.springframework.web.bind.annotation.RequestMapping
|
||||||
|
import org.springframework.web.bind.annotation.RequestParam
|
||||||
|
import org.springframework.web.bind.annotation.RestController
|
||||||
|
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/internal/api/subtitle-jobs")
|
||||||
|
class SubtitleJobController(private val service: SubtitleJobService, private val parser: SubtitleRequestParser) {
|
||||||
|
@GetMapping("/resolve")
|
||||||
|
fun resolve(@RequestParam bucket: String, @RequestParam key: String) = service.resolve(bucket, key)
|
||||||
|
|
||||||
|
@GetMapping("/{jobId}")
|
||||||
|
fun get(@PathVariable jobId: String) = service.get(jobId)
|
||||||
|
|
||||||
|
@PostMapping("/{jobId}/started", consumes = ["application/json"])
|
||||||
|
fun started(@PathVariable jobId: String, @RequestBody body: ByteArray): Map<String, String> {
|
||||||
|
service.started(jobId, parser.started(body))
|
||||||
|
return emptyMap()
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/callback", consumes = ["application/json"])
|
||||||
|
fun callback(@RequestBody body: ByteArray): Map<String, String> {
|
||||||
|
service.callback(parser.callback(body), body)
|
||||||
|
return emptyMap()
|
||||||
|
}
|
||||||
|
}
|
||||||
+72
@@ -0,0 +1,72 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.adapter.web
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.core.JsonParser
|
||||||
|
import com.fasterxml.jackson.core.JsonProcessingException
|
||||||
|
import com.fasterxml.jackson.databind.DeserializationFeature
|
||||||
|
import com.fasterxml.jackson.databind.JsonNode
|
||||||
|
import com.fasterxml.jackson.databind.ObjectMapper
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleCallbackRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleResultRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleStartedRequest
|
||||||
|
import org.springframework.http.HttpStatus
|
||||||
|
import org.springframework.stereotype.Component
|
||||||
|
import org.springframework.web.server.ResponseStatusException
|
||||||
|
|
||||||
|
@Component
|
||||||
|
class SubtitleRequestParser(objectMapper: ObjectMapper) {
|
||||||
|
private val mapper = objectMapper.copy()
|
||||||
|
.enable(JsonParser.Feature.STRICT_DUPLICATE_DETECTION)
|
||||||
|
.enable(DeserializationFeature.FAIL_ON_TRAILING_TOKENS)
|
||||||
|
|
||||||
|
fun started(body: ByteArray): SubtitleStartedRequest {
|
||||||
|
val node = parse(body)
|
||||||
|
fields(node, setOf("transcribeJobName", "status"))
|
||||||
|
return SubtitleStartedRequest(text(node, "transcribeJobName"), text(node, "status"))
|
||||||
|
}
|
||||||
|
|
||||||
|
fun callback(body: ByteArray): SubtitleCallbackRequest {
|
||||||
|
val node = parse(body)
|
||||||
|
fields(
|
||||||
|
node,
|
||||||
|
setOf("eventId", "jobId", "contentId", "transcribeJobName", "status", "subtitles", "errorCode", "errorMessage")
|
||||||
|
)
|
||||||
|
val contentId = node.path("contentId")
|
||||||
|
if (!contentId.isIntegralNumber || !contentId.canConvertToLong() || contentId.longValue() <= 0) throw invalid()
|
||||||
|
val subtitles = node.path("subtitles")
|
||||||
|
if (!subtitles.isArray || subtitles.size() > 2) throw invalid()
|
||||||
|
return SubtitleCallbackRequest(
|
||||||
|
eventId = text(node, "eventId"),
|
||||||
|
jobId = text(node, "jobId"),
|
||||||
|
contentId = contentId.longValue(),
|
||||||
|
transcribeJobName = text(node, "transcribeJobName"),
|
||||||
|
status = text(node, "status"),
|
||||||
|
subtitles = subtitles.map {
|
||||||
|
fields(it, setOf("language", "format", "s3Bucket", "s3Key"))
|
||||||
|
SubtitleResultRequest(text(it, "language"), text(it, "format"), text(it, "s3Bucket"), text(it, "s3Key"))
|
||||||
|
},
|
||||||
|
errorCode = nullableText(node, "errorCode"),
|
||||||
|
errorMessage = nullableText(node, "errorMessage")
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun parse(body: ByteArray): JsonNode = try {
|
||||||
|
mapper.readTree(body) ?: throw invalid()
|
||||||
|
} catch (_: JsonProcessingException) {
|
||||||
|
throw invalid()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun fields(node: JsonNode, expected: Set<String>) {
|
||||||
|
if (!node.isObject || node.fieldNames().asSequence().toSet() != expected) throw invalid()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun text(node: JsonNode, field: String): String {
|
||||||
|
val value = node.path(field)
|
||||||
|
if (!value.isTextual || value.textValue().isBlank()) throw invalid()
|
||||||
|
return value.textValue()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun nullableText(node: JsonNode, field: String): String? =
|
||||||
|
if (node.path(field).isNull) null else text(node, field)
|
||||||
|
|
||||||
|
private fun invalid() = ResponseStatusException(HttpStatus.UNPROCESSABLE_ENTITY, "Invalid subtitle request")
|
||||||
|
}
|
||||||
+219
@@ -0,0 +1,219 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.application
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.aws.cloudfront.AudioContentCloudFront
|
||||||
|
import kr.co.vividnext.sodalive.content.AudioContent
|
||||||
|
import kr.co.vividnext.sodalive.i18n.Lang
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence.Subtitle
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence.SubtitleCallbackReceipt
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence.SubtitleCallbackReceiptRepository
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence.SubtitleJob
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence.SubtitleJobRepository
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.adapter.persistence.SubtitleRepository
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.domain.SubtitleJobStatus
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.ContentSubtitleResponse
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleCallbackRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleJobResponse
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleResultRequest
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleSourceResponse
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.dto.SubtitleStartedRequest
|
||||||
|
import org.springframework.beans.factory.annotation.Value
|
||||||
|
import org.springframework.dao.DataIntegrityViolationException
|
||||||
|
import org.springframework.data.repository.findByIdOrNull
|
||||||
|
import org.springframework.http.HttpStatus
|
||||||
|
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 org.springframework.web.server.ResponseStatusException
|
||||||
|
import java.security.MessageDigest
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import java.time.ZoneOffset
|
||||||
|
import java.time.temporal.ChronoUnit
|
||||||
|
import java.util.Locale
|
||||||
|
import java.util.UUID
|
||||||
|
|
||||||
|
@Service
|
||||||
|
class SubtitleJobService(
|
||||||
|
private val jobs: SubtitleJobRepository,
|
||||||
|
private val receipts: SubtitleCallbackReceiptRepository,
|
||||||
|
private val subtitles: SubtitleRepository,
|
||||||
|
private val cloudFront: AudioContentCloudFront,
|
||||||
|
transactionManager: PlatformTransactionManager,
|
||||||
|
@Value("\${cloud.aws.s3.content-bucket}") private val bucket: String
|
||||||
|
) {
|
||||||
|
private val transaction = TransactionTemplate(transactionManager).apply {
|
||||||
|
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
|
||||||
|
isolationLevel = TransactionDefinition.ISOLATION_READ_COMMITTED
|
||||||
|
}
|
||||||
|
|
||||||
|
@Transactional(propagation = Propagation.MANDATORY)
|
||||||
|
fun register(content: AudioContent, originalFilename: String?): SubtitleJob {
|
||||||
|
val contentId = requireNotNull(content.id)
|
||||||
|
val sourceName = UUID.randomUUID().toString()
|
||||||
|
val extension = originalFilename?.replace('\\', '/')?.substringAfterLast('/')
|
||||||
|
?.substringAfterLast('.', "")?.takeIf { it.matches(Regex("[A-Za-z0-9]{1,16}")) }
|
||||||
|
?.lowercase(Locale.ROOT)
|
||||||
|
val sourceFileName = if (extension == null) sourceName else "$sourceName.$extension"
|
||||||
|
val job = jobs.save(
|
||||||
|
SubtitleJob(
|
||||||
|
jobId = UUID.randomUUID().toString(),
|
||||||
|
contentId = contentId,
|
||||||
|
sourceBucket = bucket,
|
||||||
|
sourceKey = "input/$contentId/$sourceFileName",
|
||||||
|
outputKey = "output/$contentId/$sourceName"
|
||||||
|
)
|
||||||
|
)
|
||||||
|
content.latestSubtitleJobId = job.jobId
|
||||||
|
content.content = job.sourceKey
|
||||||
|
return job
|
||||||
|
}
|
||||||
|
|
||||||
|
@Transactional(readOnly = true)
|
||||||
|
fun resolve(bucket: String, key: String): SubtitleJobResponse =
|
||||||
|
response(jobs.findBySourceBucketAndSourceKey(bucket, key) ?: throw missing())
|
||||||
|
|
||||||
|
@Transactional(readOnly = true)
|
||||||
|
fun get(jobId: String): SubtitleJobResponse = response(jobs.findByIdOrNull(jobId) ?: throw missing())
|
||||||
|
|
||||||
|
fun started(jobId: String, request: SubtitleStartedRequest) {
|
||||||
|
if (request.transcribeJobName != "subtitle-$jobId" || request.status != "PROCESSING") throw invalid()
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
val job = jobs.findForUpdate(jobId) ?: throw missing()
|
||||||
|
if (job.status == SubtitleJobStatus.PENDING) {
|
||||||
|
job.status = SubtitleJobStatus.PROCESSING
|
||||||
|
job.updatedAt = now()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fun callback(request: SubtitleCallbackRequest, rawBody: ByteArray) {
|
||||||
|
if (request.eventId.isBlank() || request.eventId.length > 255) throw invalid()
|
||||||
|
val hash = MessageDigest.getInstance("SHA-256").digest(rawBody).joinToString("") { "%02x".format(it) }
|
||||||
|
try {
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
val existing = receipts.findByIdOrNull(request.eventId)
|
||||||
|
if (existing != null) {
|
||||||
|
replay(existing, hash)
|
||||||
|
return@executeWithoutResult
|
||||||
|
}
|
||||||
|
val job = jobs.findForUpdate(request.jobId) ?: throw missing()
|
||||||
|
val afterLock = receipts.findByIdOrNull(request.eventId)
|
||||||
|
if (afterLock != null) {
|
||||||
|
replay(afterLock, hash)
|
||||||
|
return@executeWithoutResult
|
||||||
|
}
|
||||||
|
val status = validate(job, request)
|
||||||
|
val existingResults = subtitles.findAllByJobId(job.jobId).map {
|
||||||
|
SubtitleResultRequest(it.language, it.format, it.s3Bucket, it.s3Key)
|
||||||
|
}.sortedBy { it.language }
|
||||||
|
if (job.status.terminal && (
|
||||||
|
job.status != status || existingResults != request.subtitles.sortedBy { it.language } ||
|
||||||
|
job.errorCode != request.errorCode || job.errorMessage != request.errorMessage
|
||||||
|
)
|
||||||
|
) {
|
||||||
|
throw ResponseStatusException(HttpStatus.CONFLICT, "Subtitle job already finished")
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!job.status.terminal) {
|
||||||
|
subtitles.saveAll(
|
||||||
|
request.subtitles.map {
|
||||||
|
Subtitle(job.jobId, it.language, it.format, it.s3Bucket, it.s3Key)
|
||||||
|
}
|
||||||
|
)
|
||||||
|
job.status = status
|
||||||
|
job.errorCode = request.errorCode
|
||||||
|
job.errorMessage = request.errorMessage
|
||||||
|
job.updatedAt = now()
|
||||||
|
}
|
||||||
|
receipts.saveAndFlush(SubtitleCallbackReceipt(request.eventId, job.jobId, hash))
|
||||||
|
}
|
||||||
|
} catch (exception: DataIntegrityViolationException) {
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
val receipt = receipts.findByIdOrNull(request.eventId) ?: throw exception
|
||||||
|
replay(receipt, hash)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fun recordUploadError(jobId: String) {
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
val job = jobs.findForUpdate(jobId) ?: throw missing()
|
||||||
|
val recordedAt = now()
|
||||||
|
job.sourceUploadErrorCode = "SOURCE_UPLOAD_UNCERTAIN"
|
||||||
|
job.sourceUploadErrorAt = recordedAt
|
||||||
|
job.updatedAt = recordedAt
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Transactional(readOnly = true)
|
||||||
|
fun matchesOutput(contentId: Long, outputKey: String): Boolean? =
|
||||||
|
jobs.findFirstByContentIdOrderByCreatedAtAsc(contentId)?.let { job ->
|
||||||
|
outputKey.substringBeforeLast('.', "") == job.outputKey &&
|
||||||
|
outputKey.substringAfterLast('.', "") in setOf("aac", "m4a", "mp3")
|
||||||
|
}
|
||||||
|
|
||||||
|
@Transactional(readOnly = true)
|
||||||
|
fun subtitle(content: AudioContent, lang: Lang, expirationTime: Long): ContentSubtitleResponse? {
|
||||||
|
val jobId = content.latestSubtitleJobId ?: return null
|
||||||
|
val job = jobs.findByIdOrNull(jobId) ?: return null
|
||||||
|
if (job.contentId != content.id || !job.status.terminal || job.status == SubtitleJobStatus.FAILED) return null
|
||||||
|
val language = when (lang) {
|
||||||
|
Lang.KO -> "ko-KR"
|
||||||
|
Lang.JA -> "ja-JP"
|
||||||
|
else -> return null
|
||||||
|
}
|
||||||
|
val subtitle = subtitles.findByJobIdAndLanguage(jobId, language) ?: return null
|
||||||
|
return ContentSubtitleResponse(
|
||||||
|
subtitle.language,
|
||||||
|
subtitle.format,
|
||||||
|
cloudFront.generateSignedURL(subtitle.s3Key, expirationTime)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun validate(job: SubtitleJob, request: SubtitleCallbackRequest): SubtitleJobStatus {
|
||||||
|
if (request.contentId != job.contentId || request.transcribeJobName != "subtitle-${job.jobId}") throw invalid()
|
||||||
|
if (request.subtitles.map { it.language }.distinct().size != request.subtitles.size) throw invalid()
|
||||||
|
request.subtitles.forEach {
|
||||||
|
val language = when (it.language) {
|
||||||
|
"ko-KR" -> "ko"
|
||||||
|
"ja-JP" -> "ja"
|
||||||
|
else -> throw invalid()
|
||||||
|
}
|
||||||
|
if (it.format != "SRT" || it.s3Bucket != bucket ||
|
||||||
|
it.s3Key != "subtitles/${job.contentId}/${job.jobId}/$language.srt"
|
||||||
|
) {
|
||||||
|
throw invalid()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
val status = when (request.subtitles.size) {
|
||||||
|
2 -> SubtitleJobStatus.COMPLETED
|
||||||
|
1 -> SubtitleJobStatus.PARTIAL_COMPLETED
|
||||||
|
0 -> SubtitleJobStatus.FAILED
|
||||||
|
else -> throw invalid()
|
||||||
|
}
|
||||||
|
if (request.status != status.name) throw invalid()
|
||||||
|
if (status == SubtitleJobStatus.COMPLETED) {
|
||||||
|
if (request.errorCode != null || request.errorMessage != null) throw invalid()
|
||||||
|
} else if (request.errorCode.isNullOrBlank() || request.errorMessage.isNullOrBlank() || request.errorCode.length > 255) {
|
||||||
|
throw invalid()
|
||||||
|
}
|
||||||
|
return status
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun replay(receipt: SubtitleCallbackReceipt, hash: String) {
|
||||||
|
if (receipt.bodyHash != hash) throw invalid()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun response(job: SubtitleJob) = SubtitleJobResponse(
|
||||||
|
job.jobId,
|
||||||
|
job.contentId,
|
||||||
|
job.status,
|
||||||
|
SubtitleSourceResponse(job.sourceBucket, job.sourceKey)
|
||||||
|
)
|
||||||
|
|
||||||
|
private fun now() = LocalDateTime.now(ZoneOffset.UTC).truncatedTo(ChronoUnit.SECONDS)
|
||||||
|
private fun missing() = ResponseStatusException(HttpStatus.NOT_FOUND, "Subtitle job not found")
|
||||||
|
private fun invalid() = ResponseStatusException(HttpStatus.UNPROCESSABLE_ENTITY, "Invalid subtitle request")
|
||||||
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.domain
|
||||||
|
|
||||||
|
enum class SubtitleJobStatus {
|
||||||
|
PENDING, PROCESSING, COMPLETED, PARTIAL_COMPLETED, FAILED;
|
||||||
|
|
||||||
|
val terminal: Boolean
|
||||||
|
get() = this == COMPLETED || this == PARTIAL_COMPLETED || this == FAILED
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
package kr.co.vividnext.sodalive.v2.subtitle.dto
|
||||||
|
|
||||||
|
import kr.co.vividnext.sodalive.v2.subtitle.domain.SubtitleJobStatus
|
||||||
|
|
||||||
|
data class SubtitleSourceResponse(val bucket: String, val key: String, val versionId: String? = null)
|
||||||
|
|
||||||
|
data class SubtitleJobResponse(
|
||||||
|
val jobId: String,
|
||||||
|
val contentId: Long,
|
||||||
|
val status: SubtitleJobStatus,
|
||||||
|
val source: SubtitleSourceResponse
|
||||||
|
)
|
||||||
|
|
||||||
|
data class SubtitleStartedRequest(val transcribeJobName: String, val status: String)
|
||||||
|
|
||||||
|
data class SubtitleResultRequest(val language: String, val format: String, val s3Bucket: String, val s3Key: String)
|
||||||
|
|
||||||
|
data class SubtitleCallbackRequest(
|
||||||
|
val eventId: String,
|
||||||
|
val jobId: String,
|
||||||
|
val contentId: Long,
|
||||||
|
val transcribeJobName: String,
|
||||||
|
val status: String,
|
||||||
|
val subtitles: List<SubtitleResultRequest>,
|
||||||
|
val errorCode: String?,
|
||||||
|
val errorMessage: String?
|
||||||
|
)
|
||||||
|
|
||||||
|
data class ContentSubtitleResponse(val language: String, val format: String, val url: String)
|
||||||
@@ -15,6 +15,7 @@ import org.junit.jupiter.api.BeforeEach
|
|||||||
import org.junit.jupiter.api.DisplayName
|
import org.junit.jupiter.api.DisplayName
|
||||||
import org.junit.jupiter.api.Test
|
import org.junit.jupiter.api.Test
|
||||||
import org.mockito.Mockito
|
import org.mockito.Mockito
|
||||||
|
import org.springframework.context.ApplicationEventPublisher
|
||||||
import java.util.Optional
|
import java.util.Optional
|
||||||
|
|
||||||
class AdminContentServiceTest {
|
class AdminContentServiceTest {
|
||||||
@@ -43,6 +44,7 @@ class AdminContentServiceTest {
|
|||||||
contentMainTabRepository = contentMainTabRepository,
|
contentMainTabRepository = contentMainTabRepository,
|
||||||
objectMapper = jacksonObjectMapper(),
|
objectMapper = jacksonObjectMapper(),
|
||||||
s3Uploader = s3Uploader,
|
s3Uploader = s3Uploader,
|
||||||
|
applicationEventPublisher = Mockito.mock(ApplicationEventPublisher::class.java),
|
||||||
bucket = "test-bucket"
|
bucket = "test-bucket"
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|||||||
+70
@@ -11,6 +11,9 @@ import org.junit.jupiter.api.Assertions.assertEquals
|
|||||||
import org.junit.jupiter.api.BeforeEach
|
import org.junit.jupiter.api.BeforeEach
|
||||||
import org.junit.jupiter.api.DisplayName
|
import org.junit.jupiter.api.DisplayName
|
||||||
import org.junit.jupiter.api.Test
|
import org.junit.jupiter.api.Test
|
||||||
|
import org.junit.jupiter.params.ParameterizedTest
|
||||||
|
import org.junit.jupiter.params.provider.NullSource
|
||||||
|
import org.junit.jupiter.params.provider.ValueSource
|
||||||
import org.mockito.Mockito
|
import org.mockito.Mockito
|
||||||
import org.springframework.beans.factory.annotation.Autowired
|
import org.springframework.beans.factory.annotation.Autowired
|
||||||
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc
|
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc
|
||||||
@@ -24,6 +27,7 @@ import org.springframework.test.context.ContextConfiguration
|
|||||||
import org.springframework.test.web.servlet.MockMvc
|
import org.springframework.test.web.servlet.MockMvc
|
||||||
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get
|
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get
|
||||||
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart
|
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart
|
||||||
|
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put
|
||||||
import org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath
|
import org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath
|
||||||
import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status
|
import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status
|
||||||
import java.io.InputStream
|
import java.io.InputStream
|
||||||
@@ -117,6 +121,72 @@ class AdminEventBannerControllerIntegrationTest @Autowired constructor(
|
|||||||
.andExpect(jsonPath("$.data[*].lang").value(containsInAnyOrder("KO", "EN", "JA")))
|
.andExpect(jsonPath("$.data[*].lang").value(containsInAnyOrder("KO", "EN", "JA")))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ParameterizedTest
|
||||||
|
@NullSource
|
||||||
|
@ValueSource(booleans = [true, false])
|
||||||
|
@DisplayName("관리자 이벤트 제목만 수정하면 생략한 링크와 성인 여부 등 나머지 필드를 보존한다")
|
||||||
|
fun shouldPreserveOmittedFieldsWhenUpdatingOnlyTitle(isAdult: Boolean?) {
|
||||||
|
val event = saveEventForUpdate(isAdult)
|
||||||
|
|
||||||
|
mockMvc.perform(updateRequest(event).param("title", "updated"))
|
||||||
|
.andExpect(status().isOk)
|
||||||
|
.andExpect(jsonPath("$.success").value(true))
|
||||||
|
|
||||||
|
assertEquals(event.copy(title = "updated"), eventRepository.findById(requireNotNull(event.id)).orElseThrow())
|
||||||
|
}
|
||||||
|
|
||||||
|
@ParameterizedTest
|
||||||
|
@ValueSource(booleans = [true, false])
|
||||||
|
@DisplayName("관리자 이벤트 수정은 명시한 링크와 성인 여부를 저장한다")
|
||||||
|
fun shouldPersistExplicitLinkAndAdultFlag(isAdult: Boolean) {
|
||||||
|
val event = saveEventForUpdate(!isAdult)
|
||||||
|
|
||||||
|
mockMvc.perform(
|
||||||
|
updateRequest(event)
|
||||||
|
.param("link", "https://event.test/updated")
|
||||||
|
.param("isAdult", isAdult.toString())
|
||||||
|
)
|
||||||
|
.andExpect(status().isOk)
|
||||||
|
.andExpect(jsonPath("$.success").value(true))
|
||||||
|
|
||||||
|
assertEquals(
|
||||||
|
event.copy(link = "https://event.test/updated", isAdult = isAdult),
|
||||||
|
eventRepository.findById(requireNotNull(event.id)).orElseThrow()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
@ParameterizedTest
|
||||||
|
@ValueSource(strings = ["", " "])
|
||||||
|
@DisplayName("관리자 이벤트 수정은 빈 링크를 null로 저장하고 생략한 성인 여부를 보존한다")
|
||||||
|
fun shouldClearBlankLinkWithoutChangingOmittedAdultFlag(link: String) {
|
||||||
|
val event = saveEventForUpdate()
|
||||||
|
|
||||||
|
mockMvc.perform(updateRequest(event).param("link", link))
|
||||||
|
.andExpect(status().isOk)
|
||||||
|
.andExpect(jsonPath("$.success").value(true))
|
||||||
|
|
||||||
|
assertEquals(event.copy(link = null), eventRepository.findById(requireNotNull(event.id)).orElseThrow())
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun updateRequest(event: Event) =
|
||||||
|
put("/admin/event/banner")
|
||||||
|
.param("id", event.id.toString())
|
||||||
|
.with(user("admin").roles("ADMIN"))
|
||||||
|
|
||||||
|
private fun saveEventForUpdate(isAdult: Boolean? = true): Event {
|
||||||
|
return eventRepository.saveAndFlush(
|
||||||
|
activeEvent("original", Lang.EN).apply {
|
||||||
|
popupImage = "original-popup.png"
|
||||||
|
link = "https://event.test/original"
|
||||||
|
this.isAdult = isAdult
|
||||||
|
isPopup = true
|
||||||
|
isActive = false
|
||||||
|
startDate = LocalDateTime.of(2099, 1, 1, 0, 0, 0)
|
||||||
|
endDate = LocalDateTime.of(2099, 1, 2, 23, 59, 59)
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
private fun createRequest() =
|
private fun createRequest() =
|
||||||
multipart("/admin/event/banner")
|
multipart("/admin/event/banner")
|
||||||
.file(MockMultipartFile("thumbnail", "thumbnail.png", "image/png", "thumbnail".toByteArray()))
|
.file(MockMultipartFile("thumbnail", "thumbnail.png", "image/png", "thumbnail".toByteArray()))
|
||||||
|
|||||||
+543
@@ -0,0 +1,543 @@
|
|||||||
|
package kr.co.vividnext.sodalive.content
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.databind.JsonNode
|
||||||
|
import com.fasterxml.jackson.databind.ObjectMapper
|
||||||
|
import kr.co.vividnext.sodalive.admin.content.series.genre.SeriesGenre
|
||||||
|
import kr.co.vividnext.sodalive.content.hashtag.AudioContentHashTag
|
||||||
|
import kr.co.vividnext.sodalive.content.hashtag.HashTag
|
||||||
|
import kr.co.vividnext.sodalive.content.theme.AudioContentTheme
|
||||||
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslation
|
||||||
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslationPayload
|
||||||
|
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
||||||
|
import kr.co.vividnext.sodalive.creator.admin.content.series.Series
|
||||||
|
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesContent
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.LanguageTranslationTargetType
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.ResourceTranslationJobScheduler
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.SourceTextNormalizer
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationJob
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationJobRepository
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationJobStatus
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationJobWorker
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationMemory
|
||||||
|
import kr.co.vividnext.sodalive.i18n.translation.TranslationMemoryRepository
|
||||||
|
import kr.co.vividnext.sodalive.member.Member
|
||||||
|
import kr.co.vividnext.sodalive.member.MemberRole
|
||||||
|
import org.junit.jupiter.api.Assertions.assertEquals
|
||||||
|
import org.junit.jupiter.api.Assertions.assertTrue
|
||||||
|
import org.junit.jupiter.api.BeforeEach
|
||||||
|
import org.junit.jupiter.api.DisplayName
|
||||||
|
import org.junit.jupiter.api.Test
|
||||||
|
import org.junit.jupiter.params.ParameterizedTest
|
||||||
|
import org.junit.jupiter.params.provider.NullAndEmptySource
|
||||||
|
import org.junit.jupiter.params.provider.ValueSource
|
||||||
|
import org.mockito.Mockito
|
||||||
|
import org.springframework.beans.factory.annotation.Autowired
|
||||||
|
import org.springframework.boot.test.context.SpringBootTest
|
||||||
|
import org.springframework.boot.test.mock.mockito.SpyBean
|
||||||
|
import org.springframework.boot.test.web.client.TestRestTemplate
|
||||||
|
import org.springframework.http.HttpEntity
|
||||||
|
import org.springframework.http.HttpHeaders
|
||||||
|
import org.springframework.http.HttpMethod
|
||||||
|
import org.springframework.jdbc.core.JdbcTemplate
|
||||||
|
import org.springframework.test.context.ActiveProfiles
|
||||||
|
import org.springframework.transaction.PlatformTransactionManager
|
||||||
|
import org.springframework.transaction.TransactionDefinition
|
||||||
|
import org.springframework.transaction.support.TransactionTemplate
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import java.util.concurrent.Callable
|
||||||
|
import java.util.concurrent.CountDownLatch
|
||||||
|
import java.util.concurrent.Executors
|
||||||
|
import java.util.concurrent.TimeUnit
|
||||||
|
import javax.persistence.EntityManager
|
||||||
|
|
||||||
|
@SpringBootTest(
|
||||||
|
webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT,
|
||||||
|
classes = [ContentDetailTranslationTestConfiguration::class],
|
||||||
|
properties = [
|
||||||
|
"spring.cache.type=none", "spring.jpa.properties.hibernate.show_sql=false",
|
||||||
|
"cloud.aws.cloud-front.host=https://cdn.test"
|
||||||
|
]
|
||||||
|
)
|
||||||
|
@ActiveProfiles("content-detail-translation-test")
|
||||||
|
class AudioContentDetailTranslationHttpIntegrationTest @Autowired constructor(
|
||||||
|
private val http: TestRestTemplate,
|
||||||
|
private val mapper: ObjectMapper,
|
||||||
|
private val provider: DetailTranslationProvider,
|
||||||
|
private val translations: ContentTranslationRepository,
|
||||||
|
private val memories: TranslationMemoryRepository,
|
||||||
|
private val jobs: TranslationJobRepository,
|
||||||
|
private val jdbc: JdbcTemplate,
|
||||||
|
private val worker: TranslationJobWorker,
|
||||||
|
private val scheduler: ResourceTranslationJobScheduler,
|
||||||
|
private val entityManager: EntityManager,
|
||||||
|
transactionManager: PlatformTransactionManager
|
||||||
|
) {
|
||||||
|
private val transaction = TransactionTemplate(transactionManager).apply {
|
||||||
|
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
|
||||||
|
}
|
||||||
|
|
||||||
|
@SpyBean
|
||||||
|
private lateinit var memoryWriter: TranslationMemoryRepository
|
||||||
|
|
||||||
|
@SpyBean
|
||||||
|
private lateinit var jobClaims: TranslationJobRepository
|
||||||
|
|
||||||
|
@SpyBean
|
||||||
|
private lateinit var translationReads: ContentTranslationRepository
|
||||||
|
|
||||||
|
@BeforeEach
|
||||||
|
fun prepare() {
|
||||||
|
provider.reset()
|
||||||
|
jobs.deleteAllInBatch()
|
||||||
|
translations.deleteAllInBatch()
|
||||||
|
memories.deleteAllInBatch()
|
||||||
|
jdbc.update("delete from language_detection_result")
|
||||||
|
Mockito.doAnswer {
|
||||||
|
jobs.findAll().filter { it.status == TranslationJobStatus.PENDING }.mapNotNull { it.id }
|
||||||
|
}.`when`(jobClaims).findNextPendingGroupJobIdsForUpdate(Mockito.any(LocalDateTime::class.java) ?: LocalDateTime.now())
|
||||||
|
// H2 JSON wraps converter output in a JSON string; keep the real converter's MySQL text contract.
|
||||||
|
jdbc.execute("alter table content_translation alter column rendered_payload varchar(1000000)")
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("첫 상세 HTTP 응답은 번역을 커밋하고 재조회는 저장 결과를 재사용한다")
|
||||||
|
fun shouldReturnCommittedTranslationOnFirstRequestAndReuseIt() {
|
||||||
|
val fixture = fixture()
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTranslation(response, "English title", "English detail", "#Healing")
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
val payload = translations.findByContentIdAndLocale(fixture.first, "en")!!.renderedPayload
|
||||||
|
assertEquals("English title", payload.title)
|
||||||
|
assertEquals("English detail", payload.detail)
|
||||||
|
assertEquals("#Healing", payload.tags)
|
||||||
|
}
|
||||||
|
assertEquals(3, provider.calls.get())
|
||||||
|
assertEquals(setOf("en"), memories.findAll().map { it.targetLanguage }.toSet())
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
assertEquals(response.path("translated"), detail(fixture).path("translated"))
|
||||||
|
assertEquals(3, provider.calls.get())
|
||||||
|
}
|
||||||
|
|
||||||
|
@ParameterizedTest
|
||||||
|
@NullAndEmptySource
|
||||||
|
@ValueSource(strings = [" \t "])
|
||||||
|
@DisplayName("미감지 언어는 같은 상세 응답 전에 감지하고 언어와 번역을 커밋한다")
|
||||||
|
fun shouldDetectMissingLanguageBeforeReturningTranslation(language: String?) {
|
||||||
|
val fixture = fixture(language)
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTranslation(response, "English title", "English detail", "#Healing")
|
||||||
|
assertEquals("ko", response.path("languageCode").textValue())
|
||||||
|
assertEquals("ko", transaction.execute { entityManager.find(AudioContent::class.java, fixture.first).languageCode })
|
||||||
|
assertEquals(listOf("원문 제목 원문 설명 #힐링"), provider.detectionQueries)
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("기존 메모리만으로 빈 필드를 포함한 상세 번역을 저장하고 공급자를 호출하지 않는다")
|
||||||
|
fun shouldMaterializeCachedFieldsAndKeepBlankFieldsEmpty() {
|
||||||
|
val fixture = fixture(detail = " ", tags = false)
|
||||||
|
memories.saveAndFlush(
|
||||||
|
TranslationMemory(SourceTextNormalizer.hash("원문 제목"), "원문 제목", "ko", "en", "Cached title", "aws", "test")
|
||||||
|
)
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTranslation(response, "Cached title", "", "")
|
||||||
|
assertEquals(0, provider.calls.get())
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
}
|
||||||
|
|
||||||
|
@ParameterizedTest
|
||||||
|
@ValueSource(strings = ["en", "fr"])
|
||||||
|
@DisplayName("동일 언어와 미지원 원문 언어에는 동기 번역이나 작업을 만들지 않는다")
|
||||||
|
fun shouldKeepOriginalForSameOrUnsupportedLanguage(language: String) {
|
||||||
|
val fixture = fixture(language)
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTrue(response.path("translated").isNull)
|
||||||
|
assertEquals("원문 제목", response.path("title").textValue())
|
||||||
|
assertEquals(0, provider.calls.get())
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("공급자 실패는 원문과 작업을 반환하고 worker가 누락 필드만 복구한다")
|
||||||
|
fun shouldReturnOriginalAndRecoverPartialTranslationThroughWorker() {
|
||||||
|
val fixture = fixture()
|
||||||
|
provider.beforeTranslate = { if (provider.calls.get() == 2) provider.fail = true }
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTrue(response.path("translated").isNull)
|
||||||
|
assertEquals("원문 제목", response.path("title").textValue())
|
||||||
|
assertEquals(1L, memories.count())
|
||||||
|
assertEquals(3L, jobs.count())
|
||||||
|
provider.fail = false
|
||||||
|
provider.beforeTranslate = {}
|
||||||
|
assertTrue(worker.processNextGroup())
|
||||||
|
assertEquals(4, provider.calls.get())
|
||||||
|
assertEquals(setOf(TranslationJobStatus.COMPLETED), jobs.findAll().map { it.status }.toSet())
|
||||||
|
assertTranslation(detail(fixture), "English title", "English detail", "#Healing")
|
||||||
|
assertEquals(4, provider.calls.get())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("실제 payload 제약 위반은 상세 트랜잭션을 오염시키지 않고 작업으로 복구된다")
|
||||||
|
fun shouldIsolateRealPersistenceFailureAndRecoverFromCommittedMemories() {
|
||||||
|
val fixture = fixture()
|
||||||
|
jdbc.execute(
|
||||||
|
"alter table content_translation add constraint reject_detail_payload check (content_id <> ${fixture.first})"
|
||||||
|
)
|
||||||
|
try {
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTrue(response.path("translated").isNull)
|
||||||
|
assertEquals("원문 제목", response.path("title").textValue())
|
||||||
|
assertEquals(0L, translations.count())
|
||||||
|
assertEquals(3L, memories.count())
|
||||||
|
assertEquals(3L, jobs.count())
|
||||||
|
} finally {
|
||||||
|
jdbc.execute("alter table content_translation drop constraint reject_detail_payload")
|
||||||
|
}
|
||||||
|
assertTrue(worker.processNextGroup())
|
||||||
|
assertTranslation(detail(fixture), "English title", "English detail", "#Healing")
|
||||||
|
assertEquals(3, provider.calls.get())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("메모리 update의 commit 시점 제약 위반도 원문을 반환하고 기존 재시도로 복구한다")
|
||||||
|
fun shouldIsolateMemoryCommitFailure() {
|
||||||
|
val fixture = fixture()
|
||||||
|
memories.saveAndFlush(
|
||||||
|
TranslationMemory(SourceTextNormalizer.hash("#힐링"), "#힐링", "ko", "en", "#힐링", "aws", "test")
|
||||||
|
)
|
||||||
|
jdbc.execute("alter table translation_memory add constraint reject_tag_update check (translated_text <> '#Healing')")
|
||||||
|
try {
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTrue(response.path("translated").isNull)
|
||||||
|
assertEquals("원문 제목", response.path("title").textValue())
|
||||||
|
assertEquals("#힐링", memories.findAll().single { it.sourceText == "#힐링" }.translatedText)
|
||||||
|
assertEquals(3L, jobs.count())
|
||||||
|
} finally {
|
||||||
|
jdbc.execute("alter table translation_memory drop constraint reject_tag_update")
|
||||||
|
}
|
||||||
|
assertTrue(worker.processNextGroup())
|
||||||
|
assertTranslation(detail(fixture), "English title", "English detail", "#Healing")
|
||||||
|
assertEquals(4, provider.calls.get())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("감지 실패 응답 뒤 기존 after-commit 이벤트가 언어와 비동기 작업을 복구한다")
|
||||||
|
fun shouldRetainAfterCommitDetectionRecovery() {
|
||||||
|
val fixture = fixture(null)
|
||||||
|
provider.detection = null
|
||||||
|
provider.beforeDetect = { if (provider.detectionQueries.size == 2) provider.detection = "ko" }
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTrue(response.path("translated").isNull)
|
||||||
|
assertTrue(response.path("languageCode").isNull)
|
||||||
|
assertEquals("ko", transaction.execute { entityManager.find(AudioContent::class.java, fixture.first).languageCode })
|
||||||
|
assertEquals(6L, jobs.count())
|
||||||
|
assertEquals(0, provider.calls.get())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("감지 중 커밋된 원문과 언어 수정은 동기 감지나 외부 managed entity가 덮어쓰지 않는다")
|
||||||
|
fun shouldPreserveConcurrentLanguageAndSourceEdit() {
|
||||||
|
val fixture = fixture(null)
|
||||||
|
provider.beforeDetect = {
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
entityManager.find(AudioContent::class.java, fixture.first).apply {
|
||||||
|
title = "Edited title"
|
||||||
|
languageCode = "en"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertEquals("en", response.path("languageCode").textValue())
|
||||||
|
assertTrue(response.path("translated").isNull)
|
||||||
|
transaction.executeWithoutResult {
|
||||||
|
val content = entityManager.find(AudioContent::class.java, fixture.first)
|
||||||
|
assertEquals("en", content.languageCode)
|
||||||
|
assertEquals("Edited title", content.title)
|
||||||
|
}
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("기존 번역은 FAILED 재개 유지보수의 실제 DB 실패에도 반환된다")
|
||||||
|
fun shouldReturnExistingTranslationWhenRetryMaintenanceFails() {
|
||||||
|
val fixture = fixture()
|
||||||
|
val first = detail(fixture)
|
||||||
|
jobs.saveAndFlush(
|
||||||
|
TranslationJob(
|
||||||
|
LanguageTranslationTargetType.CONTENT, fixture.first, "title", SourceTextNormalizer.hash("원문 제목"),
|
||||||
|
"원문 제목", "ko", "en", TranslationJobStatus.FAILED, 6
|
||||||
|
)
|
||||||
|
)
|
||||||
|
jdbc.execute("alter table translation_job add constraint reject_restart check (status <> 'PENDING')")
|
||||||
|
try {
|
||||||
|
assertEquals(first.path("translated"), detail(fixture).path("translated"))
|
||||||
|
assertEquals(TranslationJobStatus.FAILED, jobs.findAll().single().status)
|
||||||
|
assertEquals(3, provider.calls.get())
|
||||||
|
} finally {
|
||||||
|
jdbc.execute("alter table translation_job drop constraint reject_restart")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("누락 번역의 동기 성공도 기존 FAILED 행만 재개하고 새 작업은 만들지 않는다")
|
||||||
|
fun shouldRestartOnlyExistingFailedJobAfterSynchronousSuccess() {
|
||||||
|
val fixture = fixture()
|
||||||
|
val failed = jobs.saveAndFlush(
|
||||||
|
TranslationJob(
|
||||||
|
LanguageTranslationTargetType.CONTENT, fixture.first, "title", SourceTextNormalizer.hash("원문 제목"),
|
||||||
|
"원문 제목", "ko", "en", TranslationJobStatus.FAILED, 6
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
assertTranslation(detail(fixture), "English title", "English detail", "#Healing")
|
||||||
|
|
||||||
|
val restarted = jobs.findAll().single()
|
||||||
|
assertEquals(failed.id, restarted.id)
|
||||||
|
assertEquals(TranslationJobStatus.PENDING, restarted.status)
|
||||||
|
assertEquals(0, restarted.retryCount)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("동시 상세와 worker의 메모리 유일키 경합은 커밋된 한 결과로 수렴한다")
|
||||||
|
fun shouldConvergeConcurrentDetailAndWorkerStorage() {
|
||||||
|
val fixture = fixture()
|
||||||
|
scheduler.scheduleResourceTranslation(LanguageTranslationTargetType.CONTENT, fixture.first, "en")
|
||||||
|
val inserts = CountDownLatch(3)
|
||||||
|
val originalSave = Mockito.mockingDetails(memoryWriter).mockCreationSettings.defaultAnswer
|
||||||
|
Mockito.doAnswer { invocation ->
|
||||||
|
val memory = invocation.getArgument<TranslationMemory>(0)
|
||||||
|
if (memory.sourceText == "원문 제목") {
|
||||||
|
inserts.countDown()
|
||||||
|
check(inserts.await(10, TimeUnit.SECONDS)) { "competing memory inserts did not arrive" }
|
||||||
|
}
|
||||||
|
originalSave.answer(invocation)
|
||||||
|
}.`when`(memoryWriter).save(Mockito.any(TranslationMemory::class.java) ?: TranslationMemory("", "", "", "", "", "", ""))
|
||||||
|
val pool = Executors.newFixedThreadPool(3)
|
||||||
|
try {
|
||||||
|
val left = pool.submit(Callable { detail(fixture) })
|
||||||
|
val right = pool.submit(Callable { detail(fixture) })
|
||||||
|
val background = pool.submit(Callable { worker.processNextGroup() })
|
||||||
|
assertTranslation(left.get(20, TimeUnit.SECONDS), "English title", "English detail", "#Healing")
|
||||||
|
assertTranslation(right.get(20, TimeUnit.SECONDS), "English title", "English detail", "#Healing")
|
||||||
|
assertTrue(background.get(20, TimeUnit.SECONDS))
|
||||||
|
assertEquals(3L, memories.count())
|
||||||
|
assertEquals(1L, translations.count())
|
||||||
|
assertEquals(setOf(TranslationJobStatus.COMPLETED), jobs.findAll().map { it.status }.toSet())
|
||||||
|
val calls = provider.calls.get()
|
||||||
|
assertTranslation(detail(fixture), "English title", "English detail", "#Healing")
|
||||||
|
assertEquals(calls, provider.calls.get())
|
||||||
|
} finally {
|
||||||
|
pool.shutdownNow()
|
||||||
|
check(pool.awaitTermination(5, TimeUnit.SECONDS))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("연관 콘텐츠 네 필드는 en-ja-en 요청 언어의 저장 제목만 적용하고 원문 탐색을 유지한다")
|
||||||
|
fun shouldLocalizeRelatedTitlesForEachRequestedLanguageWithoutChangingNavigation() {
|
||||||
|
val fixture = fixture()
|
||||||
|
val related = relatedFixture(fixture)
|
||||||
|
translations.saveAllAndFlush(
|
||||||
|
related.flatMap { item ->
|
||||||
|
listOf("en", "ja").map { locale ->
|
||||||
|
ContentTranslation(item.contentId, locale, ContentTranslationPayload("$locale ${item.title}", "", ""))
|
||||||
|
}
|
||||||
|
} + ContentTranslation(
|
||||||
|
fixture.first,
|
||||||
|
"ja",
|
||||||
|
ContentTranslationPayload("Japanese title", "Japanese detail", "#Japanese")
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
listOf("en", "ja", "en").forEach { locale ->
|
||||||
|
Mockito.clearInvocations(translationReads)
|
||||||
|
val response = detail(fixture, locale)
|
||||||
|
|
||||||
|
assertRelatedContent(response, related.map { it.copy(title = "$locale ${it.title}") })
|
||||||
|
assertTranslation(
|
||||||
|
response,
|
||||||
|
if (locale == "en") "English title" else "Japanese title",
|
||||||
|
if (locale == "en") "English detail" else "Japanese detail",
|
||||||
|
if (locale == "en") "#Healing" else "#Japanese"
|
||||||
|
)
|
||||||
|
val batches = Mockito.mockingDetails(translationReads).invocations
|
||||||
|
.filter { it.method.name == "findByContentIdInAndLocale" }
|
||||||
|
assertEquals(1, batches.size)
|
||||||
|
val ids = batches.single().getArgument<List<Long>>(0)
|
||||||
|
assertEquals(related.size, ids.size)
|
||||||
|
assertEquals(related.map { it.contentId }.toSet(), ids.toSet())
|
||||||
|
assertEquals(locale, batches.single().getArgument<String>(1))
|
||||||
|
assertEquals(3, provider.calls.get())
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
assertEquals(related.size * 2 + 2L, translations.count())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@ParameterizedTest
|
||||||
|
@NullAndEmptySource
|
||||||
|
@ValueSource(strings = [" \t ", "Japanese only"])
|
||||||
|
@DisplayName("연관 제목은 요청 언어 번역 없음 또는 빈 값이면 다른 언어 대신 원문을 유지한다")
|
||||||
|
fun shouldKeepOriginalRelatedTitlesWhenRequestedTranslationIsMissingOrBlank(title: String?) {
|
||||||
|
val fixture = fixture()
|
||||||
|
val related = relatedFixture(fixture)
|
||||||
|
if (title != null) {
|
||||||
|
translations.saveAllAndFlush(
|
||||||
|
related.map {
|
||||||
|
ContentTranslation(
|
||||||
|
it.contentId,
|
||||||
|
if (title == "Japanese only") "ja" else "en",
|
||||||
|
ContentTranslationPayload(title, "", "")
|
||||||
|
)
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
val response = detail(fixture, "en")
|
||||||
|
|
||||||
|
assertRelatedContent(response, related)
|
||||||
|
assertTranslation(response, "English title", "English detail", "#Healing")
|
||||||
|
assertEquals(3, provider.calls.get())
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
assertEquals(if (title == null) 1L else related.size + 1L, translations.count())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
@DisplayName("연관 콘텐츠가 없으면 이전 다음은 null이고 추천은 빈 목록이며 배치 조회를 생략한다")
|
||||||
|
fun shouldKeepNullNeighborsAndEmptyRecommendationsWithoutTranslationLookup() {
|
||||||
|
val fixture = fixture()
|
||||||
|
Mockito.clearInvocations(translationReads)
|
||||||
|
|
||||||
|
val response = detail(fixture)
|
||||||
|
|
||||||
|
assertTrue(response.path("previousContent").isNull)
|
||||||
|
assertTrue(response.path("nextContent").isNull)
|
||||||
|
assertEquals(emptyList<JsonNode>(), response.path("creatorOtherContentList").toList())
|
||||||
|
assertEquals(emptyList<JsonNode>(), response.path("sameThemeOtherContentList").toList())
|
||||||
|
assertEquals(
|
||||||
|
0,
|
||||||
|
Mockito.mockingDetails(translationReads).invocations.count { it.method.name == "findByContentIdInAndLocale" }
|
||||||
|
)
|
||||||
|
assertTranslation(response, "English title", "English detail", "#Healing")
|
||||||
|
assertEquals(3, provider.calls.get())
|
||||||
|
assertEquals(0L, jobs.count())
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun assertRelatedContent(response: JsonNode, expected: List<OtherContentResponse>) {
|
||||||
|
assertEquals(expected[0], mapper.treeToValue(response.path("previousContent"), OtherContentResponse::class.java))
|
||||||
|
assertEquals(expected[1], mapper.treeToValue(response.path("nextContent"), OtherContentResponse::class.java))
|
||||||
|
listOf("creatorOtherContentList" to listOf(0, 1, 2), "sameThemeOtherContentList" to listOf(0, 1, 3))
|
||||||
|
.forEach { (field, indices) ->
|
||||||
|
val actual = response.path(field).map { mapper.treeToValue(it, OtherContentResponse::class.java) }
|
||||||
|
assertEquals(indices.size, actual.size)
|
||||||
|
assertEquals(indices.map { expected[it] }.associateBy { it.contentId }, actual.associateBy { it.contentId })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun relatedFixture(fixture: Pair<Long, Long>): List<OtherContentResponse> = transaction.execute {
|
||||||
|
val current = entityManager.find(AudioContent::class.java, fixture.first)
|
||||||
|
current.releaseDate = LocalDateTime.of(2020, 1, 1, 0, 0)
|
||||||
|
val genre = SeriesGenre("related-genre")
|
||||||
|
val series = Series("related-series", "related-introduction", "ko").apply {
|
||||||
|
member = current.member
|
||||||
|
this.genre = genre
|
||||||
|
}
|
||||||
|
val otherCreator = Member(password = "test", nickname = "other-creator", role = MemberRole.CREATOR)
|
||||||
|
val otherTheme = AudioContentTheme("other-theme", "other-theme.png")
|
||||||
|
listOf(genre, series, otherCreator, otherTheme).forEach(entityManager::persist)
|
||||||
|
entityManager.persist(
|
||||||
|
SeriesContent().apply {
|
||||||
|
this.series = series
|
||||||
|
content = current
|
||||||
|
}
|
||||||
|
)
|
||||||
|
listOf("가 이전", "하 다음", "creator only", "theme only").mapIndexed { index, title ->
|
||||||
|
val content = AudioContent(title, "related detail", "ko", releaseDate = current.releaseDate).apply {
|
||||||
|
member = if (index == 3) otherCreator else current.member
|
||||||
|
theme = if (index == 2) otherTheme else current.theme
|
||||||
|
coverImage = "related-$index.png"
|
||||||
|
isActive = true
|
||||||
|
}
|
||||||
|
entityManager.persist(content)
|
||||||
|
if (index < 2) {
|
||||||
|
entityManager.persist(
|
||||||
|
SeriesContent().apply {
|
||||||
|
this.series = series
|
||||||
|
this.content = content
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
OtherContentResponse(requireNotNull(content.id), title, "https://cdn.test/related-$index.png")
|
||||||
|
}
|
||||||
|
}!!
|
||||||
|
|
||||||
|
private fun detail(fixture: Pair<Long, Long>, locale: String? = null): JsonNode {
|
||||||
|
val response = http.exchange(
|
||||||
|
"/audio-content/${fixture.first}?timezone=UTC",
|
||||||
|
HttpMethod.GET,
|
||||||
|
HttpEntity<Void>(
|
||||||
|
HttpHeaders().apply {
|
||||||
|
set("X-Test-Member", fixture.second.toString())
|
||||||
|
if (locale != null) set("Accept-Language", locale)
|
||||||
|
}
|
||||||
|
),
|
||||||
|
String::class.java
|
||||||
|
)
|
||||||
|
assertEquals(200, response.statusCodeValue, response.body)
|
||||||
|
val body = mapper.readTree(response.body)
|
||||||
|
assertTrue(body.path("success").booleanValue(), response.body)
|
||||||
|
return body.path("data")
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun assertTranslation(response: JsonNode, title: String, detail: String, tags: String) {
|
||||||
|
assertEquals(title, response.path("translated").path("title").textValue())
|
||||||
|
assertEquals(detail, response.path("translated").path("detail").textValue())
|
||||||
|
assertEquals(tags, response.path("translated").path("tags").textValue())
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun fixture(language: String? = "ko", detail: String = "원문 설명", tags: Boolean = true): Pair<Long, Long> =
|
||||||
|
transaction.execute {
|
||||||
|
val creator = Member(password = "test", nickname = "detail-creator", role = MemberRole.CREATOR)
|
||||||
|
val viewer = Member(password = "test", nickname = "detail-viewer")
|
||||||
|
val theme = AudioContentTheme("테마", "theme.png")
|
||||||
|
listOf(creator, viewer, theme).forEach(entityManager::persist)
|
||||||
|
val content = AudioContent("원문 제목", detail, language, isCommentAvailable = false).apply {
|
||||||
|
member = creator
|
||||||
|
this.theme = theme
|
||||||
|
this.content = "output/audio.mp3"
|
||||||
|
coverImage = "cover.png"
|
||||||
|
duration = "00:01:00"
|
||||||
|
isActive = true
|
||||||
|
}
|
||||||
|
entityManager.persist(content)
|
||||||
|
if (tags) {
|
||||||
|
listOf("#힐링" to true, "#비활성" to false).forEach { (tag, active) ->
|
||||||
|
val hashTag = HashTag(tag)
|
||||||
|
entityManager.persist(hashTag)
|
||||||
|
entityManager.persist(
|
||||||
|
AudioContentHashTag().apply {
|
||||||
|
audioContent = content
|
||||||
|
this.hashTag = hashTag
|
||||||
|
isActive = active
|
||||||
|
}
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
requireNotNull(content.id) to requireNotNull(viewer.id)
|
||||||
|
}!!
|
||||||
|
}
|
||||||
@@ -19,7 +19,6 @@ import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
|||||||
import kr.co.vividnext.sodalive.explorer.ExplorerQueryRepository
|
import kr.co.vividnext.sodalive.explorer.ExplorerQueryRepository
|
||||||
import kr.co.vividnext.sodalive.i18n.LangContext
|
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.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
|
||||||
@@ -27,6 +26,7 @@ import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreference
|
|||||||
import kr.co.vividnext.sodalive.support.originalLocalizedNameService
|
import kr.co.vividnext.sodalive.support.originalLocalizedNameService
|
||||||
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.junit.jupiter.api.Assertions.assertEquals
|
import org.junit.jupiter.api.Assertions.assertEquals
|
||||||
import org.junit.jupiter.api.Assertions.assertFalse
|
import org.junit.jupiter.api.Assertions.assertFalse
|
||||||
import org.junit.jupiter.api.Assertions.assertNull
|
import org.junit.jupiter.api.Assertions.assertNull
|
||||||
@@ -40,6 +40,7 @@ import org.mockito.Mockito
|
|||||||
import org.springframework.boot.test.system.CapturedOutput
|
import org.springframework.boot.test.system.CapturedOutput
|
||||||
import org.springframework.boot.test.system.OutputCaptureExtension
|
import org.springframework.boot.test.system.OutputCaptureExtension
|
||||||
import org.springframework.context.ApplicationEventPublisher
|
import org.springframework.context.ApplicationEventPublisher
|
||||||
|
import org.springframework.transaction.PlatformTransactionManager
|
||||||
import java.time.LocalDateTime
|
import java.time.LocalDateTime
|
||||||
import java.util.Optional
|
import java.util.Optional
|
||||||
|
|
||||||
@@ -58,7 +59,6 @@ class AudioContentServiceTest {
|
|||||||
private lateinit var audioContentLikeRepository: AudioContentLikeRepository
|
private lateinit var audioContentLikeRepository: AudioContentLikeRepository
|
||||||
private lateinit var pinContentRepository: PinContentRepository
|
private lateinit var pinContentRepository: PinContentRepository
|
||||||
private lateinit var memberRepository: MemberRepository
|
private lateinit var memberRepository: MemberRepository
|
||||||
private lateinit var resourceTranslationJobScheduler: ResourceTranslationJobScheduler
|
|
||||||
private lateinit var contentTranslationRepository: ContentTranslationRepository
|
private lateinit var contentTranslationRepository: ContentTranslationRepository
|
||||||
private lateinit var s3Uploader: S3Uploader
|
private lateinit var s3Uploader: S3Uploader
|
||||||
private lateinit var audioContentCloudFront: AudioContentCloudFront
|
private lateinit var audioContentCloudFront: AudioContentCloudFront
|
||||||
@@ -66,6 +66,7 @@ class AudioContentServiceTest {
|
|||||||
private lateinit var contentThemeTranslationRepository: ContentThemeTranslationRepository
|
private lateinit var contentThemeTranslationRepository: ContentThemeTranslationRepository
|
||||||
private lateinit var homeFollowingNewsPublishService: HomeFollowingNewsPublishService
|
private lateinit var homeFollowingNewsPublishService: HomeFollowingNewsPublishService
|
||||||
private lateinit var memberContentPreferenceService: MemberContentPreferenceService
|
private lateinit var memberContentPreferenceService: MemberContentPreferenceService
|
||||||
|
private lateinit var subtitleJobService: SubtitleJobService
|
||||||
|
|
||||||
private lateinit var service: AudioContentService
|
private lateinit var service: AudioContentService
|
||||||
|
|
||||||
@@ -84,7 +85,6 @@ class AudioContentServiceTest {
|
|||||||
audioContentLikeRepository = Mockito.mock(AudioContentLikeRepository::class.java)
|
audioContentLikeRepository = Mockito.mock(AudioContentLikeRepository::class.java)
|
||||||
pinContentRepository = Mockito.mock(PinContentRepository::class.java)
|
pinContentRepository = Mockito.mock(PinContentRepository::class.java)
|
||||||
memberRepository = Mockito.mock(MemberRepository::class.java)
|
memberRepository = Mockito.mock(MemberRepository::class.java)
|
||||||
resourceTranslationJobScheduler = Mockito.mock(ResourceTranslationJobScheduler::class.java)
|
|
||||||
contentTranslationRepository = Mockito.mock(ContentTranslationRepository::class.java)
|
contentTranslationRepository = Mockito.mock(ContentTranslationRepository::class.java)
|
||||||
s3Uploader = Mockito.mock(S3Uploader::class.java)
|
s3Uploader = Mockito.mock(S3Uploader::class.java)
|
||||||
audioContentCloudFront = Mockito.mock(AudioContentCloudFront::class.java)
|
audioContentCloudFront = Mockito.mock(AudioContentCloudFront::class.java)
|
||||||
@@ -92,6 +92,8 @@ class AudioContentServiceTest {
|
|||||||
contentThemeTranslationRepository = Mockito.mock(ContentThemeTranslationRepository::class.java)
|
contentThemeTranslationRepository = Mockito.mock(ContentThemeTranslationRepository::class.java)
|
||||||
homeFollowingNewsPublishService = Mockito.mock(HomeFollowingNewsPublishService::class.java)
|
homeFollowingNewsPublishService = Mockito.mock(HomeFollowingNewsPublishService::class.java)
|
||||||
memberContentPreferenceService = Mockito.mock(MemberContentPreferenceService::class.java)
|
memberContentPreferenceService = Mockito.mock(MemberContentPreferenceService::class.java)
|
||||||
|
subtitleJobService = Mockito.mock(SubtitleJobService::class.java)
|
||||||
|
Mockito.`when`(subtitleJobService.matchesOutput(Mockito.anyLong(), Mockito.anyString())).thenReturn(null)
|
||||||
|
|
||||||
service = AudioContentService(
|
service = AudioContentService(
|
||||||
repository = repository,
|
repository = repository,
|
||||||
@@ -107,8 +109,11 @@ class AudioContentServiceTest {
|
|||||||
audioContentLikeRepository = audioContentLikeRepository,
|
audioContentLikeRepository = audioContentLikeRepository,
|
||||||
pinContentRepository = pinContentRepository,
|
pinContentRepository = pinContentRepository,
|
||||||
memberRepository = memberRepository,
|
memberRepository = memberRepository,
|
||||||
resourceTranslationJobScheduler = resourceTranslationJobScheduler,
|
|
||||||
contentTranslationRepository = contentTranslationRepository,
|
contentTranslationRepository = contentTranslationRepository,
|
||||||
|
detailTranslationService = Mockito.mock(AudioContentDetailTranslationService::class.java).also {
|
||||||
|
Mockito.`when`(it.resolve(Mockito.anyLong(), Mockito.anyString()))
|
||||||
|
.thenReturn(AudioContentDetailTranslationResult("ko"))
|
||||||
|
},
|
||||||
s3Uploader = s3Uploader,
|
s3Uploader = s3Uploader,
|
||||||
objectMapper = ObjectMapper(),
|
objectMapper = ObjectMapper(),
|
||||||
audioContentCloudFront = audioContentCloudFront,
|
audioContentCloudFront = audioContentCloudFront,
|
||||||
@@ -119,6 +124,8 @@ class AudioContentServiceTest {
|
|||||||
contentThemeTranslationRepository = contentThemeTranslationRepository,
|
contentThemeTranslationRepository = contentThemeTranslationRepository,
|
||||||
homeFollowingNewsPublishService = homeFollowingNewsPublishService,
|
homeFollowingNewsPublishService = homeFollowingNewsPublishService,
|
||||||
memberContentPreferenceService = memberContentPreferenceService,
|
memberContentPreferenceService = memberContentPreferenceService,
|
||||||
|
subtitleJobService = subtitleJobService,
|
||||||
|
transactionManager = Mockito.mock(PlatformTransactionManager::class.java),
|
||||||
audioContentBucket = "audio-bucket",
|
audioContentBucket = "audio-bucket",
|
||||||
coverImageBucket = "cover-bucket",
|
coverImageBucket = "cover-bucket",
|
||||||
coverImageHost = "https://cdn.test"
|
coverImageHost = "https://cdn.test"
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user