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): AP2_SESSION으로 access endpoint를 호출하고 반환된 access token으로 Resource Server를 직접 호출한다. Evidence: L505L511, L558L586.
- **Spring mediator** (participant): 현재 principal로 authorized client를 조회하고 access token, type, expiry만 JSON으로 반환한다. Evidence: L503L540.
- **Authorized-client store** (participant): Registration과 principal name으로 access token과 refresh token을 보관하는 process-local service. Evidence: L445L457, L513L521.
- **Resource Server** (participant): 브라우저가 만든 Bearer JWT를 검증하고 /api/me 사용자 JSON을 반환한다. Evidence: L571L599.
- **브라우저** (participant): AP2_SESSION으로 access endpoint를 호출하고 반환된 access token으로 Resource Server를 직접 호출한다. Evidence: L539L545, L592L620.
- **Spring mediator** (participant): 현재 principal로 authorized client를 조회하고 access token, type, expiry만 JSON으로 반환한다. Evidence: L537L574.
- **Authorized-client store** (participant): Registration과 principal name으로 access token과 refresh token을 보관하는 process-local service. Evidence: L479L491, L547L555.
- **Resource Server** (participant): 브라우저가 만든 Bearer JWT를 검증하고 /api/me 사용자 JSON을 반환한다. Evidence: L605L633.
## Relationships
- **브라우저 → Spring mediator:** GET /token/access + AP2_SESSION. Evidence: L503L511.
- **Spring mediator → Authorized-client store:** authorize current principal. Evidence: L513L521.
- **Authorized-client store → Spring mediator:** current access token. Evidence: L513L521.
- **Spring mediator → 브라우저:** access token + type + expiry. Evidence: L523L540.
- **브라우저 → Resource Server:** GET /api/me · browser-created Bearer. Evidence: L558L588.
- **Resource Server → 브라우저:** subject · username · issuer · audience. Evidence: L590L615.
- **브라우저 → Spring mediator:** GET /token/access + AP2_SESSION. Evidence: L537L545.
- **Spring mediator → Authorized-client store:** authorize current principal. Evidence: L547L555.
- **Authorized-client store → Spring mediator:** current access token. Evidence: L547L555.
- **Spring mediator → 브라우저:** access token + type + expiry. Evidence: L557L574.
- **브라우저 → Resource Server:** GET /api/me · browser-created Bearer. Evidence: L592L622.
- **Resource Server → 브라우저:** subject · username · issuer · audience. Evidence: L624L649.