SYSTEM BLUEPRINT

실사용 전 검증 흐름
보안·투표·운영 데이터 스토리보드

사용자 경험과 운영 검수 화면을 함께 보여주는 실행 설계입니다.

스토리보드란?

스토리보드는 수정할 기능과 검수할 결과를 화면으로 미리 확인하는 문서입니다. 사용자와 운영자의 주요 흐름을 실제 서비스에 가깝게 정리했습니다.

  1. 사용자가 이미지를 편집하고 한 번만 투표하는 흐름
  2. 운영자가 권한·기기별 품질을 점검하는 흐름
  3. 참여 퍼널과 증빙 자료를 확인하는 흐름

마지막까지 보시면 어떤 화면에서 무엇을 검수할지 분명해집니다.

서비스 사용자 시나리오

이미지 편집에서 안전한 한 표까지

핵심 참여 흐름을 기기별로 확인하고, 중복 투표는 저장 단계에서 막습니다.

콘텐츠 열기

이미지 로딩 확인

이미지 편집

자르기·미리보기

후보 비교

두 이미지 살펴보기

투표하기

한 표만 저장

참여 완료

기록·다음 콘텐츠

서비스 사용자 | 화면 01

이미지 편집·투표 진입

/edit/42
이미지 편집예시 · 테스트 화면
오늘의 이미지 투표
콘텐츠 #42 · 2026.10.01
자르기 영역 · 4:5
원본 이미지1080 × 1350
미리보기저장 대기
편집 적용하고 투표로
화면 검수 기준
권한 브라우저 기록
홈 참여 내 기록

[화면 개요 및 목적]

실사용자가 이미지를 편집하고 투표로 이동하는 핵심 화면입니다. 제안서의 기기별 안정화와 이미지 로딩 개선을 검수합니다.

[핵심 기능 로직]

iPhone Safari·Android Chrome·데스크톱 Chrome에서 이미지 로딩·편집 상태를 확인하고, 연동 오류와 과도한 렌더링을 수정합니다.

  • 이미지 로딩 안정화
    Next.js 이미지 처리
  • 기기별 흐름 확인
    Safari·Chrome QA
서비스 사용자 | 화면 02

한 사용자 한 표

/vote/42
이미지 투표예시 · 참여 중
더 마음에 드는 편집은?
후보 A후보 B
첫 번째 요청저장 완료
같은 계정 재요청중복 차단
후보 A 61% · 후보 B 39%
결과 확인
화면 검수 기준
권한 브라우저 기록
홈 참여 내 기록

[화면 개요 및 목적]

첫 투표는 반영하고 같은 사용자의 두 번째 요청은 차단되는 상태를 함께 보여줍니다.

[핵심 기능 로직]

사용자·투표 대상 고유 제약과 단일 DB 트랜잭션/RPC로 동시 요청 및 재시도에서도 한 표만 저장합니다.

  • 중복 결과 차단
    Postgres 고유 제약
  • 동시 요청 안정화
    Supabase RPC
서비스 사용자 | 화면 03

참여 완료·행동 이벤트

/participation/complete
참여 완료예시 · 기록됨
투표가 반영됐습니다
이번 참여 1건
콘텐츠편집 투표 #42
기록 시각2026.10.01 08:05
행동 이벤트vote_completed
통계 반영집계 대기
다음 콘텐츠 보기
화면 검수 기준
권한 브라우저 기록
홈 참여 내 기록

[화면 개요 및 목적]

사용자에게 완료 상태를 보여주면서, 운영 지표에 필요한 행동 이벤트가 기록되는 시점을 설명합니다.

[핵심 기능 로직]

편집 시작·투표 완료 등 이벤트명과 사용자/세션·콘텐츠·시각을 명세하고 서버에서 검증 후 기록합니다.

  • 이탈 지점 파악
    이벤트 로깅 스키마
  • 안전한 기록
    서버 API
운영 담당자 시나리오

