| 버전 | 작성일 | 작성자 | 변경 내용 |
|---|---|---|---|
| v1.0.0 (초안) | 2026.10.15 | 이정재 | 1. 계정설정_사업자정보_화면설계서 탭: 기존 사업자 정보(상호(법인명)·사업자 등록번호·대표자명·개업일) 하단에 사업자등록증 첨부 추가, 우측 안내 문구에 첨부 안내 추가, 요약값에 첨부 여부 추가 2. 계정설정_통장정보_화면설계서 탭: 통장 정보 항목(은행/계좌번호/예금주/통장사본) 신설 3. 담당자알림_화면설계서 탭: 업로드 시 담당자 알림(메일/웍스) 템플릿, 최고관리자 화면 이동·접근 차단 정의 4. 정책 탭: 파일 첨부, 알림 수신자·채널, 알림 트리거 조합, 권한(최고관리자/광고주/대행사), 대행사 등록·수정 권한, 데이터 반영 정책 5. 정책 탭: P-8 계좌번호·증빙파일 보안(암호화 저장, 마스킹, 복호화 권한) 6. 확정 반영: 사업자등록증 필수(M-31), 알림 수신자 = 내 환경설정 담당자 E-mail, 채널 메일(잠정), 파일 확인은 기존 최고관리자 페이지 7. 메시지·예외 처리 / 확정 필요 / 데모 탭 작성 |
| No. | 설명 |
|---|---|
| 1 | 사업자 정보 요약값 (변경)
|
| 2 | 상호 (법인명) · 사업자 등록번호 · 대표자명 · 개업일 (기존)
|
| 3 | 사업자등록증 첨부 (신규)
3-1. [파일 선택] (신규)OS 파일 선택창 오픈. 파일 선택 시 클라이언트에서 확장자·용량·0byte 검증
· 확장자 불가: Alert "jpg, jpeg, png, pdf 파일만 첨부할 수 있습니다." (M-01) · 10MB 초과: Alert "파일 용량은 최대 10MB까지 첨부할 수 있습니다." (M-02) · 0byte: Alert "파일이 비어 있거나 손상되었습니다. 다른 파일을 첨부해주세요." (M-03) · 이미 첨부된 상태에서 다시 선택 시 기존 파일을 교체 (확인 팝업 없음) · 파일명 최대 30자 표시, 초과 시 말줄임(…) + 마우스오버 시 전체 파일명 3-2. [미리보기] (신규)새 탭으로 파일 열기 (이미지: 원본 표시 / pdf: 브라우저 pdf 뷰어). 로드 실패 시 Alert "파일을 불러오지 못했습니다. 잠시 후 다시 시도해주세요." (M-22)
3-3. [삭제] (신규)Confirm "첨부한 파일을 삭제하시겠습니까?" (M-15) → [확인] 시 화면에서만 제거, [저장] 시 서버 반영. [취소] 시 유지 |
| 4 | [취소] (변경)
|
| 5 | [저장] (변경)
|
| 6 | 우측 안내 문구 (변경)
|
| No. | 설명 |
|---|---|
| 1 | 통장 정보 항목 (신규)
|
| 2 | 은행 (신규)
|
| 3 | 계좌번호 (신규)
|
| 4 | 예금주 (신규)
|
| 5 | 통장사본 (신규)
|
| 6 | [취소] (신규)사업자 정보 No.4와 같음 (M-16) |
| 7 | [저장] (신규)
|
| 광고주명 | 테스트광고주_A |
|---|---|
| 광고주 ID | test_a01 |
| 업로드 항목 | 통장사본 (변경) |
| 변경 정보 | KB국민은행 ****7890 / 예금주 테스트광고주_A |
| 업로드 일시 | 2026.10.15 14:25 |
| 작업자 | test_a01 (광고주) |
| No. | 설명 |
|---|---|
| 1 | 메일 템플릿 (신규)
|
| 2 | [최고관리자에서 확인하기] (신규)
|
| 3 | 네이버웍스 메시지 (신규, 2안 선택 시)
|
| 배경/목적 | 정산·세금계산서 발행에 필요한 사업자등록증·통장사본을 광고주가 광고주센터에서 직접 등록하게 하여, 메일·메신저로 받던 수기 수집을 줄인다. 업로드 즉시 담당자에게 알려 확인을 지연 없이 처리한다. |
|---|---|
| 메뉴 경로 | 광고주센터 > 계정설정 > 사업자 정보 |
| 사용 권한 | 광고주 계정(등록·수정), 대행사 계정(담당 광고주 조회, 수정은 P-7 확정 필요), 최고관리자 계정(최고관리자 화면 전용, 광고주센터 대리 접속은 확정 필요 No.6) |
| 범위 포함 | 사업자등록증 첨부, 통장 정보 입력·통장사본 첨부, 저장 시 담당자 알림 발송 |
| 범위 제외 | 최고관리자 쪽 증빙 조회·승인 화면, 계좌 실명 조회 API, OCR 자동 인식, 사업장 주소/업태/종목/세금계산서 이메일 기존 동작 |
| 항목 | 정책 |
|---|---|
| 허용 확장자 | jpg, jpeg, png, pdf (대소문자 무관). 서버에서 MIME 타입 재검증, 확장자 위장 파일은 저장 차단 + Alert "파일 형식이 올바르지 않습니다. jpg, jpeg, png, pdf 파일을 첨부해주세요." (M-29) 제안 |
| 파일명 | 원본 파일명 최대 100자(확장자 포함), 특수문자·이모지 허용. 초과 시 확장자 유지 + 앞 100자로 잘라 저장 제안 |
| 업로드 중 | [저장] "저장 중…" 표시, 진행률 미표시. [취소]·접기·[파일 선택]·[삭제] 비활성. 60초 초과 시 M-18 제안 |
| 용량 | 파일당 10MB 이하(10,485,760 byte 이하 허용, 초과 차단) 제안 |
| 개수 | 항목별 1개. 재선택 시 교체 |
| 업로드 시점 | 파일 선택 시 클라이언트 검증만 수행, [저장] 클릭 시 업로드 + 정보 저장 한 번에 처리. 실패 시 전체 롤백(파일·정보 모두 미반영) |
| 보관 | 비공개 스토리지 저장, 파일명은 서버에서 재생성. URL 직접 접근 차단, 미리보기·다운로드 시 권한 확인 제안 |
| 이력 | 교체 시 이전 파일은 화면에서 제거, 서버에는 이력으로 보관(보관기간 확정 필요 No.9) |
| 항목 | 정책 |
|---|---|
| 수신자 (확정) | 업로드한 광고주 계정의 내 환경설정 > 담당자 E-mail 1개 |
| 주소 기준 시점 | 발송 시점에 등록된 담당자 E-mail 제안 |
| 담당자 E-mail 미등록·형식 오류 | 메일 미발송, 발송 실패 로그 기록. 저장은 정상 처리, 사용자 화면 영향 없음 제안 (확정 필요 No.32) |
| 수신자 추가(참조) | 없음 제안 |
| 안 | 채널 | 장점 | 단점 |
|---|---|---|---|
| 1안 추천 | 메일 | 기존 메일 발송 모듈 활용, 발송 이력·증빙 남음, 외부 연동 불필요 | 즉시 인지 늦을 수 있음 |
| 2안 | 네이버웍스 Bot 메시지 | 즉시 인지 | 웍스 API·Bot 등록, 직원 웍스 계정 매핑 개발 필요 |
| 3안 | 메일 + 웍스 동시 | 인지·이력 모두 확보 | 개발량 최대, 중복 알림 피로 |
| No | 사업자등록번호 | 상호·대표자명·개업일 | 사업자등록증 | 저장 결과 | 알림 업로드 항목 |
|---|---|---|---|---|---|
| 1 | 변경 없음 | 변경 없음 | 변경 없음 | [저장] 비활성 | 미발송 |
| 2 | 최초 입력 | 최초 입력 | 첨부 | 저장 | "사업자 정보·사업자등록증 (신규)" |
| 3 | 최초 입력 | 최초 입력 | 미첨부 | 차단 (M-31) | 미발송 |
| 4 | 변경 없음 | 변경 | 변경 없음 (기존 첨부 있음) | 저장 | "사업자 정보 (변경)" |
| 4-1 | 변경 없음 | 변경 | 기존 첨부 없음 + 미첨부 | 차단 (M-31) | 미발송 |
| 5 | 변경 없음 | 변경 없음 / 변경 | 신규 첨부(기존 없음) | 저장 | "사업자등록증 (신규)" (+ 정보 변경 시 "사업자 정보·") |
| 6 | 변경 없음 | 변경 없음 / 변경 | 교체 | 저장 | "사업자등록증 (변경)" (+ 정보 변경 시 "사업자 정보·") |
| 7 | 변경 없음 | 변경 없음 / 변경 | 삭제 후 미첨부 | 차단 (M-31) | 미발송 |
| 8 | 변경 | 무관 | 교체 / 신규 첨부(기존 없음) | 저장 | 교체: "사업자 정보·사업자등록증 (변경)" / 신규 첨부: "사업자 정보·사업자등록증 (신규)" |
| 9 | 변경 | 무관 | 기존 첨부 있음 + 미교체 | 차단 (M-06) | 미발송 |
| 10 | 변경 | 무관 | 기존 첨부 있음 + 삭제 | 차단 (M-06) | 미발송 |
| 11 | 변경 | 무관 | 기존 첨부 없음 + 미첨부 | 차단 (M-31) | 미발송 |
| 상태 | 계좌정보(은행/계좌번호/예금주) 변경 | 통장사본 변경 | 저장 결과 | 알림 |
|---|---|---|---|---|
| 최초 등록 | Y (4개 모두 필수) | Y | 저장 | 발송 "통장 정보·통장사본 (신규)" |
| 최초 등록 | 일부 누락 | - | 차단 (M-07~M-12) | 미발송 |
| 등록 후 수정 | Y | Y | 저장 | 발송 "통장 정보·통장사본 (변경)" |
| 등록 후 수정 | Y | N | 차단 (M-13) | 미발송 |
| 등록 후 수정 | N | Y | 저장 | 발송 "통장사본 (변경)" |
| 등록 후 수정 | 무관 | 삭제 후 미첨부 | 차단 (M-12) | 미발송 |
| 등록 후 수정 | 계좌번호 포커스 후 미입력 이탈 | N | 변경 아님 → [저장] 비활성 | 미발송 |
| 등록 후 수정 | N | N | [저장] 비활성 | 미발송 |
| 기능 | 광고주 계정 | 대행사 계정 (담당 광고주의 광고주센터 접속 시) | 최고관리자 계정 |
|---|---|---|---|
| 광고주센터 계정설정 > 사업자 정보·통장 정보 조회 | O (본인 계정) | O (담당 광고주만) 제안 | 광고주센터 대리 접속 기능이 있는 경우만 O (확정 필요 No.6) |
| 입력·파일 첨부·[저장] | O | 1안 X (필드·[파일 선택]·[저장] 비활성) / 2안 O — P-7 참고 | 대리 접속 시 O (알림 작업자 = 관리자 ID) |
| [미리보기] | O | 1안 X (버튼 미노출) / 2안 O | 대리 접속 시 O |
| [삭제] | O | 1안 X (버튼 미노출) / 2안 O | 대리 접속 시 O |
| 계좌번호 표시 | 광고주센터 화면에서는 모든 계정이 뒤 4자리 외 마스킹. 전체 번호는 최고관리자 화면에서만 조회 (확정 필요 No.5와 함께 정의) | ||
| 최고관리자 화면(증빙 확인, 알림 링크 이동) | X — 접근 차단 (M-30) | X — 접근 차단 (M-30) | O |
| 담당 외 광고주 / 무권한 API 직접 호출 | 서버 403 → Alert "권한이 없습니다." (M-23), 데이터 변경 없음 | ||
| 안 | 내용 | 장점 | 단점 |
|---|---|---|---|
| 1안 추천 | 대행사는 조회만, 등록·수정·삭제는 광고주 계정만 | 사업자등록증·통장사본은 광고주 본인 증빙이라 책임 소재 명확, 정산 계좌 임의 변경 리스크 차단 | 광고주가 직접 로그인해야 함 |
| 2안 | 대행사도 담당 광고주 증빙 등록·수정·삭제 가능, 알림 작업자 = "대행사 ID (대행사)" | 대행사가 광고주 대신 처리 가능 | 정산 계좌를 대행사가 바꿀 수 있어 정산 사고 리스크 |
| 항목 | 정책 |
|---|---|
| 계좌번호 DB 저장 | 평문 저장 금지. 양방향 암호화(AES-256)로 저장. 정산 송금·최고관리자 조회 때 원문이 필요하므로 단방향(해시) 사용 불가 |
| 암호화 키 | DB와 분리 보관(설정 서버/KMS). 소스 코드에 키 하드코딩 금지 |
| 마스킹 | 광고주센터 API 응답에는 마스킹값(뒤 4자리)만 내려줌. 원문은 내려주지 않음(화면에서만 가리지 않음) |
| 복호화 권한 | 최고관리자 화면·정산 처리에서만 복호화. 광고주·대행사 계정은 복호화 불가 |
| 로그·알림 | 애플리케이션 로그·알림 메일·웍스 메시지에 계좌번호 원문 미기록 (마스킹값만) |
| 통장사본·사업자등록증 파일 | 계좌번호가 이미지에 그대로 있으므로 비공개 스토리지 저장(P-1), 권한 확인 후에만 미리보기. 파일 자체 암호화 여부는 사내 보안 정책 확인 |
| 전송 | HTTPS 전송 |
| ID | 발생 조건 | 유형 | 문구 |
|---|---|---|---|
| M-01 | 허용 외 확장자 파일 선택 | Alert | jpg, jpeg, png, pdf 파일만 첨부할 수 있습니다. |
| M-02 | 10MB 초과 파일 선택 | Alert | 파일 용량은 최대 10MB까지 첨부할 수 있습니다. |
| M-03 | 0byte 파일 선택 | Alert | 파일이 비어 있거나 손상되었습니다. 다른 파일을 첨부해주세요. |
| M-04 | (기존) 사업자 정보 필수값 미입력 | 기존 유형 | 기존 운영 문구 사용 (문구 확인 필요) |
| M-05 | (기존) 사업자 정보 인증 실패 | 기존 유형 | 기존 운영 문구 사용 (문구 확인 필요) |
| M-06 | 사업자등록번호 변경 + 등록증 미교체 | Alert | 사업자등록번호 변경 시 사업자등록증을 다시 첨부해주세요. |
| M-07 | 은행 미선택 | 인라인 에러 | 은행을 선택해주세요. |
| M-08 | 계좌번호 미입력 | 인라인 에러 | 계좌번호를 입력해주세요. |
| M-09 | 계좌번호 10자리 미만/16자리 초과 | 인라인 에러 | 계좌번호는 숫자 10~16자리로 입력해주세요. |
| M-10 | 예금주 미입력 | 인라인 에러 | 예금주를 입력해주세요. |
| M-11 | 예금주 허용 외 문자 | 인라인 에러 | 예금주는 한글, 영문, 숫자, 공백, 괄호만 입력할 수 있습니다. |
| M-12 | 통장사본 미첨부 저장 | Alert | 통장사본을 첨부해주세요. |
| M-13 | 계좌정보 변경 + 통장사본 미교체 | Alert | 계좌 정보 변경 시 통장사본을 다시 첨부해주세요. |
| M-14 | 저장 성공 | Toast | 저장되었습니다. |
| M-15 | [삭제] 클릭 | Confirm | 첨부한 파일을 삭제하시겠습니까? |
| M-16 | 변경 후 [취소]/헤더 클릭으로 접기 | Confirm | 저장하지 않은 내용이 있습니다. 작성을 취소하시겠습니까? |
| M-17 | 저장 API 실패, 서버 오류(5xx) | Alert | 일시적인 오류로 저장하지 못했습니다. 잠시 후 다시 시도해주세요. |
| M-18 | 업로드 중 네트워크 끊김/타임아웃(60초) | Alert | 파일 업로드에 실패했습니다. 네트워크 상태를 확인 후 다시 시도해주세요. |
| M-19 | 세션 만료 후 [저장]/[미리보기] | Alert | 로그인이 만료되었습니다. 다시 로그인해주세요. → [확인] 시 로그인 페이지 이동 |
| M-20 | 다른 사용자가 먼저 저장(동시 수정) | Alert | 다른 사용자가 먼저 정보를 수정했습니다. 새로고침 후 다시 시도해주세요. |
| M-21 | 저장된 데이터 없음 | 빈 데이터 안내 | 요약값 "미설정", 파일 영역 "첨부된 파일 없음" |
| M-22 | [미리보기] 파일 로드 실패 | Alert | 파일을 불러오지 못했습니다. 잠시 후 다시 시도해주세요. |
| M-23 | 무권한 계정 저장 API 호출(403) | Alert | 권한이 없습니다. |
| M-24 | 계정설정 조회 API 실패 | Alert | 정보를 불러오지 못했습니다. 잠시 후 다시 시도해주세요. |
| M-25 | 미사용 (번호 예약) | ||
| M-26 | 미사용 (번호 예약) | ||
| M-27 | 미사용 (번호 예약) | ||
| M-28 | 미사용 (번호 예약) | ||
| M-31 | 사업자등록증 미첨부 상태로 사업자 정보 [저장] | Alert | 사업자등록증을 첨부해주세요. |
| M-30 | 최고관리자 로그인 페이지에 광고주·대행사 계정 입력(알림 링크 진입 포함) | Alert | 최고관리자 계정으로만 접속할 수 있습니다. |
| M-29 | 확장자 위장 파일 저장(서버 MIME 검증 실패) | Alert | 파일 형식이 올바르지 않습니다. jpg, jpeg, png, pdf 파일을 첨부해주세요. |
| 상황 | 처리 |
|---|---|
| 저장 API 실패 / 5xx | M-17 노출, 입력값·선택 파일 화면에 유지, 펼침 유지. 서버 롤백(파일·정보 모두 미반영), 알림 미발송 |
| 네트워크 끊김 | M-18 노출, 입력값 유지, [저장] 다시 활성 |
| 세션 만료 | M-19 → 로그인 페이지. 입력값 소실 |
| 계정설정 조회 API 실패 | 요약값 영역 "-" 표시 + Alert "정보를 불러오지 못했습니다. 잠시 후 다시 시도해주세요." (M-24), 펼침 불가 |
| 빈 데이터 | M-21 |
| [저장] 중복 클릭 | 요청 중 버튼 비활성. 서버는 동일 요청 1건만 처리, 파일 1개·알림 1건만 생성 |
| 동시 수정 | M-20, 나중 요청 저장 차단 |
| 알림 발송 실패 | 저장 유지, 1분 간격 3회 재시도 → 최종 실패 시 로그 기록. 사용자 화면 영향 없음 |
| 확장자 위장 파일 | M-29, 저장 롤백, 입력값 유지 |
| No | 항목 | 제안 | 확정 필요 사유 |
|---|---|---|---|
| 맥스 리뷰 우선순위 상 (TC 작성·개발 진행 불가) — No.1·2·4·5 확정, No.3(채널)은 메일로 잠정 | |||
| 1 | 사업자 정보 펼침 영역의 기존 필드 구성 | 확정 — 상호(법인명)·사업자 등록번호·대표자명·개업일 운영 중, 저장 시 사업자 정보 인증 | |
| 2 | 사업자등록증 필수 여부 | 확정 — 필수 (M-31) | |
| 3 | 알림 채널 | 메일 (잠정) | 최종 확인 필요 |
| 4 | 알림 수신자 | 확정 — 광고주 계정 내 환경설정 > 담당자 E-mail (P-2) | |
| 5 | 최고관리자 증빙 조회 화면 | 확정 — 기존 최고관리자 페이지에서 확인 | |
| 6 | 최고관리자 계정의 광고주센터 대리 접속 기능 존재 여부 | 있으면 광고주와 같은 권한, 알림 작업자 = 관리자 ID | 계정 유형 3종(최고관리자/광고주/대행사)과 최고관리자 화면 접속 제한은 확정됨. 광고주센터 대리 접속 유무 미확인 |
| 7 | 파일 확장자·용량·개수 | jpg/jpeg/png/pdf, 10MB, 1개 | 요구사항은 "사진"만 언급, pdf 허용 여부 포함 |
| 8 | 계좌 실명 조회 API | 미적용, 담당자 수기 확인 | 정산 계좌 오입력 리스크 |
| 9 | 교체 전 파일 보관기간 | 5년 (세무 증빙 기준) | 개인정보 보관 정책 확인 필요 |
| 10 | 사업자등록증 삭제 시 알림 발송 | 해당 없음 — 필수 항목이라 삭제만 하고 저장 불가 (M-31) | |
| 11 | 검수 상태(확인요청/확인완료/반려) 관리 | 1안: 상태 없음, 알림만 (이번 범위) / 2안: 상태값 + 반려 사유 노출 | 2안은 최고관리자 승인 화면 필요 |
| 12 | 계좌번호 길이·마스킹·예금주 허용 문자 | 10~16자리, 뒤 4자리 노출, 한글·영문·숫자·공백·괄호 30자 | 은행별 자릿수·법인 예금주 표기 확인 |
| 13 | 사업자등록번호 검증 방식 | 확정 — 기존 사업자 정보 인증 사용 (체크섬·하이픈 제안 철회) | |
| 14 | 통장 정보 행 위치 | 세금계산서 발행 이메일 하단 | 별도 "정산 정보" 카드로 분리할지 |
| 15 | 알림 재시도 정책 | 1분 간격 3회, 최종 실패 시 로그 | 메일 발송 모듈 기존 정책 확인 |
| 16 | 사업자등록번호 중복 등록 | 허용 | 한 사업자가 여러 광고주 계정을 운영하는 경우 |
| 17 | 상호·대표자명·개업일 입력 정책 | 기존 운영 정책 유지 | 회귀 TC 작성을 위해 기존 입력 정책·인증 문구 공유 요청 |
| 18 | 아코디언 펼침 규칙 | 행별 독립, 여러 행 동시 펼침 허용 | 기존 행 동작 확인 필요 |
| 19 | 상호명·대표자명 변경 시 알림 | 발송 "사업자 정보 (변경)" | 담당자 알림 범위 |
| 20 | 대행사·최고관리자 계정 저장 시 알림 | 발송, 작업자 = 해당 계정 ID와 유형 | 광고주 외 계정 작업도 알릴지 |
| 21 | 확장자 위장 파일 문구 | M-29 별도 문구 | 서버 MIME 검증 적용 여부 |
| 22 | 파일명 길이·업로드 중 동작 | 원본명 100자, 진행률 미표시, 업로드 중 [취소]·접기 비활성 | UX 확인 |
| 23 | 동시 수정 판정 단위 | 사업자 정보·통장 정보 행별 버전 | 서버 구현 방식 확인 |
| 24 | 대행사 계정의 등록·수정 권한 | 1안 조회만 (P-7) | 정산 계좌를 누가 바꿀 수 있는지 |
| 25 | 대행사 본인 계정설정 적용 범위 | 이번 범위 제외 | 대행사 자체 사업자 정보·통장 정보도 수집 대상인지 |
| 26 | 대행사의 담당 외 광고주 접근 | 서버 403 + M-23 | 대행사-광고주 매핑 기준 확인 |
| 27 | M-30 문구·노출 위치 | 최고관리자 로그인 페이지 Alert | 기존 최고관리자 로그인 실패 문구 확인 |
| 31 | 계좌번호 암호화 방식 (개발 문의) | AES-256 양방향 암호화, 키 분리 보관 (P-8) | 사내 개인정보·보안 담당 확인 |
| 32 | 담당자 E-mail 미등록·형식 오류 시 처리 | 미발송 + 실패 로그 | 내 환경설정에서 담당자 E-mail이 필수인지 확인 |
| 33 | 알림 메일 링크 이동 경로 | 증빙 확인용 기존 최고관리자 페이지 | 정확한 메뉴 경로와 광고주 파라미터 확인 |
| 34 | 담당자 E-mail 수신자가 최고관리자 계정이 없는 경우 | 링크 진입 시 M-30으로 차단 | 담당자 E-mail에 광고주 측 주소가 등록된 계정은 링크가 쓸모없음. 링크를 유지할지 확인 |
| 28 | 주소 행 라벨 불일치 (운영) | "주소"로 통일 | 운영 화면에서 미설정 상태는 "사업장 주소", 입력 상태는 "주소"로 라벨이 다름. 의도된 차이인지 확인 |
| 29 | 사업자등록증만 변경 시 사업자 정보 인증 여부 | 인증 생략, 파일만 저장 | 인증 API 호출 비용·정책 확인 |
| 30 | 인증 성공 후 파일 업로드 실패 시 처리 | 정보 저장도 롤백(인증 결과 미반영), M-17 | 기존 인증 결과 저장 시점 확인 |