From 52810f991f4760d02c6aa84ef867b9a19763991e Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Wed, 30 Sep 2026 18:14:16 +0800 Subject: [PATCH] 1 --- src/api/stock/report.ts | 224 +++++++++ src/pages.json | 13 + src/pagesA/external-inventory/report.vue | 586 +++++++++++++++++++++++ src/router/pages.ts | 10 + 我的页面-分类入口改造-分析与任务清单.md | 41 ++ 5 files changed, 874 insertions(+) create mode 100644 src/api/stock/report.ts create mode 100644 src/pagesA/external-inventory/report.vue diff --git a/src/api/stock/report.ts b/src/api/stock/report.ts new file mode 100644 index 0000000..eb68e2f --- /dev/null +++ b/src/api/stock/report.ts @@ -0,0 +1,224 @@ +/** + * 库存报表(`stock.report.searchStore`) + * + * 与 new3 Web 端 `src/views/storage/report/store.vue`(**货主侧**)同一个接口 + * (它引的是 `@/api/stock.report/stock.report` 的 `searchStoreReport`)。 + * ⚠️ 同模块还有**仓库侧**的 `stock.report.search` —— 小程序是货主侧(与「收货单」用 + * `getStoreReceivingList` 同理),货主侧才会**不收 `store_ids`**、也不提供 `by_space`。 + * + * ``` + * body = { where?: {...}, sort?: {...}, pagination: { page, pageSize } } + * 返回 data = { list: [...], pagination: { page, pageSize, total } } + * ``` + * + * ⚠️ **这是第三套 `where` 形状 —— 扁平值**: + * ``` + * where.keyword = 'xxx' // 不是 { operator, value } + * where.warehouse_ids = [3] // 仓库是**数组**写法(不是 warehouse_id) + * where.start_time = '2026-09-01 00:00:00' + * where.end_time = '2026-09-30 23:59:59' + * ``` + * 对照:`stock.warehouse.externalList` = 裸值单值;`storage.receiving.*` = `{ operator, value }`。 + * + * 小程序端展示的字段取自 new3 `report-config.ts` 的 `fixedReportColumns`,并**去掉货主侧 + * 不显示的列**(new3 `store.vue` 的 `STORE_SIDE_HIDDEN_COLS = {store_id, store_name}`): + * 商品名称 / 商品编码 / 条码 / SKU / 期初数量 / 区间内入库 / 区间内出库 / 期末数量 / + * 统计区间 / 仓库。排序、按库位统计、导出等 Web 能力移动端不做。 + */ + +import request from '@/utils/request' +import type { BizResponse } from '@/utils/request' +import { SYSTEM_URL, gatewayParams } from '@/utils/gateway' + +/** + * 每页条数:**固定 50 条,页面不提供修改** + * + * 明细行是纯文本(没有图片),单页可以比「外仓商品」的 20 条多放一些,少翻页; + * 与「收货单」取同一个值,便于记忆 + */ +export const REPORT_PAGE_SIZE = 50 + +/** 报表明细行(只声明小程序用到的字段,其余用索引签名兜住) */ +export interface ReportItem { + /** 统计区间开始 / 结束(后端原值,形如 `2026-09-01 00:00:00`) */ + start_time?: string | null + end_time?: string | null + /** 商品库存 ID(Web 端列名是 SKU) */ + stock_id?: number + store_id?: number + /** 仓库 */ + warehouse_id?: number + warehouse_name?: string + /** 期初数量 */ + begin_total?: number + /** 区间内入库 */ + inbound_total?: number + /** 区间内出库 */ + outbound_total?: number + /** 期末数量 */ + end_total?: number + /** 货主(货主侧不展示,保留字段便于排查) */ + store_name?: string + item_name?: string + item_code?: string + barcode?: string + /** 库位:只有 `by_space=true` 才有,货主侧不提供该条件,正常不会返回 */ + space_id?: number | null + space_name?: string | null + [key: string]: any +} + +/** 列表响应体 `data` */ +export interface ReportPayload { + list?: ReportItem[] + total?: number + pagination?: { page?: number; pageSize?: number; total?: number } + [key: string]: any +} + +/** 查询条件(页面传入) */ +export interface ReportQuery { + page?: number + pageSize?: number + /** 商品关键字:SKU ID / 商品编码 / 商品名称 / 条码 模糊匹配 */ + keyword?: string + /** 仓库 id(接口是**数组**写法 `warehouse_ids`),空字符串表示全部 */ + warehouse_id?: number | string + /** 统计区间开始(`YYYY-MM-DD HH:mm:ss`) */ + start_time?: string + /** 统计区间结束(`YYYY-MM-DD HH:mm:ss`) */ + end_time?: string +} + +function isFilled(value: unknown): boolean { + return value !== undefined && value !== null && value !== '' +} + +/** + * 组装请求体 + * + * `where` 全是**扁平值**;无有效条件时**不传 `where`**(new3 同款写法 —— + * 空对象可能被后端当成「筛了空」) + */ +function buildBody(query: ReportQuery): Record { + const { page = 1, pageSize = REPORT_PAGE_SIZE, keyword, warehouse_id, start_time, end_time } = query + + const where: Record = {} + if (keyword && String(keyword).trim()) where.keyword = String(keyword).trim() + + if (isFilled(warehouse_id)) { + const num = Number(warehouse_id) + // 与 new3 `applyWarehouseToWhere()` 一致:能转数字就给数字数组,否则原样包成数组 + where.warehouse_ids = Number.isFinite(num) ? [num] : [warehouse_id] + } + + if (isFilled(start_time)) where.start_time = start_time + if (isFilled(end_time)) where.end_time = end_time + + const body: Record = { pagination: { page, pageSize } } + if (Object.keys(where).length) body.where = where + return body +} + +/** 库存报表明细(分页) */ +export function fetchStoreReportList( + query: ReportQuery = {} +): Promise> { + return request({ + url: SYSTEM_URL, + method: 'POST', + params: gatewayParams('stock.report.searchStore'), + data: buildBody(query), + // 需要登录:未登录时不发请求,直接弹登录抽屉 + auth: true + }) +} + +/** 总数:后端放在 `pagination.total`(也可能在顶层 `total`) */ +export function readTotal(payload: ReportPayload | undefined | null): number { + const total = payload?.pagination?.total ?? payload?.total ?? 0 + const num = Number(total) + return Number.isFinite(num) && num > 0 ? num : 0 +} + +// ── 统计区间 ────────────────────────────────────────────────────────────── + +/** 预设区间(含「全部」);默认「全部」= 不传时间条件,跟随后端默认口径 */ +export const REPORT_PERIOD_OPTIONS: Array<{ value: string; label: string }> = [ + { value: '', label: '全部' }, + { value: 'today', label: '今天' }, + { value: 'd7', label: '近 7 天' }, + { value: 'd30', label: '近 30 天' }, + { value: 'month', label: '本月' } +] + +const pad2 = (num: number): string => String(num).padStart(2, '0') + +/** + * 日期 → `YYYY-MM-DD HH:mm:ss` + * + * 与 new3 `normalizeReportStartDateParam` / `normalizeReportEndDateParam` 等价 + * (开始取当天 00:00:00、结束取当天 23:59:59,不用 `dayjs`:小程序端不引这个依赖) + */ +function toParam(date: Date, endOfDay = false): string { + const day = `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}` + return `${day} ${endOfDay ? '23:59:59' : '00:00:00'}` +} + +function addDays(base: Date, days: number): Date { + const next = new Date(base.getTime()) + next.setDate(next.getDate() + days) + return next +} + +/** + * 预设区间 → `{ start_time, end_time }` + * + * @param key 预设标识;`''`(全部)返回 `null` = 不传时间条件 + * + * ⚠️ 天数**含今天**:近 7 天 = 今天往前推 6 天 + */ +export function buildPeriodRange(key: string): { start_time: string; end_time: string } | null { + if (!key) return null + + const now = new Date() + const end = toParam(now, true) + + if (key === 'today') return { start_time: toParam(now), end_time: end } + if (key === 'd7') return { start_time: toParam(addDays(now, -6)), end_time: end } + if (key === 'd30') return { start_time: toParam(addDays(now, -29)), end_time: end } + if (key === 'month') { + return { start_time: toParam(new Date(now.getFullYear(), now.getMonth(), 1)), end_time: end } + } + return null +} + +// ── 展示文本 ────────────────────────────────────────────────────────────── + +/** + * 数量文案:带千分位(如 `1,234`) + * + * 不用 `toLocaleString('zh-CN')`:小程序 JSCore 对 locale 参数支持不稳, + * 手写分组更可控(与 new3 `formatReportNumber` 的展示效果一致) + */ +export function readNumberText(value: unknown): string { + if (!isFilled(value)) return '—' + + const num = Number(value) + if (!Number.isFinite(num)) return '—' + + const [intPart, decPart] = String(num).split('.') + const sign = intPart.startsWith('-') ? '-' : '' + const digits = sign ? intPart.slice(1) : intPart + const grouped = digits.replace(/\B(?=(\d{3})+(?!\d))/g, ',') + const decimal = decPart ? `.${decPart.slice(0, 4)}` : '' + return `${sign}${grouped}${decimal}` +} + +/** 统计区间文案:只到**日期**(`2026-09-01 ~ 2026-09-30`),移动端一行放得下 */ +export function readPeriodText(item: ReportItem | undefined | null): string { + const start = item?.start_time ? String(item.start_time).slice(0, 10) : '' + const end = item?.end_time ? String(item.end_time).slice(0, 10) : '' + if (start && end) return `${start} ~ ${end}` + return start || end || '—' +} diff --git a/src/pages.json b/src/pages.json index 8e756e6..7fade26 100644 --- a/src/pages.json +++ b/src/pages.json @@ -78,6 +78,15 @@ "backgroundTextStyle": "dark", "onReachBottomDistance": 80 } + }, + { + "path": "external-inventory/report", + "style": { + "navigationBarTitleText": "库存报表", + "enablePullDownRefresh": true, + "backgroundTextStyle": "dark", + "onReachBottomDistance": 80 + } } ] } @@ -136,6 +145,10 @@ { "name": "收货单", "path": "pagesA/external-inventory/receiving" + }, + { + "name": "库存报表", + "path": "pagesA/external-inventory/report" } ] }, diff --git a/src/pagesA/external-inventory/report.vue b/src/pagesA/external-inventory/report.vue new file mode 100644 index 0000000..1b31177 --- /dev/null +++ b/src/pagesA/external-inventory/report.vue @@ -0,0 +1,586 @@ + + + + + diff --git a/src/router/pages.ts b/src/router/pages.ts index a27ebbe..c4e1013 100644 --- a/src/router/pages.ts +++ b/src/router/pages.ts @@ -158,6 +158,16 @@ export const PAGE_REGISTRY: PageMeta[] = [ auth: 'required' // 对应后端 id=633(父节点 632「外仓库存」分类)—— 同样必须与 key 逐字符相等 // 不设 hidden → 登录后由后端菜单下发才出现;不设 common → 走「后端菜单」那一侧 + }, + { + key: '/external-inventory/report', + path: 'pagesA/external-inventory/report', + title: '库存报表', + // 本地兜底图标;后端 id=637 下发的是 file-text(uview 图标表里存在同名图标) + icon: 'file-text', + auth: 'required' + // 对应后端 id=637(父节点 632「外仓库存」分类,sort=1 排在「收货单」之后) + // 接口 stock.report.searchStore(**货主侧**),见 api/stock/report.ts } // ─────────────── 待启用(页面文件就绪后再登记)─────────────── diff --git a/我的页面-分类入口改造-分析与任务清单.md b/我的页面-分类入口改造-分析与任务清单.md index a5f4197..f4ba78a 100644 --- a/我的页面-分类入口改造-分析与任务清单.md +++ b/我的页面-分类入口改造-分析与任务清单.md @@ -429,6 +429,47 @@ body = { pagination: { page, pageSize }, where: { <字段>: { operator, value } 引用完整性 125 个 / 0 缺失 - ⚠️ 待实测:`is_review` **不在** new3 货主侧列定义里,筛选是否生效需在工具里点一次确认 +### 3.6 库存报表页面实现(2026-09-30) + +后端新增小程序页面权限:**637** `/external-inventory/report`「库存报表」 +(632「外仓库存」的子,sort 1 排在「收货单」之后,`meta_icon='file-text'`)。 + +> ⚠️ **id 不是顺序分配**:634/635/636 已被 pda「移库记录」/ web「库存盘点」/ api 权限占用 —— +> 新增 `miniprogram_pages` 前先查空闲 id(本次按 634 直接 INSERT 撞过主键)。 + +#### 接口(`src/api/stock/report.ts`) + +``` +POST {base}/system?method=stock.report.searchStore&v=1.0×tamp=... +body = { where?: {...}, sort?: {...}, pagination: { page, pageSize } } +返回 data = { list: [...], pagination: { page, pageSize, total } } +``` + +- 与 new3 `views/storage/report/store.vue`(**货主侧**)同源;仓库侧是同模块的 + `stock.report.search`(按 `store_ids` 过滤)—— 别拿错(「收货单」也是走货主侧 `getStoreReceivingList`) +- ⚠️ **第三套 `where` 形状:扁平值**(前两套分别是「外仓商品」的裸值、「收货单」的 `{operator,value}`): + `where.keyword` / `where.warehouse_ids = [id]`(**数组**,不是 `warehouse_id`)/ + `where.start_time` / `where.end_time`;**无有效条件时连 `where` 都不传**(new3 同款写法) +- 货主侧不收 `store_ids`、不提供 `by_space` + +#### 页面(`pagesA/external-inventory/report.vue`) + +- 筛选:**商品关键字 + 仓库 + 统计区间**(→ `keyword` / `warehouse_ids` / `start_time`+`end_time`) +- **统计区间用预设**(全部 / 今天 / 近 7 天 / 近 30 天 / 本月)代替 Web 的日期范围选择器 —— + 移动端拉日历挑区间体验差;默认「全部」= 不传时间条件、跟随后端默认口径; + 天数**含今天**(近 7 天 = 往前推 6 天),格式 `YYYY-MM-DD HH:mm:ss`(start 00:00:00 / end 23:59:59) +- 卡片字段(new3 `fixedReportColumns` 去掉货主侧隐藏的 `store_id`/`store_name`): + 商品名称 + 仓库 / 编码 · 条码 · SKU / **2×2 四个数量**(期初 / 区间内入库 / 区间内出库 / 期末)/ + 统计区间(只到日期);数量带千分位(手写分组,不用 `toLocaleString`:小程序 JSCore 的 locale 支持不稳) +- 分页:`REPORT_PAGE_SIZE = 50` 固定,复用公共 `page-pager`(`unit="条明细"`),**整页替换** +- 未做(Web 能力,移动端刻意不做):SKU 多选、按库位统计、列排序、导出 +- 校验:`type-check` 通过;`check:pages` → **11 条注册表 / 11 个已注册页面 / 0 告警**; + 产物已重建(页面 js/wxml/json/wxss + `api/stock/report.js`,含 `stock.report.searchStore` / + `warehouse_ids`;wxml 含四个数量与统计区间标签),引用完整性 131 个 / 0 缺失 +- ✅ **接口存在性已取证**:未带 token 请求 `stock.report.searchStore` → **HTTP 401** + (对照组:伪造方法名 `stock.report.searchStoreXyz` → 500)。 + 待你在工具里确认的是「带 token 能正常返回数据」以及页面字段是否都下发 + --- ## 4. 下一步任务清单