운영자 워크플로우

Step 1: 예측 미리보기 → Step 2: 생산 런 생성 → Step 3: 생산/이동/재고 검증

/login / /docs /ops/admin/locations /health

토큰 상태 확인 전

기본 입력

Tenant ID

Run Date

Central Location ID

Store Location ID

Default Need G

Request Timeout (ms)

Production Forecast Mode

SKU IDs (comma/newline separated)

로그인은 /login에서 먼저 수행하고, 저장된 freshops.accessToken/freshops.refreshToken을 사용합니다. 샘플 SKU 생성은 ADMIN 권한이 필요합니다.

Step 1. Forecast Preview

아직 실행되지 않았습니다.

Forecast 응답이 여기에 표시됩니다.

Step 2. Production Run 생성

manual 모드: Step1 결과를 line.forecastG/sigmaG로 전달, auto 모드: forecastG 생략하여 서버 내부 예측 사용. 원클릭 실행은 runDate 충돌(409) 시 자동으로 다음 날짜로 이동해 재시도합니다.

Run ID (생성 후 자동 채움)

Production Run 응답이 여기에 표시됩니다.

Step 3. 결과 검증

통합 검증 버튼은 run/transfers/projection을 서버에서 일괄 계산해 PASS/FAIL 체크를 반환합니다.

검증 요약이 여기에 표시됩니다.

검증 응답이 여기에 표시됩니다.

Step 4. 최근 Run 이력

Date From

Date To

Limit

행의 상세는 run 상세 조회, 검증은 Step3 검증을 해당 run 기준으로 즉시 실행합니다.

최근 production run 목록이 여기에 표시됩니다.

Step 5. 실행 로그

실행 로그가 여기에 표시됩니다.

Step 6. Waste 기록

Location ID

SKU ID

Waste Qty (g)

Reason Code

Recorded At (optional)

Waste List Limit

Waste Date From

Waste Date To

POST /waste/records는 동일 트랜잭션에서 inventory_events(WASTE)와 projection 감소를 함께 반영합니다.

Waste 응답이 여기에 표시됩니다.

Step 7. Audit 로그 조회

Action

Entity Type

Entity ID

Actor ID

Date From

Date To

Limit

Offset

/audit/logs는 ADMIN 전용입니다. 필터/limit/offset으로 감사 로그를 조회합니다.

Audit 요약이 여기에 표시됩니다.

Audit 로그 응답이 여기에 표시됩니다.

Step 8. 운영 체크리스트

Audit retention 자동화 적용 여부를 점검하고 상태를 저장합니다.

AUDIT_PRUNE_DATABASE_URL GitHub Secret 설정 완료 (선택) AUDIT_PRUNE_TENANT_ID Secret 설정 또는 전역 정책 확정 AUDIT_LOG_RETENTION_DAYS/AUDIT_LOG_PRUNE_BATCH_SIZE 변수 검토 완료 GitHub Actions audit-retention 수동 실행(dry_run=true) 성공 확인 실삭제 실행(dry_run=false) 전 승인/점검 절차 완료 스케줄 실행 결과(artifact + summary) 주기 모니터링 체계 수립

워크플로우 열기

체크리스트 요약이 여기에 표시됩니다.

Step 9. Ingest 모니터링/알림

Store Location 관리

Location Name

Store Code

Location Type

Manager Name

Manager Phone

Location ID (for status)

활성 지점만 조회

Page Limit

Page Offset

지점(Location) 관리 결과가 여기에 표시됩니다.

지점(Location) 응답이 여기에 표시됩니다.

Ingest Device 관리

Store ID (filter / key issue required)

Device ID (filter / key issue required)

Device Description (key issue)

Issued API Key (shown once)

Metrics Window (min)

Online Threshold (min)

Alert Device Limit

Min Offline Devices

Min Queue Pending Total

Min Queue Failed Total

Min Queue Dead Total

Min Error Devices

Dispatch Channels

알림 조회 시 채널 발송 요청(dispatch=true)

디바이스 등록/키 발행 결과가 여기에 표시됩니다.

디바이스 관리 응답이 여기에 표시됩니다.

Device Config JSON (storeId/deviceId required)

Device config 요약이 여기에 표시됩니다.

Device config 응답이 여기에 표시됩니다.

/ingest/admin/alerts는 오프라인/큐/에러 임계치를 계산하고 INGEST_ALERT_WEBHOOK_URL/INGEST_ALERT_SLACK_WEBHOOK_URL/INGEST_ALERT_EMAIL_WEBHOOK_URL 설정에 따라 채널 라우팅을 시도합니다.

Ingest 모니터링 요약이 여기에 표시됩니다.

Ingest 모니터링 응답이 여기에 표시됩니다.