This commit is contained in:
yin 2026-10-14 17:59:46 +08:00
parent e3f975e389
commit 03d8ed615a
15 changed files with 2410 additions and 137 deletions

View File

@ -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<string, any> {
const {
page = 1,
pageSize = EXTERNAL_WAREHOUSE_PAGE_SIZE,
keyword,
auth_status,
use_status
} = query
const body: Record<string, any> = { 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<BizResponse<ExternalWarehousePayload>> {
return request<ExternalWarehousePayload>({
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> | 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> | ExternalWarehousePayload | any
): ExternalWarehouseItem[] {
return pickPayload(res)?.list || []
}
/** 总数:后端放在 `pagination.total`(也可能在顶层 `total`) */
export function readTotal(
res: BizResponse<ExternalWarehousePayload> | 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<number, string> = {
1: '待审核',
2: '已通过',
3: '已拒绝',
4: '已解除',
5: '已过期'
}
/** 签约状态:色系(与 new3 `getAuthStatusType` 一致) */
const AUTH_STATUS_TONES: Record<number, StatusTone> = {
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)
}

View File

@ -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<boolean>
/** 页面直接 `v-for` 渲染的分段(段标题 + 九宫格) */
sections: ComputedRef<EntrySection[]>
/**
* 动态菜单段是否有内容
*
* 首页用它判断「已登录但菜单没拉回来」:此时「工具」段仍在,不白屏,
* 只需在那之下补一条轻量重试提示(不用大块空态盖住可用内容)。
*/
hasDynamicEntries: ComputedRef<boolean>
/** 是否正在拉取 `user.info` */
loading: Ref<boolean>
/**
@ -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<Record<string, unknown>>(() => {
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,

View File

@ -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"

View File

@ -27,7 +27,7 @@
</view>
</view>
<!-- 功能入口:本地「常用功能」列表 + 后端菜单分类段(两段形态一致,见 toHomeSections) -->
<!-- 功能入口:动态菜单分类段(在前)+ 本地「工具」段(在后,不登录也显示) -->
<view class="card">
<!-- 登录后菜单尚未取到时的骨架屏(避免闪一下空态文案,也比转圈更贴合最终布局) -->
<view v-if="loading" class="skeleton">
@ -37,14 +37,27 @@
</view>
</view>
<!-- 「常用功能」段(本地)+ 后端分类段(如「外仓商品」);重复的 key 会自动去重 -->
<entry-sections
v-else-if="sections.length"
:sections="sections"
@select="onEntry"
></entry-sections>
<!-- 入口分段:动态菜单段(在前,登录后才有)+ 本地「工具」段(固定在后,不登录也有) -->
<template v-else-if="sections.length">
<entry-sections :sections="sections" @select="onEntry"></entry-sections>
<!-- 兜底空态:正常走不到(「常用功能」至少有公开页),只要不白屏即可 -->
<!--
已登录、动态菜单却没回来(接口失败 / 后端未配)→ 只补一条**轻量重试**:
「工具」段照常可用,所以不用大块空态把页面盖住
-->
<view
v-if="showMenuError"
class="menu-error"
hover-class="menu-error--active"
:hover-stay-time="60"
@click="loadEntries(true)"
>
<up-icon name="error-circle" color="#e6a23c" size="15"></up-icon>
<text class="menu-error__text">业务功能列表加载失败,点此重试</text>
</view>
</template>
<!-- 兜底空态:只有「连本地工具段都为空」才会走到(正常配置下不出现),只保证不白屏 -->
<empty-state v-else v-bind="emptyStateProps" @retry="loadEntries(true)">
<!-- 未登录 → 去登录 -->
<template v-if="!isLogin" #action>
@ -70,7 +83,7 @@
</view>
<!-- 未登录:一句轻提示(不阻断浏览,只是说明登录后还能看到什么) -->
<view v-if="!isLogin" class="tip">登录后可查看仓库 / 货主等业务功能</view>
<view v-if="!isLogin" class="tip">登录以使用更多功能</view>
<!-- 运行信息:用于确认各端编译正常 -->
<!-- <view class="card">
@ -103,13 +116,34 @@ const userStore = useUserStore()
/**
* 入口区状态(与后端菜单解耦,见 `useEntrySections`)
*
* - 「常用功能」段 = **本地列表**(`PageMeta.common === true` 的页面:公开示例 + 测试页)
* → 不受登录态 / 授权 / 接口故障影响,开发联调随时能进测试页
* - 其后是后端菜单段(`user.info` 的 menus × `PAGE_REGISTRY`,如「外仓商品」分类)
* - 未登录时后端段为空,只剩下「常用功能」(公开页仍可浏览)
* - **动态菜单段**(在前)= `user.info` 的 menus × `PAGE_REGISTRY`(如「外仓商品」分类),
* 登录后才有;未登录 / 拉取失败 / 后端未配时为空
* - **本地「工具」段**(固定在后)= `PageMeta.common === true` 的页面(计算器 / 条形码),
* 不看登录态、不看接口 ⇒ **未登录也一定显示**
* (微信审核要求:不能出现「需登录才能看到任何内容」)
*/
const { isLogin, sections, loading, loadEntries, onEntry, goLogin, goMine, emptyStateProps } =
useEntrySections('public')
const {
isLogin,
sections,
hasDynamicEntries,
loading,
loadEntries,
onEntry,
goLogin,
goMine,
emptyStateProps
} = useEntrySections('public')
/**
* 是否显示「业务功能列表加载失败」提示
*
* 四个条件缺一不可:已登录 + 不在加载中 + 动态段为空 + 不是「微信已登录待绑账号」
*(未绑定账号时没有菜单是**预期行为**,不能当故障报)。
* 注意它**不阻断**工具段 —— 提示只是补在分段下方。
*/
const showMenuError = computed(
() => isLogin.value && !loading.value && !hasDynamicEntries.value && !userStore.isWechatUnbound
)
/** 按时间段问候(头部第一行,比写死的「首页」更有温度) */
const greeting = computed(() => {
@ -255,6 +289,25 @@ useEntryScene()
/* 段标题 + 九宫格的样式在 components/entry-sections(仅本页使用,勿在此重复定义) */
/* 动态菜单拉取失败时的轻量重试提示(工具段仍可用,故不盖大块空态) */
.menu-error {
display: flex;
align-items: center;
justify-content: center;
padding: 16rpx 32rpx 28rpx;
border-radius: 0 0 24rpx 24rpx;
&--active {
background-color: #fdf6ec;
}
&__text {
margin-left: 10rpx;
font-size: 24rpx;
color: #e6a23c;
}
}
/* 未登录时的底部轻提示 */
.tip {
margin-top: 48rpx;

View File

@ -46,7 +46,7 @@
* - 菜单里的细项(身份信息 / 待绑定 / 微信资料 / 电脑端登录码 / **退出登录**)全部移到
* 二级页 `pages/mine/user-info`,本页不再堆卡片
*
* ⚠️ 功能入口(九宫格)统一放在**首页** = 本地「常用功能」列表 + 后端菜单分类段;
* ⚠️ 功能入口(九宫格)统一放在**首页** = 后端菜单分类段 + 本地「工具」段;
* 本页不再渲染页面列表(2026-09-25 调整)。
*/
import { computed } from 'vue'

View File

@ -1,70 +0,0 @@
<template>
<view class="page">
<view class="card">
<up-cell-group :border="false">
<up-cell title="登录状态" :value="isLogin ? '已登录' : '未登录'" :border="false"></up-cell>
<up-cell title="页面策略" value="public(无需登录)" :border="false"></up-cell>
</up-cell-group>
</view>
<view class="card">
<view class="card__title">这页验证什么</view>
<view class="text">
它在 PAGE_REGISTRY 里声明为 auth: 'public' 且
<text class="text--strong">common: true</text>,因此会出现在首页
<text class="text--strong">「常用功能」段</text>里(LOCAL_COMMON_ENTRIES),**未登录也能看到**。
</view>
<!-- <view class="text">
这正是「未登录也必须有可浏览内容」这条微信审核要求的落点:
「常用功能」由前端本地清单决定,不依赖后端菜单是否配置。
</view> -->
</view>
</view>
</template>
<script setup lang="ts">
/**
* 框架示例页:`public`(公共页面)
*
* ⚠️ 这是「页面渲染框架」的示例页,业务页上线后可直接删除
* (删除时同步清理:pages.json 的 subPackages、PAGE_REGISTRY、condition)。
*/
import { usePageAuth } from '@/composables/usePageAuth'
const { isLogin } = usePageAuth('public')
</script>
<style lang="scss" scoped>
.page {
min-height: 100vh;
background-color: #f5f6fa;
padding-top: 24rpx;
}
.card {
margin: 0 24rpx 24rpx;
padding: 8rpx 0;
background-color: #ffffff;
border-radius: 16rpx;
overflow: hidden;
&__title {
padding: 24rpx 32rpx 8rpx;
font-size: 30rpx;
font-weight: 600;
color: #303133;
}
}
.text {
padding: 8rpx 32rpx 16rpx;
font-size: 26rpx;
line-height: 1.7;
color: #606266;
&--strong {
color: #2979ff;
font-weight: 600;
}
}
</style>

View File

@ -0,0 +1,585 @@
<template>
<view class="page">
<!-- required 未登录:页内「请先登录」+ 去登录,**不自动跳转** -->
<auth-gate auth="required">
<template #default>
<!-- 筛选区(吸顶):关键词 + 搜索;签约状态 / 使用状态用胶囊唤起底部选择器 -->
<view class="filter">
<view class="filter__row">
<view class="filter__input">
<up-input
v-model="form.keyword"
color="#303133"
placeholder-style="color: #c0c4cc"
placeholder="搜索仓库名 / 备注"
prefix-icon="search"
border="none"
clearable
confirm-type="search"
@confirm="onSearch"
></up-input>
</view>
<up-button
type="primary"
shape="circle"
size="small"
text="搜索"
@click="onSearch"
></up-button>
</view>
<view class="filter__row filter__row--chips">
<view
class="chip"
:class="{ 'chip--active': isFilled(form.auth_status) }"
@click="openPicker('auth')"
>
<text class="chip__text">{{ authLabel }}</text>
<up-icon
name="arrow-down"
size="12"
:color="isFilled(form.auth_status) ? '#2979ff' : '#909399'"
></up-icon>
</view>
<view
class="chip"
:class="{ 'chip--active': isFilled(form.use_status) }"
@click="openPicker('use')"
>
<text class="chip__text">{{ useLabel }}</text>
<up-icon
name="arrow-down"
size="12"
:color="isFilled(form.use_status) ? '#2979ff' : '#909399'"
></up-icon>
</view>
<view v-if="hasFilter" class="filter__reset" @click="onReset">重置</view>
</view>
</view>
<!-- 首屏加载(翻页时保留旧列表,只把分页器置为「加载中…」,避免整屏闪动) -->
<view v-if="loading && !list.length" class="loading">
<up-loading-icon mode="circle" size="18" text="加载中"></up-loading-icon>
</view>
<template v-else-if="list.length">
<!-- 签约仓库卡片:小程序只展示 new3 表格里最关键的 7 个字段 -->
<view v-for="(item, index) in list" :key="item.id ?? index" class="wh">
<view class="wh__head">
<view class="wh__name">{{ warehouseNameOf(item) }}</view>
<view v-if="counterpartyRealNameOf(item)" class="wh__real">
({{ counterpartyRealNameOf(item) }})
</view>
<!-- 右上角:使用状态(启用 / 禁用)——「签约状态」已挪到卡片下方 -->
<view
class="wh__use"
:class="isEnabled(item) ? 'wh__use--success' : 'wh__use--info'"
>
{{ useStatusText(item) }}
</view>
</view>
<view class="wh__line">
<text class="wh__label">货主备注</text>
<text class="wh__value">{{ storeRemarkOf(item) }}</text>
</view>
<view class="wh__tags">
<view
class="tag"
:class="item.counterparty_role === 'warehouse' ? 'tag--role' : 'tag--role-owner'"
>
{{ counterpartyRoleLabel(item) }}
</view>
<view v-if="needsMyConfirm(item)" class="tag tag--warning">待我确认</view>
</view>
<view class="wh__foot">
<view class="wh__foot-item">
<text class="wh__label">签约状态</text>
<text class="wh__value" :class="`wh__value--${authStatusTone(item)}`">
{{ authStatusLabel(item) }}
</text>
</view>
<view class="wh__foot-item">
<text class="wh__label">面单余额</text>
<text class="wh__num">{{ printQuantityText(item) }}</text>
</view>
</view>
</view>
</template>
<!-- 空态:无数据 / 加载失败(有筛选条件时文案不同) -->
<empty-state v-else v-bind="emptyStateProps" @retry="loadPage(1)"></empty-state>
</template>
</auth-gate>
<!-- 分页器(固定底部,与外仓商品 / 收货单同一个组件) -->
<page-pager
v-if="list.length"
:total="total"
:page="pageNo"
:page-size="EXTERNAL_WAREHOUSE_PAGE_SIZE"
:loading="loading"
unit="个仓库"
@change="goPage"
></page-pager>
<!-- 选择器(签约状态 / 使用状态):底部弹层,同一组件复用于两个维度 -->
<option-picker
:show="pickerVisible"
:title="pickerTitle"
:options="pickerOptions"
:value="pickerValue"
@select="chooseOption"
@close="closePicker"
></option-picker>
<!-- 登录抽屉:点「去登录」或碰需要登录的接口时就地弹出(不跳页) -->
<auth-modal></auth-modal>
</view>
</template>
<script setup lang="ts">
/**
* 外部仓库(签约仓库列表)
*
* 接口与 new3 Web 端 `views/warehouses/index.vue`(「外部仓库」页)**同源**
* (`storeWarehouse.warehouse.list`,见 `api/warehouse/external-warehouse.ts`),
* 但交互按**移动端**重做:
*
* | Web 端 | 小程序端(本页) |
* |---|---|
* | 高级筛选字段树 + 工具栏(刷新 / 显示详情 / 发起签约 / 导出日志) | 顶部固定筛选区:关键词 + 签约状态 / 使用状态(只留只读筛选,**本页不做写操作**) |
* | 表格 11 列(含 仓库ID / 奇门配置 / 授权截止 / 操作) | 卡片,只展示 签约仓库 / 货主备注 / 对方角色 / 签约状态 / 待确认 / 使用状态 / 面单余额 |
* | 下半个「签约详情」面板 + 操作日志 | 不做(移动端一屏放不下,需要时再进二级页) |
* | 底部页码 / 每页条数 / 跳页 | **固定底部分页器**(与外仓商品页同款组件) |
* | 刷新按钮 | 下拉刷新(`enablePullDownRefresh`) |
*
* 默认筛选 `use_status = 1`(只看启用),与 new3 的 `initial-conditions` 一致。
*
* ⚠️ 三条必须保持一致,改任意一处都要同步另两处(`npm run check:pages` 会校验):
* 1. 本文件的物理路径 `pagesA/external-warehouse/list`
* 2. `src/pages.json` 里 `subPackages[pagesA]` 的注册
* 3. `src/router/pages.ts` 的 `PAGE_REGISTRY`(key = 后端 `wms_permission.path`)
*/
import { computed, reactive, ref, watch } from 'vue'
import { onLoad, onPullDownRefresh } from '@dcloudio/uni-app'
import { usePageAuth } from '@/composables/usePageAuth'
import AuthModal from '@/components/auth-modal/auth-modal.vue'
import OptionPicker from '@/components/option-picker/option-picker.vue'
import PagePager from '@/components/page-pager/page-pager.vue'
import {
AUTH_STATUS_OPTIONS,
EXTERNAL_WAREHOUSE_PAGE_SIZE,
USE_STATUS_OPTIONS,
authStatusLabel,
authStatusTone,
counterpartyRealNameOf,
counterpartyRoleLabel,
externalWarehouseList,
isEnabled,
needsMyConfirm,
printQuantityText,
readRows,
readTotal,
storeRemarkOf,
useStatusText,
warehouseNameOf
} from '@/api/warehouse/external-warehouse'
import type { ExternalWarehouseItem } from '@/api/warehouse/external-warehouse'
/** 本页是 required:未登录时只做页内提示,不自动跳登录 */
const { isLogin } = usePageAuth('required')
/** 默认只看「启用」的签约关系(对齐 new3 的初始条件) */
const DEFAULT_USE_STATUS = 1
/** 筛选条件(关键词回车 / 点搜索才生效,避免每输入一个字就请求) */
const form = reactive({
keyword: '',
/** 签约状态:'' = 全部 */
auth_status: '' as string | number,
/** 使用状态:1 启用 / 0 禁用 / '' 全部 */
use_status: DEFAULT_USE_STATUS as string | number
})
const list = ref<ExternalWarehouseItem[]>([])
/** 后端总数(「共 N 个」与总页数都靠它) */
const total = ref(0)
/** 当前页码(1-based) */
const pageNo = ref(1)
const loading = ref(false)
const isFilled = (value: unknown): boolean =>
value !== undefined && value !== null && value !== ''
/** 是否偏离了默认条件(只有偏离时才给「重置」,否则按钮是多余的) */
const hasFilter = computed(
() =>
!!form.keyword.trim() ||
isFilled(form.auth_status) ||
form.use_status !== DEFAULT_USE_STATUS
)
/** 总页数(按固定每页条数算;总数 0 时也算 1 页,避免出现「第 1/0 页」) */
const pageCount = computed(() =>
Math.max(1, Math.ceil(total.value / EXTERNAL_WAREHOUSE_PAGE_SIZE))
)
/** 翻页后回到顶部(否则新一页会从上一页的滚动位置继续,看着像没动) */
const scrollToTop = (): void => {
uni.pageScrollTo({ scrollTop: 0, duration: 0 })
}
/**
* 拉取指定页(**整页替换**,不做追加 —— 分页由底部页码控件驱动)
* @param target 目标页码(1-based),越界自动夹到 `[1, pageCount]`
*/
const loadPage = async (target = pageNo.value): Promise<void> => {
if (!isLogin.value) return
if (loading.value) return
// 未知总数时(首屏)先不夹上界,拿到 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 externalWarehouseList({
page,
pageSize: EXTERNAL_WAREHOUSE_PAGE_SIZE,
keyword: form.keyword,
auth_status: form.auth_status,
use_status: form.use_status
})
list.value = readRows(res)
total.value = readTotal(res)
pageNo.value = page
} catch {
// 失败提示由 request 层统一 toast;这里保留原页与旧数据(不把用户用到空白页)
} finally {
loading.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 => {
reloadFirstPage()
}
const onReset = (): void => {
form.keyword = ''
form.auth_status = ''
form.use_status = DEFAULT_USE_STATUS
authLabel.value = '签约状态'
useLabel.value = '启用'
reloadFirstPage()
}
/** 下拉刷新:重拉当前页;若当前页已越界(总数变少)则回到第 1 页 */
const refresh = async (): Promise<void> => {
await loadPage(pageNo.value)
if (!list.value.length && pageNo.value > 1) await loadPage(1)
}
// ── 签约状态 / 使用状态 选择器(底部弹层,一个组件复用于两个维度)──
type PickerKind = 'auth' | 'use'
const pickerVisible = ref(false)
const pickerKind = ref<PickerKind>('auth')
const PICKER_TITLES: Record<PickerKind, string> = {
auth: '选择签约状态',
use: '选择使用状态'
}
/**
* 胶囊上显示的名称
*
* 未选中时显示的是**筛选项名**(签约状态),选中后显示具体值(已通过 / 启用)。
* 使用状态默认就是「启用」,所以它一开始就显示值。
*/
const authLabel = ref('签约状态')
const useLabel = ref('启用')
const pickerTitle = computed(() => PICKER_TITLES[pickerKind.value])
const pickerOptions = computed(() =>
pickerKind.value === 'auth' ? AUTH_STATUS_OPTIONS : USE_STATUS_OPTIONS
)
const pickerValue = computed(() =>
pickerKind.value === 'auth' ? form.auth_status : form.use_status
)
const openPicker = (kind: PickerKind): void => {
pickerKind.value = kind
pickerVisible.value = true
}
const closePicker = (): void => {
pickerVisible.value = false
}
const chooseOption = (option: { value: string | number; label: string }): void => {
// 选中「全部」时,胶囊回到**筛选项名**(而不是「全部」这种字样)
if (pickerKind.value === 'auth') {
form.auth_status = option.value
authLabel.value = isFilled(option.value) ? option.label : '签约状态'
} else {
form.use_status = option.value
useLabel.value = isFilled(option.value) ? option.label : '使用状态'
}
closePicker()
reloadFirstPage()
}
/** 空态文案:有筛选条件时不能用「服务器出差了」这种口气 */
const emptyStateProps = computed(() =>
hasFilter.value ? { text: '没有符合条件的仓库,试试换个关键词或筛选条件' } : {}
)
// ── 生命周期 ──
onLoad(() => {
loadPage(1)
})
// 未登录进来是空态(页内有登录引导);登录成功后自动拉一次
watch(isLogin, (value) => {
if (value && !list.value.length) loadPage(1)
})
// 下拉刷新:重拉当前页
onPullDownRefresh(() => {
refresh()
})
</script>
<style lang="scss" scoped>
.page {
min-height: 100vh;
background-color: #f5f6fa;
/* 给固定底部的分页器留位置(分页器只有一行,约 72rpx),否则最后一张卡会被盖住 */
padding-bottom: 140rpx;
}
/* 筛选区:吸顶。部分低版本基础库不支持 sticky 就退化为普通块,不影响使用 */
.filter {
position: sticky;
top: 0;
z-index: 10;
padding: 16rpx 24rpx 12rpx;
background-color: #ffffff;
border-bottom: 1rpx solid #ebeef5;
&__row {
display: flex;
align-items: center;
&--chips {
margin-top: 8rpx;
flex-wrap: wrap;
}
}
&__input {
flex: 1;
/* flex 子项里的输入框必须允许收缩,否则长占位符会把搜索按钮挤出去 */
min-width: 0;
margin-right: 16rpx;
padding: 0 20rpx;
background-color: #f5f6fa;
border-radius: 999rpx;
}
&__reset {
padding: 8rpx 8rpx 8rpx 16rpx;
font-size: 24rpx;
color: #2979ff;
}
}
.chip {
display: flex;
align-items: center;
max-width: 320rpx;
margin: 4rpx 16rpx 4rpx 0;
padding: 10rpx 20rpx;
background-color: #f5f6fa;
border-radius: 999rpx;
&--active {
background-color: rgba(41, 121, 255, 0.1);
}
&__text {
margin-right: 6rpx;
font-size: 24rpx;
color: #606266;
/* 长仓库名/状态名过长时省略,避免把箭头挤出胶囊 */
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
}
.loading {
display: flex;
justify-content: center;
padding: 120rpx 0;
}
/* ── 签约仓库卡片 ── */
.wh {
margin: 20rpx 24rpx 0;
padding: 24rpx 28rpx;
background-color: #ffffff;
border-radius: 16rpx;
&__head {
display: flex;
align-items: center;
flex-wrap: wrap;
}
&__name {
max-width: 420rpx;
font-size: 30rpx;
font-weight: 600;
color: #303133;
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
&__real {
font-size: 24rpx;
color: #909399;
}
/* 使用状态推到最右,一眼能扫到(卡片里唯一「该不该用」的开关态) */
&__use {
margin-left: auto;
padding: 4rpx 14rpx;
border-radius: 999rpx;
font-size: 22rpx;
&--success {
color: #19be6b;
background-color: rgba(25, 190, 107, 0.12);
}
&--info {
color: #909399;
background-color: #f2f3f5;
}
}
&__line {
display: flex;
align-items: center;
margin-top: 16rpx;
}
&__label {
flex: none;
margin-right: 16rpx;
font-size: 24rpx;
color: #909399;
}
&__value {
flex: 1;
min-width: 0;
font-size: 26rpx;
color: #606266;
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
/* 签约状态用色阶区分(与右上角「使用状态」互补:那边管「用不用」,这边管「签成没签成」) */
&--warning {
color: #e6a23c;
}
&--success {
color: #19be6b;
}
&--danger {
color: #f56c6c;
}
&--info {
color: #909399;
}
}
&__tags {
display: flex;
align-items: center;
flex-wrap: wrap;
margin-top: 16rpx;
}
/* 底部一行两列:左「签约状态」/ 右「面单余额」 */
&__foot {
display: flex;
align-items: center;
justify-content: space-between;
margin-top: 16rpx;
padding-top: 16rpx;
border-top: 1rpx solid #f2f3f5;
}
&__foot-item {
display: flex;
align-items: baseline;
/* 可伸缩的 flex 子项要允许收缩,否则超长状态名会把右边那列挤出去 */
min-width: 0;
}
/* 面单余额:数字用等宽感更强的字号与色,方便扫读 */
&__num {
font-size: 32rpx;
font-weight: 600;
color: #303133;
}
}
.tag {
margin: 0 12rpx 0 0;
padding: 4rpx 14rpx;
border-radius: 6rpx;
font-size: 22rpx;
&--role {
color: #2979ff;
background-color: rgba(41, 121, 255, 0.12);
}
&--role-owner {
color: #e6a23c;
background-color: rgba(230, 162, 60, 0.12);
}
&--warning {
color: #e6a23c;
background-color: rgba(230, 162, 60, 0.12);
}
}
</style>

View File

@ -172,7 +172,7 @@
<script setup lang="ts">
/**
* 测试页 —— 验证「后端 miniprogram_pages → 首页常用功能入口」整条链路
* 测试页 —— 验证「后端 miniprogram_pages → 首页动态菜单入口」整条链路
*
* 对应 `wms_permission` id = 628(type='miniprogram_pages',path='/test/index')。
* 已加入 `pages.json` 的 `condition`,微信开发者工具「编译模式」可直达。

View File

@ -0,0 +1,367 @@
<template>
<view class="page">
<!-- 内容输入 -->
<view class="card">
<view class="field__label">条码内容</view>
<view class="field__input">
<up-input
v-model="content"
color="#303133"
placeholder-style="color: #c0c4cc"
placeholder="数字 / 字母 / 常用符号"
:maxlength="MAX_LENGTH"
border="none"
clearable
></up-input>
</view>
<view class="field__hint">
码制 Code128(B),最长 {{ MAX_LENGTH }} 个字符;
<text class="field__hint--warn">不支持中文</text>
</view>
<view class="actions">
<view class="actions__item">
<up-button
type="primary"
shape="circle"
size="small"
text="复制内容"
@click="copyContent"
></up-button>
</view>
<view class="actions__item">
<up-button
:plain="true"
type="primary"
shape="circle"
size="small"
text="示例"
@click="useSample"
></up-button>
</view>
<view class="actions__item">
<up-button
:plain="true"
type="info"
shape="circle"
size="small"
text="清空"
@click="reset"
></up-button>
</view>
</view>
</view>
<!-- 条码预览 -->
<view class="card card--preview">
<!-- 出错 / 未输入:明确指引,不白屏 -->
<view v-if="encoded.error" class="preview__tip">
<up-icon name="error-circle" color="#f56c6c" size="18"></up-icon>
<text class="preview__tip-text preview__tip-text--error">{{ encoded.error }}</text>
</view>
<view v-else-if="!encoded.data" class="preview__tip">
<up-icon name="scan" color="#c0c4cc" size="40"></up-icon>
<text class="preview__tip-text">输入内容后自动生成条码</text>
</view>
<template v-else>
<!--
条码本体:**用 view 按整数像素宽度拼**,不用画布 ——
整数 CSS 像素 × 整数 dpr = 整数设备像素,条空边缘不糊(对扫码友好),
且无需 canvas 的异步绘制 / 页面实例,H5 与小程序端表现一致。
⚠️ 横向 padding(静区)放在**内层**:微信端 scroll-view 的横向 padding 只对左侧生效。
-->
<scroll-view class="barcode" scroll-x :style="{ height: `${barHeight}px` }">
<view
class="barcode__inner"
:style="{
width: `${layout.width}px`,
height: `${barHeight}px`,
'padding-left': `${layout.quiet}px`,
'padding-right': `${layout.quiet}px`
}"
>
<view
v-for="run in runs"
:key="run.id"
class="barcode__run"
:class="{ 'barcode__run--black': run.black }"
:style="{ width: `${run.modules * layout.module}px` }"
></view>
</view>
</scroll-view>
<!-- HRI:条码下方的人眼可读文本(仓库单据习惯对一下单号) -->
<view class="hri">{{ encoded.data.text }}</view>
<view class="meta">
<text class="meta__item">Code128(B)</text>
<text class="meta__dot">·</text>
<text class="meta__item">{{ encoded.data.text.length }} 字符</text>
<text class="meta__dot">·</text>
<text class="meta__item">{{ encoded.data.modules }} 模块</text>
<text class="meta__dot">·</text>
<text class="meta__item">模块宽 {{ layout.module }}px</text>
</view>
<view v-if="layout.scroll" class="meta__hint">
条码比屏幕宽(保持可扫清晰度)→ 可左右滑动查看完整条码
</view>
</template>
</view>
<view class="foot">条码内容仅在本机生成,不会上传服务器</view>
</view>
</template>
<script setup lang="ts">
/**
* 工具 · 条形码生成器(Code128B)
*
* 定位:现场贴标 / 对单 —— 把单号、库位、SKU 编码变成**屏幕上可扫**的条码,
* 并支持把内容复制到别处(如手持终端、打印软件)。
*
* 设计取舍:
* - **公共页**(`auth: 'public'`、`common: true`):不用登录,也让「未登录有可浏览内容」有落点
* - 编码全在本地(`utils/barcode.ts`),**不发任何请求** → 断网可用、也不涉及数据合规
* - 渲染用 `view` 拼条空(整数像素),不用画布:不糊、无异步、两端一致(详见模板里的注释)
* - 模块宽度**不低于 2px**:放不下时改为横向滚动,而不是继续压缩(压缩到 1px 就扫不出来了)
*/
import { computed, ref } from 'vue'
import { BarcodeError, encodeCode128 } from '@/utils/barcode'
import type { BarcodeResult } from '@/utils/barcode'
/** 内容长度上限:Code128 每字符 11 个模块,太长会密到看不出条空 */
const MAX_LENGTH = 30
/** 左右静区(规范要求 ≥ 10 个模块,缺了扫码枪很难定位起止符) */
const QUIET_MODULES = 10
/** 模块宽度档位(px) */
const MODULE_PREFERRED = 2
const MODULE_MAX = 4
/** 初始给一个示例,进页面即可看到效果(可一键清空) */
const SAMPLE = 'WMS-20261014'
const content = ref(SAMPLE)
const windowWidth = uni.getSystemInfoSync().windowWidth || 375
/** rpx → px:本条码的宽度计算**必须用 px**(条空宽度要是整数像素) */
const rpx2px = (value: number): number => (value * windowWidth) / 750
/** 可用宽度 = 屏宽 −(页面左右 24rpx + 卡片左右 32rpx) */
const availableWidth = Math.max(
120,
Math.floor(windowWidth - rpx2px(24) * 2 - rpx2px(32) * 2)
)
/** 编码结果(或错误文案) */
const encoded = computed<{ data: BarcodeResult | null; error: string }>(() => {
const text = content.value.trim()
if (!text) return { data: null, error: '' }
try {
return { data: encodeCode128(text), error: '' }
} catch (err) {
return {
data: null,
error: err instanceof BarcodeError ? err.message : '无法生成条码'
}
}
})
/**
* 版面计算
*
* - 放得下 → 撑到合适宽度(上限 4px,太粗反而不利于扫码)
* - 放不下 → 保持 2px 模块并**横向滚动**(`scroll: true`)
*/
const layout = computed(() => {
const data = encoded.value.data
if (!data) {
return { module: MODULE_PREFERRED, width: 0, quiet: 0, total: 0, scroll: false }
}
const total = data.modules + QUIET_MODULES * 2
const fit = Math.floor(availableWidth / total)
const module = fit >= MODULE_PREFERRED ? Math.min(fit, MODULE_MAX) : MODULE_PREFERRED
return {
module,
width: total * module,
quiet: QUIET_MODULES * module,
total,
scroll: total * module > availableWidth
}
})
/** 条高:跟随屏宽,太矮不好扫、太高占屏 */
const barHeight = computed(() =>
Math.round(Math.min(160, Math.max(88, availableWidth * 0.32)))
)
/** 渲染用游程(带 `id` 作 key —— 微信端 key 必须唯一,用下标最稳) */
const runs = computed(() =>
(encoded.value.data?.runs ?? []).map((run, index) => ({ id: index, ...run }))
)
function copyContent(): void {
const text = encoded.value.data?.text ?? content.value.trim()
if (!text) return
uni.setClipboardData({
data: text,
fail: () => uni.$u.toast('复制失败')
})
}
function useSample(): void {
content.value = SAMPLE
}
function reset(): void {
content.value = ''
}
</script>
<style lang="scss" scoped>
.page {
min-height: 100vh;
padding: 24rpx 0 48rpx;
background-color: #f5f6fa;
}
.card {
margin: 0 24rpx 24rpx;
padding: 32rpx;
background-color: #ffffff;
border-radius: 24rpx;
box-shadow: 0 8rpx 24rpx rgba(41, 121, 255, 0.06);
/* 预览卡:条码区必须白底黑条,不跟随暗色主题 */
&--preview {
background-color: #ffffff;
}
}
.field {
&__label {
font-size: 28rpx;
font-weight: 600;
color: #303133;
}
&__input {
margin-top: 12rpx;
padding: 8rpx 20rpx;
background-color: #f7f8fa;
border-radius: 16rpx;
}
&__hint {
margin-top: 12rpx;
font-size: 24rpx;
color: #909399;
&--warn {
color: #e6a23c;
}
}
}
.actions {
display: flex;
align-items: center;
margin-top: 24rpx;
/* 按钮之间留间距(uview 按钮自身没有外边距) */
&__item {
margin-right: 16rpx;
}
}
.preview {
&__tip {
display: flex;
flex-direction: column;
align-items: center;
padding: 64rpx 24rpx;
}
&__tip-text {
margin-top: 16rpx;
font-size: 26rpx;
color: #909399;
text-align: center;
&--error {
margin-top: 16rpx;
color: #f56c6c;
}
}
}
.barcode {
width: 100%;
/* 允许子项超出后横向滚动:内容不换行 + 内层 inline-flex */
white-space: nowrap;
background-color: #ffffff;
&__inner {
display: inline-flex;
align-items: stretch;
flex-shrink: 0;
box-sizing: border-box;
}
&__run {
flex-shrink: 0;
height: 100%;
background-color: #ffffff;
&--black {
background-color: #000000;
}
}
}
.hri {
margin-top: 16rpx;
font-size: 26rpx;
color: #303133;
text-align: center;
letter-spacing: 2rpx;
word-break: break-all;
}
.meta {
display: flex;
align-items: center;
justify-content: center;
flex-wrap: wrap;
margin-top: 20rpx;
&__item {
font-size: 22rpx;
color: #a8abb2;
}
&__dot {
margin: 0 10rpx;
font-size: 22rpx;
color: #dcdfe6;
}
&__hint {
margin-top: 12rpx;
font-size: 22rpx;
color: #e6a23c;
text-align: center;
}
}
.foot {
margin-top: 32rpx;
font-size: 24rpx;
color: #a8abb2;
text-align: center;
}
</style>

View File

@ -0,0 +1,617 @@
<template>
<view class="page">
<!-- 整屏一列:显示区在顶部(固定),键盘吃满下方剩余高度 —— 符合「上面看、下面按」的持机姿势 -->
<view class="layout">
<!-- 显示区:算式 + 结果(按 = 后出终值,未按前给「≈」实时预览) -->
<view class="display">
<!-- 算式:右对齐;长算式自动缩字号并最多两行,避免把键盘挤小 -->
<text
class="display__expr"
:class="{ 'display__expr--long': expressionLong }"
>{{ expression || '0' }}</text>
<view class="display__row">
<text v-if="errorText" class="display__error">{{ errorText }}</text>
<template v-else-if="shownResult">
<!-- 左侧占位:把「= 结果」推到右边贴齐,短结果不会飘到屏幕左侧 -->
<view class="display__spacer"></view>
<text class="display__op">{{ justEvaluated ? '=' : '≈' }}</text>
<text
class="display__value"
:class="{
'display__value--final': justEvaluated,
'display__value--long': resultLong
}"
>{{ shownResult }}</text>
<view
v-if="canCopy"
class="display__copy"
hover-class="display__copy--active"
:hover-stay-time="60"
@click="copyResult"
>
<text class="display__copy-text">复制</text>
</view>
</template>
<text v-else class="display__idle">输入算式,按 = 得到结果</text>
</view>
</view>
<!--
键盘:5 行 × 4 列
高度**不写死 rpx** —— 行用 `flex: 1` 均分剩余空间、按键填满格子,
这样任何屏高下都是「铺满下半屏的大按键」,小屏也不会被压成一条;
大拇指能够到的位置放最常用的(数字 / = / +)
-->
<view class="keypad">
<view v-for="(row, rowIndex) in KEY_ROWS" :key="rowIndex" class="keypad__row">
<view v-for="key in row" :key="key.label" class="keypad__cell">
<view
class="key"
:class="`key--${key.kind}`"
hover-class="key--active"
:hover-stay-time="40"
@click="press(key)"
@longpress="onLongPress(key)"
>
<up-icon
v-if="key.kind === 'backspace'"
name="backspace"
color="#4b5563"
size="24"
></up-icon>
<text v-else class="key__label">{{ key.label }}</text>
</view>
</view>
</view>
</view>
<!-- 底部说明同时承载「安全区留白」:全面屏的横条不会压在按键上 -->
<view class="foot">支持 + − × ÷ 与括号,最多 {{ MAX_LENGTH }} 个字符</view>
</view>
</view>
</template>
<script setup lang="ts">
/**
* 工具 · 计算器
*
* 定位:仓储现场常用的「凑数」工具(算体积 / 重量 / 金额),所以:
* - **公共页**(`auth: 'public'`、`common: true`):不用登录就能用,
* 也让「未登录也有可浏览内容」这条微信审核要求有个真实落点
* - **不依赖任何接口**:纯本地运算,断网也能用(现场信号差是常态)
*
* 求值全部走 `utils/calculator.ts`(自己写的解析器,**不用 `eval`**,见该文件注释)。
*/
import { computed, ref } from 'vue'
import {
CalcError,
evaluateExpression,
formatNumber,
isDisplayOperator,
toPlainNumber,
tryEvaluate
} from '@/utils/calculator'
type KeyKind = 'digit' | 'dot' | 'op' | 'paren' | 'clear' | 'backspace' | 'equal'
interface CalcKey {
/** 键面文案,同时用作 `v-for` 的 key(**必须唯一**,微信端 key 重复会丢行) */
label: string
kind: KeyKind
/** 点击后追加到算式里的字符(`clear` / `backspace` / `equal` 不需要) */
value?: string
}
/**
* 键盘布局:**按行**声明(5 行 × 4 列)
*
* 为什么按行而不是一维数组:行是 `flex: 1` 的等高容器,高度由屏幕剩余空间决定,
* 一维数组只能依赖 `width: 25%` 换行,高度还得写死 rpx(小屏会被压扁)。
*/
const KEY_ROWS: CalcKey[][] = [
[
{ label: 'C', kind: 'clear' },
{ label: '⌫', kind: 'backspace' },
{ label: '(', kind: 'paren', value: '(' },
{ label: ')', kind: 'paren', value: ')' }
],
[
{ label: '7', kind: 'digit', value: '7' },
{ label: '8', kind: 'digit', value: '8' },
{ label: '9', kind: 'digit', value: '9' },
{ label: '÷', kind: 'op', value: '÷' }
],
[
{ label: '4', kind: 'digit', value: '4' },
{ label: '5', kind: 'digit', value: '5' },
{ label: '6', kind: 'digit', value: '6' },
{ label: '×', kind: 'op', value: '×' }
],
[
{ label: '1', kind: 'digit', value: '1' },
{ label: '2', kind: 'digit', value: '2' },
{ label: '3', kind: 'digit', value: '3' },
{ label: '−', kind: 'op', value: '-' }
],
[
{ label: '0', kind: 'digit', value: '0' },
{ label: '.', kind: 'dot', value: '.' },
{ label: '=', kind: 'equal' },
{ label: '+', kind: 'op', value: '+' }
]
]
/** 算式长度上限:超过就不再接受输入(防止极端长串把解析与展示都拖垮) */
const MAX_LENGTH = 40
/** 正在编辑的算式(显示字符,如 `1+2×3`) */
const expression = ref('')
/** 按「=」得到的结果(**展示用**,带千分位) */
const resultText = ref('')
/** 结果的可续算形式(纯数字串;科学计数法等无法续算时为空串) */
const resultPlain = ref('')
/** 求值失败的原因 */
const errorText = ref('')
/** 是否刚按过「=」(决定结果是「终值」还是「预览值」) */
const justEvaluated = ref(false)
/** 边输入边预览:算不出来就**不显示**(不报错,避免打断输入) */
const preview = computed(() => {
const value = tryEvaluate(expression.value)
return value === null ? '' : formatNumber(value)
})
const shownResult = computed(() => (justEvaluated.value ? resultText.value : preview.value))
const canCopy = computed(() => Boolean(shownResult.value) && !errorText.value)
/** 算式超过 16 个字符就缩字号(尽量让算式保持在两行内,不把键盘挤小) */
const expressionLong = computed(() => expression.value.length > 16)
/** 结果去掉千分位与小数点后超过 9 位就缩字号(移动端屏窄,长数字必须让位) */
const resultLong = computed(() => shownResult.value.replace(/[,.]/g, '').length > 9)
/** 按键轻震动反馈(部分环境不支持 → 静默忽略) */
function feedback(): void {
try {
uni.vibrateShort({ fail: () => {} })
} catch {
/* 忽略:震动只是体感增强,失败不影响输入 */
}
}
/** 重置到初始态(「C」键) */
function reset(): void {
expression.value = ''
resultText.value = ''
resultPlain.value = ''
errorText.value = ''
justEvaluated.value = false
}
/**
* 刚按过「=」时继续操作:
* - 按运算符 → **从结果接着算**(`1+1=` → `2`,再按 `×3` → `2×3`)
* - 按数字 / 左括号 → **开一个新算式**(不把结果拼在数字后面)
*/
function resumeFromResult(char: string): void {
if (!justEvaluated.value) return
const plain = resultPlain.value
justEvaluated.value = false
resultText.value = ''
expression.value = isDisplayOperator(char) && plain ? plain : ''
}
/** 追加一个字符(含各种非法组合的过滤,保证算式始终是「半合法」的) */
function input(char: string): void {
errorText.value = ''
resumeFromResult(char)
const text = expression.value
// ── 运算符 ──
if (isDisplayOperator(char)) {
const last = text.slice(-1)
if (!text) {
// 空算式只允许以负号开头(如「−5」)
if (char === '-') expression.value = char
return
}
if (isDisplayOperator(last)) {
const prev = text.slice(-2, -1)
// `-` 作「下一个数的符号」用时(如 `3×-` / `(-`),替换运算符要把它一起删掉
const unaryMinus =
last === '-' && (prev === '' || prev === '(' || isDisplayOperator(prev))
const head = unaryMinus ? text.slice(0, -2) : text.slice(0, -1)
// 没有可替换的内容(空算式按运算符 / `-` 再按运算符)→ 不接受这次输入,避免造出非法算式
if (!head) {
expression.value = ''
return
}
// 左括号后面只允许负号(`(-` 合法,`(+` 不合法)
if (head.slice(-1) === '(' && char !== '-') return
expression.value = head + char
return
}
// 左括号 / 小数点后面不能直接跟运算符
if (last === '(' || last === '.') return
expression.value = text + char
return
}
// ── 小数点 ──
if (char === '.') {
// 取「正在输入的那个数」的片段,一个数里只允许一个小数点
const current = /[0-9.]*$/.exec(text)?.[0] ?? ''
if (current.includes('.')) return
if (!current) {
// 左边是空 / `(` / 运算符 → 补前导 0(`.5` 记作 `0.5`)
if (text && !/[+(×÷-]$/.test(text)) return
if (text.length >= MAX_LENGTH) return
expression.value = `${text}0.`
return
}
expression.value = text + '.'
return
}
// ── 左括号 ──
if (char === '(') {
// 不做隐式乘法:`3(` / `)(` 直接忽略(避免用户以为能算)
if (/[0-9.)]$/.test(text)) return
if (text.length >= MAX_LENGTH) return
expression.value = text + '('
return
}
// ── 右括号 ──
if (char === ')') {
// 左边必须是数字或右括号,且存在未配对的左括号
if (!/[0-9)]$/.test(text)) return
const openCount = (text.match(/\(/g) ?? []).length
const closeCount = (text.match(/\)/g) ?? []).length
if (openCount <= closeCount) return
if (text.length >= MAX_LENGTH) return
expression.value = text + ')'
return
}
// ── 数字 ──
if (text.length >= MAX_LENGTH) return
// 右括号后面直接接数字 → 忽略(同样不做隐式乘法)
if (text.slice(-1) === ')') return
// 独立的 `0` 后面再按数字 → 顶掉这个 0(`0` → `5`,而不是 `05`)
if (/(?:^|[^\d.])0$/.test(text)) {
expression.value = text.slice(0, -1) + char
return
}
expression.value = text + char
}
/** 退格:出结果后按退格 → 回到可编辑态(结果区换回实时预览) */
function backspace(): void {
errorText.value = ''
justEvaluated.value = false
resultText.value = ''
expression.value = expression.value.slice(0, -1)
}
/** 求值(「=」键) */
function evaluate(): void {
if (!expression.value) return
try {
const text = formatNumber(evaluateExpression(expression.value))
resultText.value = text
resultPlain.value = toPlainNumber(text)
errorText.value = ''
justEvaluated.value = true
} catch (err) {
// 错误文案由 utils 给出(如「除数不能为 0」「括号没有闭合」),页面不重复翻译
resultText.value = ''
resultPlain.value = ''
errorText.value = err instanceof CalcError ? err.message : '表达式有误'
justEvaluated.value = false
}
}
function press(key: CalcKey): void {
feedback()
switch (key.kind) {
case 'clear':
reset()
break
case 'backspace':
backspace()
break
case 'equal':
evaluate()
break
default:
input(key.value ?? '')
}
}
/**
* 长按 ⌫ = 一键清空(移动端惯例:长按比连点快)
*
* 与 `press()` 的先后顺序无所谓:即使长按后 click 也跟着触发,
* 此时表达式已被清空,`backspace()` 是空操作 ⇒ 结果仍然是「清空」。
* (注:真机上是微信的 bindlongpress;H5 用鼠标点不出来,需触摸设备验)
*/
function onLongPress(key: CalcKey): void {
if (key.kind !== 'backspace') return
feedback()
reset()
}
/** 复制结果(不带千分位,方便直接粘到别的输入框里) */
function copyResult(): void {
const text = resultPlain.value || shownResult.value.replace(/,/g, '')
if (!text) return
uni.setClipboardData({
data: text,
fail: () => uni.$u.toast('复制失败')
})
}
</script>
<style lang="scss" scoped>
/* 整页 = 一列:显示区(顶部、固定)+ 键盘(下方、吃满剩余高度) */
.page {
display: flex;
flex-direction: column;
/* 高度取父级(page)的 100%,不要用 100vh !见文件末尾非 scoped 的说明 */
height: 100%;
/* border-box:高度里要含住内边距与安全区,否则会多出一条滚动 */
box-sizing: border-box;
background-color: #f5f6fa;
}
.layout {
display: flex;
flex-direction: column;
flex: 1;
min-height: 0;
width: 100%;
/* H5 / 平板这类宽屏下不让计算器拉得太宽(小程序端永远窄屏) */
max-width: 480px;
margin: 0 auto;
padding: 24rpx 24rpx 0;
}
.display {
flex-shrink: 0;
display: flex;
flex-direction: column;
padding: 32rpx;
background-color: #ffffff;
border-radius: 24rpx;
box-shadow: 0 8rpx 24rpx rgba(41, 121, 255, 0.06);
/* 算式:右对齐 + 可折行;最多两行(再多就裁掉),长算式自动缩字号 */
&__expr {
max-height: 3em;
overflow: hidden;
font-size: 40rpx;
color: #909399;
text-align: right;
line-height: 1.4;
word-break: break-all;
&--long {
font-size: 32rpx;
}
}
&__row {
display: flex;
align-items: center;
min-height: 72rpx;
margin-top: 12rpx;
}
/* 左侧占位:把内容推到右侧(flex 子项默认 min-width: auto,需显式置 0) */
&__spacer {
flex: 1;
min-width: 0;
}
/* 运算符前缀:「≈」预览 / 「=」终值 */
&__op {
flex-shrink: 0;
margin-right: 12rpx;
font-size: 34rpx;
color: #c0c4cc;
}
&__value {
flex-shrink: 1;
/* flex 子项默认 min-width: auto,长数字会把容器撑破 */
min-width: 0;
font-size: 44rpx;
color: #606266;
text-align: right;
word-break: break-all;
&--final {
font-size: 56rpx;
font-weight: 600;
color: #2979ff;
}
/* 结果很长时缩字号 + 允许断行,否则会横向顶出屏幕(移动端必做) */
&--long {
font-size: 40rpx;
}
}
&__error {
flex: 1;
min-width: 0;
font-size: 28rpx;
color: #f56c6c;
text-align: right;
}
&__idle {
flex: 1;
min-width: 0;
font-size: 26rpx;
color: #c0c4cc;
text-align: right;
}
&__copy {
flex-shrink: 0;
display: flex;
align-items: center;
margin-left: 16rpx;
padding: 8rpx 18rpx;
border-radius: 999rpx;
background-color: #eef4ff;
&--active {
background-color: #dfeaff;
}
&-text {
margin-left: 6rpx;
font-size: 24rpx;
color: #2979ff;
}
}
}
/* 键盘:5 行均分剩余高度,每行 4 个等宽格子(用 flex 而非百分比高度,屏高自适应更稳) */
.keypad {
flex: 1;
display: flex;
flex-direction: column;
/* 兜底:按键不能被压到按不动;真放不下时由整页滚动接管 */
min-height: 460rpx;
margin-top: 24rpx;
&__row {
flex: 1;
display: flex;
min-height: 0;
}
&__cell {
flex: 1;
display: flex;
min-width: 0;
padding: 6rpx;
/* 小程序里 view 默认 content-box */
box-sizing: border-box;
}
}
.key {
flex: 1;
display: flex;
align-items: center;
justify-content: center;
/* 触控目标高度由行高决定(≈ 下半屏 / 5);这里只给个最小值兜底 */
min-height: 88rpx;
border-radius: 20rpx;
background-color: #ffffff;
box-shadow: 0 2rpx 8rpx rgba(15, 23, 42, 0.06);
&__label {
font-size: 44rpx;
color: #303133;
}
/* 点按反馈(hover-class 指向本类,scoped 下可用) */
&--active {
background-color: #e8eefc;
}
/* 运算符:浅蓝底 + 蓝字 */
&--op {
background-color: #eef4ff;
box-shadow: none;
.key__label {
font-size: 48rpx;
color: #2979ff;
}
}
/* 括号 / 小数点:灰字弱化 */
&--paren,
&--dot {
.key__label {
color: #606266;
}
}
/* 清空:暖色提示「这是危险键」 */
&--clear {
background-color: #fff2e8;
box-shadow: none;
.key__label {
font-size: 40rpx;
color: #ff7d29;
}
}
/* 退格:只放图标(底色要跟数字键一致,否则会与页面背景融成「缺一块」的观感) */
&--backspace {
background-color: #ffffff;
}
/* 等号:主色实心,最显眼(也在大拇指最好按的右下区域) */
&--equal {
background-color: #2979ff;
box-shadow: 0 6rpx 16rpx rgba(41, 121, 255, 0.28);
.key__label {
font-size: 48rpx;
font-weight: 600;
color: #ffffff;
}
}
}
.foot {
flex-shrink: 0;
padding: 16rpx 0 24rpx;
/* 底部安全区:iPhone 全面屏的横条别压在按键上 */
padding-bottom: calc(24rpx + env(safe-area-inset-bottom));
font-size: 22rpx;
color: #a8abb2;
text-align: center;
}
</style>
<style lang="scss">
/*
* 让整页铺满「导航栏以下的可用高度」
*
* ⚠️ 两条硬约束(都实测过):
* 1. **不能写在 scoped 里**:scoped 会给选择器补 `[data-v-x]`,而小程序的 `page`
* 根元素没有这个属性,整条规则会被丢掉 → 页面塔成内容高度,键盘就撑不满了
* 2. **不能用 `100vh` 代替**:可用高度 = 屏幕高 − 导航栏,写 100vh 会多出导航栏那一条(
* H5 实测多出 44px),整页凭空多出滚动
*/
page {
height: 100%;
}
</style>

View File

@ -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
}

View File

@ -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',

126
src/utils/barcode.ts Normal file
View File

@ -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
}
}

209
src/utils/calculator.ts Normal file
View File

@ -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 : ''
}

View File

@ -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/ # 静态资源