위험 재현부터 검수 자료 인계까지

권한·기기별 QA·행동 데이터를 한 화면 흐름에서 추적합니다.

권한 진단

역할별 접근 확인

정책 수정

RLS·인증 패치

기기별 QA

Safari·Chrome 점검

행동 분석

퍼널·이탈 조회

검수 인계

PR·보고서·조서

운영 담당자 | 화면 01

RLS·인증 권한 점검

/admin/security
보안 점검예시 · 재점검 완료
역할별 접근 권한
검사 2026.10.01 08:10 · 정책 12건
비로그인 → 개인 투표차단
일반 → 본인 투표허용
일반 → 타인 투표차단
관리자 → 집계허용
재점검 12/12 통과
문제 재현 → 정책 수정 → 동일 테스트
화면 검수 기준
권한 브라우저 기록
홈 참여 내 기록

[화면 개요 및 목적]

역할별 접근 매트릭스에서 허용과 차단을 확인하고, 취약점 수정 전후 결과를 비교합니다.

[핵심 기능 로직]

비로그인·일반·관리자 세션으로 직접 조회와 타인 ID 접근을 재현합니다. RLS migration 반영 후 동일 테스트를 재실행합니다.

  • 타인 데이터 차단
    Supabase RLS
  • 패치 재검증
    권한 회귀 테스트
운영 담당자 | 화면 02

기기별 QA·수정 이력

/admin/qa
안정화 QA예시 · 검수 진행
기기별 주요 흐름
iPhone SafariAndroid ChromeDesktop Chrome
이미지 로딩수정 완료
투표 제출재점검 통과
편집 미리보기확인 중
PR #18 · 이미지 로딩 안정화
결과보고서 · 검수조서 준비
화면 검수 기준
권한 브라우저 기록
홈 참여 내 기록

[화면 개요 및 목적]

기기별 문제를 수정 PR, 배포, 재점검, 결과보고서와 검수조서까지 연결합니다.

[핵심 기능 로직]

Safari·Chrome의 메인 흐름을 같은 체크리스트로 확인합니다. 프론트/백엔드 연동 및 이미지 성능 수정은 PR과 보고서로 추적합니다.

  • 기기별 재현성
    QA 체크리스트
  • 증빙 가능한 수정
    GitHub PR·보고서
운영 담당자 | 화면 03

참여 퍼널·CSV

/admin/analytics
참여 분석예시 · 오늘
참여 퍼널
2026.09.24–10.01 · 최근 7일
콘텐츠 조회 1,284명
편집 시작 842명 · 65.6%
투표 완료 617명 · 48.1%
편집 → 투표 이탈26.7%
전일 대비 완료+4.2%
CSV 내려받기
화면 검수 기준
권한 브라우저 기록
홈 참여 내 기록

[화면 개요 및 목적]

편집부터 투표 완료까지의 참여·이탈을 한눈에 보고 통계 자료를 CSV로 내려받는 화면입니다.

[핵심 기능 로직]

이벤트 명세에 맞춘 SQL/RPC로 단계별 인원·이탈률을 집계하고 권한 확인 후 통계 API와 CSV를 제공합니다.

  • 이탈 단계 발견
    퍼널 SQL·RPC
  • 검수 자료 확보
    통계·CSV API
시나리오

유저 여정 타이틀 (Admin Flow)

유저 타입 3이 플랫폼을 사용하는 전체 흐름 설명.

1. 단계명

단계 설명
두 번째 줄

2. 단계명

단계 설명
두 번째 줄

3. 단계명

단계 설명
두 번째 줄

4. 단계명

단계 설명
두 번째 줄

5. 단계명

단계 설명
두 번째 줄

| 화면 01

[화면 개요 및 목적]

[핵심 기능 로직]

    | 화면 02

    [화면 개요 및 목적]

    [핵심 기능 로직]

      | 화면 03

      [화면 개요 및 목적]

      [핵심 기능 로직]