PriceFlow 사용자 매뉴얼 & QA

가격변동 관리 시스템 — 테스트 가이드 & QA 체크시트

접속 정보

주소 pf-farmhub.vercel.app

이메일 admin@priceit.co.kr

비밀번호 priceflow2026

사용 매뉴얼

테스트 시나리오

QA 체크시트

1 로그인

주소에 접속하면 PriceFlow 로그인 화면이 나옵니다
이메일과 비밀번호를 입력하고 로그인 버튼 클릭
로그인 성공하면 자동으로 대시보드로 이동합니다
로그아웃: 왼쪽 메뉴 맨 아래 로그아웃 버튼

잘못된 비밀번호를 입력하면 "이메일 또는 비밀번호가 올바르지 않습니다" 메시지가 빨간색으로 나옵니다.

2 전체 업무 흐름

PriceFlow는 구글 시트 입력부터 시작합니다. 아래 순서대로 진행됩니다.

흐름도

공급사가 카톡/메일/전화로 가격 변동을 알려줌
직원이 구글 시트(가격변동입력)에 한 줄 입력
자동으로 Slack #소싱_공급가_스냅샷-log 채널에 알림 전송
직원이 Slack 스레드에 증거 스크린샷 첨부
PriceFlow 대시보드에 해당 건이 나타남
대시보드에서 승인 → 가격 반영 → 엑셀 다운로드
엑셀을 AdminPlus에 업로드하면 끝

구글 시트 입력이 출발점입니다. 시트에 입력하지 않으면 PriceFlow에 아무것도 나타나지 않습니다.

3 구글 시트 — 가격변동 입력

공급사에서 가격이 바뀌면 이 시트에 한 줄 입력합니다.

시트 링크

가격변동입력 시트 시트 열기

입력해야 하는 열

A열 — 입력일시: 오늘 날짜 입력 (예: 2026-03-07)
B열 — 입력자: 본인 이름
C열 — 유형: "가격변경" 또는 "신규등록"
D열 — 공급사: 공급사 이름 (예: 한솔팜)
E열 — 품목: 상품+옵션명 (예: 참외 3kg)
F열 — 상품코드: 어드민플러스 상품코드 (모르면 비워둬도 됨)
G열 — 기존 공급가: 현재 공급가 (숫자만, 예: 15000)
H열 — 기존 배송비: 현재 배송비 (없으면 비워둠)
I열 — 변경 공급가: 바뀐 공급가 (숫자만, 예: 17000)
J열 — 변경 배송비: 바뀐 배송비 (없으면 비워둠)
K열 — 가격유형: "일반" / "프로모션" / "시즌" 등
L열 — 적용일: 가격이 적용되는 날짜
M열 — 변동유형: "인상" / "인하" / "신규"
N열 — 출처: "카톡" / "메일" / "전화" / "직접확인"
O열 — 비고: 참고사항 (선택)

자동 처리되는 열 (직접 입력 X)

P열 — 처리상태: 시스템이 자동으로 업데이트
Q열 — 슬랙알림ID: Slack 메시지 ID (자동 생성)
R열 — 전송: 체크박스 (체크하면 전송)

입력 순서

시트의 맨 아래 빈 행으로 이동
A열부터 O열까지 한 줄을 채웁니다
R열(전송) 체크박스에 체크 ✓
자동으로 Slack에 알림이 가고, PriceFlow에 반영됩니다

입력 후 R열 체크박스를 반드시 체크하세요. 체크하지 않으면 시스템이 인식하지 못합니다.

테스트 체크리스트

시트 링크를 클릭하면 구글 시트가 열리는지 확인

시트에 접근 권한이 있는지 확인

테스트 데이터 한 줄 입력 후 R열 체크 → Slack에 알림이 오는지 확인

시트 입력 후 PriceFlow 대시보드에 해당 건이 나타나는지 확인

4 대시보드 (첫 화면)

가격변동 현황을 한눈에 보고, 승인/반려 작업을 하는 메인 화면입니다.

화면 위에서 아래로

