From 03d8ed615a5a002b84cc96c6cbbfe666ebb6f76b Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Wed, 14 Oct 2026 17:59:46 +0800 Subject: [PATCH] 1 --- src/api/warehouse/external-warehouse.ts | 290 +++++++++++ src/composables/useEntrySections.ts | 45 +- src/pages.json | 39 +- src/pages/index/index.vue | 83 +++- src/pages/mine/mine.vue | 2 +- src/pagesA/demo/public.vue | 70 --- src/pagesA/external-warehouse/list.vue | 585 ++++++++++++++++++++++ src/pagesA/test/index.vue | 2 +- src/pagesA/tools/barcode.vue | 367 ++++++++++++++ src/pagesA/tools/calculator.vue | 617 ++++++++++++++++++++++++ src/router/entries.ts | 43 +- src/router/pages.ts | 57 ++- src/utils/barcode.ts | 126 +++++ src/utils/calculator.ts | 209 ++++++++ 微信小程序开发清单.md | 12 +- 15 files changed, 2410 insertions(+), 137 deletions(-) create mode 100644 src/api/warehouse/external-warehouse.ts delete mode 100644 src/pagesA/demo/public.vue create mode 100644 src/pagesA/external-warehouse/list.vue create mode 100644 src/pagesA/tools/barcode.vue create mode 100644 src/pagesA/tools/calculator.vue create mode 100644 src/utils/barcode.ts create mode 100644 src/utils/calculator.ts diff --git a/src/api/warehouse/external-warehouse.ts b/src/api/warehouse/external-warehouse.ts new file mode 100644 index 0000000..c246983 --- /dev/null +++ b/src/api/warehouse/external-warehouse.ts @@ -0,0 +1,290 @@ +/** + * 外部仓库(签约仓库)列表(`storeWarehouse.warehouse.list`) + * + * 与 new3 Web 端 `src/views/warehouses/index.vue`(「外部仓库」页)**同一个接口、 + * 同一套参数结构** —— 那个页面用的 `warehouseList()` 就是它: + * + * ``` + * body = { + * page, pageSize / page_size, // ⚠️ 见下方坑 1 + * keyword?, // 仓库名 / 备注 + * auth_status?, // 1 待审核 2 已通过 3 已拒绝 4 已解除 5 已过期 + * use_status? // 1 启用 / 0 禁用 + * } + * 返回 data = { + * list: [...], + * pagination: { total, page, pageSize }, + * current_subject?: { store_id, company_name, role } // 当前主体(货主) + * } + * ``` + * + * ⚠️ 三处容易踩的坑: + * + * 1. **参数是「扁平」的**:new3 直接发 `{ page, page_size, ...where }`, + * 不是本项目其它列表页那种 `{ pagination: { page, pageSize }, where: {...} }`。 + * 所以本模块**不套 `pagination` / `where`**,照 new3 原样发。 + * 2. 请求里每页条数叫 **`page_size`(下划线)**,响应里页码字段可能是 `pageSize`(驼峰) + * —— 读取时两种都认(见 `readTotal`)。 + * 3. 业务字段**已知在 `data` 里**,但项目里已经踩过两次「顶层直出、没有 data 包裹」 + * (`index.loadStores` / `stock.transaction.storeList`),故统一走 `pickPayload()` 兜底。 + * + * 字段命名对照(new3 列配置 → 语义): + * | 字段 | 展示为 | 说明 | + * |---|---|---| + * | `warehouse_name` → `remask` → `counterparty_name` | 签约仓库 | 依次兜底 | + * | `counterparty_name` | 签约仓库(括号内真名) | 与主名不同才显示 | + * | `remask` → `store_name` | 货主备注 | `remask` 是**用户改过的备注**(不是拼写错误) | + * | `counterparty_role` | 对方角色 | `warehouse` = 仓库方,其余 = 货主方 | + * | `auth_status` / `auth_status_label` | 签约状态 | 后端给 label 就优先用 | + * | `needs_my_confirm` | 待确认 | 真值才显示「待我确认」 | + * | `use_status` | 使用状态 | 1 启用 / 0 禁用 | + * | `print_quantity` | 面单余额 | 缺失显示 `—`(**不要显示 0**,会被误读成「没余额」) | + */ + +import request from '@/utils/request' +import type { BizResponse } from '@/utils/request' +import { SYSTEM_URL, gatewayParams } from '@/utils/gateway' + +/** 每页条数:移动端不做「每页条数」选择器,固定即可(与 new3 默认值一致) */ +export const EXTERNAL_WAREHOUSE_PAGE_SIZE = 20 + +/** 列表项(只声明小程序用到的字段,其余用索引签名兜住) */ +export interface ExternalWarehouseItem { + /** 签约记录 id */ + id?: number + /** 仓库 id(本仓库在 wms 里的主键,可能为空) */ + warehouse_id?: number | null + /** 对方仓库名 */ + warehouse_name?: string + /** 对方主体真名(备注被改过时用它做区分) */ + counterparty_name?: string + /** 对方角色:`warehouse` = 仓库方,其余视为货主方 */ + counterparty_role?: string + /** 己方货主名 */ + store_name?: string + /** 备注(用户可改,new3 里就叫 remask) */ + remask?: string + /** 签约状态码:1 待审核 / 2 已通过 / 3 已拒绝 / 4 已解除 / 5 已过期 */ + auth_status?: number | null + /** 签约状态文案(后端给就用它,优先于本地映射) */ + auth_status_label?: string + /** 授权截止时间 */ + auth_end?: string + /** 是否待「我」确认(后端可能是布尔、0/1,也可能是字符串) */ + needs_my_confirm?: boolean | number | string | null + /** 使用状态:1 启用 / 0 禁用 */ + use_status?: number | null + /** 面单余额 */ + print_quantity?: number | string | null + /** 是否已配置奇门(本页不展示,留作以后扩展) */ + has_qimen_config?: boolean + [key: string]: any +} + +/** 列表响应体 `data` */ +export interface ExternalWarehousePayload { + list?: ExternalWarehouseItem[] + total?: number + pagination?: { + page?: number + pageSize?: number + page_size?: number + total?: number + } + /** 当前主体(货主)信息 */ + current_subject?: { store_id?: number; company_name?: string; role?: string } + [key: string]: any +} + +/** 查询条件(页面传入) */ +export interface ExternalWarehouseQuery { + /** 页码(1-based) */ + page?: number + /** 每页条数(请求体里发成 `page_size`) */ + pageSize?: number + /** 关键词:仓库名 / 备注 */ + keyword?: string + /** 签约状态,`''` 表示全部 */ + auth_status?: number | string + /** 使用状态:1 启用 / 0 禁用,`''` 表示全部 */ + use_status?: number | string +} + +function isFilled(value: unknown): boolean { + return value !== undefined && value !== null && value !== '' +} + +/** + * 组装请求体(**扁平参数**,见文件头「坑 1」) + * + * `use_status = 0` 是有效值(禁用),所以判断用 `isFilled` 而不是真值判断。 + */ +function buildBody(query: ExternalWarehouseQuery): Record { + const { + page = 1, + pageSize = EXTERNAL_WAREHOUSE_PAGE_SIZE, + keyword, + auth_status, + use_status + } = query + + const body: Record = { page, page_size: pageSize } + + if (keyword && String(keyword).trim()) body.keyword = String(keyword).trim() + if (isFilled(auth_status)) body.auth_status = Number(auth_status) + if (isFilled(use_status)) body.use_status = Number(use_status) + + return body +} + +/** 外部仓库(签约仓库)列表(分页) */ +export function externalWarehouseList( + query: ExternalWarehouseQuery = {} +): Promise> { + return request({ + url: SYSTEM_URL, + method: 'POST', + params: gatewayParams('storeWarehouse.warehouse.list'), + data: buildBody(query), + // 需要登录:未登录时不发请求,直接弹登录抽屉 + auth: true + }) +} + +/** + * 取出业务体:优先 `data` 包裹,其次顶层直出 + * + * 判据是「有 list 数组或有 pagination」——只判 `data` 存在会把 `{}` 也当业务体。 + */ +export function pickPayload( + res: BizResponse | ExternalWarehousePayload | any +): ExternalWarehousePayload { + const body: any = res ?? {} + const inner: any = body.data + + if (inner && typeof inner === 'object' && (Array.isArray(inner.list) || inner.pagination)) { + return inner as ExternalWarehousePayload + } + if (Array.isArray(body.list) || body.pagination) { + return body as ExternalWarehousePayload + } + return (inner ?? body) as ExternalWarehousePayload +} + +/** 列表数组 */ +export function readRows( + res: BizResponse | ExternalWarehousePayload | any +): ExternalWarehouseItem[] { + return pickPayload(res)?.list || [] +} + +/** 总数:后端放在 `pagination.total`(也可能在顶层 `total`) */ +export function readTotal( + res: BizResponse | ExternalWarehousePayload | any +): number { + const payload = pickPayload(res) + const total = payload?.pagination?.total ?? payload?.total ?? 0 + const num = Number(total) + return Number.isFinite(num) && num > 0 ? num : 0 +} + +// ─────────────────────────── 展示映射(与 new3 逐条对齐) ─────────────────────────── + +export type StatusTone = 'warning' | 'success' | 'danger' | 'info' + +/** 签约状态:文案(后端 `auth_status_label` 优先) */ +const AUTH_STATUS_LABELS: Record = { + 1: '待审核', + 2: '已通过', + 3: '已拒绝', + 4: '已解除', + 5: '已过期' +} + +/** 签约状态:色系(与 new3 `getAuthStatusType` 一致) */ +const AUTH_STATUS_TONES: Record = { + 1: 'warning', + 2: 'success', + 3: 'danger', + 4: 'info', + 5: 'danger' +} + +/** 签约状态筛选选项(`''` = 全部,`option-picker` 会把它固定置顶) */ +export const AUTH_STATUS_OPTIONS = [ + { value: '', label: '全部' }, + { value: 1, label: '待审核' }, + { value: 2, label: '已通过' }, + { value: 3, label: '已拒绝' }, + { value: 4, label: '已解除' }, + { value: 5, label: '已过期' } +] + +/** 使用状态筛选选项 */ +export const USE_STATUS_OPTIONS = [ + { value: '', label: '全部' }, + { value: 1, label: '启用' }, + { value: 0, label: '禁用' } +] + +export function authStatusLabel(item: ExternalWarehouseItem | undefined | null): string { + const label = item?.auth_status_label + if (label && String(label).trim()) return String(label) + return AUTH_STATUS_LABELS[Number(item?.auth_status)] || '—' +} + +export function authStatusTone(item: ExternalWarehouseItem | undefined | null): StatusTone { + return AUTH_STATUS_TONES[Number(item?.auth_status)] || 'info' +} + +/** 对方角色:`warehouse` = 仓库方,其余 = 货主方(与 new3 一致) */ +export function counterpartyRoleLabel(item: ExternalWarehouseItem | undefined | null): string { + return item?.counterparty_role === 'warehouse' ? '仓库方' : '货主方' +} + +export function useStatusText(item: ExternalWarehouseItem | undefined | null): string { + return Number(item?.use_status) === 1 ? '启用' : '禁用' +} + +export function isEnabled(item: ExternalWarehouseItem | undefined | null): boolean { + return Number(item?.use_status) === 1 +} + +/** 是否待「我」确认(后端可能是布尔、0/1) */ +export function needsMyConfirm(item: ExternalWarehouseItem | undefined | null): boolean { + const value = item?.needs_my_confirm + return value === true || value === 1 || value === '1' +} + +/** 签约仓库主名:`warehouse_name` → `remask` → `counterparty_name` */ +export function warehouseNameOf(item: ExternalWarehouseItem | undefined | null): string { + return item?.warehouse_name || item?.remask || item?.counterparty_name || '未命名仓库' +} + +/** + * 签约仓库的「真名」(括号里那部分) + * + * 主名用的是备注(`remask`)时,真名与主名不同才有信息量,相同就不显示。 + */ +export function counterpartyRealNameOf(item: ExternalWarehouseItem | undefined | null): string { + const primary = item?.warehouse_name || item?.remask + const real = item?.counterparty_name + if (primary && real && primary !== real) return String(real) + return '' +} + +/** 货主备注:`remask` → `store_name` */ +export function storeRemarkOf(item: ExternalWarehouseItem | undefined | null): string { + return item?.remask || item?.store_name || '—' +} + +/** + * 面单余额 + * + * 缺失/为空显示 `—`:显示 0 会被误读成「没有面单了」。 + */ +export function printQuantityText(item: ExternalWarehouseItem | undefined | null): string { + const value = item?.print_quantity + if (!isFilled(value)) return '—' + return String(value) +} diff --git a/src/composables/useEntrySections.ts b/src/composables/useEntrySections.ts index 38e0a6f..21dd381 100644 --- a/src/composables/useEntrySections.ts +++ b/src/composables/useEntrySections.ts @@ -1,13 +1,17 @@ /** * 首页入口区渲染状态 * - * 首页的入口区 = **本地「常用功能」列表**(`LOCAL_COMMON_ENTRIES`,前端写死)+ 后端菜单段 - * (`user.info` 的 menus × `PAGE_REGISTRY`),两段形态一致、并排展示,合成逻辑在 `toHomeSections()`。 + * 首页的入口区 = **动态菜单段**(`user.info` 的 menus × `PAGE_REGISTRY`)+ **本地「工具」段** + * (`LOCAL_COMMON_ENTRIES`,前端写死),两段形态一致、动态段在前,合成逻辑在 `toHomeSections()`。 * * 这个 composable 负责把「取数 / 加载态 / 空态文案 / 点击跳转」收口在一处, * 页面只负责 `onShow` 调一次 `loadEntries()`,然后把 `sections` 交给模板。 * - * 登录态差异:未登录时后端菜单为空 ⇒ 只剩下「常用功能」段(公开页仍可浏览,满足微信审核要求)。 + * 登录态差异(2026-10-14 起): + * - 「工具」段不依赖接口 ⇒ **未登录时也一定有内容**,不再是「空态 + 去登录」那种形态 + * - 未登录 / 未绑定 / 拉取失败只影响「动态菜单段」有无;已登录但拉不到菜单时, + * 页面用 `hasDynamicEntries` 判断并给一条**轻量重试提示**(工具段照常可用,不阻断) + * - `emptyStateProps` 只在**连本地段都为空**时才会走到(正常配置下不会出现,留作兜底) */ import { computed, ref } from 'vue' @@ -30,6 +34,13 @@ export interface UseEntrySectionsReturn { isLogin: ComputedRef /** 页面直接 `v-for` 渲染的分段(段标题 + 九宫格) */ sections: ComputedRef + /** + * 动态菜单段是否有内容 + * + * 首页用它判断「已登录但菜单没拉回来」:此时「工具」段仍在,不白屏, + * 只需在那之下补一条轻量重试提示(不用大块空态盖住可用内容)。 + */ + hasDynamicEntries: ComputedRef /** 是否正在拉取 `user.info` */ loading: Ref /** @@ -62,10 +73,35 @@ export function useEntrySections( const loading = ref(false) - /** 本地「常用功能」段 + 后端菜单段(未登录时后端段为空,只剩下常用功能) */ + /** 入口分段 = 动态菜单段(在前)+ 本地「工具」段(固定在后,不登录也渲染) */ const sections = computed(() => toHomeSections(permissionStore.entries, { looseTitle })) + /** 动态菜单段是否有内容(未登录 / 未绑定 / 失败时都为 false) */ + const hasDynamicEntries = computed(() => permissionStore.entries.length > 0) + + /** + * 空态文案(按“为什么是空的”分三种,**不要用服务端故障文案盖住未登录场景**) + * + * ⚠️ 只在**连本地「工具」段都为空**(`LOCAL_COMMON_ENTRIES` 为空)时才会显示 —— + * 正常配置下首页永远至少有工具段,走不到这里,这里只做「绝不白屏」的兜底。 + * + * | 场景 | 文案 | 动作 | + * |---|---|---| + * | 未登录 | 「登录后使用完整功能」 | 「去登录」(无「重试」) | + * | 微信已登录·未绑账号 | 「微信已登录,绑定 WMS 账号后即可使用各功能」 | 「去绑定账号」 | + * | 已登录但菜单拉不到 | 「服务器出差了,请稍后再试」(组件默认值) | 「重试」 | + * + * 为什么未登录要给「去登录」而不是「重试」:`loadEntries()` 未登录会直接 return, + * 点了也没反应(且未登录本就不是故障,说“服务器出差”会误导用户反复重试)。 + */ const emptyStateProps = computed>(() => { + if (!isLogin.value) { + return { + text: '登录后使用完整功能', + icon: 'account', + showRetry: false + } + } if (userStore.isWechatUnbound) { return { text: '微信已登录,绑定 WMS 账号后即可使用各功能', icon: 'account' } } @@ -105,6 +141,7 @@ export function useEntrySections( return { isLogin, sections, + hasDynamicEntries, loading, loadEntries, onEntry, diff --git a/src/pages.json b/src/pages.json index 1a020cb..3fdf2e9 100644 --- a/src/pages.json +++ b/src/pages.json @@ -43,12 +43,6 @@ { "root": "pagesA", "pages": [ - { - "path": "demo/public", - "style": { - "navigationBarTitleText": "公开示例" - } - }, { "path": "demo/required", "style": { @@ -61,6 +55,18 @@ "navigationBarTitleText": "测试页" } }, + { + "path": "tools/calculator", + "style": { + "navigationBarTitleText": "计算器" + } + }, + { + "path": "tools/barcode", + "style": { + "navigationBarTitleText": "条形码生成" + } + }, { "path": "external-stock/list", "style": { @@ -70,6 +76,15 @@ "onReachBottomDistance": 80 } }, + { + "path": "external-warehouse/list", + "style": { + "navigationBarTitleText": "外部仓库", + "enablePullDownRefresh": true, + "backgroundTextStyle": "dark", + "onReachBottomDistance": 80 + } + }, { "path": "external-inventory/receiving", "style": { @@ -145,8 +160,12 @@ "path": "pages/mine/user-info" }, { - "name": "公开示例页", - "path": "pagesA/demo/public" + "name": "计算器", + "path": "pagesA/tools/calculator" + }, + { + "name": "条形码", + "path": "pagesA/tools/barcode" }, { "name": "需登录示例页", @@ -160,6 +179,10 @@ "name": "外仓商品", "path": "pagesA/external-stock/list" }, + { + "name": "外部仓库", + "path": "pagesA/external-warehouse/list" + }, { "name": "收货单", "path": "pagesA/external-inventory/receiving" diff --git a/src/pages/index/index.vue b/src/pages/index/index.vue index 7f53e29..16648a9 100644 --- a/src/pages/index/index.vue +++ b/src/pages/index/index.vue @@ -27,7 +27,7 @@ - + @@ -37,14 +37,27 @@ - - + + + + - - - - diff --git a/src/pagesA/external-warehouse/list.vue b/src/pagesA/external-warehouse/list.vue new file mode 100644 index 0000000..adcee6c --- /dev/null +++ b/src/pagesA/external-warehouse/list.vue @@ -0,0 +1,585 @@ + + + + + diff --git a/src/pagesA/test/index.vue b/src/pagesA/test/index.vue index e3a1b1a..9092c4b 100644 --- a/src/pagesA/test/index.vue +++ b/src/pagesA/test/index.vue @@ -172,7 +172,7 @@ + + diff --git a/src/pagesA/tools/calculator.vue b/src/pagesA/tools/calculator.vue new file mode 100644 index 0000000..fd8a968 --- /dev/null +++ b/src/pagesA/tools/calculator.vue @@ -0,0 +1,617 @@ + + + + + + + diff --git a/src/router/entries.ts b/src/router/entries.ts index b4f36b3..078195f 100644 --- a/src/router/entries.ts +++ b/src/router/entries.ts @@ -11,7 +11,7 @@ * | 未命中 | **忽略该项**,记入 `missing`(不影响其它入口,由调用方告警) | * | 分组节点无子项命中 | 整组丢弃(避免渲染出空分组) | * | `hidden = 1` | 不进导航入口 | - * | `common: true` 的本地页面 | 无论后端是否下发,都进首页「常用功能」段(见 `LOCAL_COMMON_ENTRIES`) | + * | `common: true` 的本地页面 | 无论后端是否下发,都进首页「工具」段(见 `LOCAL_COMMON_ENTRIES`) | * * ⚠️ **输出固定为两层**(`EntryGroup.children` 只能是 `EntryLeaf`): * 小程序首页是「分组标题 + 子项九宫格」(决策点 4), @@ -184,16 +184,16 @@ export function generateEntries(menus: MenuNode[] | null | undefined): GenerateE } /** - * 首页「常用功能」—— **本地维护**的页面列表(与后端菜单无关) + * 首页「工具」—— **本地维护**的页面列表(与后端菜单无关) * * 为什么单独搞一份:这个段要在**任何登录态 / 授权 / 接口故障 / 后端未配置**的情况下都稳定, - * 用来常驻放「必须有」或「随时要进」的页面(公开页关系到微信审核、测试页关系到开发联调)。 - * 后端 `miniprogram_pages` 只负责「登录后**还**能看到什么」,在首页以**分类段**追加在其后。 + * 用来常驻放「必须有」或「随时要进」的页面(公开工具页关系到微信审核)。 + * 后端 `miniprogram_pages` 只负责「登录后**还**能看到什么」,在首页以**分类段**排在它**前面**。 * * 筛选条件:`common === true`(**显式声明,不设置即不进**)**且** `isEntryVisible(page)` * - * ⚠️ `auth: 'public'` 的页面请一并标 `common: true`,否则未登录时首页没有任何入口 - *(微信审核要求「未登录也要能看到内容」)。 + * ⚠️ `auth: 'public'` 的页面请一并标 `common: true`,否则未登录时首页只剩下动态菜单(必为空), + * 等于「一打开什么都没有」(微信审核要求「未登录也要能看到内容」)。 */ export const LOCAL_COMMON_ENTRIES: EntryLeaf[] = PAGE_REGISTRY.filter( (page) => page.common === true && isEntryVisible(page) @@ -269,20 +269,23 @@ export function toSections(nodes: EntryNode[], options: ToSectionsOptions = {}): return sections } -/** 首页本地列表的段标题(= `PageMeta.common` 选出来的那一组) */ -export const COMMON_SECTION_TITLE = '常用功能' +/** 首页本地「工具」段的段标题(= `PageMeta.common` 选出来的那一组) */ +export const TOOLS_SECTION_TITLE = '工具' /** - * 首页入口分段 = **本地「常用功能」段** + 后端菜单段 + * 首页入口分段 = **动态菜单段** + **本地「工具」段** * - * 形态完全一致(都是「标题 + 子项九宫格」),并排展示; - * 差别只在来源:前者前端写死、后者由 `user.info` 的 `menus` 驱动。 + * 顺序(2026-10-14 定):**动态菜单段在前、「工具」段固定在后** —— + * 业务功能随角色 / 权限变化,是首页主体;工具是固定入口,放最后不抢视线。 * - * - 本地段固定**在最前**:它是每个用户都有的固定入口,位置不该被后端配置左右 - * - **去重**:本地列表里已有的 key 从后端段中剔除(否则「测试页」会同时出现在两处) - * - 本地段为空(没有页面标 `common: true`)时不渲染它 + * 形态完全一致(都是「标题 + 子项九宫格」),差别只在来源: + * 前者由 `user.info` 的 `menus` 驱动,后者前端写死。 * - * 未登录时 `nodes` 为空 ⇒ 结果就是纯粹的「常用功能」,正好担当「未登录可浏览内容」。 + * - **「工具」段无论是否登录都渲染**(纯本地清单、不看接口)⇒ 未登录时首页也一定有内容, + * 这正是微信审核「不能出现需登录才能看到任何内容」的落点 + * - **去重**:本地段里已有的 key 会从动态段中剔除 + * (后端也配了同一个页面时,只在「工具」段出现一次) + * - 动态段为空(未登录 / 后端没配 / 拉取失败)时,结果就是纯粹的「工具」段 */ export function toHomeSections( nodes: EntryNode[], @@ -291,10 +294,7 @@ export function toHomeSections( const sections: EntrySection[] = [] const localKeys = new Set(LOCAL_COMMON_ENTRIES.map((leaf) => leaf.key)) - if (LOCAL_COMMON_ENTRIES.length) { - sections.push({ key: 'common', title: COMMON_SECTION_TITLE, leaves: LOCAL_COMMON_ENTRIES }) - } - + // ① 动态菜单段(未登录 / 拿不到菜单时为空) for (const section of toSections(nodes, options)) { const leaves = section.leaves.filter((leaf) => !localKeys.has(leaf.key)) // 整段都被本地列表覆盖 → 不渲染空标题 @@ -302,5 +302,10 @@ export function toHomeSections( sections.push({ ...section, leaves }) } + // ② 本地「工具」段:固定最后、固定存在 + if (LOCAL_COMMON_ENTRIES.length) { + sections.push({ key: 'tools', title: TOOLS_SECTION_TITLE, leaves: LOCAL_COMMON_ENTRIES }) + } + return sections } diff --git a/src/router/pages.ts b/src/router/pages.ts index f80c7c7..c93b085 100644 --- a/src/router/pages.ts +++ b/src/router/pages.ts @@ -42,15 +42,16 @@ export interface PageMeta { /** 是否不进导航入口(九宫格 / 功能菜单):可被跳转,但不作为入口展示 */ hidden?: boolean /** - * 是否进首页**本地**「常用功能」列表 + * 是否进首页**本地**「工具」列表 * * - **必须显式写 `common: true` 才会进**(不设置 = 不进) * - 该列表在 `router/entries.ts` 的 `LOCAL_COMMON_ENTRIES`,**与后端菜单无关**: - * 不受登录态 / 授权 / 接口故障 / 后端是否配置影响 → 用来常驻放测试页、公开页这类页面 + * 不受登录态 / 授权 / 接口故障 / 后端是否配置影响 → 「无论是否登录都会显示」 * - 后端 `miniprogram_pages` 只负责「登录后**还**能看到什么」, - * 在首页以**分类段**(如「外仓商品」)追加在「常用功能」之后;两处重复的 key 会自动去重 + * 在首页以**分类段**(如「外仓商品」)排在「工具」段**前面**;两处重复的 key 会自动去重 * - * ⚠️ `auth: 'public'` 的页面建议一并标 `common: true` —— 否则未登录时首页可能一个入口都没有 + * ⚠️ `auth: 'public'` 的页面请一并标 `common: true` —— 否则未登录时首页会没有任何入口 + *(微信审核要求「不能需登录才能看到任何内容」) */ common?: boolean } @@ -106,16 +107,28 @@ export const PAGE_REGISTRY: PageMeta[] = [ hidden: true }, - // ──────── 框架示例页(分包 pagesA):验证三态渲染与权限,业务页上线后可删 ──────── + // ─────────────── 工具(分包 pagesA):首页「工具」段,**不登录也能用** ─────────────── + // ⚠️ 这两页是「未登录也要有可浏览内容」这条微信审核要求的落点: + // 标了 `common: true` ⇒ 常驻首页「工具」段(不受登录态 / 后端菜单 / 接口故障影响), + // 位置固定在**动态菜单段之后**(见 entries.ts 的 `toHomeSections`)。 { - key: '/demo/public', - path: 'pagesA/demo/public', - title: '公开示例', - icon: 'info-circle', + key: '/tools/calculator', + path: 'pagesA/tools/calculator', + title: '计算器', + icon: 'grid', auth: 'public', - // 未登录也必须有可浏览内容(微信审核要求)→ 常驻首页「常用功能」 common: true }, + { + key: '/tools/barcode', + path: 'pagesA/tools/barcode', + title: '条形码', + icon: 'scan', + auth: 'public', + common: true + }, + + // ──────── 框架示例页(分包 pagesA):验证三态渲染与权限,业务页上线后可删 ──────── { key: '/demo/required', path: 'pagesA/demo/required', @@ -131,10 +144,12 @@ export const PAGE_REGISTRY: PageMeta[] = [ title: '测试页', icon: 'grid', auth: 'required', - // 常驻首页「常用功能」:不依赖后端菜单 / 授权,开发联调随时能进 - common: true - // 不设 hidden → 登录后后端菜单(wms_permission id=628)也会下发; - // 与本地列表重复,首页会自动去重(只显示一次) + // 2026-10-14 起**不在首页展示**,两处一起堵: + // - 去掉 `common: true` → 不再进本地「工具」段 + // - 加 `hidden: true` → 后端菜单(wms_permission id=628)下发了也不渲染入口 + // (只去掉 common 不够:登录后仍会由后端菜单那一侧冒出来) + // 需要联调时:微信开发者工具「编译模式」选「测试页」直接进(pages.json 的 condition 已保留) + hidden: true }, // ─────────────── 业务页(分包)─────────────── @@ -146,8 +161,20 @@ export const PAGE_REGISTRY: PageMeta[] = [ auth: 'required' // ⚠️ 后端 wms_permission 里这条记录的 path(type='miniprogram_pages') // 必须与上面的 key **逐字符相等**,否则入口会被忽略并进 permissionStore.missing + // 未设 common → 不进本地「工具」(它属于后端菜单那一侧) // 不设 hidden → 登录后由后端菜单下发才出现,首页以「外仓商品」**分类段**展示 - // 未设 common → 不进本地「常用功能」(它属于后端菜单那一侧) + }, + { + key: '/external-warehouse/list', + path: 'pagesA/external-warehouse/list', + title: '外部仓库', + icon: 'home', + auth: 'required' + // 对应后端 id=642(父节点 641「外部仓库」分类,2026-10-14 新增)—— 同样必须与 key 逐字符相等 + // 不设 hidden → 登录后由后端菜单下发才出现(未授权该页 id 的角色看不到) + // 未设 common → 不进本地「工具」(它属于后端菜单那一侧) + // 接口 storeWarehouse.warehouse.list(**货主侧**,与 new3 views/warehouses 同源), + // 见 api/warehouse/external-warehouse.ts }, { key: '/external-inventory/receiving', diff --git a/src/utils/barcode.ts b/src/utils/barcode.ts new file mode 100644 index 0000000..2a7cc93 --- /dev/null +++ b/src/utils/barcode.ts @@ -0,0 +1,126 @@ +/** + * Code 128(B 码集)编码 —— 把文本编码成「条 / 空 的模块宽度序列」 + * + * ⚠️ **为什么输出「宽度序列」而不是图片 / 位图**: + * 页面用 `view` 按**整数像素宽度**渲染(见 `pagesA/tools/barcode.vue`), + * 不需要画布、不需要异步 `canvas.draw()`,在 H5 与小程序端表现一致, + * 而且整数 CSS 像素 × 整数 dpr = 整数设备像素 ⇒ 条空边缘**不糊**(对扫码友好)。 + * 若将来要「保存成图片」,再在此序列之上补一层画布绘制即可(本文件不用改)。 + * + * 码集选择:**只用 B 码集**(覆盖 ASCII 32~126,即数字 / 大小写字母 / 常用符号), + * 不做 A/C 码集的自动切换 —— 仓储场景的条码(单号、库位、SKU 编码)都在这个范围内, + * 少一层「自动选码集」的逻辑就少一类线上问题。 + * + * 校验位算法(规范规定):`(104 + Σ 码值 × 位置) % 103`,位置从第 1 个数据字符开始计。 + */ + +/** 起始符:Code B */ +const START_B = 104 + +/** 停止符(7 个元素、共 13 个模块,比普通码字多一位) */ +const STOP_PATTERN = '2331112' + +/** + * 条空宽度表 —— **索引 = 码值**(0~105),每项 6 个数字 = 条/空交替的宽度。 + * 每项 6 个元素、合计 11 个模块;条空交替「以条开头」⇒ 相邻码字拼接后仍交替。 + */ +const PATTERNS: string[] = [ + '212222', '222122', '222221', '121223', '121322', '131222', '122213', '122312', + '132212', '221213', '221312', '231212', '112232', '122132', '122231', '113222', + '123122', '123221', '223211', '221132', '221231', '213212', '223112', '312131', + '311222', '321122', '321221', '312212', '322112', '322211', '212123', '212321', + '232121', '111323', '131123', '131321', '112313', '132113', '132311', '211313', + '231113', '231311', '112133', '112331', '132131', '113123', '113321', '133121', + '313121', '211331', '231131', '213113', '213311', '213131', '311123', '311321', + '331121', '312113', '312311', '332111', '314111', '221411', '431111', '111224', + '111422', '121124', '121421', '141122', '141221', '112214', '112412', '122114', + '122411', '142112', '142211', '241211', '221114', '413111', '241112', '134111', + '111242', '121142', '121241', '114212', '124112', '124211', '411212', '421112', + '421211', '212141', '214121', '412121', '111143', '111341', '131141', '114113', + '114311', '411113', '411311', '113141', '114131', '311141', '411131', '211412', + '211214', '211232' +] + +/** 编码失败原因(页面直接展示 `message`) */ +export class BarcodeError extends Error { + constructor(message: string) { + super(message) + this.name = 'BarcodeError' + } +} + +/** 一段**同色**的条(`black: true`)或空(`black: false`),`modules` = 模块数 */ +export interface BarcodeRun { + black: boolean + modules: number +} + +export interface BarcodeResult { + /** 原始内容(人眼可读,页面在条码下方原样显示) */ + text: string + /** 条空交替序列(不含左右静区,静区由页面按规范加 ≥10 个模块) */ + runs: BarcodeRun[] + /** 条 + 空的总模块数(不含静区) */ + modules: number + /** 码值序列(起始符 + 数据 + 校验位),排障用 */ + values: number[] +} + +/** 该字符能否用 Code128B 表达 */ +export function isEncodable(char: string): boolean { + const code = char.charCodeAt(0) + return code >= 32 && code <= 126 +} + +/** + * 把「每个元素一个数字」的宽度串压成同色游程 + * (元素序号为偶数的位置是**条**,因为每个码字都以条开头且元素个数为偶数) + */ +function toRuns(digits: string): BarcodeRun[] { + const runs: BarcodeRun[] = [] + + for (let i = 0; i < digits.length; i++) { + const modules = Number(digits[i]) + if (!modules) continue + + const black = i % 2 === 0 + const last = runs[runs.length - 1] + if (last && last.black === black) last.modules += modules + else runs.push({ black, modules }) + } + + return runs +} + +/** + * 生成 Code128B 条码 + * @throws {BarcodeError} 内容为空 / 含不支持的字符(如中文) + */ +export function encodeCode128(text: string): BarcodeResult { + const raw = text ?? '' + if (!raw) throw new BarcodeError('请先输入条码内容') + + const unsupported = Array.from(raw).find((char) => !isEncodable(char)) + if (unsupported) { + throw new BarcodeError(`Code128 不支持「${unsupported}」(仅数字、字母与常用符号)`) + } + + // 起始符 + 数据码值(Code B:码值 = ASCII - 32) + const values = [START_B, ...Array.from(raw).map((char) => char.charCodeAt(0) - 32)] + + // 校验位 = (起始符 + Σ 数据码值 × 位置) % 103,位置从 1 开始 + // reduce 里的 index 0 是起始符(权重 0),故起始符单独加在括号外 + const checksum = + (START_B + values.reduce((sum, value, index) => sum + value * index, 0)) % 103 + values.push(checksum) + + const digits = values.map((value) => PATTERNS[value]).join('') + STOP_PATTERN + const runs = toRuns(digits) + + return { + text: raw, + runs, + modules: runs.reduce((sum, run) => sum + run.modules, 0), + values + } +} diff --git a/src/utils/calculator.ts b/src/utils/calculator.ts new file mode 100644 index 0000000..d83b917 --- /dev/null +++ b/src/utils/calculator.ts @@ -0,0 +1,209 @@ +/** + * 计算器表达式求值(`pagesA/tools/calculator` 专用) + * + * ⚠️ **为什么不用 `eval` / `new Function`**: + * 1. 小程序运行环境里 `eval` 默认不可用(并会被代码审计拦截) + * 2. 把用户输入直接交给 `eval` 属于「任意代码执行」,是明确的安全红线 + * 所以这里手写一个**极小的递归下降解析器**,只认四则运算 + 括号 + 一元负号。 + * + * 文法(优先级由低到高): + * ``` + * expression := term (('+' | '-') term)* + * term := unary (('*' | '/') unary)* + * unary := ('+' | '-') unary | primary + * primary := number | '(' expression ')' + * ``` + * + * 页面按键产出的是**显示字符**(`×` `÷` `−`),`normalizeExpression()` 负责统一成 + * 解析器认识的 `*` `/` `-`;顺带把千分位逗号、全角符号、空白一并清掉 + *(用户从别处复制数字过来时最容易带上这些)。 + */ + +/** 求值失败的原因(页面直接展示 `message`,不需要再翻译) */ +export class CalcError extends Error { + constructor(message: string) { + super(message) + this.name = 'CalcError' + } +} + +/** 运算符号(页面按键显示的就是这几个字符,`normalizeExpression()` 再转换) */ +export const DISPLAY_OPERATORS = ['+', '-', '×', '÷'] + +/** 是否是页面按键产出的运算符显示字符 */ +export function isDisplayOperator(char: string): boolean { + return DISPLAY_OPERATORS.includes(char) +} + +/** + * 归一化:显示字符 → 解析字符,去掉一切空白与千分位逗号 + * + * 注意**不要**把英文字母 `x` 当乘号 —— 会误伤用户复制进来的内容。 + */ +export function normalizeExpression(input: string): string { + return (input ?? '') + .replace(/[×✕]/g, '*') + .replace(/÷/g, '/') + .replace(/[−–—]/g, '-') + .replace(/[.。]/g, '.') + .replace(/[,\s]/g, '') +} + +/** 递归下降解析器(只在本文件内使用) */ +class Parser { + private index = 0 + + constructor(private readonly text: string) {} + + parse(): number { + const value = this.parseExpression() + if (this.index < this.text.length) { + throw new CalcError(`无法识别「${this.text[this.index]}」`) + } + return value + } + + private parseExpression(): number { + let value = this.parseTerm() + + for (;;) { + const op = this.readOp(['+', '-']) + if (!op) return value + const right = this.parseTerm() + value = op === '+' ? value + right : value - right + } + } + + private parseTerm(): number { + let value = this.parseUnary() + + for (;;) { + const op = this.readOp(['*', '/']) + if (!op) return value + const right = this.parseUnary() + + if (op === '/') { + if (right === 0) throw new CalcError('除数不能为 0') + value /= right + } else { + value *= right + } + } + } + + private parseUnary(): number { + const op = this.readOp(['+', '-']) + if (op) { + const value = this.parseUnary() + return op === '-' ? -value : value + } + return this.parsePrimary() + } + + private parsePrimary(): number { + if (this.text[this.index] === '(') { + this.index++ + const value = this.parseExpression() + if (this.text[this.index] !== ')') throw new CalcError('括号没有闭合') + this.index++ + return value + } + return this.parseNumber() + } + + private parseNumber(): number { + const start = this.index + while (this.index < this.text.length && /[0-9.]/.test(this.text[this.index])) this.index++ + + const raw = this.text.slice(start, this.index) + // 空 / 只有小数点 / 多个小数点 → 都不是合法数字 + if (!raw || raw === '.' || raw.split('.').length > 2) { + throw new CalcError('表达式不完整') + } + + const value = Number(raw) + if (!Number.isFinite(value)) throw new CalcError('表达式有误') + return value + } + + private readOp(ops: string[]): string | null { + const char = this.text[this.index] + if (char && ops.includes(char)) { + this.index++ + return char + } + return null + } +} + +/** + * 去掉浮点误差:`0.1 + 0.2` 得到 `0.30000000000000004`, + * 这里按 12 位有效数字收敛回 `0.3`。 + */ +function fixFloat(value: number): number { + return Number(value.toPrecision(12)) +} + +/** + * 求值 + * @throws {CalcError} 表达式非法 / 除数为 0 / 结果溢出 + */ +export function evaluateExpression(input: string): number { + const text = normalizeExpression(input) + if (!text) throw new CalcError('表达式为空') + + const value = new Parser(text).parse() + if (!Number.isFinite(value)) throw new CalcError('结果超出可计算范围') + + return fixFloat(value) +} + +/** + * 求值(**不抛错**版本,供「边输入边预览」使用) + * @returns 可计算时返回结果,否则返回 `null` + */ +export function tryEvaluate(input: string): number | null { + try { + return evaluateExpression(input) + } catch { + return null + } +} + +/** + * 展示用格式化 + * + * - 整数部分加千分位(`1234567` → `1,234,567`),提升可读性 + * - 极大 / 极小的数改用科学计数法,避免出现 `0.000000000001` + * - ⚠️ 展示值**带逗号**,若要用它继续计算必须先 `normalizeExpression()` + * (页面里的「接着算」是把结果转成纯数字串再拼接,见 `calculator.vue`) + */ +export function formatNumber(value: number): string { + if (!Number.isFinite(value)) return '错误' + + const abs = Math.abs(value) + if (abs !== 0 && (abs >= 1e12 || abs < 1e-6)) { + // 1e+21 → "1e+21";1.230000e+3 → "1.23e+3" + return value + .toExponential(6) + .replace(/\.?0+e/, 'e') + .replace(/e\+?(-?)0*(\d)/, 'e$1$2') + } + + const [intPart, decimalPart] = String(value).split('.') + const sign = intPart.startsWith('-') ? '-' : '' + const digits = sign ? intPart.slice(1) : intPart + const grouped = digits.replace(/\B(?=(\d{3})+(?!\d))/g, ',') + + return decimalPart ? `${sign}${grouped}.${decimalPart}` : `${sign}${grouped}` +} + +/** + * 把「展示用」数值还原成可继续计算的纯数字串 + * @returns 无法还原时返回 `''`(页面据此放弃「接着算」,改为开新表达式) + */ +export function toPlainNumber(display: string): string { + const text = (display ?? '').replace(/,/g, '') + // 科学计数法(含 e)不参与后续拼接,避免解析器不认识 e + return /^[+-]?\d*\.?\d+$/.test(text) ? text : '' +} diff --git a/微信小程序开发清单.md b/微信小程序开发清单.md index eadb2bc..c6d02b3 100644 --- a/微信小程序开发清单.md +++ b/微信小程序开发清单.md @@ -29,7 +29,8 @@ | 静态路由表(阶段 1) | ✅ 已完成 | `src/router/pages.ts`:`PAGE_REGISTRY`(逻辑路径 → 物理页面 + `auth` 策略)+ `PAGE_MAP`;配置 `npm run check:pages` 一致性校验 | | 菜单/权限 store(阶段 2) | ✅ 已完成 | `src/router/entries.ts`(菜单 × 路由表 → 入口树)+ `store/modules/permission.ts`;`getInfo()` 触发时机收口到「登录成功 / 启动带 token / 切换身份」 | | 三态渲染组件(阶段 3) | ✅ 已完成 | `composables/usePageAuth.ts` + `components/auth-gate/`(public / optional / required)+ `components/empty-state/`(统一空态文案 + 重试);「去登录」收口到 `goLogin()` | -| 页面接入(阶段 4) | ✅ 已完成 | 首页九宫格改为 store 驱动(分组标题 + 子项两层渲染,空态走 `empty-state`);「我的」新增功能菜单;新增 `pagesA/demo/*` 两个示例页 | +| 页面接入(阶段 4) | ✅ 已完成 | 首页九宫格改为 store 驱动(分组标题 + 子项两层渲染,空态走 `empty-state`);「我的」新增功能菜单 | +| 首页入口分段(2026-10-14) | ✅ 已完成 | **动态菜单段(在前)+ 本地「工具」段(固定在后)**,合成逻辑在 `router/entries.ts` 的 `toHomeSections()`;「工具」段 = `common: true` 的页面(计算器 / 条形码),**与登录态、后端菜单、接口无关 ⇒ 未登录也一定显示**(微信审核要求)。已删除原 `pagesA/demo/public.vue`(被计算器页取代) | | 页面渲染框架 | 🚧 开发中(阶段 1、2、2.5、3、4 已完成) | 见第 12 节与《页面渲染框架-设计与任务清单.md》 | | 身份(角色/仓库)展示 | ✅ 已完成 | 「我的」页登录后显示:姓名 / 身份类型 / 所属组织 / 员工 ID / 授权到期;数据来自 `user.info` 的 `employees[]`,**不改数据库** | | 身份切换 `changeRole` | 🚧 已实现待联调 | 入口在「我的」页(多身份时出现);接口已实测存在,返回结构待后端确认 | @@ -150,14 +151,17 @@ d:\wechat\ ├── utils/ # 工具函数 │ ├── auth.ts # token 本地存取(唯一写入方) │ ├── auth-guard.ts # 登录跳转(LOGIN_PAGE / redirectToLogin,不做全局拦截) + │ ├── barcode.ts # Code128(B) 编码(输出条空宽度序列,供工具页渲染) + │ ├── calculator.ts # 四则运算求值(自写解析器,不用 eval) │ ├── navigate.ts # 统一跳转(自动区分 switchTab / navigateTo) │ └── request.ts # uni.request 封装 ├── pages/ # 主包页面(启动页 + tabBar 页) │ ├── login/login.vue # 登录 / 注册页(非启动页,仅 401 兜底 / 直接访问) - │ ├── index/index.vue # 首页(启动页):入口由 permissionStore / 本地公共清单驱动 + │ ├── index/index.vue # 首页(启动页):动态菜单段 + 本地「工具」段 │ └── mine/mine.vue # 我的 - ├── pagesA/ # 分包 A(已注册;当前放框架示例页) - │ └── demo/ # public.vue(公开示例)、required.vue(需登录 + 按钮级权限示例) + ├── pagesA/ # 分包 A(已注册) + │ ├── tools/ # 计算器 / 条形码(公共工具页,`common: true` → 首页「工具」段) + │ └── demo/ # required.vue(需登录 + 按钮级权限示例) ├── pagesB/ # 分包 B(规划:出库,待注册) ├── pagesC/ # 分包 C(规划:库存/盘点,待注册) └── static/ # 静态资源