im 요구사항 설명서 자동 생성

매장은 접수→정상→일시중지→해지접수→해지완료→취소 6가지 상태를 가지며, 각 상태에 따라 과금 여부와 가능한 작업이 달라집니다.

코드와 기획 모두 6종 상태 정의 일치 (Finding: S-01)

매장은 신규 등록, 양수로 인한 신규, 일반 해지, 양도로 인한 해지 4가지 구분으로 분류되어 과금과 프로모션 승계 규칙이 달라집니다.

코드와 기획 모두 4종 구분 일치 (Finding: S-02)

매장이나 상품을 일시중지하면 과금이 중단되지만, 청구 파일은 0원으로 생성하여 정산 이력을 유지합니다.

코드는 청구 방식별 3종 분기로 고정+건수는 전액 청구, 기획은 일괄 0원 — 금액이 정반대 (Finding: S-03)

• 운영실 확인: 일시중지 시 청구 방식별 금액 계산 정책 재정의 필요

매장 양도 시 양수 매장이 생성되며, 양도 매장의 프로모션 잔여 일수가 양수 매장으로 자동 승계됩니다. 양도와 양수는 동일 매장 코드를 사용합니다.

코드는 매장 구분만 있고, 기획의 승계 프로모션·취소 규칙·설치완료일 제약 등 상세 로직 누락 (Finding: S-04)

• regular-billing/channel-management 코드 분산 가능성 재확인

매장을 다른 브랜드로 이관할 때, 이관 대상 브랜드에 상품이 등록되어 있지 않으면 이관을 차단합니다.

기획에만 명시된 이관 제약 조건 (Finding: S-05)

매장은 UNIDOM에서 기존 매장 정보를 가져오거나, 직접 등록 브랜드에 한해 수기로 입력할 수 있습니다. MPOS는 영업관리에서 자동 등록됩니다.

기획에 명시된 2경로 등록 방식이 코드에 미구현 (Finding: S-06)

매장 등록 시 기본·계약·청구·설치·중계 5개 탭으로 정보를 입력하고, 상세 화면에서는 영업·프로모션·기타매출 탭이 추가됩니다.

코드는 6섹션(A~F), 기획은 등록 5탭·상세 8탭 — 구조 불일치 (Finding: S-07)

매장별로 전자계약 알림톡 발송 여부를 설정할 수 있으며, 1.5차에서는 POS 사용료 계약서만 발송합니다.

1.5차 신규 요건으로 코드 미구현 (Finding: S-08)

매장 주소 입력 시 경도와 위도를 자동 생성하여 저장하며, 운영 관리자와 협력사에게는 노출하지 않습니다.

기획에 명시된 경도·위도 저장 및 권한별 노출 제어 미구현 (Finding: S-09)

매장별로 배민 주문접수 방식을 설정하고, 메뉴 요청 유형(직접 등록/배민 광고/추후 전달/선설치 요청)을 선택합니다.

코드는 메뉴 요청 유형/등록 방식만, 기획은 4종 세분화 (Finding: S-10)

청구 상품별로 주문중계 관련 설정을 입력하여 배달대행 및 플랫폼 연동을 관리합니다.

1.5차 신규 요건으로 코드 미구현 (Finding: S-11)

청구 상품의 결제 수단은 간편결제, 카드 정기, CMS 정기, 직접 납입, 본사 청구, 미과금, 직접 청구, 프로모션, 네이버 9종으로 구분됩니다.

코드와 기획 모두 9종 결제 수단 일치 (Finding: S-12)

청구 상품은 접수, 설치 요청, 설치 진행 중, 설치 완료, 설치 보류, 설치 취소, 해지 접수, 해지 완료, 보류, 일시중지, 사용 제한, 사용 제한 해제 12가지 상태를 가집니다.

코드는 6종만, 기획은 12종 — 나머지는 시스템 자동 전이 가능성 (Finding: S-13)

• 등록 시 6종만 선택 가능한지, 나머지는 자동 전이인지 확인 필요

청구 상품의 과금 시작일은 설치완료일 익일을 기준으로 하며, 접수일 기준은 1.5차에서 제외되었습니다.

코드와 기획 모두 설치완료일 익일 기준 일치 (Finding: S-14)