지금 할 일 카드 — 노란색(승인 대기 N건), 초록색(반영 대기 N건), 보라색(신규 등록 N건). 해당 건수가 0이면 카드가 안 보입니다
요약 바 — 회색 배경에 전체/처리중/완료/오류 건수. 오류가 0건이면 오류 항목 숨김
필터 3개 — 상태, 공급사, 유형(트리거) 드롭다운. 선택 즉시 테이블이 갱신됩니다
일괄 액션 바 — 체크박스로 선택하면 파란 배경에 "N건 선택 | 일괄 승인 | 일괄 반려" 표시
가격변동 테이블 — 아래 컬럼 참조

테이블 컬럼	설명
체크박스	승인 가능한 건만 체크 가능. 헤더 체크로 전체 선택/해제
공급사	공급사 이름
상품명	"상품명 / 옵션명" 형태. 옵션 없으면 상품명만
유형	인상 인하 신규 단종
공급가	기존가(취소선) → 변경가(굵은 글씨)
판매가	자동 계산된 판매가(파란색) + 마진율(%)
상태	입력됨 확인중 승인 대기 승인됨 반영 완료 반려 오류
기준일	가격 적용 시작일 (예: "3/10~"). 적용일이 설정된 건에만 표시
등록일	등록 날짜
작업	상태에 따라: 승인/반려 버튼, 이메일 발송 버튼, 또는 "-"

카카오 메시지 생성

승인된 건이 있으면 "카카오 메시지" 버튼이 활성화됩니다.

승인된 건이 1건 이상이면 대시보드 상단에 "카카오 메시지" 버튼이 보입니다
클릭하면 카카오 오픈채팅방에 복붙할 수 있는 텍스트가 자동 생성됩니다
카테고리별로 탭이 나뉘며, 복사 버튼으로 텍스트를 복사할 수 있습니다

반영 대기 카드의 "가격 반영" 버튼을 누르면 가격 반영 페이지로 바로 이동합니다.

테스트 체크리스트

로그인 후 대시보드가 자동으로 뜨는지 확인

지금 할 일 카드에 건수가 맞게 표시되는지 확인

필터에서 상태를 "승인 대기"로 바꾸면 해당 건만 나오는지 확인

필터에서 공급사를 선택하면 해당 공급사 건만 나오는지 확인

체크박스로 여러 건 선택 후 일괄 승인 클릭 → 우상단에 알림 뜨는지

개별 건의 승인 버튼 클릭 → 상태가 "승인됨"으로 바뀌는지

개별 건의 반려 버튼 클릭 → 상태가 "반려"로 바뀌는지

테이블에 기준일(적용일) 컬럼이 표시되는지 확인

승인된 건이 있을 때 카카오 메시지 버튼이 활성화되는지

카카오 메시지 클릭 시 카테고리별 텍스트가 생성되는지

5 공급가 입력

공급사별 상품의 공급가를 직접 입력하고, 판매가를 자동 계산합니다.

화면 구성

공급사 선택 — 상단 드롭다운. "공급사명 (코드)" 형태로 표시. 선택하면 해당 공급사 품목만 로딩
기본 마진율 — 선택한 공급사의 마진율이 작은 글씨로 표시 (예: "기본 마진율: 5%")
가격 입력 테이블 — 아래 컬럼 참조

테이블 컬럼	설명
상품옵션명	상품 이름 + 옵션. 아래에 작은 글씨로 호감코드 표시
현재가	현재 DB에 저장된 공급가 (원 단위)
변경가	직접 입력하는 칸. 숫자만 입력 가능
마진율	적용될 마진율 (%)
판매가	변경가 입력 시 자동 계산되어 파란색으로 표시. 공식: CEILING(공급가 / (1 - 마진율), 100)
검증	자동 검증 결과. 정상이면 정상, 문제 있으면 ! 역마진 ~ 이상치 등

사용 방법

공급사를 선택합니다
변경할 품목의 변경가 칸에 새 공급가를 입력합니다
오른쪽에 판매가가 자동 계산되고, 검증 결과가 표시됩니다
여러 품목을 한번에 입력할 수 있습니다
하단의 저장 및 검증 버튼을 누르면 가격변동이 등록됩니다
저장 성공 시 초록색 완료 메시지가 나옵니다

