Skip to content

Shortlink Usecase

wcorn edited this page Aug 22, 2026 · 1 revision

유스케이스: 단축 URL (링크)

확정 명세 · 아키텍처 · 데이터 모델 · API · 화면

0. 등장인물

누구 무엇을 하나
발급자 사용자 본인(1인) 로그인해서 링크를 만들고 관리한다
방문자 가족 · 동행 · 동호회 · 나 자신(다른 기기) 계정이 없다. 짧은 주소를 열 뿐이다
프리뷰 봇 카카오톡 · 슬랙 · 디스코드 등 사람보다 먼저 링크를 연다. 통계에서 분리된다(명세 §8.2)

1. UC-01 — 죽은 링크를 되살린다 (핵심)

이 모듈이 존재하는 이유다.

8월 3일, 부모님께 일상기록 사진을 보냈다. MinIO presigned URL이라 주소가 길고 X-Amz-Signature가 붙어 있다. 카카오톡에 붙이니 두 줄이 넘는다. 8월 14일, 어머니가 "사진이 안 열린다"고 한다. 서명이 만료됐다. 새 URL을 뽑아 다시 보내야 하는데, 이미 보낸 메시지의 링크는 죽은 채로 대화창에 남는다.

단축 링크가 있었다면:

  1. 8/3 — presigned URL을 빠른 발급 바에 붙여넣고 Enter → s.orino.dev/9dwqr가 클립보드에 복사됨 → 카카오톡에 붙여넣어 전송
  2. 8/14 — /links/9dwqr → 목적지 수정 → 새 presigned URL 붙여넣고 사유 서명 만료로 재발급
  3. 부모님은 아무것도 안 한다. 대화창의 그 링크를 다시 누르면 열린다
  4. 상세 화면 하단에 이력 두 줄이 남는다 — 2026.08.14 — 서명 만료로 재발급 / 2026.08.03 — 최초 발급

관련: SL-001 · SL-002 · SL-008 · SL-013

2. UC-02 — 폰에서 3초 안에 발급한다

카페에서 지도 앱의 좌표 링크를 동행에게 보내려는데, 주소가 길어서 메시지가 지저분해진다.

  1. 폰에서 orino → 사이드바 전환 링크 (또는 /select → 링크 카드)
  2. 제목 바로 아래 상주하는 입력창에 붙여넣기
  3. Enter — 발급 + 클립보드 자동 복사 + 토스트 복사했어요
  4. 앱을 나가 카카오톡에 붙여넣는다

모달을 열지 않는다. 메모도 태그도 나중에 붙일 수 있다. 이 흐름이 3초를 넘기면 사람은 다음부터 그냥 긴 URL을 보낸다(명세 §4.1·§5.4).

관련: SL-002 · SL-020

3. UC-03 — 옵션을 붙여 발급한다

동호회 공지를 뿌리는데, 나중에 회수할 수 있어야 하고 어디서 눌렸는지도 보고 싶다.

  1. 새 링크 버튼 → 모달
  2. 목적지 URL 입력 → 라벨 옆에 s.orino.dev/ab3k9 + 17자 칩이 실시간으로 뜬다(명세 §3을 화면이 계속 상기시킨다)
  3. OG 프리뷰가 뒤따라 채워진다. 안 떠도 만들기는 눌린다(명세 §4.4)
  4. (선택) 커스텀 슬러그 · 만료 · 메모 · 태그 · 비밀번호
  5. 만들기 → 같은 모달이 성공 화면으로 바뀐다: 성공 칩 · 짧은 주소 크게 · QR · QR 저장 / 완료
  6. 보조 문구 — 목적지는 나중에 바꿔도 이 주소는 그대로예요. (UC-01로 이어지는 안내)

관련: SL-003 · SL-005 · SL-006 · SL-007 · SL-014 · SL-018

4. UC-04 — 뿌린 주소를 회수한다

동호회 공지가 바뀌어서 예전 링크를 잠깐 막아야 한다.

  1. /links → 검색창에 메모 일부 입력 → 해당 행
  2. 더보기(Ellipsis) → 비활성
  3. 행이 흐려지고 꺼짐 배지, QR 버튼이 사라진다
  4. 그 사이 방문자는 404 한 장만 본다 — 없는 주소인지 꺼진 주소인지 알 수 없다(명세 §7)
  5. 공지가 확정되면 다시 활성

삭제는 다르다. 삭제하면 목록에서 사라지고 슬러그는 영구 점유되어 다시는 발급되지 않는다(명세 §3.1).

관련: SL-009 · SL-010 · SL-012 · SL-021

5. UC-05 — 이 링크가 실제로 쓰였나 본다

부모님께 보낸 사진 링크를 진짜 여셨는지 궁금하다.

  1. /links 행 클릭 → /links/9dwqr
  2. 총 방문 142 · 최근 7일 23 · 마지막 방문 3일 전
  3. 옆에 봇·프리뷰 18건은 따로 셉니다 — 통계는 참고치 — 142에 봇은 안 들어 있다(명세 §8.2)
  4. 최근 30일 일별 막대에서 보낸 다음 날 솟은 것이 보인다
  5. 유입 경로 카카오톡 88 — 예상대로 왔다
  6. 기기·국가 아래 한 줄 — 국가만 봅니다. IP는 저장하지 않아요.

관련: SL-015 · SL-016 · SL-017 · SL-019

6. UC-06 — 방문자가 링크를 연다 (비로그인)

계정도 앱도 없는 사람의 경로다. orino의 유일한 공개 표면.

카카오톡의 s.orino.dev/9dwqr 탭
   → (프리뷰 봇이 먼저 열었을 수 있다 — 봇 통계로만 셈)
   → 302 + Cache-Control: no-store
   → presigned URL로 이동, 사진이 열린다
  • 로그인 화면을 보지 않는다. orino가 무엇인지도 알 필요 없다
  • 살아 있지 않으면(없음·꺼짐·만료·삭제) 전부 같은 화면, 같은 404
  • 비밀번호 링크면 확인 화면을 한 번 거친다 — 이 경우에만 "존재한다"가 드러난다(명세 §10)

관련: SL-013 · SL-021 · SL-014

7. 화면 흐름

로그인
  └─ /select ── 여행 ── (기존)
       │        일상 ── (기존)
       └───────  링크 ──▶ /links ─┬─ 빠른 발급 바(상주) ──▶ 발급 + 클립보드 복사
                                  ├─ 새 링크 ──▶ 모달 ──▶ 발급 직후(QR)
                                  ├─ 검색 · 상태 칩 · 태그(사이드바)
                                  └─ 행 클릭 ──▶ /links/{slug}
                                                   ├─ 목적지 수정 ──▶ 이력 추가
                                                   ├─ QR / PNG 저장
                                                   └─ 통계(방문 · 유입 · 기기 · 국가)

[비로그인]  s.orino.dev/{slug} ──▶ 302 목적지
                               └──▶ 404 한 장  (없음 · 꺼짐 · 만료 · 삭제 공통)
                               └──▶ 비밀번호 확인 화면 ──▶ 302

8. 이 모듈이 다루지 않는 흐름

  • 남이 내 orino에 링크를 만든다 — 발급자는 1인이다
  • 방문자가 링크에 반응한다(댓글·좋아요) — 표면을 늘리지 않는다
  • 링크를 폴더로 정리한다 — 태그로 충분하다
  • 통계를 내보낸다(CSV) — 필요가 확인되면 그때

Clone this wiki locally