청구 상품 등록 시 상태 미설정, 청구 대상·결제 수단 미선택, POS 유형 수량 복수 설정, 수량 0 등의 오류를 알럿으로 안내합니다.

기획에 명시된 유효성 검증 로직 미구현 (Finding: S-15)

매장 등록 시 사업자등록번호 중복을 확인하여 동일 사업자번호로 중복 등록을 방지합니다.

코드와 기획 모두 중복 확인 기능 일치 (Finding: S-16)

매장 등록 시 더존 ERP에 거래처 코드를 생성하며, 본사·가맹점·협력사 3종으로 구분하여 관리합니다.

코드와 기획 모두 3종 거래처 코드 일치 (Finding: S-17)

매장별로 계약서, 사업자등록증, 출금동의서 3종 파일을 첨부하고, 이싸인온에서 발송된 메인 계약 번호와 연계합니다.

코드는 범용 파일 유형 드롭다운, 기획은 3종 고정 + 메인 계약 번호 연계 (Finding: S-18)

매장 최초 등록 및 양도·양수 완료 시 전자계약과 간편결제 알림톡이 자동 발송되며, 수정 시에는 발송되지 않습니다.

코드는 체크박스만, 기획은 트리거 조건·재발송·회수 등 상세 로직 명시 (Finding: S-19)

• 운영실 확인: 자동 발송 트리거 조건 및 재발송 정책 재정의 필요

매장 등록 후 설치 완료 상품이 1건 이상이면 매장 상태가 자동으로 정상으로 전환됩니다.

코드와 기획 모두 자동 상태 전환 로직 일치 (Finding: S-20)

매장 등록 후 청구 생성, 알림톡 발송, 더존 연동, 배민 연동 등 7단계 자동 처리가 순차적으로 실행됩니다.

코드에 7단계 절차 명시, 기획은 분산 기술 (Finding: S-21)

마스터는 46개 필드 전체 수정 가능, 운영 관리자는 일부만, 협력사는 상태와 담당자만 수정할 수 있습니다.

코드는 관리자 단일 권한, 기획은 3-tier 세분 권한 (Finding: S-22)

• 운영실 확인: 권한별 수정 가능 필드 매트릭스 재정의 필요

매장 전체 또는 상품별로 일시중지를 설정할 수 있으며, 최대 90일까지 가능하고 횟수 제한은 없습니다. 일시중지 기간은 약정 기간에서 제외됩니다.

코드는 배치 00:05, 기획은 00:00 + 금액 재계산 02:00 분리. 권한별 제약 미구현 (Finding: S-23)

• 운영실 확인: 일시중지 배치 시각 및 권한별 제약 정책 재정의 필요

일시중지 기간과 프로모션 기간이 겹치면 등록을 차단하여 과금 오류를 방지합니다.

기획에 명시된 충돌 방지 로직 미구현 (Finding: S-24)

일시중지 기간은 약정 기간 계산에서 제외되어 위약금 계산 시 반영되지 않습니다.

기획에 명시된 약정 기간 제외 로직 미구현 — 위약금 계산 영향 (Finding: S-25)

• 운영실 확인: 위약금 계산 시 일시중지 기간 제외 정책 재정의 필요

매장 해지 시 결제 해지 요청일을 설정하며, 해지 신청서 PDF를 첨부하고 전자계약 발송 여부를 선택합니다. 해지 접수 상품이 있으면 매장 해지가 불가합니다.

코드는 채널 연동 해제 배치 00:10, 기획은 해지 신청서·전자계약·네이버/요기요 연동 원복 X 등 상세 로직 명시 (Finding: S-26)

• 운영실 확인: 매장 해지 시 채널 연동 해제 및 원복 정책 재정의 필요

해지 시 위약금은 약정 기간 동안의 총 할인가를 1.1로 나눈 금액으로 계산하며, 별도 위약금 파일로 청구합니다. 국세청 상태별 계산 정책은 운영실에서 검토 중입니다.

코드는 위약금 생성 로직 미완성, 기획은 계산 공식 명시 — 국세청 상태별 정책 운영실 정리 중 (Finding: S-27)

• 운영실(BL팀 박지혜, BO팀 정기승) 확인: 국세청 상태별 위약금 계산 정책 정리 필요

결제 해지 요청일 변경 시 D+1 셧다운이 적용되며, 납입 전이면 과금이 재계산되고 납입 완료면 수기 수정/환불 처리합니다.