역마진(판매가가 공급가보다 낮음)이면 빨간색 경고가 뜹니다. 반드시 확인하세요.

테스트 체크리스트

공급사 드롭다운에 공급사 목록이 나오는지 확인

공급사를 바꾸면 해당 품목으로 테이블이 바뀌는지 확인

변경가에 숫자를 입력하면 판매가가 실시간으로 계산되는지 확인

판매가 계산이 100원 단위 올림으로 되는지 확인 (예: 공급가 9,500원, 마진5% → 판매가 10,000원)

저장 후 대시보드에 새 가격변동 건이 생기는지 확인

역마진이 되는 값을 넣었을 때 빨간 경고가 뜨는지 확인

6 마진 규칙

판매가 계산에 사용되는 마진율을 관리합니다. 공급사별/상품별로 다르게 설정 가능.

화면 구성

우선순위 안내 — "옵션별(30) > 상품별(20) > 공급사별(10) > 전체(0)" — 더 구체적인 규칙이 우선 적용
규칙 추가 폼 — 우측 상단 "규칙 추가" 버튼을 누르면 나타남
규칙 목록 테이블 — 현재 설정된 마진 규칙 전체

규칙 추가 시 입력 항목

범위 — 전체 / 공급사별 / 상품별 / 옵션별 중 선택
공급사 — 범위가 "공급사별"일 때만 나타남. 공급사 선택
마진 타입 — "퍼센트(%)" 또는 "고정금액(원)"
마진값 — 숫자 입력 (예: 5.0 = 5%, 또는 1000 = 1,000원)
비고 — 메모 (선택사항)

테이블 컬럼	설명
우선순위	숫자가 클수록 먼저 적용 (30 > 20 > 10 > 0)
범위	전체 공급사 상품 등 배지로 표시
대상	해당 공급사/상품 이름. 전체이면 "전체"
타입	"퍼센트" 또는 "고정금액"
마진	"5.0%" 또는 "1,000원"
상태	활성 또는 비활성
비고	메모
관리	"비활성" / "활성화" 버튼

테스트 체크리스트

기존 규칙(전체 5%)이 목록에 보이는지 확인

"규칙 추가" → 범위를 "공급사별"로 선택 → 공급사 드롭다운이 나타나는지 확인

새 규칙 추가 후 목록에 추가되는지 확인

"비활성" 버튼을 누르면 상태가 바뀌는지 확인

공급사 마진을 바꾼 후 공급가 입력에서 판매가가 달라지는지 확인

7 마진계산기

공급가와 마진율을 넣으면 판매가를 바로 계산해볼 수 있는 도구입니다.

3가지 기능

단일 계산 — 공급가 + 마진율 입력 → 판매가/마진금액 자동 표시
마진율별 시뮬레이션 — 3%~25% 구간 판매가를 한눈에 비교. 현재 선택된 마진율이 파란색으로 강조
가격변동 영향도 분석 — 기존 공급가 → 변경 공급가 넣으면, 판매가 변동금액/변동률/마진 변화를 자동 계산

테스트 체크리스트

공급가 10,000원 / 마진율 5% 입력 → 판매가 10,600원(100원 올림)이 나오는지 확인

시뮬레이션 테이블에 여러 마진율별 판매가가 나오는지 확인

영향도 분석에서 기존 → 변경 공급가 넣으면 변동금액이 맞게 계산되는지 확인

8 가격 반영

승인된 가격변동을 AdminPlus 엑셀로 다운로드하고, 업로드 후 완료 처리하는 화면입니다.

3단계 프로세스

화면 상단에 진행 단계가 표시됩니다: ① 검토 → ② 다운로드 → ③ 반영 완료

Step 1 — 검토: "검토 시작 (N건)" 버튼 클릭 → 반영할 항목 미리보기 테이블이 나옴 (상품코드, 상품명, 기존공급가, 변경공급가, 판매가)
Step 2 — 다운로드: "엑셀 다운로드" 버튼 클릭 → xlsx 파일이 PC에 저장됨. 초록색 가이드 카드가 나타남
Step 3 — 반영 완료: AdminPlus에 엑셀 업로드 후 "반영 완료" 버튼 클릭. "AdminPlus에 반영 완료하셨나요?" 확인 팝업 뜸

