enhancement(afternote): 애프터노트 상세를 App Link 목적지로 연다 #2088

작업 유형

enhancement — 신규 기능·기존 기능 개선

주 담당 모듈

afternote — 애프터노트

개요

무엇을

App Link 계약에 애프터노트 상세 /afternote/{id} 를 더하고, 브라우저에서 온 그 링크가 지문 관문 뒤 상세 화면에 서게 한다.

왜 지금은 없나

#924 가 세우는 계약은 목적지 다섯 개만 받는다. 상세는 계약에서 뺐고 intent-filter 에서도 그 경로를 잡지 않으며, 파서 테스트가 그 상태를 못으로 박았다. AfternoteAppLinkParserTest 의 "애프터노트 상세 경로는 아직 목적지가 아니다" 가 /afternote/42 를 AppLinkRejectionReason.UNKNOWN_PATH 거절로 고정한다. 도착할 자리가 없는 경로를 계약에만 실으면 링크가 앱을 열고 홈으로 떨어지는 반쪽 활성화가 되는데, #924 본문이 그것을 머지하지 말라고 못 박아 뒀다.

자리가 없는 이유는 애프터노트 피처의 로컬 Navigation 3 스택이다. AfternoteNavHost 가 rememberNavBackStack(AfternoteRoute.FingerprintLoginRoute) 로 스택 바닥을 지문 관문에 고정하고, 밖에서 상세를 지목해 넣을 인자가 없다. 그 파일을 고쳐야 자리가 열린다.

해야 할 것

1. AfternoteNavHost 가 초기 엔트리를 받는다. 바닥이 지문 관문이라는 성질은 유지하고, 관문을 지난 뒤 상세가 그 위에 얹히게 한다. 관문을 건너뛰는 경로를 새로 만들지 않는다.
2. NavigationTarget 에 상세 목적지를 더한다. requiredGates 는 LOGIN 과 BIOMETRIC 이고, 정규 경로는 /afternote/{id}, ID 형식은 타임레터 상세와 같은 양의 10진 정수다.
3. 파서 계약 표에 그 행을 더하고, 지금 거절을 고정한 테스트를 해석되는 쪽으로 뒤집는다. 잘못된 ID 거절은 타임레터 상세와 같은 기준으로 남긴다.
4. manifest intent-filter 에 pathPrefix="/afternote/" 를 더한다. 기존 path="/afternote" 와 겹치지 않는다. 한 요소에 속성을 묶지 않는 규칙(IntentFilterUniqueDataAttributes)을 지킨다.
5. 앱 루트의 navigator adapter(AppState.navigateToAppLinkTarget)가 그 목적지를 배선한다. 애프터노트 탭은 navigateToBottomBarRoute 가 restoreState 를 끄는 유일한 라우트다. 저장된 스택으로 복원되어 지문 관문을 건너뛰는 일이 없어야 한다는 이 성질을 깨지 않는다.

순서 제약

AfternoteNavHost 를 열린 PR 세 건이 물고 있다. #2021(#1968), #2001(#1999), #1962(#1695). #924 가 이 목적지를 범위에서 뺀 이유 절반이 그것이다. 셋의 이슈를 blocked_by 로 걸어 둔다.

완료 조건

1. /afternote/{id} 가 목적지로 해석되고, ID 형식 거절과 정규 URL 왕복이 단위 테스트에 있다.
2. 지문 관문을 통과한 뒤에만 상세가 열린다. 관문 앞에서는 목적지를 들고 대기했다가 통과 후 한 번만 재개한다.
3. 링크로 들어온 애프터노트 탭이 저장된 스택을 복원해 관문을 건너뛰지 않는다. 이 성질을 고정하는 테스트가 있다.
4. 브라우저에서 https://afternote.kro.kr/afternote/{id} 가 선택창 없이 앱을 열고 상세에 선다. 실측 기준은 test(platform): App Link https 진입과 Digital Asset Links 검증을 실기기에서 확인한다 #2087 과 같다.

자식 이슈

No response

참고

• 계약과 intent 수신, 관문 뒤 재개는 feat(platform): App Links URI 계약·인텐트 수신·인증 후 목적지 재개 #924 가 세운다. 상세를 뺀 근거는 NavigationTarget KDoc 의 "여기 없는 목적지" 절에 있다.
• 앱 루트 NavDisplay 교체는 refactor(platform): 앱 루트를 Navigation 3 NavDisplay로 전환 #1702 다. 이 이슈는 그 전환과 독립이다. 계약은 엔진 중립이고 갈리는 것은 배선 한 곳이다.
• 수신자 경로의 식별자·관문 계약은 enhancement(core): 수신자 App Link 식별자·인증 관문 계약을 공통 URI 파서에서 분리한다 #1951 이 따로 갖는다.