[feat] 서버가 발급할 App Link 경로·링크 ID·발급 채널을 정한다(또는 쓰지 않기로 정한다) #306

📝 설 명

앱 바깥(푸시, 카카오톡, 메일)에서 앱의 특정 화면으로 들어오게 하는 https 링크(Android App Link)를 서버가 발급할지, 발급한다면 어떤 경로와 ID 를 쓸지 정해진 곳이 없다.

2026-09-30 기준 main(6adc0c4) 상태:

• 서버가 만드는 앱 진입용 링크는 수신자 초대 /invitations/{token} 하나다. 이 경로를 여는 웹 랜딩은 [feat] #227 후속 — 계정 전환 계약에 따른 BE 카카오 신규 가입 단일화 #290 에서 범위 밖으로 뺐다.
• 푸시는 목적지를 URL 이 아니라 data 키로 실을지를 [feat] FCM 푸시 발송 계약 확정 — payload 형태(notification vs data-only)와 목적지 data 키 #261 이 다루는데, [feat] FCM 푸시 발송 계약 확정 — payload 형태(notification vs data-only)와 목적지 data 키 #261 에는 URL 이라는 선택지가 올라가 있지 않다.
• 카카오 초대는 앱 공유 템플릿이 스킴으로 토큰을 넘긴다. 등록 완료·사후 전달 카카오 통지의 발송 주체와 채널은 [chore] #227 후속 — 등록 완료·사후 전달 카카오 통지의 발송 책임과 계약 확정 #291 에서 정하는 중이다.

FE 는 App Link 수신(Afternote/Afternote-FE#924)을 구현했다가 서버에 발급처가 없어 PR 을 머지하지 않고 닫았다. 푸시가 data 키로 가고 카카오가 스킴으로 토큰을 넘기면 https App Link 를 쓸 곳이 없어질 수도 있다. 그 결론도 이 이슈에 남아야 FE 가 수신 코드를 다시 열지 말지 정할 수 있다.

🚀 해야할 일

• 서버가 https App Link 를 발급할지 정한다. 발급하지 않기로 하면 그 결정을 이 이슈에 적고 닫는다.
• 발급한다면 채널별(푸시, 카카오톡, 메일)로 어떤 사건에 어떤 경로를 누구에게 보내는지 정한다.
• 경로에 실리는 ID 가 어느 번호 공간인지(예: timeLetterId 인지 timeLetterReceiverId 인지) 정한다.
• assetlinks.json 을 어느 도메인에서 서빙할지 정한다.
• 정한 내용을 API 명세에 적는다.

참고

• 푸시 목적지 키: [feat] FCM 푸시 발송 계약 확정 — payload 형태(notification vs data-only)와 목적지 data 키 #261
• 카카오 통지 발송 주체: [chore] #227 후속 — 등록 완료·사후 전달 카카오 통지의 발송 책임과 계약 확정 #291
• 웹 랜딩 범위: [feat] #227 후속 — 계정 전환 계약에 따른 BE 카카오 신규 가입 단일화 #290
• 알림을 눌렀을 때 열릴 화면(PM 몫)은 디스코드 질문방 thread 1553358505254060062 에서 묻고 있다.
• FE 수신 구현 보류: feat(platform): App Links URI 계약·인텐트 수신·인증 후 목적지 재개 Afternote-FE#924, PR feat(platform): 검증된 App Link 를 목적지로 받아 관문 뒤에 재개한다 (#924) Afternote-FE#2093(브랜치 feat/924-app-links-receive 보존)