이전 반영 이력 테이블

# — 번호 (최신이 1)
생성일시 — 배치 생성 날짜
항목수 — 포함된 가격변동 건수
상태 — 작성중 엑셀 다운로드됨 승인됨 반영 완료
액션 — "반영 완료" 또는 "상세보기" 버튼

"반영 완료"는 실제로 AdminPlus에 업로드한 후에만 누르세요. 누르면 해당 건들의 상태가 최종 완료로 변경됩니다.

테스트 체크리스트

승인 대기 건이 없으면 "반영할 가격변동이 없습니다" 메시지가 나오는지 확인

승인된 건이 있으면 "검토 시작" 버튼이 활성화되는지 확인

검토에서 미리보기 테이블이 정확한지 확인 (상품명, 가격 등)

엑셀 다운로드가 되고, 파일이 열리는지 확인

이전 반영 이력에서 "상세보기"를 누르면 포함된 항목이 나오는지 확인

9 상품 매핑

DB 상품이 AdminPlus 상품코드와 올바르게 연결되어 있는지 확인하고, 공급가를 대조·검수하는 관리 화면입니다.

화면 구성

검수 진행률 바 — 파란색 프로그레스 바. "검수 진행률: N/1,202 (XX%)" 형태. 매핑된 상품 중 검수 완료 비율을 표시
통계 바 — 전체/매핑(초록)/미매핑(빨강)/검수완료(파란)/미검수(주황) 건수. 대조 실행 후에는 일치/불일치/시트없음 건수도 표시
필터 5개 — 공급사, 매핑상태(전체/매핑완료/미매핑), 판매상태(판매중/미사용/전체), 검수상태(전체/검수완료/미검수), 검색어
상단 버튼 4개 — "공급가 마스터 대조", "일치건 전체검수", "엑셀 다운로드", "엑셀 업로드"
상품 테이블 — PF코드, 공급사, 상품+옵션명, AP코드, DB공급가, (대조 후) 시트공급가, 대조결과, 실제공급가(입력 가능)
페이지네이션 — 하단에 이전/다음 버튼

공급가 마스터 대조 (핵심 기능)

구글 시트(전체 공급가 마스터)와 DB에 저장된 공급가를 자동으로 비교합니다.

우측 상단의 "공급가 마스터 대조" 버튼 클릭
잠시 로딩 후, 테이블에 시트공급가와 대조결과 컬럼이 추가됨
대조결과 배지:
- 일치 — DB 가격과 시트 가격이 동일
- 불일치 (+500) — 가격이 다름. 차이금액이 괄호 안에 표시
- 시트없음 — 시트에 해당 상품이 없음
통계 바 오른쪽에 대조 결과 요약이 표시됨: 일치 N / 불일치 M / 시트없음 K

일치건 전체검수 (일괄 처리)

대조 결과가 "일치"인 건들을 한번에 검수 완료 처리합니다.

먼저 "공급가 마스터 대조"를 실행합니다
대조 완료 후, "일치건 전체검수 (N건)" 버튼이 나타납니다
버튼을 클릭하면 일치 건 전부가 mapping_verified = true로 처리됩니다
검수 진행률 바가 즉시 올라갑니다

불일치건 수동 확인

자동 대조 후 남은 불일치/시트없음 건은 담당자가 직접 확인합니다.

검수 필터를 "미검수"로 설정하면 아직 확인 안 된 건만 볼 수 있습니다
각 건을 확인한 후, 체크박스로 선택 → "매핑 검수 완료" 버튼 클릭
실제 공급가가 다른 경우, 오른쪽 실제공급가 칸에 올바른 가격을 입력 → 저장

대조 실행에 몇 초 걸릴 수 있습니다 (전체 시트 데이터를 읽어오기 때문). "대조 중..." 표시가 사라질 때까지 기다려주세요.

AP코드가 빨간색 "미매핑"이면 AdminPlus에 해당 상품이 연결되지 않은 것입니다. 엑셀로 반영할 때 제외됩니다.

테스트 체크리스트

검수 진행률 바가 표시되는지 확인

통계 바 숫자가 맞는지 대략 확인

