enhancement(core): 수신자 App Link 식별자·인증 관문 계약을 공통 URI 파서에서 분리한다 #1951

Activity

1. github-actions

   added

   enhancementNew feature or requestNew feature or request

   area:core공용 코어·네트워크 기능 영역공용 코어·네트워크 기능 영역

   on Sep 7, 2026
2. github-actions

   assigned

   OnlyReadOneBook

   on Sep 7, 2026
3. OnlyReadOneBook

   added a parent issue on Sep 7, 2026

   • feat(core): App Link URI 계약과 엔진 중립 목적지 파서를 세운다 #1857
4. OnlyReadOneBook

   marked this as blocked by 2 issues on Sep 7, 2026

   • security(receiver): 기록함 접근 자격·마스터키 비노출 서버 계약을 확정하고 검증한다 #1949
   • security(receiver): 다중 수신자 컨텍스트·키 보관 정책을 서버 기록함 기준으로 분리 확정한다 #1950
5. OnlyReadOneBook

   marked this as blocking 2 issues on Sep 7, 2026

   • feat(core): App Link URI 계약과 엔진 중립 목적지 파서를 세운다 #1857
   • feat(platform): App Links URI 계약·인텐트 수신·인증 후 목적지 재개 #924
6. OnlyReadOneBook

   unmarked this as blocking 2 issues on Sep 12, 2026

   • feat(core): App Link URI 계약과 엔진 중립 목적지 파서를 세운다 #1857
   • feat(platform): App Links URI 계약·인텐트 수신·인증 후 목적지 재개 #924
