feat(t222): add freight ingestion admin flow

2026-07-28 23:26:34 +08:00
parent c524e734fb
commit 6d052b0462
37 changed files with 3397 additions and 101 deletions
@@ -0,0 +1,66 @@
+{{define "freight-detail"}}
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <title>{{.Page.Title}} - 采购任务管理</title>
+  {{template "document-head" .}}
+</head>
+<body>
+  {{template "site-header" .}}
+  <main id="main-content" class="page">
+    <div class="title-row">
+      <div>
+        <h1>{{if .Detail.Order.SourceCode}}{{.Detail.Order.SourceCode}}{{else}}货运详情{{end}}</h1>
+        <p class="subtitle">ERP ID：{{.Detail.Order.ExternalStockID}} · 来源版本 {{.Detail.Order.Revision}}</p>
+      </div>
+      <a class="button" href="/freight">返回列表</a>
+    </div>
+    <section class="detail-section" aria-labelledby="freight-source-title">
+      <h2 id="freight-source-title">来源信息</h2>
+      <dl class="detail-grid">
+        <div><dt>店铺</dt><dd>{{if .Detail.Order.ShopName}}{{.Detail.Order.ShopName}}{{else}}未提供{{end}}</dd></div>
+        <div><dt>ERP 创建时间</dt><dd>{{displayTime .Detail.Order.SourceCreatedAt}}</dd></div>
+        <div><dt>订单状态</dt><dd>{{if .Detail.Order.OrderStatus}}{{.Detail.Order.OrderStatus}}{{else}}未提供{{end}}</dd></div>
+        <div><dt>采购状态</dt><dd>{{if .Detail.Order.PurchaseStatus}}{{.Detail.Order.PurchaseStatus}}{{else}}未提供{{end}}</dd></div>
+      </dl>
+    </section>
+    <section class="table-region" aria-labelledby="freight-items-title">
+      <h2 id="freight-items-title">商品明细</h2>
+      {{if .Detail.Items}}
+      <table>
+        <thead>
+          <tr>
+            <th scope="col">商品</th>
+            <th scope="col">规格 / SKU</th>
+            <th scope="col">数量</th>
+            <th scope="col">采购状态</th>
+            <th scope="col">来源版本</th>
+          </tr>
+        </thead>
+        <tbody>
+          {{range .Detail.Items}}
+          <tr>
+            <td data-label="商品">
+              <strong>{{if .Title}}{{.Title}}{{else}}缺少标题{{end}}</strong>
+              <span class="secondary">明细 ID：{{.ExternalItemID}}</span>
+              {{if .ProductThumbRef}}<span class="secondary">图片引用：{{.ProductThumbRef}}</span>{{end}}
+            </td>
+            <td data-label="规格 / SKU">
+              <span>{{if .ProductSpec}}{{.ProductSpec}}{{else}}未提供规格{{end}}</span>
+              <span class="secondary">SKU：{{if .SKU}}{{.SKU}}{{else}}未提供{{end}}</span>
+            </td>
+            <td data-label="数量">{{if .Quantity}}{{.Quantity}}{{else}}未提供{{end}}</td>
+            <td data-label="采购状态">{{if .PurchaseStatus}}{{.PurchaseStatus}}{{else}}未提供{{end}}</td>
+            <td data-label="来源版本">{{.Revision}}</td>
+          </tr>
+          {{end}}
+        </tbody>
+      </table>
+      {{else}}
+      <div class="empty-state"><h2>该货运单没有商品明细</h2></div>
+      {{end}}
+    </section>
+  </main>
+</body>
+</html>
+{{end}}
@@ -0,0 +1,46 @@
+{{define "freight-import"}}
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <title>{{.Page.Title}} - 采购任务管理</title>
+  {{template "document-head" .}}
+</head>
+<body>
+  {{template "site-header" .}}
+  <main id="main-content" class="page narrow-page">
+    <div class="title-row">
+      <div>
+        <h1>导入 ERP 货运</h1>
+        <p class="subtitle">使用 ERP 页面“全部单号”中的完整单号</p>
+      </div>
+      <a class="button" href="/freight">返回列表</a>
+    </div>
+    {{if .Error}}<div class="notice danger" role="alert">{{.Error}}</div>{{end}}
+    {{if .Sync}}
+    <section class="detail-section" aria-labelledby="sync-result-title">
+      <h2 id="sync-result-title">同步状态</h2>
+      <dl class="detail-grid">
+        <div><dt>状态</dt><dd>{{.Sync.Status}}</dd></div>
+        <div><dt>货运单</dt><dd>{{.Sync.OrderCount}}</dd></div>
+        <div><dt>商品明细</dt><dd>{{.Sync.ItemCount}}</dd></div>
+        <div><dt>错误码</dt><dd>{{if .Sync.ErrorCode}}{{.Sync.ErrorCode}}{{else}}无{{end}}</dd></div>
+      </dl>
+      {{if or (eq .Sync.Status "PENDING") (eq .Sync.Status "RUNNING")}}
+      <p class="secondary">同步仍在后台执行，刷新本页查看结果。</p>
+      {{end}}
+    </section>
+    {{end}}
+    <form class="form-panel" method="post" action="/freight/import" data-loading-form>
+      <input type="hidden" name="csrf_token" value="{{.Page.CSRFToken}}">
+      <input type="hidden" name="idempotency_key" value="{{.IdempotencyKey}}">
+      <div class="field">
+        <label for="order-number">完整单号</label>
+        <input id="order-number" name="order_number" value="{{.OrderNumber}}"
+          maxlength="128" autocomplete="off" required>
+      </div>
+      <button class="button primary" type="submit" data-loading-label="正在创建…">开始同步</button>
+    </form>
+  </main>
+</body>
+</html>
+{{end}}
@@ -0,0 +1,62 @@
+{{define "freight"}}
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <title>{{.Page.Title}} - 采购任务管理</title>
+  {{template "document-head" .}}
+</head>
+<body>
+  {{template "site-header" .}}
+  <main id="main-content" class="page">
+    <div class="title-row">
+      <div>
+        <h1>ERP 货运</h1>
+        <p class="subtitle">核对已同步的货运单和全部商品明细</p>
+      </div>
+      <a class="button primary" href="/freight/import">导入货运单</a>
+    </div>
+    <section class="table-region" aria-labelledby="freight-table-title">
+      <h2 id="freight-table-title" class="visually-hidden">货运单列表</h2>
+      {{if .Orders}}
+      <table>
+        <thead>
+          <tr>
+            <th scope="col">来源单号</th>
+            <th scope="col">店铺</th>
+            <th scope="col">状态</th>
+            <th scope="col">商品</th>
+            <th scope="col">更新时间</th>
+            <th scope="col"><span class="visually-hidden">操作</span></th>
+          </tr>
+        </thead>
+        <tbody>
+          {{range .Orders}}
+          <tr>
+            <td data-label="来源单号">
+              <strong>{{if .SourceCode}}{{.SourceCode}}{{else}}{{.ExternalStockID}}{{end}}</strong>
+              <span class="secondary">ERP ID：{{.ExternalStockID}}</span>
+            </td>
+            <td data-label="店铺">{{if .ShopName}}{{.ShopName}}{{else}}未提供{{end}}</td>
+            <td data-label="状态">
+              <span class="secondary">订单：{{if .OrderStatus}}{{.OrderStatus}}{{else}}未提供{{end}}</span>
+              <span class="secondary">采购：{{if .PurchaseStatus}}{{.PurchaseStatus}}{{else}}未提供{{end}}</span>
+            </td>
+            <td data-label="商品">{{.ItemCount}} 项</td>
+            <td data-label="更新时间"><time datetime="{{machineTime .UpdatedAt}}">{{displayTime .UpdatedAt}}</time></td>
+            <td data-label="操作"><a class="detail-link" href="/freight/{{pathPart .ID}}">查看详情</a></td>
+          </tr>
+          {{end}}
+        </tbody>
+      </table>
+      {{else}}
+      <div class="empty-state">
+        <h2>尚未导入货运单</h2>
+        <p>按完整单号创建第一条 ERP 同步任务。</p>
+        <a class="button primary" href="/freight/import">导入货运单</a>
+      </div>
+      {{end}}
+    </section>
+  </main>
+</body>
+</html>
+{{end}}
@@ -17,6 +17,7 @@
  <nav class="main-nav" aria-label="主导航">
    <a href="/tasks" {{if .Page.TasksCurrent}}aria-current="page"{{end}}>任务列表</a>
    <a href="/tasks/new" {{if .Page.NewCurrent}}aria-current="page"{{end}}>新建任务</a>
+    <a href="/freight" {{if .Page.FreightCurrent}}aria-current="page"{{end}}>ERP 货运</a>
  </nav>
  {{if .Page.CSRFToken}}
  <form class="logout-form" method="post" action="/logout">