"공급가 마스터 대조" 클릭 → 시트공급가/대조결과 컬럼이 추가되는지 확인

대조결과가 일치(초록)/불일치(빨강)/시트없음(회색)으로 구분되는지 확인

"일치건 전체검수" 클릭 → 진행률이 올라가는지 확인

공급사 필터로 특정 공급사 품목만 나오는지 확인

검색창에 상품명을 입력하면 필터링되는지 확인

체크 선택 후 "매핑 검수 완료" 클릭 → 행 배경이 연두색으로 바뀌는지 확인

페이지네이션(이전/다음)이 동작하는지 확인

10 모니터링

최근 7일간의 가격변동 통계를 한눈에 보는 화면입니다.

화면 구성

요약 카드 4개 — 7일간 총 변동(건수), 오늘(인상/인하/신규), 미처리(건수, 많으면 노란색 경고), 오류(건수, 있으면 빨간색 경고)
최근 7일 차트 — 날짜별 막대그래프. 빨강=인상, 초록=인하, 보라=신규, 진빨강=오류
공급사별 변동 — 어떤 공급사에서 변동이 많았는지 가로 막대그래프
상태 분포 — 입력됨/확인중/승인대기/승인됨/반영완료/반려/오류 건수
최근 오류 — 오류가 있으면 빨간 카드로 표시 (최대 10건)

테스트 체크리스트

왼쪽 메뉴에서 "모니터링" 클릭 시 페이지가 열리는지 확인

4개 요약 카드에 숫자가 표시되는지 확인 (0이어도 표시되면 OK)

7일 차트에 막대가 나오는지 확인 (데이터가 없으면 빈 차트)

공급사별 변동 차트에 공급사 이름이 나오는지 확인

상태 분포 섹션에 각 상태별 건수가 나오는지 확인

11 QA 체크시트 제출

QA 체크시트를 작성하고 제출하면 자동으로 Slack에 전송되고, 본인에게 DM 리포트가 옵니다.

제출 후 자동 처리

제출 시 Slack #priceflow-qa 채널에 결과 요약이 전송됩니다
스레드에 PASS/FAIL 상세 내역이 붙습니다
제출한 본인에게 Slack DM으로 개인 리포트가 옵니다 (PASS/FAIL/미테스트 분류)
FAIL 항목은 QA 이슈 트래커(/qa-issues)에 자동 등록됩니다

DM 리포트가 안 오면 Slack에서 본인의 표시 이름과 제출 시 입력한 이름이 같은지 확인하세요.

테스트 체크리스트

QA 체크시트 제출 후 Slack 채널에 결과가 전송되는지 확인

제출 후 본인에게 Slack DM 리포트가 오는지 확인

테스트 시나리오란?

실제 업무 흐름대로 처음부터 끝까지 따라해보는 것입니다. 아래 시나리오를 순서대로 진행해주세요.

시나리오 A: 공급가 변경 → 승인 → 엑셀 다운로드

가장 핵심적인 흐름입니다. 공급사에서 가격이 바뀌었을 때의 전체 과정.

따라하기

왼쪽 메뉴에서 공급가 입력 클릭
아무 공급사를 선택합니다
아무 품목 하나의 변경가에 현재가와 다른 값을 입력합니다 (예: 현재가 10,000원이면 11,000원)
기대 결과: 판매가가 자동으로 계산되고, 검증 결과에 "정상"이 뜹니다
하단의 저장 및 검증 버튼 클릭
기대 결과: 초록색 "N건의 가격 변동이 저장되었습니다" 메시지
왼쪽 메뉴에서 대시보드 클릭
기대 결과: 방금 입력한 건이 테이블에 나타남. 상태는 "승인 대기". 지금 할 일에 "승인 대기 N건" 카드 표시
해당 건의 승인 버튼 클릭
기대 결과: 상태가 "승인됨"으로 변경. "반영 대기" 카드가 나타남
"반영 대기" 카드의 가격 반영 버튼 클릭 (또는 왼쪽 메뉴 → 가격 반영)
기대 결과: 가격 반영 페이지로 이동. "검토 시작" 버튼 활성화
검토 시작 클릭 → 미리보기 확인 → 엑셀 다운로드 클릭
기대 결과: xlsx 파일이 다운로드됨. 초록색 Step 2 가이드가 나타남
다운로드된 엑셀 파일을 열어서 내용이 맞는지 확인
기대 결과: 상품코드, 판매가 등이 정확하게 들어있음

