Compare commits
528
Commits
23673b4465
..
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 | ||
|
|
64b52db208 | ||
|
|
454f20751d | ||
|
|
5061d85d99 | ||
|
|
6ab901fe0a | ||
|
|
4fbe4ced28 | ||
|
|
f073de374d | ||
|
|
d0b5fff40d | ||
|
|
e1e6554da5 | ||
|
|
e48ea1b505 | ||
|
|
6947675322 | ||
|
|
8b3aab232f | ||
|
|
ff7987b8a1 | ||
|
|
ea64782052 | ||
|
|
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 |
@@ -196,6 +196,7 @@ single-context 구성으로 루트 `GLOSSARY.md`와 `docs/adr/`를 사용한다.
|
||||
- 필요한 문서/도구/참조가 없으면 어느 검토 부분이 미검증인지 보고한다. 공유 checklist 결손을 조용히 무시하거나 global checklist를 만들거나 설치해 full sign-off로 바꾸지 않는다.
|
||||
- 기존 PRD/plan 경로와 project guides가 변경 범위·테스트·검증 기준이다. 이미 완료된 분석을 다른 skill workflow로 반복하지 않는다.
|
||||
- 구현 시 focused test부터 시작하고 프로젝트의 TDD, 보안 및 사람 승인 경계를 지킨다. 실패한 테스트를 삭제/완화하지 않는다.
|
||||
- 에이전트는 구현 중인 기능과 직접 영향받는 범위만 각각 테스트한다. 전체 테스트는 사용자가 실행하며, 에이전트는 실행 명령과 미검증 범위를 안내한다. `test` 무필터 실행 및 전체 테스트를 포함하는 `check`/`build`/`clean build`도 자동 실행하지 않는다. 상세 기준은 `docs/agent-guides/실행명령어.md`를 따른다.
|
||||
- 새 session은 갱신된 `AGENTS.md`를 안정적으로 다시 읽을 수 있도록 시작한다. skill 단계는 논리적 routing guidance이며 runtime 자동 invocation 성공을 보장하지 않는다.
|
||||
- worktree는 필요성을 확인하되 자동 생성하지 않는다. branch 종료/merge는 실제 해당 작업일 때만 다루며 commit/push/merge/delete는 명시적 승인 없이는 하지 않는다.
|
||||
- 사용자가 이미 명확하게 승인한 범위는 다시 묻지 않는다. 승인 경계 밖의 새로운 결정이나 scope 확장만 확인한다.
|
||||
|
||||
@@ -16,6 +16,8 @@ plugins {
|
||||
group = "kr.co.vividnext"
|
||||
version = "0.0.1-SNAPSHOT"
|
||||
val querydslVersion = "5.0.0"
|
||||
extra["httpclient5.version"] = "5.6.4"
|
||||
extra["httpcore5.version"] = "5.4.3"
|
||||
|
||||
java {
|
||||
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-cloudfront:1.12.380")
|
||||
|
||||
implementation(platform("software.amazon.awssdk:bom:2.57.11"))
|
||||
implementation("software.amazon.awssdk:comprehend")
|
||||
implementation("software.amazon.awssdk:translate")
|
||||
|
||||
// bootpay
|
||||
implementation("io.github.bootpay:backend:2.2.1")
|
||||
|
||||
|
||||
@@ -0,0 +1,390 @@
|
||||
# 크리에이터 채널 비밀 후원 익명 조회 구현 계획
|
||||
|
||||
| 문서 항목 | 내용 |
|
||||
|---|---|
|
||||
| 상태 | Phase 1 및 `P2-T1`·`P2-GATE` 완료. 전체 테스트는 사용자 실행 |
|
||||
| 작성일 | 2026-11-04 |
|
||||
| 요구사항 기준 | [prd.md](prd.md) |
|
||||
| API 기준 | [prd.md §8](prd.md#8-api-계약) |
|
||||
| 현재 Phase | Phase 2: 응답 isSecret UI 표시 의미 변경 |
|
||||
| 현재 활성 Goal | 없음 |
|
||||
| 다음 Goal | 없음 |
|
||||
|
||||
> 실행 준비 기준: goal별로 한 번에 하나씩 실행하며, 각 Task의 명령과 체크박스는 실행 후에만 완료 처리한다. 구현 방법은 본 계획의 TDD 순서를 따른다.
|
||||
|
||||
**실행 방식:** 사용자 지시에 따라 worktree 없이 현재 `test` 브랜치에서 Goal을 순차 실행한다. 커밋·푸시·배포는 하지 않는다.
|
||||
|
||||
**Architecture:** persistence record는 실제 `isSecret`을 유지한다. 서비스의 기존 `toDomain` mapper가 조회자별 `isMasked`로 표시 필드와 응답 domain의 `isSecret`을 정한다. DTO 필드명·타입과 기존 이미지 URL 조합은 바꾸지 않는다.
|
||||
|
||||
**Spec:** [prd.md](prd.md), 특히 §7~§10.
|
||||
|
||||
**Review Focus:**
|
||||
|
||||
- 공개 행은 다른 인증 viewer에게도 원본 표시: `P1-T1`, `P1-T2` 공개 후원 E2E assertion.
|
||||
- 비밀 행은 USER 및 본인이 아닌 CREATOR role도 익명: 양 Task의 role별 HTTP E2E.
|
||||
- null/empty 메시지, localized nickname, 마스킹 이미지 URL과 원본/default-profile 회귀: 양 Task의 mapper/service 검증.
|
||||
- 월 경계·정렬·limit/page의 비밀 행 포함: repository와 HTTP E2E의 경계·초과 건수 검증.
|
||||
- 응답 `isSecret`은 조회자별 마스킹 Boolean, DB/record는 원래 비밀 Boolean이다. 양 endpoint 역할별 JSON과 저장값 불변을 검증하고 랭킹은 유지한다.
|
||||
|
||||
## 목표
|
||||
|
||||
크리에이터 채널 홈과 후원 탭에서 현재 KST 월 비밀 후원을 유지하며, 크리에이터와 후원자 외의 사용자에게는 식별 정보 대신 익명 필드를 반환한다.
|
||||
|
||||
## 현재 상태
|
||||
|
||||
| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|
||||
|---:|---|---:|---|---|
|
||||
| 1 | 범위 한정 완료 | `2/2` | 없음 | 전체 suite는 600000ms timeout으로 결과 미확정. 전체 suite 통과로 간주하지 않음 |
|
||||
| 2 | 완료 | `1/1` | 없음 | 관련 196개 회귀 및 최종 HTTP 55개 통과. 전체 테스트는 사용자 실행 |
|
||||
|
||||
- 구현 단계의 실행 체크박스는 실제 테스트 및 검토 증거가 확보된 뒤에만 완료 처리한다.
|
||||
- 미완료 Goal은 동시에 하나만 실행한다.
|
||||
- 파일명과 URL 구성 계약 및 설정된 CDN 이미지 접근은 확인했다. 전체 프로젝트 suite는 timeout으로 미완료 상태이며 범위 한정 Gate 성공과 분리한다.
|
||||
|
||||
## 범위
|
||||
|
||||
### 포함
|
||||
|
||||
- 홈 및 후원 탭의 현재 KST 월 비밀 후원 조회, DB 비밀 설정 보존, 조회자별 UI flag `isSecret` 및 서비스 계층 마스킹.
|
||||
- 양쪽 DTO 직렬화와 repository, service, controller, facade 및 HTTP MockMvc E2E 검증.
|
||||
- 기존 접근 제어, 정렬, count/page, 랭킹, 날짜·금액 계약 보존.
|
||||
|
||||
### 제외
|
||||
|
||||
- 후원 생성, 수정, 취소, DB/DDL, 공개 후원 표시 변경.
|
||||
- 랭킹 변경 또는 전체 익명성 보장.
|
||||
- 신규 dependency, 공통 masking abstraction, port signature 변경(실제 필요가 발견된 경우 별도 결정 전까지 금지).
|
||||
- 새 config, fallback, 공통 helper architecture 또는 외부 번역 서비스.
|
||||
|
||||
## 기술적 제약
|
||||
|
||||
- Kotlin, Spring Boot 2.7.14, Java 17, Gradle Wrapper, QueryDSL 및 기존 `SodaMessageSource`/CDN URL 변환을 사용한다.
|
||||
- 이번 변경에서 공개 API 필드를 추가하지 않는다. 내부 `memberId`, 현재 채널 주인 전용 `donationId` 및 숨김 정책은 유지한다.
|
||||
- persistence에서 비밀 row를 유지하되 서비스가 response domain을 만들기 전 익명화한다. 두 계층 모두 수정과 테스트를 하나의 end-to-end Task로 수행한다.
|
||||
- 각 Task의 `isSecret` 추가는 해당 탭의 port record, domain model, QueryDSL constructor projection 순서와 해당 테스트 fixture constructor를 함께 갱신한다.
|
||||
- 로컬 변환 함수 `toDomain`이 이미 있으므로 기존 함수가 있는 service 안에서 viewer/creator/lang 판정을 수행한다. 새 공유 추상화는 만들지 않는다.
|
||||
- 신규 로직은 먼저 요구 동작을 검증하는 assertion 실패를 관찰한 뒤 구현한다. 필드 추가로 발생한 컴파일 오류는 의도한 RED 증거가 아니다.
|
||||
- focused test와 직접 영향 package 회귀를 우선한다. 전체 테스트·빌드는 이 계획의 미래 Gate에서만 실행하며, 실제 수행한 결과만 Progress에 기록한다.
|
||||
- 마스킹 대상 비밀 후원의 이미지 URL은 기존 `defaultProfileImageUrl()`처럼 `cloud.aws.cloud-front.host`에 `/profile/anonymous-profile.png`를 직접 붙여 만든다. 임의 사용자 제공 경로에 `toCdnUrl`을 적용하지 않는다. 테스트 host `https://cdn.test`의 정확한 기대 URL은 `https://cdn.test/profile/anonymous-profile.png`다.
|
||||
- 익명 URL은 마스킹 대상 비밀 donation item에만 적용한다. 공개 및 creator/donor 본인의 원본 profile image, 기존 `default-profile.png` fallback은 그대로 유지한다. 테스트용 host/URL은 실제 운영 자산 접근 검증을 대신하지 않는다.
|
||||
|
||||
### Phase 1: 홈과 후원 탭 응답에서 비밀 후원 마스킹
|
||||
|
||||
**Phase 결과:** 두 API가 비밀 후원을 count/list에 포함하고 권한별 원본 또는 익명 표시를 반환한다.
|
||||
|
||||
**선행조건:** PRD `SDA-001`~`SDA-007` 및 §8 계약 확인. 파일명과 URL 구성 계약이 확정되어 있어 이미지 제공 대기 없이 RED와 GREEN을 진행할 수 있다. 운영 CDN 접근 가능 여부는 최종 Gate에서 검증한다.
|
||||
|
||||
**Phase 완료 조건:** `P1-T1`, `P1-T2` 및 `P1-GATE`의 증거 충족. 운영 CDN에서 이미지에 접근할 수 없으면 Gate는 blocked 상태다.
|
||||
|
||||
### 구현 항목
|
||||
|
||||
- [x] **Task 1.1: 홈 후원 목록 조회와 익명화**
|
||||
|
||||
**Goal 실행 `P1-T1`:** 홈 API는 현재 KST 월 비밀 후원을 포함하고, 그 비밀 행만 크리에이터·해당 후원자는 원본, 다른 조회자는 익명 표시를 받으며 공개 행은 기존 원본 표시를 유지한다.
|
||||
|
||||
- **시작 조건:** 없음. PRD `SDA-001`, `SDA-003`~`SDA-007`과 §8.1~§8.3 확인. 이미지 URL 계약은 확정되어 있다.
|
||||
- **완료 증거:** 홈 DTO `isSecret`/응답 계약 및 서비스 마스킹 테스트, repository query 행 검증, 실제 HTTP E2E와 정확한 이미지 URL 및 원본/default-profile 회귀 검증 기록.
|
||||
- **범위 밖:** 후원 탭 변경, 랭킹 변경, 실제 이미지 자산 생성.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/adapter/out/persistence/DefaultCreatorChannelHomeQueryRepository.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/port/out/CreatorChannelHomeQueryPort.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/domain/CreatorChannelHome.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryService.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/dto/CreatorChannelHomeResponse.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/i18n/SodaMessageSource.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/adapter/out/persistence/DefaultCreatorChannelHomeQueryRepositoryTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryServiceTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/adapter/in/web/CreatorChannelHomeControllerTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/application/CreatorChannelHomeFacadeTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/domain/CreatorChannelHomeQueryPolicyTest.kt` (관련 동작이 있으면 수정)
|
||||
|
||||
**Interfaces:**
|
||||
|
||||
- Consumes: 기존 `CreatorChannelHomeQueryPort.findChannelDonations(creatorId, viewerId, now, limit, lang)`, `SodaMessageSource.getMessage(key, lang)` 및 `cloud.aws.cloud-front.host`.
|
||||
- Produces: `CreatorChannelDonationRecord.isSecret: Boolean`, home domain donation의 `isSecret: Boolean`, response JSON `channelDonations[].isSecret`.
|
||||
- Port method signature를 유지한다. record의 새 `isSecret`을 QueryDSL projection과 모든 constructor fixture에 추가한다. Service mapper signature는 `CreatorChannelDonationRecord.toDomain(creatorId: Long, viewerId: Long, lang: Lang): CreatorChannelDonation`으로 둔다.
|
||||
|
||||
- [x] **RED:** E2E에서 `isSecret` 누락 assertion 실패를 production 변경 전에 확인하고 viewer role 및 공개/비밀 행 cases를 추가했다.
|
||||
- [x] **RED 확인:** JSON path `$.data.channelDonations[0].isSecret` 누락 assertion 실패 확인.
|
||||
- [x] **RED 추가 검증:** role, 현지화, 원본/default/익명 이미지 URL 및 Boolean 응답 검증 cases 작성.
|
||||
- [x] **GREEN:** repository filter 제거, persisted `isSecret` 전달 및 서비스 마스킹을 구현했다. 공개/본인 원본과 기존 default-profile 동작을 보존했다.
|
||||
- [x] **GREEN 확인:** 홈 package 89 tests 통과. 이후 홈 E2E 18 + service 23 및 `ktlintCheck` 통과.
|
||||
- [x] **REFACTOR:** KST 월 경계 회귀를 2026년 12월 고정 검증으로 보강했고, 테스트 lint 위반을 수정했다. 역할/언어/월 경계/최신 8건 및 민감 필드 경계를 검증했다.
|
||||
|
||||
**Task 1.1 검증 명령:**
|
||||
|
||||
```bash
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.application.CreatorChannelHomeQueryServiceTest'
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.adapter.out.persistence.DefaultCreatorChannelHomeQueryRepositoryTest'
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.application.CreatorChannelHomeFacadeTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest'
|
||||
```
|
||||
|
||||
**Expected:** 각 명령 exit code 0. response의 **마스킹 대상 비밀 donation item만** 원본 nickname/message/profile path가 없어야 한다. 공개/본인 후원과 ranking identity는 response에 기존대로 남는다. 구현 시 실행할 명령이며 현재 검증 결과가 아니다.
|
||||
|
||||
**Task 1.1 Progress:** 완료. 세부 RED/GREEN 및 2026년 12월 월 경계 수정 증거는 Progress의 `P1-T1 구현 및 검토`와 후속 수정 기록을 참조한다.
|
||||
|
||||
- [x] **Task 1.2: 후원 탭 목록과 count 익명화**
|
||||
|
||||
**Goal 실행 `P1-T2`:** 후원 탭은 현재 월 비밀 후원을 목록·count에 포함하고, 비밀 row만 권한별로 마스킹하며 공개 row의 기존 원본 표시를 유지한다.
|
||||
|
||||
- **시작 조건:** `P1-T1` 완료. 별도 domain mapper를 사용하되 `P1-T1`에서 등록한 i18n key를 재사용한다.
|
||||
- **완료 증거:** donation DTO의 `isSecret`, query count/list, service masking, E2E의 viewer 역할별 응답과 pagination 회귀 기록.
|
||||
- **범위 밖:** 기존 랭킹 쿼리, 랭킹 결과 익명화 또는 랭킹 합계 변경.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultCreatorChannelDonationQueryRepository.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/port/out/CreatorChannelDonationQueryPort.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/domain/CreatorChannelDonationTab.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryService.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/dto/CreatorChannelDonationTabResponse.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultCreatorChannelDonationQueryRepositoryTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/domain/CreatorChannelDonationQueryPolicyTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryServiceTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationControllerTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/application/CreatorChannelDonationFacadeTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationEndToEndTest.kt`
|
||||
|
||||
**Interfaces:**
|
||||
|
||||
- Consumes: 기존 `CreatorChannelDonationQueryPort.countChannelDonations/findChannelDonations`, `SodaMessageSource.getMessage(key, lang)`, 그리고 `P1-T1`이 추가하는 `explorer.channel_donation.anonymous.nickname`, `explorer.channel_donation.anonymous.message`.
|
||||
- Produces: `CreatorChannelDonationRecord.isSecret: Boolean`, donation domain item의 `isSecret: Boolean`, `donations[].isSecret` JSON 필드.
|
||||
- Port method signature를 유지한다. record constructor projection와 모든 test fixture를 갱신한다. mapper signature는 `CreatorChannelDonationRecord.toDomain(creatorId: Long, viewerId: Long, lang: Lang): CreatorChannelDonation`이다.
|
||||
|
||||
- [x] **RED:** E2E의 `isSecret` JSON assertion을 추가하고 production 변경 전 field 누락 실패를 확인했다. USER/별도 CREATOR role, 공개·본인·타인 비밀 및 out-of-range page cases를 추가했다.
|
||||
- [x] **RED 확인:** `$.data.donations[0].isSecret` 누락 assertion 실패 확인.
|
||||
- [x] **RED 추가 검증:** donor/creator 원본, 기본·익명 이미지, 타 역할 마스킹을 위한 검증 cases 작성.
|
||||
- [x] **GREEN:** secret filter만 제거하고 count/list, paging 및 KST 계약을 유지했다. persisted `isSecret`과 권한별 마스킹을 구현했으며 ranking은 변경하지 않았다.
|
||||
- [x] **GREEN 확인:** donation package 63 tests 및 `ktlintCheck` 통과.
|
||||
- [x] **REFACTOR:** mixed 25행 pagination, 전체 count, 월 경계, 역할/언어/메시지 및 기존 ranking 동작을 검증했다.
|
||||
|
||||
**Task 1.2 검증 명령:**
|
||||
|
||||
```bash
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.application.CreatorChannelDonationQueryServiceTest'
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultCreatorChannelDonationQueryRepositoryTest'
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationControllerTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.application.CreatorChannelDonationFacadeTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest'
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.domain.CreatorChannelDonationQueryPolicyTest'
|
||||
```
|
||||
|
||||
**Expected:** 구현 시 각 명령 exit code 0. 타인 비밀 항목만 익명화되고 공개/본인 항목 및 랭킹은 유지된다. 100/200/300 fixture의 count는 3, 최신순은 300/200/100이다. 같은 3건을 조회할 때 모든 viewer의 count는 같고, 범위 밖 page는 빈 목록과 count 3을 반환한다. can/createdAtUtc는 모든 역할에서 저장값과 정확히 일치한다.
|
||||
|
||||
**Task 1.2 Progress:** 완료. 상세 결과는 Progress의 `P1-T2 구현 및 검토`와 통합 Gate 기록을 참조한다.
|
||||
|
||||
### Phase 1 Gate
|
||||
|
||||
**Goal 실행 `P1-GATE`:** 두 조회 endpoint의 계약, 권한 마스킹 및 직접 영향 회귀를 범위 한정으로 검증한다. 전체 프로젝트 suite는 timeout으로 미완료이며 성공으로 간주하지 않는다.
|
||||
|
||||
- **시작 조건:** `P1-T1`, `P1-T2` 구현 완료. 파일명과 URL 계약은 확정되어 있으며 실제 운영 CDN 이미지 접근 가능 여부를 검증한다.
|
||||
- **완료 증거:** focused 패키지 테스트, `ktlintCheck`, `bootJar`, SpringBootTest MockMvc 경로 및 설정된 CDN의 실제 이미지 응답 결과를 Progress에 기록한다. 전체 suite는 별도 제한 사항이다.
|
||||
- **범위 밖:** 랭킹 수정, 테스트 삭제·완화, 전체 테스트를 무조건 실행하는 것.
|
||||
- **TDD 예외 사유:** Gate는 제품 로직을 바꾸지 않고 기존 자동 테스트와 제공된 자산 URL을 검증한다.
|
||||
- **대체 검증 방법:** focused/package test, MockMvc 응답 field와 설정된 이미지 URL 접근 결과를 대조해 기록한다. MockMvc는 live socket/server 검증이 아니다. 코드 수정이 필요하면 owning Task로 되돌린다.
|
||||
|
||||
```bash
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest'
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.*'
|
||||
./gradlew ktlintCheck
|
||||
./gradlew bootJar
|
||||
```
|
||||
|
||||
위 명령은 구현 후 실행할 미래 Gate 검증이며 `bootJar`는 전체 test suite를 암묵 실행하지 않는다. 전체 회귀는 광범위 공통 코드/인증/보안 변경, 여러 domain 변경, release/final 전체 상태 증거 요구, targeted tests만으로 영향 범위를 판단할 수 없는 실패 또는 사용자 명시 요청 때만 별도로 실행한다. 기존 message group에 두 i18n key를 추가한 사실만으로 전체 회귀를 요구하지 않는다. 생략 시 근거와 focused/package 회귀 결과를 기록한다.
|
||||
|
||||
```bash
|
||||
./gradlew test
|
||||
```
|
||||
|
||||
**Gate Expected:** E2E와 해당 패키지 테스트·lint·`bootJar`의 실제 성공 결과를 확인한다. 정확한 URL `"$cloudFrontHost/profile/anonymous-profile.png"`가 마스킹 대상 donation item의 `profileImageUrl`이 되고 CDN에서 실제 접근 가능하면 범위 한정 Gate를 완료한다. 전체 suite 결과는 별도로 기록한다.
|
||||
|
||||
**수동 검증:**
|
||||
|
||||
- [x] SpringBootTest/H2/MockMvc 요청으로 creator, donor, USER, 별도 CREATOR role을 검증했다. 별도 live server HTTP 요청은 실행하지 않았다.
|
||||
- [x] 타인 응답에서 마스킹 대상 secret item의 원문 부재, public/own donation 보존, 목록 DTO의 신규 ID 부재를 검증했다.
|
||||
- [x] 설정된 CDN URL의 접근 결과는 HTTP 200, `image/png`, 19,331 bytes다. 업로드 작업은 하지 않았다.
|
||||
- [x] 랭킹의 기존 식별 정보 및 secret contribution 집계와 전역 익명성이 아니라는 제한을 유지했다.
|
||||
|
||||
## 실행 순서와 의존성
|
||||
|
||||
| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
|
||||
|---:|---|---|---|---|
|
||||
| 1 | `P1-T1` | 없음 | 아니요 | RED/GREEN 테스트의 실패 위치 판정 |
|
||||
| 2 | `P1-T2` | `P1-T1` 완료 | 아니요 | donation 변경과 직접 테스트에서 실패 위치 판정 |
|
||||
| 3 | `P1-GATE` | `P1-T1`, `P1-T2` 완료 | 아니요 | 운영 CDN 접근 실패 시 blocker 유지 |
|
||||
|
||||
```text
|
||||
P1-T1 → P1-T2 → P1-GATE 범위 한정 완료
|
||||
```
|
||||
|
||||
## 변경 금지 항목
|
||||
|
||||
- Query의 secret filtering을 제거하는 시점에 service masking과 E2E 증거를 함께 완성한다. raw 비밀 필드를 공개하는 중간 배포를 하지 않는다.
|
||||
- 월 경계, 홈 limit 8, donation default/page size, 최신순 tie-breaker, 인증·block·creator validation을 바꾸지 않는다.
|
||||
- 기존 랭킹 query/DTO를 수정하지 않는다.
|
||||
- 익명 이미지 URL은 `"$cloudFrontHost/profile/anonymous-profile.png"`로 확정되었고 설정된 CDN에서 접근 확인했다. 업로드는 수행하지 않았다. 공개/본인 profile 및 기존 default-profile fallback은 변경하지 않는다.
|
||||
- 신규 memberId/donationId를 노출하거나 테스트를 삭제·skip·완화하지 않는다.
|
||||
- [`docs/20260622_크리에이터_채널_후원_탭_API/prd.md`](../20260622_크리에이터_채널_후원_탭_API/prd.md)는 편집하지 않는다.
|
||||
|
||||
## 의사결정 및 중단 규칙
|
||||
|
||||
- `P1-T1`과 `P1-T2`는 확정된 파일명·URL 계약으로 구현 완료했다. 설정된 CDN 접근 검증을 마쳤다. 전체 suite timeout은 범위 한정 Gate의 성공과 구분한다.
|
||||
- EN/JA는 사용자 승인 문구가 아닌 작성자 기술 초안이다. implementation review에서 승인/수정 확인을 기록하며 사용자 확정 문구로 간주하지 않는다.
|
||||
- 회귀가 발견되면 해당 Task의 새 회귀 수정 체크박스와 증거를 계획에 추가한 뒤 수정한다. 성공을 추정하지 않는다.
|
||||
|
||||
### Phase 2: 응답 isSecret을 익명 UI 표시 여부로 변경
|
||||
|
||||
**결과:** 두 탭에서 익명 표시가 필요한 타인의 비밀 후원만 `isSecret=true`를 반환한다. Phase 1 완료 기록은 당시 저장값 전달 계약의 이력으로 보존하며 현재 의미는 이 Phase가 우선한다.
|
||||
|
||||
- [x] **Task 2.1: 조회자별 UI flag 전달**
|
||||
|
||||
**Goal `P2-T1`:** 기존 마스킹 판정과 응답 flag를 일치시키되 DB 비밀 설정과 나머지 응답·권한 정책을 유지한다.
|
||||
- 시작 조건: PRD `DEC-008` 승인. 현재 `test` 브랜치에서 진행, worktree·commit·push 없음.
|
||||
- 완료 증거: 기존 HTTP 역할/언어 매트릭스 RED→GREEN, 두 기능 회귀 성공, DB 비밀값 불변과 owner 전용 donationId/숨김 회귀 통과.
|
||||
- 범위 밖: DB/record/쿼리 수정, 추가 응답 필드, 숨김·랭킹·인증·시각 정책 변경.
|
||||
|
||||
**Files:**
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryService.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryService.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryServiceTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryServiceTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationEndToEndTest.kt`
|
||||
|
||||
**Interface:** 로컬 mapper에서 응답 domain 생성 인자 `isSecret = isMasked`를 사용한다. 입력 record의 실제 비밀값·기존 mapper signature 및 DTO signature는 유지한다.
|
||||
|
||||
- [x] **RED:** 기존 두 HTTP E2E 및 service 테스트에서 내 채널/본인 비밀 후원의 flag 기대값을 false로, 타인 비밀은 true로 변경했다. 공개·타인 CREATOR·언어·내용·이미지·금액·시각·donationId assertion은 유지했다.
|
||||
- [x] **RED 확인:** 두 E2E 메서드 실행은 컴파일 성공 후 `:test` 단계에서 600000ms timeout으로 assertion 결과를 얻지 못했다. 두 service의 역할별 메서드만 실행해 22개 중 8개에서 expected false / actual true 실패를 확인했다. HTTP 검증은 환경 지연 원인을 조사한 뒤 별도로 완료한다.
|
||||
- [x] **GREEN:** 두 서비스의 반환 `isSecret` 값만 `isMasked`로 바꿨다. 테스트는 fixture/id/can으로 원본 공개·비밀 row를 선택하며 소유자의 응답 flag로 원본 비밀 여부를 추정하지 않는다.
|
||||
- [x] **GREEN 확인:** 두 service 46개, 관련 패키지 196개 및 최종 HTTP E2E 55개가 통과했다. 조회 후 별도 트랜잭션 clear/재조회로 DB 비밀값 보존을 확인했다.
|
||||
- [x] **REFACTOR:** 추가 추상화 없이 기능별 회귀·lint 성공과 독립 검토 승인을 기록했다. repository record의 실제 비밀값 assertion은 변경하지 않았다.
|
||||
|
||||
**Goal `P2-GATE`:** 두 기능의 새 flag 계약 및 직접 영향 회귀를 판정한다.
|
||||
- 시작 조건: `P2-T1` 구현 및 검증 완료.
|
||||
- 완료 증거: 아래 명령 성공과 독립 검토. 전체 테스트는 사용자가 `./gradlew test`로 실행한다.
|
||||
- TDD 예외 사유: 검증 전용 Goal이며 제품 코드를 추가하지 않는다.
|
||||
- 대체 검증: 실제 SpringBootTest/H2/MockMvc 요청 결과와 DB 재조회 assertion, 코드 리뷰 대조.
|
||||
|
||||
```bash
|
||||
./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.*' ktlintCheck
|
||||
```
|
||||
|
||||
실행 순서: `P2-T1` → `P2-GATE`. 이번 변경에서는 전체 테스트를 자동 실행하지 않는다.
|
||||
|
||||
- [x] `P2-GATE`: 관련 기능 회귀, 실제 HTTP/MockMvc 응답, DB 불변, ktlint 및 독립 검토 통과.
|
||||
|
||||
## Progress
|
||||
|
||||
### 응답 isSecret 의미 변경 커밋 전 재검증: 2026-11-05
|
||||
|
||||
- 사용자 `/commit-with-validation` 요청에 따라 기존 구현 변경을 커밋한다. 구현 단계의 커밋 미실행 기록은 당시 이력으로 보존한다.
|
||||
- 실행 명령: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests '*CreatorChannelHomeQueryServiceTest' --tests '*CreatorChannelDonationQueryServiceTest' --tests '*CreatorChannelHomeEndToEndTest' --tests '*CreatorChannelDonationEndToEndTest' ktlintCheck --console=plain`.
|
||||
- 결과: exit 0, `BUILD SUCCESSFUL`, 2분 27초. 네 클래스 101개 테스트, 실패·오류·skip 0. `ktlintCheck`는 `UP-TO-DATE`로 통과했다.
|
||||
- `git diff --check` 통과. 전체 테스트는 실행하지 않았으며 사용자 실행 명령은 `./gradlew test`다.
|
||||
|
||||
### P2-GATE 완료 증거
|
||||
|
||||
- 관련 service 두 클래스 46개 및 `ktlintCheck` 성공. 이어 네 home/donation 패키지를 위 명령으로 검증했다 (`--tests` 패턴 앞에 `*` 사용, `--info --console=plain` 추가). 15개 클래스·196개 테스트, 실패·오류·skip 0, exit 0, 1분 32초. 기존 숨김·owner donationId·정산·랭킹 회귀 포함.
|
||||
- 독립 정적 리뷰 APPROVE: production 변경은 두 반환 할당뿐이며, 저장값과 익명 내용·기존 권한/필드 구조 보존을 확인했다.
|
||||
- 부모 최종 실행: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests '*CreatorChannelHomeEndToEndTest' --tests '*CreatorChannelDonationEndToEndTest' ktlintCheck bootJar --console=plain`. exit 0, 1분 45초. home 18 + donation 37 = 55개, 실패·오류·skip 0. `bootJar` 성공, lint 직전 성공 결과 재사용.
|
||||
- Surface: RANDOM_PORT/TestRestTemplate/실제 JWT 요청과 MockMvc 역할·언어 매트릭스를 구분해 검증했다. 동일 비밀행의 owner/donor GET은 원문과 false, outsider GET은 익명과 true다. 기존 owner-only donationId, 숨김 후 최신 목록 보충 및 DB 원본 불변 assertion 통과.
|
||||
- 초기 HTTP timeout은 재현되지 않았다. 진단 실행의 donation/home Spring 시작은 각각 약 25.7초/11.7초였으며, 소유 Test Executor 스레드 덤프는 repository 초기화 중 RUNNABLE 상태였고 이후 정상 종료했다. 과거 timeout 원인은 미확정이며 설정을 변경하지 않았다.
|
||||
- 범위 밖 관찰: H2의 background scheduler에서 `FOR UPDATE SKIP LOCKED` 문법 오류 로그가 있었으나 관련 테스트 실패는 없었다. 원인을 이번 변경이나 timeout으로 단정하거나 수정하지 않았다.
|
||||
- Kotlin LSP 미설치/도구 부재로 LSP 통과 주장은 하지 않는다. 관련 Kotlin 컴파일과 lint로 검증했다. 전체 테스트·운영 데이터/CDN 재검증·커밋·푸시는 수행하지 않았다. 전체 테스트 사용자 명령: `./gradlew test`.
|
||||
|
||||
### P2-T1 RED 및 최소 변경
|
||||
|
||||
- HTTP RED 명령: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests '*CreatorChannelHomeEndToEndTest.shouldMaskOnlyOtherMembersSecretDonationsThroughHttp*' --tests '*CreatorChannelDonationEndToEndTest.shouldMaskOnlyOtherMembersSecretDonationsThroughHttp*'`. 컴파일 성공 후 `:test`에서 10분 timeout; RED assertion 증거로 간주하지 않는다.
|
||||
- 대체 RED 명령: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests '*CreatorChannelHomeQueryServiceTest.shouldMaskSecretDonationOnlyForOtherViewers*' --tests '*CreatorChannelDonationQueryServiceTest.shouldMaskSecretDonationOnlyForOtherViewers*'`. 55초, 22개 중 8개 expected false / actual true 실패. 본인 및 채널 주인의 저장된 비밀 후원에서 기대와 다름을 확인했다.
|
||||
- 그 뒤 production은 두 서비스의 `isSecret = isSecret`을 `isSecret = isMasked`로 바꾼 2줄만 수정했다. repository/record/DB 및 기존 donationId 판정은 변경하지 않았다.
|
||||
- 전체 테스트는 실행하지 않는다. 기존 기능별 HTTP/서비스 테스트와 직접 영향 package 회귀만 실행하며, 전체 검증은 사용자 명령 `./gradlew test`로 분리한다.
|
||||
|
||||
### 커밋 전 재검증: 2026-11-04
|
||||
|
||||
- 사용자 `/commit-with-validation` 요청으로 기존 변경의 커밋을 진행한다. 이전 구현 단계의 커밋 미실행 기록은 당시 상태로 보존한다.
|
||||
- 실행: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.*' ktlintCheck`
|
||||
- 결과: exit 0, `BUILD SUCCESSFUL` 1분 56초. XML 13개에서 home 89개와 donation 63개, 총 152개 테스트의 실패·오류·skip 0을 확인했다. lint는 `UP-TO-DATE`이며 `git diff --check`도 통과했다.
|
||||
- 이번 검증에서 전체 테스트, `bootJar`, live server 및 CDN 접근은 재실행하지 않았다. 기존 전체 suite timeout 이력은 유지하며, 최신 실행 지침에 따라 전체 테스트는 사용자가 `./gradlew test`로 실행한다.
|
||||
|
||||
### 현재 완료 상태: 2026-11-04
|
||||
|
||||
- 상태: `P1-T1`, `P1-T2` 구현 및 독립 리뷰 승인 완료. `P1-GATE`는 아래 범위 한정 검증 완료. 전체 프로젝트 suite는 timeout으로 결과 미확정이며 전체 suite 통과 또는 전체 release 검증 완료로 표시하지 않는다.
|
||||
- 통합 검증: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.*' ktlintCheck bootJar` exit 0, `BUILD SUCCESSFUL` 49s. 총 152 tests (home 89, donation 63), failures/errors/skipped 0. 출력 artifact: `build/libs/sodalive-0.0.1-SNAPSHOT.jar`.
|
||||
- 이미지 접근: `CLOUD_FRONT_HOST/profile/anonymous-profile.png` 요청은 host를 출력하거나 기록하지 않고 HTTP 200, `image/png`, 19,331 bytes를 반환했다. 자산 업로드는 하지 않았다.
|
||||
- Surface 검증은 SpringBootTest/H2/MockMvc의 실제 endpoint 요청 경로다. 별도 live server/curl 요청은 하지 않았다.
|
||||
- 전체 프로젝트 `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test`는 `:test`에서 600000ms tool timeout에 도달했다. 최종 결과가 없고 실패 assertion도 출력되지 않았으므로 성공/실패 어느 쪽으로도 판정하지 않는다. 이후 Gradle/Test/Redis 프로세스가 남지 않았음을 확인했다.
|
||||
- 독립 reviewer는 P1-T2와 전체 feature를 승인했으며 blocker가 없었다. 홈의 2026년 12월 월 경계 결함 수정은 T1 Progress 기록에 보존되어 있다.
|
||||
- Kotlin LSP 진단은 도구 부재로 수행할 수 없었다. home은 11개 변경 파일, donation은 executor에서 진단 도구를 사용할 수 없었다. 컴파일·lint 성공은 LSP 진단 성공으로 간주하지 않는다.
|
||||
- EN/JA 번역은 기존 문서 결정대로 기술 초안이며 제품 승인 문구로 간주하지 않는다. 커밋, worktree, push, 배포, live application server 실행은 하지 않았다.
|
||||
|
||||
### 이전 실행 기록
|
||||
|
||||
### 문서 작성: 2026-11-04
|
||||
|
||||
- 상태: 계획 작성 완료, 구현 미착수
|
||||
- 무엇을: 요구사항과 구현 경로를 확인하고 PRD 및 goal 실행 계획을 작성했다.
|
||||
- 왜: 구현 전 요구사항과 테스트 가능한 완료 기준을 고정하기 위해서다.
|
||||
- 어떻게:
|
||||
- 샘플 `docs/sample/sample-prd.md`, `docs/sample/sample-plan-task.md` 및 `docs/agent-guides/문서유지보수.md`/`작업절차.md`를 읽었다. 과거 기준 문서는 [`docs/20260622_크리에이터_채널_후원_탭_API/prd.md`](../20260622_크리에이터_채널_후원_탭_API/prd.md)다.
|
||||
- Kotlin source 및 두 기존 `SpringBootTest` MockMvc E2E 파일을 읽고 현재 persistence filter, service mapper, DTO 필드, test fixture 구조를 확인했다.
|
||||
- 문서 전용 작업이므로 Gradle, 테스트, 빌드, 서버 요청은 실행하지 않았다.
|
||||
- 남은 항목: 실제 코드 변경 및 모든 구현 체크박스, 외부 의존 `EXT-001` 이미지 제공/검증.
|
||||
- 다음 행동: `P1-T1`의 첫 RED 테스트를 작성한다. 구현 착수 시 실제 자산 제공 여부를 다시 확인한다.
|
||||
|
||||
### 문서 정합성 검증: 2026-11-04
|
||||
|
||||
- 두 문서를 직접 읽고 인터뷰 결정 및 현재 source/test 구조와 대조했다. 읽기 전용 독립 검토 결과는 APPROVE이며 차단 지적은 없었다.
|
||||
- Node 정적 검사로 문서의 Kotlin 경로 23개와 로컬 링크 8개의 존재, trailing whitespace 없음, 끝 개행, 구현 체크박스 미완료 상태를 확인했다.
|
||||
- 두 Markdown 파일에 `lsp_diagnostics`를 시도했으나 `.md` 서버 미설정으로 진단할 수 없었다. 문서 간 대조와 정적 검사를 대체 근거로 사용했다.
|
||||
- 문서 전용 변경이므로 프로젝트 문서 유지보수 규칙에 따라 Gradle 테스트·빌드·API 실행 검증은 생략했다. 위 미래 구현 검증 명령의 성공을 의미하지 않는다.
|
||||
|
||||
### 이미지 계약 정정: 2026-11-04
|
||||
|
||||
- 기존 Progress 및 `ISSUE-001` 기록은 작성 당시의 filename/path 미제공 상태를 나타내는 역사 기록이다. 이후 사용자 입력으로 filename/path 계약이 제공되어 해당 blocker 상태는 현재 유효하지 않다.
|
||||
- 파일명은 `anonymous-profile.png`이며 URL은 기존 `defaultProfileImageUrl()`과 동일한 직접 host/path 조합인 `"$cloudFrontHost/profile/anonymous-profile.png"`로 확정했다. 테스트 host `https://cdn.test`의 기대 URL은 `https://cdn.test/profile/anonymous-profile.png`다.
|
||||
- 이 계약은 마스킹 대상 비밀 donation item에만 적용한다. 공개 및 본인 원본 profile, 기존 default-profile fallback은 그대로 둔다. 운영 파일 업로드와 실제 CDN 접근 가능성은 검증하지 않았으며 `P1-GATE`에 남는다.
|
||||
- 실행 체크박스는 모두 미완료이며 테스트, 빌드, API 요청, CDN 접근 검증은 수행하지 않았다.
|
||||
|
||||
### P1-T1 구현 및 검토: 2026-11-04
|
||||
|
||||
- 완료: 홈 repository의 비밀행 제외 제거, persisted `isSecret` 전달, ID 기반 마스킹, KO/EN/JA 문구와 익명 프로필 URL을 구현했다.
|
||||
- RED: 기존 E2E에서 `No value at JSON path "$.data.channelDonations[0].isSecret"` assertion 실패를 먼저 확인했다. 확장 테스트에서도 기존 필터의 비밀행 누락을 확인했다.
|
||||
- GREEN: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*'` 성공. 89개, 실패·오류·skip 0 (E2E 18, repository 38, service 23, policy 5, controller 3, facade 2).
|
||||
- 독립 확인: 부모 세션에서 홈 E2E를 같은 옵션으로 재실행하여 성공했다. 변경 파일 11개를 읽고 검토했다.
|
||||
- 리뷰 수정: 테스트의 UTC 월초 `plusMonths` 계산이 12월에 잘못되는 문제를 고정 assertion으로 재현하고 KST 기준 월 이동으로 수정했다. 추가된 테스트 2파일의 ktlint 포맷 위반도 수정했다.
|
||||
- 수정 후 `test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.application.CreatorChannelHomeQueryServiceTest' ktlintCheck` (위 공통 Gradle 옵션) 성공. E2E 18 + service 23, 실패·skip 0. 새 읽기 전용 검토에서 이전 P2 지적 ADDRESSED 및 새 결함 없음 확인.
|
||||
- Kotlin LSP 미설치로 11개 파일 진단 불가. Gradle Kotlin 컴파일 및 ktlint 결과를 기록하며 LSP 통과로 간주하지 않는다.
|
||||
- 실제 API surface는 SpringBootTest/H2/MockMvc 전체 요청 경로로 확인했다. 운영 CDN 접근은 아직 미검증이며 Gate에서 별도로 판정한다.
|
||||
|
||||
### P1-GATE 이미지 사전 검증: 2026-11-04
|
||||
|
||||
- 환경의 `CLOUD_FRONT_HOST`가 설정되어 있음을 확인하고, host 값을 출력하지 않은 채 `curl --silent --show-error --max-time 20 --output /dev/null --write-out 'HTTP_STATUS=%{http_code}\nCONTENT_TYPE=%{content_type}\nSIZE_DOWNLOAD=%{size_download}\n' "$CLOUD_FRONT_HOST/profile/anonymous-profile.png"`를 실행했다.
|
||||
- 결과: HTTP 200, Content-Type `image/png`, 다운로드 크기 19,331바이트. 설정된 CDN의 실제 익명 이미지 접근 가능성을 확인했다. 자산 업로드·수정은 하지 않았다.
|
||||
- 이미지 접근 조건만 충족했으며, `P1-T2`와 통합 회귀·리뷰가 끝나기 전 전체 Gate는 완료하지 않는다.
|
||||
|
||||
### P1-T2 구현 및 통합 Gate: 2026-11-04
|
||||
|
||||
- T2 RED: production 변경 전 MockMvc E2E 5개 중 1개가 `$.data.donations[0].isSecret` 누락 assertion으로 실패했다. T2 GREEN: donation 패키지 63 tests와 `ktlintCheck` 통과. 역할별 마스킹, count/page, KST 경계, KO/EN/JA 및 legacy ranking 회귀를 검증했다. E2E 21, repository 14, service 17, policy 5, controller 2, facade 2, legacy ranking adapter 2개가 통과했다. 결과 XML과 HTML은 `build/test-results/test/`, `build/reports/tests/test/`에 있다.
|
||||
- 통합 명령은 위 현재 완료 상태에 기록한 home/donation 4 package 패턴, `ktlintCheck`, `bootJar`를 함께 실행했으며 152/152 tests, lint 및 jar 성공으로 끝났다. jar 경로는 `build/libs/sodalive-0.0.1-SNAPSHOT.jar`다.
|
||||
- CDN 이미지 확인은 HTTP 200, `image/png`, 19,331 bytes였다. host는 로그에 기록하지 않았다. 자산 업로드는 하지 않았다.
|
||||
- 독립 reviewer는 P1-T2와 전체 feature를 승인했고 blocker가 없었다.
|
||||
- 전체 프로젝트 suite 추가 실행은 `:test` 단계에서 600000ms timeout에 도달해 최종 결과를 얻지 못했다. 실패 assertion 출력은 없었지만 suite 통과로 간주하지 않는다. 프로세스 확인에서 남은 Gradle/Test/Redis 프로세스는 없었다.
|
||||
- LSP 진단은 home 11개 파일 및 donation에서 사용 가능한 도구가 없어 완료되지 않았다. Kotlin 컴파일과 ktlint 결과만 검증 근거다. 실제 live server 요청은 없으며 surface QA는 MockMvc 경로로 한정한다.
|
||||
- EN/JA는 기존 기술 초안 상태를 유지하며 제품 승인으로 변경하지 않는다. commit/worktree/push/deploy는 없었다.
|
||||
|
||||
## Decision Log
|
||||
|
||||
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
|
||||
|---|---|---|---|---|---|
|
||||
| 2026-11-04 | `DEC-001` | 확정 | 홈 및 후원 탭을 각각 저장소·service·DTO·E2E까지 완료하는 bounded Task로 나눈다. | 서로 다른 domain port와 DTO, 독립 E2E가 존재 | `P1-T1`, `P1-T2` |
|
||||
| 2026-11-04 | `DEC-002` | 확정 | 기존 local mapper와 CDN 변환을 사용하고 공용 masking abstraction 및 port signature 변경을 만들지 않는다. | 현재 service 구현 방식과 최소 변경 | `P1-T1`, `P1-T2` |
|
||||
| 2026-11-04 | `DEC-003` | 확정 (과거 기록, `DEC-004`로 정정) | 익명 이미지 자산은 P0 외부 의존이며 경로 검증 전 Gate를 통과시키지 않는다. | 사용자 제공 자산 필요 | `EXT-001`, `P1-GATE` |
|
||||
| 2026-11-04 | `DEC-004` | 확정 | 사용자가 제공한 파일명은 `anonymous-profile.png`; 기존 default-profile 방식대로 `cloud.aws.cloud-front.host`에 `/profile/anonymous-profile.png`를 직접 붙인다. URL 계약은 확정됐지만 운영 CDN 접근은 미검증이다. | 사용자 입력과 두 query service의 기존 defaultProfileImageUrl 근거 | `P1-T1`, `P1-T2`, `P1-GATE`, `ISSUE-001` |
|
||||
| 2026-11-04 | `DEC-005` | 확정 | 익명 이미지는 마스킹 대상 비밀 donation item에만 쓰고 공개/본인 원본 profile과 기존 default-profile fallback은 보존한다. | 기존 표시 정책 유지 | `P1-T1`, `P1-T2` |
|
||||
|
||||
## 발견된 문제
|
||||
|
||||
| ID | 심각도 | 상태 | 발견 내용 | 영향 Goal | 처리 계획 |
|
||||
|---|---|---|---|---|---|
|
||||
| `ISSUE-001` | Blocker | 해결 | 파일명·URL 계약 및 설정된 CDN 접근 검증을 완료했다. 별도의 전체 suite timeout은 제품 버그로 분류하지 않고 현재 검증 한계로 기록한다. | `P1-GATE` | 추가 조치 없음. 전체 suite 결과는 미확정이며 통과로 주장하지 않는다. |
|
||||
@@ -0,0 +1,184 @@
|
||||
# 크리에이터 채널 비밀 후원 익명 조회 PRD
|
||||
|
||||
## 문서 정보
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 문서 상태 | 응답 isSecret UI 표시 의미 변경 및 관련 기능 검증 완료 (`P2-GATE`) |
|
||||
| 작성일 | 2026-11-04 |
|
||||
| 최종 수정일 | 2026-11-04 |
|
||||
| 대상 제품 | 크리에이터 채널 비밀 후원 익명 조회 |
|
||||
| 작성자·결정권자 | 제품 요청 기준 |
|
||||
| 관련 API Contract | 이 문서 §8 |
|
||||
| 관련 구현 계획 | [plan-task.md](plan-task.md) |
|
||||
| 관련 review | 없음 |
|
||||
|
||||
## 1. Overview
|
||||
|
||||
크리에이터 채널 홈과 후원 탭에서 비밀 후원 행은 그대로 보이되, 크리에이터와 후원자 본인 외의 조회자에게 후원자의 식별 정보와 메시지를 숨긴다. 응답 `isSecret`은 현재 조회자에게 익명 UI로 표시해야 하는지를 나타낸다. 마스킹 대상 비밀 후원 이미지 URL은 기존 `default-profile`과 같은 방식으로 `cloud.aws.cloud-front.host`에 `/profile/anonymous-profile.png`를 붙여 구성한다. 최초 구현 검증 이력은 보존하고, 후속 의미 변경은 `P2-T1`에서 별도로 검증한다.
|
||||
|
||||
## 2. Problem Statement
|
||||
|
||||
현재 두 조회 경로는 비밀 후원을 일반 조회자에게 결과에서 제거한다. 그 결과 후원 건수와 목록의 의미가 조회자에 따라 달라지고, 사용자는 비밀 후원이 있었는지 확인할 수 없다. 해결 후에는 건수와 행은 유지하면서 권한에 맞게 표시 필드만 가려야 한다.
|
||||
|
||||
## 3. Goals
|
||||
|
||||
### 3.1 제품 목표
|
||||
|
||||
- 홈의 `channelDonations`와 후원 탭 `donations`에 현재 KST 월의 비밀 후원을 포함한다.
|
||||
- 비밀 후원에 한해 크리에이터 본인 또는 해당 후원자 본인에게 원래 닉네임, 메시지, 프로필 이미지를 보여 준다. 공개 후원은 기존처럼 모든 인증 조회자에게 원본을 보여 준다.
|
||||
- 비밀 후원의 나머지 조회자에게 확정된 익명 표시 문구와 `"$cloudFrontHost/profile/anonymous-profile.png"` 이미지를 보여 준다. 공개 후원과 크리에이터·후원자 본인의 프로필 이미지 및 기존 default-profile fallback은 변경하지 않는다.
|
||||
- 두 응답의 `isSecret`은 현재 조회자에게 익명 후원 UI로 표시해야 하는지를 나타낸다. DB의 실제 비밀 여부는 변경하지 않는다.
|
||||
|
||||
### 3.2 UX 목표
|
||||
|
||||
- 익명화된 후원도 목록의 건수와 정렬을 유지해 숨겨진 행으로 오해되지 않게 한다.
|
||||
- 메시지가 null 또는 빈 문자열이어도 비공개 문구를 표시한다.
|
||||
|
||||
## 4. Non-Goals
|
||||
|
||||
- 후원 작성, 수정, 취소, DB 스키마 또는 DDL 변경.
|
||||
- 공개 후원의 표시 변경.
|
||||
- 랭킹의 노출·집계·익명성 변경. 기존 랭킹 식별 정보와 비밀 후원 집계는 유지한다.
|
||||
- 플랫폼 전체에서 후원자를 알아볼 수 없게 하는 익명성 보장. 이 변경은 두 목록의 특정 필드만 가린다.
|
||||
- 인증, 차단, 크리에이터 검증, API route, pagination 정책 변경.
|
||||
- 기존 `20260622` 문서 수정. 본 문서는 목록의 비밀 후원 노출, 건수 및 `isSecret` 표시 범위에 한해 후속 기준이며 그 외 역사적 결정은 대체하지 않는다.
|
||||
|
||||
## 5. Target Users and Permissions
|
||||
|
||||
| 사용자 | 조회 결과 |
|
||||
|---|---|
|
||||
| 채널 크리에이터 (`viewerId == creatorId`) | 공개 및 비밀 후원 모두 원본 필드 |
|
||||
| 후원자 본인 (`viewerId == donor.memberId`) | 자신의 공개 및 비밀 후원 원본 필드 |
|
||||
| 그 외 인증 조회자 | 공개 후원은 원본 필드, 비밀 후원은 행을 유지하고 닉네임·메시지·프로필 이미지를 익명 표시 |
|
||||
|
||||
- 기존 인증 및 크리에이터 조회 권한을 그대로 적용한다.
|
||||
- 기존 차단 확인과 크리에이터 역할 검증을 변경하지 않는다.
|
||||
- 이번 후속 변경은 새 `memberId`나 식별 필드를 추가하지 않으며, 현재 구현의 채널 주인 전용 `donationId` 반환 정책을 유지한다.
|
||||
|
||||
## 6. 핵심 사용자 흐름
|
||||
|
||||
1. 인증 사용자가 크리에이터 채널 홈 또는 후원 탭을 조회한다.
|
||||
2. 서버는 기존 권한·차단·크리에이터 검증을 수행하고 현재 KST 월 후원 목록을 가져온다.
|
||||
3. 비밀 후원은 크리에이터와 해당 후원자만 원본 필드를 받고, 그 외 조회자는 익명화된 값을 받는다. 공개 후원은 기존대로 인증 조회자에게 원본 필드를 제공한다.
|
||||
4. 클라이언트는 응답 `isSecret` 하나로 익명 후원 UI를 선택한다. 기존 정렬·건수·pagination은 유지한다.
|
||||
|
||||
## 7. 기능 요구사항
|
||||
|
||||
요구사항과 파일명·URL 구성 계약은 확정됐고 구현됐다. 설정된 CDN에서 익명 이미지 URL의 실제 접근도 확인됐다.
|
||||
|
||||
| ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 |
|
||||
|---|---|---|---|---|
|
||||
| `SDA-001` | 확정 | 홈 `channelDonations`에 현재 KST 월의 공개·비밀 후원을 포함한다. | 현재 월 경계 포함, 이전·다음 월 제외, 전체 후보에서 최신 최대 8건, `createdAt`/id 내림차순. 홈 count 필드는 추가하지 않는다. | §8.1~§8.2, `P1-T1` |
|
||||
| `SDA-002` | 확정 | 후원 탭 `donations`와 `donationCount`에 현재 KST 월의 공개·비밀 후원을 포함한다. | count가 공개/비밀 전체와 일치하고 기존 페이지 경계를 유지 | §8.1~§8.2, `P1-T2` |
|
||||
| `SDA-003` | 확정 | 비밀 후원은 본인 또는 크리에이터에게 원본 필드를 반환하고, 공개 후원은 기존처럼 모든 인증 조회자에게 원본을 반환한다. | 비밀의 경우 `viewerId == creatorId` 또는 `viewerId == donor.memberId`; 공개 행은 인증 viewer 모두 nickname/message/profile 원본 | §8.3, `P1-T1`, `P1-T2` |
|
||||
| `SDA-004` | 확정 | 비밀 후원의 나머지 조회자에게 해당 행 필드만 익명화한다. | 닉네임 `익명`, 메시지 `크리에이터에게만 보여요`, 프로필 URL은 `"$cloudFrontHost/profile/anonymous-profile.png"` | §8.3, `P1-T1`, `P1-T2`, `EXT-001` |
|
||||
| `SDA-005` | 정정 확정 | 응답 `isSecret`은 현재 조회자에게 익명 처리된 항목일 때만 true다. | 공개·본인 후원·내 채널 후원은 false, 다른 채널의 타인 비밀 후원은 true. DB 원본은 보존 | §8.1~§8.2, `P2-T1` |
|
||||
| `SDA-006` | 확정 | 익명 닉네임과 메시지 문구를 요청 언어에 맞춰 반환한다. | `Lang.KO/EN/JA`와 기존 `SodaMessageSource` 사용, 두 key 모두 언어별 값, KO 문구 정확 일치 | §8.3, `P1-T1`, `P1-T2` |
|
||||
| `SDA-007` | 완료 | 익명 프로필 이미지 파일명은 `anonymous-profile.png`; URL은 `"$cloudFrontHost/profile/anonymous-profile.png"`로 구성한다. | 설정된 CDN에서 HTTP 200, `image/png`, 19,331 bytes를 확인했다. | `EXT-001`, `P1-GATE` |
|
||||
|
||||
## 8. API 계약
|
||||
|
||||
### 8.1 공통 동작
|
||||
|
||||
- 기존 인증, block 검사, creator 검증과 응답 envelope를 유지한다.
|
||||
- 현재 KST 월 시작은 inclusive, 다음 KST 월 시작은 exclusive이며 저장·비교 시간 변환 규칙은 기존 구현을 유지한다.
|
||||
- 최신순은 `createdAt DESC, donation.id DESC`다.
|
||||
- 응답 `isSecret = 저장된 isSecret && viewerId != creatorId && viewerId != donorId`다. 공개 후원·본인이 한 비밀 후원·내 채널의 비밀 후원은 false, 다른 채널에서 타인이 한 비밀 후원만 true다.
|
||||
- 응답값은 실제 비밀 설정을 설명하지 않고 익명 UI 표시 여부만 나타낸다. DB와 repository record의 `isSecret`은 저장값 그대로 유지한다. `isMyDonation` 등 추가 필드는 만들지 않는다.
|
||||
- `can`과 `createdAtUtc`는 실제 값 그대로 반환한다.
|
||||
- 새 donor `memberId`나 추가 식별 필드를 만들지 않는다. 후속 기능으로 도입된 채널 주인 전용 `donationId` 노출 및 후원 숨김 정책은 이번 변경에서 그대로 유지한다.
|
||||
|
||||
### 8.2 Endpoint 계약
|
||||
|
||||
| 조회 대상 | 응답 `isSecret` | 표시 정보 |
|
||||
|---|---|---|
|
||||
| 공개 후원 | false | 원본 |
|
||||
| 내가 한 비밀 후원 | false | 원본 |
|
||||
| 내 채널의 비밀 후원 | false | 원본 |
|
||||
| 다른 채널에서 타인이 한 비밀 후원 | true | 익명 처리 |
|
||||
|
||||
| Method 및 경로 | 응답 필드 | 목록 및 page 규칙 |
|
||||
|---|---|---|
|
||||
| `GET /api/v2/creator-channels/{creatorId}/home` | `data.channelDonations[]`에 `nickname`, `profileImageUrl`, `can`, `message`, `createdAtUtc`, `isSecret` | 현재 월 전체 대상 중 최신 최대 8건 |
|
||||
| `GET /api/v2/creator-channels/{creatorId}/donations` | `data.donations[]`에 같은 후원 필드와 `isSecret`, `data.donationCount` | 기본 page `0`, 기본 size `20`, size `20..50`, hasNext 기존 규칙 |
|
||||
|
||||
### 8.3 익명화 및 현지화
|
||||
|
||||
마스킹 대상 비밀 후원의 `profileImageUrl`은 `cloud.aws.cloud-front.host`를 사용하는 기존 `defaultProfileImageUrl()`과 동일한 직접 문자열 조합으로 `"$cloudFrontHost/profile/anonymous-profile.png"`를 만든다. 이는 임의 사용자 제공 경로에 `toCdnUrl`을 적용하는 계약이 아니다. 기존 구현 근거는 `CreatorChannelHomeQueryService.kt:258`과 `CreatorChannelDonationQueryService.kt:114`의 `defaultProfileImageUrl(): String = "$cloudFrontHost/profile/default-profile.png"`이다. `https://cdn.test`를 host로 쓰는 테스트 기대 URL은 `https://cdn.test/profile/anonymous-profile.png`다.
|
||||
|
||||
이 익명 URL은 **마스킹 대상 비밀 후원 행에만** 사용한다. 공개 후원과 크리에이터·해당 후원자 본인의 원본 프로필 이미지 및 기존 `default-profile.png` fallback은 그대로 유지한다. 설정된 CDN에서 해당 경로의 이미지 접근을 확인했다. 이 검증은 업로드 주체나 별도 운영 배포 상태를 확인한 것은 아니다.
|
||||
|
||||
기존 `SodaMessageSource`에서 다음 key를 `Lang.KO`, `Lang.EN`, `Lang.JA`별로 제공한다.
|
||||
|
||||
| Key | KO | EN 기술 초안 | JA 기술 초안 |
|
||||
|---|---|---|---|
|
||||
| `explorer.channel_donation.anonymous.nickname` | `익명` | `Anonymous` | `匿名` |
|
||||
| `explorer.channel_donation.anonymous.message` | `크리에이터에게만 보여요` | `Only visible to the creator` | `クリエイターにのみ表示されます` |
|
||||
|
||||
EN/JA 문구는 사용자가 명시 승인한 문구가 아니며 작성자의 기술 초안이다. 구현 review에서 제품 문구 확인 대상으로 고정하고 `SodaMessageSource` 외부 번역 서비스를 도입하지 않는다. null 또는 빈 원본 메시지에도 익명 조회자는 위 문구를 받는다.
|
||||
|
||||
### 8.4 랭킹 제한
|
||||
|
||||
랭킹 query·응답·가시성·합계를 변경하지 않는다. 랭킹의 `userId`, 닉네임, 프로필은 기존 규칙대로 노출될 수 있고 집계에는 비밀 후원 기여분이 포함된다. 따라서 이 기능만으로 전체 서비스 차원의 후원자 익명성이 보장되지 않는다.
|
||||
|
||||
## 9. 외부 의존
|
||||
|
||||
| ID | 우선순위 | 제공 필요 계약 | 담당 주체 | 구현 영향 | 재개 조건 |
|
||||
|---|---:|---|---|---|---|
|
||||
| `EXT-001` | 완료 | 파일명 `anonymous-profile.png`; URL 계약 `"$cloudFrontHost/profile/anonymous-profile.png"` (`cloud.aws.cloud-front.host` 사용) | 사용자/제품 자산 제공자 | 익명 조회자의 이미지 필드. 설정된 CDN에서 접근 확인 | HTTP 200, `image/png`, 19,331 bytes 확인. 업로드 작업은 수행하지 않음 |
|
||||
|
||||
테스트 host `https://cdn.test`의 정확한 기대 URL은 `https://cdn.test/profile/anonymous-profile.png`다. 신규 config, fallback, 공통 helper 또는 임의 사용자 경로용 `toCdnUrl`은 추가하지 않는다. 설정된 CDN 접근 검증은 통과했다. 저장소 필터를 없애 raw secret 필드를 반환하는 코드를 먼저 배포해서는 안 된다.
|
||||
|
||||
## 10. 보안과 데이터 취급
|
||||
|
||||
- 익명화는 응답 DTO 이전 서버 서비스 변환에서 수행한다. 익명 뷰어에게 raw 비밀 필드를 보내지 않는다.
|
||||
- 저장소가 비밀 행을 조회하도록 바뀌어도 원본 값이 API 출력·로그·오류에 노출되지 않게 서비스 경계를 검증한다.
|
||||
- 이 변경으로 donor ID를 새로 반환하지 않는다.
|
||||
- 랭킹의 기존 식별 정보가 목록 마스킹을 우회해 보일 수 있음을 문서화하며 전역 익명성을 약속하지 않는다.
|
||||
|
||||
## 11. 성공 기준과 추적
|
||||
|
||||
### 11.1 수용 기준
|
||||
|
||||
- [x] 홈 `channelDonations`는 전체 현재 월 공개·비밀 후보 중 최신 8건을 유지하며 새 home count 필드를 추가하지 않는다 (`SDA-001`).
|
||||
- [x] 후원 탭 공개/비밀 모두 건수·페이지·hasNext에 포함된다 (`SDA-002`).
|
||||
- [x] 비밀 후원은 크리에이터와 해당 후원자 본인만 원본을 보고 다른 사용자는 익명 문구와 이미지 자산을 본다. 공개 후원은 모두 원본을 본다 (`SDA-003`, `SDA-004`).
|
||||
- [x] 최초 구현에서 저장된 비밀 상태를 Boolean으로 직렬화했다 (과거 기준, `DEC-008`로 의미 변경).
|
||||
- [x] 현재 조회자에게 익명 처리된 항목만 응답 `isSecret=true`이며 원본 반환 항목은 false다. 조회 후에도 DB의 비밀 설정은 동일하다 (`SDA-005`, `P2-T1`).
|
||||
- [x] `can`, `createdAtUtc`, 기존 인증·차단·크리에이터 오류 및 랭킹 동작이 유지된다.
|
||||
- [x] URL 계약과 설정된 CDN 접근을 검증했다. HTTP 200, `image/png`, 19,331 bytes (`SDA-007`).
|
||||
- [x] HTTP MockMvc E2E로 홈과 후원 탭의 익명/본인/크리에이터 응답을 검증했다. 별도 live application server 요청은 수행하지 않았다.
|
||||
|
||||
범위 한정 feature gate는 package tests, `ktlintCheck`, `bootJar`, CDN 접근 검증으로 완료했다. 전체 프로젝트 test suite는 제한 시간 timeout으로 완료되지 않았으며 전체 suite 통과를 뜻하지 않는다.
|
||||
|
||||
### 11.2 추적표
|
||||
|
||||
| 요구사항 | 구현 계획 | 자동 검증 |
|
||||
|---|---|---|
|
||||
| `SDA-001`, `SDA-003`, `SDA-005`, `SDA-006` | `P1-T1` | 홈 repository/service/controller 및 `CreatorChannelHomeEndToEndTest` |
|
||||
| `SDA-002`~`SDA-006` | `P1-T2` | donation repository/service/controller 및 `CreatorChannelDonationEndToEndTest` |
|
||||
| `SDA-007` | `P1-T1`, `P1-T2`, `P1-GATE` | 두 Task는 확정 URL 계약과 기존 이미지 회귀를 검증하고, Gate는 운영 CDN 접근 가능 여부를 검증 |
|
||||
| `SDA-005` 정정 | `P2-T1`, `P2-GATE` | 홈·후원 service/HTTP E2E의 역할별 UI flag, DB 원본 및 기존 donationId/숨김 회귀 |
|
||||
|
||||
## 12. 과거 문서와의 관계
|
||||
|
||||
[`docs/20260622_크리에이터_채널_후원_탭_API/prd.md`](../20260622_크리에이터_채널_후원_탭_API/prd.md)의 문서는 작성 당시의 역사적 기록으로 남긴다. 본 PRD는 홈 및 후원 탭에서 비밀 후원을 제거하던 기존 visibility 동작, 그에 따른 목록 건수, 응답 `isSecret` 부재에 대해서만 후속 기준을 정한다. 랭킹을 비롯한 본 문서에 명시하지 않은 기존 결정은 바꾸지 않는다.
|
||||
|
||||
## 13. Decision Log
|
||||
|
||||
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 |
|
||||
|---|---|---|---|---|---|
|
||||
| 2026-11-04 | `DEC-001` | 확정 | 두 목록은 전체 현재 월 비밀 후원을 포함하고 표시 필드만 권한별 마스킹한다. | 요청에서 확정된 제품 동작 | `SDA-001`~`SDA-006`, §8 |
|
||||
| 2026-11-04 | `DEC-002` | 확정 | `isSecret`은 persisted 비밀 상태를 보여 주며 모든 사용자에게 제공한다. | 요청에서 확정된 API 동작 | `SDA-005` |
|
||||
| 2026-11-04 | `DEC-003` | 확정 | 랭킹은 변경하지 않고 전역 익명성을 보장하지 않는다. | 요청에서 확정된 범위 | §8.4 |
|
||||
| 2026-11-04 | `DEC-004` | 외부 의존 (과거 기록, `DEC-006`으로 정정) | 익명 프로필 이미지는 자산 경로를 받기 전까지 운영 구현 및 완료를 차단한다. | 실제 이미지 제공 필요 | `EXT-001`, `P1-GATE` |
|
||||
| 2026-11-04 | `DEC-005` | 기술 초안 | EN/JA 문구는 작성자 초안으로 구현 review 때 제품 확인한다. | 한국어만 정확 문구 승인됨 | `SDA-006` |
|
||||
| 2026-11-04 | `DEC-006` | 확정 | 사용자가 제공한 익명 이미지 파일명은 `anonymous-profile.png`; 기존 `defaultProfileImageUrl()`과 동일하게 `cloud.aws.cloud-front.host`를 사용해 `"$cloudFrontHost/profile/anonymous-profile.png"`로 직접 구성한다. | 파일명 및 default-profile 구성 방식 사용자 확정. 운영 CDN 접근성은 별도 미검증 | `SDA-007`, `EXT-001`, §8.3 |
|
||||
| 2026-11-04 | `DEC-007` | 확정 | 익명 이미지는 마스킹 대상 비밀 후원 행에만 적용하고 공개/본인 원본 이미지와 기존 default-profile fallback은 보존한다. | 기존 표시 정책 유지 | `SDA-003`, `SDA-004`, §8.3 |
|
||||
|
||||
| 2026-11-04 | `DEC-008` | 정정 확정 | `DEC-002`의 저장값 전달 계약을 대체한다. 응답 isSecret은 익명 UI 표시 여부이며 공개·본인·내 채널은 false, 타 채널 타인 비밀 후원만 true다. DB 저장값, 원본/익명 내용, 기존 donationId와 숨김 정책은 유지한다. | UI에서 실제 비밀 여부 구분이 필요 없다는 사용자 확정 및 수정 요청 | `SDA-005`, §8.1, `P2-T1` |
|
||||
|
||||
## 14. 변경 관리
|
||||
|
||||
요구사항 변경은 Decision Log, 이 PRD, 이 문서 안 API 계약, [plan-task.md](plan-task.md) 순서로 반영한다. 구현 시작 전에는 외부 의존 경계를 다시 확인하고, 진행 체크박스 및 검증 결과를 실제 증거에 따라 누적한다.
|
||||
@@ -0,0 +1,2 @@
|
||||
ALTER TABLE channel_donation_message
|
||||
ADD COLUMN is_hidden TINYINT(1) NOT NULL DEFAULT 0 COMMENT '채널 후원 표시 숨김 여부';
|
||||
@@ -0,0 +1,577 @@
|
||||
# 채널 후원 메시지 숨김 구현 계획
|
||||
|
||||
| 문서 항목 | 내용 |
|
||||
|---|---|
|
||||
| 상태 | 서버 구현·기능 범위 검증·최종 리뷰 완료 |
|
||||
| 작성일 | 2026-11-05 |
|
||||
| 요구사항 기준 | [prd.md](prd.md) |
|
||||
| API 기준 | [prd.md §8](prd.md#8-제안-api-경계-author-technical-draft) |
|
||||
| 현재 Phase | 전체 Phase 완료 |
|
||||
| 현재 활성 Goal | 없음 |
|
||||
| 다음 Goal | 없음. 운영 DDL/배포·프론트엔드는 별도 작업 |
|
||||
|
||||
## 목표와 실행 경계
|
||||
|
||||
**목표:** 소유 CREATOR가 채널 후원 항목을 soft-hide하면 모든 사용자에게 V2 채널 홈과 후원 탭에서 보이지 않고, 원본 후원과 재무 영향은 보존된다.
|
||||
|
||||
사용자의 "문서대로 진행" 요청으로 PRD `DEC-006`의 기술안과 아래 계획 실행을 승인했다. 과거 기록의 초안/미착수 표시는 해당 기록 시점의 상태이며 현재 상태는 상단 표를 따른다. 동시에 하나의 미완료 Goal만 실행하며, Phase 중간 결과를 개별 배포하지 않는다. 배포 시 DDL을 선반영하고 숨김 API와 두 조회 필터를 함께 배포한다. 서버 검증과 프론트엔드 연동 완료는 구분하며, 운영 DDL 실행·배포는 별도 승인 대상이다.
|
||||
|
||||
## 현재 상태
|
||||
|
||||
| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
|
||||
|---:|---|---:|---|---|
|
||||
| 1 | 완료 | `2/2` | 없음 | Gate 및 독립 리뷰 통과 |
|
||||
| 2 | 완료 | `2/2` | 없음 | Gate 및 독립 리뷰 통과 |
|
||||
| 3 | 완료 | `1/1` 및 `P3-R1` | 없음 | 최종 리뷰 승인, 운영 적용 별도 |
|
||||
|
||||
## 범위
|
||||
|
||||
### 포함
|
||||
|
||||
- `ChannelDonationMessage.isHidden` soft-hide 필드 및 운영 반영용 DDL 파일 추가 Task.
|
||||
- 소유 CREATOR 한 명의 단일 donation 숨김 use case와 bodyless DELETE API.
|
||||
- 홈과 탭 목록의 local hidden filter, 탭 count/pagination 및 홈 최대 8건 refill.
|
||||
- 두 V2 응답에 owner-only `donationId` 추가 및 회귀 assertion 조정.
|
||||
- HTTP/repository 통합 테스트로 권한, 데이터 보존, 기존 랭킹/재무 효과 및 legacy API 불변 검증.
|
||||
|
||||
### 제외
|
||||
|
||||
- 운영 DB DDL 실행, 배포 및 공유 인프라 변경. 코드·테스트·DDL 문서 작성은 사용자 승인으로 포함한다.
|
||||
- 복원, hard delete, audit metadata/reason/history, bulk hide, 실시간 push.
|
||||
- legacy/financial/ranking 전역 query 필터, Hibernate 전역 soft-delete annotation.
|
||||
- frontend 파일, 화면/UX 디자인.
|
||||
|
||||
## 기술 초안과 경계
|
||||
|
||||
- 현행 엔티티 `src/main/kotlin/kr/co/vividnext/sodalive/explorer/profile/channelDonation/ChannelDonationMessage.kt`는 `BaseEntity` ID/시간만 상속한다. 권고 변경은 `isHidden: Boolean = false`와 운영 MySQL DDL `is_hidden TINYINT(1) NOT NULL DEFAULT 0 COMMENT '채널 후원 표시 숨김 여부'`다. 구현 전 DDL 위치/운영 schema 적용 절차를 확인한다.
|
||||
- donation 탭 list/count query의 현재 predicate는 creator 및 KST 월 범위다. `isHidden=false`를 두 query 모두에 적용한다. 홈 query도 local `isHidden=false` 필터를 적용하고 기존 8건 한도를 숨김 제외 후 적용한다.
|
||||
- 양 query에 공유 도메인 전역 filter를 만들지 않는다. 숨김 predicate는 공개 후원 탭 및 홈 전용이다. 랭킹 port/adapter, 정산, can usage와 `explorer.profile.channelDonation` legacy query에 추가하지 않는다.
|
||||
- visible 행은 기존 `isSecret` 값과 masking을 보존한다. hidden은 공개/비밀 모두 제외한다.
|
||||
- owner-only `donationId` nullable/omitted JSON 정책을 검증한다. donor `memberId`는 응답하지 않는다. 기존 E2E에서 전 역할 donation ID 부재를 단정한 부분은 소유자 케이스만 ID 기대값으로 바꾸고 비소유 케이스의 부재 assertion을 유지한다.
|
||||
- API 초안은 `DELETE /api/v2/creator-channels/{creatorId}/donations/{donationId}`, body 없음, `ApiResponse.ok` data 없음이다. 인증/도메인 거부는 기존 `SodaException`, i18n, 공통 handler를 재사용하며 HTTP 200 `success=false` 관례와 충돌하는 generic REST 403/404는 만들지 않는다.
|
||||
- `actor.role == CREATOR`, `actor.id == creatorId`, donation ID와 creator ID의 동일 소속을 모두 검증한다. 존재하지 않음 또는 다른 채널의 대상도 변화 없이 거부하고 존재 여부 정보 노출은 기존 domain 오류 패턴으로 제한한다.
|
||||
- 숨김 재요청은 이미 `isHidden=true`이면 성공한다. 원본 저장값을 덮어쓰지 않고 can/refund/ranking/settlement/usage 경계를 호출하지 않는다.
|
||||
|
||||
## 검증 명령 정책
|
||||
|
||||
- 미래 구현에서는 각 Task 아래 명시된 실제 테스트 클래스만 `--tests`로 지정한다. 아래 RED/GREEN 명령은 향후 실행 명령이며 현재 실행하지 않는다.
|
||||
- Phase Gate도 관련 donation/home/legacy HTTP 및 repository 테스트 클래스만 `--tests`로 지정한다. 무필터 테스트를 실행하지 않는다.
|
||||
- 프로젝트 전체 테스트는 사용자가 직접 `./gradlew test`로 실행한다. `check`, `build`, `clean build`도 자동 실행하지 않는다. 미래 빌드/포맷 확인은 필요한 경우 `./gradlew bootJar`, `./gradlew ktlintCheck`만 사용한다.
|
||||
- 미래 구현 전용 명령 예시는 실행 사실이나 성공 기록이 아니다. 테스트 결과, SQL 운영 적용, H2 통합 근거를 실행 후 실제로 기록한다.
|
||||
|
||||
## Review Focus
|
||||
|
||||
- 소유자가 아닌 CREATOR, donor, USER, ADMIN 및 anonymous 요청의 권한/상태 변경 없음: Task 1.2 HTTP 통합 검증.
|
||||
- 경로의 creator와 실제 donation 소속 불일치 또는 ID 미존재: Task 1.2의 forged ID HTTP 검증.
|
||||
- hidden row가 count, offset/page 결과에 남거나 페이지를 덜 채우지 않는지: Task 2.1 repository/HTTP 검증.
|
||||
- home hidden 후보가 최신 8건을 줄이지 않고 visible 최대 8건으로 refill하는지: Task 2.2 home repository/HTTP 검증.
|
||||
- 기록·랭킹·정산·can 사용 및 legacy 출력 불변: `P3-GATE`. owner-only ID와 donor ID 비노출: Task 2.1/2.2 통합 검증.
|
||||
|
||||
### Phase 1: 저장과 소유자 전용 숨김 API
|
||||
|
||||
**Phase 결과:** 소유 CREATOR가 한 donation을 기록 보존형으로 숨기며, 권한 실패/중복 요청도 안전하다.
|
||||
|
||||
**선행조건:** 별도 명시 구현 요청. PRD 제품 결정을 유지하고 §7~§8 기술 초안의 실제 패턴과 DDL 반영 절차를 재확인한다.
|
||||
|
||||
**Phase 완료 조건:** `P1-T1`, `P1-T2`, `P1-GATE` 완료 증거 기록.
|
||||
|
||||
#### Task 1.1: 숨김 저장 모델과 persistence port
|
||||
|
||||
- [x] **Task 1.1 완료:** 아래 TDD 단계와 완료 증거를 충족한다.
|
||||
|
||||
**Goal 실행 `P1-T1`:** donation record에 기본 비숨김 상태를 저장하고 포트가 donation을 채널 범위로 숨길 수 있게 한다.
|
||||
|
||||
- **시작 조건:** 구현 요청 및 `ChannelDonationMessage.kt`, `BaseEntity.kt`, schema/DDL 관례 재확인.
|
||||
- **완료 증거:** entity 매핑, MySQL DDL 파일, repository integration에서 기본 false/true 저장, 동일 채널 한정 및 원본 보존이 확인됨.
|
||||
- **범위 밖:** API wiring, 조회 filter 및 금융 동작 변경.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/explorer/profile/channelDonation/ChannelDonationMessage.kt`
|
||||
- Create: `docs/20261105_채널후원메시지숨김/channel_donation_message_is_hidden_ddl.sql` (작성 완료, 운영 미적용)
|
||||
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/port/out/HideCreatorChannelDonationPort.kt`
|
||||
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultHideCreatorChannelDonationRepository.kt`
|
||||
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultHideCreatorChannelDonationRepositoryTest.kt`
|
||||
|
||||
**Interfaces:**
|
||||
|
||||
- Consumes: existing `ChannelDonationMessage.id`, `creator.id`, mutable JPA entity and project DB mappings.
|
||||
- Produces: entity `isHidden: Boolean = false`; `HideCreatorChannelDonationPort.hideOwnedDonation(creatorId: Long, donationId: Long): Boolean`, true when matching donation exists and is already/now hidden, false otherwise. Repository update must condition by both IDs and leave other fields untouched.
|
||||
|
||||
- [x] **RED:** `shouldHideOnlyDonationOwnedByCreatorAndRetainOriginalValues`에서 기본 false와 숨김 후 can/message/isSecret/member/creator/id 보존을 검증한다.
|
||||
- [x] **RED 확인:** `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest'`를 실행해 새 필드/동작 누락으로 assertion 실패를 확인한다. 컴파일/fixture 오류는 RED 증거가 아니다.
|
||||
- [x] **GREEN:** boolean field, port, 채널+donation 제한 update 및 DDL을 최소 구현한다.
|
||||
- [x] **GREEN 확인:** 같은 focused 명령을 실행해 H2 DB 왕복과 다른 channel ID 무변경이 통과하는지 확인한다.
|
||||
- [x] **REFACTOR:** 이번 Task의 중복만 정리하고 같은 focused test 및 `./gradlew ktlintCheck`를 실행해 결과를 기록한다.
|
||||
|
||||
**P1-T1 실제 실행 기록: 2026-11-05 (상위 리뷰 전, Task 최종 완료 미체크)**
|
||||
|
||||
- 범위: 이 Task의 entity/port/repository/test/DDL과 이 기록만 변경한다. `P1-T2`, 조회 filter, API 및 금융 경계는 시작하지 않는다.
|
||||
- 테스트 작성 후 컴파일 가능한 최소 bootstrap으로 `isHidden=false` 매핑, port와 항상 false를 반환하는 repository stub을 추가했다. 숨김 동작 구현 전 assertion RED를 확인했다.
|
||||
- RED 명령: Java 17(`liberica-17.0.15+10`)에서 `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest'`. 최초 120초 실행은 `compileKotlin` 도중 도구 timeout으로 종료되어 RED 근거로 사용하지 않았다. 동일 명령을 600초 제한으로 재실행해 exit 1, 6건 중 assertion 실패 3건, errors/skip 0을 확인했다.
|
||||
- RED 실패: `shouldHideOnlyDonationOwnedByCreatorAndRetainOriginalValues(false/true)`의 52행과 `shouldSucceedWhenHidingAgainWithoutChangingOriginalValues`의 108행에서 `expected: <true> but was: <false>`. 컴파일 및 H2 fixture 생성은 성공했다.
|
||||
- MySQL 멱등성 근거: Connector/J의 [`useAffectedRows` 설명](https://github.com/mysql/mysql-connector-j/blob/release/8.x/src/main/resources/com/mysql/cj/LocalizedErrorMessages.properties)은 `CLIENT_FOUND_ROWS`에 따라 matched/affected count가 달라짐을 명시한다. update는 두 ID 및 `isHidden=false`로 제한하고 true만 설정한다. 따라서 최초 변경은 양 설정 모두 1건이고 반복 숨김은 양 설정 모두 0건이며, 같은 두 ID의 존재 확인으로 true를 반환한다. H2에서도 반복 요청이 0건 update 경로를 통과하므로 H2의 무변경 update count를 MySQL 근거로 사용하지 않는다.
|
||||
- 트랜잭션: repository의 쓰기 메서드에 `@Transactional`을 두어 독립 포트 호출도 update/존재 조회를 한 트랜잭션에서 수행한다. 후속 service의 트랜잭션이 있으면 참여하며 service/API 구현은 이 Task에 추가하지 않는다.
|
||||
- 임시 경로: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/channel-hide.aeTJdH/p1-t1.SxYFSF`. 각 shell 실행에 이 경로의 `TMPDIR`, `NODE_COMPILE_CACHE`, `BUN_RUNTIME_TRANSPILER_CACHE_PATH`를 지정한다. 운영 SQL은 실행하지 않는다.
|
||||
- GREEN 명령: 위 RED와 동일한 focused 명령을 구현 후 실행해 exit 0, 신규 6건 통과(failures/errors/skip 0)를 확인했다. `compileKotlin`, `compileJava`, `compileTestKotlin`도 성공했다. 실제 DB는 캐시를 끈 `@DataJpaTest`의 H2이며 `QueryDslConfig`와 실제 repository bean을 import했다. mock은 사용하지 않았다.
|
||||
- DB 동작 증거: 신규 기본 false, 공개/비밀 각각 선택한 행만 true, 같은 채널의 다른 행 및 다른 채널 행은 false, wrong creator/missing ID는 false 반환, 반복 숨김 true 반환을 확인했다. 매번 flush/clear/find로 DB에서 다시 읽어 `id/can/additionalMessage/isSecret/member/creator/createdAt`을 고정 기대값과 정확히 비교했다. 선택 항목 테스트에서 3행, 나머지 거부/반복 테스트에서 1행이 유지됐다. 생성 시각은 기존 DDL의 초 정밀도에 맞는 고정값 `2026-11-05T00:00:00`을 사용했고 비교값 절삭이나 허용오차는 사용하지 않았다.
|
||||
- SQL 관찰: 테스트 XML의 Hibernate 출력에서 hide는 `UPDATE channel_donation_message SET is_hidden=? WHERE id=? AND creator_id=? AND is_hidden=?`만 실행하고, 반복 숨김과 거부는 같은 두 ID로 `SELECT 1`을 수행했다. hide SQL에 원본 필드 update, DELETE 또는 전역 filter는 없었다. fixture 준비의 createdAt update와 hide update를 구분했다.
|
||||
- 회귀/포맷 명령: `./gradlew --no-daemon -Pkotlin.compiler.execution.strategy=in-process test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultCreatorChannelDonationQueryRepositoryTest' ktlintCheck` 실행, exit 0. XML 기준 신규 6건 + 기존 query 14건 = 20건, failures/errors/skip 모두 0. `ktlintMainSourceSetCheck`, `ktlintTestSourceSetCheck`, Kotlin script 검사 및 `ktlintCheck` 성공. 추가 리팩터링은 필요하지 않아 범위를 확장하지 않았다.
|
||||
- 검증 한계: MySQL 서버에서 DDL 및 repository를 실행하지 않았고 운영 SQL은 미적용이다. MySQL matched/affected 차이는 위 Connector/J 근거와 조건부 update로 처리했다. `lsp_diagnostics` 도구가 없어 컴파일/ktlint로 대체했으며 LSP 성공을 주장하지 않는다. 기존 무관 코드의 `!!`/unchecked-cast/unused-parameter 컴파일 경고와 Gradle 9 비호환 deprecation 안내는 수정하지 않았다.
|
||||
- 중단 상태: P1-T1 실행 substep만 체크하고 Task 1.1 최종 완료는 상위 리뷰 대기로 남긴다. API/조회 filter는 미구현이므로 실제 화면 숨김 완료로 보고하지 않는다. 전체 테스트·`check`/`build`/`clean build`·`bootJar`·리뷰어·커밋·stage·push는 실행하지 않았다. 전체 테스트는 사용자가 `./gradlew test`로 별도 실행한다.
|
||||
- 변경 범위/공백: read-only git status/diff에서 P1-T1 지정 파일과 이 계획의 실행 기록만 변경했고, 원래 untracked인 PRD는 수정하지 않았다. tracked diff 및 신규 5개 파일(entity 외 port/repository/test/DDL/계획)의 `git diff --no-index --check /dev/null <file>`를 검사해 모두 exit 0·출력 없음이었다. 프로세스 종료와 임시 루트의 열린 파일 없음, 빈 디렉터리임을 확인했으며 기존 상위 Gradle daemon은 종료하지 않는다.
|
||||
|
||||
#### Task 1.2: use case와 API 권한 경계
|
||||
|
||||
선행 검증: P1-T1 독립 리뷰에서 명세/품질 PASS. 상위에서 신규 repository 테스트를 재실행해 6건, failures/errors/skip 0, BUILD SUCCESSFUL을 확인했다. 저장 단계만 완료이며 조회 숨김은 아직 미구현이다.
|
||||
|
||||
- [x] **Task 1.2 완료:** 아래 TDD 단계와 완료 증거를 충족한다.
|
||||
|
||||
**Goal 실행 `P1-T2`:** 소유 CREATOR 전용 bodyless DELETE endpoint가 대상 항목을 멱등 숨김 처리하고 도메인 오류를 기존 envelope로 반환한다.
|
||||
|
||||
- **시작 조건:** `P1-T1` 완료. 현재 `CreatorChannelDonationController`, 기존 authentication/member role 및 `SodaExceptionHandler`의 실제 오류 패턴을 재확인한다.
|
||||
- **완료 증거:** 서비스/HTTP 테스트가 성공, role 및 owner/channel mismatch 거부, hidden duplicate 성공, response data 없음, 금융 효과 불변을 확인함.
|
||||
- **범위 밖:** 조회 filter, DTO ID 및 frontend 연동.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/HideCreatorChannelDonationService.kt`
|
||||
- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/HideCreatorChannelDonationServiceTest.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationController.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/application/CreatorChannelDonationFacade.kt`
|
||||
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationControllerTest.kt`
|
||||
- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationEndToEndTest.kt`
|
||||
- Fixture: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/application/CreatorChannelDonationFacadeTest.kt` (생성자 주입 인자 변경만 반영)
|
||||
|
||||
**Interfaces:**
|
||||
|
||||
- Consumes: `HideCreatorChannelDonationPort.hideOwnedDonation(creatorId, donationId)` from `P1-T1`; authenticated `Member`; existing `ApiResponse`/`SodaException` handler.
|
||||
- Produces: `HideCreatorChannelDonationService.hide(creatorId: Long, donationId: Long, actor: Member): Unit`; `DELETE /api/v2/creator-channels/{creatorId}/donations/{donationId}` bodyless, success `ApiResponse.ok` with no data.
|
||||
|
||||
- [x] **RED:** `shouldAllowOnlyOwningCreatorToHideDonationThroughHttp`와 역할별 denial, forged creator/donation ID, not-found, repeated hide 통합 cases를 작성한다. 승인된 역할만 성공하며 실패는 모든 원본/금융 fixture를 유지해야 한다.
|
||||
- [x] **RED 확인:** `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest'`를 실행해 endpoint 미구현 또는 정책 assertion 실패를 확인한다.
|
||||
- [x] **GREEN:** service/facade/controller를 구현하고 기존 error key/handler로 role, owner, 같은 channel 소속을 검증한다. 같은 소유자의 중복 요청은 성공 처리하되 금융 변경은 하지 않는다.
|
||||
- [x] **GREEN 확인:** 같은 focused 명령으로 소유 성공, donor/other creator/user/admin 거부, forged ID 거부, 중복 성공, HTTP-200 domain error envelope와 금융/원본 불변을 확인한다.
|
||||
- [x] **REFACTOR:** 이번 Task의 중복만 정리하고 focused controller/E2E 테스트 및 `./gradlew ktlintCheck` 결과를 기록한다.
|
||||
|
||||
**P1-T2 실제 실행 기록: 2026-11-05 (상위 리뷰 대기, Task 최종 완료 미체크)**
|
||||
|
||||
- 승인 범위: `P1-T2` 및 `P1-GATE`까지만 실행한다. `P1-T1` entity/port/repository/DDL은 보존하며 P2 조회 filter/응답 ID는 시작하지 않는다. 기존 Facade 직접 생성 fixture도 주입 변경에 맞춘다.
|
||||
- 경계 판단: 인증은 기존 `SecurityConfig`/`TokenProvider`/`requireMember`를 그대로 사용한다. 외부 입력인 두 경로 ID는 service의 CREATOR role/actor ID 확인 후 기존 채널 범위 port에 전달한다. role/owner 거부는 `common.error.access_denied`, 대상 소속 불일치/미존재는 같은 `common.error.invalid_request`로 처리해 존재 여부를 구별하지 않는다. 기존 read-only Facade의 hide 진입점은 명시적인 쓰기 트랜잭션으로 재정의한다.
|
||||
- 임시 루트: 부모 경로를 `ls -ld`로 확인하고 `mktemp -d`로 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/channel-hide.aeTJdH/p1-t2.jkumZp`를 만들었다. shell 실행마다 해당 루트의 `TMPDIR`, `NODE_COMPILE_CACHE`, `BUN_RUNTIME_TRANSPILER_CACHE_PATH`를 지정한다. Java는 `17.0.15`다.
|
||||
- RED 명령: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest'`, 도구 timeout 600000ms. 정상 컴파일 후 exit 1, 30건 중 failures 8, errors/skip 0, 3분 11초. 신규 인증 DELETE 8건은 endpoint 미구현으로 183행에서 `expected: <200 OK> but was: <404 NOT_FOUND>` assertion 실패했다. 기존 21건 및 신규 anonymous 401 검증 1건은 통과했다.
|
||||
- RED 실제 HTTP: `RANDOM_PORT`의 Tomcat `50634`에서 실제 JWT와 `TestRestTemplate`로 body 없는 DELETE를 전송했다. 예: `/api/v2/creator-channels/90/donations/104` 소유 CREATOR는 `404` 및 `status:404,error:Not Found`, `/api/v2/creator-channels/131/donations/162` anonymous는 `401` 및 `status:401,error:Unauthorized`를 반환했다. JWT는 출력하지 않았다. `@DirtiesContext`의 Tomcat 종료 로그를 확인했다.
|
||||
- 구현 후 첫 동일 E2E 실행은 exit 1, 30건 중 failures 8, errors/skip 0, 4분 35초였다. 실제 owner 응답은 이미 `200 {"success":true,"message":null,"data":null,"errorProperty":null}`이고 domain 거부도 `200 success=false`였지만 신규 테스트가 data 키 자체의 생략을 잘못 가정했다. `ApiResponse.kt`의 nullable 필드와 기존 `ApiResponse.ok<Unit>()` 사용을 확인해 공통 envelope를 변경하지 않고 신규 assertion을 `data`의 정확한 JSON null 검증으로 정정했다. 이는 payload가 없다는 계약이며 `{}`/Unit 객체는 허용하지 않는다. 기존 테스트는 완화하지 않았다.
|
||||
- GREEN 및 포맷 1차 명령: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.application.HideCreatorChannelDonationServiceTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationControllerTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.application.CreatorChannelDonationFacadeTest' ktlintCheck`. XML 기준 E2E 30 + 실제 DB service 9 + controller 4 + facade fixture 회귀 2 = 45건, failures/errors/skip 모두 0. 명령 전체는 신규 service test의 `listOf` 인자 줄바꿈 ktlint 위반 5건으로 exit 1(1분 21초)이며, 해당 신규 코드 포맷만 수정하고 Gate에서 다시 확인한다.
|
||||
- 최종 GREEN: 아래 P1-GATE 명령에서 E2E 30건, service 9건, controller 4건, facade fixture 2건이 다시 통과했다. GET 동작/응답 ID 부재를 검증하던 기존 테스트 21건은 그대로 유지했다. `HideCreatorChannelDonationServiceTest`는 실제 Spring bean/기존 repository/H2를 사용하고 외부 mock 없이 검증한다. USER/ADMIN은 자기 ID와 경로가 같아도 거부하며, 비소유 USER/ADMIN/CREATOR는 대상 미존재 여부보다 먼저 access_denied를 반환한다.
|
||||
- 실제 socket HTTP 최종 증거: 기존 E2E의 `RANDOM_PORT` Tomcat `50765`, 실제 `TokenProvider` 발급 JWT, 기존 운영 인증 체인을 사용했다. body 없는 DELETE 총 13요청을 실행했고 JWT는 로그에 출력하지 않았다. 공개 `/api/v2/creator-channels/90/donations/104`, 비밀 `/api/v2/creator-channels/95/donations/109` 및 중복 `/api/v2/creator-channels/1/donations/2` 2회는 `200 {"success":true,"message":null,"data":null,"errorProperty":null}`였다. donor/outsider/other CREATOR/ADMIN 및 경로 소유권 위조는 `200 success=false,message=권한이 없습니다.,data=null`; 다른 채널 `/api/v2/creator-channels/106/donations/145`와 미존재 `/api/v2/creator-channels/106/donations/9223372036854775807`는 동일한 `200 success=false,message=잘못된 요청입니다.,data=null`이었다. 이미 숨긴 항목의 donor 요청도 거부됐다. anonymous `/api/v2/creator-channels/131/donations/162`는 실제 인증 체인에서 `401` 및 `status:401,error:Unauthorized`였다.
|
||||
- DB 보존 증거: 각 HTTP fixture는 해당 채널 3행과 다른 채널 1행, 실제 `UseCan` 1행(`can=450,rewardCan=50,isRefund=false`) 및 `UseCanCalculate` 1행(`can=500,status=RECEIVED`)을 생성해 commit했다. JDBC로 전체 컬럼을 요청 전후 다시 읽어 donation의 `is_hidden`만 제외한 원본/연결/시각과 재무 두 테이블의 모든 컬럼·행 수가 정확히 동일함을 확인했다. 별도 transaction/clear/find로 선택 ID만 hidden=true이고 나머지는 false인 것도 확인했다. 거부는 전 행 false, 중복은 첫 요청 이후 같은 상태였다. 고정 donation 생성 시각은 `2026-11-05T00:00:00`이며 비교값 절삭/허용오차를 사용하지 않았다.
|
||||
- 정리 영수증: 각 socket 테스트의 발급 token은 해당 member ID만 `@AfterEach`에서 제거했다. `@DirtiesContext`로 `50765` Tomcat 및 E2E/service Hikari 종료 로그를 확인했다. 이번 실행들의 Test worker PID `73880,75780,76195,76844`를 `ps`로 조회해 잔존 프로세스가 없었고 `lsof +D`는 열린 파일 없이 종료했다. 임시 루트는 0 entries였으며 symlink 해석 후 부모 allowlist, 현재 UID 소유권과 빈 상태를 확인해 `rmdir`로 `p1-t2.jkumZp`만 삭제했다. shared Gradle/Kotlin daemon은 종료하지 않았다.
|
||||
- 한계/중단: LSP 도구가 없어 실제 Kotlin/Java 컴파일 및 ktlint로 대체했다. MySQL/운영 DDL 적용, 전체 테스트, `check`/`build`/`clean build`/`bootJar`, dependency audit, reviewer/subagent, commit/stage/push는 수행하지 않았다. 전체 테스트는 사용자 실행 명령 `./gradlew test`다. P2 filter/ID는 미구현이므로 두 V2 목록은 아직 hidden 항목을 제외하지 않는다. P3의 실제 legacy/ranking/정산 조회 불변 최종 Gate는 수행하지 않았으며 이번 증거는 원본·재무 record 보존까지다. Task 1.2와 Phase 최종 완료 판정은 상위 리뷰에 남기고 여기서 중단한다.
|
||||
|
||||
#### Phase 1 Gate
|
||||
|
||||
**Goal 실행 `P1-GATE`:** 숨김 저장 및 owner-only API 권한/불변 조건을 확인한다.
|
||||
|
||||
- **시작 조건:** `P1-T1`, `P1-T2` 완료.
|
||||
- **완료 증거:** 두 focused 테스트 통과, entity/repository 데이터 보존 및 E2E 권한/멱등성 증거 기록.
|
||||
- **범위 밖:** 전체 suite, 조회 필터 및 legacy query 수정.
|
||||
|
||||
```bash
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.application.HideCreatorChannelDonationServiceTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationControllerTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest'
|
||||
./gradlew ktlintCheck
|
||||
```
|
||||
|
||||
**Expected:** 구현 후 각 명령 exit 0, 실패/skip 0. DB 원본 및 can/정산 관련 fixture 불변. 현재 실행하지 않음.
|
||||
|
||||
**P1-GATE 실제 실행 기록: 2026-11-05 (실행 통과, 최종 완료는 상위 리뷰 대기)**
|
||||
|
||||
- [x] 위 Gate의 4개 클래스와 주입 변경 직접 영향 범위인 `CreatorChannelDonationFacadeTest`를 함께 focused 실행했다.
|
||||
- [x] 같은 invocation에서 `ktlintCheck`를 실행해 main/test/Kotlin script 검사 성공을 확인했다.
|
||||
- [x] Phase 1 최종 완료 판정: 독립 리뷰 명세/품질 PASS. 상위에서 실제 HTTP를 포함한 E2E 30건을 재실행해 failures/errors/skip 0, BUILD SUCCESSFUL(26초)을 확인했다. 로그에서 Tomcat·DB 풀 종료도 확인했다.
|
||||
|
||||
실제 명령:
|
||||
|
||||
```bash
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.application.HideCreatorChannelDonationServiceTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationControllerTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.application.CreatorChannelDonationFacadeTest' ktlintCheck
|
||||
```
|
||||
|
||||
- 결과: exit 0, `BUILD SUCCESSFUL in 1m 9s`. XML 기준 repository 6 + service 9 + controller 4 + E2E 30 = Gate 49건, 추가 facade 2건으로 총 51건이며 failures/errors/skipped는 전부 0이다. 앞선 실행에서 변경된 production Kotlin/Java와 test Kotlin 컴파일이 성공했고 최종 실행의 test Kotlin 컴파일도 성공했다. 기존 무관 컴파일 경고와 Gradle deprecation 안내는 범위 밖으로 유지한다.
|
||||
- 증거 경로: `build/test-results/test/TEST-kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest.xml`의 HTTP EVIDENCE 13행과 각 클래스 XML의 testsuite 집계를 직접 확인했다. 실제 HTTP/DB/정리 내용은 바로 위 P1-T2 기록에 누적했다. 전체 테스트 통과나 화면 숨김 완료를 뜻하지 않는다.
|
||||
|
||||
### Phase 2: V2 조회 필터, count 및 owner-only ID
|
||||
|
||||
**Phase 결과:** 홈/탭은 hidden item을 모든 사용자에게 제외하고 count/page/refill 및 ID 공개 범위를 올바르게 유지한다.
|
||||
|
||||
**선행조건:** `P1-GATE` 완료. `P1-T2` 성공 이후 API 조회 필드 노출과 기존 JSON assertion을 갱신한다.
|
||||
|
||||
**Phase 완료 조건:** `P2-T1`, `P2-T2`, `P2-GATE` 완료 증거 기록.
|
||||
|
||||
#### Task 2.1: donation 탭 filter, count, pagination, ID
|
||||
|
||||
- [x] **Task 2.1 완료:** 아래 TDD 단계와 완료 증거를 충족한다.
|
||||
|
||||
**Goal 실행 `P2-T1`:** donation 탭은 hidden 제외 count/list를 동일 조건으로 제공하고 owner에게만 donationId를 제공한다.
|
||||
|
||||
- **시작 조건:** Phase 1 Gate 완료. 현재 query/service/domain/response 및 기존 E2E ID 부재 assertion 확인.
|
||||
- **완료 증거:** repository와 HTTP 통합에서 역할별 hidden 제외, count/page/hasNext, visible 공개/비밀 masking 유지, owner ID 및 non-owner 부재가 검증됨.
|
||||
- **범위 밖:** 홈 목록 filter 및 legacy/ranking query 변경.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultCreatorChannelDonationQueryRepository.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/port/out/CreatorChannelDonationQueryPort.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/domain/CreatorChannelDonationTab.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryService.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/dto/CreatorChannelDonationTabResponse.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultCreatorChannelDonationQueryRepositoryTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryServiceTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationEndToEndTest.kt`
|
||||
- Fixture/contract: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/domain/CreatorChannelDonationQueryPolicyTest.kt`
|
||||
- Fixture/contract: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/application/CreatorChannelDonationFacadeTest.kt`
|
||||
- Fixture/contract: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationControllerTest.kt`
|
||||
|
||||
**Interfaces:**
|
||||
|
||||
- Consumes: `ChannelDonationMessage.isHidden`; actor/owner context available to V2 response assembly. Existing `countChannelDonations` and `findChannelDonations` page API.
|
||||
- Produces: donation tab item response `donationId: Long?` serialized only for owning CREATOR; count/list share hidden predicate before pagination. No donor member ID.
|
||||
|
||||
- [x] **RED:** `shouldExcludeHiddenRowsFromDonationTabCountAndPagesForEveryViewer` 및 `shouldExposeDonationIdOnlyToOwningCreator`를 추가한다. mixed 25 rows, hidden within first page, all-hidden empty, and owner/non-owner JSON boundary cases를 포함한다.
|
||||
- [x] **RED 확인:** `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultCreatorChannelDonationQueryRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest'`를 실행해 hidden filter 및 owner ID 부재/노출 assertion 실패를 확인한다.
|
||||
- [x] **GREEN:** count와 목록에 동일 local predicate를 적용하고 pagination 전에 제외한다. response mapping에서 소유 CREATOR에만 persisted ID를 제공한다.
|
||||
- [x] **GREEN 확인:** 같은 focused 명령을 실행해 viewer 전원 hidden 제외, `donationCount`, page/hasNext, 공개/비밀 masking 및 ID JSON을 검증한다.
|
||||
- [x] **REFACTOR:** 현재 ID 없음만 가정하던 owner assertion은 owner-only ID 기대값으로 수정하고 non-owner 부재 assertion은 보존한다. focused donation query/service/E2E 및 `./gradlew ktlintCheck` 결과 기록.
|
||||
|
||||
**P2-T1 실행 증거: 2026-11-05 (최종 Task 판정은 상위 리뷰 대기)**
|
||||
|
||||
- RED: 위 두 클래스 명령, 정상 컴파일 후 48건 중 assertion 실패 7건, errors/skip 0, `BUILD FAILED in 36s`. repository는 hidden 혼합 count `22 != 25`, all-hidden `0 != 2`; 실제 socket GET은 count `22 != 28`, owner ID `[3,2,1] != [null,null,null]`, 기존 언어별 owner JSON은 `donationId` 누락으로 실패했다. 최초 fixture의 숨김 플래그 변경이 managed createdAt을 덮어쓰는 문제를 바로잡아 persist 전에 플래그를 설정하고 RED를 재확인했다. 중간 생성자 컴파일 오류는 RED 근거에서 제외했다.
|
||||
- GREEN: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultCreatorChannelDonationQueryRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.application.CreatorChannelDonationQueryServiceTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.domain.CreatorChannelDonationQueryPolicyTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.*' ktlintCheck`, exit 0, `BUILD SUCCESSFUL in 1m`. repository 16 + service 20 + policy 5 + E2E 32 + controller 4 + facade 2 = 79건, failures/errors/skip 0; Kotlin/Java/test 컴파일 및 ktlint 통과.
|
||||
- 검증: 공개·비밀 25행 중 최신 3행 숨김 후 22행을 20+2로 조회, HTTP 두 건 DELETE 후 정확히 20행/hasNext=false, 전부 숨김 후 count=0/empty/false를 owner/donor/outsider/other CREATOR/ADMIN 모두 확인했다. record ID는 실제 저장 행의 ID와 비교하며 서비스는 같은 ID의 USER/ADMIN에도 ID를 주지 않는다. 기존 월 경계·정렬·다국어 masking assertion과 non-owner 필드 부재를 유지했다.
|
||||
- 기존 RANDOM_PORT/TestRestTemplate/JWT helper를 GET에도 재사용했다. 토큰을 출력하지 않고 기존 token 삭제와 DirtiesContext 종료를 유지했다. 홈/P3/legacy/재무 query와 P1 production은 수정하지 않았다. LSP 도구가 없어 컴파일/ktlint로 검증한다.
|
||||
|
||||
#### Task 2.2: 홈 filter, refill, owner-only ID
|
||||
|
||||
- [x] **Task 2.2 완료:** 아래 TDD 단계와 완료 증거를 충족한다.
|
||||
|
||||
**Goal 실행 `P2-T2`:** 채널 홈은 hidden donation을 제외한 최신 visible 최대 8건을 제공하고 소유 CREATOR에게만 donationId를 제공한다.
|
||||
|
||||
- **시작 조건:** `P2-T1` 완료. 홈 query/service/domain/response와 현재 KST 월/최대 8개 테스트 확인.
|
||||
- **완료 증거:** repository 및 HTTP 통합으로 hidden 전체 제외, hidden 섞인 최신 8개 refill, owner ID 범위 및 visible `isSecret` 표시 유지.
|
||||
- **범위 밖:** donation tab count, home 새 count 필드, legacy API 변경.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/adapter/out/persistence/DefaultCreatorChannelHomeQueryRepository.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/port/out/CreatorChannelHomeQueryPort.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/domain/CreatorChannelHome.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryService.kt`
|
||||
- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/dto/CreatorChannelHomeResponse.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/adapter/out/persistence/DefaultCreatorChannelHomeQueryRepositoryTest.kt`
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt`
|
||||
- Fixture/contract: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryServiceTest.kt`
|
||||
- Fixture/contract: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/application/CreatorChannelHomeFacadeTest.kt`
|
||||
- Fixture/contract: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/adapter/in/web/CreatorChannelHomeControllerTest.kt`
|
||||
|
||||
**Interfaces:**
|
||||
|
||||
- Consumes: `ChannelDonationMessage.isHidden`; existing home `findChannelDonations(creatorId, viewerId, now, limit, lang)` and owner context in response assembly.
|
||||
- Produces: `channelDonations[]` hidden-excluded, maximum 8 visible rows after filter; `donationId: Long?` only for owning CREATOR, no donor member ID.
|
||||
|
||||
- [x] **RED:** `shouldRefillHomeWithLatestEightVisibleDonationsAfterHiddenRowsAreExcluded` 및 `shouldExposeHomeDonationIdOnlyToOwningCreator`를 작성한다. hidden newest candidates, tied timestamps, public/secret visible rows, all-hidden empty를 포함한다.
|
||||
- [x] **RED 확인:** `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.adapter.out.persistence.DefaultCreatorChannelHomeQueryRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest'`로 숨김 누락 또는 owner ID assertion 실패를 확인한다.
|
||||
- [x] **GREEN:** home query의 channel/month 조건과 함께 `isHidden=false`를 적용하고 기존 정렬 뒤 최대 8개를 조회한다. 소유자 응답에만 ID를 전달한다.
|
||||
- [x] **GREEN 확인:** 같은 focused 명령으로 모든 viewer의 hidden 부재, visible 최대 8개 refill, 기존 월 경계/정렬/secret masking 및 ID 응답 범위를 검증한다.
|
||||
- [x] **REFACTOR:** owner-only ID 회귀를 유지하며 현재 donation ID 부재만 강제하던 assertion을 owner/non-owner 구분 검증으로 갱신한다. focused home tests 및 `./gradlew ktlintCheck` 결과 기록.
|
||||
|
||||
**P2-T2 실행 증거: 2026-11-05 (최종 Task 판정은 상위 리뷰 대기)**
|
||||
|
||||
- RED: 위 두 클래스에 실제 socket home GET을 추가한 `CreatorChannelDonationEndToEndTest`까지 focused 실행. 정상 컴파일 후 93건 중 assertion 실패 8건, errors/skip 0, `BUILD FAILED in 51s`. repository는 visible 기대 `[9,8,7,6,5,4,3,2]` 대신 hidden 포함 `[12,11,10,9,8,7,6,5]`, all-hidden empty 실패; socket home은 hidden 원본 포함 `[300,200,100,12,11,10,9,8]`, owner ID `[179,178,177]` 대신 null 세 건. 기존 다국어 owner field-set assertion 3건도 ID 누락으로 실패했다.
|
||||
- GREEN: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' ktlintCheck`, exit 0, `BUILD SUCCESSFUL in 1m 31s`. home repository 40 + service 26 + policy 5 + E2E 18 + controller 3 + facade 2 + socket donation E2E 35 = 129건, failures/errors/skip 0; 컴파일 및 ktlint 통과.
|
||||
- 검증: 최신 숨김 공개·비밀 후보 3건을 제외하고 동시각 ID 내림차순 visible 8건을 모든 5역할에 보충했다. owner가 홈에서 얻은 실제 ID로 공개/비밀 각각 DELETE한 뒤 홈 8건 refill 및 탭 count=8/hasNext=false, 두 JSON item 배열의 완전 일치를 검증했다. 전부 숨김 후 모든 역할의 홈은 빈 배열이다. 3행 별도 fixture에서도 양 조회면 persisted ID가 정확히 같고 선택한 비밀 행을 숨긴 뒤 모든 역할에서 두 목록이 일치한다.
|
||||
- 새 월 의존 fixture는 현재 UTC 시각으로 계산한 KST 월 범위를 사용한다. 기존 P1 고정 fixture/원본 snapshot은 유지했다. 홈 `isViewerCreator`의 role-only live 접근 정책은 변경하거나 소유권에 재사용하지 않았다. 양 도메인에 소유자 ID만 전달하며 API property NON_NULL로 non-owner 키 자체를 생략한다. home E2E에도 DirtiesContext 종료를 명시했다.
|
||||
|
||||
#### Phase 2 Gate
|
||||
|
||||
**Goal 실행 `P2-GATE`:** 양 V2 조회 표면에서 숨김, page/count/refill과 owner ID를 통합 확인한다.
|
||||
|
||||
- **시작 조건:** `P2-T1`, `P2-T2` 완료.
|
||||
- **완료 증거:** 아래 focused test, `ktlintCheck`, `bootJar` 결과. HTTP integration에서 creator/donor/USER/other CREATOR/ADMIN별 숨김 부재 확인.
|
||||
- **범위 밖:** 전체 test suite 및 frontend UI 구현.
|
||||
|
||||
```bash
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultCreatorChannelDonationQueryRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.adapter.out.persistence.DefaultCreatorChannelHomeQueryRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest'
|
||||
./gradlew ktlintCheck
|
||||
./gradlew bootJar
|
||||
```
|
||||
|
||||
**Expected:** 구현 후 지정 focused tests, lint, jar 성공. hidden 공개/비밀 item은 어떤 role에도 없고 count/page/home fill 모두 visible 기준이다. donor ID는 추가되지 않는다. 현재 실행하지 않음.
|
||||
|
||||
**P2-GATE 실행 증거: 2026-11-05 (실행 통과·상위 리뷰 대기)**
|
||||
|
||||
- [x] 지정 Gate 4개 클래스 109건 및 직접 영향받는 service/policy/controller/facade 67건, 합계 176건 통과. failures/errors/skipped 모두 0.
|
||||
- [x] 같은 invocation에서 `ktlintCheck`, `bootJar` 성공, exit 0, `BUILD SUCCESSFUL in 1m 14s`. bootJar는 실제 생성했고 lint는 직전 GREEN 결과와 동일 입력의 UP-TO-DATE 판정이다. 마지막 fixture UTC 조정 후 test Kotlin 재컴파일도 성공했다.
|
||||
- [x] 기존 socket E2E에서 두 V2 GET → owner ID로 DELETE → 두 GET을 실제 인증 체인으로 확인했다. 모든 역할의 hidden 부재·count/page/refill·non-owner ID 키 생략·donor memberId 부재를 검증했다.
|
||||
- [x] Phase 2 Task 및 Gate 최종 승인: 독립 리뷰에서 명세/품질 PASS. 상위가 홈·후원 E2E 53건을 재실행해 실패/오류/skip 0과 BUILD SUCCESSFUL(40초), 실제 HTTP 및 종료 로그를 확인했다.
|
||||
|
||||
실제 최종 명령 (Java 17, timeout 600000ms):
|
||||
|
||||
```bash
|
||||
./gradlew test \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultCreatorChannelDonationQueryRepositoryTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.adapter.out.persistence.DefaultCreatorChannelHomeQueryRepositoryTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.application.CreatorChannelDonationQueryServiceTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.domain.CreatorChannelDonationQueryPolicyTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationControllerTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.application.CreatorChannelDonationFacadeTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.application.CreatorChannelHomeQueryServiceTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.domain.CreatorChannelHomeQueryPolicyTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.application.CreatorChannelHomeFacadeTest' \
|
||||
ktlintCheck bootJar
|
||||
```
|
||||
|
||||
실제 HTTP 응답 증거는 `build/test-results/test/TEST-kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest.xml`의 `HTTP EVIDENCE`에 있다. Tomcat port는 `51039`, worker PID는 `84091`이다. 아래는 실제 응답의 관련 필드만 발췌한 것이며 token/header는 기록하지 않았다.
|
||||
|
||||
| 요청 | HTTP | 실제 응답 관련 필드 |
|
||||
|---|---:|---|
|
||||
| owner GET `/api/v2/creator-channels/120/home` 및 `/donations` | 200 | 양 목록 `donationId=[179,178,177]`; 탭 `donationCount=3` |
|
||||
| owner DELETE `/api/v2/creator-channels/120/donations/178` | 200 | `{"success":true,"message":null,"data":null,"errorProperty":null}` |
|
||||
| 같은 두 GET 재요청 | 200 | 양 목록 `donationId=[179,177]`, `can=[300,100]`; 탭 `donationCount=2,hasNext=false` |
|
||||
| owner 홈 GET → 공개 ID 12 DELETE → 두 GET (`creatorId=1`) | 200 | 홈 `can=[9,8,7,6,5,4,3,2]` → `[9,7,6,5,4,3,2,1]`; 두 배열 동일, 탭 count=8 |
|
||||
| owner 홈 GET → 비밀 ID 29 DELETE → 두 GET (`creatorId=6`) | 200 | 홈 `can=[9,8,7,6,5,4,3,2]` → `[8,7,6,5,4,3,2,1]`; 두 배열 동일, 탭 count=8 |
|
||||
|
||||
- donor/outsider/other CREATOR/ADMIN도 같은 hidden 제외 목록을 받으며 non-owner JSON에는 `donationId` 키가 없었다. 채널 소유자와 같은 ID의 USER/ADMIN은 service matrix로도 ID 부재를 확인했다. 신규 로그와 최종 XML에 JWT 패턴 검색 결과 0건이며, 토큰은 기존 AfterEach에서 발급 member ID별 삭제했다.
|
||||
- 변경 검토: production diff는 두 query의 local predicate/ID projection, 두 port record/domain/service/DTO뿐이다. P1 저장·숨김 API, 공통 직렬화, 랭킹/정산/legacy query와 의존성·설정은 변경하지 않았다. `git diff --check` 통과. PRD는 수정하지 않았다.
|
||||
- 정리 영수증: 부모 경로를 먼저 확인하고 생성한 전용 루트 `channel-hide.aeTJdH/p2.1mgEdJ`만 사용했다. Tomcat 51039와 두 E2E Hikari 종료 로그를 확인했고 PID 84091·Gradle Test Executor·redis-server 및 해당 port listener 잔존 없음, `lsof +D` 열린 파일 없음이었다. UID 501 소유권·canonical path·빈 상태를 확인해 자체 로그 5개와 전용 루트만 삭제했다. 부모와 기존 `p1-t1.SxYFSF`, shared Gradle/Kotlin daemon PID 53466/73431은 보존했다. 최종 XML/HTML 테스트 결과는 `build/`에 남겼다.
|
||||
- 검증 한계: LSP 도구가 없어 Kotlin/Java 컴파일 및 ktlint로 대체했다. 전체 테스트·`check`/`build`/`clean build`, P3 settlement/legacy 회귀, MySQL/운영 DDL 적용, subagent/reviewer, commit/stage/push는 수행하지 않았다. 전체 테스트는 사용자가 `./gradlew test`로 실행한다. 기존 deprecation/unchecked-cast 경고는 범위 밖이다.
|
||||
|
||||
**Phase 2의 정확한 변경 파일 (22개, 기존 P1 변경은 별도 보존):**
|
||||
|
||||
```text
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultCreatorChannelDonationQueryRepository.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/port/out/CreatorChannelDonationQueryPort.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/domain/CreatorChannelDonationTab.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryService.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/dto/CreatorChannelDonationTabResponse.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/adapter/out/persistence/DefaultCreatorChannelHomeQueryRepository.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/port/out/CreatorChannelHomeQueryPort.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/domain/CreatorChannelHome.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryService.kt
|
||||
src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/dto/CreatorChannelHomeResponse.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultCreatorChannelDonationQueryRepositoryTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/application/CreatorChannelDonationQueryServiceTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/domain/CreatorChannelDonationQueryPolicyTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationEndToEndTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationControllerTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/application/CreatorChannelDonationFacadeTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/adapter/out/persistence/DefaultCreatorChannelHomeQueryRepositoryTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/home/application/CreatorChannelHomeQueryServiceTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/adapter/in/web/CreatorChannelHomeControllerTest.kt
|
||||
src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/application/CreatorChannelHomeFacadeTest.kt
|
||||
docs/20261105_채널후원메시지숨김/plan-task.md
|
||||
```
|
||||
|
||||
### Phase 3: 보존, legacy 및 최종 회귀 증거
|
||||
|
||||
**Phase 결과:** 숨김이 표시 조정에 한정되고 원본/재무/legacy 동작을 바꾸지 않았다는 증거가 남는다.
|
||||
|
||||
**선행조건:** `P2-GATE` 완료.
|
||||
|
||||
**Phase 완료 조건:** `P3-GATE` 증거 기록.
|
||||
|
||||
#### Task 3.1: 재무 불변과 legacy 경계 Gate
|
||||
|
||||
- [x] **Task 3.1 완료:** 아래 회귀 검증과 완료 증거를 충족했다. 최종 리뷰의 P3-R1 보정 및 재리뷰도 통과했다.
|
||||
|
||||
**Goal 실행 `P3-GATE`:** 실제 persistence/HTTP 증거로 DB 보존, 랭킹/정산/can 사용 불변 및 legacy 목록의 기존 출력 유지를 확인한다.
|
||||
|
||||
- **시작 조건:** Phase 2 완료. 기존 legacy 채널 후원 query/controller 및 랭킹 adapter의 실제 경로를 구현 전 다시 확인한다.
|
||||
- **완료 증거:** 통합 테스트에서 숨김 전후 원본 행과 금융 record 동일, 랭킹 동일, legacy 결과에서 같은 donation 표시, 문서에 global hide가 아님을 확인.
|
||||
- **범위 밖:** legacy API를 숨김 처리하거나 재무 query를 변경하는 것.
|
||||
- **TDD 예외 사유:** Gate 자체는 별도 production behavior를 추가하지 않고 앞선 integration test의 회귀 범위를 판정한다. 필요한 실패 assertion은 소유 Task에 추가 후 재검증한다.
|
||||
- **대체 검증 방법:** repository/HTTP integration test, DB flush/clear/reload, legacy endpoint response 대조 및 focused lint/build를 기록한다.
|
||||
|
||||
**Files:**
|
||||
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/donation/adapter/in/web/CreatorChannelDonationEndToEndTest.kt`
|
||||
- Verify: `src/test/kotlin/kr/co/vividnext/sodalive/explorer/profile/channelDonation/ChannelDonationControllerTest.kt` (기존 mock 기반 controller 회귀이며 DB 보존/조회 증거를 대체하지 않음)
|
||||
- Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/legacy/LegacyCreatorChannelDonationRankingAdapterTest.kt`
|
||||
|
||||
- [x] 실제 persistence를 사용하는 `CreatorChannelDonationEndToEndTest`에서 숨김 API 성공 후 legacy GET을 호출해 동일 행이 유지되는지 확인한다. mock 응답만으로 판정하지 않는다.
|
||||
- [x] entity를 DB에서 재조회해 ID/can/message/isSecret/createdAt/member/creator 값이 숨김 전후 동일한지 확인한다.
|
||||
- [x] `UseCan`, `UseCanCalculate` 및 실제 ranking/정산 조회 결과가 숨김 전후 바뀌지 않는지 확인한다. mock 위임 테스트만으로 불변을 주장하지 않는다.
|
||||
- [x] 관련 donation/home/legacy 클래스만 `--tests`로 실행하고 `./gradlew ktlintCheck`, `./gradlew bootJar` 결과를 기록한다.
|
||||
|
||||
```bash
|
||||
./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' --tests 'kr.co.vividnext.sodalive.explorer.profile.channelDonation.ChannelDonationControllerTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.legacy.LegacyCreatorChannelDonationRankingAdapterTest'
|
||||
```
|
||||
|
||||
**Expected:** 지정 테스트 exit 0, legacy 실제 조회와 재무 원본/집계 결과가 숨김 전후 동일. 현재 실행하지 않음.
|
||||
|
||||
**P3-GATE 실행 증거: 2026-11-05 (실행 통과, Task 최종 승인은 상위 전체 변경 리뷰 대기)**
|
||||
|
||||
- 변경은 위 E2E 파일과 이 기록뿐이며 production/PRD/P1·P2 기존 테스트는 보존했다. `shouldPreserveLegacyRankingAndSettlementAfterHidingDonationThroughHttp(false/true)` 2건을 추가하고 기존 HTTP/JWT·snapshot·hidden 재조회 helper를 재사용했다. Gate의 승인된 TDD 예외에 따라 production을 인위적으로 되돌리지 않았다.
|
||||
- 금융 기여 연결: 채널별 메시지는 선택할 500캔 한 건뿐이고, 동일 donor/creator·비밀 여부·시각의 `UseCan(can=450,rewardCan=50,isRefund=false,CHANNEL_DONATION)` 및 `UseCanCalculate(can=500,status=RECEIVED)` 한 건을 commit했다. 별도 채널의 400캔 행도 보존한다. DB flush/clear/reload로 금액·연결·상태를 대조했으며 P1의 독립 500캔 fixture를 보존 증거로 재사용하지 않았다.
|
||||
- 월/격리: 현재 UTC로 구한 KST 월 시작에 2시간을 더한 초 정밀도 입력을 사용했다. 공개 `2026-10-31T17:00:00Z`, 비밀 `2026-10-31T17:00:01Z`는 KST 11월이다. 날짜 설정 후 baseline을 읽었다. 정산은 실제 주입된 `AdminChannelDonationCalculateQueryRepository.getChannelDonationByCreatorTotal` 및 `getChannelDonationByCreator`를 동일 초의 inclusive 범위로 전후 호출해 다른 fixture와 격리했다. 날짜 포맷 함수/alias/mock은 사용하지 않았다.
|
||||
- 신규 2건 우선 명령: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest.shouldPreserveLegacyRankingAndSettlementAfterHidingDonationThroughHttp' ktlintCheck`. exit 0, `BUILD SUCCESSFUL in 31s`, tests=2, failures/errors/skipped=0. test Kotlin 컴파일과 변경 test source ktlint 검사를 실제 실행했다.
|
||||
|
||||
최종 Gate 명령 (Java 17.0.15, timeout 600000ms, 표준 wrapper, 강제 재실행 없음):
|
||||
|
||||
```bash
|
||||
./gradlew test \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.explorer.profile.channelDonation.ChannelDonationControllerTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.legacy.LegacyCreatorChannelDonationRankingAdapterTest' \
|
||||
--tests 'kr.co.vividnext.sodalive.admin.calculate.channelDonation.AdminChannelDonationCalculateQueryRepositoryTest' \
|
||||
ktlintCheck bootJar
|
||||
```
|
||||
|
||||
- 결과: exit 0, `BUILD SUCCESSFUL in 33s`. 지정 Gate는 E2E 37 + legacy controller 2 + ranking adapter 2 = 41건, 직접 호출한 정산 repository 회귀 2건을 더해 총 43건, failures/errors/skipped 모두 0. 기존 E2E 35건도 전부 유지·통과했다. `ktlintCheck`와 `bootJar`는 동일 입력의 UP-TO-DATE 성공이며 기존 `build/libs/sodalive-0.0.1-SNAPSHOT.jar`(141 MiB)를 확인했다. 새 production 재컴파일/새 jar 생성으로 표현하지 않는다.
|
||||
- 실제 socket 증거: Tomcat `51284`, worker PID `88424`, 실제 JWT 인증 체인의 GET → owner 응답 ID로 bodyless DELETE → GET 순서다. 공개 `creatorId=125,donationId=181`, 비밀 `creatorId=130,donationId=183` 모두 DELETE `200 {"success":true,"message":null,"data":null,"errorProperty":null}`. 양 경우 탭 `donationCount=1→0,donations=[]/hasNext=false`, 홈 `channelDonations` 1건→빈 배열을 확인했다.
|
||||
- legacy 증거: owner GET `/explorer/profile/channel-donation?creatorId=125&page=0&size=20` 및 creatorId=130의 **전체 JSON envelope**가 전후 정확히 동일했다. `totalCount=1`, 같은 ID 181/183·500캔·공개/비밀 플래그·원문/생성 시각이 남는다. 이 기능은 두 V2 표시 목록만 숨기며 global hide가 아니다.
|
||||
- 랭킹 증거: 탭 owner 응답 전체 `rankings`가 전후 동일하고 donor 126/131의 `donationCan=500→500`이었다. DELETE 후 해당 fixture의 정확한 Redis ranking key만 제거하고 제거 성공을 확인해, stale cache가 아닌 실제 legacy query 재조회로 검증했다.
|
||||
- 정산 증거: 공개·비밀 모두 실제 total/count 및 creator별 query 결과 전체와 `toResponseItem()` 전체가 전후 동일했다. 각각 `count=1,totalCan=500,krw=50000,fee=3300,settlementAmount=39695,withholdingTax=1310,depositAmount=38385`. 0건/0원 불변을 통과 근거로 쓰지 않았다.
|
||||
- DB 증거: JDBC 전체 컬럼 snapshot에서 donation 2행(자기 채널 1+다른 채널 1)은 `is_hidden` 외 모든 값, `UseCan` 1행과 `UseCanCalculate` 1행은 모든 컬럼·행 수가 동일했다. 별도 transaction/clear/find로 선택 ID만 hidden=true임을 확인했다. 행 삭제나 비교 정밀도 완화는 없다.
|
||||
- 증거 파일: `build/test-results/test/TEST-kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest.xml`의 `HTTP EVIDENCE`, `SETTLEMENT EVIDENCE`, testsuite 집계 및 나머지 3개 클래스 XML. JWT 패턴 검색 결과는 0건이며 토큰은 기존 AfterEach에서 발급 member ID별 삭제했다.
|
||||
- 정리: 확인한 부모 아래 `mktemp -d`로 생성한 `channel-hide.aeTJdH/p3.OBzvWM`의 TMPDIR/NODE_COMPILE_CACHE/BUN_RUNTIME_TRANSPILER_CACHE_PATH를 모든 shell에 지정했다. 두 실행의 Tomcat `51262/51284` 및 Hikari 종료 로그, worker PID `88133/88424`·Test Executor·redis-server·port listener 잔존 없음, `lsof +D` 열린 파일 없음과 0 entries를 확인했다. canonical 부모 allowlist·현재 UID 소유권·symlink 아님을 검사한 뒤 `rmdir`로 해당 빈 루트만 삭제했다. shared Gradle/Kotlin daemon PID `53466/73431`과 부모/다른 Task 임시 경로는 보존했다.
|
||||
- 한계/인계: LSP 도구가 없어 test Kotlin 컴파일·ktlint로 대체했다. MySQL/운영 DDL, 전체 테스트·`check`/`build`/`clean build`, subagent/reviewer, commit/stage/push는 미실행이다. 기존 Gradle deprecation 안내는 유지했다. 전체 테스트의 사용자 명령은 `./gradlew test`이며, 상위의 broad scoped donation/home 회귀와 최종 전체 변경 리뷰·Task 승인에 넘긴다.
|
||||
|
||||
## Phase Gate와 전체 테스트 정책
|
||||
|
||||
### 회귀 수정 `P3-R1`: MySQL 자동 수정 시각 보존
|
||||
|
||||
- [x] **Task P3-R1 완료:** 숨김 UPDATE가 기존 `updated_at`을 명시적으로 유지함을 회귀 검사하고 최종 재리뷰를 통과했다.
|
||||
- **목표:** MySQL의 자동 갱신 시각 설정에서도 숨김 상태 외 원본 컬럼을 바꾸지 않는다.
|
||||
- **시작 조건:** 최종 Oracle 리뷰에서 기존 DDL의 `updated_at ... ON UPDATE CURRENT_TIMESTAMP`와 현재 UPDATE의 시각 자기 대입 누락을 확인했다.
|
||||
- **Files:** Modify `src/main/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultHideCreatorChannelDonationRepository.kt`; Test `src/test/kotlin/kr/co/vividnext/sodalive/v2/creator/channel/donation/adapter/out/persistence/DefaultHideCreatorChannelDonationRepositoryTest.kt`.
|
||||
- **범위 밖:** 기존 테이블 DDL 수정, 시각 초기화, 공통 시간 변환 변경, snapshot assertion 완화.
|
||||
- [x] **RED:** 실제 생성 UPDATE SQL에 `updated_at=updated_at` 보존식이 없는 실패를 확인한다.
|
||||
- [x] **GREEN:** QueryDSL UPDATE에 기존 `updatedAt` 자기 대입만 추가한다.
|
||||
- [x] **GREEN 확인:** repository 회귀와 실제 HTTP 원본 snapshot 검사 통과, 생성 SQL 보존식 확인.
|
||||
- [x] **REFACTOR 검증:** 추가 리팩터링 없이 이번 변경 범위의 lint/컴파일 및 `bootJar` 결과를 기록한다.
|
||||
- [x] **최종 재리뷰:** Oracle가 P3-R1을 ADDRESSED로 판정하고 전체 변경을 승인했다. 새로운 명세·품질·보안 차단 사항은 없다.
|
||||
- **검증 명령:** `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest' ktlintCheck bootJar`.
|
||||
- **검증 한계:** H2의 Hibernate 생성 스키마에는 기존 MySQL 자동 시각 설정이 없으므로 기존 green만으로 MySQL 원본 시각 보존을 보장하지 않는다. 실제 MySQL 실행 여부는 결과에 별도로 기록한다.
|
||||
|
||||
**P3-R1 실행 증거: 2026-11-05 (RED/GREEN·검증 완료, 최종 재리뷰 대기)**
|
||||
|
||||
- 기존 DDL `docs/plan-task/20260223_channel_donation_message_ddl.sql`의 `updated_at TIMESTAMP ... ON UPDATE CURRENT_TIMESTAMP`를 확인했다. production 변경은 `.set(channelDonationMessage.updatedAt, channelDonationMessage.updatedAt)` 한 줄뿐이다. 기존 HTTP 전체 컬럼 snapshot·다른 행·멱등성 검사는 변경하지 않았다.
|
||||
- 신규 `shouldPreserveUpdatedAtWithSelfAssignmentInGeneratedHideSql`은 테스트 내부 `TestConfiguration`/`HibernatePropertiesCustomizer`/`StatementInspector`로 실제 repository가 실행하는 SQL을 수집한다. fixture flush/clear/reload 후 수집값을 비우고 숨김 UPDATE의 자기 대입을 검사하며, DB에서 다시 읽은 `updatedAt`도 정확히 비교한다. 소스 문자열·mock 검증 또는 H2의 MySQL 자동 갱신 모방은 없다.
|
||||
- RED 명령: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest.shouldPreserveUpdatedAtWithSelfAssignmentInGeneratedHideSql'`. Java 17.0.15, timeout 600000ms, exit 1, `BUILD FAILED in 14s`, tests=1/failures=1/errors=0/skipped=0. 정상 컴파일 후 60행의 실제 SQL assertion이 `update channel_donation_message set is_hidden=? where id=? and creator_id=? and is_hidden=? ==> expected: <true> but was: <false>`로 실패했다.
|
||||
- GREEN: 위 두 클래스 지정 검증 명령을 그대로 실행했다(timeout 600000ms, 표준 daemon·캐시 사용, 강제 재실행 없음). exit 0, `BUILD SUCCESSFUL in 49s`, repository 7 + HTTP E2E 37 = 44건, failures/errors/skipped 모두 0. production/test Kotlin 컴파일, main/test ktlint 검사 및 `bootJar`가 실제 실행됐고 Kotlin script 검사는 UP-TO-DATE 성공이다. 새 jar `build/libs/sodalive-0.0.1-SNAPSHOT.jar`는 141 MiB다.
|
||||
- 실제 GREEN SQL(공백만 정리): `update channel_donation_message set is_hidden=?, updated_at=updated_at where id=? and creator_id=? and is_hidden=?`. 증거는 `build/test-results/test/TEST-kr.co.vividnext.sodalive.v2.creator.channel.donation.adapter.out.persistence.DefaultHideCreatorChannelDonationRepositoryTest.xml`의 신규 testcase 및 Hibernate 출력이다.
|
||||
- 실제 HTTP: Tomcat `51419`에서 JWT 인증 DELETE 성공·중복 성공, 권한/ID 거부 및 anonymous 401을 확인했다. 공개/비밀 `/api/v2/creator-channels/125/donations/181`, `/api/v2/creator-channels/130/donations/183`은 모두 `200 success=true,data=null`이며 원본/재무 전체 컬럼 snapshot, legacy 전체 JSON, 랭킹 500캔 및 정산 39,695원·입금 38,385원 전후 동일 검사가 통과했다. 증거는 같은 디렉터리의 `TEST-kr.co.vividnext.sodalive.v2.api.creator.channel.donation.adapter.in.web.CreatorChannelDonationEndToEndTest.xml`이다.
|
||||
- 정리: 부모를 확인한 뒤 만든 전용 루트 `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/channel-hide.aeTJdH/p3-r1.tm8TPt`에 shell별 TMPDIR/NODE_COMPILE_CACHE/BUN_RUNTIME_TRANSPILER_CACHE_PATH를 지정했다. worker PID `91431/91649` 종료, Tomcat·Hikari 종료 로그, port 51419 listener·Test Executor·redis-server 잔존 없음, `lsof +D` 열린 파일 없음과 0 entries를 확인했다. canonical 부모·현재 UID·symlink 아님을 확인하고 `rmdir`로 전용 루트만 삭제했다. shared Gradle/Kotlin daemon PID `53466/73431`, 부모와 다른 작업 경로는 보존했다.
|
||||
- 한계: 실제 MySQL/운영 DDL, 전체 테스트, subagent/reviewer, commit/stage/push는 실행하지 않았다. LSP 도구는 미제공이며 Kotlin 컴파일·ktlint 결과만 보고한다. 기존 Gradle deprecation 안내는 유지했다. 전체 테스트의 사용자 실행 명령은 `./gradlew test`다. Task P3-R1 및 최종 재리뷰 체크는 상위 판정까지 미완료로 남긴다.
|
||||
|
||||
모든 Phase Gate는 구현 경로를 직접 검증하는 focused feature test만 실행한다. 무필터 `test` 또는 전체 suite를 포함하는 `check`/`build`/`clean build`를 실행하지 않는다. 전체 테스트는 사용자 실행 항목이며 명령은 `./gradlew test`다. Phase Gate의 성공은 전체 suite 성공을 뜻하지 않는다.
|
||||
|
||||
## 프론트엔드 후속 범위
|
||||
|
||||
프론트엔드 작업은 이 backend 저장소 범위 밖이다. 별도 작업에서 소유 CREATOR에게만 전달되는 `donationId`를 사용해 숨김 API를 호출하고, 성공 뒤 홈과 탭 데이터를 다시 조회해야 한다. 프론트엔드 파일 경로, UI 디자인, 추가 확인 dialog/interaction을 이 계획에서 정하지 않는다.
|
||||
|
||||
## 실행 순서와 의존성
|
||||
|
||||
| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
|
||||
|---:|---|---|---|---|
|
||||
| 1 | `P1-T1` | 별도 명시 요청 | 아니요 | DDL/schema 근거 확인 |
|
||||
| 2 | `P1-T2` | `P1-T1` | 아니요 | 기존 auth/error 관례 재확인 |
|
||||
| 3 | `P1-GATE` | `P1-T1`, `P1-T2` | 아니요 | 실패 소유 Task에 회귀 추가 |
|
||||
| 4 | `P2-T1` | `P1-GATE` | 아니요 | count/list 동일 predicate 확인 |
|
||||
| 5 | `P2-T2` | `P2-T1` | 아니요 | 홈 fill 및 owner ID 검증 보강 |
|
||||
| 6 | `P2-GATE` | `P2-T1`, `P2-T2` | 아니요 | 실패 소유 Task에 회귀 추가 |
|
||||
| 7 | `P3-GATE` | `P2-GATE` | 아니요 | legacy/financial 경계 확인 |
|
||||
|
||||
```text
|
||||
P1-T1 -> P1-T2 -> P1-GATE -> P2-T1 -> P2-T2 -> P2-GATE -> P3-GATE
|
||||
```
|
||||
|
||||
## 변경 금지와 중단 조건
|
||||
|
||||
- 별도 구현 요청 전에는 이 계획의 체크박스를 시작하거나 코드를 수정하지 않는다.
|
||||
- soft-hide 행과 원본 값을 보존한다. delete SQL, 필드 초기화, 숨김 metadata/history를 추가하지 않는다.
|
||||
- `isHidden` 조건을 global entity filter, legacy list, ranking, settlement 또는 can use query에 적용하지 않는다.
|
||||
- 권한을 UI에만 맡기지 않는다. 인증, CREATOR role, channel ownership, donation-channel match를 서버에서 검증한다.
|
||||
- 상태 오류를 generic HTTP 403/404로 바꾸지 않고 기존 `SodaException`/handler 응답 관례를 확인한다.
|
||||
- 사용자 결정과 기술 제안을 합치지 않는다. 구현 단계에서 제안 변경이 필요하면 구현 전에 PRD/plan Decision Log를 먼저 갱신한다.
|
||||
|
||||
## Progress 및 문서 검증 기록
|
||||
|
||||
### 최종 완료 판정: 2026-11-05
|
||||
|
||||
- P3-R1 수정 후 상위에서 아래 「최종 기능 범위 재검증」과 동일한 명령을 다시 실행했다. `BUILD SUCCESSFUL in 1m 7s`, XML 19개 클래스 총 **208건**, failures/errors/skipped 모두 0이다. repository 회귀 1건이 추가됐으며 기존 207건도 통과했다.
|
||||
- `ktlintCheck`·`bootJar`는 수정 후 생성 산출물의 UP-TO-DATE 성공이다. 직전 P3-R1 실행에서는 production/test 컴파일·lint·jar 생성이 실제 수행됐다. 전체 suite를 실행한 것은 아니다.
|
||||
- 최초 최종 리뷰에서 MySQL 자동 `updated_at` 갱신 위험을 발견했다. 보존식 1줄과 실제 생성 SQL RED/GREEN을 추가했고, scoped 재리뷰에서 **ADDRESSED / 전체 변경 승인**을 받았다. 실제 MySQL 실행 한계는 유지한다.
|
||||
- 최종 테스트 worker PID 92754 잔존 없음과 임시 루트 열린 파일 없음을 확인했다. 테스트/HTTP/SQL 증거는 `build/test-results/test/`, 빌드 산출물은 `build/libs/sodalive-0.0.1-SNAPSHOT.jar`에 남긴다.
|
||||
- 최종 정리 영수증: 소유권·symlink 아님·빈 상태를 확인해 남은 `p1-t1.SxYFSF`와 부모 `channel-hide.aeTJdH`를 `rmdir`로 제거했다. 임시 notepad도 제거했고 셸에서 세 경로 부재를 확인했다(exit 0). 작업용 서버/worker는 종료됐으며 공유 캐시·기존 daemon은 건드리지 않았다. 최종 tracked 및 신규 파일 공백 검사도 exit 0이었다.
|
||||
- 현재 변경은 서버 소스·관련 테스트·본 기능 문서/DDL에 한정한다. 커밋·push·운영 SQL·배포는 하지 않았다. 전체 테스트 사용자 명령은 `./gradlew test`다.
|
||||
- 프론트엔드 연동은 범위 밖이며 서버 구현 완료와 화면 클라이언트 반영 완료를 구분한다. 기존 프로필 API에서는 숨긴 행이 계속 보일 수 있다.
|
||||
|
||||
### 최종 기능 범위 재검증: 2026-11-05
|
||||
|
||||
- 상위 세션에서 아래 명령을 직접 실행했다. exit 0, `BUILD SUCCESSFUL in 1m 5s`, XML 19개 클래스 합계 207건, failures/errors/skipped 모두 0이다. 이는 변경 기능과 직접 영향 회귀이며 전체 suite가 아니다.
|
||||
- `ktlintCheck` 및 `bootJar`는 동일 입력의 UP-TO-DATE 성공이다. production jar는 Phase 2에서 생성했고 이후 production 변경은 없다.
|
||||
- 실제 socket HTTP에서 공개/비밀 500캔 각각 DELETE 성공, V2 목록/건수 감소, legacy 전체 JSON 유지, cache 제거 후 랭킹 500캔 유지, 실제 정산 39,695원·입금액 38,385원 유지 로그를 다시 확인했다.
|
||||
- 최종 worker PID 89370의 Tomcat·Hikari 종료 로그와 `ps -p 89370` 잔존 없음, `git diff --check` exit 0을 확인했다. 전체 변경 Oracle 리뷰는 별도로 대기한다.
|
||||
|
||||
```bash
|
||||
./gradlew test \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.donation.*' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.donation.*' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.creator.channel.home.*' \
|
||||
--tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.*' \
|
||||
--tests 'kr.co.vividnext.sodalive.explorer.profile.channelDonation.*' \
|
||||
--tests 'kr.co.vividnext.sodalive.admin.calculate.channelDonation.AdminChannelDonationCalculateQueryRepositoryTest' \
|
||||
ktlintCheck bootJar --console=plain
|
||||
```
|
||||
|
||||
- 전체 테스트 `./gradlew test`는 사용자 실행 항목이다. 운영 MySQL/DDL 실행·배포·프론트엔드 연동은 수행하지 않았다. `lsp_diagnostics` 미제공으로 Kotlin 컴파일/ktlint를 사용했으며 LSP 검증을 주장하지 않는다.
|
||||
|
||||
### 구현 착수: 2026-11-05
|
||||
|
||||
- 사용자 "문서대로 진행" 승인으로 기술 초안과 미래 구현 계획의 실행을 시작한다. 문서 전용 제한/미요청 문구는 과거 작성 시점 기록이며, 현재 제품 코드·테스트·DDL 문서 변경을 허용한다. 실제 운영 DDL 실행과 배포는 하지 않는다.
|
||||
- 현재 `test` 브랜치에서 작업한다. 기존 source 변경이 없고 별도 worktree를 자동 생성하지 않는다. 검증은 프로젝트 기준의 focused test, HTTP 경로, lint 및 bootJar를 사용한다.
|
||||
- 제공된 도구에 `lsp_diagnostics`가 없어 Kotlin 컴파일·ktlint로 대체하며 LSP 검증 성공을 주장하지 않는다.
|
||||
|
||||
### 문서 작성: 2026-11-05
|
||||
|
||||
- 상태: PRD와 미래 계획 작성 완료. 현재 Goal 없음, 구현/테스트 미착수.
|
||||
- 무엇을: 사용자 인터뷰 결정과 현행 donation/home V2 query, DTO, controller, tests를 근거로 지정 문서 두 개를 작성한다.
|
||||
- 어떻게: 코드 스타일/테스트/작업 절차/문서 유지보수/실행 명령어 지침, 두 sample 문서, 기존 비밀 후원 PRD/계획, `ChannelDonationMessage`, donation/home repository, response DTO 및 donation HTTP E2E test를 읽었다.
|
||||
- 문서 전용이므로 Gradle, API 호출, SQL 실행 및 runtime/test/build 검증은 하지 않았다. 향후 계획의 명령은 실행 결과가 아니다.
|
||||
- 최초 초안에서는 콘텐츠 일관성 및 공백 검사가 검증 대기였으며, 후속 결과는 아래 문서 검증 기록에 누적한다.
|
||||
- 남은 조건: 사용자의 별도 명시 구현 요청. frontend 작업은 backend와 별도 범위.
|
||||
|
||||
### 문서 검증: 2026-11-05
|
||||
|
||||
- 상태: 문서 작성·검토 완료. 제품 구현은 미착수이며 활성 구현 Goal은 없다.
|
||||
- 무엇을/왜: 인터뷰 결정, PRD 요구사항, Goal·파일·검증 명령의 연결을 대조하고 기술 초안이 사용자 확정사항으로 오인되지 않는지 확인했다.
|
||||
- 내용 검증: 두 문서 전체 읽기, 실제 source/test 경로 대조, 요구사항 추적표와 상대 링크 확인. 날짜는 `date '+%Y-%m-%d %Z'`의 `2026-11-05 KST`에 맞췄다.
|
||||
- 독립 검토: 최초 검토 에이전트는 지원되지 않는 모델로 시작 실패했다. 다른 실행 경로의 검토자는 읽기 전용 builder check 후 중요한 미해결 질문·모순·실행 차단 결함이 없다고 판정했다.
|
||||
- 공백 검사: 두 문서 각각 `GIT_MASTER=1 git diff --no-index --check /dev/null "docs/20261105_채널후원메시지숨김/prd.md"`, `GIT_MASTER=1 git diff --no-index --check /dev/null "docs/20261105_채널후원메시지숨김/plan-task.md"` 실행, 각각 exit 0·출력 없음. untracked 문서도 검사 대상에 포함했다.
|
||||
- 변경 범위: `GIT_MASTER=1 git status --short --untracked-files=all`로 이 작업의 신규 문서 두 개만 확인했다. 제품 코드·테스트·설정·SQL은 변경하지 않았다.
|
||||
- 미실행: 문서 전용 변경이므로 테스트·빌드·Gradle·API·SQL 실행과 런타임/운영 DB 검증은 생략했다. 실제 기능이 동작한다는 완료 주장은 하지 않는다.
|
||||
- 다음 조건: 기술안 검토 및 별도의 구현 요청. 전체 테스트 명령 `./gradlew test`는 향후 구현 후 사용자가 직접 실행한다.
|
||||
|
||||
## Decision Log
|
||||
|
||||
| 날짜 | ID | 상태 | 결정 | 근거 | 영향 |
|
||||
|---|---|---|---|---|---|
|
||||
| 2026-11-05 | `PLAN-DEC-001` | 사용자 확정 | 후원 항목 하나 soft-hide, 원본/재무 보존, 두 V2 목록만 숨김. | 사용자 인터뷰 | `CDH-001`~`CDH-008` |
|
||||
| 2026-11-05 | `PLAN-DEC-002` | 작성자 기술 초안 | 단일 boolean, 로컬 query filter, owner-only ID, bodyless DELETE API, 멱등 재요청. | 현행 패키지 및 query 경계 | `CDH-009`, `P1-T1`~`P2-T2` |
|
||||
|
||||
## 최종 문서 전용 확인
|
||||
|
||||
- [x] 두 문서 간 ID/범위/기술 제안 정합성 및 trailing whitespace를 확인했다.
|
||||
- [x] 변경 파일이 이 디렉터리의 `prd.md`와 `plan-task.md` 두 개뿐인지 확인했다.
|
||||
- 문서 전용 변경이므로 프로젝트 지침에 따라 Gradle 테스트/빌드는 실행하지 않는다. 런타임 동작은 미검증이다.
|
||||
|
||||
## 커밋 전 검증: 2026-11-05
|
||||
|
||||
- 사용자 `/commit-with-validation` 요청으로 변경 파일과 전역 커밋 절차 및 저장소 메시지 규칙을 확인했다.
|
||||
- Java 17.0.15에서 위 「최종 기능 범위 재검증」의 명령을 동일하게 실행했다. `BUILD SUCCESSFUL in 2s`, exit 0이며 test·ktlintCheck·bootJar를 포함한 19개 task 모두 UP-TO-DATE였다. 테스트를 새로 실행하거나 jar를 새로 생성한 결과로 표현하지 않는다.
|
||||
- 현재 XML 19개 클래스의 208건, failures/errors/skipped 모두 0을 확인했다. `git diff --check`도 통과했다.
|
||||
- 전체 테스트와 운영 MySQL/DDL 적용은 수행하지 않았다. 전체 테스트 사용자 명령은 `./gradlew test`이며, 배포 전 DDL 선반영 조건은 유지한다.
|
||||
@@ -0,0 +1,162 @@
|
||||
# 채널 후원 메시지 항목 숨김 PRD
|
||||
|
||||
## 문서 정보
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 문서 상태 | 서버 구현·기능 범위 검증·최종 리뷰 완료. 운영 DDL/프론트엔드 연동 미수행 |
|
||||
| 작성일 | 2026-11-05 |
|
||||
| 최종 수정일 | 2026-11-05 |
|
||||
| 대상 제품 | 크리에이터 채널 후원 메시지 숨김 |
|
||||
| 작성자·결정권자 | 요구사항은 사용자 인터뷰로 확정, 기술안은 문서 작성자 제안 |
|
||||
| 관련 API Contract | 이 문서 §8, `DEC-006`으로 구현 승인 |
|
||||
| 관련 구현 계획 | [plan-task.md](plan-task.md) |
|
||||
| 관련 review | 없음 |
|
||||
|
||||
## 1. 개요
|
||||
|
||||
크리에이터는 자신의 채널에 표시되는 단일 후원 항목을 숨길 수 있다. 숨김은 원본 후원 기록을 보존하는 표시 조정이며, 채널 홈의 `channelDonations`와 후원 탭의 `donations`에서만 항목을 제외한다. 최초에는 문서만 작성했으며, 이후 사용자의 "문서대로 진행" 승인(`DEC-006`)에 따라 구현했다. 현재 실행 상태와 검증 결과는 [plan-task.md](plan-task.md)를 기준으로 한다.
|
||||
|
||||
## 2. 문제와 목표
|
||||
|
||||
채널에 표시된 후원 메시지가 부적절하거나 더 이상 게시하기 적절하지 않을 수 있지만, 이를 제거하면서 후원 및 정산 이력을 변경해서는 안 된다. 크리에이터가 해당 후원 항목을 숨기면 모든 조회자에게 두 V2 채널 표시 위치에서 보이지 않고 원본 기록과 재무 효과는 그대로 남아야 한다.
|
||||
|
||||
## 3. 목표와 범위 밖
|
||||
|
||||
### 목표
|
||||
|
||||
- 채널의 소유 CREATOR만 해당 채널의 후원 항목 하나를 숨길 수 있다.
|
||||
- 숨긴 항목은 채널 소유자와 후원자를 포함한 모든 조회자에게 두 V2 표시 목록에서 제외된다.
|
||||
- `donationCount`는 숨기지 않은 후원 항목만 센다.
|
||||
- 데이터베이스 원본 값, 기여도 랭킹, 정산 및 사용한 can은 그대로 보존된다.
|
||||
|
||||
### 범위 밖
|
||||
|
||||
- 복원, 물리 삭제, 후원 취소, 환불, can 사용 취소 또는 정산 역분개.
|
||||
- legacy 프로필/후원 목록 API의 숨김 처리. 해당 경로는 같은 원본 기록을 계속 노출할 수 있다. 이 기능은 전역 삭제나 전체 서비스 비노출을 약속하지 않는다.
|
||||
- 관리자 추가 권한, 후원자 권한, 다른 크리에이터 권한, 일반 회원 권한.
|
||||
- 숨김 사유, 수행자/시각 이력, UI 이력, 일괄 API, 실시간 push.
|
||||
- 프론트엔드 구현 및 화면 디자인. 별도 프론트엔드 작업은 소유자 전용 ID로 숨김 API를 호출하고 두 표시 경로를 다시 조회해야 한다.
|
||||
|
||||
## 4. 사용자와 권한
|
||||
|
||||
| 주체 | 숨김 가능 여부 | 두 V2 목록의 숨긴 항목 |
|
||||
|---|---:|---|
|
||||
| 해당 채널의 소유 CREATOR | 가능 | 제외 |
|
||||
| 후원자 본인 | 불가 | 제외 |
|
||||
| 다른 CREATOR | 불가 | 제외 |
|
||||
| 일반 회원 | 불가 | 제외 |
|
||||
| 관리자 | 이 요청으로 추가 권한 없음 | 제외 |
|
||||
|
||||
서버는 인증 회원, `CREATOR` role, 요청 경로의 `creatorId`와 인증 회원의 채널 소유권, 후원 항목과 동일 채널 소속을 검증한다. 존재하지 않는 항목 또는 다른 채널의 ID를 안전하게 거부하고 어떠한 기록도 변경하지 않는다. 현재 `SodaException` 및 공통 오류 handler를 따른다. 프로젝트 관례상 도메인 실패는 HTTP 200 응답의 `success=false` envelope일 수 있으며, 별도의 REST 403/404 계약을 만들지 않는다.
|
||||
|
||||
## 5. 핵심 흐름 (기술 제안 포함)
|
||||
|
||||
1. 소유 CREATOR가 채널 홈 또는 후원 탭에서 항목을 선택한다.
|
||||
2. 프론트엔드는 소유자에게만 응답되는 안정적인 `donationId`로 숨김 요청을 보낸다.
|
||||
3. 서버가 인증, role, 채널 소유권 및 후원 소속을 확인한 뒤 해당 항목의 숨김 상태만 기록한다.
|
||||
4. 같은 소유자가 이미 숨긴 항목을 다시 요청해도 성공하는 멱등 동작을 제공한다.
|
||||
5. 프론트엔드는 홈과 후원 탭을 다시 조회한다. 숨긴 항목은 양쪽에서 보이지 않으며 count도 감소한다.
|
||||
|
||||
## 6. 제품 요구사항
|
||||
|
||||
| ID | 상태 | 요구사항 | 수용 기준 |
|
||||
|---|---|---|---|
|
||||
| `CDH-001` | 확정 | 소유 CREATOR는 채널 후원 한 항목을 숨긴다. | ID로 단일 항목을 지정하며 소유권과 채널 소속이 모두 일치할 때만 성공한다. |
|
||||
| `CDH-002` | 확정 | 숨김 상태는 soft-hide다. | DB 행, ID, can, 메시지, donor/creator 연결, 생성 시각, `isSecret`이 보존된다. |
|
||||
| `CDH-003` | 확정 | 숨긴 항목은 모든 사용자에게 숨긴다. | V2 홈 `channelDonations` 및 V2 후원 탭 `donations`에서 creator와 donor 본인 포함 전원에게 제외된다. |
|
||||
| `CDH-004` | 확정 | 후원 탭의 `donationCount`는 보이는 항목 수다. | 숨김 항목은 count에서 빠지며 pagination 및 `hasNext`도 같은 숨김 제외 조건을 쓴다. |
|
||||
| `CDH-005` | 확정 | 랭킹과 재무 효과는 보존한다. | 기존 랭킹, 정산, 원본 can 사용 및 후원 기록의 값/행이 달라지지 않는다. |
|
||||
| `CDH-006` | 확정 | 권한은 소유 CREATOR에 한정한다. | donor, 타 CREATOR, USER, ADMIN 요청은 거부되며 기록 변화가 없다. |
|
||||
| `CDH-007` | 확정 | 숨김은 지정된 두 V2 표시 경로만 바꾼다. | legacy 프로필/후원 목록은 변경하지 않으며 같은 행을 계속 반환할 수 있음을 명시한다. |
|
||||
| `CDH-008` | 확정 | 현재 공개/비밀 후원 표시 정책을 유지한다. | 숨기지 않은 공개 및 비밀 항목은 현재 `isSecret` 마스킹 규칙으로 계속 표시된다. |
|
||||
| `CDH-009` | 작성자 기술 초안 | 숨김 재요청은 안전하게 성공하도록 제안한다. | 같은 소유자의 중복 숨김 요청은 성공하며 금융 효과를 재적용하지 않는다. |
|
||||
|
||||
## 7. 기술 상태와 근거
|
||||
|
||||
다음 기술 선택은 최초 **AUTHOR TECHNICAL DRAFT**로 작성했고 `DEC-006`으로 구현 승인됐다. 아래 제안 표현은 작성 당시의 결정 근거이며 현재 구현 계약으로 사용한다.
|
||||
|
||||
- 변경 전 엔티티 `ChannelDonationMessage`는 `BaseEntity`의 ID/시간을 상속하며 숨김 필드가 없었다. 구현은 boolean `isHidden=false`를 추가하고 MySQL의 `is_hidden TINYINT(1) NOT NULL DEFAULT 0 COMMENT '채널 후원 표시 숨김 여부'`를 사용한다. [운영 반영용 DDL](channel_donation_message_is_hidden_ddl.sql)을 작성했으며 운영 DB에는 실행하지 않았다.
|
||||
- 기존 donation 탭 QueryDSL은 채널과 KST 월 조건으로 count와 page 조회를 나눠 수행하고, 홈 QueryDSL은 같은 기간의 최신 8건을 조회한다. 숨김 조건은 각 조회 경로의 `offset/limit` 적용 전에 둔다. 홈은 기존 limit 8을 유지해 숨긴 항목 다음의 표시 가능 항목으로 최대 8개를 채운다.
|
||||
- donation 탭의 count와 list가 동일한 숨김 제외 predicate를 사용한다. legacy query, 랭킹/정산/금융 query에는 전역 filter를 추가하지 않는다. Hibernate 전역 `@Where`/`@SQLDelete`는 사용하지 않는다.
|
||||
- 현재 홈/탭 후원 응답은 후원 항목의 ID와 donor member ID를 노출하지 않으며 기존 테스트도 ID 부재를 검증한다. 숨김 동작을 위해 안정적인 `donationId`를 소유 CREATOR 응답에만 nullable/생략 방식으로 추가하는 방안을 제안한다. 일반 조회자, donor 및 다른 사용자의 JSON에는 ID가 없어야 하며 donor `memberId`는 누구에게도 추가 노출하지 않는다. 기존 owner ID 부재 assertion은 owner-only ID 노출 검증으로 갱신하고 non-owner 부재 검증은 유지한다.
|
||||
- 제안 endpoint는 bodyless `DELETE /api/v2/creator-channels/{creatorId}/donations/{donationId}`이며 `ApiResponse.ok` envelope에 data 없이 성공을 반환한다. 기존 인증 주입, `SodaException`, message key/i18n 및 handler를 재사용한다. generic REST 403/404를 새로 도입하지 않는다.
|
||||
- 공개 후원 및 비밀 후원의 기존 `isSecret` 표시/masking은 visible row에만 그대로 적용한다. 숨긴 항목은 공개/비밀 구분 없이 전체 제외한다.
|
||||
|
||||
## 8. 제안 API 경계 (AUTHOR TECHNICAL DRAFT)
|
||||
|
||||
| Method / path | 입력 | 성공 | 실패 및 제한 |
|
||||
|---|---|---|---|
|
||||
| `DELETE /api/v2/creator-channels/{creatorId}/donations/{donationId}` | 인증 사용자, 경로 ID, body 없음 | 기존 `ApiResponse.ok` envelope, data 없음 | 현재 `SodaException`/handler 및 현행 HTTP-200 `success=false` 도메인 오류 패턴. 비소유/불일치/미존재는 상태 변경 없이 거부 |
|
||||
|
||||
제안된 application 경계는 재사용 패키지 `kr.co.vividnext.sodalive.v2.creator.channel.donation`의 `HideCreatorChannelDonationService.hide(creatorId: Long, donationId: Long, actor: Member)`다. 출력 port는 `HideCreatorChannelDonationPort.hideOwnedDonation(creatorId: Long, donationId: Long): Boolean`로 채널에 속하는 항목만 원자적으로 숨긴다. 소유자 role/identity 검증은 service 경계에서 수행한다. adapter 패키지 `kr.co.vividnext.sodalive.v2.api.creator.channel.donation`은 controller/facade와 공개 응답의 소유자 전용 `donationId`를 조립한다. 구체 파일과 인터페이스는 plan의 기술 초안에 적는다.
|
||||
|
||||
숨김 행 재요청은 이미 숨김 상태면 성공으로 끝낸다. 첫 요청과 재요청 모두 can 사용, 환불, 랭킹, 정산을 호출하거나 수정하지 않는다. 소유권·같은 채널 소속·항목 존재 여부가 일치하지 않으면 성공 처리하지 않는다.
|
||||
|
||||
## 9. 비기능, 보안과 데이터
|
||||
|
||||
- 사용자 제공 ID는 신뢰하지 않는다. 인증 회원, `CREATOR` role, 채널 소유자 ID 및 donation의 channel ID를 서버에서 대조한다.
|
||||
- 다른 채널/존재하지 않는 donation에 대한 거부가 데이터 존재 여부를 불필요하게 노출하지 않도록 기존 도메인 오류 패턴을 검토한다.
|
||||
- `isHidden` 외에 `hiddenAt`, `hiddenBy`, reason, history를 추가하지 않는다.
|
||||
- 변경 범위 밖의 구형 API가 원본을 노출할 수 있다는 제한을 제품/운영 설명에서 숨기지 않는다.
|
||||
- 테스트는 repository/HTTP 통합 근거를 포함하고, 기존 테스트 관례인 JUnit 5, `@SpringBootTest`, 실제 H2/MockMvc 경로를 따른다.
|
||||
|
||||
## 10. 성공 기준과 추적
|
||||
|
||||
- [x] `CDH-001`~`CDH-009`의 미래 구현 테스트와 계획 Goal이 연결되어 있다. 구현 및 테스트 통과를 뜻하지 않는다.
|
||||
- [x] 역할별 권한, 다른 채널 및 존재하지 않는 ID, 숨김 중복 요청을 HTTP 통합으로 확인했다.
|
||||
- [x] 모든 viewer role의 홈/탭 결과에서 숨긴 공개/비밀 행이 제외된다.
|
||||
- [x] count, page, `hasNext`, 홈 최신 8개 보충 결과가 숨김 predicate와 일치한다.
|
||||
- [x] 원본 행과 값, ranking, settlement, can 사용 내역의 불변을 H2/실제 HTTP로 확인했다. MySQL 자동 수정 시각 보존은 생성 SQL 자기 대입 회귀로 확인했으며 운영 MySQL 실행은 미검증이다.
|
||||
- [x] legacy 출력이 변경되지 않고 그 제한을 문서화했다.
|
||||
- [x] donor member ID는 추가 노출되지 않으며 donation ID는 소유 CREATOR에만 응답된다.
|
||||
|
||||
| 요구사항 | 계획 Goal | 주요 완료 증거 |
|
||||
|---|---|---|
|
||||
| `CDH-001`, `CDH-006` | `P1-T1`, `P1-T2`, `P1-GATE` | 소유 CREATOR 성공, 비소유/위조 ID/미존재 거부 |
|
||||
| `CDH-002`, `CDH-005`, `CDH-007` | `P1-T1`, `P3-GATE` | DB 재조회, 실제 랭킹/정산 및 legacy 조회 전후 비교 |
|
||||
| `CDH-003`, `CDH-004`, `CDH-008` | `P2-T1`, `P2-T2`, `P2-GATE` | 역할별 숨김 제외, count/page/refill, visible 비밀 후원 마스킹 |
|
||||
| `CDH-009` (기술 초안) | `P1-T1`, `P1-T2` | 동일 소유자의 중복 요청 성공 및 추가 변경 없음 |
|
||||
| 소유자 전용 ID (기술 초안) | `P2-T1`, `P2-T2` | 양 응답의 동일 persisted ID, 비소유자 JSON의 ID 부재 |
|
||||
|
||||
## 11. 인터뷰 기록과 미결 사항
|
||||
|
||||
사용자 인터뷰 결정: 단일 항목 soft-hide, 소유 CREATOR만 권한 보유, 모든 viewer에게 두 V2 목록에서 제외, 복원 없음, donationCount 제외, 랭킹/정산/can 사용 보존, legacy API 불변 및 전역 삭제가 아님.
|
||||
|
||||
점수: Goal 1.00, Scope 1.00, Constraints 0.90, Success 0.85, Context 0.85. 기존 코드베이스 가중치 `.30/.20/.15/.20/.15` 적용 모호성은 **0.0675 (약 0.07)**다. 제품 질문은 모두 해결되었다. 기술안은 사용자 결정으로 승격하지 않는다.
|
||||
|
||||
| 분류 | 상태 | 항목 |
|
||||
|---|---|---|
|
||||
| 제품 질문 | 없음 | 구현 범위·권한·보존 정책·조회 범위는 인터뷰로 확정 |
|
||||
| 기술 제안 | `DEC-006` 승인 | §7~§9의 필드, predicate, ID 노출 및 endpoint 계약을 구현 기준으로 확정 |
|
||||
| 외부 의존 | 프론트엔드 연동 필요 | 실제 화면의 숨김 조작과 양쪽 데이터 갱신은 별도 프론트엔드 작업. 이 계획의 backend 완료와 화면 기능 완료를 구분 |
|
||||
|
||||
## 12. Decision Log
|
||||
|
||||
| 날짜 | ID | 상태 | 결정 | 근거 |
|
||||
|---|---|---|---|---|
|
||||
| 2026-11-05 | `DEC-001` | 사용자 확정 | 단일 채널 후원 항목을 soft-hide하고 원본 기록/값을 보존한다. | 사용자 인터뷰 |
|
||||
| 2026-11-05 | `DEC-002` | 사용자 확정 | 소유 CREATOR만 숨김할 수 있고, 숨긴 항목은 두 V2 목록에서 모든 viewer에게 제외한다. | 사용자 인터뷰 |
|
||||
| 2026-11-05 | `DEC-003` | 사용자 확정 | donationCount에서 제외하되 랭킹, 정산, can 사용은 그대로 둔다. | 사용자 인터뷰 |
|
||||
| 2026-11-05 | `DEC-004` | 사용자 확정 | legacy 프로필/후원 목록, 복원 및 기타 global hide는 범위 밖이다. | 사용자 인터뷰 |
|
||||
| 2026-11-05 | `DEC-005` | 작성자 기술 초안 | `isHidden` 필드, 로컬 query filter, owner-only ID, DELETE route, 멱등 재요청을 제안한다. | 기존 코드 경계와 최소 구현 검토. 사용자 승인 아님 |
|
||||
|
||||
## 13. 기준 문서와 변경 관리
|
||||
|
||||
[`docs/20261104_크리에이터채널_비밀후원_익명조회/prd.md`](../20261104_크리에이터채널_비밀후원_익명조회/prd.md)는 현재 visible row의 비밀 여부 마스킹 기준이다. 본 문서는 기존 `isSecret` 마스킹 정책을 변경하지 않고, 숨김 상태의 두 V2 query 제외 및 `donationCount`에 한해 후속 요구를 더한다. 과거 PRD의 목록 DTO ID 비노출 요구는 **owner-only `donationId` 기술안이 승인될 경우에만** 소유 CREATOR 응답 범위에서 좁게 대체한다. 현재 공개 계약을 이미 변경한 것은 아니다. donor member ID 부재 및 모든 non-owner의 ID 부재 요구는 유지한다. 과거 문서는 수정하지 않는다.
|
||||
|
||||
구현 착수 전 별도의 명시적 요청이 필요하다. 구현 선택을 확정하면 이 PRD의 기술 제안을 승인된 계약과 구분해 Decision Log에 반영하고 계획을 동기화한다.
|
||||
|
||||
### 구현 승인: 2026-11-05
|
||||
|
||||
사용자의 "문서대로 진행" 요청으로 이 문서의 기술 제안과 계획을 구현 기준으로 승인했다. 위 초안/미요청 표기는 작성 당시 이력이며 현재는 `isHidden`, 소유 CREATOR 전용 `donationId`, bodyless DELETE 및 멱등 재요청을 구현한다. 프론트엔드·운영 DDL 실행·배포는 포함하지 않는다.
|
||||
|
||||
| 날짜 | ID | 상태 | 결정 | 근거 |
|
||||
|---|---|---|---|---|
|
||||
| 2026-11-05 | `DEC-006` | 사용자 승인 | `DEC-005` 기술 초안을 본 구현의 계약으로 사용한다. | "문서대로 진행" |
|
||||
|
||||
### 서버 구현 완료: 2026-11-05
|
||||
|
||||
- 관련 기능 19개 클래스 208건이 실패/오류/skip 없이 통과했다. 실제 JWT socket HTTP, 원본 DB·랭킹·정산·legacy 보존과 SQL 시각 보존을 검증했고 최종 리뷰가 승인됐다.
|
||||
- `ktlintCheck`, `bootJar` 성공. 전체 suite는 미실행이며 사용자가 `./gradlew test`로 검증한다. 상세 명령·실패 이력·최종 증거는 [plan-task.md](plan-task.md)에 있다.
|
||||
- [DDL](channel_donation_message_is_hidden_ddl.sql)은 작성만 했으며 배포 전에 반영해야 한다. 프론트엔드는 소유자 전용 `donationId`로 DELETE를 호출하고 두 조회 결과를 갱신해야 한다. 화면 클라이언트·운영 배포 완료를 의미하지 않는다.
|
||||
@@ -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`다.
|
||||
@@ -20,10 +20,9 @@
|
||||
- 각 task에는 TDD 절차를 명시한다. 기본 형식은 `RED: 실패 테스트 작성/실패 확인`, `GREEN: 최소 구현/통과 확인`, `REFACTOR: 정리/회귀 확인`을 포함한다.
|
||||
- 테스트 작성이 현실적으로 불가능한 task는 `TDD 예외 사유`와 `대체 검증 방법`을 task에 명시한다.
|
||||
- 각 phase 또는 task에는 실행 명령, 기대 결과, 수동 확인 항목 등 검증 기준을 함께 작성한다.
|
||||
- 각 task의 검증 기준에는 focused test와 직접 영향받는 회귀 명령을 우선 명시한다. 전체 회귀는 광범위한 공통 코드 변경,
|
||||
여러 domain/phase 변경, release/final Gate에서 전체 상태 증거를 별도로 요구하는 경우, targeted test만으로 영향 범위를 판단할
|
||||
수 없는 경우 또는 사용자 요청일 때만 포함한다.
|
||||
- 계획에서 전체 회귀를 조건부로 두면 실행 조건, 생략 시 기록할 근거와 대체 focused/영향 범위 회귀 명령을 함께 명시한다.
|
||||
- 각 Task와 Gate의 에이전트 검증 명령은 구현 기능의 focused test와 직접 영향받는 기능별 회귀로 한정한다. 전체 테스트는 사용자 실행 항목으로 분리한다.
|
||||
- 공통 코드·여러 domain/phase 변경·release/final Gate를 자동 전체 테스트 실행 조건으로 작성하지 않는다. `check`/`build`/`clean build`의 간접 전체 테스트도 피하고 필요한 빌드는 `bootJar`로 명시한다.
|
||||
- 계획과 결과 보고에 기능별 실행 명령·결과, 전체 테스트 미실행 사실 및 사용자 실행 명령 `./gradlew test`를 남긴다. 기능 범위 완료와 사용자 전체 검증 상태를 구분하며 기존 timeout·실패 이력은 보존한다.
|
||||
- 구현 완료 즉시 해당 task 체크박스를 `- [x]`로 갱신한다.
|
||||
- 작업 도중 범위가 변경되면 계획 문서 체크리스트를 먼저 업데이트한 뒤 구현한다.
|
||||
- 결과 보고 시 개별 task 검증 기록(무엇/왜/어떻게, 실행 명령, 결과)은 해당 task 아래에 한국어로 남긴다.
|
||||
|
||||
+40
-12
@@ -3,25 +3,53 @@
|
||||
## 실행 기준
|
||||
- 아래 명령은 저장소 루트(`/Users/klaus/Develop/sodalive/Server/sodalive`)에서 실행한다.
|
||||
- 변경 범위에 맞는 최소 명령으로 검증하고, 결과는 계획 문서 하단 검증 기록에 남긴다.
|
||||
- 검증은 focused test → 영향받는 package/feature 회귀 → 전체 회귀 순서로 범위를 넓힌다.
|
||||
- 전체 회귀 테스트(`./gradlew test`, `./gradlew check`, 전체 `build`)는 실행 시간이 길므로 매 Task나 일반적인 작은 변경에서
|
||||
관성적으로 실행하지 않는다.
|
||||
- 공통 인증·보안·예외·설정·serialization처럼 영향 범위가 넓은 코드 변경, 여러 domain/phase에 걸친 변경, release/final Gate에서
|
||||
전체 상태 증거를 별도로 요구하는 경우, targeted test만으로 영향 범위를 판단할 수 없는 실패 또는 사용자 명시 요청일 때만
|
||||
전체 회귀를 실행한다.
|
||||
- 전체 회귀를 생략하면 실행하지 않은 사실, 생략 근거와 대신 실행한 focused/영향 범위 회귀 명령을 계획 문서에 기록한다.
|
||||
- 에이전트는 구현 중인 기능의 focused test와 직접 영향받는 package/feature 회귀만 각각 실행한다. `--tests`로 대상 클래스·메서드·패키지를 명시한다.
|
||||
- 전체 테스트는 10분 실행 제한으로 완료되지 않는 경우가 많으므로 사용자가 직접 실행한다. 에이전트는 무필터 `./gradlew test`를 자동 실행하거나 timeout 후 재시도하지 않는다.
|
||||
- 공통 코드 변경, 여러 domain/phase 변경, release/final Gate라도 자동으로 전체 테스트로 확대하지 않는다. 영향받는 기능을 식별해 각각 검증하고 확인하지 못한 범위를 보고한다.
|
||||
- `./gradlew check`, `./gradlew build`, `./gradlew clean build`도 전체 테스트를 포함하므로 에이전트가 자동 실행하지 않는다. 빌드 산출물 검증이 필요하면 `./gradlew bootJar`를 사용하고 기능별 테스트와 구분해 기록한다.
|
||||
- 계획 문서와 최종 보고에는 실행한 기능별 테스트 명령·결과, 전체 테스트 미실행 사실, 사용자 실행 명령 `./gradlew test`를 남긴다. 기능별 성공을 전체 테스트 성공으로 표현하지 않는다.
|
||||
- 전체 테스트의 사용자 실행 대기는 기능 범위 완료를 막지 않는다. 기능별 테스트 실패나 미검증 위험은 별도로 명시하며 실패를 무시하거나 테스트를 완화하지 않는다.
|
||||
|
||||
## Build/Lint/Test
|
||||
|
||||
아래는 사용 가능한 명령 목록이며 모든 변경에서 전부 실행하라는 의미가 아니다.
|
||||
에이전트는 변경 범위에 필요한 명령만 선택한다. 아래 `--tests`는 기존 홈 기능의 예시이며 실제 작업 대상에 맞게 바꾼다.
|
||||
|
||||
```bash
|
||||
./gradlew tasks --all
|
||||
./gradlew bootRun
|
||||
./gradlew build
|
||||
./gradlew clean build
|
||||
./gradlew test
|
||||
./gradlew check
|
||||
./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 ktlintCheck
|
||||
./gradlew ktlintFormat
|
||||
```
|
||||
|
||||
사용자가 직접 실행하는 전체 검증 명령:
|
||||
|
||||
```bash
|
||||
./gradlew test
|
||||
./gradlew check
|
||||
./gradlew build
|
||||
./gradlew clean build
|
||||
```
|
||||
|
||||
위 명령은 목적에 맞게 하나를 선택한다. 전체 테스트 확인만 필요하면 `./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
|
||||
```
|
||||
|
||||
@@ -29,8 +29,8 @@
|
||||
전에는 goal이나 Phase Gate를 완료 처리하지 않는다.
|
||||
- 변경 중: 완료된 Task와 기존 검증 기록은 되돌리거나 삭제하지 않는다. 후속 리뷰에서 발견한 회귀는 별도 Task/Goal로 누적한다.
|
||||
- 변경 후: 변경 범위의 focused test를 우선 실행하고, 공유 경계와 직접 영향받는 package/feature 회귀까지만 단계적으로 확장한다.
|
||||
- 변경 후: 전체 회귀 테스트는 공통 인증·보안·예외·설정 등 광범위한 변경, 여러 domain/phase 변경, release/final Gate에서 전체
|
||||
상태 증거를 별도로 요구하는 경우, targeted test만으로 영향 범위를 판단할 수 없는 실패 또는 사용자 명시 요청일 때만 실행한다.
|
||||
- 변경 후: 전체 회귀 테스트를 실행하지 않으면 생략 사실과 근거, 대신 실행한 focused/영향 범위 회귀 명령을 검증 기록에 남긴다.
|
||||
- 변경 후: 전체 테스트는 사용자가 직접 수행한다. 공통 코드·여러 domain/phase 변경이나 release/final Gate에서도 에이전트는 관련 기능을 각각 검증하며 전체 테스트로 자동 확대하지 않는다.
|
||||
- 변경 후: 전체 테스트를 포함하는 무필터 `test`, `check`, `build`, `clean build`를 자동 실행하지 않는다. 필요한 빌드 검증은 `bootJar`로 분리한다.
|
||||
- 변경 후: 검증 기록과 최종 보고에 실행한 기능별 명령·결과, 미검증 범위와 사용자용 전체 테스트 명령 `./gradlew test`를 남긴다. 전체 테스트 사용자 실행 대기만으로 기능 범위 완료를 막거나 전체 성공으로 표시하지 않는다.
|
||||
- 변경 후: 각 task의 검증 결과는 해당 task 아래에 무엇을, 왜, 어떻게 검증했는지, 실행 명령과 결과를 한국어로 누적 기록한다.
|
||||
- 변경 후: 여러 task/phase에 걸친 회귀 검증, 전체 빌드/포맷 검증, 문서 변경 범위 확인처럼 전체에 해당하는 검증은 계획 문서 하단의 검증 기록에 누적한다.
|
||||
|
||||
@@ -50,10 +50,9 @@
|
||||
- 계약: 제공되지 않은 endpoint, DTO, enum, 오류 status/key와 validation 상한을 추정하지 않는다.
|
||||
- backend 구현 전 UI 확인이 필요하면 제공 계약 기반 explicit mock mode를 사용하고 실제 404 자동 fallback·production mock을 금지하며 mock/server 완료 증거를 분리한다.
|
||||
- 구현: 모든 구현 Task는 아래 `RED → GREEN → REFACTOR` 순서를 체크박스에 명시하고, 가장 작은 실패 test에서 시작해 최소 구현으로 통과시킨다.
|
||||
- 검증: focused test에서 시작해 영향받는 package/feature 회귀로 확장한다. 전체 회귀는 공통 경계 변경, 여러 domain/phase 변경,
|
||||
release/final Gate에서 전체 상태 증거를 별도로 요구하는 경우, targeted test만으로 영향 범위를 판단할 수 없는 실패 또는 사용자
|
||||
명시 요청이 있을 때만 실행한다.
|
||||
- 전체 회귀를 생략하면 생략 사실·근거와 대신 실행한 focused/영향 범위 회귀 명령을 Progress에 기록한다.
|
||||
- 검증: 에이전트는 구현 기능의 focused test와 직접 영향받는 package/feature 회귀만 `--tests`로 지정해 각각 실행한다. 공통 경계·여러 domain/phase 변경과 release/final Gate도 전체 테스트 자동 실행 사유가 아니다.
|
||||
- 전체 테스트는 사용자가 직접 실행한다. 에이전트는 무필터 `test` 및 전체 테스트를 포함하는 `check`/`build`/`clean build`를 실행하지 않으며, 필요한 빌드 검증은 `bootJar`로 분리한다.
|
||||
- Progress와 최종 보고에 실행한 기능별 명령·결과, 전체 테스트 미실행 및 미검증 범위, 사용자 실행 명령 `./gradlew test`를 기록한다. 전체 테스트 사용자 실행 대기는 기능 범위 완료와 별도 상태로 관리한다.
|
||||
|
||||
## Task TDD 작성 규칙
|
||||
|
||||
|
||||
@@ -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.common.SodaException
|
||||
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 org.springframework.beans.factory.annotation.Value
|
||||
import org.springframework.context.ApplicationEventPublisher
|
||||
import org.springframework.data.domain.Pageable
|
||||
import org.springframework.data.repository.findByIdOrNull
|
||||
import org.springframework.stereotype.Service
|
||||
@@ -26,6 +29,7 @@ class AdminContentService(
|
||||
private val contentMainTabRepository: AdminContentMainTabRepository,
|
||||
private val objectMapper: ObjectMapper,
|
||||
private val s3Uploader: S3Uploader,
|
||||
private val applicationEventPublisher: ApplicationEventPublisher,
|
||||
@Value("\${cloud.aws.s3.bucket}")
|
||||
private val bucket: String
|
||||
) {
|
||||
@@ -158,6 +162,16 @@ class AdminContentService(
|
||||
}
|
||||
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> {
|
||||
|
||||
+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
|
||||
}
|
||||
|
||||
@@ -179,7 +179,7 @@ class AdminEventBannerService(
|
||||
event.isPopup = isPopup
|
||||
}
|
||||
|
||||
if (isAdult != event.isAdult) {
|
||||
if (isAdult != null && isAdult != event.isAdult) {
|
||||
event.isAdult = isAdult
|
||||
}
|
||||
|
||||
|
||||
+5
@@ -186,6 +186,11 @@ class ChatCharacterController(
|
||||
|
||||
var translated: TranslatedAiCharacterDetail? = null
|
||||
if (langContext.lang.code != character.languageCode) {
|
||||
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||
LanguageTranslationTargetType.CHARACTER,
|
||||
listOf(characterId),
|
||||
langContext.lang.code
|
||||
)
|
||||
val existing = aiCharacterTranslationRepository
|
||||
.findByCharacterIdAndLocale(character.id!!, langContext.lang.code)
|
||||
|
||||
|
||||
+9
-2
@@ -28,8 +28,15 @@ class OriginalWorkTranslationService(
|
||||
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
|
||||
if (existedPayload != null) {
|
||||
val t = existedPayload.title.trim()
|
||||
@@ -51,7 +58,7 @@ class OriginalWorkTranslationService(
|
||||
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
||||
resourceType = LanguageTranslationTargetType.ORIGINAL_WORK,
|
||||
resourceId = originalWork.id!!,
|
||||
resourceId = originalWorkId,
|
||||
targetLanguage = target
|
||||
)
|
||||
return null
|
||||
|
||||
@@ -157,6 +157,13 @@ class SecurityConfig(
|
||||
JwtFilter::class.java
|
||||
)
|
||||
.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()
|
||||
.requestMatchers(EndpointRequest.toAnyEndpoint()).permitAll()
|
||||
.antMatchers("/member/check/email").permitAll()
|
||||
|
||||
@@ -52,6 +52,9 @@ data class AudioContent(
|
||||
var content: String? = null
|
||||
var coverImage: String? = null
|
||||
|
||||
@Column(length = 36)
|
||||
var latestSubtitleJobId: String? = null
|
||||
|
||||
@OneToOne(fetch = FetchType.EAGER)
|
||||
@JoinColumn(name = "theme_id", nullable = false)
|
||||
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.translation.ContentThemeTranslationRepository
|
||||
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.extensions.convertLocalDateTime
|
||||
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.translation.LanguageTranslationEvent
|
||||
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.MemberRepository
|
||||
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.home.following.application.HomeFollowingNewsPublishService
|
||||
import kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryService
|
||||
import kr.co.vividnext.sodalive.v2.subtitle.application.SubtitleJobService
|
||||
import org.slf4j.LoggerFactory
|
||||
import org.springframework.beans.factory.annotation.Value
|
||||
import org.springframework.cache.annotation.Cacheable
|
||||
import org.springframework.context.ApplicationEventPublisher
|
||||
import org.springframework.data.repository.findByIdOrNull
|
||||
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.TransactionSynchronization
|
||||
import org.springframework.transaction.support.TransactionSynchronizationManager
|
||||
import org.springframework.transaction.support.TransactionTemplate
|
||||
import org.springframework.web.multipart.MultipartFile
|
||||
import java.text.SimpleDateFormat
|
||||
import java.time.LocalDateTime
|
||||
@@ -78,8 +81,8 @@ class AudioContentService(
|
||||
private val pinContentRepository: PinContentRepository,
|
||||
private val memberRepository: MemberRepository,
|
||||
|
||||
private val resourceTranslationJobScheduler: ResourceTranslationJobScheduler,
|
||||
private val contentTranslationRepository: ContentTranslationRepository,
|
||||
private val detailTranslationService: AudioContentDetailTranslationService,
|
||||
|
||||
private val s3Uploader: S3Uploader,
|
||||
private val objectMapper: ObjectMapper,
|
||||
@@ -93,6 +96,8 @@ class AudioContentService(
|
||||
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
||||
private val homeFollowingNewsPublishService: HomeFollowingNewsPublishService,
|
||||
private val memberContentPreferenceService: MemberContentPreferenceService,
|
||||
private val subtitleJobService: SubtitleJobService,
|
||||
transactionManager: PlatformTransactionManager,
|
||||
|
||||
@Value("\${cloud.aws.s3.content-bucket}")
|
||||
private val audioContentBucket: String,
|
||||
@@ -104,6 +109,9 @@ class AudioContentService(
|
||||
private val coverImageHost: String
|
||||
) {
|
||||
private val log = LoggerFactory.getLogger(javaClass)
|
||||
private val registrationTransaction = TransactionTemplate(transactionManager).apply {
|
||||
propagationBehavior = TransactionDefinition.PROPAGATION_REQUIRES_NEW
|
||||
}
|
||||
|
||||
@Transactional
|
||||
fun audioContentLike(request: PutAudioContentLikeRequest, member: Member): PutAudioContentLikeResponse {
|
||||
@@ -220,7 +228,7 @@ class AudioContentService(
|
||||
pinContent?.isActive = false
|
||||
}
|
||||
|
||||
@Transactional
|
||||
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||
fun createAudioContent(
|
||||
contentFile: MultipartFile?,
|
||||
coverImage: MultipartFile?,
|
||||
@@ -245,7 +253,7 @@ class AudioContentService(
|
||||
return createAudioContent(contentFile, coverImage, request, releaseDate, member)
|
||||
}
|
||||
|
||||
@Transactional
|
||||
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||
fun createAudioContent(
|
||||
contentFile: MultipartFile?,
|
||||
coverImage: MultipartFile?,
|
||||
@@ -260,115 +268,118 @@ class AudioContentService(
|
||||
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)
|
||||
?: throw SodaException(messageKey = "content.error.invalid_theme")
|
||||
// 테마 체크
|
||||
val theme = themeQueryRepository.findThemeByIdAndActive(id = request.themeId)
|
||||
?: throw SodaException(messageKey = "content.error.invalid_theme")
|
||||
|
||||
if ((request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) && request.price < 5) {
|
||||
throw SodaException(messageKey = "content.error.alarm_theme_price_min")
|
||||
}
|
||||
if ((request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) && request.price < 5) {
|
||||
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) {
|
||||
request.isFullDetailVisible
|
||||
} else {
|
||||
true
|
||||
}
|
||||
val isFullDetailVisible = if (request.price >= 50) {
|
||||
request.isFullDetailVisible
|
||||
} else {
|
||||
true
|
||||
}
|
||||
|
||||
val purchaseOption = if (request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) {
|
||||
PurchaseOption.BUY_ONLY
|
||||
} else {
|
||||
request.purchaseOption
|
||||
}
|
||||
val purchaseOption = if (request.themeId == 12L || request.themeId == 13L || request.themeId == 14L) {
|
||||
PurchaseOption.BUY_ONLY
|
||||
} else {
|
||||
request.purchaseOption
|
||||
}
|
||||
|
||||
val isOnlyRental = if (
|
||||
(request.limited != null && request.limited > 0) ||
|
||||
purchaseOption == PurchaseOption.BUY_ONLY
|
||||
) {
|
||||
false
|
||||
} else if (request.purchaseOption == PurchaseOption.RENT_ONLY) {
|
||||
true
|
||||
} else {
|
||||
request.isOnlyRental
|
||||
}
|
||||
val isOnlyRental = if (
|
||||
(request.limited != null && request.limited > 0) ||
|
||||
purchaseOption == PurchaseOption.BUY_ONLY
|
||||
) {
|
||||
false
|
||||
} else if (request.purchaseOption == PurchaseOption.RENT_ONLY) {
|
||||
true
|
||||
} else {
|
||||
request.isOnlyRental
|
||||
}
|
||||
|
||||
// DB에 값 추가
|
||||
val audioContent = AudioContent(
|
||||
title = request.title.trim(),
|
||||
detail = request.detail.trim(),
|
||||
languageCode = request.languageCode,
|
||||
price = if (request.price > 0) {
|
||||
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"
|
||||
// DB에 값 추가
|
||||
val audioContent = AudioContent(
|
||||
title = request.title.trim(),
|
||||
detail = request.detail.trim(),
|
||||
languageCode = request.languageCode,
|
||||
price = if (request.price > 0) {
|
||||
request.price
|
||||
} 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()
|
||||
audioContentHashTag.audioContent = audioContent
|
||||
audioContentHashTag.hashTag = hashTag
|
||||
val hashTag = hashTagRepository.findByTag(tag)
|
||||
?: hashTagRepository.save(HashTag(tag))
|
||||
|
||||
audioContentHashTag
|
||||
}.toList()
|
||||
val audioContentHashTag = AudioContentHashTag()
|
||||
audioContentHashTag.audioContent = audioContent
|
||||
audioContentHashTag.hashTag = hashTag
|
||||
|
||||
audioContent.audioContentHashTags.addAll(tags)
|
||||
}
|
||||
audioContentHashTag
|
||||
}.toList()
|
||||
|
||||
var metadata = ObjectMetadata()
|
||||
metadata.contentLength = coverImage.size
|
||||
audioContent.audioContentHashTags.addAll(tags)
|
||||
}
|
||||
|
||||
// 커버 이미지 파일명 생성
|
||||
val coverImageFileName = generateFileName(prefix = "${audioContent.id}-cover")
|
||||
val metadata = ObjectMetadata()
|
||||
metadata.contentLength = coverImage.size
|
||||
|
||||
// 커버 이미지 업로드
|
||||
val coverImagePath = s3Uploader.upload(
|
||||
inputStream = coverImage.inputStream,
|
||||
bucket = coverImageBucket,
|
||||
filePath = "audio_content_cover/${audioContent.id}/$coverImageFileName",
|
||||
metadata = metadata
|
||||
// 커버 이미지 파일명 생성
|
||||
val coverImageFileName = generateFileName(prefix = "${audioContent.id}-cover")
|
||||
|
||||
// 커버 이미지 업로드
|
||||
val coverImagePath = s3Uploader.upload(
|
||||
inputStream = coverImage.inputStream,
|
||||
bucket = coverImageBucket,
|
||||
filePath = "audio_content_cover/${audioContent.id}/$coverImageFileName",
|
||||
metadata = metadata
|
||||
)
|
||||
|
||||
audioContent.coverImage = coverImagePath
|
||||
audioContent to subtitleJobService.register(audioContent, contentFile.originalFilename)
|
||||
}
|
||||
)
|
||||
|
||||
audioContent.coverImage = coverImagePath
|
||||
|
||||
// 콘텐츠 파일명 생성
|
||||
val contentFileName = generateFileName(prefix = "${audioContent.id}-content")
|
||||
val (audioContent, subtitleJob) = registration
|
||||
|
||||
// 콘텐츠 파일 업로드
|
||||
metadata = ObjectMetadata()
|
||||
val metadata = ObjectMetadata()
|
||||
metadata.contentLength = contentFile.size
|
||||
metadata.addUserMetadata(
|
||||
"generate_preview",
|
||||
@@ -384,38 +395,45 @@ class AudioContentService(
|
||||
metadata.addUserMetadata("preview_end_time", request.previewEndTime)
|
||||
}
|
||||
|
||||
val contentPath = s3Uploader.upload(
|
||||
inputStream = contentFile.inputStream,
|
||||
bucket = audioContentBucket,
|
||||
filePath = "input/${audioContent.id}/$contentFileName",
|
||||
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
|
||||
try {
|
||||
contentFile.inputStream.use { inputStream ->
|
||||
s3Uploader.upload(
|
||||
inputStream = inputStream,
|
||||
bucket = audioContentBucket,
|
||||
filePath = subtitleJob.sourceKey,
|
||||
metadata = metadata
|
||||
)
|
||||
)
|
||||
} else {
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageTranslationEvent(
|
||||
id = audioContent.id!!,
|
||||
targetType = LanguageTranslationTargetType.CONTENT
|
||||
}
|
||||
} catch (exception: Exception) {
|
||||
subtitleJobService.recordUploadError(subtitleJob.jobId)
|
||||
throw exception
|
||||
}
|
||||
|
||||
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!!)
|
||||
@@ -481,8 +499,9 @@ class AudioContentService(
|
||||
|
||||
@Transactional
|
||||
fun uploadComplete(contentId: Long, content: String, duration: String) {
|
||||
val keyFileName = content.split("/").last()
|
||||
if (!keyFileName.startsWith(contentId.toString())) throw SodaException(messageKey = "common.error.invalid_request")
|
||||
val registeredOutputMatches = subtitleJobService.matchesOutput(contentId, content)
|
||||
val validOutput = registeredOutputMatches ?: content.substringAfterLast("/").startsWith(contentId.toString())
|
||||
if (!validOutput) throw SodaException(messageKey = "common.error.invalid_request")
|
||||
|
||||
val audioContent = repository.findByIdOrNull(contentId)
|
||||
?: throw SodaException(messageKey = "common.error.invalid_request")
|
||||
@@ -781,6 +800,24 @@ class AudioContentService(
|
||||
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 isLike = audioContentLikeRepository.findByMemberIdAndContentId(
|
||||
memberId = member.id!!,
|
||||
@@ -854,44 +891,14 @@ class AudioContentService(
|
||||
listOf()
|
||||
}
|
||||
|
||||
var translated: TranslatedContent? = null
|
||||
|
||||
/**
|
||||
* audioContent.languageCode != languageCode
|
||||
*
|
||||
* 번역 콘텐츠를 조회한다. - contentId, locale
|
||||
* 번역 콘텐츠가 있으면
|
||||
* 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
|
||||
val translation = detailTranslationService.resolve(id, langContext.lang.code)
|
||||
if (translation.detectionQuery != null) {
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageDetectEvent(
|
||||
id = id,
|
||||
query = translation.detectionQuery
|
||||
)
|
||||
} else {
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
||||
resourceType = LanguageTranslationTargetType.CONTENT,
|
||||
resourceId = audioContent.id!!,
|
||||
targetLanguage = langContext.lang.code
|
||||
)
|
||||
}
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -933,7 +940,7 @@ class AudioContentService(
|
||||
contentId = audioContent.id!!,
|
||||
title = audioContent.title,
|
||||
detail = contentDetail,
|
||||
languageCode = audioContent.languageCode,
|
||||
languageCode = translation.languageCode,
|
||||
coverImageUrl = "$coverImageHost/${audioContent.coverImage!!}",
|
||||
contentUrl = audioContentUrl,
|
||||
themeStr = themeStrTranslated,
|
||||
@@ -953,8 +960,8 @@ class AudioContentService(
|
||||
purchaseOption = purchaseOption,
|
||||
orderType = orderType,
|
||||
remainingTime = remainingTime,
|
||||
creatorOtherContentList = creatorOtherContentList,
|
||||
sameThemeOtherContentList = sameThemeOtherContentList,
|
||||
creatorOtherContentList = creatorOtherContentList.map(::translateRelatedContent),
|
||||
sameThemeOtherContentList = sameThemeOtherContentList.map(::translateRelatedContent),
|
||||
isCommentAvailable = audioContent.isCommentAvailable,
|
||||
isLike = isLike,
|
||||
likeCount = likeCount,
|
||||
@@ -974,11 +981,23 @@ class AudioContentService(
|
||||
isFollow = creatorFollowing?.isFollow ?: false,
|
||||
isNotify = creatorFollowing?.isNotify ?: false
|
||||
),
|
||||
previousContent = previousContent,
|
||||
nextContent = nextContent,
|
||||
previousContent = previousContent?.let(::translateRelatedContent),
|
||||
nextContent = nextContent?.let(::translateRelatedContent),
|
||||
buyerList = buyerList,
|
||||
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!!
|
||||
)
|
||||
|
||||
val contentUrl = if (isExistsAudioContent) {
|
||||
audioContentCloudFront.generateSignedURL(
|
||||
resourcePath = audioContent.content!!,
|
||||
expirationTime = 1000 * 60 * 60 * (audioContent.duration!!.split(":")[0].toLong() + 2)
|
||||
return if (isExistsAudioContent) {
|
||||
val expirationTime = 1000 * 60 * 60 * (audioContent.duration!!.split(":")[0].toLong() + 2)
|
||||
GenerateUrlResponse(
|
||||
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 {
|
||||
""
|
||||
GenerateUrlResponse("")
|
||||
}
|
||||
|
||||
return GenerateUrlResponse(contentUrl)
|
||||
}
|
||||
|
||||
@Transactional(readOnly = true)
|
||||
|
||||
@@ -1,5 +1,8 @@
|
||||
package kr.co.vividnext.sodalive.content
|
||||
|
||||
import kr.co.vividnext.sodalive.v2.subtitle.dto.ContentSubtitleResponse
|
||||
|
||||
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.order.OrderType
|
||||
import kr.co.vividnext.sodalive.content.translation.TranslatedContent
|
||||
import kr.co.vividnext.sodalive.v2.subtitle.dto.ContentSubtitleResponse
|
||||
|
||||
data class GetAudioContentDetailResponse(
|
||||
val contentId: Long,
|
||||
@@ -42,7 +43,8 @@ data class GetAudioContentDetailResponse(
|
||||
val nextContent: OtherContentResponse?,
|
||||
val buyerList: List<ContentBuyer>,
|
||||
val isAvailableUsePoint: Boolean,
|
||||
val translated: TranslatedContent?
|
||||
val translated: TranslatedContent?,
|
||||
val subtitle: ContentSubtitleResponse? = null
|
||||
)
|
||||
|
||||
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.explorer.profile.CreatorCheersRepository
|
||||
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.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 org.slf4j.LoggerFactory
|
||||
import org.springframework.beans.factory.annotation.Value
|
||||
import org.springframework.context.ApplicationEventPublisher
|
||||
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.stereotype.Component
|
||||
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.support.TransactionSynchronization
|
||||
import org.springframework.transaction.support.TransactionSynchronizationManager
|
||||
import org.springframework.util.LinkedMultiValueMap
|
||||
import org.springframework.web.client.RestTemplate
|
||||
import javax.persistence.EntityManager
|
||||
import javax.persistence.LockModeType
|
||||
|
||||
/**
|
||||
* 텍스트 기반 데이터(콘텐츠, 댓글 등)에 대해 파파고 언어 감지를 요청하기 위한 이벤트.
|
||||
* 텍스트 기반 데이터(콘텐츠, 댓글 등)에 대해 언어 감지를 요청하기 위한 이벤트.
|
||||
*/
|
||||
enum class LanguageDetectTargetType {
|
||||
CONTENT,
|
||||
@@ -56,10 +49,6 @@ class LanguageDetectEvent(
|
||||
val targetLanguage: String? = null
|
||||
)
|
||||
|
||||
data class PapagoLanguageDetectResponse(
|
||||
val langCode: String?
|
||||
)
|
||||
|
||||
@Component
|
||||
class LanguageDetectListener(
|
||||
private val audioContentRepository: AudioContentRepository,
|
||||
@@ -74,28 +63,17 @@ class LanguageDetectListener(
|
||||
private val languageDetectionCacheService: LanguageDetectionCacheService,
|
||||
private val creatorCommunityTranslationService: CreatorCommunityTranslationService,
|
||||
private val entityManager: EntityManager,
|
||||
|
||||
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 resourceTranslationJobScheduler: ResourceTranslationJobScheduler
|
||||
) {
|
||||
|
||||
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
|
||||
@TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
|
||||
@Transactional(propagation = Propagation.REQUIRES_NEW)
|
||||
fun detectLanguage(event: LanguageDetectEvent) {
|
||||
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
|
||||
}
|
||||
|
||||
@@ -117,34 +95,32 @@ class LanguageDetectListener(
|
||||
|
||||
val character = chatCharacterRepository.findById(characterId).orElse(null)
|
||||
if (character == null) {
|
||||
log.warn("[PapagoLanguageDetect] ChatCharacter not found. characterId={}", characterId)
|
||||
log.warn("[LanguageDetect] ChatCharacter not found. characterId={}", characterId)
|
||||
return
|
||||
}
|
||||
|
||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||
if (!character.languageCode.isNullOrBlank()) {
|
||||
log.debug(
|
||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. characterId={}, languageCode={}",
|
||||
"[LanguageDetect] languageCode already set. Skip language detection. characterId={}, languageCode={}",
|
||||
characterId,
|
||||
character.languageCode
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
val langCode = detectLanguageCode(event, characterId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
character.languageCode = langCode
|
||||
chatCharacterRepository.save(character)
|
||||
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageTranslationEvent(
|
||||
id = characterId,
|
||||
targetType = LanguageTranslationTargetType.CHARACTER
|
||||
)
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||
resourceType = LanguageTranslationTargetType.CHARACTER,
|
||||
resourceId = characterId
|
||||
)
|
||||
|
||||
log.info(
|
||||
"[PapagoLanguageDetect] languageCode updated from Papago. characterId={}, langCode={}",
|
||||
"[LanguageDetect] languageCode updated. characterId={}, langCode={}",
|
||||
characterId,
|
||||
langCode
|
||||
)
|
||||
@@ -155,36 +131,34 @@ class LanguageDetectListener(
|
||||
|
||||
val audioContent = audioContentRepository.findById(contentId).orElse(null)
|
||||
if (audioContent == null) {
|
||||
log.warn("[PapagoLanguageDetect] AudioContent not found. contentId={}", contentId)
|
||||
log.warn("[LanguageDetect] AudioContent not found. contentId={}", contentId)
|
||||
return
|
||||
}
|
||||
|
||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||
if (!audioContent.languageCode.isNullOrBlank()) {
|
||||
log.debug(
|
||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. contentId={}, languageCode={}",
|
||||
"[LanguageDetect] languageCode already set. Skip language detection. contentId={}, languageCode={}",
|
||||
contentId,
|
||||
audioContent.languageCode
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
val langCode = detectLanguageCode(event, contentId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
audioContent.languageCode = langCode
|
||||
|
||||
// REQUIRES_NEW 트랜잭션 내에서 변경 내용을 저장한다.
|
||||
audioContentRepository.save(audioContent)
|
||||
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageTranslationEvent(
|
||||
id = contentId,
|
||||
targetType = LanguageTranslationTargetType.CONTENT
|
||||
)
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||
resourceType = LanguageTranslationTargetType.CONTENT,
|
||||
resourceId = contentId
|
||||
)
|
||||
|
||||
log.info(
|
||||
"[PapagoLanguageDetect] languageCode updated from Papago. contentId={}, langCode={}",
|
||||
"[LanguageDetect] languageCode updated. contentId={}, langCode={}",
|
||||
contentId,
|
||||
langCode
|
||||
)
|
||||
@@ -195,27 +169,27 @@ class LanguageDetectListener(
|
||||
|
||||
val comment = audioContentCommentRepository.findById(commentId).orElse(null)
|
||||
if (comment == null) {
|
||||
log.warn("[PapagoLanguageDetect] AudioContentComment not found. commentId={}", commentId)
|
||||
log.warn("[LanguageDetect] AudioContentComment not found. commentId={}", commentId)
|
||||
return
|
||||
}
|
||||
|
||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||
if (!comment.languageCode.isNullOrBlank()) {
|
||||
log.debug(
|
||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. commentId={}, languageCode={}",
|
||||
"[LanguageDetect] languageCode already set. Skip language detection. commentId={}, languageCode={}",
|
||||
commentId,
|
||||
comment.languageCode
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
val langCode = detectLanguageCode(event, commentId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
comment.languageCode = langCode
|
||||
audioContentCommentRepository.save(comment)
|
||||
|
||||
log.info(
|
||||
"[PapagoLanguageDetect] languageCode updated from Papago. commentId={}, langCode={}",
|
||||
"[LanguageDetect] languageCode updated. commentId={}, langCode={}",
|
||||
commentId,
|
||||
langCode
|
||||
)
|
||||
@@ -226,14 +200,14 @@ class LanguageDetectListener(
|
||||
|
||||
val comment = characterCommentRepository.findById(commentId).orElse(null)
|
||||
if (comment == null) {
|
||||
log.warn("[PapagoLanguageDetect] CharacterComment not found. commentId={}", commentId)
|
||||
log.warn("[LanguageDetect] CharacterComment not found. commentId={}", commentId)
|
||||
return
|
||||
}
|
||||
|
||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||
if (!comment.languageCode.isNullOrBlank()) {
|
||||
log.debug(
|
||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. " +
|
||||
"[LanguageDetect] languageCode already set. Skip language detection. " +
|
||||
"characterCommentId={}, languageCode={}",
|
||||
commentId,
|
||||
comment.languageCode
|
||||
@@ -241,13 +215,13 @@ class LanguageDetectListener(
|
||||
return
|
||||
}
|
||||
|
||||
val langCode = detectLanguageCode(event, commentId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
comment.languageCode = langCode
|
||||
characterCommentRepository.save(comment)
|
||||
|
||||
log.info(
|
||||
"[PapagoLanguageDetect] languageCode updated from Papago. characterCommentId={}, langCode={}",
|
||||
"[LanguageDetect] languageCode updated. characterCommentId={}, langCode={}",
|
||||
commentId,
|
||||
langCode
|
||||
)
|
||||
@@ -258,27 +232,27 @@ class LanguageDetectListener(
|
||||
|
||||
val cheers = creatorCheersRepository.findById(cheersId).orElse(null)
|
||||
if (cheers == null) {
|
||||
log.warn("[PapagoLanguageDetect] CreatorCheers not found. cheersId={}", cheersId)
|
||||
log.warn("[LanguageDetect] CreatorCheers not found. cheersId={}", cheersId)
|
||||
return
|
||||
}
|
||||
|
||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||
if (!cheers.languageCode.isNullOrBlank()) {
|
||||
log.debug(
|
||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. cheersId={}, languageCode={}",
|
||||
"[LanguageDetect] languageCode already set. Skip language detection. cheersId={}, languageCode={}",
|
||||
cheersId,
|
||||
cheers.languageCode
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
val langCode = detectLanguageCode(event, cheersId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
cheers.languageCode = langCode
|
||||
creatorCheersRepository.save(cheers)
|
||||
|
||||
log.info(
|
||||
"[PapagoLanguageDetect] languageCode updated from Papago. cheersId={}, langCode={}",
|
||||
"[LanguageDetect] languageCode updated. cheersId={}, langCode={}",
|
||||
cheersId,
|
||||
langCode
|
||||
)
|
||||
@@ -289,34 +263,32 @@ class LanguageDetectListener(
|
||||
|
||||
val series = seriesRepository.findByIdOrNull(seriesId)
|
||||
if (series == null) {
|
||||
log.warn("[PapagoLanguageDetect] Series not found. seriesId={}", seriesId)
|
||||
log.warn("[LanguageDetect] Series not found. seriesId={}", seriesId)
|
||||
return
|
||||
}
|
||||
|
||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||
if (!series.languageCode.isNullOrBlank()) {
|
||||
log.debug(
|
||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. seriesId={}, languageCode={}",
|
||||
"[LanguageDetect] languageCode already set. Skip language detection. seriesId={}, languageCode={}",
|
||||
seriesId,
|
||||
series.languageCode
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
val langCode = detectLanguageCode(event, seriesId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
series.languageCode = langCode
|
||||
seriesRepository.save(series)
|
||||
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageTranslationEvent(
|
||||
id = seriesId,
|
||||
targetType = LanguageTranslationTargetType.SERIES
|
||||
)
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||
resourceType = LanguageTranslationTargetType.SERIES,
|
||||
resourceId = seriesId
|
||||
)
|
||||
|
||||
log.info(
|
||||
"[PapagoLanguageDetect] languageCode updated from Papago. seriesId={}, langCode={}",
|
||||
"[LanguageDetect] languageCode updated. seriesId={}, langCode={}",
|
||||
seriesId,
|
||||
langCode
|
||||
)
|
||||
@@ -327,35 +299,32 @@ class LanguageDetectListener(
|
||||
|
||||
val originalWork = originalWorkRepository.findByIdOrNull(originalWorkId)
|
||||
if (originalWork == null) {
|
||||
log.warn("[PapagoLanguageDetect] OriginalWork not found. originalWorkId={}", originalWorkId)
|
||||
log.warn("[LanguageDetect] OriginalWork not found. originalWorkId={}", originalWorkId)
|
||||
return
|
||||
}
|
||||
|
||||
// 이미 언어 코드가 설정된 경우 호출하지 않음
|
||||
if (!originalWork.languageCode.isNullOrBlank()) {
|
||||
log.debug(
|
||||
"[PapagoLanguageDetect] languageCode already set. Skip language detection. originalWorkId={}, languageCode={}",
|
||||
"[LanguageDetect] languageCode already set. Skip language detection. originalWorkId={}, languageCode={}",
|
||||
originalWorkId,
|
||||
originalWork.languageCode
|
||||
)
|
||||
return
|
||||
}
|
||||
|
||||
val langCode = detectLanguageCode(event, originalWorkId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
originalWork.languageCode = langCode
|
||||
originalWorkRepository.save(originalWork)
|
||||
|
||||
// 언어 감지가 완료된 후 언어 번역 이벤트 호출
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageTranslationEvent(
|
||||
id = originalWorkId,
|
||||
targetType = LanguageTranslationTargetType.ORIGINAL_WORK
|
||||
)
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||
resourceType = LanguageTranslationTargetType.ORIGINAL_WORK,
|
||||
resourceId = originalWorkId
|
||||
)
|
||||
|
||||
log.info(
|
||||
"[PapagoLanguageDetect] languageCode updated from Papago. originalWorkId={}, langCode={}",
|
||||
"[LanguageDetect] languageCode updated. originalWorkId={}, langCode={}",
|
||||
originalWorkId,
|
||||
langCode
|
||||
)
|
||||
@@ -367,16 +336,14 @@ class LanguageDetectListener(
|
||||
val category = categoryRepository.findByIdOrNull(categoryId) ?: return
|
||||
if (!category.languageCode.isNullOrBlank()) return
|
||||
|
||||
val langCode = detectLanguageCode(event, categoryId) ?: return
|
||||
val langCode = detectLanguageCode(event) ?: return
|
||||
|
||||
category.languageCode = langCode
|
||||
categoryRepository.save(category)
|
||||
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageTranslationEvent(
|
||||
id = categoryId,
|
||||
targetType = LanguageTranslationTargetType.CREATOR_CONTENT_CATEGORY
|
||||
)
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslations(
|
||||
resourceType = LanguageTranslationTargetType.CREATOR_CONTENT_CATEGORY,
|
||||
resourceId = categoryId
|
||||
)
|
||||
}
|
||||
|
||||
@@ -395,7 +362,7 @@ class LanguageDetectListener(
|
||||
return
|
||||
}
|
||||
|
||||
val languageCode = detectLanguageCode(event, event.id) ?: return
|
||||
val languageCode = detectLanguageCode(event) ?: return
|
||||
if (languageCode !in getTranslatableLanguageCodes(null)) return
|
||||
|
||||
val currentCreatorCommunity = creatorCommunityRepository.findByIdAndIsActiveTrueForUpdate(event.id) ?: return
|
||||
@@ -427,60 +394,7 @@ class LanguageDetectListener(
|
||||
)
|
||||
}
|
||||
|
||||
private fun detectLanguageCode(event: LanguageDetectEvent, targetIdForLog: Long): String? {
|
||||
return languageDetectionCacheService.detectWithCache(event.query) {
|
||||
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
|
||||
}
|
||||
private fun detectLanguageCode(event: LanguageDetectEvent): String? {
|
||||
return languageDetectionCacheService.detectWithCache(event.query)?.detectedLanguage
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,50 +1,64 @@
|
||||
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 org.springframework.stereotype.Service
|
||||
import org.springframework.transaction.annotation.Transactional
|
||||
|
||||
@Service
|
||||
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
|
||||
fun detectWithCache(
|
||||
query: String,
|
||||
provider: String = DEFAULT_PROVIDER,
|
||||
detector: () -> String?
|
||||
): String? {
|
||||
fun detectWithCache(query: String): DetectedLanguage? {
|
||||
val normalizedQuery = SourceTextNormalizer.normalize(query)
|
||||
if (normalizedQuery.isBlank()) return null
|
||||
|
||||
val sourceHash = SourceTextNormalizer.hash(normalizedQuery)
|
||||
val cached = languageDetectionResultRepository.findBySourceHashAndProviderAndNormalizationVersion(
|
||||
sourceHash = sourceHash,
|
||||
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(
|
||||
providers.forEach { provider ->
|
||||
val cached = languageDetectionResultRepository.findBySourceHashAndProviderAndNormalizationVersion(
|
||||
sourceHash = sourceHash,
|
||||
provider = provider,
|
||||
provider = provider.providerId.code,
|
||||
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 {
|
||||
const val DEFAULT_PROVIDER = "papago"
|
||||
private const val MAX_SAMPLE_LENGTH = 500
|
||||
}
|
||||
}
|
||||
|
||||
@@ -141,6 +141,11 @@ class CategoryService(
|
||||
val categoryIds = baseList.map { it.categoryId }
|
||||
val entities = repository.findAllById(categoryIds)
|
||||
val entityMap = entities.associateBy { it.id!! }
|
||||
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||
LanguageTranslationTargetType.CREATOR_CONTENT_CATEGORY,
|
||||
categoryIds,
|
||||
locale
|
||||
)
|
||||
|
||||
// 요청 로케일로 이미 저장된 번역 일괄 조회
|
||||
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.content.ContentType
|
||||
import kr.co.vividnext.sodalive.content.LanguageDetectEvent
|
||||
import kr.co.vividnext.sodalive.content.LanguageDetectTargetType
|
||||
import kr.co.vividnext.sodalive.content.order.OrderRepository
|
||||
import kr.co.vividnext.sodalive.content.order.OrderType
|
||||
import kr.co.vividnext.sodalive.content.series.content.ContentSeriesContentRepository
|
||||
import kr.co.vividnext.sodalive.content.series.content.GetSeriesContentListResponse
|
||||
import kr.co.vividnext.sodalive.content.series.translation.SeriesGenreTranslationRepository
|
||||
import kr.co.vividnext.sodalive.content.series.translation.SeriesTranslationRepository
|
||||
import kr.co.vividnext.sodalive.content.series.translation.TranslatedSeries
|
||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
||||
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesPublishedDaysOfWeek
|
||||
import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesSortType
|
||||
@@ -21,6 +21,7 @@ import kr.co.vividnext.sodalive.member.Member
|
||||
import kr.co.vividnext.sodalive.member.block.BlockMemberRepository
|
||||
import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
|
||||
import org.springframework.beans.factory.annotation.Value
|
||||
import org.springframework.context.ApplicationEventPublisher
|
||||
import org.springframework.stereotype.Service
|
||||
import org.springframework.transaction.annotation.Transactional
|
||||
import java.time.ZoneId
|
||||
@@ -36,7 +37,8 @@ class ContentSeriesService(
|
||||
|
||||
private val langContext: LangContext,
|
||||
|
||||
private val seriesTranslationRepository: SeriesTranslationRepository,
|
||||
private val detailTranslationService: ContentSeriesDetailTranslationService,
|
||||
private val applicationEventPublisher: ApplicationEventPublisher,
|
||||
private val seriesGenreTranslationRepository: SeriesGenreTranslationRepository,
|
||||
private val contentTranslationRepository: ContentTranslationRepository,
|
||||
private val resourceTranslationJobScheduler: ResourceTranslationJobScheduler,
|
||||
@@ -98,6 +100,11 @@ class ContentSeriesService(
|
||||
if (currentLang == Lang.EN || currentLang == Lang.JA) {
|
||||
val targetLocale = currentLang.code
|
||||
val ids = genres.map { it.id }
|
||||
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||
LanguageTranslationTargetType.SERIES_GENRE,
|
||||
ids,
|
||||
targetLocale
|
||||
)
|
||||
|
||||
// 기존 번역 일괄 조회
|
||||
val existing = if (ids.isNotEmpty()) {
|
||||
@@ -254,47 +261,16 @@ class ContentSeriesService(
|
||||
limit = 5
|
||||
)
|
||||
|
||||
/**
|
||||
* series.languageCode != null && series.languageCode != languageCode
|
||||
*
|
||||
* 번역 시리즈를 조회한다. - series, locale
|
||||
* 번역 콘텐츠가 있으면
|
||||
* TranslatedSeries로 가공한다
|
||||
*
|
||||
* 번역 콘텐츠가 없으면
|
||||
* 누락 번역 job을 예약하고 원문 응답을 유지한다.
|
||||
*
|
||||
* 번역 대상: title, introduction, keywordList
|
||||
*
|
||||
* 파파고로 번역한 데이터를 TranslatedSeries 가공한다
|
||||
*/
|
||||
|
||||
val dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy.MM.dd")
|
||||
|
||||
// 요청된 언어(locale)에 대한 시리즈 번역을 조회하거나, 없으면 동기 번역 후 저장한다.
|
||||
var translated: TranslatedSeries? = null
|
||||
run {
|
||||
val locale = langContext.lang.code
|
||||
val languageCode = series.languageCode
|
||||
// 원본 언어가 존재하고, 요청 언어와 다를 때만 번역 처리
|
||||
if (!languageCode.isNullOrBlank() && languageCode != locale) {
|
||||
val existing = seriesTranslationRepository.findBySeriesIdAndLocale(seriesId = seriesId, locale = locale)
|
||||
if (existing != null) {
|
||||
val payload = existing.renderedPayload
|
||||
val kws = payload.keywords.ifEmpty { keywordList }
|
||||
translated = TranslatedSeries(
|
||||
title = payload.title,
|
||||
introduction = payload.introduction,
|
||||
keywords = kws
|
||||
)
|
||||
} else {
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
||||
resourceType = LanguageTranslationTargetType.SERIES,
|
||||
resourceId = seriesId,
|
||||
targetLanguage = locale
|
||||
)
|
||||
}
|
||||
}
|
||||
val translation = detailTranslationService.resolve(seriesId, langContext.lang.code)
|
||||
if (translation.detectionQuery != null) {
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageDetectEvent(seriesId, translation.detectionQuery, LanguageDetectTargetType.SERIES)
|
||||
)
|
||||
}
|
||||
val translated = translation.translated?.let {
|
||||
it.copy(keywords = it.keywords.ifEmpty { keywordList })
|
||||
}
|
||||
|
||||
// 장르 번역 조회 (있으면 반환)
|
||||
|
||||
@@ -58,6 +58,11 @@ class AudioContentThemeService(
|
||||
val targetLocale = currentLang.code
|
||||
// 1) 기존 번역을 한 번에 조회
|
||||
val ids = themesWithIds.map { it.id }
|
||||
resourceTranslationJobScheduler.restartFailedResourceTranslations(
|
||||
LanguageTranslationTargetType.CONTENT_THEME,
|
||||
ids,
|
||||
targetLocale
|
||||
)
|
||||
val existingTranslations = if (ids.isNotEmpty()) {
|
||||
contentThemeTranslationRepository.findByContentThemeIdInAndLocale(ids, targetLocale)
|
||||
} else {
|
||||
|
||||
+11
@@ -1,9 +1,20 @@
|
||||
package kr.co.vividnext.sodalive.content.translation
|
||||
|
||||
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> {
|
||||
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>
|
||||
}
|
||||
|
||||
+2
@@ -199,7 +199,9 @@ class CreatorAdminContentService(
|
||||
}
|
||||
|
||||
audioContent.audioContentHashTags.addAll(newAudioContentHashTagList)
|
||||
}
|
||||
|
||||
if (request.title != null || request.detail != null || !request.tags.isNullOrBlank()) {
|
||||
applicationEventPublisher.publishEvent(
|
||||
LanguageTranslationEvent(
|
||||
id = request.id,
|
||||
|
||||
@@ -7,7 +7,7 @@ import org.springframework.stereotype.Service
|
||||
class SendEmailService(private val amazonSimpleEmailService: AmazonSimpleEmailService) {
|
||||
fun sendTemplatedEmail(template: String, templateData: String, receiver: String) {
|
||||
val senderDto = TemplatedEmailSenderDto(
|
||||
senderEmail = "yozmlive.noreply@gmail.com",
|
||||
senderEmail = "noreply@sodalive.net",
|
||||
template = template,
|
||||
templateData = templateData,
|
||||
to = receiver
|
||||
|
||||
@@ -228,7 +228,7 @@ class EventService(
|
||||
)
|
||||
}
|
||||
|
||||
if (event.link != link) {
|
||||
if (link != null && event.link != link) {
|
||||
event.link = link
|
||||
}
|
||||
|
||||
@@ -240,7 +240,7 @@ class EventService(
|
||||
event.isPopup = isPopup
|
||||
}
|
||||
|
||||
if (isAdult != event.isAdult) {
|
||||
if (isAdult != null && isAdult != event.isAdult) {
|
||||
event.isAdult = isAdult
|
||||
}
|
||||
|
||||
|
||||
+3
@@ -15,6 +15,9 @@ class ChannelDonationMessage(
|
||||
@Column(columnDefinition = "TEXT")
|
||||
var additionalMessage: String? = null
|
||||
) : BaseEntity() {
|
||||
@Column(nullable = false)
|
||||
var isHidden: Boolean = false
|
||||
|
||||
@ManyToOne(fetch = FetchType.LAZY)
|
||||
@JoinColumn(name = "member_id", nullable = false)
|
||||
var member: Member? = null
|
||||
|
||||
@@ -1921,6 +1921,16 @@ class SodaMessageSource {
|
||||
Lang.KO to "%s캔을 비밀후원하셨습니다.",
|
||||
Lang.EN to "You secretly sponsored %s cans.",
|
||||
Lang.JA to "%sCANをシークレット支援しました。"
|
||||
),
|
||||
"explorer.channel_donation.anonymous.nickname" to mapOf(
|
||||
Lang.KO to "익명",
|
||||
Lang.EN to "Anonymous",
|
||||
Lang.JA to "匿名"
|
||||
),
|
||||
"explorer.channel_donation.anonymous.message" to mapOf(
|
||||
Lang.KO to "크리에이터에게만 보여요",
|
||||
Lang.EN to "Only visible to the creator",
|
||||
Lang.JA to "クリエイターにのみ表示されます"
|
||||
)
|
||||
)
|
||||
|
||||
|
||||
+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"
|
||||
|
||||
override val providerName: String = "papago"
|
||||
override val providerId: LanguageProviderId = LanguageProviderId.PAPAGO
|
||||
|
||||
override val providerVersion: String = "nmt-v1"
|
||||
|
||||
@@ -43,57 +43,49 @@ class PapagoTranslationService(
|
||||
|
||||
request.texts.forEach { text ->
|
||||
try {
|
||||
val body = mapOf(
|
||||
"source" to request.sourceLanguage,
|
||||
"target" to request.targetLanguage,
|
||||
"text" to text
|
||||
)
|
||||
val translatedText = StringBuilder()
|
||||
for (chunk in splitText(text)) {
|
||||
val body = mapOf(
|
||||
"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>(
|
||||
papagoTranslateUrl,
|
||||
requestEntity
|
||||
)
|
||||
val response = restTemplate.postForEntity<PapagoTranslationResponse>(
|
||||
papagoTranslateUrl,
|
||||
requestEntity
|
||||
)
|
||||
|
||||
if (!response.statusCode.is2xxSuccessful) {
|
||||
return@forEach
|
||||
if (!response.statusCode.is2xxSuccessful) {
|
||||
return TranslateResult(emptyList())
|
||||
}
|
||||
|
||||
val translated = response.body?.message?.result?.translatedText
|
||||
if (translated.isNullOrBlank()) {
|
||||
return TranslateResult(emptyList())
|
||||
}
|
||||
translatedText.append(translated)
|
||||
}
|
||||
|
||||
val translated = response.body?.message?.result?.translatedText
|
||||
translatedTexts.add(translated ?: "")
|
||||
translatedTexts.add(translatedText.toString())
|
||||
} catch (_: Exception) {
|
||||
return TranslateResult(emptyList())
|
||||
}
|
||||
}
|
||||
|
||||
return TranslateResult(translatedTexts)
|
||||
}
|
||||
|
||||
private fun validateLanguages(sourceLanguage: String, targetLanguage: String): Boolean {
|
||||
return requireSupportedLanguage(sourceLanguage) && requireSupportedLanguage(targetLanguage)
|
||||
private fun splitText(text: String): List<String> {
|
||||
return splitTextByCodePoint(text, MAX_REQUEST_TEXT_LENGTH, Character::charCount)
|
||||
}
|
||||
|
||||
private fun requireSupportedLanguage(language: String): Boolean {
|
||||
val normalized = language.lowercase()
|
||||
return SUPPORTED_LANGUAGE_CODES.contains(normalized)
|
||||
private fun validateLanguages(sourceLanguage: String, targetLanguage: String): Boolean {
|
||||
return TranslationLanguages.isSupported(sourceLanguage) && TranslationLanguages.isSupported(targetLanguage)
|
||||
}
|
||||
|
||||
companion object {
|
||||
private val SUPPORTED_LANGUAGE_CODES = setOf(
|
||||
"ko",
|
||||
"en",
|
||||
"ja"
|
||||
)
|
||||
|
||||
/**
|
||||
* 번역 대상 언어 코드 집합을 반환한다.
|
||||
*
|
||||
* @param excludedLanguageCode 번역 대상에서 제외할 언어 코드(대소문자 무시)
|
||||
* @return 지원되는 언어 코드 중 [excludedLanguageCode]를 제외한 집합
|
||||
*/
|
||||
fun getTranslatableLanguageCodes(excludedLanguageCode: String?): Set<String> {
|
||||
val normalized = excludedLanguageCode?.lowercase()
|
||||
return SUPPORTED_LANGUAGE_CODES.filterNot { it == normalized }.toSet()
|
||||
}
|
||||
private const val MAX_REQUEST_TEXT_LENGTH = 5000
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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
|
||||
|
||||
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.transaction.annotation.Propagation
|
||||
import org.springframework.transaction.annotation.Transactional
|
||||
import java.time.LocalDateTime
|
||||
|
||||
@Service
|
||||
class ResourceTranslationJobScheduler(
|
||||
private val sourceExtractor: TranslationSourceExtractor,
|
||||
private val translationJobScheduler: TranslationJobScheduler
|
||||
private val translationJobScheduler: TranslationJobScheduler,
|
||||
private val translationJobRepository: TranslationJobRepository
|
||||
) {
|
||||
@Transactional
|
||||
fun scheduleResourceTranslations(resourceType: LanguageTranslationTargetType, resourceId: Long) {
|
||||
@@ -27,6 +30,61 @@ class ResourceTranslationJobScheduler(
|
||||
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) {
|
||||
source.fields.forEach { field ->
|
||||
translationJobScheduler.scheduleMissingTranslation(
|
||||
|
||||
@@ -20,4 +20,8 @@ object SourceTextNormalizer {
|
||||
.digest(normalized.toByteArray(Charsets.UTF_8))
|
||||
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(
|
||||
val texts: List<String>,
|
||||
val sourceLanguage: String,
|
||||
val targetLanguage: String
|
||||
val targetLanguage: String,
|
||||
val rejectUnchangedAwsResult: Boolean = false
|
||||
)
|
||||
|
||||
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
|
||||
|
||||
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.repository.query.Param
|
||||
import java.time.LocalDateTime
|
||||
@@ -14,6 +15,58 @@ interface TranslationJobRepository : JpaRepository<TranslationJob, Long> {
|
||||
sourceHash: String
|
||||
): 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(
|
||||
"""
|
||||
select j from TranslationJob j
|
||||
|
||||
+37
-7
@@ -1,12 +1,15 @@
|
||||
package kr.co.vividnext.sodalive.i18n.translation
|
||||
|
||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
||||
import org.springframework.stereotype.Service
|
||||
import org.springframework.transaction.annotation.Transactional
|
||||
import java.time.LocalDateTime
|
||||
|
||||
@Service
|
||||
class TranslationJobScheduler(
|
||||
private val translationJobRepository: TranslationJobRepository
|
||||
private val translationJobRepository: TranslationJobRepository,
|
||||
private val translationCoordinator: TranslationCoordinator,
|
||||
private val contentTranslationRepository: ContentTranslationRepository
|
||||
) {
|
||||
@Transactional
|
||||
fun scheduleMissingTranslation(
|
||||
@@ -21,7 +24,7 @@ class TranslationJobScheduler(
|
||||
if (normalizedText.isBlank()) return
|
||||
|
||||
val normalizedSourceLanguage = sourceLanguage.lowercase()
|
||||
if (!SUPPORTED_SOURCE_LANGUAGE_CODES.contains(normalizedSourceLanguage)) return
|
||||
if (!TranslationLanguages.isSupported(normalizedSourceLanguage)) return
|
||||
|
||||
val normalizedTargetLanguage = targetLanguage.lowercase()
|
||||
if (normalizedSourceLanguage == normalizedTargetLanguage) return
|
||||
@@ -34,7 +37,38 @@ class TranslationJobScheduler(
|
||||
targetLanguage = normalizedTargetLanguage,
|
||||
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(
|
||||
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
|
||||
class TranslationJobWorker(
|
||||
private val translationJobRepository: TranslationJobRepository,
|
||||
private val translationMemoryRepository: TranslationMemoryRepository,
|
||||
private val translationProvider: TranslationProvider,
|
||||
private val translationMemoryService: TranslationMemoryService,
|
||||
private val materializer: TranslationReadModelMaterializer,
|
||||
transactionManager: PlatformTransactionManager
|
||||
) {
|
||||
private val log = LoggerFactory.getLogger(javaClass)
|
||||
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() {
|
||||
repeat(MAX_GROUPS_PER_TICK) {
|
||||
if (!processNextGroup()) return
|
||||
@@ -34,7 +33,13 @@ class TranslationJobWorker(
|
||||
val failedJobs = mutableListOf<Pair<TranslationJob, Exception>>()
|
||||
jobs.forEach { job ->
|
||||
try {
|
||||
ensureMemory(job)
|
||||
translationMemoryService.ensureMemory(
|
||||
job.resourceType,
|
||||
job.fieldKey,
|
||||
job.sourceText,
|
||||
job.sourceLanguage,
|
||||
job.targetLanguage
|
||||
)
|
||||
succeededJobs.add(job)
|
||||
} catch (ex: Exception) {
|
||||
failedJobs.add(job to ex)
|
||||
@@ -68,52 +73,6 @@ class TranslationJobWorker(
|
||||
}.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) {
|
||||
transactionTemplate.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
|
||||
job.retryCount += 1
|
||||
job.lastErrorMessage = ex.message?.take(MAX_ERROR_LENGTH)
|
||||
if (job.retryCount >= MAX_RETRY_COUNT) {
|
||||
if (job.retryCount >= MAX_ATTEMPTS) {
|
||||
job.status = TranslationJobStatus.FAILED
|
||||
} else {
|
||||
job.status = TranslationJobStatus.PENDING
|
||||
@@ -150,6 +109,6 @@ class TranslationJobWorker(
|
||||
companion object {
|
||||
private const val MAX_GROUPS_PER_TICK = 5
|
||||
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,
|
||||
|
||||
@Column(name = "translated_text", nullable = false, columnDefinition = "text")
|
||||
val translatedText: String,
|
||||
var translatedText: String,
|
||||
|
||||
@Column(name = "provider", nullable = false, length = 50)
|
||||
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
|
||||
|
||||
interface TranslationProvider {
|
||||
val providerName: String
|
||||
val providerId: LanguageProviderId
|
||||
val providerVersion: String
|
||||
|
||||
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.OriginalWorkTranslationPayload
|
||||
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.CategoryTranslationRepository
|
||||
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.ContentTranslationPayload
|
||||
import kr.co.vividnext.sodalive.content.translation.ContentTranslationRepository
|
||||
import kr.co.vividnext.sodalive.creator.admin.content.series.Series
|
||||
import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
|
||||
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.CreatorCommunityTranslation
|
||||
import kr.co.vividnext.sodalive.v2.creator.channel.community.translation.adapter.out.persistence.CreatorCommunityTranslationRepository
|
||||
@@ -29,7 +31,7 @@ import javax.persistence.LockModeType
|
||||
@Service
|
||||
class TranslationReadModelMaterializer(
|
||||
private val sourceExtractor: TranslationSourceExtractor,
|
||||
private val translationMemoryRepository: TranslationMemoryRepository,
|
||||
private val translationCoordinator: TranslationCoordinator,
|
||||
private val contentTranslationRepository: ContentTranslationRepository,
|
||||
private val aiCharacterTranslationRepository: AiCharacterTranslationRepository,
|
||||
private val contentThemeTranslationRepository: ContentThemeTranslationRepository,
|
||||
@@ -71,14 +73,13 @@ class TranslationReadModelMaterializer(
|
||||
return@forEach
|
||||
}
|
||||
|
||||
val memory = translationMemoryRepository
|
||||
.findBySourceHashAndSourceLanguageAndTargetLanguageAndProviderAndNormalizationVersion(
|
||||
sourceHash = SourceTextNormalizer.hash(normalizedText),
|
||||
sourceLanguage = source.sourceLanguage.lowercase(),
|
||||
targetLanguage = targetLanguage,
|
||||
provider = DEFAULT_PROVIDER,
|
||||
normalizationVersion = SourceTextNormalizer.NORMALIZATION_VERSION
|
||||
) ?: return null
|
||||
val memory = translationCoordinator.findCached(
|
||||
sourceHash = SourceTextNormalizer.hash(normalizedText),
|
||||
sourceLanguage = source.sourceLanguage.lowercase(),
|
||||
targetLanguage = targetLanguage,
|
||||
rejectUnchangedAwsResult = source.resourceType == LanguageTranslationTargetType.CONTENT &&
|
||||
field.fieldKey == "tags"
|
||||
) ?: return null
|
||||
|
||||
result[field.fieldKey] = memory.translatedText
|
||||
}
|
||||
@@ -91,7 +92,8 @@ class TranslationReadModelMaterializer(
|
||||
detail = translations["detail"].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) {
|
||||
contentTranslationRepository.save(ContentTranslation(resourceId, targetLanguage, payload))
|
||||
} else {
|
||||
@@ -140,6 +142,7 @@ class TranslationReadModelMaterializer(
|
||||
.map { it.trim() }
|
||||
.filter { it.isNotBlank() }
|
||||
)
|
||||
entityManager.find(Series::class.java, resourceId, LockModeType.PESSIMISTIC_WRITE)
|
||||
val existing = seriesTranslationRepository.findBySeriesIdAndLocale(resourceId, targetLanguage)
|
||||
if (existing == null) {
|
||||
seriesTranslationRepository.save(SeriesTranslation(resourceId, targetLanguage, payload))
|
||||
@@ -231,8 +234,4 @@ class TranslationReadModelMaterializer(
|
||||
}
|
||||
return true
|
||||
}
|
||||
|
||||
companion object {
|
||||
const val DEFAULT_PROVIDER = "papago"
|
||||
}
|
||||
}
|
||||
|
||||
+1
@@ -52,6 +52,7 @@ class TranslationSourceExtractor(
|
||||
val content = audioContentRepository.findByIdOrNull(resourceId) ?: return null
|
||||
val sourceLanguage = content.languageCode?.takeIf { it.isNotBlank() } ?: return null
|
||||
val tags = content.audioContentHashTags
|
||||
.filter { it.isActive }
|
||||
.mapNotNull { it.hashTag?.tag }
|
||||
.joinToString(",")
|
||||
return TranslationSource(
|
||||
|
||||
+1
-1
@@ -3,7 +3,7 @@ package kr.co.vividnext.sodalive.member.contentpreference
|
||||
import kr.co.vividnext.sodalive.member.Member
|
||||
|
||||
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 {
|
||||
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.http.HttpStatus
|
||||
import org.springframework.stereotype.Service
|
||||
import org.springframework.transaction.annotation.Propagation
|
||||
import org.springframework.transaction.annotation.Transactional
|
||||
import org.springframework.web.multipart.MultipartFile
|
||||
import java.time.DateTimeException
|
||||
@@ -158,7 +159,7 @@ class AiCharacterAdminAudioContentFacade(
|
||||
)
|
||||
}
|
||||
|
||||
@Transactional
|
||||
@Transactional(propagation = Propagation.NOT_SUPPORTED)
|
||||
fun create(
|
||||
characterId: Long,
|
||||
coverImage: MultipartFile,
|
||||
|
||||
+11
@@ -6,6 +6,7 @@ import kr.co.vividnext.sodalive.i18n.LangContext
|
||||
import kr.co.vividnext.sodalive.member.Member
|
||||
import kr.co.vividnext.sodalive.v2.api.creator.channel.donation.application.CreatorChannelDonationFacade
|
||||
import org.springframework.security.core.annotation.AuthenticationPrincipal
|
||||
import org.springframework.web.bind.annotation.DeleteMapping
|
||||
import org.springframework.web.bind.annotation.GetMapping
|
||||
import org.springframework.web.bind.annotation.PathVariable
|
||||
import org.springframework.web.bind.annotation.RequestMapping
|
||||
@@ -18,6 +19,16 @@ class CreatorChannelDonationController(
|
||||
private val creatorChannelDonationFacade: CreatorChannelDonationFacade,
|
||||
private val langContext: LangContext
|
||||
) {
|
||||
@DeleteMapping("/{creatorId}/donations/{donationId}")
|
||||
fun hideDonation(
|
||||
@PathVariable creatorId: Long,
|
||||
@PathVariable donationId: Long,
|
||||
@AuthenticationPrincipal(expression = "#this == 'anonymousUser' ? null : member") member: Member?
|
||||
): ApiResponse<Unit> {
|
||||
creatorChannelDonationFacade.hide(creatorId, donationId, requireMember(member))
|
||||
return ApiResponse.ok<Unit>()
|
||||
}
|
||||
|
||||
@GetMapping("/{creatorId}/donations")
|
||||
fun getDonationTab(
|
||||
@PathVariable creatorId: Long,
|
||||
|
||||
+8
-1
@@ -4,6 +4,7 @@ import kr.co.vividnext.sodalive.i18n.Lang
|
||||
import kr.co.vividnext.sodalive.member.Member
|
||||
import kr.co.vividnext.sodalive.v2.api.creator.channel.donation.dto.CreatorChannelDonationTabResponse
|
||||
import kr.co.vividnext.sodalive.v2.creator.channel.donation.application.CreatorChannelDonationQueryService
|
||||
import kr.co.vividnext.sodalive.v2.creator.channel.donation.application.HideCreatorChannelDonationService
|
||||
import kr.co.vividnext.sodalive.v2.creatorname.application.CreatorLocalizedNameService
|
||||
import org.springframework.stereotype.Service
|
||||
import org.springframework.transaction.annotation.Transactional
|
||||
@@ -13,8 +14,14 @@ import java.time.LocalDateTime
|
||||
@Transactional(readOnly = true)
|
||||
class CreatorChannelDonationFacade(
|
||||
private val creatorChannelDonationQueryService: CreatorChannelDonationQueryService,
|
||||
private val creatorLocalizedNameService: CreatorLocalizedNameService
|
||||
private val creatorLocalizedNameService: CreatorLocalizedNameService,
|
||||
private val hideCreatorChannelDonationService: HideCreatorChannelDonationService
|
||||
) {
|
||||
@Transactional
|
||||
fun hide(creatorId: Long, donationId: Long, actor: Member) {
|
||||
hideCreatorChannelDonationService.hide(creatorId, donationId, actor)
|
||||
}
|
||||
|
||||
fun getDonationTab(
|
||||
creatorId: Long,
|
||||
viewer: Member,
|
||||
|
||||
+9
-2
@@ -1,5 +1,6 @@
|
||||
package kr.co.vividnext.sodalive.v2.api.creator.channel.donation.dto
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude
|
||||
import com.fasterxml.jackson.annotation.JsonProperty
|
||||
import kr.co.vividnext.sodalive.extensions.toUtcIso
|
||||
import kr.co.vividnext.sodalive.v2.creator.channel.donation.domain.CreatorChannelDonation
|
||||
@@ -48,20 +49,26 @@ data class MemberDonationRankingResponse(
|
||||
}
|
||||
|
||||
data class CreatorChannelDonationResponse(
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL)
|
||||
val donationId: Long?,
|
||||
val nickname: String,
|
||||
val profileImageUrl: String,
|
||||
val can: Int,
|
||||
val message: String,
|
||||
val createdAtUtc: String
|
||||
val createdAtUtc: String,
|
||||
@JsonProperty("isSecret")
|
||||
val isSecret: Boolean
|
||||
) {
|
||||
companion object {
|
||||
fun from(donation: CreatorChannelDonation): CreatorChannelDonationResponse {
|
||||
return CreatorChannelDonationResponse(
|
||||
donationId = donation.donationId,
|
||||
nickname = donation.nickname,
|
||||
profileImageUrl = donation.profileImageUrl,
|
||||
can = donation.can,
|
||||
message = donation.message,
|
||||
createdAtUtc = donation.createdAt.toUtcIso()
|
||||
createdAtUtc = donation.createdAt.toUtcIso(),
|
||||
isSecret = donation.isSecret
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
+9
-2
@@ -1,5 +1,6 @@
|
||||
package kr.co.vividnext.sodalive.v2.api.creator.channel.home.dto
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude
|
||||
import com.fasterxml.jackson.annotation.JsonProperty
|
||||
import kr.co.vividnext.sodalive.v2.api.creator.channel.common.dto.CreatorChannelAudioContentResponse
|
||||
import kr.co.vividnext.sodalive.v2.common.domain.CreatorActivityType
|
||||
@@ -109,20 +110,26 @@ data class CreatorChannelLiveResponse(
|
||||
}
|
||||
|
||||
data class CreatorChannelDonationResponse(
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL)
|
||||
val donationId: Long?,
|
||||
val nickname: String,
|
||||
val profileImageUrl: String,
|
||||
val can: Int,
|
||||
val message: String,
|
||||
val createdAtUtc: String
|
||||
val createdAtUtc: String,
|
||||
@JsonProperty("isSecret")
|
||||
val isSecret: Boolean
|
||||
) {
|
||||
companion object {
|
||||
fun from(donation: CreatorChannelDonation): CreatorChannelDonationResponse {
|
||||
return CreatorChannelDonationResponse(
|
||||
donationId = donation.donationId,
|
||||
nickname = donation.nickname,
|
||||
profileImageUrl = donation.profileImageUrl,
|
||||
can = donation.can,
|
||||
message = donation.message,
|
||||
createdAtUtc = donation.createdAt.toUtcIso()
|
||||
createdAtUtc = donation.createdAt.toUtcIso(),
|
||||
isSecret = donation.isSecret
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
+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.CreatorCommunityRepository
|
||||
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.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.TranslationSourceExtractor
|
||||
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 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
|
||||
.findByCreatorCommunityIdInAndLocale(posts.mapNotNull { it.id }, normalizedLocale)
|
||||
.associateBy { it.creatorCommunityId }
|
||||
@@ -62,6 +73,11 @@ class CreatorCommunityTranslationService(
|
||||
targetLanguages
|
||||
.filter { it != sourceLanguage }
|
||||
.forEach { language ->
|
||||
resourceTranslationJobScheduler.restartFailedResourceTranslationsInCurrentTransaction(
|
||||
LanguageTranslationTargetType.CREATOR_COMMUNITY,
|
||||
listOf(postId),
|
||||
language
|
||||
)
|
||||
if (!materializer.materialize(LanguageTranslationTargetType.CREATOR_COMMUNITY, postId, language)) {
|
||||
resourceTranslationJobScheduler.scheduleResourceTranslation(
|
||||
resourceType = LanguageTranslationTargetType.CREATOR_COMMUNITY,
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user