SYSTEM BLUEPRINT

악보 수집부터
다운로드까지의 흐름

상품 등록은 매일 자동으로,
결제 후 다운로드는 안전하게.

스토리보드란?

스토리보드는 만들 화면과 사용 흐름을 미리 살펴보는 문서입니다. 아래 화면은 공고 내용을 바탕으로 한 사전 설계 예시이며, 고객 쇼핑몰 화면은 기존 카페24 그대로 둡니다.

  1. 운영 담당자는 한 화면에서 신규 출판사 4곳의 수집·등록·주문·다운로드를 확인합니다.
  2. 구매 고객은 결제 후 워터마크가 들어간 악보를 기간·횟수 제한 링크로 받습니다.

마지막까지 보시면 카탈로그가 상품이 되고, 결제가 다운로드로 이어지는 모습을 확인하실 수 있습니다.

운영 담당자 시나리오

출판사 시스템을 따로 보지 않는 운영

수집·등록·주문·다운로드를 한 관리 화면에서 확인합니다.

자동 수집

매일 정해진 시각
카탈로그 수집

상품 검수

원화 가격 확인 후
카페24 공개

결제 처리

결제 즉시
다운로드 권한

실패 알림

재시도 후에도 실패면
담당자 알림

현황 확인

판매·다운로드를
한 화면에서

운영 담당자 | 화면 01

연동 현황 대시보드

연동 관리 · 사전 설계 예시
디지털 악보 연동 관리 운영 담당자 · 2026.09.23 (수) 설명용 예시
연동 현황
신규 출판사 4곳의 수집·판매·다운로드를 기존 관리자페이지와 같은 기준으로 봅니다.
오늘 판매
37건
다운로드 완료
35건
확인 필요
2건
출판사 A정상
FTP CSV · 마지막 수집 06:10
상품 8,412개오늘 판매 14건
출판사 B정상
FTP XML · 마지막 수집 04:32
상품 5,907개오늘 판매 9건
출판사 C재시도 중
REST API · 마지막 수집 06:45
상품 3,260개오늘 판매 8건
출판사 D확인 필요
자체 파일 · 마지막 수집 수동
상품 1,038개오늘 판매 6건
최근 알림
시각내용상태
08:02출판사 D 주문 #20260923-0417 다운로드 링크 발급 실패 → 재시도 2회 후 알림담당자 확인
06:47출판사 C 3페이지 응답 지연 → 증분 동기화 자동 재시도재시도 중
06:12출판사 A 신규 124건 수집, 카페24 등록 대기처리 완료

[화면 개요 및 목적]

담당자가 출판사 시스템을 따로 열지 않고 신규 4곳의 수집·판매·다운로드 상태를 봅니다. 제안서의 “조용한 실패를 먼저 알림”을 보여줍니다.

[핵심 기능 로직]

출판사별 마지막 수집 시각과 상태를 색으로 구분합니다. 재시도 후에도 실패하면 담당자와 개발 담당에게 동시에 알립니다. 데모 4단계에서 알림을 확인합니다.

  • 한눈에 보는 운영 상태
    PostgreSQL 집계 · 기존 관리자 DB 적재
  • 실패를 먼저 알림
    실행 기록 · 메일/메신저 알림
운영 담당자 | 화면 02

상품 수집·등록 검수

연동 관리 · 사전 설계 예시
디지털 악보 연동 관리 운영 담당자 · 2026.09.23 (수) 설명용 예시
상품 수집·등록 검수
수집한 카탈로그를 공통 형식으로 맞춘 결과입니다. 확인 후 카페24에 공개합니다.
출판사 A · CSV 피드
출판사 B · XML 피드
출판사 C · REST API
출판사 D · 자체 파일
이번 수집 신규
124건
가격 변경
38건
형식 오류
3건
품번곡명 · 작곡가원가 → 판매가카페24 상태
HN-1452Nocturnes Op.9 · Chopin€ 4.99 → 7,900원등록 완료
HN-1461Sonate D 959 · Schubert€ 6.50 → 9,900원진열 안 함
HN-1503Kinderszenen Op.15 · Schumann€ 3.99 → 6,500원검수 대기
HN-1519Partita No.2 BWV 826 · Bach가격 누락형식 오류
환율 1 EUR = 1,468원 · 매일 09:00 갱신 · 100원 단위 올림