시나리오 B: 마진 규칙 변경 → 판매가 확인

특정 공급사의 마진율을 바꾸면 판매가가 달라지는지 확인합니다.

따라하기

왼쪽 메뉴에서 마진계산기 클릭
공급가 10,000원, 마진율 5% 입력
기대 결과: 판매가 10,600원
마진율을 10%로 바꿔봅니다
기대 결과: 판매가 11,200원
왼쪽 메뉴에서 마진 규칙 클릭
규칙 추가 버튼 → 범위: "공급사별" → 아무 공급사 선택 → 마진율: 10% → 추가
기대 결과: 목록에 새 규칙이 추가됨. 우선순위 10
왼쪽 메뉴에서 공급가 입력 → 방금 규칙 추가한 공급사 선택
기대 결과: 기본 마진율이 10%로 표시되고, 판매가 계산도 10% 기준으로 바뀜

시나리오 C: 일괄 승인 테스트

따라하기

먼저 공급가 입력에서 3건 이상의 가격변동을 등록합니다
대시보드로 이동
필터에서 상태를 "승인 대기"로 선택
기대 결과: 승인 대기 건만 표시됨
헤더의 체크박스를 클릭 (전체 선택)
기대 결과: 모든 행이 선택되고, "N건 선택" 바가 나타남
일괄 승인 버튼 클릭
기대 결과: 모든 건이 "승인됨"으로 바뀜. 우상단에 알림 표시

시나리오 D: 상품 검색 & 매핑 확인

따라하기

왼쪽 메뉴에서 상품 매핑 클릭
통계 바에서 미매핑 숫자를 확인합니다
필터에서 매핑 상태를 "미매핑"으로 선택
기대 결과: AP코드가 빨간 "미매핑" 배지인 행만 표시
검색창에 아는 상품명을 입력해봅니다
기대 결과: 해당 상품만 필터링됨
아무 행 1개를 체크 → 매핑 검수 완료 클릭
기대 결과: 해당 행의 배경이 연두색으로 바뀌고, 체크 표시(✓)가 생김

시나리오 E: 공급가 마스터 대조 → 일괄 검수 → 불일치 확인

내일 오후 1시까지 전체 상품 검수를 완료하는 핵심 시나리오입니다.

따라하기

왼쪽 메뉴에서 상품 매핑 클릭
상단의 검수 진행률 바를 확인합니다 (처음엔 0%)
기대 결과: "검수 진행률" 파란색 바가 표시됨. 0/N (0%)
우측 상단의 "공급가 마스터 대조" 버튼 클릭
기대 결과: "대조 중..." → 완료 후 "대조 완료: 일치 N건 / 불일치 M건" 알림. 테이블에 시트공급가 + 대조결과 컬럼이 추가됨
통계 바 오른쪽에 대조 결과 요약을 확인합니다
기대 결과: "일치 N" (초록) / "불일치 M" (빨강) 숫자가 표시됨
테이블에서 대조결과 컬럼을 확인합니다 — 초록 "일치", 빨강 "불일치(+금액)", 회색 "시트없음"
기대 결과: 각 행마다 배지가 다르게 표시됨
"일치건 전체검수 (N건)" 버튼 클릭
기대 결과: "N건 검수 완료 처리" 알림. 진행률 바가 크게 올라감
검수 필터를 "미검수"로 바꿔서 남은 건만 확인합니다
기대 결과: 불일치 + 시트없음 건만 나타남
불일치 건을 하나씩 확인합니다. DB공급가와 시트공급가가 다른 이유를 파악합니다
확인 완료된 건을 체크 → "매핑 검수 완료" 클릭
기대 결과: 해당 행 배경이 연두색, 진행률 바가 올라감
모든 건 검수 완료 시 진행률 100%를 확인합니다

예상 소요시간: 자동 대조 ~5분 / 일치건 전체검수 ~10초 / 불일치건 수동 확인 2~4시간

