WEB/src/views/storage/stockcheck/config/template-config.ts
2026-09-29 18:15:06 +08:00

1044 lines
36 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/**
* 【库存盘点】配置文件 — 基于 views/mode 模板 v2
*
* ===== 接口来源 =====
* 全部接口来自「库存盘点模块」(module folder = stock.check),封装在
* `src/api/stock.check/stock.check.ts`:
*
* 列表 stock.check.list → 本文件 tabPages[].api.list
* 详情 stock.check.detail → CheckItemsPanel(明细面板自行拉取)
* 新建 stock.check.create → pages/CheckFormDialog.vue
* 加明细 stock.check.addDetail → pages/CheckStockPickerDialog.vue
* 上报 stock.check.report → CheckItemsPanel(行内 / 批量上报,覆盖式)
* 记录列表 stock.check.recordList → CheckRecordsPanel(作业记录页签)
* 记录删除 stock.check.recordDelete → CheckRecordsPanel(仅 approved/checking 可删)
* 提交 stock.check.submit → index.vue 操作列
* 审核 stock.check.audit → index.vue 操作列(通过 / 驳回)
* 完成 stock.check.finish → index.vue 操作列
* 取消 stock.check.cancel → index.vue 操作列
* 导出 stock.check.export → index.vue(useAsyncExportTask + 进度弹窗)
* 导出进度 stock.check.exportTaskProgress → 同上
*
* ===== 状态机(主表 status)=====
* created ──submit──> submitted ──audit(approve)──> approved ──report(首次)──> checking ──finish──> completed
* │ │ (终态)
* │ └──audit(reject)──> rejected ──addDetail/submit 可再来──┐
* └──cancel──> cancelled(终态) │
* ↑──────────────── submit 仅 created/rejected ──────────────────────────┘
*
* 注意:warehouse_id 由服务端从登录上下文(ctx.user.store_id)注入,前端一律不传。
*
* ===== 核心设计(沿用模板)=====
* 1. FIELD_DICT — 全局字段预设表(唯一真相来源)
* 2. VALUE_MAPS — 值翻译映射表(select options 和 tag 翻译共用)
* 3. TAG_RESOLVERS — 状态文字颜色解析器
* 4. 各标签页通过 key 引用所需字段(scanBoxFieldKeys / tableColumnKeys)
* 5. resolveTabConfig() — 加载时将 key 列表展开为完整配置
*/
import { ref, isRef, type Component } from 'vue'
import DetailPanel from './components/DetailPanel.vue'
import CheckItemsPanel from './components/CheckItemsPanel.vue'
import CheckRecordsPanel from './components/CheckRecordsPanel.vue'
import {
stockCheckList,
stockCheckExport,
stockCheckExportTaskProgress,
type StockCheckStatus
} from '@/api/stock.check/stock.check'
import { loadStores } from '@/api/index/index'
// ============================================================
// 〇、全局页面配置
// ============================================================
export const PAGE_CONFIG = {
/** 是否显示顶部多标签栏(本页为单页签,通过 ScanBox 的「状态」筛选,不显示标签栏) */
showTabArea: false,
/** 单页模式:不显示标签栏,仅一个标签页内容 */
singlePage: true,
/** 是否启用详情面板(底部分栏 + 显示/隐藏详情按钮),false 时表格占满全高 */
enableDetailPanel: true
}
// ============================================================
// 〇-A、组件注册表 — 所有可复用组件在此注册
// ============================================================
export const COMPONENT_REGISTRY: Record<string, Component> = {
/** 盘点单信息(描述列表) */
DetailPanel,
/** 盘点明细(明细行表格 + 实盘上报) */
CheckItemsPanel,
/** 作业记录(recordList + recordDelete) */
CheckRecordsPanel
}
// ============================================================
// 〇-A1、货主下拉选项(ScanBox 筛选与「新建盘点」表单共用)
// ============================================================
/** 货主下拉选项(value 为货主ID;对齐 storage/generalreport 的 index.loadStores) */
export const storeOptions = ref<{ value: number; label: string }[]>([])
let storeOptionsLoading = false
/** 加载货主下拉选项(已加载则复用) */
export async function loadStoreOptions(): Promise<{ value: number; label: string }[]> {
if (storeOptions.value.length) return storeOptions.value
if (storeOptionsLoading) return storeOptions.value
storeOptionsLoading = true
try {
const res: any = await loadStores()
if (res && (res.code === 200 || res.code === 1)) {
const raw: any[] = res.stores ?? res.data?.stores ?? res.data?.list ?? []
storeOptions.value = normalizeStoreOptions(raw)
}
} catch (e) {
console.error('[stockcheck] 加载货主列表失败', e)
} finally {
storeOptionsLoading = false
}
return storeOptions.value
}
/** 兼容 { value,label } / { id,store_remask } / { store_id,store_name } 等形态 */
function normalizeStoreOptions(stores: any[]): { value: number; label: string }[] {
if (!Array.isArray(stores)) return []
const out: { value: number; label: string }[] = []
const seen = new Set<number>()
for (const s of stores) {
const value = Number(s?.value ?? s?.id ?? s?.store_id)
if (!Number.isFinite(value) || value <= 0 || seen.has(value)) continue
seen.add(value)
const label =
(s?.label != null && String(s.label).trim()) ||
(s?.store_remask != null && String(s.store_remask).trim()) ||
(s?.name != null && String(s.name).trim()) ||
(s?.store_name != null && String(s.store_name).trim()) ||
String(value)
out.push({ value, label: String(label) })
}
return out
}
// ============================================================
// 〇-B、SCANBOX_GROUPS — ScanBox 分组名称
// ============================================================
export const SCANBOX_GROUPS = {
basic: '基础信息',
process: '流程状态',
time: '时间范围',
custom: '自定义字段'
} as const
// ============================================================
// 一、FIELD_DICT — 全局字段预设表(唯一真相来源)
// ============================================================
// 每个字段拥有:
// label — 唯一翻译文本
// scanBox — ScanBox 渲染配置(type/options/group)
// table — 表格列配置(minWidth/fixed/align/sortable)
// slot — 单元格渲染配置(tag/tagResolver/translateField)
// detailLabel — 明细面板中的标签文本(可选,默认用 label)
// filterParamMap — ScanBox 筛选值 → API 传参值映射
export interface FieldDefinition {
key: string
label: string
scanBox: {
type: 'text' | 'select' | 'daterange' | 'number'
group?: string
/** 支持数组或 ref(ref 由 resolveTabConfig 解包,保证选项异步加载后仍响应式) */
options?: { label: string; value: any }[] | any
} | null
table: {
minWidth?: number
width?: number
fixed?: 'left' | 'right' | boolean
align?: 'left' | 'center' | 'right'
sortable?: boolean
showOverflowTooltip?: boolean
copyAction?: 'copy' | 'copyQr'
copyValue?: (row: any) => any
} | null
slot: {
type: 'tag' | 'text' | 'default' | 'operation'
tagType?: string | Record<string, string>
tagResolver?: string
translateField?: string
/** 时间/日期列格式化:datetime=YYYY-MM-DD HH:mm:ss,date=YYYY-MM-DD */
format?: 'datetime' | 'date'
} | null
detailLabel?: string
filterParamMap?: Record<string, string>
}
// ============================================================
// VALUE_MAPS — 值翻译映射(select options 和 tag 翻译共用)
// ============================================================
export const VALUE_MAPS: Record<string, Record<string, string>> = {
/** 盘点主表状态 */
status: {
created: '待提交',
submitted: '待审核',
rejected: '已驳回',
approved: '待盘点',
checking: '盘点中',
completed: '已完成',
cancelled: '已取消'
},
/** 主表明细进度 detail_status */
detail_status: {
none_checked: '未盘点',
partial_checked: '部分盘点',
all_checked: '已盘完'
},
/** 盘点范围 type */
type: {
all: '全盘',
store: '按货主',
goods: '按商品',
location: '按库位'
},
/** 盘点方式 mode */
mode: {
open: '明盘',
blind: '盲盘'
},
/** 明细行状态(stock.check.detail 的 rows[].status:checked=有作业记录 / unchecked=未盘) */
check_item_status: {
unchecked: '未盘',
checked: '已盘点'
}
}
/** 从 VALUE_MAPS 衍生 options(value 取映射的原始 key,保证回传后端的是英文枚举) */
export function getOptions(field: string): { label: string; value: string }[] {
const map = VALUE_MAPS[field]
if (!map) return []
return Object.entries(map).map(([value, label]) => ({ label, value }))
}
/** 翻译 value → label */
export function translate(field: string, value: any): string {
const map = VALUE_MAPS[field]
if (!map) return value === undefined || value === null || value === '' ? '—' : String(value)
return map[String(value)] ?? String(value ?? '—')
}
/**
* 把后端各种时间形态归一化为 Date,识别不了返回 null。
*
* 兼容(后端各模块并不统一,盘点实测是时间戳):
* - 数字/纯数字串:秒(10 位) / 毫秒(13 位) / 微秒(16 位) / 纳秒(19 位),含小数串(如 '1759075200.123')
* - 紧凑串:'20260929'(YYYYMMDD)/ '20260929120000'(YYYYMMDDHHmmss)
* - 日期时间串:'2026-09-29'、'2026-09-29 12:00:00'、ISO
* - Date 实例
*/
function toDate(value: any): Date | null {
if (value === undefined || value === null || value === '') return null
if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value
const text = String(value).trim()
// 紧凑日期串(PHP 常见):8 位 = YYYYMMDD,14 位 = YYYYMMDDHHmmss
if (/^\d{8}$/.test(text)) {
const d = new Date(`${text.slice(0, 4)}-${text.slice(4, 6)}-${text.slice(6, 8)}T00:00:00`)
return Number.isNaN(d.getTime()) ? null : d
}
if (/^\d{14}$/.test(text)) {
const d = new Date(
`${text.slice(0, 4)}-${text.slice(4, 6)}-${text.slice(6, 8)}T${text.slice(8, 10)}:${text.slice(10, 12)}:${text.slice(12, 14)}`
)
return Number.isNaN(d.getTime()) ? null : d
}
// 时间戳(整数或小数)
if (/^-?\d+(\.\d+)?$/.test(text)) {
let num = Number(text)
if (!Number.isFinite(num) || num <= 0) return null
// 数量级归一到毫秒:> 1e14 视为微秒/纳秒逐级缩小;< 1e10 视为秒
while (num > 1e14) num /= 1000
if (num < 1e10) num *= 1000
const d = new Date(num)
return Number.isNaN(d.getTime()) ? null : d
}
const d = new Date(text)
return Number.isNaN(d.getTime()) ? null : d
}
/** 格式化时间 → YYYY-MM-DD HH:mm:ss(时间戳/日期串,空值或无法识别返回 —) */
export function formatTime(value: any): string {
if (value === undefined || value === null || value === '') return '—'
const d = toDate(value)
if (!d) return String(value)
const pad = (n: number) => String(n).padStart(2, '0')
return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
}
/** 格式化日期 → YYYY-MM-DD(时间戳/日期串,空值返回 —) */
export function formatDate(value: any): string {
if (value === undefined || value === null || value === '') return '—'
const d = toDate(value)
if (!d) return String(value)
const pad = (n: number) => String(n).padStart(2, '0')
return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`
}
/** 业务成功判定:与 utils/request 的 SUCCESS_CODES(200/20000/1/0)对齐 */
export function isCheckApiSuccess(res: any): boolean {
if (!res || typeof res !== 'object') return false
return [200, 20000, 1, 0].includes(Number(res.code))
}
// ============================================================
// TAG_RESOLVERS — 状态文字颜色解析器
// ============================================================
// 颜色规则:未开始=info(灰) 待xx/进行中=warning(黄) 已完成=success(绿) 驳回/异常=danger(红)
export const TAG_RESOLVERS: Record<string, (val: any) => string> = {
/** 盘点主表状态 */
resolveCheckStatusTag(v) {
switch (String(v ?? '')) {
case 'created':
return 'info'
case 'submitted':
return 'warning'
case 'rejected':
return 'danger'
case 'approved':
return 'primary'
case 'checking':
return 'warning'
case 'completed':
return 'success'
case 'cancelled':
return 'info'
default:
return 'info'
}
},
/** 明细盘点进度 detail_status */
resolveCheckDetailStatusTag(v) {
switch (String(v ?? '')) {
case 'all_checked':
return 'success'
case 'partial_checked':
return 'warning'
case 'none_checked':
return 'info'
default:
return 'info'
}
},
/** 明细行状态 */
resolveCheckItemStatusTag(v) {
return String(v ?? '') === 'checked' ? 'success' : 'info'
}
}
// ============================================================
// 二、FIELD_DICT 实例 — 在此定义页面所需的所有字段
// ============================================================
export const FIELD_DICT: Record<string, FieldDefinition> = {
/** 关键字(对盘点单号 / 盘点名称模糊匹配,对应 where.keyword) */
keyword: {
key: 'keyword',
label: '盘点单号/名称',
scanBox: { type: 'text', group: SCANBOX_GROUPS.basic },
table: null,
slot: null
},
/** 货主筛选(value 为货主ID,对应 where.store_id) */
store_id: {
key: 'store_id',
label: '货主',
scanBox: { type: 'select', group: SCANBOX_GROUPS.basic, options: storeOptions },
table: { minWidth: 90, align: 'center' },
slot: null,
detailLabel: '货主ID'
},
check_no: {
key: 'check_no',
label: '盘点单号',
scanBox: null,
table: { minWidth: 170, fixed: 'left', copyAction: 'copy', showOverflowTooltip: true },
slot: null
},
title: {
key: 'title',
label: '盘点名称',
scanBox: null,
table: { minWidth: 150, showOverflowTooltip: true },
slot: null
},
type: {
key: 'type',
label: '盘点范围',
scanBox: null,
table: { minWidth: 100, align: 'center' },
slot: { type: 'tag', tagType: 'info', translateField: 'type' }
},
mode: {
key: 'mode',
label: '盘点方式',
scanBox: null,
table: { minWidth: 100, align: 'center' },
slot: { type: 'tag', tagType: 'info', translateField: 'mode' }
},
status: {
key: 'status',
label: '盘点状态',
// 状态作为 ScanBox 筛选(可选、默认全部);value 为英文枚举,直接作为 where.status 回传
scanBox: { type: 'select', group: SCANBOX_GROUPS.process, options: getOptions('status') },
table: { minWidth: 100, align: 'center' },
slot: { type: 'tag', tagResolver: 'resolveCheckStatusTag', translateField: 'status' }
},
detail_status: {
key: 'detail_status',
label: '盘点进度',
scanBox: null,
table: { minWidth: 100, align: 'center' },
slot: { type: 'tag', tagResolver: 'resolveCheckDetailStatusTag', translateField: 'detail_status' }
},
total_items: {
key: 'total_items',
label: '明细行数',
scanBox: null,
table: { minWidth: 90, align: 'center' },
slot: null
},
checked_items: {
key: 'checked_items',
label: '已盘行数',
scanBox: null,
table: { minWidth: 90, align: 'center' },
slot: null
},
diff_items: {
key: 'diff_items',
label: '差异行数',
scanBox: null,
table: { minWidth: 90, align: 'center' },
slot: null
},
check_date: {
key: 'check_date',
label: '盘点日期',
scanBox: null,
table: { minWidth: 110, align: 'center' },
// 后端返回时间戳,需按「日期」展示(YYYY-MM-DD)
slot: { type: 'text', format: 'date' }
},
creator_name: {
key: 'creator_name',
label: '创建人',
scanBox: null,
table: { minWidth: 100 },
slot: null
},
created_at: {
key: 'created_at',
label: '创建时间',
scanBox: null,
table: { minWidth: 165 },
slot: { type: 'text', format: 'datetime' }
},
start_time: {
key: 'start_time',
label: '开始时间',
scanBox: null,
table: null,
// 仅详情面板展示,后端返回时间戳
slot: { type: 'text', format: 'datetime' }
},
end_time: {
key: 'end_time',
label: '结束时间',
scanBox: null,
table: null,
// 仅详情面板展示,后端返回时间戳
slot: { type: 'text', format: 'datetime' }
},
remark: {
key: 'remark',
label: '备注',
scanBox: null,
table: null,
slot: null
},
/** 操作列(虚拟字段,仅用于表格列渲染) */
operation: {
key: 'operation',
label: '操作',
scanBox: null,
table: { minWidth: 240, fixed: 'right', align: 'center' },
slot: { type: 'operation' }
}
}
// ============================================================
// 三、ColumnSlotConfig — 列单元格渲染配置
// ============================================================
export interface ColumnSlotConfig {
type: 'tag' | 'text' | 'default' | 'operation'
tagType?: string | Record<string, string>
tagResolver?: string
translateField?: string
/** 时间/日期列格式化:datetime=YYYY-MM-DD HH:mm:ss,date=YYYY-MM-DD */
format?: 'datetime' | 'date'
}
// ============================================================
// 三-A、OperationButtonConfig — 操作列按钮配置
// ============================================================
export interface OperationButtonConfig {
key: string
label: string
type?: 'primary' | 'success' | 'warning' | 'danger' | 'info' | ''
actionType: 'form' | 'action'
formKey?: string
formTitle?: string
formWidth?: string
paramMap?: Record<string, string>
extraParams?: Record<string, any>
disabledOnField?: string
/** 按行数据决定是否渲染该按钮(返回 false 隐藏;用于按 status 显示可用动作) */
visibleWhen?: (row: Record<string, any>) => boolean
confirmMessage?: string
confirmTitle?: string
confirmType?: 'warning' | 'danger' | 'info'
confirmButtonText?: string
}
// ============================================================
// 四、DetailFieldConfig / DetailSectionConfig — 明细面板配置
// ============================================================
export interface DetailFieldConfig {
key: string
label?: string
span?: number
renderType?: 'text' | 'tag' | 'pre'
tagType?: string | Record<string, string>
tagResolver?: string
translateField?: string
/** 时间/日期格式化(与表格列同一套:datetime / date) */
format?: 'datetime' | 'date'
}
export interface DetailSectionConfig {
title: string
columnCount: number
fields: DetailFieldConfig[]
}
export interface DetailTabConfig {
name: string
label: string
componentKey: string
component?: Component
}
// ============================================================
// 五、TabPageApiConfig — 标签页接口插槽配置
// ============================================================
export type ApiMethod = (...args: any[]) => Promise<any>
export type ApiSource = 'api' | 'list'
export type ComponentApiConfig = { source: 'list' } | ApiMethod
export interface TabPageApiConfig {
/** 列表查询接口 */
list: ApiMethod
/** 明细面板接口(可选,不配则用 row 数据) */
detail?: ComponentApiConfig
/** 操作日志接口(可选) */
log?: ComponentApiConfig
/** 导出接口(可选) */
export?: ApiMethod
/** 导出进度查询接口(可选) */
exportProgress?: ApiMethod
/** ScanBox 下拉选项数据源接口(可选) */
scanBoxOptions?: Record<string, ApiMethod>
/** 工具栏按钮 → API 方法映射(可选) */
toolbar?: Record<string, ApiMethod>
/** 列表响应解析器 */
parseListResponse?: (res: any) => { list: any[]; total: number }
/** 构建列表请求参数 */
buildListParams?: (params: {
pagination: { page: number; pageSize: number }
conditions: Record<string, any>
sort?: { prop: string; order: string }
}) => Record<string, any>
}
// ============================================================
// 六、TabPageRawConfig — 标签页声明配置(仅用 key 引用)
// ============================================================
export interface TabPageRawConfig {
name: string
label: string
scanBoxCacheKey: string
/** ScanBox 需要的字段 key 列表(从 FIELD_DICT 中查找) */
scanBoxFieldKeys: string[]
/** 表格需要的列 key 列表(从 FIELD_DICT 中查找) */
tableColumnKeys: string[]
upperTableDefaults: {
title: string
enableColumnConfig?: boolean
showIndex?: boolean
showSelection?: boolean
emptyText?: string
}
/** 明细面板标签页配置 */
detailTabs?: { name: string; label: string; componentKey: string }[]
/** 明细面板分区配置(字段 key 列表,resolveTabConfig 展开) */
detailSections: {
title: string
columnCount: number
fieldKeys: string[]
}[]
/** 接口配置(有 api 时启用真实接口) */
api?: TabPageApiConfig
/** 操作列按钮配置(需 tableColumnKeys 包含 'operation') */
operationButtons?: OperationButtonConfig[]
}
// ============================================================
// 七、TabPageConfig — 展开后的完整配置(给 index.vue 使用)
// ============================================================
export interface TabPageConfig {
name: string
label: string
scanBoxCacheKey: string
scanBoxFields: Record<string, any>[]
upperTable: {
title: string
enableColumnConfig: boolean
showIndex: boolean
showSelection: boolean
emptyText: string
columns: Record<string, any>[]
}
columnSlots: Record<string, ColumnSlotConfig>
detailConfig: DetailSectionConfig[]
detailTabs: DetailTabConfig[]
api?: TabPageApiConfig
operationButtons?: OperationButtonConfig[]
}
// ============================================================
// 八、resolveTabConfig — 加载时将 RawConfig 展开为完整配置
// ============================================================
export function resolveTabConfig(raw: TabPageRawConfig): TabPageConfig {
// 展开 ScanBox 字段
const scanBoxFields: Record<string, any>[] = []
for (const key of raw.scanBoxFieldKeys) {
const def = FIELD_DICT[key]
if (!def || !def.scanBox) continue
scanBoxFields.push({
label: def.label,
value: def.key,
type: def.scanBox.type,
// options 允许传 ref(异步加载的货主下拉),解包后仍受 currentTabConfig 依赖追踪
options: def.scanBox.options
? (isRef(def.scanBox.options) ? def.scanBox.options.value : [...def.scanBox.options])
: undefined,
group: def.scanBox.group,
required: (def.scanBox as any).required
})
}
// 展开表格列
const columns: Record<string, any>[] = []
for (const key of raw.tableColumnKeys) {
const def = FIELD_DICT[key]
if (!def || !def.table) continue
columns.push({
prop: def.key,
label: def.label,
...def.table
})
}
// 展开列插槽
const columnSlots: Record<string, ColumnSlotConfig> = {}
for (const key of raw.tableColumnKeys) {
const def = FIELD_DICT[key]
if (!def || !def.slot) continue
columnSlots[def.key] = { ...def.slot }
}
// 展开明细面板配置
const detailConfig: DetailSectionConfig[] = raw.detailSections.map((sec) => ({
title: sec.title,
columnCount: sec.columnCount,
fields: sec.fieldKeys
.map((key): DetailFieldConfig | null => {
const def = FIELD_DICT[key]
if (!def) return null
return {
key: def.key,
label: def.detailLabel ?? def.label,
translateField: def.slot?.translateField,
tagResolver: def.slot?.tagResolver,
tagType: def.slot?.tagType,
format: def.slot?.format,
renderType: def.slot?.type === 'tag' ? 'tag' : 'text'
}
})
.filter((f): f is DetailFieldConfig => f !== null)
}))
// 展开明细标签页(解析 componentKey → Component)
const detailTabs: DetailTabConfig[] = raw.detailTabs
? raw.detailTabs.map((tab) => ({
name: tab.name,
label: tab.label,
componentKey: tab.componentKey,
component: COMPONENT_REGISTRY[tab.componentKey]
}))
: [{ name: 'detail', label: '明细', componentKey: 'DetailPanel', component: COMPONENT_REGISTRY['DetailPanel'] }]
return {
name: raw.name,
label: raw.label,
scanBoxCacheKey: raw.scanBoxCacheKey,
scanBoxFields,
upperTable: {
title: raw.upperTableDefaults.title,
enableColumnConfig: raw.upperTableDefaults.enableColumnConfig ?? true,
showIndex: raw.upperTableDefaults.showIndex ?? true,
showSelection: raw.upperTableDefaults.showSelection ?? true,
emptyText: raw.upperTableDefaults.emptyText ?? '暂无数据',
columns
},
columnSlots,
detailConfig,
detailTabs,
api: raw.api,
operationButtons: raw.operationButtons
}
}
// ============================================================
// 九、buildWhereConditions — 将 ScanBox 条件转为 API where 参数
// ============================================================
export function buildWhereConditions(rawConditions: Record<string, any>): Record<string, any> {
const where: Record<string, any> = {}
for (const [key, cond] of Object.entries(rawConditions || {})) {
let value: any = undefined
if (cond && typeof cond === 'object' && 'operator' in cond) {
value = (cond as any).value
} else if (cond !== undefined && cond !== null && cond !== '') {
value = Array.isArray(cond) ? cond[0] ?? '' : cond
}
if (value === undefined || value === null || value === '' || (Array.isArray(value) && value.length === 0)) {
continue
}
const def = FIELD_DICT[key]
if (def?.filterParamMap) {
const mapped = def.filterParamMap[String(value)]
if (mapped !== undefined) {
where[key] = mapped
continue
}
}
where[key] = value
}
return where
}
// ============================================================
// 十、工具栏按钮系统
// ============================================================
// 按钮分为三类:
// common — 公共按钮(刷新、导出)
// function — 功能按钮(打开表单/确认窗口)
// basic — 基础操作(字段设置、隐藏详情)
export interface ToolbarButtonConfig {
key: string
label: string
category: 'common' | 'function' | 'basic'
size?: '' | 'default' | 'small' | 'large'
type?: '' | 'primary' | 'success' | 'warning' | 'info' | 'danger'
plain?: boolean
loadingKey?: string
disabledKey?: string
action: string
dynamicLabelKey?: string
onlyForTabs?: string[]
buttonType?: 'default' | 'dropdown'
dropdownOptions?: Array<{ label: string; action: string; divided?: boolean }>
formKey?: string
}
export const TOOLBAR_BUTTONS: Record<string, ToolbarButtonConfig> = {
// ===== 公共按钮 =====
refresh: {
key: 'refresh',
label: '刷新',
category: 'common',
type: 'primary',
size: 'small',
loadingKey: 'loading',
action: 'loadData'
},
// ===== 功能按钮 =====
create: {
key: 'create',
label: '新建盘点',
category: 'function',
type: 'primary',
plain: false,
size: 'small',
action: 'openCreateCheck'
},
export: {
key: 'export',
label: '导出',
category: 'function',
type: 'primary',
plain: true,
size: 'small',
loadingKey: 'exportLoading',
action: 'handleExport'
},
// ===== 基础操作 =====
columnConfig: {
key: 'columnConfig',
label: '字段设置',
category: 'basic',
size: 'small',
action: 'openColumnConfigPanel'
},
toggleDetail: {
key: 'toggleDetail',
label: '显示详情',
category: 'basic',
dynamicLabelKey: 'detailToggleLabel',
size: 'small',
action: 'toggleDetailVisible'
}
}
/** 按标签页名称获取工具栏按钮列表(自动根据 PAGE_CONFIG 过滤) */
export function getTabToolbarButtons(tabName: string): ToolbarButtonConfig[] {
return Object.values(TOOLBAR_BUTTONS).filter((btn) => {
if (btn.onlyForTabs && !btn.onlyForTabs.includes(tabName)) return false
// 详情面板禁用时,隐藏「显示/隐藏详情」按钮
if (!PAGE_CONFIG.enableDetailPanel && btn.key === 'toggleDetail') return false
return true
})
}
// ============================================================
// 十一、批量操作配置(可选,接入 BatchOperationForm 时使用)
// ============================================================
export interface BatchOperationConfig {
action: string
title: string
confirmText: string
confirmType?: 'warning' | 'error' | 'info' | 'success'
confirmButtonText: string
successText: string
failText: string
apiMethod: (...args: any[]) => Promise<any>
payloadKey?: string
idField?: string | string[]
payloadBuilder?: (rows: Record<string, any>[]) => Record<string, any>
useProgress?: boolean
progressApiMethod?: (...args: any[]) => Promise<any>
}
/** ★ 在此配置批量操作 */
export const BATCH_OPERATION_CONFIGS: Record<string, BatchOperationConfig> = {}
// ============================================================
// 十二、标签页注册表 — 库存盘点(按状态分组)
// ============================================================
/** 表格列(各状态页签一致) */
const TABLE_COLUMN_KEYS = [
'check_no',
'title',
'type',
'mode',
'status',
'detail_status',
'total_items',
'checked_items',
'diff_items',
'check_date',
'creator_name',
'created_at',
'operation'
]
/** 明细面板分区(「盘点单信息」tab) */
const DETAIL_SECTIONS = [
{
title: '基本信息',
columnCount: 3,
fieldKeys: ['check_no', 'title', 'type', 'mode', 'status', 'detail_status', 'store_id']
},
{
title: '进度信息',
columnCount: 3,
fieldKeys: ['total_items', 'checked_items', 'diff_items', 'creator_name', 'check_date']
},
{
title: '时间信息',
columnCount: 2,
fieldKeys: ['start_time', 'end_time', 'created_at']
},
{
title: '备注',
columnCount: 1,
fieldKeys: ['remark']
}
]
const DETAIL_TABS = [
{ name: 'detail', label: '盘点单信息', componentKey: 'DetailPanel' },
{ name: 'items', label: '盘点明细', componentKey: 'CheckItemsPanel' },
{ name: 'records', label: '作业记录', componentKey: 'CheckRecordsPanel' }
]
/** created/rejected:可加明细、可提交、可取消 */
const EDITABLE_STATUSES: StockCheckStatus[] = ['created', 'rejected']
/** approved/checking:可上报实盘、可完成 */
const RUNNING_STATUSES: StockCheckStatus[] = ['approved', 'checking']
/** 操作列按钮:按行状态显隐(可见即代表后端允许该动作) */
const OPERATION_BUTTONS: OperationButtonConfig[] = [
{
key: 'addItems',
label: '添加商品',
actionType: 'action',
type: 'primary',
visibleWhen: (row) => EDITABLE_STATUSES.includes(row?.status)
},
{
key: 'submitCheck',
label: '提交审核',
actionType: 'action',
type: 'primary',
confirmMessage: '提交后进入审核流程,期间不可再增删盘点商品。确定提交?',
confirmTitle: '提交审核',
confirmType: 'warning',
confirmButtonText: '确定提交',
visibleWhen: (row) => EDITABLE_STATUSES.includes(row?.status)
},
{
key: 'auditPass',
label: '审核通过',
actionType: 'action',
type: 'primary',
confirmMessage: '审核通过后即可开始盘点作业。确定通过?',
confirmTitle: '审核通过',
confirmType: 'info',
confirmButtonText: '确定通过',
visibleWhen: (row) => row?.status === 'submitted'
},
{
key: 'auditReject',
label: '驳回',
actionType: 'action',
type: 'danger',
visibleWhen: (row) => row?.status === 'submitted'
},
{
key: 'finishCheck',
label: '完成盘点',
actionType: 'action',
type: 'success',
confirmMessage: '完成盘点后不再允许修改实盘数量。确定完成?(存在未盘明细时后端会拒绝)',
confirmTitle: '完成盘点',
confirmType: 'warning',
confirmButtonText: '确定完成',
visibleWhen: (row) => RUNNING_STATUSES.includes(row?.status)
},
{
key: 'cancelCheck',
label: '取消',
actionType: 'action',
type: 'danger',
confirmMessage: '取消后不可恢复,确定取消该盘点单?',
confirmTitle: '取消盘点单',
confirmType: 'warning',
confirmButtonText: '确定取消',
visibleWhen: (row) => ['created', 'submitted', 'rejected'].includes(String(row?.status))
},
{
key: 'exportCheck',
label: '导出',
actionType: 'action',
type: 'primary',
visibleWhen: () => true
}
]
/** 生成页签配置(单页签:statuses 传空数组,状态筛选交给 ScanBox) */
function buildCheckTab(
name: string,
label: string,
statuses: StockCheckStatus[]
): TabPageRawConfig {
return {
name,
label,
scanBoxCacheKey: `stock-check-${name}`,
// 筛选:盘点单号/名称(where.keyword)、盘点状态(where.status)、货主(where.store_id)
scanBoxFieldKeys: ['keyword', 'status', 'store_id'],
tableColumnKeys: TABLE_COLUMN_KEYS,
upperTableDefaults: {
title: '盘点单列表',
showSelection: true,
emptyText: '暂无盘点单'
},
detailTabs: DETAIL_TABS,
detailSections: DETAIL_SECTIONS,
api: {
list: stockCheckList,
// 列表行已含全部主表字段,「盘点单信息」直接用行数据(明细行由「盘点明细」面板单独拉取)
detail: { source: 'list' },
export: stockCheckExport,
exportProgress: stockCheckExportTaskProgress,
parseListResponse(res: any) {
const data = res?.data ?? res ?? {}
const list = Array.isArray(data.rows)
? data.rows
: Array.isArray(data.list)
? data.list
: []
const total = Number(data.total ?? data.pagination?.total ?? list.length)
return { list, total: Number.isFinite(total) ? total : list.length }
},
buildListParams({ pagination, conditions }) {
return {
pagination: { page: pagination.page, pageSize: pagination.pageSize },
where: {
...buildWhereConditions(conditions),
// statuses 非空时固定状态(列表接口 status 支持数组);单页签传空数组 → 由 ScanBox 控制
...(statuses.length ? { status: [...statuses] } : {})
}
}
}
},
operationButtons: OPERATION_BUTTONS
}
}
/**
* 单页签列表:全部盘点单共用一个列表,状态筛选交给 ScanBox 的「盘点状态」。
* 如需恢复成按状态分页签,直接多调几次 buildCheckTab 即可,例如:
* buildCheckTab('todo', '待提交', ['created', 'rejected'])
*/
export const tabPages: TabPageRawConfig[] = [
buildCheckTab('all', '盘点单', [])
]
// ============================================================
// 十三、向后兼容导出
// ============================================================
export const templateTabs = tabPages.map((t) => ({ name: t.name, label: t.label, scanBoxCacheKey: t.scanBoxCacheKey }))