290 lines
20 KiB
YAML
290 lines
20 KiB
YAML
- generic [ref=f65e3]:
|
|
- link "본문으로 건너뛰기" [ref=f65e4] [cursor=pointer]:
|
|
- /url: "#main-content"
|
|
- banner [ref=f65e5]:
|
|
- generic [ref=f65e6]:
|
|
- link "TechLog Studio" [ref=f65e7] [cursor=pointer]:
|
|
- /url: /studio
|
|
- text: TechLog
|
|
- generic [ref=f65e8]: Studio
|
|
- navigation "Studio 주 탐색" [ref=f65e10]:
|
|
- link "작업본" [ref=f65e11] [cursor=pointer]:
|
|
- /url: /studio/documents
|
|
- link "게시 기록" [ref=f65e12] [cursor=pointer]:
|
|
- /url: /studio/publications
|
|
- link "새 문서" [ref=f65e13] [cursor=pointer]:
|
|
- /url: /studio/documents/new
|
|
- link "주제·프로젝트" [ref=f65e14] [cursor=pointer]:
|
|
- /url: /studio/taxonomy
|
|
- link "릴리즈" [ref=f65e15] [cursor=pointer]:
|
|
- /url: /studio/releases
|
|
- link "공개 사이트 보기" [ref=f65e16] [cursor=pointer]:
|
|
- /url: /
|
|
- button "로그아웃" [ref=f65e17]
|
|
- main [ref=f65e18]:
|
|
- generic [ref=f65e19]:
|
|
- generic [ref=f65e20]:
|
|
- region [ref=f65e21]:
|
|
- generic [ref=f65e22]:
|
|
- paragraph [ref=f65e23]: PROJECT_DECISION · VERSION 1
|
|
- heading "문서 편집" [level=1] [ref=f65e24]
|
|
- paragraph [ref=f65e25]: 화면 조회는 Read Projection을 사용한다
|
|
- region [ref=f65e26]:
|
|
- generic [ref=f65e27]:
|
|
- paragraph [ref=f65e28]: DOCUMENT
|
|
- heading "기본 정보" [level=2] [ref=f65e29]
|
|
- generic [ref=f65e30]:
|
|
- generic [ref=f65e31]:
|
|
- generic [ref=f65e32]: 제목
|
|
- textbox "제목" [ref=f65e33]: 화면 조회는 Read Projection을 사용한다
|
|
- generic [ref=f65e34]:
|
|
- generic [ref=f65e35]: slug
|
|
- textbox "slug" [ref=f65e36]:
|
|
- /placeholder: 비우면 제목에서 만듭니다 (영문 소문자·숫자·하이픈)
|
|
- text: read-projection-for-screen-query
|
|
- generic [ref=f65e37]:
|
|
- generic [ref=f65e38]: 요약
|
|
- textbox "요약" [ref=f65e39]: 화면에 내보내는 조회는 엔티티를 하이드레이트하지 않고 필요한 스칼라 값만 캐리어로 받는다. 엔티티 그래프 조회는 쓰기 경로에 남기고 읽기 경로는 프로젝션으로 분리한다.
|
|
- generic [ref=f65e40]: 목록 카드에는 약 90자까지 보입니다 · 93 / 2000
|
|
- generic [ref=f65e41]:
|
|
- generic [ref=f65e42]: Topic
|
|
- combobox "Topic" [ref=f65e43]:
|
|
- option "선택하지 않음"
|
|
- option "JPA 피드 조회 성능" [selected]
|
|
- option "OAuth/OIDC 인증 경계"
|
|
- generic [ref=f65e44]:
|
|
- generic [ref=f65e45]: Project
|
|
- combobox "Project" [ref=f65e46]:
|
|
- option "미지정"
|
|
- option "Backend Clean Architecture"
|
|
- option "KeyCloak Patterns"
|
|
- option "Liner N + 1문제" [selected]
|
|
- status [ref=f65e47]
|
|
- group "근거 기록" [ref=f65e48]:
|
|
- generic [ref=f65e50]:
|
|
- generic [ref=f65e51]:
|
|
- generic [ref=f65e52]: 근거 1 대상
|
|
- combobox "근거 1 대상" [ref=f65e53]:
|
|
- option "대상 선택"
|
|
- option
|
|
- option
|
|
- option [disabled]
|
|
- option
|
|
- option
|
|
- option
|
|
- option
|
|
- option "실제 동시 트래픽에서도 이 구조가 안정적인가"
|
|
- option "서버 세션 기반 인증 구조는 다중 인스턴스에서 어떻게 운영할 것인가"
|
|
- option "ANALYZE 이후 Cardinality Estimate는 어떻게 달라지는가"
|
|
- option "Authorization Code Flow의 Endpoint와 Credential 이동 기준"
|
|
- option "Authorization Code와 PKCE가 보호하는 구간"
|
|
- option "Bearer JWT가 인증된 principal이 되기까지"
|
|
- option "BFF 인증 구조 설계 기준"
|
|
- option "BFF가 OAuth Token을 관리하는 조건"
|
|
- option "BFF의 Session과 OAuth2AuthorizedClient를 어디에 저장할 것인가"
|
|
- option "Browser Token을 없애면서 BFF에 Session과 CSRF 책임이 생긴 과정"
|
|
- option "Collection Fetch Join Pagination의 In-memory Paging"
|
|
- option "Cookie로 인증하는 요청에서 CSRF token이 하는 일"
|
|
- option "브라우저가 credential을 보관하는 위치와 그 성질"
|
|
- option "DTO 변환 과정에서 발생한 Highlight 컬렉션 N+1"
|
|
- option "필드 접근 없이 발생한 EAGER ToOne N+1"
|
|
- option "Feed Visibility Query Pattern"
|
|
- option "feed_visible을 Production CQRS로 승격할 것인가"
|
|
- option "Fetch Join · Batch · Projection 선택 기준" [disabled]
|
|
- option "Fetch Join으로 N+1을 해결하다 만난 MultiBag과 행 폭증"
|
|
- option "Fetch Type과 Fetch Strategy 구분"
|
|
- option "Forward-Auth 구조에서 Application Authorization을 어디까지 Edge에 둘 것인가"
|
|
- option "Forward-Auth에서 Client가 보낸 Identity Header를 신뢰하면 안 되는 이유"
|
|
- option "Forward-Auth에서 Identity Header를 신뢰하기 위한 조건"
|
|
- option "Forward-Auth와 Nginx auth_request의 동작"
|
|
- option "Highlight 없는 FeedItem을 허용할 것인가"
|
|
- option "외부 IdP와의 연동이라도 별도의 인증 방식이 아니다."
|
|
- option "외부 IdP 연동과 Application 인증 구조의 경계"
|
|
- option "외부 IdP Brokering의 동작"
|
|
- option "JPA N+1 정량 진단 기준"
|
|
- option "Keyset Pagination 설계 기준"
|
|
- option "OAuth/OIDC 인증 패턴 선택 기준"
|
|
- option "OAuth Token과 Application Session을 구분하는 기준"
|
|
- option "PostgreSQL Query Plan 측정 기준"
|
|
- option "Projection 이후에도 1,509행을 읽은 Row Over-fetch" [selected]
|
|
- option "Public Client와 Confidential Client 구분 기준"
|
|
- option "Refresh Token 관리만 서버로 이전, Access Token은 여전히 Browser에 노출"
|
|
- option "Refresh Token Rotation과 다중 Replica 경쟁을 어떻게 처리할 것인가"
|
|
- option "Round Trip과 Row Volume을 독립 측정할 것인가"
|
|
- option "SPA에서 토큰을 직접 관리하면서 드러난 Browser Credential 경계"
|
|
- option "Top-N-per-group 선택 기준"
|
|
- option "Visibility OR이 Keyset Index를 깨뜨린 문제"
|
|
- generic [ref=f65e54]:
|
|
- generic [ref=f65e55]: 근거 1 이유
|
|
- textbox "근거 1 이유" [ref=f65e56]: 프로젝션의 효과와 남은 비용을 확인한 기록이다.
|
|
- generic [ref=f65e57]:
|
|
- button "위로" [disabled] [ref=f65e58]
|
|
- button "아래로" [ref=f65e59]
|
|
- button "삭제" [ref=f65e60]
|
|
- generic [ref=f65e61]:
|
|
- generic [ref=f65e62]:
|
|
- generic [ref=f65e63]: 근거 2 대상
|
|
- combobox "근거 2 대상" [ref=f65e64]:
|
|
- option "대상 선택"
|
|
- option
|
|
- option
|
|
- option [disabled]
|
|
- option
|
|
- option
|
|
- option
|
|
- option
|
|
- option "실제 동시 트래픽에서도 이 구조가 안정적인가"
|
|
- option "서버 세션 기반 인증 구조는 다중 인스턴스에서 어떻게 운영할 것인가"
|
|
- option "ANALYZE 이후 Cardinality Estimate는 어떻게 달라지는가"
|
|
- option "Authorization Code Flow의 Endpoint와 Credential 이동 기준"
|
|
- option "Authorization Code와 PKCE가 보호하는 구간"
|
|
- option "Bearer JWT가 인증된 principal이 되기까지"
|
|
- option "BFF 인증 구조 설계 기준"
|
|
- option "BFF가 OAuth Token을 관리하는 조건"
|
|
- option "BFF의 Session과 OAuth2AuthorizedClient를 어디에 저장할 것인가"
|
|
- option "Browser Token을 없애면서 BFF에 Session과 CSRF 책임이 생긴 과정"
|
|
- option "Collection Fetch Join Pagination의 In-memory Paging"
|
|
- option "Cookie로 인증하는 요청에서 CSRF token이 하는 일"
|
|
- option "브라우저가 credential을 보관하는 위치와 그 성질"
|
|
- option "DTO 변환 과정에서 발생한 Highlight 컬렉션 N+1"
|
|
- option "필드 접근 없이 발생한 EAGER ToOne N+1"
|
|
- option "Feed Visibility Query Pattern"
|
|
- option "feed_visible을 Production CQRS로 승격할 것인가"
|
|
- option "Fetch Join · Batch · Projection 선택 기준" [selected]
|
|
- option "Fetch Join으로 N+1을 해결하다 만난 MultiBag과 행 폭증"
|
|
- option "Fetch Type과 Fetch Strategy 구분"
|
|
- option "Forward-Auth 구조에서 Application Authorization을 어디까지 Edge에 둘 것인가"
|
|
- option "Forward-Auth에서 Client가 보낸 Identity Header를 신뢰하면 안 되는 이유"
|
|
- option "Forward-Auth에서 Identity Header를 신뢰하기 위한 조건"
|
|
- option "Forward-Auth와 Nginx auth_request의 동작"
|
|
- option "Highlight 없는 FeedItem을 허용할 것인가"
|
|
- option "외부 IdP와의 연동이라도 별도의 인증 방식이 아니다."
|
|
- option "외부 IdP 연동과 Application 인증 구조의 경계"
|
|
- option "외부 IdP Brokering의 동작"
|
|
- option "JPA N+1 정량 진단 기준"
|
|
- option "Keyset Pagination 설계 기준"
|
|
- option "OAuth/OIDC 인증 패턴 선택 기준"
|
|
- option "OAuth Token과 Application Session을 구분하는 기준"
|
|
- option "PostgreSQL Query Plan 측정 기준"
|
|
- option "Projection 이후에도 1,509행을 읽은 Row Over-fetch" [disabled]
|
|
- option "Public Client와 Confidential Client 구분 기준"
|
|
- option "Refresh Token 관리만 서버로 이전, Access Token은 여전히 Browser에 노출"
|
|
- option "Refresh Token Rotation과 다중 Replica 경쟁을 어떻게 처리할 것인가"
|
|
- option "Round Trip과 Row Volume을 독립 측정할 것인가"
|
|
- option "SPA에서 토큰을 직접 관리하면서 드러난 Browser Credential 경계"
|
|
- option "Top-N-per-group 선택 기준"
|
|
- option "Visibility OR이 Keyset Index를 깨뜨린 문제"
|
|
- generic [ref=f65e65]:
|
|
- generic [ref=f65e66]: 근거 2 이유
|
|
- textbox "근거 2 이유" [ref=f65e67]: 배치와 프로젝션이 서로 다른 비용을 줄인다는 기준이다.
|
|
- generic [ref=f65e68]:
|
|
- button "위로" [ref=f65e69]
|
|
- button "아래로" [ref=f65e70]
|
|
- button "삭제" [ref=f65e71]
|
|
- generic [ref=f65e72]:
|
|
- generic [ref=f65e73]:
|
|
- generic [ref=f65e74]: 근거 3 대상
|
|
- combobox "근거 3 대상" [ref=f65e75]:
|
|
- option "대상 선택"
|
|
- option
|
|
- option
|
|
- option [selected]
|
|
- option
|
|
- option
|
|
- option
|
|
- option
|
|
- option "실제 동시 트래픽에서도 이 구조가 안정적인가"
|
|
- option "서버 세션 기반 인증 구조는 다중 인스턴스에서 어떻게 운영할 것인가"
|
|
- option "ANALYZE 이후 Cardinality Estimate는 어떻게 달라지는가"
|
|
- option "Authorization Code Flow의 Endpoint와 Credential 이동 기준"
|
|
- option "Authorization Code와 PKCE가 보호하는 구간"
|
|
- option "Bearer JWT가 인증된 principal이 되기까지"
|
|
- option "BFF 인증 구조 설계 기준"
|
|
- option "BFF가 OAuth Token을 관리하는 조건"
|
|
- option "BFF의 Session과 OAuth2AuthorizedClient를 어디에 저장할 것인가"
|
|
- option "Browser Token을 없애면서 BFF에 Session과 CSRF 책임이 생긴 과정"
|
|
- option "Collection Fetch Join Pagination의 In-memory Paging"
|
|
- option "Cookie로 인증하는 요청에서 CSRF token이 하는 일"
|
|
- option "브라우저가 credential을 보관하는 위치와 그 성질"
|
|
- option "DTO 변환 과정에서 발생한 Highlight 컬렉션 N+1"
|
|
- option "필드 접근 없이 발생한 EAGER ToOne N+1"
|
|
- option "Feed Visibility Query Pattern"
|
|
- option "feed_visible을 Production CQRS로 승격할 것인가"
|
|
- option "Fetch Join · Batch · Projection 선택 기준" [disabled]
|
|
- option "Fetch Join으로 N+1을 해결하다 만난 MultiBag과 행 폭증"
|
|
- option "Fetch Type과 Fetch Strategy 구분"
|
|
- option "Forward-Auth 구조에서 Application Authorization을 어디까지 Edge에 둘 것인가"
|
|
- option "Forward-Auth에서 Client가 보낸 Identity Header를 신뢰하면 안 되는 이유"
|
|
- option "Forward-Auth에서 Identity Header를 신뢰하기 위한 조건"
|
|
- option "Forward-Auth와 Nginx auth_request의 동작"
|
|
- option "Highlight 없는 FeedItem을 허용할 것인가"
|
|
- option "외부 IdP와의 연동이라도 별도의 인증 방식이 아니다."
|
|
- option "외부 IdP 연동과 Application 인증 구조의 경계"
|
|
- option "외부 IdP Brokering의 동작"
|
|
- option "JPA N+1 정량 진단 기준"
|
|
- option "Keyset Pagination 설계 기준"
|
|
- option "OAuth/OIDC 인증 패턴 선택 기준"
|
|
- option "OAuth Token과 Application Session을 구분하는 기준"
|
|
- option "PostgreSQL Query Plan 측정 기준"
|
|
- option "Projection 이후에도 1,509행을 읽은 Row Over-fetch" [disabled]
|
|
- option "Public Client와 Confidential Client 구분 기준"
|
|
- option "Refresh Token 관리만 서버로 이전, Access Token은 여전히 Browser에 노출"
|
|
- option "Refresh Token Rotation과 다중 Replica 경쟁을 어떻게 처리할 것인가"
|
|
- option "Round Trip과 Row Volume을 독립 측정할 것인가"
|
|
- option "SPA에서 토큰을 직접 관리하면서 드러난 Browser Credential 경계"
|
|
- option "Top-N-per-group 선택 기준"
|
|
- option "Visibility OR이 Keyset Index를 깨뜨린 문제"
|
|
- generic [ref=f65e76]:
|
|
- generic [ref=f65e77]: 근거 3 이유
|
|
- textbox "근거 3 이유" [ref=f65e78]: 이 구현을 감춘 경계다.
|
|
- generic [ref=f65e79]:
|
|
- button "위로" [ref=f65e80]
|
|
- button "아래로" [disabled] [ref=f65e81]
|
|
- button "삭제" [ref=f65e82]
|
|
- button "근거 추가" [ref=f65e83]
|
|
- region [ref=f65e84]:
|
|
- generic [ref=f65e85]:
|
|
- paragraph [ref=f65e86]: PROJECT DECISION
|
|
- heading "프로젝트 결정" [level=2] [ref=f65e87]
|
|
- generic [ref=f65e88]:
|
|
- generic [ref=f65e89]:
|
|
- generic [ref=f65e90]: 결정 상태
|
|
- combobox "결정 상태" [ref=f65e91]:
|
|
- option "아직 정하지 않음"
|
|
- option "PROPOSED"
|
|
- option "ADOPTED" [selected]
|
|
- generic [ref=f65e92]:
|
|
- generic [ref=f65e93]: 결정일
|
|
- textbox "결정일" [ref=f65e94]
|
|
- generic [ref=f65e95]:
|
|
- generic [ref=f65e96]: 결정문
|
|
- textbox "결정문" [ref=f65e97]: 화면 조회 경로에서는 필요한 컬럼만 선택해 캐리어 record로 받는다. 영속 엔티티를 만들지 않는다. 부모와 자식을 각각 스칼라로 조회하고 애플리케이션에서 조립한다. 이 구현은 조회 포트 뒤에 둔다.
|
|
- generic [ref=f65e98]:
|
|
- generic [ref=f65e99]: 판단 이유
|
|
- textbox "판단 이유" [ref=f65e100]: 배치를 적용한 뒤에도 엔티티는 통째로 하이드레이트됐다. 페이지 20건을 조회하는데 부모와 연관을 합해 천 개가 넘는 영속 객체가 올라왔다. 화면에는 일부 컬럼만 필요했다. 캐리어 생성자 표현식은 영속 엔티티 대신 스칼라 값으로 record를 만든다. 1차 캐시, 더티체킹, 지연 프록시가 생기지 않는다. 컬럼을 읽기 위한 조인이 있어도 그 대상 엔티티를 만들지 않는다. 측정에서 하이드레이트한 엔티티가 0이 됐고 발행 쿼리도 데이터 규모와 관계없이 두 개로 고정됐다. 부모 스칼라 쿼리와 자식 IN 쿼리다. 이 효과는 배치 설정 여부와 무관하게 성립한다. 배치는 왕복을 줄이고 프로젝션은 적재를 없앤다. 두 전략은 서로를 대신하지 않는다.
|
|
- group "영향" [ref=f65e101]:
|
|
- paragraph [ref=f65e103]: 아직 입력한 항목이 없습니다.
|
|
- button "영향 추가" [ref=f65e104]
|
|
- region [ref=f65e105]:
|
|
- generic [ref=f65e106]:
|
|
- paragraph [ref=f65e107]: LIVE
|
|
- heading "즉시 미리보기" [level=2] [ref=f65e108]
|
|
- alert [ref=f65e110]:
|
|
- heading "초안을 미리 볼 수 없습니다" [level=2] [ref=f65e111]
|
|
- list [ref=f65e112]:
|
|
- listitem [ref=f65e113]: 1:1 이 Decision 의 공개 주소는 프로젝트 주소 아래에 있습니다. 주제·프로젝트 화면에서 이 프로젝트를 먼저 게시해 주세요.
|
|
- complementary [ref=f65e114]:
|
|
- heading "작업 상태" [level=2] [ref=f65e115]
|
|
- status "편집 상태" [ref=f65e116]: 저장되지 않음
|
|
- generic [ref=f65e117]:
|
|
- generic [ref=f65e118]:
|
|
- term [ref=f65e119]: 저장 버전
|
|
- definition [ref=f65e120]: "1"
|
|
- generic [ref=f65e121]:
|
|
- term [ref=f65e122]: 종류
|
|
- definition [ref=f65e123]: Decision
|
|
- alert [ref=f65e124]: 요청 형식이 올바르지 않습니다
|
|
- generic [ref=f65e125]:
|
|
- button "저장" [ref=f65e126]
|
|
- button "게시" [ref=f65e127]
|
|
- paragraph [ref=f65e128]: 요청 형식이 올바르지 않습니다 |