! 테스트 전 준비사항

환경 설정 (반드시 먼저!)

Chrome 브라우저 최신 버전 사용 (다른 브라우저는 테스트 대상 아님)
시크릿/프라이빗 모드로 열기: Ctrl+Shift+N (맥: Cmd+Shift+N)
시크릿 모드가 어려우면 캐시 삭제 후 테스트:
Ctrl+Shift+Delete (맥: Cmd+Shift+Delete) → "캐시된 이미지 및 파일" 체크 → 삭제
접속: https://pf-farmhub.vercel.app
페이지가 완전히 로딩될 때까지 기다린 후 테스트 시작 (로딩 중 동작이 안 되는 건 버그 아님)

! PASS / FAIL 판정 기준

이것만 기억하세요

PASS: 설명대로 정상 동작하는 경우
FAIL: 동작하지 않거나 오류가 발생하는 경우. 반드시 메모 작성 필수!
- (미테스트): 테스트하지 못한 항목 (모르겠거나 접근 불가). FAIL이 아닙니다!

자주 틀리는 판정

"느리다" → PASS 처리 + 메모에 "느림" 기록
"데이터가 없어서 확인 불가" → - (미테스트) 처리. FAIL 아님!
"로딩 중이라 안 됨" → 잠시 기다려보세요. 그래도 안 되면 FAIL
"뭔가 이상한데 뭔지 모르겠다" → - (미테스트) + 메모에 느낀 점 기록

! 메모 작성 가이드

메모 없는 FAIL은 처리할 수 없습니다

FAIL로 체크했으면 반드시 메모를 적어주세요
무슨 에러인지, 뭐가 안 되는지 구체적으로 적어주세요

좋은 메모 예시

"승인 버튼 클릭 시 '현재상태(detected)에서는 승인할 수 없습니다' 에러 표시됨"

"공급사 드롭다운 클릭했는데 목록이 비어있음. 로딩 스피너만 계속 돌아감"

"엑셀 다운로드 버튼 누르면 파일은 받아지는데 열면 내용이 비어있음"

나쁜 메모 예시 (이렇게 적으면 확인 불가)

"안됨" — 무엇이 안 되는지 알 수 없음

"에러" — 어떤 에러인지 알 수 없음

(메모 없이 FAIL만 체크) — 재현 불가

! 스크린샷 찍는 법

FAIL 항목은 스크린샷을 찍어서 Slack #priceflow-qa 채널에 올려주세요.

맥: Cmd+Shift+4 → 영역 드래그 → 바탕화면에 저장됨
윈도우: Win+Shift+S → 영역 드래그 → 클립보드에 복사 → Slack에 붙여넣기
에러 메시지가 빨간 글씨로 나오면 그 부분을 캡처해주세요
스크린샷에 해당 QA 번호를 같이 적어주면 더 좋습니다 (예: "#9 승인 버튼 에러")

QA 체크시트

각 항목을 테스트하고 결과를 기록해주세요. FAIL은 반드시 메모를 적어주세요.

테스트 담당자: _____________ 테스트 일자: _____________

