@@ -871,6 +1011,108 @@ function renderGrowthOps(rows) {
}).join('');
}
+function fillExternalOfferSample() {
+ const sample = [
+ '資料來源,外部商品ID,商品名稱,售價,資料時間,取得方式,PChome商品ID,同款狀態,資料可信度',
+ 'momo_reference,MOMO-1001,範例保養商品,899,2026-06-15T10:00:00,manual_csv,PCH-1001,verified,88',
+ 'shopee,SHP-2001,待確認商品,790,2026-06-15T10:05:00,manual_csv,,unmatched,60'
+ ].join('\\n');
+ document.getElementById('externalOfferCsvText').value = sample;
+}
+
+async function previewExternalOfferCsv() {
+ const fileInput = document.getElementById('externalOfferCsvFile');
+ const textInput = document.getElementById('externalOfferCsvText');
+ const resultBox = document.getElementById('offerDryRunResult');
+ const button = document.getElementById('btnExternalOfferDryRun');
+ const formData = new FormData();
+
+ if (fileInput.files && fileInput.files[0]) {
+ formData.append('file', fileInput.files[0]);
+ }
+ if (textInput.value.trim()) {
+ formData.append('csv_text', textInput.value.trim());
+ }
+
+ if (!formData.has('file') && !formData.has('csv_text')) {
+ resultBox.innerHTML = `
+
+ 請先上傳 CSV 或貼上內容。
+
`;
+ return;
+ }
+
+ button.disabled = true;
+ button.innerHTML = '
預檢中';
+ resultBox.innerHTML = `
`;
+
+ try {
+ const response = await fetch('/api/ai/pchome-growth/external-offers/csv-dry-run', {
+ method: 'POST',
+ body: formData,
+ });
+ const data = await response.json();
+ renderExternalOfferDryRun(data);
+ } catch (error) {
+ console.error(error);
+ resultBox.innerHTML = `
+
+ CSV 預檢暫時失敗，請稍後再試。
+
`;
+ } finally {
+ button.disabled = false;
+ button.innerHTML = '
預檢 CSV';
+ }
+}
+
+function renderExternalOfferDryRun(data) {
+ const resultBox = document.getElementById('offerDryRunResult');
+ const summary = data.summary || {};
+ document.getElementById('offerDryRunReady').textContent = (summary.ready_count || 0).toLocaleString();
+ document.getElementById('offerDryRunReview').textContent = (summary.review_count || 0).toLocaleString();
+ document.getElementById('offerDryRunBlocked').textContent = (summary.blocked_count || 0).toLocaleString();
+
+ if (!data.success) {
+ const errors = (data.errors || [data.error || 'CSV 格式需要修正']).slice(0, 4);
+ resultBox.innerHTML = `
+
+ ${escapeHtml(errors.join('；'))}
+
`;
+ return;
+ }
+
+ const rows = (data.rows || []).slice(0, 8);
+ if (!rows.length) {
+ resultBox.innerHTML = `
+
+ CSV 裡沒有可檢查的資料列。
+
`;
+ return;
+ }
+
+ resultBox.innerHTML = rows.map((row) => {
+ const statusClass = row.status_code === 'ready'
+ ? ' is-ready'
+ : row.status_code === 'blocked'
+ ? ' is-blocked'
+ : '';
+ const reasons = (row.reasons || []).join('、');
+ const price = row.price ? formatMoney(row.price) : '未填價格';
+ return `
+
+
${escapeHtml(row.title || '未命名商品')}
+
+ 第 ${escapeHtml(row.row_number || '-')} 列 · ${escapeHtml(row.source_code || '未填來源')} · ${escapeHtml(price)}
+
+
${escapeHtml(reasons)}
+
`;
+ }).join('');
+}
+
// ── 競品比價表格（熱力圖底色）──────────────────────
function renderCompetitorTable(rows) {
const tbody = document.getElementById('competitorTbody');
diff --git a/tests/test_external_market_offer_service.py b/tests/test_external_market_offer_service.py
index 0e41f64..10aba98 100644
--- a/tests/test_external_market_offer_service.py
+++ b/tests/test_external_market_offer_service.py
@@ -46,6 +46,44 @@ def test_normalized_offer_payload_validates_plain_required_fields():
assert "售價必須大於 0" in missing_errors
+def test_external_offer_csv_dry_run_accepts_chinese_headers_and_classifies_rows():
+ from services.external_market_offer_service import dry_run_external_offer_csv
+
+ csv_text = "\n".join([
+ "資料來源,外部商品ID,商品名稱,售價,資料時間,取得方式,PChome商品ID,同款狀態,資料可信度",
+ "momo_reference,MOMO-1,可用商品,899,2026-06-15T10:00:00,manual_csv,PCH-1,verified,88",
+ "shopee,SHP-1,暫停來源商品,799,2026-06-15T10:01:00,manual_csv,PCH-2,verified,90",
+ "momo_reference,MOMO-2,缺價格商品,,2026-06-15T10:02:00,manual_csv,PCH-3,verified,90",
+ ])
+
+ payload = dry_run_external_offer_csv(csv_text)
+
+ assert payload["success"] is True
+ assert payload["message"] == "CSV 預檢完成，尚未寫入資料。"
+ assert payload["summary"] == {
+ "total_rows": 3,
+ "ready_count": 1,
+ "review_count": 1,
+ "blocked_count": 1,
+ }
+ rows = payload["rows"]
+ assert rows[0]["status_label"] == "可使用"
+ assert rows[1]["status_label"] == "需人工確認"
+ assert "這個來源目前先暫停，不進告警" in rows[1]["reasons"]
+ assert rows[2]["status_label"] == "不能使用"
+ assert "缺少售價" in rows[2]["reasons"]
+
+
+def test_external_offer_csv_dry_run_reports_empty_file_plainly():
+ from services.external_market_offer_service import dry_run_external_offer_csv
+
+ payload = dry_run_external_offer_csv("")
+
+ assert payload["success"] is False
+ assert payload["errors"] == ["CSV 內容是空的"]
+ assert payload["summary"]["blocked_count"] == 0
+
+
def test_external_source_readiness_uses_legacy_momo_reference_cache():
from services.external_market_offer_service import build_external_source_readiness
@@ -87,3 +125,12 @@ def test_external_market_migration_creates_source_and_offer_tables():
assert "coupang" in migration
assert "DROP " not in migration.upper()
assert "TRUNCATE " not in migration.upper()
+
+
+def test_external_offer_csv_dry_run_route_is_registered_as_post_only():
+ from pathlib import Path
+
+ route_source = Path("routes/ai_routes.py").read_text(encoding="utf-8")
+
+ assert "@ai_bp.route('/api/ai/pchome-growth/external-offers/csv-dry-run', methods=['POST'])" in route_source
+ assert "dry_run_external_offer_csv" in route_source
diff --git a/tests/test_pchome_revenue_growth_service.py b/tests/test_pchome_revenue_growth_service.py
index 8f36470..7f123af 100644
--- a/tests/test_pchome_revenue_growth_service.py
+++ b/tests/test_pchome_revenue_growth_service.py
@@ -89,5 +89,7 @@ def test_ai_intelligence_template_uses_pchome_growth_name_and_endpoint():
assert "PChome 業績成長自動化作戰系統" in template
assert "/api/ai/pchome-growth/opportunities" in template
+ assert "/api/ai/pchome-growth/external-offers/csv-dry-run" in template
assert "growthSourceReadiness" in template
+ assert "外部報價預檢" in template
assert "待補對應" in template