[화면 개요 및 목적]

CSV·XML·API·자체 파일로 들어온 카탈로그가 같은 형식으로 정리되어 카페24 상품이 되는 과정입니다. 제안서의 “검수 후 공개” 설계를 보여줍니다.

[핵심 기능 로직]

품번·곡명·가격을 공통 형식으로 맞추고 외화 가격을 매일 갱신 환율로 원화 환산합니다. 새 상품은 진열 안 함으로 등록해 확인 후 공개합니다. 데모 1단계에서 체험합니다.

  • 상품 수작업 등록 제거
    Python 수집기 · CSV/XML/JSON 파싱
  • 공식 방식으로 상품 등록
    카페24 Admin API · OAuth 인증
운영 담당자 | 화면 03

주문·다운로드 처리

연동 관리 · 사전 설계 예시
디지털 악보 연동 관리 운영 담당자 · 2026.09.23 (수) 설명용 예시
주문·다운로드 처리
카페24 결제·환불 이벤트를 받아 주문 한 건당 한 번만 처리합니다.
오늘 주문
주문번호출판사상태
0923-0421A다운로드 완료
0923-0417D재시도 중
0923-0409B권한 부여
0922-0388C환불 회수
0922-0371A다운로드 완료
주문 20260923-0417재시도 중
김*준 · 출판사 D · Préludes Livre 1 · 12,900원
결제 완료
카페24 주문 이벤트 수신
07:58
다운로드 권한 부여
만료 7일 · 5회 제한
07:58
워터마크 PDF 생성
구매자 정보 새김 → 1차 실패
07:59
자동 재시도
2회차 진행, 실패 시 담당자 알림
08:02
다운로드 링크 발송
재시도 성공 후 발송
대기
오늘 자동 재시도
4건
환불 회수
1건
평균 처리
38초
환불 주문 0922-0388은 카페24 환불 이벤트 수신 즉시 링크를 무효화하고 기록을 남겼습니다.

[화면 개요 및 목적]

결제 한 건이 출판사 주문·권한 부여·다운로드로 이어지는 과정을 주문 단위로 봅니다. 제안서의 “결제와 다운로드 연결”을 증명합니다.

[핵심 기능 로직]

결제·환불 이벤트를 받아 같은 주문은 한 번만 처리합니다. 출판사 A·B·C는 각 출판사 주문 API로, D는 자체 엔진으로 링크를 만듭니다. 실패는 자동 재시도합니다. 데모 2·4단계와 연결됩니다.

  • 중복 지급 없는 처리
    주문 한 건 한 번 처리(멱등) · 재시도 대기열
  • 출판사별 주문 연동
    출판사 A·B·C 주문 API 연결
구매 고객 · 정책 시나리오

결제 후 바로, 안전하게 받는 악보

기존 쇼핑몰에서 결제하면 워터마크 악보를 제한 링크로 받습니다.

상품 선택

기존 카페24
상품 페이지

결제

카페24 체크아웃
그대로 사용

링크 수신

마이페이지에서
보안 링크 확인

악보 받기

워터마크 PDF
기간·횟수 제한

환불 회수

환불 시
링크 즉시 무효

구매 고객 · 정책 | 화면 01

고객 보안 다운로드

쇼핑몰 마이페이지 · 사전 설계 예시
클래식 악보 쇼핑몰 마이페이지 · 디지털 악보 · 장바구니 0
주문 20260923-0417 · 9월 23일 (수)
Préludes Livre 1
Debussy · 출판사 D · PDF 42쪽
남은 다운로드
3회 / 5회
링크 만료
9월 30일 (수)
23:59까지
결제 완료 즉시 다운로드 권한 부여사용 가능
구매자 정보 워터마크 적용적용됨
환불 시 링크 즉시 무효해당 없음
같은 주문의 다른 악보
Arabesques No.1
출판사 A · 개인화 PDF
다운로드 완료
Clair de lune
출판사 B · 출판사 링크
받기 가능
미리보기 · 1 / 42쪽
Préludes · I. Danseuses de Delphes
김*준 · 주문 20260923-0417 · 2026.09.23 개인 사용 전용
다운로드 이력
2회 · 9월 23일 (수) 오후 2:14
링크 만료 안내
만료 3일 전 메일 안내
문의
마이페이지 1:1 문의

