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
@@ -10,16 +10,16 @@
## Elements and evidence
- **브라우저** (participant): AP4_SESSION cookie와 함께 edge endpoint를 호출하는 외부 client. Evidence: L992L1007.
- **Nginx edge** (participant): Internal auth subrequest를 만들고 인증 결과를 allowlisted upstream header와 internal token으로 재조립한다. Evidence: L914L939, L1009L1028.
- **oauth2-proxy** (participant): AP4_SESSION을 검증하고 인증된 user, email과 필요 시 갱신 cookie를 auth response로 돌려준다. Evidence: L980L990, L1009L1015.
- **Spring upstream** (participant): Identity header와 internal token을 함께 검증해 allowlisted identity JSON을 반환한다. Evidence: L1017L1026, L1030L1063.
- **브라우저** (participant): AP4_SESSION cookie와 함께 edge endpoint를 호출하는 외부 client. Evidence: L1032L1047.
- **Nginx edge** (participant): Internal auth subrequest를 만들고 인증 결과를 allowlisted upstream header와 internal token으로 재조립한다. Evidence: L954L979, L1049L1068.
- **oauth2-proxy** (participant): AP4_SESSION을 검증하고 인증된 user, email과 필요 시 갱신 cookie를 auth response로 돌려준다. Evidence: L1020L1030, L1049L1055.
- **Spring upstream** (participant): Identity header와 internal token을 함께 검증해 allowlisted identity JSON을 반환한다. Evidence: L1057L1066, L1070L1103.
## Relationships
- **브라우저 → Nginx edge:** GET /api/edge + AP4_SESSION. Evidence: L992L999.
- **Nginx edge → oauth2-proxy:** internal /oauth2/auth subrequest. Evidence: L922L939, L1009L1009.
- **oauth2-proxy → Nginx edge:** authenticated user + email. Evidence: L1009L1015.
- **Nginx edge → Spring upstream:** GET /edge/me · trusted headers + internal token. Evidence: L1017L1026.
- **Spring upstream → Nginx edge:** trusted identity JSON. Evidence: L1030L1048.
- **Nginx edge → 브라우저:** pattern + user + email + identityHeader. Evidence: L1039L1048, L1065L1076.
- **브라우저 → Nginx edge:** GET /api/edge + AP4_SESSION. Evidence: L1032L1039.
- **Nginx edge → oauth2-proxy:** internal /oauth2/auth subrequest. Evidence: L962L979, L1049L1049.
- **oauth2-proxy → Nginx edge:** authenticated user + email. Evidence: L1049L1055.
- **Nginx edge → Spring upstream:** GET /edge/me · trusted headers + internal token. Evidence: L1057L1066.
- **Spring upstream → Nginx edge:** trusted identity JSON. Evidence: L1070L1088.
- **Nginx edge → 브라우저:** pattern + user + email + identityHeader. Evidence: L1079L1088, L1105L1116.