Repository navigation
Shortlink Usecase
| 누구 | 무엇을 하나 | |
|---|---|---|
| 발급자 | 사용자 본인(1인) | 로그인해서 링크를 만들고 관리한다 |
| 방문자 | 가족 · 동행 · 동호회 · 나 자신(다른 기기) | 계정이 없다. 짧은 주소를 열 뿐이다 |
| 프리뷰 봇 | 카카오톡 · 슬랙 · 디스코드 등 | 사람보다 먼저 링크를 연다. 통계에서 분리된다(명세 §8.2) |
이 모듈이 존재하는 이유다.
8월 3일, 부모님께 일상기록 사진을 보냈다. MinIO presigned URL이라 주소가 길고
X-Amz-Signature가 붙어 있다. 카카오톡에 붙이니 두 줄이 넘는다. 8월 14일, 어머니가 "사진이 안 열린다"고 한다. 서명이 만료됐다. 새 URL을 뽑아 다시 보내야 하는데, 이미 보낸 메시지의 링크는 죽은 채로 대화창에 남는다.
단축 링크가 있었다면:
- 8/3 — presigned URL을 빠른 발급 바에 붙여넣고 Enter →
s.orino.dev/9dwqr가 클립보드에 복사됨 → 카카오톡에 붙여넣어 전송 - 8/14 —
/links/9dwqr→목적지 수정→ 새 presigned URL 붙여넣고 사유서명 만료로 재발급 - 부모님은 아무것도 안 한다. 대화창의 그 링크를 다시 누르면 열린다
- 상세 화면 하단에 이력 두 줄이 남는다 —
2026.08.14 — 서명 만료로 재발급/2026.08.03 — 최초 발급
관련: SL-001 · SL-002 · SL-008 · SL-013
카페에서 지도 앱의 좌표 링크를 동행에게 보내려는데, 주소가 길어서 메시지가 지저분해진다.
- 폰에서 orino → 사이드바 전환
링크(또는/select→ 링크 카드) - 제목 바로 아래 상주하는 입력창에 붙여넣기
- Enter — 발급 + 클립보드 자동 복사 + 토스트
복사했어요 - 앱을 나가 카카오톡에 붙여넣는다
모달을 열지 않는다. 메모도 태그도 나중에 붙일 수 있다. 이 흐름이 3초를 넘기면 사람은 다음부터 그냥 긴 URL을 보낸다(명세 §4.1·§5.4).
관련: SL-002 · SL-020
동호회 공지를 뿌리는데, 나중에 회수할 수 있어야 하고 어디서 눌렸는지도 보고 싶다.
-
새 링크버튼 → 모달 - 목적지 URL 입력 → 라벨 옆에
s.orino.dev/ab3k9+17자칩이 실시간으로 뜬다(명세 §3을 화면이 계속 상기시킨다) - OG 프리뷰가 뒤따라 채워진다. 안 떠도
만들기는 눌린다(명세 §4.4) - (선택) 커스텀 슬러그 · 만료 · 메모 · 태그 · 비밀번호
-
만들기→ 같은 모달이 성공 화면으로 바뀐다: 성공 칩 · 짧은 주소 크게 · QR ·QR 저장/완료 - 보조 문구 —
목적지는 나중에 바꿔도 이 주소는 그대로예요.(UC-01로 이어지는 안내)
관련: SL-003 · SL-005 · SL-006 · SL-007 · SL-014 · SL-018
동호회 공지가 바뀌어서 예전 링크를 잠깐 막아야 한다.
-
/links→ 검색창에 메모 일부 입력 → 해당 행 - 더보기(
Ellipsis) →비활성 - 행이 흐려지고
꺼짐배지, QR 버튼이 사라진다 - 그 사이 방문자는 404 한 장만 본다 — 없는 주소인지 꺼진 주소인지 알 수 없다(명세 §7)
- 공지가 확정되면 다시
활성
삭제는 다르다. 삭제하면 목록에서 사라지고 슬러그는 영구 점유되어 다시는 발급되지 않는다(명세 §3.1).
관련: SL-009 · SL-010 · SL-012 · SL-021
부모님께 보낸 사진 링크를 진짜 여셨는지 궁금하다.
-
/links행 클릭 →/links/9dwqr - 총 방문
142· 최근 7일23· 마지막 방문3일 전 - 옆에
봇·프리뷰 18건은 따로 셉니다 — 통계는 참고치— 142에 봇은 안 들어 있다(명세 §8.2) - 최근 30일 일별 막대에서 보낸 다음 날 솟은 것이 보인다
- 유입 경로
카카오톡 88— 예상대로 왔다 - 기기·국가 아래 한 줄 —
국가만 봅니다. IP는 저장하지 않아요.
관련: SL-015 · SL-016 · SL-017 · SL-019
계정도 앱도 없는 사람의 경로다. orino의 유일한 공개 표면.
카카오톡의 s.orino.dev/9dwqr 탭
→ (프리뷰 봇이 먼저 열었을 수 있다 — 봇 통계로만 셈)
→ 302 + Cache-Control: no-store
→ presigned URL로 이동, 사진이 열린다
- 로그인 화면을 보지 않는다. orino가 무엇인지도 알 필요 없다
- 살아 있지 않으면(없음·꺼짐·만료·삭제) 전부 같은 화면, 같은 404
- 비밀번호 링크면 확인 화면을 한 번 거친다 — 이 경우에만 "존재한다"가 드러난다(명세 §10)
관련: SL-013 · SL-021 · SL-014
로그인
└─ /select ── 여행 ── (기존)
│ 일상 ── (기존)
└─────── 링크 ──▶ /links ─┬─ 빠른 발급 바(상주) ──▶ 발급 + 클립보드 복사
├─ 새 링크 ──▶ 모달 ──▶ 발급 직후(QR)
├─ 검색 · 상태 칩 · 태그(사이드바)
└─ 행 클릭 ──▶ /links/{slug}
├─ 목적지 수정 ──▶ 이력 추가
├─ QR / PNG 저장
└─ 통계(방문 · 유입 · 기기 · 국가)
[비로그인] s.orino.dev/{slug} ──▶ 302 목적지
└──▶ 404 한 장 (없음 · 꺼짐 · 만료 · 삭제 공통)
└──▶ 비밀번호 확인 화면 ──▶ 302
- 남이 내 orino에 링크를 만든다 — 발급자는 1인이다
- 방문자가 링크에 반응한다(댓글·좋아요) — 표면을 늘리지 않는다
- 링크를 폴더로 정리한다 — 태그로 충분하다
- 통계를 내보낸다(CSV) — 필요가 확인되면 그때