기획에 명시된 셧다운 및 재계산 규칙 4종 미구현 (Finding: S-28)

• 운영실 확인: 결제 해지 요청일 변경 시 재계산 정책 재정의 필요

매장 취소는 상품/청구 정보를 유지하고 과금만 해지 처리하며, 매장 해지는 상태 값만 업데이트하고 결제 해지 요청일은 변경하지 않습니다.

기획에 명시된 취소 vs 해지 데이터 처리 차이 미구현 (Finding: S-29)

• 운영실 확인: 매장 취소와 해지의 데이터 처리 차이 재정의 필요

가맹점 청구 상품이 3회 미수되면 상품별로 사용 제한 상태로 전환되며, 시스템 직권해지는 없고 안내만 제공합니다.

기획은 가맹점 청구만·3회 미수·청구 파일별 결제 명시, 코드는 상세 로직 확인 필요 (Finding: S-30)

• 운영실 확인: 미수 3회 정책 및 청구 파일별 결제 로직 재정의 필요

사용 제한 상태 및 해지 완료 상품을 대상으로 매장 단위로 일괄 팝업 중지 또는 사용 제한 해제를 처리합니다.

코드는 단순 팝업 중지, 기획은 사용 제한 + 해지 완료 대상·매장 단위 일괄 (Finding: S-31)

매장별로 효성 간편결제 ID를 등록, 삭제, 갱신할 수 있으며, 매장 상태에 따라 버튼 노출이 제어됩니다.

코드와 기획 모두 효성 ID 관리 기능 일치 (기획에 상태별 제약 세밀) (Finding: S-32)

매장의 배민 주문접수 유형을 실시간으로 조회하여 최신 상태를 확인합니다.

코드와 기획 모두 배민 조회 기능 일치 (Finding: S-33)

매장별 계약 파일을 S3에 업로드하고 다운로드할 수 있습니다.

코드와 기획 모두 S3 파일 관리 일치 (Finding: S-34)

청구 건은 미청구, 청구 완료, 납입 완료, 미수, 결손, 환불, 취소 7가지 결제 상태로 관리됩니다.

코드와 기획 모두 7종 결제 상태 일치 (기획 정식 정의 누락) (Finding: S-35)

청구 금액을 수기로 변경하거나 결손 처리할 수 있으며, 권한과 조건에 따라 제한됩니다.

코드에 금액 변경·결손 기능 있음, 기획은 해지 후 납입 완료 케이스만 언급 (Finding: S-36)

• 운영실 확인: 청구 금액 변경 권한 및 조건 재정의 필요

청구 건의 매출을 취소하고 더존 ERP 전표와 연동하여 정산 데이터를 업데이트합니다.

코드에 매출 취소 기능 있음, 기획 미명시 (Finding: S-37)

효성 간편결제로 납입된 청구 건을 실시간으로 카드 취소 처리합니다.

코드에 카드 취소 기능 있음, 기획 미명시 (Finding: S-38)

• 운영실 확인: 카드 취소 정책 및 권한 재정의 필요

청구 건을 선택하여 일괄 환불 처리할 수 있으며, 환불 금액과 사유를 입력합니다.

코드는 범용 환불, 기획은 해지 부수 기능으로 언급 (Finding: S-39)

• 운영실 확인: 환불 처리 정책 및 권한 재정의 필요

가맹점이 직접 납입한 청구 건을 수기로 납입 완료 처리합니다.

코드와 기획 모두 직접납입 처리 일치 (Finding: S-40)

시스템 장애 발생 시 금액 차감 또는 기간 보상을 제공하며, VAT 및 원단위 처리 규칙이 적용됩니다.

코드는 금액차감/기간보상 기능, 기획은 VAT 재정의 운영실 검토 대기 — VAT/원단위 비대칭 핵심 (Finding: S-41)

• 운영실 확인: VAT 처리 금액 계산식 재정의 필요 (2025.08.27)

청구 건의 청구예정일을 수기로 수정하여 과금 일정을 조정합니다.

코드 문서 섹션명·필드 불일치 (장애보상 필드가 청구예정일 수정에 기재) (Finding: S-42)

• ftk-admin 소스 확인: 청구예정일 수정 섹션 정리 필요

