docs: add traffic ops admin implementation plan

Bite-sized tasks for TrafficOpsView package CRUD, purchase intake, and ledger.
3 weeks ago · 5d192c0541
1 changed files with 703 additions and 0 deletions
--- a/docs/superpowers/plans/2026-09-01-traffic-ops-admin.md
+++ b/docs/superpowers/plans/2026-09-01-traffic-ops-admin.md
@ -0,0 +1,703 @@
+# Traffic Ops Admin Page Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 为管理员新增独立「流量运营」页：套餐 CRUD、采购入池、账务流水只读。
+
+**Architecture:** 新建 `TrafficOpsView`，页内三 Tab；路由 `/traffic-ops` + `meta.admin`；侧栏/顶栏挂入口；对接既有 `/v1/admin/traffic/*`，不改后端。UI/交互对齐 `FirmwaresView`（operation-page、asset-toolbar、t-table、t-dialog、ui.confirm）。
+
+**Tech Stack:** Vue 3、tdesign-vue-next、Pinia uiStore、axios `src/utils/http.js`、现有 urls/router/layout 模式
+
+**Spec:** `docs/superpowers/specs/2026-09-01-traffic-ops-admin-design.md`
+
+---
+
+## File map
+
+| 文件 | 职责 |
+|---|---|
+| `src/config/urls.js` | 新增 admin traffic URL 常量 |
+| `src/router/index.js` | 注册 `/traffic-ops` |
+| `src/layout/components/SideMenu.vue` | 管理员菜单「流量运营」 |
+| `src/layout/components/TopBar.vue` | 标题映射 |
+| `src/views/TrafficOpsView/TrafficOpsView.vue` | 页面本体（三 Tab） |
+
+辅助约定：
+
+- 请求：`import request from '@/utils/http'`
+- Toast/Confirm：`useUiStore()` from `@/stores/modules/uiStore`
+- GB ↔ bytes：`GB_BYTES = 1024 ** 3`；展示用 `bytesToGbText(n)`
+- pool 404：拦截器会 toast + reject；采购 Tab 需 catch `err.status === 404` / msg 含「资源不存在」，把 `pool` 置空并抑制二次致命提示（可吞掉已知 404）
+
+---
+
+### Task 1: URL + 路由 + 菜单骨架
+
+**Files:**
+- Modify: `src/config/urls.js`
+- Modify: `src/router/index.js`
+- Modify: `src/layout/components/SideMenu.vue`
+- Modify: `src/layout/components/TopBar.vue`
+- Create: `src/views/TrafficOpsView/TrafficOpsView.vue`（骨架）
+
+- [ ] **Step 1: 在 `urls.js` Account 段落后追加 Admin Traffic 常量**
+
+```js
+// Admin traffic ops
+export const ADMIN_TRAFFIC_POOL = '/v1/admin/traffic/pool'
+export const ADMIN_TRAFFIC_PURCHASES = '/v1/admin/traffic/purchases'
+export const ADMIN_TRAFFIC_PACKAGES = '/v1/admin/traffic/packages'
+export const ADMIN_TRAFFIC_PACKAGE = (id) => `/v1/admin/traffic/packages/${id}`
+export const ADMIN_TRAFFIC_LEDGER = '/v1/admin/traffic/ledger'
+```
+
+- [ ] **Step 2: 路由增加 admin 子路由（放在 firmwares 附近）**
+
+```js
+{ path: 'traffic-ops', name: 'traffic-ops', component: () => import('../views/TrafficOpsView/TrafficOpsView.vue'), meta: { admin: true } },
+```
+
+- [ ] **Step 3: SideMenu 在「固件管理」后增加菜单项**
+
+```vue
+<t-menu-item v-if="isAdmin" value="traffic-ops">
+  <template #icon>
+    <svg :class="s.icon"><use href="#i-wallet" /></svg>
+  </template>
+  流量运营
+</t-menu-item>
+```
+
+（若 `#i-wallet` 语义冲突，可改用已有 `#i-box` / `#i-download`；不要新增 icon symbol 除非必要。）
+
+- [ ] **Step 4: TopBar titles 增加**
+
+```js
+'traffic-ops': '流量运营',
+```
+
+- [ ] **Step 5: 创建骨架页 `TrafficOpsView.vue`**
+
+```vue
+<template>
+  <section class="operation-page">
+    <header class="operation-page-header">
+      <div>
+        <h1>流量运营</h1>
+        <span>管理云媒体流量套餐、平台采购入池与账务流水</span>
+      </div>
+    </header>
+
+    <div class="business-workspace">
+      <t-tabs v-model="tab" class="business-tdesign-tabs">
+        <t-tab-panel value="packages" label="套餐管理" :destroy-on-hide="false" />
+        <t-tab-panel value="purchases" label="采购入池" :destroy-on-hide="false" />
+        <t-tab-panel value="ledger" label="账务流水" :destroy-on-hide="false" />
+      </t-tabs>
+
+      <div v-show="tab === 'packages'">套餐管理占位</div>
+      <div v-show="tab === 'purchases'">采购入池占位</div>
+      <div v-show="tab === 'ledger'">账务流水占位</div>
+    </div>
+  </section>
+</template>
+
+<script setup>
+import { ref, watch } from 'vue'
+
+const tab = ref('packages')
+
+watch(tab, (v) => {
+  // 后续各 Tab 按需懒加载
+  void v
+})
+</script>
+```
+
+- [ ] **Step 6: 冒烟**
+
+Run（本地已有 Vite 时）：管理员登录 → 侧栏见「流量运营」→ 进入页见三 Tab；普通用户侧栏无此项，手动访问 `/traffic-ops` 应回 `/monitor`。
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add src/config/urls.js src/router/index.js src/layout/components/SideMenu.vue src/layout/components/TopBar.vue src/views/TrafficOpsView/TrafficOpsView.vue
+git commit -m "$(cat <<'EOF'
+feat: scaffold admin traffic ops page
+
+Add /traffic-ops route, menu entry, urls, and tabbed page shell.
+EOF
+)"
+```
+
+---
+
+### Task 2: 套餐管理 Tab CRUD
+
+**Files:**
+- Modify: `src/views/TrafficOpsView/TrafficOpsView.vue`
+
+- [ ] **Step 1: 增加共享工具函数与套餐状态**
+
+```js
+import { onMounted, reactive, ref, watch } from 'vue'
+import { useUiStore } from '@/stores/modules/uiStore'
+import request from '@/utils/http'
+import * as urls from '@/config/urls'
+
+const ui = useUiStore()
+const GB_BYTES = 1024 ** 3
+
+function bytesToGb(n) {
+  const v = Number(n || 0) / GB_BYTES
+  return Number.isFinite(v) ? v : 0
+}
+function bytesToGbText(n) {
+  return `${bytesToGb(n).toFixed(2)} GB`
+}
+function fmtTime(t) {
+  if (!t) return '--'
+  const d = new Date(t)
+  if (Number.isNaN(d.getTime())) return '--'
+  return d.toLocaleString('zh-CN', { hour12: false })
+}
+
+const tab = ref('packages')
+
+// packages
+const pkgList = ref([])
+const pkgTotal = ref(0)
+const pkgPageNum = ref(1)
+const pkgPageSize = ref(10)
+const pkgStatusFilter = ref('')
+const pkgModalVisible = ref(false)
+const pkgEditingId = ref(null)
+const pkgFormError = ref('')
+const pkgForm = reactive({
+  code: '',
+  name: '',
+  amountGb: 1,
+  price: 0,
+  validityDays: 0,
+  sort: 0,
+  status: 'active'
+})
+
+const pkgStatusFilterOptions = [
+  { label: '全部状态', value: '' },
+  { label: '上架', value: 'active' },
+  { label: '下架', value: 'inactive' }
+]
+const pkgStatusOptions = [
+  { label: '上架', value: 'active' },
+  { label: '下架', value: 'inactive' }
+]
+const pkgColumns = [
+  { colKey: 'code', title: '编码', width: '12%' },
+  { colKey: 'name', title: '名称', width: '14%' },
+  { colKey: 'amountText', title: '额度', width: '10%' },
+  { colKey: 'priceText', title: '价格', width: '8%' },
+  { colKey: 'validityText', title: '有效期', width: '10%' },
+  { colKey: 'status', title: '状态', width: '8%' },
+  { colKey: 'sort', title: '排序', width: '6%' },
+  { colKey: 'updatedAt', title: '更新时间', width: '16%' },
+  { colKey: 'actions', title: '操作', width: '12%' }
+]
+```
+
+- [ ] **Step 2: 实现 loadPackages / open / submit / disable**
+
+```js
+async function loadPackages() {
+  try {
+    const params = { pageNum: pkgPageNum.value, pageSize: pkgPageSize.value }
+    if (pkgStatusFilter.value) params.status = pkgStatusFilter.value
+    const page = await request.get(urls.ADMIN_TRAFFIC_PACKAGES, { params })
+    pkgTotal.value = page?.total || 0
+    pkgList.value = (page?.records || []).map((p) => ({
+      id: String(p.id),
+      code: p.code,
+      name: p.name,
+      amountText: bytesToGbText(p.amountBytes),
+      priceText: `¥${Number(p.price || 0).toFixed(2)}`,
+      validityText: Number(p.validityDays) > 0 ? `${p.validityDays} 天` : '长期有效',
+      status: p.status,
+      statusName: p.status === 'active' ? '上架' : '下架',
+      statusClass: p.status === 'active' ? 'online' : 'offline',
+      sort: p.sort ?? 0,
+      updatedAt: fmtTime(p.updatedAt),
+      raw: p
+    }))
+  } catch (e) {
+    ui.toast(e.message || '加载套餐失败')
+  }
+}
+
+function reloadPackages() {
+  pkgPageNum.value = 1
+  loadPackages()
+}
+
+function openPkgAdd() {
+  Object.assign(pkgForm, { code: '', name: '', amountGb: 1, price: 0, validityDays: 0, sort: 0, status: 'active' })
+  pkgEditingId.value = null
+  pkgFormError.value = ''
+  pkgModalVisible.value = true
+}
+
+function openPkgEdit(row) {
+  const r = row.raw
+  Object.assign(pkgForm, {
+    code: r.code,
+    name: r.name,
+    amountGb: Number(bytesToGb(r.amountBytes).toFixed(4)) || 1,
+    price: Number(r.price || 0),
+    validityDays: Number(r.validityDays || 0),
+    sort: Number(r.sort || 0),
+    status: r.status || 'active'
+  })
+  pkgEditingId.value = row.id
+  pkgFormError.value = ''
+  pkgModalVisible.value = true
+}
+
+async function submitPackage() {
+  pkgFormError.value = ''
+  if (!pkgForm.name || (!pkgEditingId.value && !pkgForm.code)) {
+    pkgFormError.value = '请填写编码和名称'
+    return
+  }
+  if (!(Number(pkgForm.amountGb) > 0)) {
+    pkgFormError.value = '额度必须大于 0 GB'
+    return
+  }
+  const amountBytes = Math.round(Number(pkgForm.amountGb) * GB_BYTES)
+  try {
+    if (pkgEditingId.value) {
+      // 后端 Update: price/validityDays 仅 >0 才写入；编辑时若用户未改就原样提交正值
+      const payload = {
+        name: pkgForm.name,
+        amountBytes,
+        sort: Number(pkgForm.sort || 0),
+        status: pkgForm.status
+      }
+      if (Number(pkgForm.price) > 0) payload.price = Number(pkgForm.price)
+      if (Number(pkgForm.validityDays) > 0) payload.validityDays = Number(pkgForm.validityDays)
+      // 长期有效（0）无法通过 Update 写入；保持原值即可。若必须把有效期改成长期，需后端后续支持。
+      await request.put(urls.ADMIN_TRAFFIC_PACKAGE(pkgEditingId.value), payload)
+      ui.toast('套餐已更新')
+    } else {
+      await request.post(urls.ADMIN_TRAFFIC_PACKAGES, {
+        code: pkgForm.code.trim(),
+        name: pkgForm.name.trim(),
+        amountBytes,
+        price: Number(pkgForm.price || 0),
+        validityDays: Number(pkgForm.validityDays || 0),
+        sort: Number(pkgForm.sort || 0)
+      })
+      ui.toast('套餐已创建')
+    }
+    pkgModalVisible.value = false
+    await loadPackages()
+  } catch (e) {
+    pkgFormError.value = e.message || '保存失败'
+  }
+}
+
+async function disablePackage(row) {
+  const ok = await ui.confirm(
+    `确认下架套餐 ${row.name}？`,
+    '下架后用户侧购买区不可见，之后可再编辑上架。'
+  )
+  if (!ok) return
+  try {
+    await request.delete(urls.ADMIN_TRAFFIC_PACKAGE(row.id))
+    ui.toast('套餐已下架')
+    await loadPackages()
+  } catch (e) {
+    ui.toast(e.message || '下架失败')
+  }
+}
+```
+
+- [ ] **Step 3: 模板替换 packages 占位**
+
+结构对齐 FirmwaresView：
+
+- `asset-toolbar`：状态筛选 `@change="reloadPackages"`
+- header `page-actions`：刷新 `loadPackages`、新建 `openPkgAdd`
+- `t-table` + `#status` / `#actions`（编辑、下架）
+- `t-pagination` 绑定 `pkgPageNum` / `pkgTotal` / `pkgPageSize`
+- `t-dialog destroy-on-close`：新建/编辑表单；编辑时 `code` disabled；编辑显示 status 选择
+
+关键表单片段：
+
+```vue
+<label><span>编码<b>*</b></span>
+  <t-input v-model="pkgForm.code" :disabled="!!pkgEditingId" placeholder="唯一编码，如 MEDIA_10G" />
+</label>
+<label><span>名称<b>*</b></span><t-input v-model="pkgForm.name" placeholder="套餐名称" /></label>
+<div class="form-row">
+  <label><span>额度(GB)<b>*</b></span>
+    <t-input-number v-model="pkgForm.amountGb" theme="normal" :min="0.01" :step="1" style="width:100%" />
+  </label>
+  <label><span>价格(元)</span>
+    <t-input-number v-model="pkgForm.price" theme="normal" :min="0" :step="0.01" style="width:100%" />
+  </label>
+</div>
+<div class="form-row">
+  <label><span>有效期(天)</span>
+    <t-input-number v-model="pkgForm.validityDays" theme="normal" :min="0" style="width:100%" />
+  </label>
+  <label><span>排序</span>
+    <t-input-number v-model="pkgForm.sort" theme="normal" :min="0" style="width:100%" />
+  </label>
+</div>
+<label v-if="pkgEditingId"><span>状态</span>
+  <t-select v-model="pkgForm.status" :options="pkgStatusOptions" style="width:100%" />
+</label>
+<div class="form-hint" v-if="!pkgEditingId">有效期填 0 表示长期有效</div>
+```
+
+- [ ] **Step 4: Tab 切换 / onMounted 加载**
+
+```js
+watch(tab, (v) => {
+  if (v === 'packages') loadPackages()
+})
+onMounted(() => {
+  if (tab.value === 'packages') loadPackages()
+})
+```
+
+- [ ] **Step 5: 冒烟**
+
+管理员进入套餐 Tab：
+
+1. 列表能出已有套餐
+2. 新建一套餐 → 列表出现 → 用户账户购买区可见
+3. 编辑改名/价格 → 生效
+4. 下架 → 用户侧消失；再编辑 status=active 可上架
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add src/views/TrafficOpsView/TrafficOpsView.vue
+git commit -m "$(cat <<'EOF'
+feat: add traffic package CRUD tab
+
+Admin can create, edit, and disable cloud media traffic packages.
+EOF
+)"
+```
+
+---
+
+### Task 3: 采购入池 Tab
+
+**Files:**
+- Modify: `src/views/TrafficOpsView/TrafficOpsView.vue`
+
+- [ ] **Step 1: 增加 pool / purchases 状态与加载**
+
+```js
+const pool = ref(null) // null = 未建池
+const poolMissing = ref(false)
+const purchaseList = ref([])
+const purchaseTotal = ref(0)
+const purchasePageNum = ref(1)
+const purchasePageSize = ref(10)
+const purchaseProvider = ref('')
+const purchaseStatus = ref('')
+const purchaseModalVisible = ref(false)
+const purchaseFormError = ref('')
+const purchaseForm = reactive({
+  batchNo: '',
+  provider: '',
+  totalGb: 1,
+  unitCost: 0,
+  totalCost: 0,
+  expiresAt: '',
+  remark: ''
+})
+
+const purchaseStatusOptions = [
+  { label: '全部状态', value: '' },
+  { label: '有效', value: 'active' },
+  { label: '失效', value: 'inactive' }
+]
+const purchaseColumns = [
+  { colKey: 'batchNo', title: '批次号', width: '12%' },
+  { colKey: 'provider', title: '供应商', width: '10%' },
+  { colKey: 'totalText', title: '总量', width: '10%' },
+  { colKey: 'costText', title: '成本', width: '10%' },
+  { colKey: 'expiresAt', title: '到期', width: '14%' },
+  { colKey: 'statusName', title: '状态', width: '8%' },
+  { colKey: 'remark', title: '备注', width: '14%', ellipsis: true },
+  { colKey: 'createdAt', title: '创建时间', width: '16%' }
+]
+
+async function loadPool() {
+  poolMissing.value = false
+  try {
+    pool.value = await request.get(urls.ADMIN_TRAFFIC_POOL)
+  } catch (e) {
+    if (e.status === 404 || /资源不存在|not found/i.test(e.message || '')) {
+      pool.value = null
+      poolMissing.value = true
+      return
+    }
+    ui.toast(e.message || '加载资源池失败')
+  }
+}
+
+async function loadPurchases() {
+  try {
+    const params = { pageNum: purchasePageNum.value, pageSize: purchasePageSize.value }
+    if (purchaseProvider.value) params.provider = purchaseProvider.value
+    if (purchaseStatus.value) params.status = purchaseStatus.value
+    const page = await request.get(urls.ADMIN_TRAFFIC_PURCHASES, { params })
+    purchaseTotal.value = page?.total || 0
+    purchaseList.value = (page?.records || []).map((p) => ({
+      id: String(p.id),
+      batchNo: p.batchNo || '—',
+      provider: p.provider || '—',
+      totalText: bytesToGbText(p.totalBytes),
+      costText: `¥${Number(p.totalCost || 0).toFixed(2)}`,
+      expiresAt: fmtTime(p.expiresAt),
+      statusName: p.status === 'active' ? '有效' : (p.status || '—'),
+      remark: p.remark || '',
+      createdAt: fmtTime(p.createdAt),
+      raw: p
+    }))
+  } catch (e) {
+    ui.toast(e.message || '加载采购列表失败')
+  }
+}
+
+async function loadPurchasesTab() {
+  await Promise.all([loadPool(), loadPurchases()])
+}
+
+function openPurchaseAdd() {
+  Object.assign(purchaseForm, {
+    batchNo: '', provider: '', totalGb: 1, unitCost: 0, totalCost: 0, expiresAt: '', remark: ''
+  })
+  purchaseFormError.value = ''
+  purchaseModalVisible.value = true
+}
+
+async function submitPurchase() {
+  purchaseFormError.value = ''
+  if (!purchaseForm.batchNo.trim() || !purchaseForm.provider.trim()) {
+    purchaseFormError.value = '请填写批次号和供应商'
+    return
+  }
+  if (!(Number(purchaseForm.totalGb) > 0)) {
+    purchaseFormError.value = '采购总量必须大于 0 GB'
+    return
+  }
+  const payload = {
+    batchNo: purchaseForm.batchNo.trim(),
+    provider: purchaseForm.provider.trim(),
+    totalBytes: Math.round(Number(purchaseForm.totalGb) * GB_BYTES),
+    unitCost: Number(purchaseForm.unitCost || 0),
+    totalCost: Number(purchaseForm.totalCost || 0),
+    remark: purchaseForm.remark || ''
+  }
+  if (purchaseForm.expiresAt) {
+    // t-date-picker 若返回字符串，转 ISO；后端 *time.Time
+    payload.expiresAt = new Date(purchaseForm.expiresAt).toISOString()
+  }
+  try {
+    await request.post(urls.ADMIN_TRAFFIC_PURCHASES, payload)
+    ui.toast('采购已录入')
+    purchaseModalVisible.value = false
+    await loadPurchasesTab()
+  } catch (e) {
+    purchaseFormError.value = e.message || '录入失败'
+  }
+}
+```
+
+- [ ] **Step 2: 模板采购区**
+
+1. 资源池卡片（`poolMissing` 时空态文案：「尚未建立资源池，首次录入采购后自动创建」）
+2. 工具栏：provider 输入 / status 筛选 / 刷新 / 录入采购
+3. 采购表 + 分页
+4. 新建弹窗字段对齐 CreateReq
+
+- [ ] **Step 3: watch tab 时加载 purchases**
+
+```js
+watch(tab, (v) => {
+  if (v === 'packages') loadPackages()
+  if (v === 'purchases') loadPurchasesTab()
+})
+```
+
+- [ ] **Step 4: 冒烟**
+
+1. pool 不存在时卡片空态，不整页挂掉
+2. 录入 1GB 采购 → pool 出现/可用增加 → 列表有记录
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/views/TrafficOpsView/TrafficOpsView.vue
+git commit -m "$(cat <<'EOF'
+feat: add traffic purchase intake tab
+
+Show platform pool status and allow creating purchase batches.
+EOF
+)"
+```
+
+---
+
+### Task 4: 账务流水 Tab（只读）
+
+**Files:**
+- Modify: `src/views/TrafficOpsView/TrafficOpsView.vue`
+
+- [ ] **Step 1: 状态与加载**
+
+```js
+const ledgerList = ref([])
+const ledgerTotal = ref(0)
+const ledgerPageNum = ref(1)
+const ledgerPageSize = ref(10)
+const ledgerAccountType = ref('')
+const ledgerAccountId = ref('')
+
+const ledgerAccountTypeOptions = [
+  { label: '全部账户', value: '' },
+  { label: '用户', value: 'user' },
+  { label: '平台', value: 'platform' }
+]
+const ledgerColumns = [
+  { colKey: 'createdAt', title: '时间', width: '14%' },
+  { colKey: 'accountType', title: '账户类型', width: '8%' },
+  { colKey: 'accountId', title: '账户ID', width: '10%' },
+  { colKey: 'direction', title: '方向', width: '7%' },
+  { colKey: 'amountText', title: '金额', width: '12%' },
+  { colKey: 'balanceText', title: '余额前→后', width: '14%' },
+  { colKey: 'sourceType', title: '来源', width: '10%' },
+  { colKey: 'sourceId', title: '来源ID', width: '10%', ellipsis: true },
+  { colKey: 'idempotencyKey', title: '幂等键', width: '12%', ellipsis: true }
+]
+
+async function loadLedger() {
+  try {
+    const params = { pageNum: ledgerPageNum.value, pageSize: ledgerPageSize.value }
+    if (ledgerAccountType.value) params.accountType = ledgerAccountType.value
+    if (ledgerAccountId.value) params.accountId = Number(ledgerAccountId.value)
+    const page = await request.get(urls.ADMIN_TRAFFIC_LEDGER, { params })
+    ledgerTotal.value = page?.total || 0
+    ledgerList.value = (page?.records || []).map((r) => ({
+      id: String(r.id),
+      createdAt: fmtTime(r.createdAt),
+      accountType: r.accountType,
+      accountId: String(r.accountId),
+      direction: r.direction === 'credit' ? '入账' : (r.direction === 'debit' ? '扣减' : r.direction),
+      amountText: `${bytesToGbText(r.amountBytes)} (${r.amountBytes})`,
+      balanceText: `${bytesToGbText(r.balanceBefore)} → ${bytesToGbText(r.balanceAfter)}`,
+      sourceType: r.sourceType || '—',
+      sourceId: r.sourceId || '—',
+      idempotencyKey: r.idempotencyKey || '—'
+    }))
+  } catch (e) {
+    ui.toast(e.message || '加载流水失败')
+  }
+}
+
+function reloadLedger() {
+  ledgerPageNum.value = 1
+  loadLedger()
+}
+```
+
+- [ ] **Step 2: 模板**
+
+筛选栏 + 只读表 + 分页；`empty="暂无流水"`；无写按钮。
+
+- [ ] **Step 3: watch tab 加载 ledger**
+
+```js
+if (v === 'ledger') loadLedger()
+```
+
+- [ ] **Step 4: 冒烟**
+
+切换到流水 Tab 能分页；筛选 `platform` / `user` 不报错。
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/views/TrafficOpsView/TrafficOpsView.vue
+git commit -m "$(cat <<'EOF'
+feat: add read-only traffic ledger tab
+
+Allow admins to filter and page platform/user traffic ledger entries.
+EOF
+)"
+```
+
+---
+
+### Task 5: 端到端验收与收口
+
+**Files:** 视冒烟结果微调 `TrafficOpsView.vue` / 样式
+
+- [ ] **Step 1: 权限验收**
+
+- 管理员：侧栏可见，三 Tab 可用
+- 普通用户：侧栏不可见；访问 `/traffic-ops` → `/monitor`
+
+- [ ] **Step 2: 业务闭环验收**
+
+1. 新建 active 套餐 → 账户中心购买区出现
+2. 下架 → 购买区消失
+3. 录入采购 → pool 可用增加
+4. （若有支付流水）ledger 可见对应记录；没有也至少空态正常
+
+- [ ] **Step 3: 已知后端约束确认**
+
+- 编辑套餐时：`price=0` / `validityDays=0` **不会**被 Update 写入（payload 已按 `>0` 省略）
+- 创建时 `validityDays=0` 表示长期有效（OK）
+- pool 404 不炸页
+
+- [ ] **Step 4: 最终 commit（若有样式/文案微调）**
+
+```bash
+git add src/views/TrafficOpsView/TrafficOpsView.vue
+git commit -m "$(cat <<'EOF'
+fix: polish traffic ops admin page
+
+Tighten empty states, filters, and GB display after smoke checks.
+EOF
+)"
+```
+
+（无改动则跳过。）
+
+---
+
+## Self-review
+
+**Spec coverage**
+
+| Spec 项 | Task |
+|---|---|
+| 独立 `/traffic-ops` + 菜单 + 顶栏 | Task 1 |
+| 套餐 CRUD / 下架 confirm / GB 输入 | Task 2 |
+| 采购入池 + pool 404 空态 | Task 3 |
+| 流水只读筛选分页 | Task 4 |
+| 权限双控与用户侧可见性回归 | Task 5 |
+| 不改后端 / 不做采购编辑删除 / 不做流水写入 | 全任务遵守 |
+
+**Placeholder scan:** 无 TBD；关键 payload/模板已写出。
+
+**一致性:** URL 常量名、Tab value、字段名与后端 JSON（camelCase）一致。
+
+**风险记入实现:** Update 无法把 `validityDays` 改回 0；若产品强需求，另开后端任务，不在本计划偷偷改契约。