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

작업 유형

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

주 담당 모듈

core — 코어

개요

#924에서 엔진 중립 공통 URI 파서와 비수신자 목적지 계약을 분리한다. Android intent 수신과 인증 후 재개는 #924, 수신자 경로·서버 식별자·접근 관문은 #1951이 각각 소유한다. 이 이슈는 #1951 없이 독립적으로 완료할 수 있다.

현재 범위

• https://afternote.kro.kr의 scheme·host·포트·userinfo·query·fragment·정규 path 검증.
• Home(/), 작성자 애프터노트 홈·상세(/afternote, /afternote/{id}), 타임레터 상세(/timeletter/{id}), 데일리질문 작성(/mindrecord/daily-question), 알림 설정(/settings/notification) 6개 목적지.
• 양의 ASCII 10진 정수 ID, 정규 URL 왕복, 로그인·작성자 생체인증 관문 계약.
• 허용하지 않은 경로와 잘못된 입력을 안전한 기본 진입 및 고정된 거절 사유로 반환한다.
• Nav2/Nav3 및 Android Intent 타입과 결합하지 않는다.

분리된 수신자 계약

/received, /received/senders/{senderId}, /received/afternote/{id}는 #1951에서 최종 서버 식별자·관문을 확정한 뒤 구현한다. PR #1859에서 관련 목적지/UUID 정규식/RECEIVER_IDENTITY/성공 계약 테스트를 실제로 제거했다. 현재는 이 경로를 지원 목적지로 선언하지 않고 거절하며, 이 거절 회귀를 검증한다. 미래 계약을 로컬 SenderRegistry UUID로 미리 고정하지 않는다.

완료 조건

• 현재 6개 목적지의 parsing·ID validation·관문 판정과 정규 URL 왕복 검증.
• 미지원 경로·잘못된 ID·query 등 거절 사유 검증.
• 수신자 미확정 계약이 현재 코드·문서·성공 테스트에 포함되지 않음.
• core common 테스트 65개, konsist 54개 및 core common ktlintCheck 통과(최신 develop 통합 기준).
• PR feat(core): 공통 URI 검증과 비수신자 App Link 계약을 세운다 (#1857) #1859 병합.

참고

• 구현: feat(core): 공통 URI 검증과 비수신자 App Link 계약을 세운다 (#1857) #1859. 수신자 후속: enhancement(core): 수신자 App Link 식별자·인증 관문 계약을 공통 URI 파서에서 분리한다 #1951. 최종 intent 수신·인증 후 재개: feat(platform): App Links URI 계약·인텐트 수신·인증 후 목적지 재개 #924.
• Digital Asset Links 인프라: [fix] assetlinks.json 패키지명 불일치 — 패스키 검증 불가 + 앱링크 relation 부재 Afternote-BE#228.
• #1951은 이 이슈의 완료 조건이나 blocked_by가 아니다.