청구 건의 최종 청구 ID를 POS 시스템과 동기화하여 최신 상태를 유지합니다.

코드에 최종 청구 ID 갱신 기능 있음, 기획 미명시 (Finding: S-43)

효성 청구의뢰를 삭제하거나 납입을 취소하여 청구 건을 원복합니다.

코드에 삭제·취소 기능, 기획은 납입취소 워크플로우 미정의 (Finding: S-44)

• 운영실 확인: 납입취소 워크플로우 정의 필요

청구 목록을 엑셀 파일로 다운로드하여 외부 시스템에서 활용합니다.

코드와 기획 모두 엑셀 다운로드 일치 (Finding: S-45)

매장 등록 및 양도·양수 시 전자계약이 자동 발송되며, 재발송 및 회수 기능을 제공합니다. 금액 합산 조건과 본사 납부 표시 규칙이 적용됩니다.

코드는 체크박스만, 기획은 트리거 조건·재발송·회수·금액 합산 조건·본사 납부 표시 명시 (Finding: S-46)

• 운영실 확인: 전자계약 발송 트리거 조건 및 재발송 정책 재정의 필요

매장 수명주기 알림톡은 오전 10시 배치로 발송되며, eSign On 계정이 Foodtech와 메이트로 분리되어 템플릿 코드가 다릅니다.

기획에 명시된 배치 시각 및 계정 분리 미구현 (Finding: S-47)

• 운영실 확인: 알림톡 발송 시점 및 계정 분리 정책 재정의 필요

양수신규와 양도해지가 동시에 완료되면 양도해지 알림톡을 발송하지 않으며, 양도해지가 별도로 완료될 때만 발송합니다.

기획에 명시된 예외 처리 로직 미구현 (Jira DEVREQ2024-303) (Finding: S-48)

• 운영실 확인: 양수신규+양도해지 동시 완료 알림톡 정책 재정의 필요

운영 정책상 서류 누락 시 해지/양도해지 완료 처리 자체가 불가하므로, 서류 미첨부 관련 알림톡 7종은 미사용으로 전환되었습니다.

기획에 명시된 미사용 전환 정책 (2025-07-21) (Finding: S-49)

POS 구분, 접수 구분, 사업자등록증 유무, 가맹점 유형, 기타 제휴 구분에 따라 전자계약 서식과 약관이 자동으로 결정됩니다.

기획에 명시된 서식 결정 매트릭스 미구현 (Legacy 179/180/183/184/187 + MATE 46~55 등) (Finding: S-50)

• 운영실 확인: 전자계약 서식 결정 로직 재정의 필요

매장별로 메모를 등록, 수정, 삭제할 수 있으며, 협력사는 등록만 가능하고 수정/삭제는 불가합니다.

코드와 기획 모두 메모 관리 일치 (기획에 권한별 세밀도 추가) (Finding: S-51)

매장의 월별 청구건이 미청구→청구완료→납입완료 또는 미수→결손 등으로 상태 전환되며, 각 상태에서 허용되는 운영 작업(금액변경·환불·취소)이 다릅니다.

기획 다이어그램의 '청구중' 상태가 enum에 없으나 운영 관례로 처리 가능 (Finding: T-01)

운영팀이 청구 완료 전 매장의 청구 금액을 수정할 수 있으며, 300원 미만 입력 시 결손처리 체크박스가 자동 활성화됩니다. 재진입 시 체크 해제하면 결손 취소됩니다.

세부 조건(300원 미만 자동체크, 재진입 해제=결손취소) 검증 필요 (Finding: T-02)

• 300원 미만 자동체크 로직 실제 동작 확인

과거 별도 결손처리 버튼이 있었으나 v0.1.6부터 청구금액변경 팝업 내 체크박스로 통합되었습니다. 레거시 자동 결손 배치가 남아있을 가능성이 있습니다.

레거시 자동 결손 배치 잔존 여부 확인 필요 (Finding: T-03)

• 레거시 자동 결손 배치 존재 여부 및 폐기 계획

납입 완료된 청구건을 취소할 때 금액은 납입금액과 동일하게 고정되며 수정할 수 없습니다. 더존 ERP의 매출·입금 전표도 자동 취소됩니다.

코드는 취소 금액 숫자 입력 가능, 기획은 금액 수정 불가(납입금액 고정) (Finding: T-04)

