diff --git a/.env.development b/.env.development index f2395ca..725f5fa 100644 --- a/.env.development +++ b/.env.development @@ -9,7 +9,7 @@ VITE_APP_BASE_API = 'http://192.168.11.56:6060/' # 请求头 platform:后端 /system 网关会校验,非白名单值直接返回 HTTP 400(响应体为空) # 实测白名单:web / app / wx / miniProgram(**大小写不敏感**,mp-weixin / h5 / mp / mobile 等被拒) -VITE_APP_PLATFORM = 'miniProgram' +VITE_APP_PLATFORM = 'miniprogram' # 请求头 project:后端同样校验(实测白名单:all / wms) VITE_APP_PROJECT = 'all' diff --git a/src/api/stock/external-stock.ts b/src/api/stock/external-stock.ts index 59617db..4f79649 100644 --- a/src/api/stock/external-stock.ts +++ b/src/api/stock/external-stock.ts @@ -7,12 +7,15 @@ * body = { * warehouse_id?: number, // 顶层(new3 已验证可用) * pagination: { page, pageSize }, - * where: { keyword?, store_id? }, // 通用过滤条件 + * where: { keyword?, is_sn_mgmt?, is_batch_mgmt?, store_id? }, // 通用过滤(**裸值**) * sort?: { sortField, sortOrder } // 小程序端不用(见下) * } * 返回 data = { list: [...], pagination: { total }, summary?: {...} } * ``` * + * `is_sn_mgmt` / `is_batch_mgmt` 取值 `'Y'` / `'N'`(字段与 new3 的筛选配置一致, + * 对应表 `wms_stock_warehouse` 上的 char 字段)。 + * * 小程序端只取 3 个字段展示(商品图片 / 商品名称 / 可用库存),并且**去掉**了排序、 * 每页条数选择、页码跳转等不适合移动端的交互 —— 分页改为「上拉加载」, * 见 `pagesA/external-stock/list.vue`。 @@ -63,22 +66,46 @@ export interface ExternalStockQuery { pageSize?: number /** 关键词(商品名称 / 编码),空字符串表示不过滤 */ keyword?: string - /** 货主 id,空字符串表示全部 */ - store_id?: number | string /** 仓库 id,空字符串表示全部 */ warehouse_id?: number | string + /** SN 管理:`'Y'` / `'N'`,空字符串表示全部 */ + is_sn_mgmt?: string + /** 批次管理:`'Y'` / `'N'`,空字符串表示全部 */ + is_batch_mgmt?: string + /** + * 货主 id + * + * ⚠️ 小程序端**目前不提供该筛选**(2026-09-28 按要求移除,new3 也没有这个筛选), + * 能力保留在这里:以后要恢复货主筛选,页面传值即可(是否生效仍需后端确认)。 + */ + store_id?: number | string } function isFilled(value: unknown): boolean { return value !== undefined && value !== null && value !== '' } -/** 组装请求体(⚠️ 货主过滤位置要调整时改这里) */ +/** + * 组装请求体 + * + * ⚠️ 本接口的 `where` 是**裸值**(`where.keyword = 'x'`、`where.is_sn_mgmt = 'Y'`), + * 不是 `storage.receiving.*` 那种 `{ operator, value }` —— 两者别混。 + */ function buildBody(query: ExternalStockQuery): Record { - const { page = 1, pageSize = EXTERNAL_STOCK_PAGE_SIZE, keyword, store_id, warehouse_id } = query + const { + page = 1, + pageSize = EXTERNAL_STOCK_PAGE_SIZE, + keyword, + warehouse_id, + is_sn_mgmt, + is_batch_mgmt, + store_id + } = query const where: Record = {} if (keyword && String(keyword).trim()) where.keyword = String(keyword).trim() + if (isFilled(is_sn_mgmt)) where.is_sn_mgmt = is_sn_mgmt + if (isFilled(is_batch_mgmt)) where.is_batch_mgmt = is_batch_mgmt if (isFilled(store_id)) where.store_id = store_id return { diff --git a/src/api/storage/receiving.ts b/src/api/storage/receiving.ts index 503ebee..6ea122f 100644 --- a/src/api/storage/receiving.ts +++ b/src/api/storage/receiving.ts @@ -14,9 +14,13 @@ * 和「外仓商品」那个 `where.keyword = 'xxx'` 的写法不一样,别混。 * 顶层参数只有 `stock_query_where`(商品条码/编码搜索),小程序端暂不用。 * - * 小程序端只展示 4 个信息(单号 / 收货状态 / 种类+数量 / 创建时间), - * 并且**去掉**排序、页码、每页条数等不适合移动端的交互 —— 分页改为「上拉加载」, - * 见 `pagesA/external-inventory/receiving.vue`。 + * 小程序端展示的字段(单号 / 收货状态 / 入库状态 / 匹配状态 / 种类+数量 / 车牌号 / + * 创建时间 / 备注),并且**去掉**排序、每页条数选择器这类不适合移动端的交互 + *(翻页用固定底部的 `components/page-pager`),见 `pagesA/external-inventory/receiving.vue`。 + * + * 筛选维度(与 new3 `views/storage/receiving_owner/index.vue` 去掉 scan-box 后保留的一致): + * 收货单号(like)/ 收货状态 / 入库状态 / 匹配状态 / 审核状态 / 仓库; + * **不含货主(store_id)** —— new3 货主侧页面也已 `.filter(f => f.value !== 'store_id')` 移除。 */ import request from '@/utils/request' @@ -51,6 +55,15 @@ export interface ReceivingItem { total_quantity?: number /** 总箱数 */ total_boxes?: number + /** 备注 */ + remark?: string + /** + * 审核状态:1 = 已审核 / 0 = 未审核 + * + * ⚠️ new3 货主侧的列定义(`receivingStoreColumns`)里**没有**这一列, + * 所以列表项可能不下发;本页只把它当**筛选条件**用,不展示。 + */ + is_review?: number | string /** 创建时间(后端已格式化) */ create_at_display?: string /** 车牌号 */ @@ -74,10 +87,21 @@ export interface ReceivingQuery { pageSize?: number /** 收货单号(模糊搜索),空字符串表示不过滤 */ keyword?: string - /** 货主 id,空字符串表示全部 */ + /** + * 货主 id,空字符串表示全部 + * + * 小程序端**目前不提供该筛选**(2026-09-28 按要求移除,与 new3 货主侧页面一致), + * 能力保留在这里,需要时可从页面再接回去 + */ store_id?: number | string - /** 收货状态,空字符串表示全部 */ + /** 收货状态 receiving / completed / cancelled,空字符串表示全部 */ status?: string + /** 匹配状态 all_matched / partial_matched / unmatched,空字符串表示全部 */ + detail_status?: string + /** 入库状态 waiting / none / partial / all,空字符串表示全部 */ + storage_status?: string + /** 审核状态:'1' = 已审核 / '0' = 未审核(请求前会转成数字),空字符串表示全部 */ + is_review?: number | string /** 仓库 id,空字符串表示全部 */ warehouse_id?: number | string } @@ -110,12 +134,95 @@ export function readStatusColor(status?: string): string { /** 状态选项(筛选用,含「全部」) */ export const RECEIVING_STATUS_OPTIONS: Array<{ value: string; label: string }> = [ - { value: '', label: '全部状态' }, + { value: '', label: '全部' }, { value: 'receiving', label: '收货中' }, { value: 'completed', label: '已完成' }, { value: 'cancelled', label: '已作废' } ] +/** 匹配状态(`detail_status`)→ 文案 */ +export const RECEIVING_DETAIL_STATUS_TEXT: Record = { + all_matched: '全部匹配', + partial_matched: '部分匹配', + unmatched: '未匹配' +} + +/** 匹配状态 → 主题色 */ +export const RECEIVING_DETAIL_STATUS_COLOR: Record = { + all_matched: '#19be6b', + partial_matched: '#ff9900', + unmatched: '#909399' +} + +/** 入库状态(`storage_status`)→ 文案 */ +export const RECEIVING_STORAGE_STATUS_TEXT: Record = { + all: '全部入库', + partial: '部分入库', + waiting: '待入库', + none: '未入库' +} + +/** 入库状态 → 主题色 */ +export const RECEIVING_STORAGE_STATUS_COLOR: Record = { + all: '#19be6b', + partial: '#ff9900', + waiting: '#2979ff', + none: '#909399' +} + +/** 匹配状态选项(筛选用,含「全部」) */ +export const RECEIVING_DETAIL_OPTIONS: Array<{ value: string; label: string }> = [ + { value: '', label: '全部' }, + { value: 'all_matched', label: '全部匹配' }, + { value: 'partial_matched', label: '部分匹配' }, + { value: 'unmatched', label: '未匹配' } +] + +/** + * 入库状态选项(筛选用,含「全部」) + * + * 选项文案照抄 new3 的筛选项(`all` 在筛选里写的是「已入库」、 + * 而列表展示用的是 `storageStatusConfig` 的「全部入库」)—— 两边不一致是 Web 端原样 + */ +export const RECEIVING_STORAGE_OPTIONS: Array<{ value: string; label: string }> = [ + { value: '', label: '全部' }, + { value: 'waiting', label: '待入库' }, + { value: 'none', label: '未入库' }, + { value: 'partial', label: '部分入库' }, + { value: 'all', label: '已入库' } +] + +/** 审核状态选项(筛选用,含「全部」);值是数字字符串,请求前转数字 */ +export const RECEIVING_REVIEW_OPTIONS: Array<{ value: string; label: string }> = [ + { value: '', label: '全部' }, + { value: '1', label: '已审核' }, + { value: '0', label: '未审核' } +] + +/** 匹配状态文案:未知值原样显示(后端加了新状态也不会显示成空白) */ +export function readDetailStatusText(status?: string): string { + if (!status) return '—' + return RECEIVING_DETAIL_STATUS_TEXT[status] || status +} + +/** 匹配状态颜色 */ +export function readDetailStatusColor(status?: string): string { + if (!status) return '#909399' + return RECEIVING_DETAIL_STATUS_COLOR[status] || '#909399' +} + +/** 入库状态文案 */ +export function readStorageStatusText(status?: string): string { + if (!status) return '—' + return RECEIVING_STORAGE_STATUS_TEXT[status] || status +} + +/** 入库状态颜色 */ +export function readStorageStatusColor(status?: string): string { + if (!status) return '#909399' + return RECEIVING_STORAGE_STATUS_COLOR[status] || '#909399' +} + function isFilled(value: unknown): boolean { return value !== undefined && value !== null && value !== '' } @@ -124,9 +231,25 @@ function isFilled(value: unknown): boolean { const eq = (value: unknown) => ({ operator: 'eq', value }) const like = (value: unknown) => ({ operator: 'like', value }) +/** 纯数字字符串转数字(`is_review` 这类字段后端是数值,传字符串可能匹配不上) */ +const toNumeric = (value: unknown): unknown => { + const text = String(value).trim() + return /^-?\d+(\.\d+)?$/.test(text) ? Number(text) : value +} + /** 组装请求体(条件字段/操作符要调整时改这里) */ function buildBody(query: ReceivingQuery): Record { - const { page = 1, pageSize = RECEIVING_PAGE_SIZE, keyword, store_id, status, warehouse_id } = query + const { + page = 1, + pageSize = RECEIVING_PAGE_SIZE, + keyword, + store_id, + status, + detail_status, + storage_status, + is_review, + warehouse_id + } = query const where: Record = {} // 收货单号模糊搜索:new3 的字段配置里 `receiving_number` 支持 like/contains/starts_with, @@ -134,6 +257,9 @@ function buildBody(query: ReceivingQuery): Record { if (keyword && String(keyword).trim()) where.receiving_number = like(String(keyword).trim()) if (isFilled(store_id)) where.store_id = eq(store_id) if (isFilled(status)) where.status = eq(status) + if (isFilled(detail_status)) where.detail_status = eq(detail_status) + if (isFilled(storage_status)) where.storage_status = eq(storage_status) + if (isFilled(is_review)) where.is_review = eq(toNumeric(is_review)) if (isFilled(warehouse_id)) where.warehouse_id = eq(warehouse_id) return { diff --git a/src/components/page-pager/page-pager.vue b/src/components/page-pager/page-pager.vue new file mode 100644 index 0000000..9ed9d25 --- /dev/null +++ b/src/components/page-pager/page-pager.vue @@ -0,0 +1,154 @@ + + + + + diff --git a/src/pagesA/external-inventory/receiving.vue b/src/pagesA/external-inventory/receiving.vue index b127ad2..0efa1a1 100644 --- a/src/pagesA/external-inventory/receiving.vue +++ b/src/pagesA/external-inventory/receiving.vue @@ -3,7 +3,7 @@ - - - - 共 {{ total }} 条·{{ loading ? '加载中…' : `第 ${pageNo}/${pageCount} 页` }} - - - - {{ btn.label }} - - - + + - + ([]) @@ -199,28 +235,28 @@ const isFilled = (value: unknown): boolean => value !== undefined && value !== null && value !== '' const hasFilter = computed( - () => !!form.keyword.trim() || isFilled(form.store_id) || !!form.status + () => + !!form.keyword.trim() || + !!form.status || + !!form.storage_status || + !!form.is_review || + isFilled(form.warehouse_id) ) const statusTextOf = (item: ReceivingItem): string => readStatusText(item?.status) const statusColorOf = (item: ReceivingItem): string => readStatusColor(item?.status) +const storageStatusTextOf = (item: ReceivingItem): string => + readStorageStatusText(item?.storage_status) +const storageStatusColorOf = (item: ReceivingItem): string => + readStorageStatusColor(item?.storage_status) +const detailStatusTextOf = (item: ReceivingItem): string => + readDetailStatusText(item?.detail_status) +const detailStatusColorOf = (item: ReceivingItem): string => + readDetailStatusColor(item?.detail_status) const quantityTextOf = (item: ReceivingItem): string => readQuantityText(item) /** 总页数(按固定每页条数算;总数 0 时也算 1 页,避免出现「第 1/0 页」) */ const pageCount = computed(() => Math.max(1, Math.ceil(total.value / RECEIVING_PAGE_SIZE))) -const canPrev = computed(() => pageNo.value > 1) -const canNext = computed(() => pageNo.value < pageCount.value) - -/** 分页器按钮:首页 / 上一页 / 下一页 / 尾页(不满足条件或加载中则置灰) */ -const pagerButtons = computed(() => { - const busy = loading.value - return [ - { label: '首页', target: 1, disabled: busy || !canPrev.value }, - { label: '上一页', target: pageNo.value - 1, disabled: busy || !canPrev.value }, - { label: '下一页', target: pageNo.value + 1, disabled: busy || !canNext.value }, - { label: '尾页', target: pageCount.value, disabled: busy || !canNext.value } - ] -}) /** 翻页后回到顶部(否则新一页会从上一页的滚动位置继续,看着像没动) */ const scrollToTop = (): void => { @@ -245,8 +281,10 @@ const loadPage = async (target = pageNo.value): Promise => { page, pageSize: RECEIVING_PAGE_SIZE, keyword: form.keyword, - store_id: form.store_id, - status: form.status + status: form.status, + storage_status: form.storage_status, + is_review: form.is_review, + warehouse_id: form.warehouse_id }) const payload = res?.data @@ -281,10 +319,10 @@ const onSearch = (): void => { const onReset = (): void => { form.keyword = '' - form.store_id = '' form.status = '' - storeLabel.value = '全部货主' - statusLabel.value = '全部状态' + form.storage_status = '' + form.is_review = '' + form.warehouse_id = '' reloadFirstPage() } @@ -294,37 +332,85 @@ const refresh = async (): Promise => { if (!list.value.length && pageNo.value > 1) await loadPage(1) } -// ── 货主 / 收货状态选择器(底部弹层,一个组件复用于两个维度)── -type PickerKind = 'store' | 'status' +// ── 收货状态 / 入库状态 / 审核状态 / 仓库 选择器(同一个底部弹层组件复用)── +type PickerKind = 'status' | 'storage' | 'review' | 'warehouse' const pickerVisible = ref(false) -const pickerKind = ref('store') +const pickerKind = ref('status') const pickerLoading = ref(false) -const storeOptions = ref([]) +const warehouseOptions = ref([]) -/** 胶囊上显示的名称(选中后显示具体名称,未选显示「全部…」) */ -const storeLabel = ref('全部货主') -const statusLabel = ref('全部状态') +const PICKER_TITLES: Record = { + status: '选择收货状态', + storage: '选择入库状态', + review: '选择审核状态', + warehouse: '选择仓库' +} -const pickerTitle = computed(() => (pickerKind.value === 'store' ? '选择货主' : '选择收货状态')) -const pickerValue = computed(() => - pickerKind.value === 'store' ? form.store_id : form.status -) -/** 弹层选项:页面负责拼「全部…」,「选项多时的名称搜索」在 option-picker 内部处理 */ -const pickerOptions = computed(() => - pickerKind.value === 'store' - ? [{ value: '', label: '全部货主' }, ...storeOptions.value] - : RECEIVING_STATUS_OPTIONS -) +/** + * 胶囊上显示的名称 + * + * 未选中时显示**筛选项名**(收货状态 / 入库状态 / 审核状态 / 仓库), + * 选中后显示具体值(收货中 / 待入库 / 已审核 / 仓库名) + */ +const PICKER_NAMES: Record = { + status: '收货状态', + storage: '入库状态', + review: '审核状态', + warehouse: '仓库' +} + +/** 维度 → 表单字段名(只在这里维护一次映射) */ +const FIELD_OF: Record = { + status: 'status', + storage: 'storage_status', + review: 'is_review', + warehouse: 'warehouse_id' +} + +/** 本地常量选项(仓库选项来自接口,不在这里) */ +const LOCAL_OPTIONS: Record, SelectOption[]> = { + status: RECEIVING_STATUS_OPTIONS, + storage: RECEIVING_STORAGE_OPTIONS, + review: RECEIVING_REVIEW_OPTIONS +} + +/** 某个维度当前选中的值 */ +const valueOf = (kind: PickerKind): string | number => form[FIELD_OF[kind]] + +const pickerTitle = computed(() => PICKER_TITLES[pickerKind.value]) +const pickerValue = computed(() => valueOf(pickerKind.value)) +/** 弹层选项:仓库来自接口(含「全部仓库」),三个状态是本地常量;「名称搜索」在 option-picker 内部 */ +const pickerOptions = computed(() => { + if (pickerKind.value === 'warehouse') { + return [{ value: '', label: '全部仓库' }, ...warehouseOptions.value] + } + return LOCAL_OPTIONS[pickerKind.value as Exclude] +}) + +/** + * 胶囊文案:未选中 = 筛选项名,选中 = 选项文案(找不到就原样显示值) + * + * 文案由「当前值 + 选项表」算出来,不再额外维护一份 label 状态, + * 重置时也就不会漏掉某个胶囊 + */ +const labelOf = (kind: PickerKind): string => { + const value = valueOf(kind) + if (!isFilled(value)) return PICKER_NAMES[kind] + + const options = kind === 'warehouse' ? warehouseOptions.value : LOCAL_OPTIONS[kind] + return options.find((option) => String(option.value) === String(value))?.label || String(value) +} + +/** 仓库选项只有用到时才拉(拉过就缓存,不重复请求) */ +const ensureWarehouseOptions = async (): Promise => { + if (warehouseOptions.value.length) return -/** 货主选项只有用到时才拉(拉过就缓存,不重复请求);状态是本地常量 */ -const ensureStoreOptions = async (): Promise => { - if (storeOptions.value.length) return pickerLoading.value = true try { - storeOptions.value = await fetchStoreOptions() + warehouseOptions.value = await fetchWarehouseOptions() } catch { - // 失败提示由 request 层统一 toast;这里保持空列表(弹层里只剩「全部」+ 提示) + // 失败提示由 request 层统一 toast;这里保持空列表(弹层里只剩「全部仓库」) } finally { pickerLoading.value = false } @@ -333,7 +419,7 @@ const ensureStoreOptions = async (): Promise => { const openPicker = (kind: PickerKind): void => { pickerKind.value = kind pickerVisible.value = true - if (kind === 'store') ensureStoreOptions() + if (kind === 'warehouse') ensureWarehouseOptions() } const closePicker = (): void => { @@ -341,13 +427,8 @@ const closePicker = (): void => { } const chooseOption = (option: SelectOption): void => { - if (pickerKind.value === 'store') { - form.store_id = option.value - storeLabel.value = option.label - } else { - form.status = String(option.value) - statusLabel.value = option.label - } + // 表单各字段类型不同(string / string | number),用索引赋值避免联合类型收窄报错 + ;(form as Record)[FIELD_OF[pickerKind.value]] = option.value closePicker() reloadFirstPage() } @@ -395,7 +476,9 @@ onPullDownRefresh(() => { align-items: center; &--chips { - margin-top: 12rpx; + margin-top: 8rpx; + /* 筛选项变多了(收货状态 / 入库状态 / 审核状态 / 仓库 / 重置):允许换行,否则会被挤出屏幕 */ + flex-wrap: wrap; } } @@ -420,7 +503,8 @@ onPullDownRefresh(() => { display: flex; align-items: center; max-width: 320rpx; - margin-right: 16rpx; + /* 筛选项有四个 + 重置:允许换行,所以上下各留 4rpx 避免换行后贴在一起 */ + margin: 4rpx 16rpx 4rpx 0; padding: 10rpx 20rpx; background-color: #f5f6fa; border-radius: 999rpx; @@ -433,7 +517,7 @@ onPullDownRefresh(() => { margin-right: 6rpx; font-size: 24rpx; color: #606266; - /* 货主名可能很长:截断而不是把筛选行撑破 */ + /* 仓库名可能很长:截断而不是把筛选行撑破 */ max-width: 240rpx; overflow: hidden; white-space: nowrap; @@ -448,12 +532,6 @@ onPullDownRefresh(() => { padding: 96rpx 0; } -.count { - padding: 20rpx 32rpx 0; - font-size: 24rpx; - color: #909399; -} - /* 收货单卡片 */ .order { margin: 20rpx 24rpx 0; @@ -511,62 +589,5 @@ onPullDownRefresh(() => { } } -/* 分页器:固定底部,**一行**放下(每页 50 条固定,不可改) */ -.pager { - position: fixed; - left: 0; - right: 0; - bottom: 0; - z-index: 20; - display: flex; - align-items: center; - justify-content: space-between; - padding: 12rpx 20rpx; - /* iPhone 底部安全区:不支持 env() 时保留上一行的 12rpx */ - padding-bottom: calc(12rpx + env(safe-area-inset-bottom)); - background-color: #ffffff; - border-top: 1rpx solid #ebeef5; - - /* 总数 / 页码:可收缩,极端情况下省略号,保证四个按钮永远完整可见 */ - &__info { - flex: 1; - min-width: 0; - margin-right: 12rpx; - font-size: 22rpx; - color: #909399; - overflow: hidden; - white-space: nowrap; - text-overflow: ellipsis; - } - - &__sep { - margin: 0 6rpx; - } - - &__actions { - flex-shrink: 0; - display: flex; - align-items: center; - } - - &__btn { - margin-left: 8rpx; - padding: 8rpx 16rpx; - font-size: 22rpx; - line-height: 1.4; - color: #2979ff; - text-align: center; - background-color: #f5f6fa; - border-radius: 8rpx; - - &:first-child { - margin-left: 0; - } - - &--disabled { - color: #c0c4cc; - background-color: #fafafa; - } - } -} +/* 分页器样式在 components/page-pager(两个列表页共用,勿在此重复定义) */ diff --git a/src/pagesA/external-stock/list.vue b/src/pagesA/external-stock/list.vue index b5572d6..b8c6736 100644 --- a/src/pagesA/external-stock/list.vue +++ b/src/pagesA/external-stock/list.vue @@ -29,18 +29,6 @@ - - {{ storeLabel }} - - + + {{ snLabel }} + + + + {{ batchLabel }} + + 重置 - - + + - - + + + + + ([]) -/** 后端总数(用于「共 N 件」与判断是否到底) */ +/** 后端总数(「共 N 件」与总页数都靠它) */ const total = ref(0) -/** 已加载到第几页(0 = 还没加载过) */ -const page = ref(0) +/** 当前页码(1-based) */ +const pageNo = ref(1) const loading = ref(false) -const loadingMore = ref(false) -const noMore = ref(false) -const failed = ref(false) const isFilled = (value: unknown): boolean => value !== undefined && value !== null && value !== '' const hasFilter = computed( - () => !!form.keyword.trim() || isFilled(form.store_id) || isFilled(form.warehouse_id) + () => + !!form.keyword.trim() || + isFilled(form.warehouse_id) || + !!form.is_sn_mgmt || + !!form.is_batch_mgmt ) /** 可用库存文案:后端没给数据显示 `—`(**不能回退成 0**,会被误读成「没库存」) */ @@ -202,109 +211,138 @@ const qtyTextOf = (item: ExternalStockItem): string => { const coverOf = (item: ExternalStockItem): string => readCover(item) +/** 总页数(按固定每页条数算;总数 0 时也算 1 页,避免出现「第 1/0 页」) */ +const pageCount = computed(() => + Math.max(1, Math.ceil(total.value / EXTERNAL_STOCK_PAGE_SIZE)) +) + +/** 翻页后回到顶部(否则新一页会从上一页的滚动位置继续,看着像没动) */ +const scrollToTop = (): void => { + uni.pageScrollTo({ scrollTop: 0, duration: 0 }) +} + /** - * 拉取列表 - * @param reset true = 回到第 1 页(首次 / 搜索 / 筛选 / 下拉刷新);false = 加载下一页 + * 拉取指定页(**整页替换**,不做追加 —— 分页由底部页码控件驱动) + * @param target 目标页码(1-based),越界自动夹到 `[1, pageCount]` */ -const load = async (reset = false): Promise => { +const loadPage = async (target = pageNo.value): Promise => { if (!isLogin.value) return - if (loading.value || loadingMore.value) return - if (!reset && noMore.value) return + if (loading.value) return - // 失败时不推进 page,所以「重试」会重发同一页 - const target = reset ? 1 : page.value + 1 - - if (reset) loading.value = true - else loadingMore.value = true - failed.value = false + // 未知总数时(首屏)先不夹上界,拿到 total 后页码自会收敛 + const max = total.value > 0 ? pageCount.value : Number.MAX_SAFE_INTEGER + const page = Math.min(Math.max(1, Math.floor(target) || 1), max) + loading.value = true try { const res = await externalStockList({ - page: target, + page, pageSize: EXTERNAL_STOCK_PAGE_SIZE, keyword: form.keyword, - store_id: form.store_id, - warehouse_id: form.warehouse_id + warehouse_id: form.warehouse_id, + is_sn_mgmt: form.is_sn_mgmt, + is_batch_mgmt: form.is_batch_mgmt }) const payload = res?.data - const rows = payload?.list || [] - list.value = reset ? rows : [...list.value, ...rows] + list.value = payload?.list || [] total.value = readTotal(payload) - page.value = target - - // 后端没给 total 时(readTotal = 0)用「本页不满一页」兜底判到底 - noMore.value = - rows.length < EXTERNAL_STOCK_PAGE_SIZE || - (total.value > 0 && list.value.length >= total.value) + pageNo.value = page } catch { - // 失败提示由 request 层统一 toast;这里只管状态:首屏失败 → 空态可重试;加载更多 → 底部可重试 - if (reset) { - list.value = [] - total.value = 0 - page.value = 0 - } - failed.value = true + // 失败提示由 request 层统一 toast;这里保留原页与旧数据(不把用户用到空白页) } finally { loading.value = false - loadingMore.value = false uni.stopPullDownRefresh() } } +/** 切页(分页器按钮用):夹取范围、已在目标页则不动作 */ +const goPage = (target: number): void => { + if (loading.value) return + const next = Math.min(Math.max(1, Math.floor(target) || 1), pageCount.value) + if (next === pageNo.value) return + + loadPage(next).then(scrollToTop) +} + +/** 筛选变了必须重拉第 1 页(不能因为「还在第 1 页」就跳过) */ +const reloadFirstPage = (): void => { + loadPage(1).then(scrollToTop) +} + const onSearch = (): void => { - load(true) + reloadFirstPage() } const onReset = (): void => { form.keyword = '' - form.store_id = '' form.warehouse_id = '' - storeLabel.value = '全部货主' - warehouseLabel.value = '全部仓库' - load(true) + form.is_sn_mgmt = '' + form.is_batch_mgmt = '' + warehouseLabel.value = '仓库' + snLabel.value = 'SN管理' + batchLabel.value = '批次管理' + reloadFirstPage() } -/** 点底部状态行:加载更多 / 重试(到底了就什么都不做) */ -const onTapMore = (): void => { - if (noMore.value) return - load(false) +/** 下拉刷新:重拉当前页;若当前页已越界(总数变少)则回到第 1 页 */ +const refresh = async (): Promise => { + await loadPage(pageNo.value) + if (!list.value.length && pageNo.value > 1) await loadPage(1) } -// ── 货主 / 仓库选择器(底部弹层,一个组件复用于两个维度)── -type PickerKind = 'store' | 'warehouse' +// ── 仓库 / SN管理 / 批次管理 选择器(底部弹层,一个组件复用于多个维度)── +type PickerKind = 'warehouse' | 'sn' | 'batch' const pickerVisible = ref(false) -const pickerKind = ref('store') +const pickerKind = ref('warehouse') const pickerLoading = ref(false) -const storeOptions = ref([]) const warehouseOptions = ref([]) -/** 胶囊上显示的名称(选中后显示具体名称,未选显示「全部…」) */ -const storeLabel = ref('全部货主') -const warehouseLabel = ref('全部仓库') +/** SN管理 / 批次管理:本地固定选项(取值 Y/N,与 new3 的筛选配置一致) */ +const YES_NO_OPTIONS: SelectOption[] = [ + { value: '', label: '全部' }, + { value: 'Y', label: '是' }, + { value: 'N', label: '否' } +] -const pickerTitle = computed(() => (pickerKind.value === 'store' ? '选择货主' : '选择仓库')) -const pickerValue = computed(() => - pickerKind.value === 'store' ? form.store_id : form.warehouse_id +const PICKER_TITLES: Record = { + warehouse: '选择仓库', + sn: '选择 SN 管理', + batch: '选择批次管理' +} + +/** + * 胶囊上显示的名称 + * + * 未选中时显示的是**筛选项名**(仓库 / SN管理 / 批次管理), + * 选中后显示具体值(仓库名 / 是 / 否) + */ +const warehouseLabel = ref('仓库') +const snLabel = ref('SN管理') +const batchLabel = ref('批次管理') + +const pickerTitle = computed(() => PICKER_TITLES[pickerKind.value]) +const pickerValue = computed(() => { + if (pickerKind.value === 'warehouse') return form.warehouse_id + return pickerKind.value === 'sn' ? form.is_sn_mgmt : form.is_batch_mgmt +}) +/** 弹层选项:仓库来自接口(含「全部仓库」),SN/批次是本地常量 */ +const pickerOptions = computed(() => + pickerKind.value === 'warehouse' + ? [{ value: '', label: '全部仓库' }, ...warehouseOptions.value] + : YES_NO_OPTIONS ) -/** 弹层选项:页面负责拼「全部…」,「选项多时的名称搜索」在 option-picker 内部处理 */ -const pickerOptions = computed(() => [ - { value: '', label: pickerKind.value === 'store' ? '全部货主' : '全部仓库' }, - ...(pickerKind.value === 'store' ? storeOptions.value : warehouseOptions.value) -]) -/** 首次打开某个维度时才拉它的选项(拉过就缓存,不重复请求) */ -const ensureOptions = async (kind: PickerKind): Promise => { - const target = kind === 'store' ? storeOptions : warehouseOptions - if (target.value.length) return +/** 仓库选项只有用到时才拉(拉过就缓存,不重复请求) */ +const ensureWarehouseOptions = async (): Promise => { + if (warehouseOptions.value.length) return pickerLoading.value = true try { - const options = kind === 'store' ? await fetchStoreOptions() : await fetchWarehouseOptions() - target.value = options + warehouseOptions.value = await fetchWarehouseOptions() } catch { - // 失败提示由 request 层统一 toast;这里保持空列表(弹层里只剩「全部」+ 提示) + // 失败提示由 request 层统一 toast;这里保持空列表(弹层里只剩「全部仓库」) } finally { pickerLoading.value = false } @@ -313,7 +351,7 @@ const ensureOptions = async (kind: PickerKind): Promise => { const openPicker = (kind: PickerKind): void => { pickerKind.value = kind pickerVisible.value = true - ensureOptions(kind) + if (kind === 'warehouse') ensureWarehouseOptions() } const closePicker = (): void => { @@ -321,15 +359,19 @@ const closePicker = (): void => { } const chooseOption = (option: SelectOption): void => { - if (pickerKind.value === 'store') { - form.store_id = option.value - storeLabel.value = option.label - } else { + // 选中「全部」时,胶囊回到**筛选项名**(而不是「全部」这种字样) + if (pickerKind.value === 'warehouse') { form.warehouse_id = option.value - warehouseLabel.value = option.label + warehouseLabel.value = isFilled(option.value) ? option.label : '仓库' + } else if (pickerKind.value === 'sn') { + form.is_sn_mgmt = String(option.value) + snLabel.value = String(option.value) ? option.label : 'SN管理' + } else { + form.is_batch_mgmt = String(option.value) + batchLabel.value = String(option.value) ? option.label : '批次管理' } closePicker() - load(true) + reloadFirstPage() } /** 空态文案:有筛选条件时不能用「服务器出差了」这种口气 */ @@ -339,22 +381,17 @@ const emptyStateProps = computed(() => // ── 生命周期 ── onLoad(() => { - load(true) + loadPage(1) }) // 未登录进来是空态(页内有登录引导);登录成功后自动拉一次 watch(isLogin, (value) => { - if (value && !list.value.length) load(true) + if (value && !list.value.length) loadPage(1) }) -// 下拉刷新:替代 Web 端的「刷新」按钮 +// 下拉刷新:重拉当前页 onPullDownRefresh(() => { - load(true) -}) - -// 上拉加载下一页:替代 Web 端底部的页码控件 -onReachBottom(() => { - load(false) + refresh() }) @@ -362,7 +399,8 @@ onReachBottom(() => { .page { min-height: 100vh; background-color: #f5f6fa; - padding-bottom: 24rpx; + /* 给固定底部的分页器留位置(分页器只有一行,约 72rpx),否则最后一张卡会被盖住 */ + padding-bottom: 140rpx; } /* 筛选区:吸顶。部分低版本基础库不支持 sticky 就退化为普通块,不影响使用 */ @@ -379,7 +417,9 @@ onReachBottom(() => { align-items: center; &--chips { - margin-top: 12rpx; + margin-top: 8rpx; + /* 筛选项变多了(仓库 / SN管理 / 批次管理 / 重置):允许换行,否则会被挤出屏幕 */ + flex-wrap: wrap; } } @@ -404,7 +444,8 @@ onReachBottom(() => { display: flex; align-items: center; max-width: 320rpx; - margin-right: 16rpx; + /* 筛选项有三个 + 重置:允许换行,所以上下各留 4rpx 避免换行后贴在一起 */ + margin: 4rpx 16rpx 4rpx 0; padding: 10rpx 20rpx; background-color: #f5f6fa; border-radius: 999rpx; @@ -432,12 +473,6 @@ onReachBottom(() => { padding: 96rpx 0; } -.count { - padding: 20rpx 32rpx 0; - font-size: 24rpx; - color: #909399; -} - .goods { display: flex; margin: 20rpx 24rpx 0; @@ -465,7 +500,6 @@ onReachBottom(() => { margin-left: 20rpx; display: flex; flex-direction: column; - justify-content: space-between; } &__name { @@ -479,7 +513,18 @@ onReachBottom(() => { overflow: hidden; } + &__code { + margin-top: 8rpx; + font-size: 22rpx; + color: #909399; + overflow: hidden; + white-space: nowrap; + text-overflow: ellipsis; + } + &__qty { + /* 撑到卡片下沿:名称 / 编码在上,库存数与之对齐 */ + margin-top: auto; font-size: 24rpx; color: #909399; } @@ -492,18 +537,5 @@ onReachBottom(() => { } } -/* 底部状态行 = 移动端的分页器(见模板注释) */ -.more { - display: flex; - align-items: center; - justify-content: center; - padding: 32rpx 24rpx; - font-size: 24rpx; - color: #909399; - - &__retry { - color: #2979ff; - } -} - +/* 分页器样式在 components/page-pager(两个列表页共用,勿在此重复定义) */ diff --git a/我的页面-分类入口改造-分析与任务清单.md b/我的页面-分类入口改造-分析与任务清单.md index 9b2470a..a5f4197 100644 --- a/我的页面-分类入口改造-分析与任务清单.md +++ b/我的页面-分类入口改造-分析与任务清单.md @@ -347,6 +347,15 @@ body = { warehouse_id?, pagination: { page, pageSize }, where: { keyword?, store - 校验:`npm run type-check` 通过;`check:pages` 9/9、0 告警;产物 `list.js/json/wxml/wxss` 已生成, 引用完整性 110 个引用 / 0 缺失 +**2026-09-28 调整(筛选条件与卡片字段)**: + +- 筛选区改为 **仓库 / SN管理 / 批次管理**(**移除货主筛选**) +- 胶囊未选中时显示**筛选项名**(仓库 / SN管理 / 批次管理),选中后显示具体值(仓库名 / 是 / 否); + 选「全部…」时回到筛选项名;筛选项多了,筛选行改为允许换行(`flex-wrap`) +- SN管理 / 批次管理 取值 `'Y'`/`'N'`,走 `where` 的**裸值** + (与 new3 `handleConditionChange` 一致:它会把 ScanBox 的 `{operator,value}` 剥成裸值再传) +- 卡片新增**商品编码**行(`item_code`) + ### 3.5 收货单页面实现(2026-09-26) 后端新增小程序页面权限:**632** `/external-inventory`「外仓库存」(分类)、 @@ -399,6 +408,27 @@ body = { pagination: { page, pageSize }, where: { <字段>: { operator, value } 产物 `pagesA/external-inventory/receiving.{js,json,wxml,wxss}` + `components/option-picker/*` 均已生成, 引用完整性 117 个引用 / 0 缺失。 +**2026-09-28 调整(筛选条件与卡片字段,对齐 new3 `receiving_owner`)**: + +- 筛选区改为 **收货状态 / 入库状态 / 审核状态 / 仓库**(**移除货主筛选** —— new3 货主侧页面也已 + `.filter(f => f.value !== 'store_id')`;接口层 `store_id` 能力保留,可从页面接回) +- 「全部状态」胶囊更名 **「收货状态」**(未选中显示筛选项名,选中显示具体值;选「全部」回到筛选项名) +- 新增筛选取值(都走 `{ operator: 'eq', value }`): + | 维度 | 字段 | 取值 | + |---|---|---| + | 收货状态 | `status` | receiving 收货中 / completed 已完成 / cancelled 已作废 | + | 入库状态 | `storage_status` | waiting 待入库 / none 未入库 / partial 部分入库 / all(筛选写「已入库」、列表写「全部入库」,Web 原样) | + | 审核状态 | `is_review` | **数值** 1 已审核 / 0 未审核(页面存字符串,`buildBody()` 里转数字) | + | 仓库 | `warehouse_id` | 接口 `index.loadWarehouses`(含「全部仓库」项,选中时才拉、拉过缓存) | +- 卡片新增 3 行:**入库状态 / 匹配状态**(按状态着色)+ **备注**(有值才显示) +- 顺带:胶囊文案改为**算出来**(`labelOf(kind)` = 当前值 → 选项表),不再手工维护 + `storeLabel` / `statusLabel` 这类 ref,重置不会漏;筛选行加 `flex-wrap`(4 个胶囊 + 重置会换行) +- 备好未接线:匹配状态筛选项常量 `RECEIVING_DETAIL_OPTIONS`(本次只要求「显示」,未加筛选) +- 校验:`type-check` 通过;`check:pages` 10/10、0 告警;产物 17:24 已重建(页面 js 含 + `storage_status` / `is_review` / `warehouse_id`,wxml 含「入库状态/匹配状态/备注」,无「全部货主」), + 引用完整性 125 个 / 0 缺失 +- ⚠️ 待实测:`is_review` **不在** new3 货主侧列定义里,筛选是否生效需在工具里点一次确认 + --- ## 4. 下一步任务清单