직매장 정산 자동화 화면·사용 흐름 문서
1. 서비스 범위
직매장 정산 자동화는 약 30개 농가의 상품을 위탁 판매하는 로컬푸드 직매장을 위한 웹 서비스다.
정산 담당자가 계산대 판매 파일을 올리고 농가·품목별 정산 규칙을 적용하면 농가별 주간 정산서가 만들어진다. 점장 또는 마감 권한자는 매장 매출과 정산 합계를 대조한 뒤 목요일에 정산을 마감한다. 농가는 스마트폰에서 본인 정산서와 입금 예정일을 확인하고 이의를 제기할 수 있다.
첫 버전 포함 범위
- 한 곳의 로컬푸드 직매장만 운영
- 농가·품목·품목군 등록
- 수수료율과 적용 시작일 등록
- 할인 수수료 기준 등록
- 반품·폐기 부담 규칙 등록
- 계산대 판매 파일 업로드
- 상품코드 자동 연결과 처음 보는 코드 직접 연결
- 판매·할인·반품·폐기 내역 확인
- 오류 검사와 매장 매출 대조
- 농가별 정산서 생성
- 목요일 정산 마감과 마감 잠금
- 다음 정산의 정정 항목
- 농가용 큰 글씨 정산 조회
- 농가 이의 제기와 증빙 사진 제출
첫 버전 제외 범위
- 실제 은행 이체
- 은행 이체용 파일 생성
- 여러 매장 선택·통합 관리
- 별도 문자·카카오톡 알림
- 등록되지 않은 상품의 고도화된 자동 연결
2. 사용자 역할과 권한
| 역할 | 할 수 있는 일 | 할 수 없는 일 |
|---|---|---|
| 정산 담당자 | 농가·품목·규칙 등록, 계산대 판매 파일 업로드, 상품 연결, 반품·폐기 등록, 오류 처리, 정산서 생성 | 마감 권한이 없으면 최종 마감 불가 |
| 점장·마감 권한자 | 정산 담당자의 기능, 정산 합계 확인, 정산 마감 | 마감된 정산서 원본 수정 불가 |
| 운영자 관리자 | 담당자 계정과 권한 관리 | 마감된 정산서 원본 수정 불가 |
| 농가 | 본인 정산서 조회, 내역 내려받기, 이의 제기, 증빙 사진 제출 | 다른 농가의 정산서와 증빙 조회 불가 |
모든 규칙 변경, 파일 업로드, 직접 상품 연결, 반품·폐기 등록, 오류 처리, 마감과 정정 작업에는 담당자와 처리 시점을 자동으로 기록한다.
3. 전체 화면 흐름
운영자 초기 설정 흐름
[operator-login]
운영자 로그인
↓
[settlement-dashboard]
주간 정산 현황
↓
[farm-product-rules]
농가·품목·정산 규칙 등록
↓
[operator-login]
담당자 계정과 마감 권한 설정
↓
[settlement-dashboard]
첫 정산 준비 완료
매주 정산 흐름
[settlement-dashboard]
대상 정산 주차 확인
↓
[sales-upload-mapping]
계산대 판매 파일 업로드·상품 연결
↓
[transaction-history]
판매·할인·반품·폐기 내역 확인
↓
[reconciliation-errors]
오류 처리·매장 매출 합계 대조
↓
[settlement-close]
농가별 정산서 생성·목요일 마감
↓
[correction-history]
마감 기록과 이후 정정 항목 확인
농가 이용 흐름
[farmer-login]
농가 로그인
↓
[screen1]
이번 주 받을 금액과 입금 예정일 확인
↓
[farmer-settlement-view]
정산서 계산 내역 확인
↓
[farmer-settlement]
판매·할인·반품·폐기 세부 내역 확인
↓
이의 제기와 증빙 사진 제출
↓
[dispute-management]
운영자가 이의 처리
4. 정산 상태
| 상태 | 의미 | 가능한 행동 |
|---|---|---|
| 준비 중 | 대상 정산 주차만 생성된 상태 | 판매 파일 업로드, 규칙 등록 |
| 확인 필요 | 미연결 상품이나 정산 오류가 남은 상태 | 상품 연결, 규칙 연결, 내역 수정 |
| 대조 필요 | 거래 오류는 없지만 매장 매출 차이가 남은 상태 | 대조 항목 확인 |
| 마감 가능 | 모든 오류가 해결되고 대조 차이가 0원인 상태 | 정산서 생성, 마감 |
| 마감 완료 | 권한자가 마감해 원본이 잠긴 상태 | 조회, 내려받기, 정정 항목 등록 |
| 입금 예정 | 농가 화면에 입금 예정일이 표시된 상태 | 실제 이체 처리는 서비스 밖에서 진행 |
정산 상태 변경은 서버에서 검사한다. 화면에서 버튼만 숨기는 방식으로 마감을 제한하지 않는다.
5. 운영자 화면
[operator-login] 운영자 로그인과 권한 관리
목적
운영자가 서비스에 로그인하고 정산 담당자와 마감 권한자를 관리한다.
진입 조건
- 로그아웃 상태에서 운영자 서비스 주소로 접속
- 로그인 후 공통 메뉴의
담당자·권한선택
사용자가 보는 정보
로그인 상태
- 서비스명
직매장 정산 자동화 - 아이디
- 비밀번호
- 로그인 버튼
- 로그인 오류 안내
권한 관리 상태
- 담당자 이름
- 로그인 아이디
- 역할
- 정산 담당자
- 점장·마감 권한자
- 운영자 관리자
- 계정 상태
- 사용 중
- 사용 중지
- 마지막 로그인 일시
- 계정 생성·수정 담당자와 처리 시점
할 수 있는 행동
- 운영자 로그인
- 담당자 계정 등록
- 담당자 역할 변경
- 마감 권한 부여·해제
- 퇴사자나 미사용 계정 중지
- 비밀번호 초기화
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 로그인되었습니다. 또는 담당자 권한을 저장했습니다. |
| 빈 상태 | 등록된 담당자가 없습니다. 첫 담당자를 등록해 주세요. |
| 오류 | 아이디 또는 비밀번호를 확인해 주세요. |
| 권한 오류 | 담당자 권한을 변경할 수 없습니다. |
| 저장 오류 | 권한이 저장되지 않았습니다. 다시 시도해 주세요. |
완료 조건
- 로그인한 사용자에게 허용된 운영자 메뉴만 표시된다.
- 마감 권한이 없는 담당자는 정산 마감 버튼을 실행할 수 없다.
- 사용 중지된 계정은 로그인할 수 없다.
다음 화면
- 로그인 성공 →
[settlement-dashboard] - 담당자 등록 완료 →
[operator-login]권한 목록 - 농가 로그인 계정 관리는 →
[farm-product-rules]농가 탭
[settlement-dashboard] 주간 정산 현황 화면
목적
이번 정산 주차의 진행 상태와 마감 가능 여부를 한곳에서 확인한다.
진입 조건
- 운영자 로그인 완료
- 운영자 공통 메뉴에서
주간 정산 현황선택
사용자가 보는 정보
- 정산 주차 시작일·종료일
- 예정 마감일
- 농가 화면에 표시할 입금 예정일
- 계산대 판매 파일 업로드 상태
- 마지막 업로드 일시와 담당자
- 전체 판매 건수와 판매금액
- 미연결 상품 수
- 정산 규칙이 없는 거래 수
- 확인되지 않은 할인·반품·폐기 수
- 중복 가능성이 있는 거래 수
- 매장 매출 대조 차이
- 농가별 정산서 생성 상태
- 현재 정산 상태
마감 가능,확인 필요,마감 불가표시
할 수 있는 행동
- 대상 정산 주차 생성
- 입금 예정일 설정
- 계산대 판매 파일 업로드로 이동
- 미연결 상품 처리로 이동
- 판매·할인·반품·폐기 내역으로 이동
- 오류 목록으로 이동
- 농가별 정산서 생성·마감으로 이동
- 농가 이의 제기 목록으로 이동
핵심 표시 예시
2026년 8월 4주차
판매 기간: 8월 21일~8월 27일
마감 예정일: 8월 27일 목요일
입금 예정일: 8월 31일 월요일
현재 상태: 마감 불가
미연결 상품 3건
정산 규칙 오류 1건
확인 필요 내역 2건
매출 대조 차이 12,000원
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 모든 오류가 없고 차이가 0원이면 정산을 마감할 수 있습니다. |
| 빈 상태 | 이번 정산 주차에 등록된 판매 내역이 없습니다. |
| 오류 | 현황을 불러오지 못했습니다. 다시 시도해 주세요. |
| 마감 불가 | 차단 사유와 이동 버튼을 함께 표시 |
| 마감 완료 | 마감 일시, 마감 담당자, 최종 지급액 합계 표시 |
완료 조건
- 운영자가 현재 막혀 있는 작업을 화면 한 곳에서 확인할 수 있다.
- 각 오류 수를 누르면 해당 오류만 걸러진 화면으로 이동한다.
- 오류가 있거나 대조 차이가 0원이 아니면 마감 가능 상태가 되지 않는다.
다음 화면
- 판매 파일 처리 →
[sales-upload-mapping] - 거래 확인 →
[transaction-history] - 오류·대조 →
[reconciliation-errors] - 정산서·마감 →
[settlement-close] - 이의 처리 →
[dispute-management]
[farm-product-rules] 농가·품목·정산 규칙 관리
목적
농가, 품목, 품목군, 상품코드와 확정된 정산 약정을 등록한다.
진입 조건
- 정산 담당자 이상의 권한으로 로그인
- 공통 메뉴에서
농가·품목·정산 규칙선택
화면 구성
1. 농가 탭
- 농가명
- 대표자 또는 담당자명
- 연락처
- 입점일
- 이용 상태
- 농가 로그인 계정 연결 상태
- 내부 관리 메모
2. 품목·품목군 탭
- 품목군
- 품목명
- 규격·포장 단위
- 상품코드
- 출하 농가
- 판매 중·중지 상태
3. 수수료율 탭
- 규칙 이름
- 대상 농가
- 대상 품목 또는 품목군
- 수수료율
- 적용 시작일
- 적용 종료일
- 약정 근거
- 등록·변경 담당자
- 적용 상태
4. 할인 규칙 탭
- 적용 농가·품목
- 할인 유형
- 할인 수수료 기준
- 할인 전 금액
- 할인 후 금액
- 할인 부담 주체
- 농가·매장 분담 비율
- 적용 시작일·종료일
- 약정 근거
5. 반품·폐기 규칙 탭
- 대상 농가·품목
- 처리 유형
- 부담 주체
- 농가
- 매장
- 공동 부담
- 부담 비율
- 적용 시작일·종료일
- 약정 근거
할 수 있는 행동
- 농가 등록·수정·사용 중지
- 농가 로그인 계정 연결·중지
- 품목과 상품코드 등록
- 품목군 생성
- 새 정산 규칙 등록
- 기존 규칙에 종료일 지정
- 기존 규칙을 복사해 새 적용 시작일로 등록
- 선택한 날짜에 적용될 규칙 미리보기
- 같은 기간에 겹치는 규칙 확인
규칙 적용 기준
더 구체적으로 등록된 확정 규칙을 우선 적용한다.
- 농가와 개별 품목
- 농가와 품목군
- 농가 전체
- 개별 품목
- 품목군
- 확정된 매장 기본 규칙
일치하는 규칙이 없으면 임의로 계산하지 않고 정산 오류로 처리한다.
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 2026년 9월 1일부터 적용할 규칙을 등록했습니다. |
| 빈 상태 | 등록된 농가가 없습니다. 또는 등록된 정산 규칙이 없습니다. |
| 규칙 충돌 | 같은 대상과 적용 기간에 겹치는 규칙이 있습니다. |
| 마감 데이터 변경 시도 | 마감된 정산에 적용된 규칙은 변경할 수 없습니다. |
| 입력 오류 | 적용 시작일, 대상, 수수료율 또는 부담 주체 누락 안내 |
완료 조건
- 모든 입점 농가와 판매 품목이 등록된다.
- 상품코드가 농가와 품목에 연결된다.
- 수수료율, 할인 수수료, 반품·폐기 부담 기준에 적용 시작일이 있다.
- 적용 중인 규칙을 덮어쓰지 않고 변경 이력이 남는다.
- 확정된 약정만 적용 상태로 등록된다.
다음 화면
- 등록 완료 →
[settlement-dashboard] - 상품코드 연결 확인 →
[sales-upload-mapping] - 규칙 누락 오류 확인 →
[reconciliation-errors]
[sales-upload-mapping] 계산대 판매 파일 업로드와 상품 연결
목적
계산대 판매 파일을 올리고 상품코드가 일치하는 판매 항목을 농가와 품목에 연결한다.
진입 조건
- 대상 정산 주차가 생성됨
- 계산대 판매 파일이 준비됨
- 정산 담당자 이상의 권한으로 로그인
사용자가 보는 정보
- 대상 정산 주차와 판매 기간
- 지원 파일 형식
- 업로드할 파일 선택 영역
- 이전 업로드 파일명·업로드 일시·담당자
- 파일 안의 거래 건수와 매출 합계
- 자동 연결된 상품 수
- 처음 보는 상품코드 수
- 중복 가능 파일과 거래 수
- 업로드 처리 결과
상품 연결 목록
| 항목 | 내용 |
|---|---|
| 상품코드 | 계산대 판매 파일에 들어 있는 코드 |
| 파일의 품목명 | 계산대 판매 파일에 기록된 이름 |
| 거래 건수 | 해당 코드로 판매된 건수 |
| 판매금액 | 해당 코드의 판매 합계 |
| 연결 농가 | 등록 농가 선택 |
| 연결 품목 | 등록 품목 선택 |
| 연결 방식 | 자동 연결 또는 담당자 직접 연결 |
| 상태 | 연결 완료 또는 확인 필요 |
할 수 있는 행동
- 계산대 판매 파일 선택·업로드
- 업로드 전 정산 주차 확인
- 처음 보는 상품코드의 농가와 품목 선택
- 선택한 연결 결과 확정
- 동일 상품코드의 다음 업로드에 연결 재사용
- 잘못 연결된 미마감 상품 연결 변경
- 중복 의심 거래 확인
- 업로드 결과 내려받기
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 전체 1,248건을 불러왔습니다. 처음 보는 상품코드 3개를 연결해 주세요. |
| 전체 연결 완료 | 모든 상품이 농가와 품목에 연결되었습니다. |
| 빈 상태 | 올린 계산대 판매 파일이 없습니다. |
| 파일 오류 | 지원하지 않는 형식, 날짜 오류, 금액 오류, 빈 필수 항목 표시 |
| 중복 오류 | 이미 올린 파일과 같은 파일일 수 있습니다. |
| 미연결 오류 | 상품코드 88012345의 농가와 품목을 선택해 주세요. |
| 마감 후 업로드 | 마감된 정산 주차에는 판매 파일을 추가할 수 없습니다. |
완료 조건
- 파일의 대상 기간이 정산 주차와 일치한다.
- 모든 판매 항목에 농가와 품목이 연결된다.
- 중복으로 판정된 거래가 남아 있지 않다.
- 직접 연결한 결과에 담당자와 처리 시점이 저장된다.
- 원본 파일 식별값과 거래 식별값이 보관된다.
다음 화면
- 연결 완료 →
[transaction-history] - 정산 규칙 누락 확인 →
[reconciliation-errors] - 현황으로 돌아가기 →
[settlement-dashboard]
[transaction-history] 판매·할인·반품·폐기 내역 확인
목적
판매 원장을 기준으로 판매, 할인 판매, 반품, 폐기와 미회수 재고 내역을 확인하고 필요한 수기 기록을 등록한다.
진입 조건
- 계산대 판매 파일 업로드 완료
- 또는 운영자 공통 메뉴에서
거래 내역선택
사용자가 보는 정보
- 거래일시
- 거래번호
- 상품코드
- 농가
- 품목과 품목군
- 수량
- 정상 판매금액
- 할인액
- 실제 판매금액
- 반품 금액
- 적용 수수료율
- 할인 수수료 기준
- 반품·폐기 부담 주체
- 적용 규칙
- 확인 상태
할 수 있는 행동
- 정산 주차, 농가, 품목, 거래 유형별 검색
- 판매·할인·반품·폐기 내역 상세 확인
- 확인되지 않은 할인 부담 주체 확정
- 계산대 판매 파일에 없는 반품 기록 등록
- 폐기·미회수 재고 기록 등록
- 증빙 사진 첨부
- 농가에 알린 날짜와 방법 기록
- 미마감 거래의 잘못된 상품 연결 수정
- 선택한 거래를 오류 목록에서 확인
폐기·미회수 등록 항목
- 농가
- 품목
- 수량
- 정상 판매가 또는 기준 금액
- 처리 유형
- 회수 완료
- 미회수
- 폐기
- 폐기 사유
- 부담 주체
- 공동 부담 비율
- 증빙 사진
- 농가에 알린 날짜
- 알린 방법
- 상세 내용
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 폐기 내역을 등록했습니다. 이번 정산 주차에 반영됩니다. |
| 빈 상태 | 선택한 조건에 해당하는 내역이 없습니다. |
| 확인 필요 | 부담 주체나 적용 규칙이 없는 내역에 노란색 표시 |
| 필수 입력 오류 | 농가, 품목, 수량, 사유, 부담 주체 누락 안내 |
| 마감 후 수정 | 마감된 거래는 수정할 수 없습니다. 정정 항목을 등록해 주세요. |
| 사진 오류 | 지원하지 않는 파일이거나 업로드에 실패했다는 안내 |
완료 조건
- 모든 할인 판매에 할인 수수료 기준이 연결된다.
- 모든 반품·폐기 내역에 농가, 품목, 수량, 사유와 부담 주체가 있다.
- 담당자와 등록 시점이 자동으로 남는다.
- 마감된 거래는 조회만 가능하다.
다음 화면
- 오류 검사 →
[reconciliation-errors] - 정산 현황 →
[settlement-dashboard] - 마감된 거래 정정 →
[correction-history]
[reconciliation-errors] 오류 목록과 매장 매출 합계 대조
목적
정산을 막는 오류를 처리하고 계산대 판매 파일의 매장 매출과 농가별 정산 계산을 대조한다.
진입 조건
- 계산대 판매 파일 업로드 완료
- 운영자 대시보드에서 오류 수 또는 대조 차이 선택
사용자가 보는 정보
오류 분류
- 농가·품목 미연결
- 정산 규칙 없음
- 수수료율 없음
- 할인 수수료 기준 없음
- 반품 부담 주체 없음
- 폐기 부담 주체 없음
- 중복 가능 거래
- 대상 기간 밖의 거래
- 금액 또는 수량 오류
- 매장 매출 합계 불일치
오류별 정보
- 오류 유형
- 관련 거래
- 농가와 품목
- 영향 금액
- 오류 설명
- 해결 방법
- 처리 담당자와 시점
매출 대조표
- 계산대 판매 파일의 판매 총액
- 소비자 반품·취소 금액
- 순 판매액
- 농가 지급액 합계
- 수수료 합계
- 농가 부담 반품·폐기 금액
- 매장 부담 할인 보전액
- 정정 항목 합계
- 기타 확정 조정 항목
- 대조 차이
할 수 있는 행동
- 오류 유형별 필터
- 관련 거래 열기
- 상품 연결 화면으로 이동
- 정산 규칙 등록 화면으로 이동
- 할인·반품·폐기 내역 수정
- 중복 거래 제외 또는 정상 거래로 확정
- 오류 처리 사유 입력
- 대조 계산 다시 실행
- 해결된 오류 표시
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 모든 오류가 해결되었습니다. 매출 대조 차이는 0원입니다. |
| 빈 상태 | 확인할 오류가 없습니다. |
| 마감 불가 | 정산 규칙이 없는 거래 2건 때문에 마감할 수 없습니다. |
| 대조 오류 | 매장 매출과 정산 반영 합계가 12,000원 다릅니다. |
| 재계산 오류 | 대조 결과를 계산하지 못했습니다. 다시 시도해 주세요. |
완료 조건
아래 조건을 모두 만족해야 한다.
- 미연결 상품 0건
- 농가 미연결 거래 0건
- 정산 규칙이 없는 거래 0건
- 미확정 할인·반품·폐기 0건
- 중복 가능 거래 0건
- 매장 매출 대조 차이 0원
- 대상 기간의 계산대 판매 파일 확인 완료
다음 화면
- 모든 오류 해결 →
[settlement-close] - 상품 연결 →
[sales-upload-mapping] - 거래 수정 →
[transaction-history] - 규칙 등록 →
[farm-product-rules]
[settlement-close] 농가별 정산서 생성·마감·정정 이력
목적
농가별 정산서를 생성하고 점장 또는 마감 권한자가 정산을 마감한다.
진입 조건
- 정산 오류가 모두 해결됨
- 매장 매출 대조 차이가 0원
- 정산서 생성 또는 마감 권한 보유
사용자가 보는 정보
- 정산 주차
- 판매 기간
- 마감 예정일
- 입금 예정일
- 농가 수
- 농가별 판매금액
- 농가별 수수료
- 할인·반품·폐기 차감
- 정정 항목
- 농가별 지급액
- 전체 지급액 합계
- 수수료 합계
- 대조 결과
- 정산서 생성 상태
- 마감 담당자와 마감 일시
할 수 있는 행동
- 농가별 정산서 미리보기
- 농가별 정산서 일괄 생성
- 특정 농가 정산서 열기
- 운영자 보관용 정산서 내려받기
- 마감 전 오류 화면으로 돌아가기
- 마감 권한자가 정산 마감
- 마감 후 정정 항목 등록 화면으로 이동
마감 확인 문구
2026년 8월 4주차 정산을 마감하시겠습니까?
마감 후에는 판매 내역, 수수료율, 할인·반품·폐기 금액과
농가별 지급액을 수정할 수 없습니다.
마감 후 발견된 오류는 다음 정산의 정정 항목으로 반영됩니다.
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 생성 성공 | 30개 농가의 정산서를 생성했습니다. |
| 마감 성공 | 2026년 8월 4주차 정산을 마감했습니다. |
| 빈 상태 | 생성할 농가별 정산 내역이 없습니다. |
| 마감 권한 없음 | 정산 마감 권한이 없습니다. |
| 마감 차단 | 남은 오류 수와 대조 차이를 표시 |
| 마감 후 | 모든 금액 필드를 읽기 전용으로 표시 |
| 생성 오류 | 실패한 농가와 원인을 표시 |
완료 조건
- 모든 대상 농가의 정산서가 생성된다.
- 전체 정산 합계가 대조 결과와 일치한다.
- 권한자만 마감할 수 있다.
- 마감 시점의 거래, 규칙과 계산 결과 복사본이 보관된다.
- 마감된 정산서 변경 요청을 서버에서 차단한다.
- 농가 화면에는 마감된 정산서만 공개한다.
다음 화면
- 마감 완료 →
[correction-history] - 농가별 상세 확인 →
[farmer-settlement-view]의 운영자 미리보기 - 오류 해결 →
[reconciliation-errors] - 이의 확인 →
[dispute-management]
[correction-history] 마감과 정정 이력 화면
목적
마감된 정산서의 원본을 유지하면서 이후 발견된 오류를 다음 정산의 정정 항목으로 연결한다.
진입 조건
- 하나 이상의 정산 주차가 마감됨
[settlement-close]에서 정정 항목 선택- 마감된 거래 상세에서
정정 항목 등록선택
사용자가 보는 정보
- 원 정산 주차
- 원 정산서
- 원 거래
- 대상 농가와 품목
- 정정 사유
- 정정 전 금액
- 정정 후 금액
- 차액
- 수수료 차액
- 최종 반영액
- 반영할 다음 정산 주차
- 등록 담당자와 등록 시점
- 다음 정산 반영 여부
- 다음 정산 마감 여부
할 수 있는 행동
- 마감된 정산서 열기
- 원 거래 선택
- 정정 사유 입력
- 증빙 첨부
- 정정 전후 금액 입력·계산
- 다음 미마감 정산 주차 선택
- 정정 항목 저장
- 다음 정산서에서 반영 결과 확인
정정 예시
원 정산 주차: 2026년 8월 4주차
정정 사유: 판매 누락 1건
원 판매금액: 0원
정정 판매금액: 5,000원
수수료 차액: -500원
다음 정산 반영액: +4,500원
반영 주차: 2026년 9월 1주차
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 정정 항목 4,500원을 다음 정산에 등록했습니다. |
| 빈 상태 | 등록된 정정 항목이 없습니다. |
| 원본 미연결 | 원 정산서와 원 거래를 선택해 주세요. |
| 마감 주차 선택 오류 | 이미 마감된 주차에는 정정 항목을 추가할 수 없습니다. |
| 원본 수정 시도 | 마감된 원 정산서는 변경할 수 없습니다. |
완료 조건
- 정정 항목에 원 정산서가 연결된다.
- 가능한 경우 원 거래도 연결된다.
- 정정 사유와 담당자가 기록된다.
- 정정 전후 금액이 함께 보관된다.
- 원 정산서 금액은 변경되지 않는다.
- 다음 정산서에는 일반 판매와 구분된
정정 항목으로 표시된다. - 다음 정산 마감 시 마감 권한자가 정정 항목을 함께 확인한다.
다음 화면
- 다음 주차 확인 →
[settlement-dashboard] - 다음 정산서 확인 →
[settlement-close] - 이의 제기에서 시작된 정정 확인 →
[dispute-management]
[dispute-management] 농가 이의 제기 처리 화면
목적
농가가 제출한 이의 제기와 증빙 사진을 확인하고 처리 결과와 안내 기록을 남긴다.
진입 조건
- 농가가
[farmer-settlement]또는[screen1]에서 이의 제기 제출 - 운영자가 대시보드의 이의 제기 수 선택
- 정산서 화면에서 관련 이의 제기 선택
사용자가 보는 정보
- 접수 번호
- 접수 일시
- 농가
- 대상 정산 주차
- 대상 정산서
- 대상 판매·할인·반품·폐기·정정 내역
- 농가가 작성한 내용
- 증빙 사진
- 처리 상태
- 접수
- 확인 중
- 처리 완료
- 처리 결과
- 처리 담당자
- 처리일
- 농가에 알린 날짜
- 농가에 알린 방법
- 정정 항목 연결 여부
할 수 있는 행동
- 상태를
접수에서확인 중으로 변경 - 관련 정산서와 거래 열기
- 증빙 사진 확대 확인
- 처리 결과 작성
- 담당자 지정
- 처리일 입력
- 농가에 알린 날짜와 방법 기록
- 금액 변경이 필요하면 정정 항목 생성
- 처리 완료
첫 버전에서는 처리 결과를 자동으로 알리지 않는다. 운영자가 전화, 문자, 방문 등 실제로 알린 날짜와 방법을 기록한다.
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 이의 제기를 처리 완료했습니다. |
| 빈 상태 | 접수된 이의 제기가 없습니다. |
| 확인 중 | 담당자와 처리 시작일 표시 |
| 필수 입력 오류 | 처리 결과, 담당자, 처리일, 안내 날짜·방법 누락 안내 |
| 사진 오류 | 증빙 사진을 불러오지 못했습니다. |
| 마감 금액 변경 시도 | 마감된 정산서는 수정할 수 없습니다. 정정 항목을 등록해 주세요. |
완료 조건
- 처리 결과, 담당자와 처리일이 기록된다.
- 농가에 알린 날짜와 방법이 기록된다.
- 금액 변경이 있으면 원본 수정이 아닌 정정 항목이 생성된다.
- 처리 완료 뒤 농가 화면에서 처리 결과를 확인할 수 있다.
다음 화면
- 정정 등록 →
[correction-history] - 관련 정산서 →
[settlement-close] - 목록으로 돌아가기 →
[dispute-management]
6. 농가용 스마트폰 화면
[farmer-login] 농가 로그인 화면
목적
농가가 본인 계정으로 로그인하고 본인 정산 내역에만 접근한다.
진입 조건
- 농가가 서비스 주소에 직접 접속
- 로그인하지 않은 상태에서 농가용 화면 접근
- 로그아웃 후 다시 접속
사용자가 보는 정보
- 서비스명
직매장 정산 자동화 - 농가 로그인 안내
- 아이디
- 비밀번호
- 로그인 버튼
- 큰 글씨 오류 안내
할 수 있는 행동
- 아이디와 비밀번호 입력
- 로그인
- 비밀번호 표시·숨기기
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 본인 농가의 최근 정산 화면으로 이동 |
| 오류 | 아이디 또는 비밀번호를 다시 확인해 주세요. |
| 계정 중지 | 사용이 중지된 계정입니다. 로컬푸드 직매장에 문의해 주세요. |
| 연결 오류 | 농가 정보와 연결되지 않은 계정입니다. |
완료 조건
- 농가 계정과 농가 정보가 정확히 연결된다.
- 로그인한 농가는 본인 정산서만 볼 수 있다.
- 주소의 정산서 번호를 바꿔도 다른 농가 자료에 접근할 수 없다.
다음 화면
- 로그인 성공 →
[screen1]
확인 필요
첫 로그인과 비밀번호 복구 방법은 확정되지 않았다. 첫 버전에서는 운영자가 농가 계정을 발급하고 초기 비밀번호를 전달하는 방식으로 구현하는 것을 가정한다.
[screen1] 농가용 큰 글씨 정산 조회와 이의 제기
목적
농가가 로그인 직후 이번 주 받을 금액과 입금 예정일을 가장 먼저 확인한다.
진입 조건
- 농가 로그인 성공
- 농가용 화면의
이번 주 정산선택
사용자가 보는 정보
새봄농가
2026년 8월 4주차
입금 예정일 8월 31일 월요일
이번 주 받을 금액
213,200원
판매금액 245,000원
수수료 -23,800원
기타 차감 -10,000원
정정 금액 +2,000원
추가 표시 정보:
- 정산 상태
- 최근 마감된 정산 주차
- 판매 건수
- 할인·반품·폐기 내역 수
- 처리 중인 이의 제기 수
할 수 있는 행동
- 정산서 자세히 보기
- 상품별 판매 내역 보기
- 할인·반품·폐기 내역 보기
- 정산서 내려받기
- 이의 제기
- 이전 주차 정산서 선택
- 로그아웃
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 받을 금액과 입금 예정일을 화면 상단에 표시 |
| 빈 상태 | 확인할 수 있는 마감된 정산서가 없습니다. |
| 예정일 없음 | 입금 예정일을 확인 중입니다. 로컬푸드 직매장에 문의해 주세요. |
| 오류 | 정산 내역을 불러오지 못했습니다. 다시 시도해 주세요. |
| 이의 접수 완료 | 이의 제기가 접수되었습니다. |
완료 조건
- 농가가 별도 메뉴 탐색 없이 받을 금액을 확인할 수 있다.
- 다른 농가의 이름이나 금액이 표시되지 않는다.
- 마감된 정산서만 표시된다.
- 금액 항목을 누르면 세부 근거로 이동한다.
다음 화면
- 정산서 자세히 보기 →
[farmer-settlement-view] - 거래 세부 내역 →
[farmer-settlement] - 이의 제기 제출 후 →
[screen1]접수 결과
[farmer-settlement-view] 농가용 큰 글씨 조회 화면
목적
농가가 특정 정산 주차의 지급액 계산 구조를 큰 글씨로 확인한다.
진입 조건
[screen1]에서정산서 자세히 보기선택- 이전 정산 주차 선택
- 본인에게 연결된 마감된 정산서만 접근 가능
사용자가 보는 정보
- 농가명
- 정산 주차와 판매 기간
- 입금 예정일
- 받을 금액
- 판매금액
- 할인 관련 차감·보전
- 수수료
- 반품 금액
- 폐기·미회수 금액
- 정정 항목
- 적용된 수수료율
- 마감일
- 정산서 내려받기 버튼
표시 예시
이번 주 판매금액 245,000원
할인 관련 차감 -12,000원
매장 부담 할인 보전 +5,000원
수수료 -23,800원
폐기·미회수 차감 -3,000원
지난 정산 정정 +2,000원
────────────────────
받을 금액 213,200원
할 수 있는 행동
- 각 금액 항목의 세부 내역 열기
- 적용 수수료율과 계산 기준 확인
- 정정 항목의 원 정산 주차 확인
- 정산서 내려받기
- 이의 제기
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 전체 금액과 계산 근거 표시 |
| 세부 내역 없음 | 해당 항목에 이번 주 내역 없음 표시 |
| 권한 오류 | 이 정산서를 볼 수 없습니다. |
| 파일 오류 | 정산서를 내려받지 못했습니다. 다시 시도해 주세요. |
| 불러오기 오류 | 정산서 정보를 불러오지 못했습니다. |
완료 조건
- 최종 지급액보다
받을 금액표현을 우선 사용한다. - 모든 차감·보전·정정 항목을 구분해 표시한다.
- 정정 항목에는 원 정산 주차와 정정 사유가 표시된다.
- 내려받기 파일도 로그인 권한을 확인한 뒤 제공한다.
다음 화면
- 세부 내역 →
[farmer-settlement] - 이번 주 요약 →
[screen1]
[farmer-settlement] 농가용 스마트폰 화면
목적
농가가 본인의 판매·할인·반품·폐기 내역을 거래 단위로 확인하고 특정 내역에 이의를 제기한다.
진입 조건
[screen1]에서 세부 내역 선택[farmer-settlement-view]의 금액 항목 선택- 로그인한 농가 본인의 정산서만 접근 가능
사용자가 보는 정보
판매 내역
- 판매일
- 품목명과 규격
- 판매 수량
- 정상 판매금액
- 할인액
- 실제 판매금액
- 수수료율
- 수수료 금액
- 농가 지급 반영액
할인 내역
- 할인 유형
- 할인 전 금액
- 할인 후 금액
- 할인 부담 주체
- 할인 수수료 기준
반품·폐기 내역
- 처리일
- 품목과 수량
- 반품 또는 폐기 사유
- 부담 주체
- 농가 부담 금액
- 농가에 알린 기록
정정 내역
- 원 정산 주차
- 정정 사유
- 정정 금액
- 이번 정산 반영액
할 수 있는 행동
- 판매·할인·반품·폐기·정정 탭 선택
- 날짜와 품목별 내역 확인
- 특정 내역 선택
- 이의 제기 내용 작성
- 증빙 사진 첨부
- 이의 제기 제출
- 기존 이의 처리 상태와 결과 확인
이의 제기 입력 항목
- 대상 내역
- 이의 제기 내용
- 증빙 사진
- 농가가 원하는 연락 방법
- 제출 버튼
상태별 화면
| 상태 | 표시 내용 |
|---|---|
| 성공 | 선택한 정산 주차의 세부 내역 표시 |
| 빈 상태 | 이번 주에는 폐기 내역이 없습니다. |
| 이의 접수 성공 | 이의 제기가 접수되었습니다. 처리 결과는 이 화면에서 확인할 수 있습니다. |
| 사진 오류 | 파일 크기 또는 형식 오류 안내 |
| 권한 오류 | 본인의 정산 내역만 확인할 수 있습니다. |
| 제출 오류 | 이의 제기를 제출하지 못했습니다. 다시 시도해 주세요. |
완료 조건
- 농가는 금액의 근거가 된 거래를 확인할 수 있다.
- 이의 제기 대상 거래가 자동으로 연결된다.
- 사진은 공개 주소가 아닌 권한 확인 방식으로 제공된다.
- 농가가 제출한 내용은 운영자의
[dispute-management]에 표시된다.
다음 화면
- 정산서 요약 →
[farmer-settlement-view] - 이번 주 홈 →
[screen1] - 제출된 이의 처리 → 운영자
[dispute-management]
7. 실제 주간 사용 흐름
월요일 또는 정산 주차 시작일
- 정산 담당자가
[settlement-dashboard]에서 새 정산 주차를 연다. - 판매 시작일, 종료일, 목요일 마감일과 입금 예정일을 확인한다.
- 새 농가나 품목이 있으면
[farm-product-rules]에 등록한다. - 적용 시작일이 된 새 수수료율과 할인·폐기 규칙을 확인한다.
판매 기간 중
- 계산대 판매 파일을
[sales-upload-mapping]에 올린다. - 등록된 상품코드는 자동으로 연결된다.
- 처음 보는 상품코드는 정산 담당자가 농가와 품목을 직접 선택한다.
[transaction-history]에서 할인 판매, 반품, 폐기와 미회수 재고를 확인한다.- 계산대 판매 파일에 없는 폐기나 현장 처리 내역은 직접 등록한다.
목요일 마감 전
[reconciliation-errors]에서 미연결 상품과 정산 규칙 누락을 처리한다.- 확인되지 않은 할인·반품·폐기 부담 주체를 확정한다.
- 중복 가능 거래를 확인한다.
- 계산대 판매 파일 매출과 정산 합계를 대조한다.
- 대조 차이가 0원인지 확인한다.
[settlement-close]에서 농가별 정산서를 생성한다.- 점장 또는 마감 권한자가 최종 금액을 확인한다.
목요일 마감
- 마감 권한자가 마감 확인 문구를 읽고 정산 마감을 실행한다.
- 해당 정산 주차의 판매, 규칙, 수수료와 지급액이 잠긴다.
- 농가는
[screen1]에서 마감된 정산서와 입금 예정일을 확인한다.
마감 후 오류 발견
- 원 정산서는 수정하지 않는다.
- 운영자가
[correction-history]에서 원 정산서와 거래를 선택한다. - 정정 사유와 전후 금액을 기록한다.
- 다음 미마감 정산 주차에 정정 항목으로 연결한다.
- 다음 주 정산서에 일반 판매와 구분해 표시한다.
8. 공통 화면 기준
운영자 화면
- PC 웹을 기본으로 하되 태블릿에서도 사용할 수 있게 구성한다.
- 왼쪽 공통 메뉴에 다음 항목을 표시한다.
- 주간 정산 현황
- 계산대 판매 파일
- 거래 내역
- 오류·매출 대조
- 정산서·마감
- 이의 제기
- 농가·품목·정산 규칙
- 담당자·권한
- 오류는 건수와 영향 금액을 함께 표시한다.
- 마감 불가 사유 옆에 해결 화면으로 가는 버튼을 둔다.
- 마감 완료 화면에서는 수정 입력창을 표시하지 않는다.
농가 화면
- 스마트폰 세로 화면을 기준으로 한다.
- 농가명, 정산 주차, 받을 금액과 입금 예정일을 화면 상단에 표시한다.
- 한 화면에 하나의 주요 행동만 강조한다.
정산서 자세히 보기,세부 내역 보기,이의 제기처럼 쉬운 표현을 사용한다.- 금액은 원 단위와 천 단위 쉼표를 사용한다.
- 버튼은 손가락으로 누르기 충분한 크기로 제공한다.
- 별도 알림 없이 농가가 직접 로그인해 확인한다.
디자인 가정
제공된 로고와 색상은 없다. 첫 화면 설계에서는 다음을 가정한다.
- 서비스명:
직매장 정산 자동화 - 기본 배경: 흰색
- 주요 행동: 진한 초록색
- 확인 필요: 노란색
- 오류·마감 불가: 빨간색
- 마감 완료: 회색 또는 짙은 초록색
- 농가 화면은 본문과 버튼을 일반 운영자 화면보다 크게 표시
9. 구현 완료 조건
첫 버전은 아래 조건을 모두 충족하면 완료로 본다.
- 실제 계산대 판매 파일을 대상 정산 주차에 올릴 수 있다.
- 등록된 상품코드는 농가와 품목에 자동 연결된다.
- 처음 보는 상품코드는 운영자가 직접 연결할 수 있다.
- 모든 판매 건에 판매일 당시 유효한 정산 규칙이 적용된다.
- 품목별 수수료율과 농가별 예외 수수료율을 처리할 수 있다.
- 할인 전·후 금액 중 할인 수수료 기준을 농가 또는 품목별로 설정할 수 있다.
- 반품·폐기 부담 주체를 농가 또는 품목별로 설정할 수 있다.
- 규칙 없는 거래를 임의 계산하지 않는다.
- 미연결·규칙 누락·미확정 내역·중복 가능 거래가 있으면 마감을 차단한다.
- 매장 매출 대조 차이가 0원이 아니면 마감을 차단한다.
- 마감 권한자만 정산을 마감할 수 있다.
- 마감된 정산서와 거래는 서버에서 수정이 차단된다.
- 마감 후 오류는 다음 정산의 정정 항목으로만 반영된다.
- 농가는 스마트폰에서 받을 금액과 입금 예정일을 먼저 확인한다.
- 농가는 본인의 정산서와 증빙만 볼 수 있다.
- 농가는 특정 내역에 이의를 제기하고 증빙 사진을 제출할 수 있다.
- 운영자는 이의 처리 결과, 담당자, 처리일, 농가에 알린 날짜와 방법을 기록할 수 있다.
- 실제 은행 이체와 은행 이체용 파일은 제공하지 않는다.
10. 구현 전 확인 필요 항목
- 실제 계산대 판매 파일이 CSV인지 엑셀인지
- 파일의 열 이름, 날짜 형식, 거래 고유값과 상품코드 포함 여부
- 거래 고유값이 없을 때 중복 거래를 판정할 기준
- 수수료 원 단위 처리 방식
- 버림
- 반올림
- 올림
- 정산 주차 시작일과 종료 시각
- 목요일에 마감하지 못했을 때 늦은 마감을 허용할지
- 공휴일에 입금 예정일을 어떻게 변경할지
- 농가 첫 로그인과 비밀번호 복구 방식
- 농가 정산서 내려받기 파일 형식
- 구현 가정: PDF
- 증빙 사진의 허용 형식, 개수와 파일 크기
- 판매·정산 정보와 증빙 사진의 보관 기간