#	분류	테스트 항목
1	로그인	사이트 접속 시 로그인 화면이 나오는가
2	로그인	올바른 이메일/비밀번호로 로그인되는가
3	로그인	잘못된 비밀번호 입력 시 에러 메시지가 나오는가
4	로그인	로그아웃 버튼 클릭 시 로그인 화면으로 돌아가는가
5	구글시트	가격변동입력 시트 링크가 열리고 접근 가능한가
6	구글시트	시트에 한 줄 입력 후 R열 체크 → Slack 알림이 오는가
7	구글시트	시트 입력 후 PriceFlow 대시보드에 해당 건이 나타나는가
8	대시보드	로그인 후 대시보드가 자동으로 표시되는가
9	대시보드	지금 할 일 카드에 건수가 표시되는가
10	대시보드	상태 필터 변경 시 테이블이 갱신되는가
11	대시보드	공급사 필터 변경 시 테이블이 갱신되는가
12	대시보드	테이블에 "기준일(적용일)" 컬럼이 표시되는가
13	대시보드	개별 승인 버튼 → 상태가 "승인됨"으로 바뀌는가
14	대시보드	개별 반려 버튼 → 상태가 "반려"로 바뀌는가
15	대시보드	체크박스 전체 선택 → 일괄 승인이 동작하는가
16	대시보드	"카카오 메시지" 버튼 클릭 → 카카오용 텍스트가 생성되는가
17	대시보드	에러/실패 시 우상단에 빨간 알림(토스트)이 뜨는가
18	공급가	공급사 드롭다운에 공급사 목록이 나오는가
19	공급가	공급사 변경 시 해당 품목으로 테이블이 바뀌는가
20	공급가	변경가 입력 시 판매가가 실시간 자동계산되는가
21	공급가	판매가가 100원 단위 올림으로 계산되는가
22	공급가	검증 결과(정상/역마진/이상치 등)가 올바르게 표시되는가
23	공급가	"저장 및 검증" 클릭 → 완료 메시지가 나오는가
24	공급가	저장 후 대시보드에 해당 건이 생기는가
25	마진	마진 규칙 목록이 표시되는가 (기본: 전체 5%)
26	마진	새 규칙 추가가 정상 동작하는가
27	마진	활성/비활성 토글이 동작하는가
28	마진	마진계산기에서 계산이 정확한가 (예: 10,000원/5% → 10,600원)
29	반영	승인 건 있을 때 "검토 시작" 버튼이 활성화되는가
30	반영	미리보기 테이블에 상품코드/판매가가 맞게 나오는가
31	반영	엑셀 다운로드가 정상 동작하는가
32	반영	다운로드된 엑셀 파일이 정상적으로 열리는가
33	반영	이전 반영 이력이 표시되고 상세보기가 동작하는가
34	매핑	검수 진행률 바가 표시되고 퍼센트가 맞는가
35	매핑	통계 바에 전체/매핑/미매핑/검수완료/미검수 건수가 표시되는가
36	매핑	"공급가 마스터 대조" 클릭 → 시트공급가/대조결과 컬럼이 나타나는가
37	매핑	대조결과가 일치(초록)/불일치(빨강)/시트없음(회색)으로 구분되는가
38	매핑	불일치 배지에 차이금액(+500 등)이 표시되는가
39	매핑	"일치건 전체검수" 클릭 → 일치 건이 전부 검수 완료 처리되는가
40	매핑	전체검수 후 진행률 바가 올라가는가
41	매핑	필터(공급사, 매핑상태, 검수상태, 검색)가 정상 동작하는가
42	매핑	체크 선택 후 "매핑 검수 완료" → 행 배경 연두색 + 체크표시 생기는가
43	모니터링	왼쪽 메뉴에서 "모니터링" 클릭 → 페이지가 열리는가
44	모니터링	요약 카드 4개(7일간 총 변동, 오늘, 미처리, 오류)에 숫자가 표시되는가
45	모니터링	최근 7일 차트(날짜별 막대그래프)가 표시되는가
46	모니터링	공급사별 변동 차트에 공급사 이름이 나오는가
47	모니터링	상태 분포(입력됨/승인대기/승인됨 등) 건수가 표시되는가
48	QA	이 체크시트 제출 후 Slack에 결과가 전송되는가
49	QA	제출 후 본인에게 Slack DM 리포트가 오는가
50	공통	왼쪽 메뉴에서 각 페이지 이동이 잘 되는가
51	공통	현재 페이지가 왼쪽 메뉴에서 파란색으로 강조되는가
52	공통	없는 주소 접속 시 "404 페이지를 찾을 수 없습니다"가 나오는가
53	공통	브라우저 탭에 PF 아이콘(파비콘)이 보이는가

자유 피드백

위 체크리스트 외에 느낀 점을 자유롭게 적어주세요.

안 되는 것 (버튼 반응 없음, 에러 등)

헷갈리는 것 (메뉴 이름, 용어, 버튼 위치 등)

불편한 것 (이동 번거로움, 정보 부족 등)

추가 기능 요청 (이런 기능이 있으면 좋겠다)

다 안 채워도 됩니다!
생각날 때마다 적고 여러 번 제출해도 괜찮아요.

테스트 담당자 이름