refactor: 문서 개선 중

This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -13,11 +13,11 @@
"long_description": "브라우저가 AP4_SESSION cookie로 Nginx의 /api/edge를 호출한다. Nginx는 oauth2-proxy의 internal auth endpoint에 subrequest를 보내고 인증된 user와 email 결과를 받는다. 이어서 client가 보낸 동명 header를 사용하지 않고 oauth2-proxy 결과와 Nginx 환경의 internal token으로 /edge/me 요청을 새로 조립한다. Spring controller가 user header와 internal token을 함께 확인해 identity JSON을 만들고 Nginx가 브라우저에 전달한다.",
"source_context": {
"document": "document.md",
"document_sha256": "df4d1a604c74e756672b5b40510abfedb8c67b39af280a5f51985ea9972f5371",
"document_sha256": "ea10df24b892e2c57123a37a4b4f0d821e4f394353e6746f50df6a48342353e9",
"anchor": {
"kind": "marker",
"value": "ap4-edge-forward-auth-flow",
"line": 1108
"line": 1148
}
},
"composition": {
@@ -39,8 +39,8 @@
"description": "AP4_SESSION cookie와 함께 edge endpoint를 호출하는 외부 client.",
"evidence": [
{
"start_line": 992,
"end_line": 1007
"start_line": 1032,
"end_line": 1047
}
],
"assumption": false
@@ -54,12 +54,12 @@
"description": "Internal auth subrequest를 만들고 인증 결과를 allowlisted upstream header와 internal token으로 재조립한다.",
"evidence": [
{
"start_line": 914,
"end_line": 939
"start_line": 954,
"end_line": 979
},
{
"start_line": 1009,
"end_line": 1028
"start_line": 1049,
"end_line": 1068
}
],
"assumption": false
@@ -72,12 +72,12 @@
"description": "AP4_SESSION을 검증하고 인증된 user, email과 필요 시 갱신 cookie를 auth response로 돌려준다.",
"evidence": [
{
"start_line": 980,
"end_line": 990
"start_line": 1020,
"end_line": 1030
},
{
"start_line": 1009,
"end_line": 1015
"start_line": 1049,
"end_line": 1055
}
],
"assumption": false
@@ -90,12 +90,12 @@
"description": "Identity header와 internal token을 함께 검증해 allowlisted identity JSON을 반환한다.",
"evidence": [
{
"start_line": 1017,
"end_line": 1026
"start_line": 1057,
"end_line": 1066
},
{
"start_line": 1030,
"end_line": 1063
"start_line": 1070,
"end_line": 1103
}
],
"assumption": false
@@ -111,8 +111,8 @@
"order": 1,
"evidence": [
{
"start_line": 992,
"end_line": 999
"start_line": 1032,
"end_line": 1039
}
],
"assumption": false
@@ -126,12 +126,12 @@
"order": 2,
"evidence": [
{
"start_line": 922,
"end_line": 939
"start_line": 962,
"end_line": 979
},
{
"start_line": 1009,
"end_line": 1009
"start_line": 1049,
"end_line": 1049
}
],
"assumption": false
@@ -146,8 +146,8 @@
"order": 3,
"evidence": [
{
"start_line": 1009,
"end_line": 1015
"start_line": 1049,
"end_line": 1055
}
],
"assumption": false
@@ -162,8 +162,8 @@
"order": 4,
"evidence": [
{
"start_line": 1017,
"end_line": 1026
"start_line": 1057,
"end_line": 1066
}
],
"assumption": false
@@ -178,8 +178,8 @@
"order": 5,
"evidence": [
{
"start_line": 1030,
"end_line": 1048
"start_line": 1070,
"end_line": 1088
}
],
"assumption": false
@@ -194,12 +194,12 @@
"order": 6,
"evidence": [
{
"start_line": 1039,
"end_line": 1048
"start_line": 1079,
"end_line": 1088
},
{
"start_line": 1065,
"end_line": 1076
"start_line": 1105,
"end_line": 1116
}
],
"assumption": false