• 매출취소 금액 수정 가능 여부 최종 확정

효성 간편결제 카드로 납입 완료된 건에 한해 전액 취소가 가능합니다. 부분 취소는 불가하며, 오처리 시 운영팀이 수기로 처리합니다.

전액 취소만 가능, 부분 취소 불가 정책 일치 (Finding: T-05)

납입 완료된 청구건에 대해 환불액을 입력하면 시스템에 히스토리만 기록되고, 실제 환불은 부산은행을 통해 오프라인으로 처리됩니다.

다중 선택 가능, 오프라인 부산은행 처리 (Finding: T-06)

운영팀이 수기로 납입 처리할 때, 당월 10일 이전이면 전월 선택 가능하고 11일 이후면 전월 선택이 차단됩니다.

기획은 10일/11일 기준 명시, 코드에 날짜 제약 명시 없음 (Finding: T-07)

• 레거시 구현에 10일/11일 제약 존재 여부 확인

매장에 장애가 발생하면 금액 차감(원단위 내림) 또는 기간 보상(소수점 1자리 절상)으로 처리하며, 프로모션·일시중지 기간과 1일 이상 중첩 시 불가합니다.

프로모션/일시중지 중첩 체크 및 반올림 비대칭 정책 검증 필요 (Finding: T-08)

• VAT 재정의 2025-08-27 결과 반영 필요

미수 또는 미청구 상태의 청구건에 대해 청구 예정일을 수기로 변경할 수 있습니다. 정기청구일과 동일 월일이면 각각 청구됩니다.

문서 서술 오류 의심, 코드 실제 UI 확인 필요 (Finding: T-09)

• 청구예정일자 변경 UI 실제 동작 확인

특정 상품·결제 상태 조건을 만족하는 청구건을 영구 삭제할 수 있으며, 삭제 후 복구는 불가능합니다.

v1.7.0 신규 기능, 코드 미구현 (Finding: T-12)

• 운영 리스크 검토 및 복구 불가 정책 재확인

납입 완료된 청구건을 취소하면 상태가 미청구 또는 미수로 원복되며, 더존 전표는 운영팀이 수기로 삭제합니다.

v1.4 신규 기능, 레거시 부분 구현 가능성 (Finding: T-13)

• 레거시 납입취소 기능 존재 여부 확인

효성 간편결제 ID 등록·삭제·갱신 기능이 v1.5.0부터 가맹점정산관리에서 매장관리로 이관되었습니다.

정산관리 코드에 효성ID 관리 잔존, 매장관리로 이관 필요 (Finding: T-14, S-32)

청구 목록의 62개 컬럼 중 최대 20개를 선택해 계정별로 저장할 수 있으며, 기본 세팅이 제공됩니다.

Tobe 62개 컬럼 중 20개 기본, 계정별 저장 기능 미구현 (Finding: T-15)

결제수단이 미과금으로 설정된 매장은 상품항목 무관하게 정산 내역에서 제외되며, 배치에서 미과금 여부를 체크합니다.

v1.7.1 CreateReBilling1D 배치에 미과금 체크 로직 추가, 코드 미구현 (Finding: T-16)

• 미과금 체크 로직 구현 여부 확인

납입 완료된 청구건의 매장 상세 정보는 납입 시점 스냅샷으로 고정되며, 이후 매장 정보가 변경되어도 갱신되지 않습니다. 단, 효성ID는 예외입니다.

회계 증빙 보존 목적, 레거시 이벤트 전파 검증 필요 (Finding: T-17)

• 납입완료 스냅샷 고정 정책 레거시 구현 확인

청구 목록 조회 시 기업·브랜드·청구기간·결제수단·결제상태·상품항목 등 다양한 필터를 제공하며, 3개월 이상 또는 일자무관 조회 시 필터 1개 이상 필수입니다.

카드승인번호/정기결제ID 검색 필터 추가, 데이터 소스 확인 필요 (Finding: T-18)

• 카드승인번호 데이터 소스 확인

청구대상이 본사인 매장의 월별 청구 내역을 조회하며, 정산 소스가 브랜드 정산기준에서 매장 청구 정보로 전환되었습니다. 엑셀 다운로드 시 비밀번호(4-10자) 필수입니다.