7. OnlyReadOneBook commented on Sep 13, 2026

   

   OnlyReadOneBook

   on Sep 13, 2026

   CollaboratorAuthor

   More actions

   착수 전 점검: 본문이 딛고 선 PR #1859 가 닫혔다. 지금은 코드로 뗄 조각이 없다

   기준 리비전은 origin/develop 7d87aa3f4 이고, 관계는 GraphQL 의존성으로 직접 조회했습니다(2026-09-13).

   1. 본문 전제 두 줄이 깨졌다

   본문(2026-09-08)은 "#1857은 공통 파서·비수신자 6개 목적지만 소유하며 독립 완료한다", "확정 후 #1859의 공통 입력 검증을 재사용한다" 로 적혀 있습니다. 둘 다 지금은 성립하지 않습니다.

   • PR feat(core): 공통 URI 검증과 비수신자 App Link 계약을 세운다 (#1857) #1859 는 병합되지 않고 닫혔습니다(mergedAt null, closedAt 2026-09-11T07:08:33Z). Sadturtleman 승인(2026-09-04)까지 받은 상태였습니다.
   • feat(core): App Link URI 계약과 엔진 중립 목적지 파서를 세운다 #1857 도 같은 날 닫혔는데(2026-09-11T07:07:09Z), 마지막 완료 조건 - [ ] PR #1859 병합. 은 체크되지 않은 채입니다. 독립 완료가 아니라 feat(platform): App Links URI 계약·인텐트 수신·인증 후 목적지 재개 #924 로 흡수되며 닫힌 것입니다.

   따라서 이 이슈가 재사용하려던 "#1859의 공통 입력 검증" 은 develop 에 존재하지 않는 코드입니다.

   2. develop 에는 붙일 자리가 없다. 파서는 브랜치에만 있다

   origin/develop 에 딥링크 코드가 0줄입니다.

   $ git ls-tree -r origin/develop -- core/common/src/main/kotlin/com/afternote/core/common/deeplink
   (빈 출력)
   $ git grep -l NavigationTarget origin/develop
   (0건)
   

   파서 일체는 origin/feat/924-app-links (54b322a4) 에만 있습니다. 프로덕션 5파일 311줄, 테스트 2파일 299줄입니다.

   파일	줄
   core/common/.../deeplink/AfternoteAppLinkParser.kt	162
   core/common/.../deeplink/NavigationTarget.kt	60
   core/common/.../deeplink/AppLinkRejectionReason.kt	39
   core/common/.../deeplink/AppLinkResolution.kt	31
   core/common/.../deeplink/AuthGate.kt	19
   core/common/src/test/.../deeplink/AfternoteAppLinkParserTest.kt	200
   core/common/src/test/.../deeplink/NavigationTargetContractTest.kt	99

   이 이슈가 맡은 수신자 목적지와 거부 회귀 테스트는 #1859 위가 아니라 #924 의 PR 안에, 또는 그 뒤에 붙습니다. 지금 develop 에서 시작하면 파서부터 다시 세우게 되는데, 그건 #1859 가 이미 한 일입니다.

   3. 닫은 사유가 그대로 이 이슈의 판정 근거다

   #1859 드래프트 전환 코멘트에 적은 사유는 이렇습니다.

   이 파서를 호출하는 소비처가 아직 하나도 없다. MainActivity 인텐트 필터(#924), 알림 목적지 배선(#1111), 서버 FCM 링크 계약 모두 미착수라, 여기서 고정한 정규 URL 규칙과 거절 사유가 실제 발송 링크와 맞는지 검증할 길이 없다.

   닫음 코멘트는 "파서 단독으로는 머지하지 않기로 했으니 열어 둘 이유가 없다" 입니다. #924·#1111 은 지금도 열려 있습니다. 여기서 수신자 목적지를 먼저 만들면 이틀 전 결정을 그대로 뒤집는 것이 됩니다.

   4. 로컬 UUID 를 고정하면 안 되는 이유는 코드에 남아 있다

   지금 /received/senders/{senderId} 를 확정하면 그 senderId 는 SenderRegistry.kt:37 의 UUID.randomUUID() 입니다. @Singleton(23) + MutableStateFlow(27) 로 프로세스 메모리에만 사는 stub 이고, ReceiverRoute.kt:41-42 KDoc 도 "로컬 식별자" 라고 못박아 두었습니다. 앱 재시작이면 사라지는 값이라 외부 링크 식별자로 쓸 수 없습니다. #1949 가 record-boxes 의 서버 식별자를 확정하는 순간 전부 다시 고쳐야 합니다.

   5. 남은 것과 풀려야 할 것

   열린 PR 62건의 파일 목록을 전량 확인했습니다. deeplink·App Link·NavigationTarget 경로를 건드리는 PR 은 0건입니다. 담당자나 스택 충돌 때문이 아니라, 계약 미확정과 소비처 부재로만 막혀 있습니다.

   풀려야 하는 순서는 조회한 의존성 그대로입니다.

   • [fix] 받은 기록함 목록 응답에 다른 발신자의 마스터 키가 포함됨 Afternote-BE#93 (OPEN) → security(receiver): 기록함 접근 자격·마스터키 비노출 서버 계약을 확정하고 검증한다 #1949 (OPEN)
   • security(receiver): 기록함 접근 자격·마스터키 비노출 서버 계약을 확정하고 검증한다 #1949 → security(receiver): 다중 수신자 컨텍스트·키 보관 정책을 서버 기록함 기준으로 분리 확정한다 #1950 (OPEN)
   • security(receiver): 기록함 접근 자격·마스터키 비노출 서버 계약을 확정하고 검증한다 #1949·security(receiver): 다중 수신자 컨텍스트·키 보관 정책을 서버 기록함 기준으로 분리 확정한다 #1950 → 이 이슈

   그래서 다음 착수자가 볼 것은 세 가지입니다. 첫째, 파서는 새로 쓰지 말고 origin/feat/924-app-links 에서 가져옵니다. 둘째, 이 이슈의 산출물은 #924 의 PR 단위 안에 들어가야 합니다. 링크를 눌러 화면이 열리는 데까지가 머지 단위입니다. 셋째, 서버 식별자는 #1949 가 확정하기 전에는 무엇으로도 고정하지 않습니다.

   본문·라벨·상태는 그대로 둡니다.
8. OnlyReadOneBook commented on Sep 19, 2026

   

   OnlyReadOneBook

   on Sep 19, 2026

   CollaboratorAuthor

   More actions

   2026-09-19 정리로 닫는다. 이 이슈의 완료 조건은 PM의 결정에 달려 있어 결정 전에는 FE 가 무엇을 만들지 쓸 수 없다. 그런 이슈는 FE 저장소에 열어 두지 않고 결정이 나면 그때 새 이슈로 다시 연다.

   기다리는 결정: 기록함 권한·컨텍스트(#1949·#1950).

   PM 질문은 창구가 정해지는 대로 보낸다(일혁이 목록 보관).
9. OnlyReadOneBook

   closed this as completedon Sep 19, 2026