| Screen ID |
Screen Title |
Screen Path |
| NTF-DTL-01 |
알림 상세 |
/notification/{messageId} |
알림센터에서 알림을 클릭했을 때 진입하는 상세 화면. 알림 본문을 HTML로 렌더링하며, 딥링크를 통한 외부 진입도 지원한다. (구 화면 코드: HM_150_Alarm_Detail)
| 요소 |
기준 |
| 헤더 제목 |
알림 상세 고정 |
| 뒤로가기 |
알림센터 화면으로 이동, 알림센터 이전 스크롤 위치 유지 |
| 하드웨어 뒤로가기 |
헤더 뒤로가기와 동일 동작 |
| 공유 버튼 |
현재 알림 상세 URL 공유 (https://worksout.com/notification/{messageId}) |
딥링크 처리
| 상태 |
처리 |
| 앱 설치된 경우 |
해당 알림 상세 화면으로 이동 |
| 앱 미설치된 경우 |
앱 다운로드 페이지로 이동 |
| 항목 |
기준 |
| 제목 |
API 응답 title 표시 |
| 날짜 |
API 응답 createdTs → YYYY.MM.DD 형식으로 변환 표시 |
| 레이아웃 |
제목과 날짜 한 줄 표시 |
| 본문 |
API 응답 contents를 HTML로 렌더링 (이미지, 링크 등 지원) |
| 스크롤 |
세로 스크롤만 지원, 화면 전환 후 복귀 시 스크롤 위치 유지 |
| 상태 |
처리 |
| 초기 로딩 |
화면 전체 로딩바 표시 |
| 존재하지 않는 알림 |
컨텐츠에 접근할 수 없습니다 메시지, 뒤로가기만 가능 |
| 네트워크 오류 |
컨텐츠에 접근할 수 없습니다 메시지 + 다시 시도 버튼 |
빈 컨텐츠 (contents null 또는 빈값) |
표시할 내용이 없습니다 메시지 |
- 엔드포인트:
GET /v1/notification/{messageId}
- 호출 시점: 알림 상세 화면 진입 시
- 활용 필드:
title(알림 제목 표시), createdTs(날짜 표시, YYYY.MM.DD 형식으로 변환), contents(HTML 본문 렌더링)
| 증상 |
예상 원인 |
1차 조치 |
| 본문 미노출 |
API 실패 / contents null |
API 응답과 contents 값 확인 |
| HTML 렌더링 깨짐 |
HTML 파싱 오류 / 외부 리소스 차단 |
contents 저장값과 렌더러 로그 확인 |
| 딥링크 진입 실패 |
messageId 오류 / 앱 미설치 |
URL 파라미터와 앱 설치 여부 확인 |
| 공유 URL 오류 |
URL 생성 실패 |
messageId 존재 여부 확인 |
| 케이스 |
동작 |
| 딥링크로 앱 설치된 상태에서 진입 |
해당 알림 상세 화면으로 바로 이동 |
| 딥링크로 앱 미설치 상태에서 진입 |
앱 다운로드 페이지로 이동 |
존재하지 않는 messageId로 진입 |
컨텐츠에 접근할 수 없습니다 메시지, 뒤로가기만 가능 |
contents가 빈값인 알림 진입 |
표시할 내용이 없습니다 메시지 표시 |
| 항목 |
내용 |
| 없음 |
마스터 문서(알림 상세)와 정책 문서 간 충돌 항목 없음. 알림 상세 화면은 정책 문서에 별도 섹션이 없어 마스터 문서 내용만으로 구성됨 |