[화면 개요 및 목적]

구매 고객이 기존 마이페이지 흐름에서 받는 출판사 D 악보입니다. 고객 화면은 새로 디자인하지 않고 링크 영역만 더합니다.

[핵심 기능 로직]

구매자명·주문번호를 모든 쪽에 워터마크로 새기고, 서명된 링크에 만료일과 남은 횟수를 겁니다. 환불되면 링크가 즉시 무효가 됩니다. 데모 3단계에서 체험합니다.

  • 무단 공유 방지
    PyMuPDF 워터마크
  • 기간·횟수 제한 링크
    서명 URL · 만료 처리
구매 고객 · 정책 | 화면 02

다운로드 정책·실패 기준

연동 관리 · 사전 설계 예시
디지털 악보 연동 관리 운영 담당자 · 2026.09.23 (수) 설명용 예시
다운로드 정책·실패 처리 기준
상세 기획 단계에서 담당자와 확정할 값입니다. 아래 숫자는 설명용 초안입니다.
출판사 D 보안 다운로드
실패 처리 기준
상황처리상태
출판사 주문 실패5분 간격 3회 재시도자동
링크 발급 실패3회 실패 시 알림알림
환불 접수권한 회수 기록자동
토큰 만료자동 갱신·실패 알림확인 필요
알림 받는 사람: 운영 담당자 · 개발 담당
정책 적용 출판사
D (자체 엔진)
A·B·C 링크
출판사 발급 URL
변경 이력
3건
확정된 값은 운영 매뉴얼과 다운로드 정책 문서에 같은 숫자로 기록합니다.

[화면 개요 및 목적]

상세 기획에서 정할 만료 기간·횟수·환불 회수 규칙과 결제-다운로드 실패 처리 기준을 담당자가 확인하는 화면입니다.

[핵심 기능 로직]

정책 값은 설정으로 분리해 운영 중에도 바꿀 수 있습니다. 실패 상황별 재시도 횟수와 알림 기준을 문서와 같은 값으로 둡니다.

  • 정책을 코드 수정 없이 변경
    설정 테이블 · 변경 이력
구매 고객 · 정책 | 화면 03

정기 실행·오류 로그

연동 관리 · 사전 설계 예시
디지털 악보 연동 관리 운영 담당자 · 2026.09.23 (수) 설명용 예시
정기 실행·오류 로그
정기 실행 결과와 기존 관리자 DB 적재 결과를 매번 기록합니다. 운영 매뉴얼에 대응 절차를 담습니다.
다음 실행
09:00
어제 실행
46회
오류 기록
2건
작업주기최근 결과처리량상태
출판사 A 카탈로그 수집매일 06:00124건 신규
정상
출판사 B XML 수집매일 04:3057건 변경
정상
출판사 C 증분 동기화3시간마다3페이지 지연
재시도 중
환율 갱신매일 09:001,468원/EUR
대기
관리자 DB 적재30분마다판매 37 · 다운로드 35
정상
로그 보관 90일 · 오류는 담당자 알림 운영 매뉴얼 4장 · 오류 대응 절차
최근 오류 · 06:47 출판사 C 응답 지연(3페이지) → 5분 뒤 자동 재시도 예정 재시도 중

[화면 개요 및 목적]

카탈로그 수집·환율 갱신·관리자 DB 적재가 언제 돌고 어떤 결과였는지 기록합니다. 운영 매뉴얼의 오류 대응 절차와 연결됩니다.

[핵심 기능 로직]

작업마다 다음 실행 시각·처리 건수·오류를 남깁니다. 기존 관리자페이지 소스를 분석해 DB 적재 방식을 정하고, 구조상 어려우면 통합 대시보드로 대체합니다.

  • 정해진 시각 자동 실행
    스케줄러(크론) 서버
  • 인계 후 직접 운영
    스키마 문서 · 운영 매뉴얼
시나리오

| 화면 01

[화면 개요 및 목적]

[핵심 기능 로직]

    | 화면 02

    [화면 개요 및 목적]

    [핵심 기능 로직]

      | 화면 03

      [화면 개요 및 목적]

      [핵심 기능 로직]