# 채널 자료·실행 현황 기준

정본 데이터는 [channel-data-status.json](channel-data-status.json)이다. 작업실 현황 화면은 이를 읽어 생성한다. 기존 증거 프로파일과 고객원본은 복제하지 않고 링크한다.

## 1차 실행 방향

경영진이 현재 보는 부서 가공·제출파일을 먼저 적재 대상으로 선정한다. 판매추이는 **구매/결제일 기준 판매실적·주문내역**이며 판매계획과 별개다. 핵심 세 축은 **판매계획 / 고객 구매시점 판매추이 / 실제 마감완료 정산내역**이다. 정산내역은 재경 전달 완성파일부터 검토하되 가마감·잠정과 실제 마감완료를 구분한다. 현재 수령본의 최종승인은 미확인으로 표시한다. 손익·예산은 보조 축으로 현행 취합 산출물부터 사용한다. 프로모션 캘린더는 플랫폼 원천으로 설계한다. 더 자세한 주문·정산·배송·쿠폰 원천과 API 자동화는 이후 우선순위를 정한다.

## 상태 해석

- 가공본·최종제출 후보 수령은 승인 완료나 전체 기간 확보를 뜻하지 않는다.
- `upload_candidate`는 현업 가공파일을 1차 업로드 대상으로 선정할 수 있다는 판단이다. 이미 업로드 화면·변환 파이프라인이 구현됐다는 뜻이 아니다.
- `needs_processing`은 해당 채널 분리·기간·최종시트 선택 또는 추가 가공/제출파일 확보가 필요하다는 뜻이다.
- `source_missing`은 해당 채널 판매/마감 입력용 실데이터가 미확보된 상태다. 상위그룹 손익/계획파일 존재와는 별개다.
- `prototype`은 데일리매출 시작품에 관련 시트가 있음을 뜻한다. 오류·외부참조·개인정보·복합키 문제가 있어 현재 운영본으로 보지 않는다. `header_only`는 빈 양식이며, 컬리의 헤더+1행은 정상 거래범위 수령으로 보지 않는다.
- `group_only`는 버티컬·면세·큐텐/라쿠텐 등 상위그룹 자료만 확인했다는 뜻이다. 그룹 합계에서 하위 채널 손익이나 계획을 임의 배부하지 않는다.

## 증거·집계 규칙

파일 경로는 JSON의 `path_base=project_root`를 기준으로 해석한다. `sources`에 기간·grain·증거종류·제한과 기존 프로파일 링크를 둔다. 채널의 네 축은 `source_ids`로 연결한다. 같은 재경파일을 여러 채널이 사용해도 실제 수령파일 수는 하나다. 채널 행도 서로 배타적인 매출 분할이 아니다(일본 오프라인 납품과 LOFT 판매 등).

메디컬 신규 보고는 실제 숫자·수식이 있는 가공본이다. 구매일 주문원장이나 회계 확정본으로 단정하지 않는다. 9/9 재전달 통합매출·주요비용은 기존 9/3 원본과 해시가 같아 새 버전/새 데이터 수령으로 세지 않는다.

매출·수금·계획·광고·재고, 통계·추정·마감 확정은 섞지 않는다. 원본 파일명에 `확정` 또는 `2026`이 있어도 실제 행·시트 기간을 우선한다. 일본 OFF 재고의 중복 부분집합, 라쿠텐 파일 속 2024 Qoo10 시트, 누계/월분 중복은 기존 프로파일의 주의를 그대로 적용한다.

담당 팀은 업무 창구 후보다. 과거 RBD 명칭과 현재 조직·승인/업로더는 별도 확인하며 계정·비밀번호·고객/거래처별 실값은 이 현황에 포함하지 않는다.

재고 통합조회는 검토 후보이며 락·예약·할당·가상창고 생성·이동실행은 ERP의 기존 기능·권한 확인 영역이다. 기존 기능 안내는 가능하나 ERP 자체 수정은 이번 범위 밖이고 기능/권한에 따라 실행이 불가능할 수 있다.

## 화면과 재생성

[작업실 채널 현황 화면](../../00_프로젝트작업실/21_CURRENT_채널자료·실행현황.html)은 JSON과 작전계획의 1차 범위를 읽어 생성한다. 수정 후 프로젝트 루트에서 아래 명령을 실행한다.

```sh
python3 00_프로젝트작업실/99_생성도구/build_channel_status.py
```

재고 조회의 사이트·화면/파일·범위·업무창구·ERP 반영차이는 JSON의 `inventory_sources`에 한 번만 기록하고 채널에서 ID로 참조한다. 사이트 URL 미확인과 화면명이 아닌 파일명 근거는 구분한다. 현재 WMS 파일은 8월 수령 표본이며 실시간 접속이나 9월 현재고를 뜻하지 않는다.

## API·기존 자동수집

API 존재, 기존 고객 운영, 실제 수령 자료, 계정 권한, ERP 쓰기는 별도 상태다. [원전 발췌·공식 제품 자료](./_materials/files/channel-api-evidence-20260909.md)는 JSON `api_sources`에서 생성한 근거 뷰다. 기존 자동화 재사용과 가공 제출본 적재를 병행하고, 부족한 수집 범위만 추가 개발한다.