■ システム全体構成

概要：Windowsサーバー（ローカル）でSeleniumによりデータ自動取得 → Cloudflare R2にアップロード → Cloudflare Pagesのダッシュボードがブラウザ上でR2からデータをfetchして集計・表示

【自動実行スケジュール（Windowsタスクスケジューラ）】

時刻	スクリプト	処理内容	出力先
毎日 03:00	new_csv.py	新ダッシュボードから全店舗・全期間CSVをSeleniumで取得	data/new/latest.csv
毎日 03:10	old_csv.py	旧ダッシュボード（電通大）から前日分をSeleniumで取得・追記	data/old/current_dentsu.csv
毎日 03:30	upload_r2.py	全10ファイルをCloudflare R2にアップロード	R2バケット
毎日 04:00	charge_csv.py	majicaレポートから桃山台チャージデータ（前々日分）を取得・追記・R2アップロード	data/charge/722_charge.csv

【手動実行（不定期）】

スクリプト	処理内容	実行タイミング
build_items_csv.py	旧CSV rawファイルを current_dentsu_items.csv に結合（粗利計算用）	bulk取得後に手動実行
convert_jan_master.py	MonitorList.csv → jan_master.json に変換	新商品追加時
convert_pos_cost.py	月別原価管理.csv → pos_cost.json に変換	月1回
convert_category_master.py	部門一覧.csv → category_master.json に変換	年1〜2回
extract_missing_jan.py	jan_masterに未登録のJANコードを抽出	必要時

■ R2バケット構成（unmanned-store-dashboard）

R2パス	内容	更新頻度
new/latest.csv	新CSV全店舗・全期間（毎日上書き）	毎日
old/current_dentsu.csv	旧電通大 取引毎	毎日
old/current_dentsu_items.csv	旧電通大 商品毎（粗利計算用）	手動
old/current_shibuya.csv	旧渋谷 取引毎（旧システム終了済）	固定
old/current_shibuya_items.csv	旧渋谷 商品毎（旧システム終了済）	固定
charge/722_charge.csv	桃山台チャージ {date, charge_amount, charge_count}	毎日
master/jan_master.json	JANコード → {name, small_class, pos_cost}	新商品時
master/pos_cost.json	月別POS原価（旧CSV粗利計算用）	月1回
master/category_master.json	月別部門コード → 部門名	年1〜2回
master/cgid_log.json	CGID → 初回購買日	毎日
master/budget.json	月別予算 {sales, gross}（予算入力モーダルから生成）	随時

公開URL: https://pub-a1ac555951f74594ba017debd3a3c248.r2.dev

■ ダッシュボード（Cloudflare Pages）

ホスティング：Cloudflare Pages（index.html 単一ファイル）
データ取得：ブラウザからR2の公開URLに直接fetchし、PapaParse・Chart.jsでクライアントサイド集計・描画
認証：SHA-256ハッシュによるパスワード認証（sessionStorageでセッション管理）
更新手順：修正したindex.htmlをフォルダに入れてCloudflare Pagesの「Create new deployment」からアップロード
キャッシュ：no-cache設定により毎回最新データを取得

■ データソース・店舗マスタ

■ 新CSV集計ロジック（latest.csv）

対象行フィルタ
　伝票ステータス = 02（購買）または 08（購買・訂正）
　※ 5（返品）・10（購買返品済）は集計対象外

日付基準：伝票作成時刻 のみ使用（退店時刻・最終決済試行時刻は不使用）

店舗識別：店舗コード 列の下3桁（例: 0722 → 722）

営業期間フィルタ：各店舗の openDate 以前・closeDate 以降のデータを自動除外（テスト会計対策）

isPaid（決済完了）：決済ステータス = 1 のみ

売上(税抜)：(販売単価 − 値引き額) × 点数　※isPaid=true のみ
粗利：(販売単価 − 値引き額 − 想定仕入価格) × 点数　※isPaid=true のみ
値引き額：値割引情報（単品） 列から抽出。フォーマット {{...,18,}} の2番目の数値（波括弧除去→カンマ区切り）。{} は0円

総客数：isPaid=true の 会計伝票番号 ユニーク件数
ユニーク客数：isPaid=true の CGID ユニーク件数（集計期間ごと）

未決済件数：伝票ステータス in (02,08) かつ 決済ステータス = 2 の 会計伝票番号 ユニーク件数
　※ 3（キャンセル返品）・5（返品完了）は未決済に含めない。行カウントではなく伝票単位で集計
未決済金額(税抜)：上記対象行の (販売単価 − 値引き額) × 点数 合計

■ 旧CSV集計ロジック（取引毎CSV）

対象行フィルタ：決済ステータス = '決済完了' のみ売上対象
日付基準：生成時間 のみ使用
除外条件：店舗列に (新) を含む行（新システムデータの混入を排除）

売上(税抜)：支払い済金額（税抜）（列がない場合 支払い済金額 で代替）
値引き：割引金額 + クーポン割引金額
総客数：決済完了の オーダーID ユニーク件数
ユニーク客数：決済完了の CGID ユニーク件数

未決済件数：決済ステータス = '決済未完了' の オーダーID ユニーク件数（1行=1取引のため行カウントと一致）
未決済金額(税抜)：オーダー金額（税抜）− 割引金額 − クーポン割引金額
　※ 未払い金額 列は税込のため不使用

■ 旧CSV粗利・点数計算（商品毎CSV）

税抜換算：商品価格（税込）÷ (1 + 税率)　税率フォーマット: '8.00%' → 0.08
割引按分：取引毎CSVの 割引金額 × (商品税抜小計 ÷ オーダー金額（税抜）)
POS原価：jan_master.json の pos_cost[storeKey] を参照
粗利：(税抜単価 − 割引按分分 − POS原価) × 商品数

■ マスタデータ

jan_master.json：JANコード → {name, small_class, pos_cost:{711,717}} カテゴリー・原価参照
category_master.json：月別 部門コード(4桁) → 部門名。対象月以前の直近月にフォールバック
pos_cost.json：旧CSV用月別原価フォールバック（2025-09が最新、以降は2025-09を使用）
cgid_log.json：CGID → 初回購買日。新規ユニーク利用者・累計ユニーク利用者の計算に使用
budget.json：月別予算 {sales, gross}。売上・粗利の達成率プログレスバー表示に使用
722_charge.csv：桃山台チャージデータ {date, charge_amount, charge_count}

■ 新規・累計ユニーク利用者

新規ユニーク利用者：集計期間内のCGIDのうち、この店舗への初回購買日（storeCgidFirst[storeKey][CGID]）が期間内に含まれる件数
　※ 他店舗での購買歴は考慮しない。店舗ごとに独立して初来店日を管理
累計ユニーク利用者：OPEN日〜集計期間末日に1度でも購買したCGIDの総数（日別は当日までの積算）
　※ storeCgidFirstはnewRows・oldRows全行から storeKey 単位で構築

■ 日別サマリーのゼロ埋め

OPEN日〜当日（closeDate がある場合はcloseDate）までの全日付を表示。売上実績がない日も¥0で表示する
　※ 旧オフィス（closeDate: 2025-10-09）は閉店日までの範囲でゼロ埋め