1
This commit is contained in:
parent
6ea0718371
commit
c943b98c4b
@ -6,3 +6,10 @@
|
||||
# 注意:小程序真机与线上由微信服务端校验域名白名单且必须 HTTPS,
|
||||
# 本地联调依赖 manifest.json → mp-weixin.setting.urlCheck = false(仅影响开发者工具)
|
||||
VITE_APP_BASE_API = 'http://192.168.11.56:6060/'
|
||||
|
||||
# 请求头 platform:后端 /system 网关会校验,非白名单值直接返回 HTTP 400(响应体为空)
|
||||
# 实测白名单:web / app / wx / miniProgram(**大小写不敏感**,mp-weixin / h5 / mp / mobile 等被拒)
|
||||
VITE_APP_PLATFORM = 'miniProgram'
|
||||
|
||||
# 请求头 project:后端同样校验(实测白名单:all / wms)
|
||||
VITE_APP_PROJECT = 'all'
|
||||
|
||||
@ -4,3 +4,8 @@
|
||||
# ⚠️ 上线前必须替换为正式域名,并在「微信公众平台 → 开发管理 → 开发设置 → 服务器域名」
|
||||
# 把该域名加入 request 合法域名白名单(必须 HTTPS、证书有效,不能是 IP 或非标准端口)
|
||||
VITE_APP_BASE_API = 'https://qimen.wms.gztbyc.com/'
|
||||
|
||||
# 请求头 platform / project:后端网关切学校验,非白名单值直接 HTTP 400
|
||||
# ⚠️ 上线前需与后端确认正式环境支持的值(开发环境实测:web / app / wx / miniProgram,大小写不敏感)
|
||||
VITE_APP_PLATFORM = 'miniProgram'
|
||||
VITE_APP_PROJECT = 'all'
|
||||
|
||||
@ -34,7 +34,8 @@
|
||||
"build:quickapp-webview": "uni build -p quickapp-webview",
|
||||
"build:quickapp-webview-huawei": "uni build -p quickapp-webview-huawei",
|
||||
"build:quickapp-webview-union": "uni build -p quickapp-webview-union",
|
||||
"type-check": "vue-tsc --noEmit"
|
||||
"type-check": "vue-tsc --noEmit",
|
||||
"check:pages": "node scripts/check-pages.mjs"
|
||||
},
|
||||
"dependencies": {
|
||||
"@dcloudio/uni-app": "3.0.0-5020420260813003",
|
||||
|
||||
193
scripts/check-pages.mjs
Normal file
193
scripts/check-pages.mjs
Normal file
@ -0,0 +1,193 @@
|
||||
/**
|
||||
* 静态路由表一致性校验(`npm run check:pages`)
|
||||
*
|
||||
* 校验三件事:
|
||||
* 1. `PAGE_REGISTRY[].path` 必须真实存在于 `src/pages.json`(含 subPackages)
|
||||
* 2. `PAGE_REGISTRY[].key` 不能重复
|
||||
* 3. `pages.json` 里已注册但没有登记进 `PAGE_REGISTRY` 的页面 → 告警(不阻断)
|
||||
*
|
||||
* 为什么需要:小程序页面必须在 `pages.json` **编译期**注册,
|
||||
* 一旦静态路由表与 `pages.json` 漂移,用户点入口就会跳转失败(且只在真机上才暴露)。
|
||||
*
|
||||
* 注意:本脚本用正则从 `src/router/pages.ts` 提取条目(Node 无法直接 import .ts),
|
||||
* 因此 `PAGE_REGISTRY` 的条目请保持「一个字面量对象 + 单引号」的写法,
|
||||
* 注释掉的示例条目(整行 `//` 开头)会被自动忽略。
|
||||
*/
|
||||
|
||||
import { readFileSync } from 'node:fs'
|
||||
import { fileURLToPath } from 'node:url'
|
||||
import { join } from 'node:path'
|
||||
|
||||
const ROOT = fileURLToPath(new URL('..', import.meta.url))
|
||||
const PAGES_JSON = join(ROOT, 'src/pages.json')
|
||||
const REGISTRY_TS = join(ROOT, 'src/router/pages.ts')
|
||||
|
||||
/**
|
||||
* 去掉 JSON 里的 `//` 与块注释
|
||||
* 按字符状态机处理(尊重字符串字面量),避免把 `"http://..."` 里的 `//` 当注释切掉
|
||||
*/
|
||||
function stripJsonComments(text) {
|
||||
let out = ''
|
||||
let inString = false
|
||||
let inLine = false
|
||||
let inBlock = false
|
||||
|
||||
for (let i = 0; i < text.length; i++) {
|
||||
const c = text[i]
|
||||
const next = text[i + 1]
|
||||
|
||||
if (inLine) {
|
||||
if (c === '\n') {
|
||||
inLine = false
|
||||
out += c
|
||||
}
|
||||
continue
|
||||
}
|
||||
if (inBlock) {
|
||||
if (c === '*' && next === '/') {
|
||||
inBlock = false
|
||||
i++
|
||||
}
|
||||
continue
|
||||
}
|
||||
if (inString) {
|
||||
out += c
|
||||
if (c === '\\') {
|
||||
out += next ?? ''
|
||||
i++
|
||||
} else if (c === '"') {
|
||||
inString = false
|
||||
}
|
||||
continue
|
||||
}
|
||||
if (c === '"') {
|
||||
inString = true
|
||||
out += c
|
||||
} else if (c === '/' && next === '/') {
|
||||
inLine = true
|
||||
i++
|
||||
} else if (c === '/' && next === '*') {
|
||||
inBlock = true
|
||||
i++
|
||||
} else {
|
||||
out += c
|
||||
}
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
/** 收集 pages.json 中所有已注册的页面物理路径 */
|
||||
function collectRegisteredPaths(pagesJson) {
|
||||
const registered = new Set()
|
||||
for (const page of pagesJson.pages ?? []) {
|
||||
if (page?.path) registered.add(page.path)
|
||||
}
|
||||
// 分包字段官方写法是 subPackages(写成 subpackages 无效,这里只为兼容提示)
|
||||
const subPackages = pagesJson.subPackages ?? pagesJson.subpackages ?? []
|
||||
for (const sub of subPackages) {
|
||||
const root = String(sub?.root ?? '').replace(/\/$/, '')
|
||||
for (const page of sub?.pages ?? []) {
|
||||
if (page?.path) registered.add(`${root}/${page.path}`)
|
||||
}
|
||||
}
|
||||
return registered
|
||||
}
|
||||
|
||||
/** 从 src/router/pages.ts 里提取 PAGE_REGISTRY 的字面量条目 */
|
||||
function collectRegistryEntries(source) {
|
||||
// 整行注释(含被注释掉的示例条目)先剔除,否则会被当成真条目
|
||||
const code = source
|
||||
.split(/\r?\n/)
|
||||
.filter((line) => !/^\s*(\/\/|\*|\/\*)/.test(line))
|
||||
.join('\n')
|
||||
|
||||
const start = code.indexOf('PAGE_REGISTRY')
|
||||
if (start === -1) return null
|
||||
|
||||
const open = code.indexOf('[', start)
|
||||
if (open === -1) return null
|
||||
|
||||
// 数组以「行首的 ]」结束
|
||||
const close = code.indexOf('\n]', open)
|
||||
const block = close === -1 ? code.slice(open) : code.slice(open, close)
|
||||
|
||||
const entries = []
|
||||
for (const match of block.matchAll(/\{([^{}]*)\}/g)) {
|
||||
const body = match[1]
|
||||
const key = /key:\s*'([^']+)'/.exec(body)?.[1]
|
||||
const path = /path:\s*'([^']+)'/.exec(body)?.[1]
|
||||
if (key && path) entries.push({ key, path })
|
||||
}
|
||||
return entries
|
||||
}
|
||||
|
||||
const errors = []
|
||||
const warnings = []
|
||||
|
||||
// ── 读取 pages.json ──
|
||||
let pagesJson
|
||||
try {
|
||||
pagesJson = JSON.parse(stripJsonComments(readFileSync(PAGES_JSON, 'utf8')))
|
||||
} catch (err) {
|
||||
console.error(`✖ 解析 src/pages.json 失败:${err.message}`)
|
||||
process.exit(1)
|
||||
}
|
||||
const registered = collectRegisteredPaths(pagesJson)
|
||||
|
||||
// ── 读取 PAGE_REGISTRY ──
|
||||
let source
|
||||
try {
|
||||
source = readFileSync(REGISTRY_TS, 'utf8')
|
||||
} catch (err) {
|
||||
console.error(`✖ 读取 src/router/pages.ts 失败:${err.message}`)
|
||||
process.exit(1)
|
||||
}
|
||||
const entries = collectRegistryEntries(source)
|
||||
|
||||
if (!entries || entries.length === 0) {
|
||||
console.error(
|
||||
'✖ 未能从 src/router/pages.ts 解析出任何 PAGE_REGISTRY 条目。\n' +
|
||||
' 请确认条目仍是「字面量对象 + 单引号」写法(key: \'...\' / path: \'...\')。'
|
||||
)
|
||||
process.exit(1)
|
||||
}
|
||||
|
||||
// ── 校验 1:path 必须已在 pages.json 注册 ──
|
||||
for (const entry of entries) {
|
||||
if (!registered.has(entry.path)) {
|
||||
errors.push(
|
||||
`PAGE_REGISTRY 的 "${entry.key}" 指向 "${entry.path}",但 src/pages.json 中未注册该页面`
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
// ── 校验 2:key 不能重复 ──
|
||||
const seen = new Map()
|
||||
for (const entry of entries) {
|
||||
if (seen.has(entry.key)) {
|
||||
errors.push(`PAGE_REGISTRY 中存在重复的 key:"${entry.key}"`)
|
||||
}
|
||||
seen.set(entry.key, entry)
|
||||
}
|
||||
|
||||
// ── 校验 3:pages.json 有、但没登记进 PAGE_REGISTRY(仅告警) ──
|
||||
const registeredPaths = new Set(entries.map((entry) => entry.path))
|
||||
for (const path of registered) {
|
||||
if (!registeredPaths.has(path)) {
|
||||
warnings.push(`src/pages.json 已注册 "${path}",但 PAGE_REGISTRY 未登记(无法被菜单映射/按 auth 渲染)`)
|
||||
}
|
||||
}
|
||||
|
||||
// ── 输出 ──
|
||||
for (const warn of warnings) console.warn(`⚠ ${warn}`)
|
||||
for (const error of errors) console.error(`✖ ${error}`)
|
||||
|
||||
if (errors.length > 0) {
|
||||
console.error(`\n✖ 静态路由表校验失败:${errors.length} 个错误,${warnings.length} 个告警`)
|
||||
process.exit(1)
|
||||
}
|
||||
|
||||
console.log(
|
||||
`✔ 静态路由表校验通过:PAGE_REGISTRY ${entries.length} 条,` +
|
||||
`pages.json 已注册 ${registered.size} 个页面,${warnings.length} 个告警`
|
||||
)
|
||||
18
src/App.vue
18
src/App.vue
@ -1,11 +1,21 @@
|
||||
<script setup lang="ts">
|
||||
import { onLaunch, onShow, onHide } from "@dcloudio/uni-app";
|
||||
import { setupAuthGuard } from "@/utils/auth-guard";
|
||||
import { useUserStore } from "@/store/modules/user";
|
||||
import { getToken } from "@/utils/auth";
|
||||
|
||||
onLaunch(() => {
|
||||
// 注册全局跳转拦截:未登录时任何页面跳转都会被拦到登录页
|
||||
// 等价于 new3(Web 端)在 router.beforeEach 里做的登录准入
|
||||
setupAuthGuard();
|
||||
// ⚠️ 这里**不要**做「未登录就跳登录页」的判断。
|
||||
// 微信审核要求:打开小程序不能直接强制登录,登录入口必须由用户主动触发
|
||||
// (本项目放在「我的」页的「登录 / 注册」按钮)。
|
||||
// 登录态兜底统一由 utils/request.ts 在收到 HTTP 401 时处理(带来源页跳登录)。
|
||||
|
||||
// 启动时若本地已有 token(上次登录且未失效)→ 统一拉一次用户信息,
|
||||
// 让首页九宫格 / 「我的」在进入任何页面之前就拿到 menus + permissions。
|
||||
// 失败不提示:token 真失效时由 request 层的 401 兜底(清登录态 + 带 redirect 跳登录)。
|
||||
if (!getToken()) return;
|
||||
useUserStore()
|
||||
.getInfo()
|
||||
.catch(() => {});
|
||||
});
|
||||
onShow(() => {
|
||||
console.log("App Show");
|
||||
|
||||
@ -1,2 +0,0 @@
|
||||
接口层:按业务模块拆分的接口定义
|
||||
request.ts 为请求实例(拦截器 / 统一错误处理),见开发清单第 5 节
|
||||
@ -42,10 +42,51 @@ export interface UserLoginResult {
|
||||
[key: string]: any
|
||||
}
|
||||
|
||||
/** 切换身份(角色 / 仓库)入参 */
|
||||
export interface UserChangeRoleParams {
|
||||
/** 目标身份 ID = `user.info` 的 `employees[].id` */
|
||||
roleId: number
|
||||
/** 端标记,小程序端固定 mobile */
|
||||
device?: string
|
||||
}
|
||||
|
||||
/** 切换身份返回:后端可能换发 token 并回传 user(与 new3 一致) */
|
||||
export interface UserChangeRoleResult {
|
||||
token?: string
|
||||
user?: UserInfoResult
|
||||
[key: string]: any
|
||||
}
|
||||
|
||||
/**
|
||||
* 员工身份 —— `user.info` 返回的 `data.employees[]`
|
||||
*
|
||||
* 一个账号可能同时属于多个货主 / 仓库,每个身份一条记录。
|
||||
* 切换身份时把 `id` 作为 `roleId` 传给 `user.changeRole`(见《页面渲染框架》§4.2)。
|
||||
*/
|
||||
export interface EmployeeInfo {
|
||||
/** 员工身份 ID(切换身份用) */
|
||||
id: number
|
||||
/** 所属货主 / 仓库 ID */
|
||||
store_id: number
|
||||
/** 所属货主 / 仓库名称 */
|
||||
store_name: string
|
||||
/** 该身份下的真实姓名 */
|
||||
real_name: string
|
||||
/** 是否主身份:1 = 是 */
|
||||
is_primary?: number | string
|
||||
/** 授权到期日;null / 空 表示长期有效 */
|
||||
auth_end?: string | null
|
||||
/** 身份类型:warehouse(仓库)/ store(货主)等 */
|
||||
role_type?: string
|
||||
[key: string]: any
|
||||
}
|
||||
|
||||
/** 用户信息:后端字段随业务扩展,此处只声明稳定字段,其余用索引签名兜住 */
|
||||
export interface UserInfoResult {
|
||||
employees_id?: number
|
||||
employees_name?: string
|
||||
/** 该账号的全部可用身份 */
|
||||
employees?: EmployeeInfo[]
|
||||
permissions?: string[]
|
||||
/** 后端菜单树,供后续「页面渲染框架」生成路由使用 */
|
||||
menus?: any[]
|
||||
@ -84,6 +125,23 @@ export function getInfo(data: Record<string, any> = {}): Promise<BizResponse<Use
|
||||
})
|
||||
}
|
||||
|
||||
/**
|
||||
* 切换当前身份(角色 / 仓库)
|
||||
*
|
||||
* 入参 `roleId` = `user.info` 的 `employees[].id`(已确认,见《页面渲染框架》§4.2)。
|
||||
* 返回可能包含换发后的 `token` 与 `user`;**调用方需重调 `user.info`** 刷新菜单 / 权限。
|
||||
*/
|
||||
export function changeRole(
|
||||
data: UserChangeRoleParams
|
||||
): Promise<BizResponse<UserChangeRoleResult>> {
|
||||
return request<UserChangeRoleResult>({
|
||||
url: SYSTEM_URL,
|
||||
method: 'POST',
|
||||
params: gatewayParams('user.changeRole'),
|
||||
data
|
||||
})
|
||||
}
|
||||
|
||||
/** 退出登录 */
|
||||
export function logout(data: Record<string, any> = {}): Promise<BizResponse<any>> {
|
||||
return request({
|
||||
|
||||
@ -1,2 +0,0 @@
|
||||
全局自定义组件:easycom 自动扫描
|
||||
注意:必须符合「组件名/组件名.vue」目录结构才会被扫描到,页面中无需 import
|
||||
110
src/components/auth-gate/auth-gate.vue
Normal file
110
src/components/auth-gate/auth-gate.vue
Normal file
@ -0,0 +1,110 @@
|
||||
<template>
|
||||
<!-- public / 已登录:直接渲染页面内容 -->
|
||||
<slot v-if="mode === 'content'"></slot>
|
||||
|
||||
<!-- optional 未登录:优先用页面自定义的占位,没传则落到下面的内置引导 -->
|
||||
<slot v-else-if="mode === 'guest' && $slots.guest" name="guest"></slot>
|
||||
|
||||
<!-- required 未登录 / optional 未登录(无自定义占位):页内提示,**不自动跳转** -->
|
||||
<view v-else class="auth-gate">
|
||||
<view class="auth-gate__icon">
|
||||
<up-icon :name="copy.icon" color="#c0c4cc" size="48"></up-icon>
|
||||
</view>
|
||||
<view class="auth-gate__title">{{ copy.title }}</view>
|
||||
<view class="auth-gate__desc">{{ copy.desc }}</view>
|
||||
<view class="auth-gate__action">
|
||||
<up-button
|
||||
type="primary"
|
||||
shape="circle"
|
||||
:text="copy.action"
|
||||
@click="goLogin"
|
||||
></up-button>
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
/**
|
||||
* 页面三态渲染容器(`public` / `optional` / `required`)
|
||||
*
|
||||
* 用法:
|
||||
* ```vue
|
||||
* <auth-gate auth="required">
|
||||
* <template #default><!-- 已登录内容 --></template>
|
||||
* </auth-gate>
|
||||
*
|
||||
* <auth-gate auth="optional">
|
||||
* <template #default><!-- 已登录内容 --></template>
|
||||
* <template #guest><!-- 未登录占位,不传则用内置引导 --></template>
|
||||
* </auth-gate>
|
||||
* ```
|
||||
*
|
||||
* 说明:`public` 与 `optional` 都属于「公共页面」(不会被拦截),
|
||||
* 区别只是未登录时 `optional` 渲染引导占位。
|
||||
* 内置引导同时覆盖两种文案(`required` → 请先登录;`optional` → 登录后查看),
|
||||
* 因此**不再单独建 `guest-placeholder` 组件**(少一个组件,效果一致)。
|
||||
*/
|
||||
|
||||
import { computed } from 'vue'
|
||||
import { usePageAuth } from '@/composables/usePageAuth'
|
||||
import type { AuthMode } from '@/router/pages'
|
||||
|
||||
const props = defineProps<{
|
||||
/** 登录策略;不传则按当前页面在 `PAGE_REGISTRY` 里的声明自动判定 */
|
||||
auth?: AuthMode
|
||||
}>()
|
||||
|
||||
const { auth, isLogin, goLogin } = usePageAuth(props.auth)
|
||||
|
||||
type RenderMode = 'content' | 'guest' | 'require'
|
||||
|
||||
const mode = computed<RenderMode>(() => {
|
||||
if (auth.value === 'public' || isLogin.value) return 'content'
|
||||
return auth.value === 'optional' ? 'guest' : 'require'
|
||||
})
|
||||
|
||||
/** 内置引导文案:required 与 optional 两种语气 */
|
||||
const copy = computed(() =>
|
||||
mode.value === 'require'
|
||||
? { icon: 'lock', title: '请先登录', desc: '登录后即可使用该功能', action: '去登录' }
|
||||
: { icon: 'account', title: '登录后查看', desc: '登录后即可查看完整内容', action: '去登录' }
|
||||
)
|
||||
</script>
|
||||
|
||||
<style lang="scss" scoped>
|
||||
.auth-gate {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
padding: 96rpx 48rpx 64rpx;
|
||||
|
||||
&__icon {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
width: 128rpx;
|
||||
height: 128rpx;
|
||||
border-radius: 50%;
|
||||
background-color: #f2f3f5;
|
||||
}
|
||||
|
||||
&__title {
|
||||
margin-top: 32rpx;
|
||||
font-size: 32rpx;
|
||||
font-weight: 600;
|
||||
color: #303133;
|
||||
}
|
||||
|
||||
&__desc {
|
||||
margin-top: 12rpx;
|
||||
font-size: 26rpx;
|
||||
color: #909399;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
&__action {
|
||||
margin-top: 48rpx;
|
||||
min-width: 320rpx;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
103
src/components/empty-state/empty-state.vue
Normal file
103
src/components/empty-state/empty-state.vue
Normal file
@ -0,0 +1,103 @@
|
||||
<template>
|
||||
<view class="empty-state">
|
||||
<view class="empty-state__icon">
|
||||
<up-icon :name="icon" color="#c0c4cc" size="48"></up-icon>
|
||||
</view>
|
||||
|
||||
<view class="empty-state__text">{{ text }}</view>
|
||||
|
||||
<view v-if="showRetry || $slots.action" class="empty-state__action">
|
||||
<view v-if="showRetry" class="empty-state__btn">
|
||||
<up-button
|
||||
type="primary"
|
||||
:plain="true"
|
||||
shape="circle"
|
||||
size="small"
|
||||
:text="retryText"
|
||||
@click="emit('retry')"
|
||||
></up-button>
|
||||
</view>
|
||||
<!-- 额外动作位:未登录场景可再给一个「去登录」 -->
|
||||
<view v-if="$slots.action" class="empty-state__extra">
|
||||
<slot name="action"></slot>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
/**
|
||||
* 统一空态 / 失败提示
|
||||
*
|
||||
* 依《页面渲染框架》§3.5.1:**未登录且为空** 与 **已登录拿不到数据** 统一使用
|
||||
* 「服务器出差了,请稍后再试」+ 「重试」按钮,**不允许白屏**。
|
||||
*
|
||||
* 用法:
|
||||
* ```vue
|
||||
* <empty-state @retry="load" />
|
||||
* <empty-state v-if="!isLogin" @retry="load">
|
||||
* <template #action><!-- 可再放一个「去登录」 --></template>
|
||||
* </empty-state>
|
||||
* ```
|
||||
*/
|
||||
|
||||
withDefaults(
|
||||
defineProps<{
|
||||
/** 提示文案,缺省用统一兜底文案 */
|
||||
text?: string
|
||||
/** uview-plus 图标名 */
|
||||
icon?: string
|
||||
/** 是否显示「重试」按钮 */
|
||||
showRetry?: boolean
|
||||
retryText?: string
|
||||
}>(),
|
||||
{
|
||||
text: '服务器出差了,请稍后再试',
|
||||
icon: 'error-circle',
|
||||
showRetry: true,
|
||||
retryText: '重试'
|
||||
}
|
||||
)
|
||||
|
||||
const emit = defineEmits<{ (e: 'retry'): void }>()
|
||||
</script>
|
||||
|
||||
<style lang="scss" scoped>
|
||||
.empty-state {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
padding: 64rpx 48rpx;
|
||||
|
||||
&__icon {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
width: 112rpx;
|
||||
height: 112rpx;
|
||||
border-radius: 50%;
|
||||
background-color: #f2f3f5;
|
||||
}
|
||||
|
||||
&__text {
|
||||
margin-top: 24rpx;
|
||||
font-size: 28rpx;
|
||||
color: #909399;
|
||||
text-align: center;
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
&__action {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
margin-top: 32rpx;
|
||||
}
|
||||
|
||||
/* 注意:slot 内容由父页面渲染,样式作用域对不上,
|
||||
所以间距写在包住 slot 的 view 上,而不用 :deep() 穿透 */
|
||||
&__extra {
|
||||
margin-left: 20rpx;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
@ -30,6 +30,8 @@
|
||||
<up-form-item label="账号" prop="username" required>
|
||||
<up-input
|
||||
v-model="registerForm.username"
|
||||
:color="INPUT_COLOR"
|
||||
:placeholder-style="PLACEHOLDER_STYLE"
|
||||
placeholder="请输入账号"
|
||||
prefixIcon="account"
|
||||
clearable
|
||||
@ -40,6 +42,8 @@
|
||||
<up-form-item label="邮箱" prop="email">
|
||||
<up-input
|
||||
v-model="registerForm.email"
|
||||
:color="INPUT_COLOR"
|
||||
:placeholder-style="PLACEHOLDER_STYLE"
|
||||
placeholder="请输入邮箱"
|
||||
prefixIcon="email"
|
||||
clearable
|
||||
@ -50,6 +54,8 @@
|
||||
<up-form-item label="姓名" prop="real_name">
|
||||
<up-input
|
||||
v-model="registerForm.real_name"
|
||||
:color="INPUT_COLOR"
|
||||
:placeholder-style="PLACEHOLDER_STYLE"
|
||||
placeholder="请输入真实姓名"
|
||||
prefixIcon="account-fill"
|
||||
clearable
|
||||
@ -61,6 +67,8 @@
|
||||
<up-input
|
||||
v-model="registerForm.password"
|
||||
type="password"
|
||||
:color="INPUT_COLOR"
|
||||
:placeholder-style="PLACEHOLDER_STYLE"
|
||||
placeholder="请输入密码(不少于 6 位)"
|
||||
prefixIcon="lock"
|
||||
clearable
|
||||
@ -72,6 +80,8 @@
|
||||
<up-input
|
||||
v-model="registerForm.confirmPassword"
|
||||
type="password"
|
||||
:color="INPUT_COLOR"
|
||||
:placeholder-style="PLACEHOLDER_STYLE"
|
||||
placeholder="请再次输入密码"
|
||||
prefixIcon="lock"
|
||||
clearable
|
||||
@ -107,6 +117,8 @@
|
||||
<up-form-item label="账号" prop="username" required>
|
||||
<up-input
|
||||
v-model="loginForm.username"
|
||||
:color="INPUT_COLOR"
|
||||
:placeholder-style="PLACEHOLDER_STYLE"
|
||||
placeholder="请输入账号"
|
||||
prefixIcon="account"
|
||||
clearable
|
||||
@ -118,6 +130,8 @@
|
||||
<up-input
|
||||
v-model="loginForm.password"
|
||||
type="password"
|
||||
:color="INPUT_COLOR"
|
||||
:placeholder-style="PLACEHOLDER_STYLE"
|
||||
placeholder="请输入密码"
|
||||
prefixIcon="lock"
|
||||
clearable
|
||||
@ -141,6 +155,12 @@
|
||||
<text class="login-panel__link" @click="switchMode(true)">立即注册</text>
|
||||
</view>
|
||||
</up-form>
|
||||
|
||||
<!-- 取消:文字链形式(不用按钮样式,避免与主按钮「登录 / 注册」争夺视觉权重)
|
||||
放在两个表单之外只需一处;具体返回哪里由使用方决定 -->
|
||||
<view v-if="showCancel" class="login-panel__cancel" @click="emit('cancel')">
|
||||
<text class="login-panel__cancel-text">取消</text>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
@ -154,7 +174,8 @@
|
||||
*
|
||||
* 设计约定:
|
||||
* - 组件只负责「表单 + 校验 + 调接口」,登录成功只抛 success 事件;
|
||||
* 跳转策略(回跳来源页 / 进工作台)由使用方决定,方便在弹窗等场景复用。
|
||||
* 跳转策略(回跳来源页 / 进首页)由使用方决定,方便在弹窗等场景复用。
|
||||
* - 「取消」同理:传 `show-cancel` 才显示取消按钮,点击只抛 cancel 事件。
|
||||
* - 失败提示由 `utils/request` 统一 toast,组件内不再重复提示。
|
||||
*/
|
||||
|
||||
@ -175,18 +196,22 @@ const props = withDefaults(
|
||||
desc?: string
|
||||
/** 初始模式 */
|
||||
initialMode?: 'login' | 'register'
|
||||
/** 是否显示「取消」按钮(由使用方决定点击后去哪) */
|
||||
showCancel?: boolean
|
||||
}>(),
|
||||
{
|
||||
logo: '',
|
||||
title: 'WMS 小程序',
|
||||
desc: '仓储管理系统 · 微信小程序端',
|
||||
initialMode: 'login'
|
||||
initialMode: 'login',
|
||||
showCancel: false
|
||||
}
|
||||
)
|
||||
|
||||
const emit = defineEmits<{
|
||||
(e: 'success'): void
|
||||
(e: 'change', mode: 'login' | 'register'): void
|
||||
(e: 'cancel'): void
|
||||
}>()
|
||||
|
||||
const userStore = useUserStore()
|
||||
@ -197,6 +222,18 @@ const registerFormRef = ref<FormInstance | null>(null)
|
||||
const isRegister = ref(props.initialMode === 'register')
|
||||
const loading = ref(false)
|
||||
|
||||
/**
|
||||
* 输入文字 / 占位符颜色(必须显式指定)
|
||||
*
|
||||
* `up-input` 的文字色实现为:`color: this.color || 主题变量 --up-main-color`,
|
||||
* 而 uview-plus 在暗色主题下把 `--up-main-color` 定义为 `#f5f5f5`(近白),
|
||||
* 白底卡片上几乎看不见输入内容。
|
||||
* 它是**内联样式**(JS 计算后写到 style 上),CSS 盖不住,只能用 `color` 属性指定。
|
||||
* 占位符同理,显式给一个明显更浅的灰,与已输入文字形成对比。
|
||||
*/
|
||||
const INPUT_COLOR = '#303133'
|
||||
const PLACEHOLDER_STYLE = 'color: #c0c4cc'
|
||||
|
||||
// ──────────────────────── 登录表单 ────────────────────────
|
||||
|
||||
const loginForm = reactive({
|
||||
@ -311,6 +348,17 @@ const handleRegister = () => {
|
||||
.login-panel {
|
||||
padding: 0 48rpx;
|
||||
|
||||
/* 兜底:显式锁定浅色主题色板
|
||||
uview-plus 在 @media (prefers-color-scheme: dark) 下会把 --up-main-color 改为 #f5f5f5,
|
||||
白底卡片上文字会变得几乎看不见。
|
||||
注意:`up-input` 的文字色是 JS 读主题变量后写成**内联样式**,CSS 盖不住,
|
||||
故输入框另用 :color 属性显式指定(见 script 顶部 INPUT_COLOR);
|
||||
这里的变量覆盖是为了让卡片内其它 uview-plus 组件也保持足够对比度。 */
|
||||
--up-main-color: #303133;
|
||||
--up-content-color: #303133;
|
||||
--up-tips-color: #909399;
|
||||
--up-border-color: #dadbde;
|
||||
|
||||
&__brand {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
@ -390,6 +438,23 @@ const handleRegister = () => {
|
||||
color: #909399;
|
||||
}
|
||||
|
||||
&__cancel {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
margin-top: 36rpx;
|
||||
padding-top: 24rpx;
|
||||
/* 极细分隔线,避免与底部「立即注册」文字链混作一堆 */
|
||||
border-top: 1rpx solid #f0f0f0;
|
||||
}
|
||||
|
||||
&__cancel-text {
|
||||
/* 撑开点击热区,视觉上仍是轻量文字 */
|
||||
padding: 10rpx 40rpx;
|
||||
font-size: 28rpx;
|
||||
color: #909399;
|
||||
}
|
||||
|
||||
&__link {
|
||||
margin-left: 8rpx;
|
||||
font-size: 26rpx;
|
||||
|
||||
@ -1 +0,0 @@
|
||||
组合式函数:useXxx 形式的可复用逻辑
|
||||
86
src/composables/usePageAuth.ts
Normal file
86
src/composables/usePageAuth.ts
Normal file
@ -0,0 +1,86 @@
|
||||
/**
|
||||
* 页面登录态与三态渲染策略(`public` / `optional` / `required`)
|
||||
*
|
||||
* 把「页面要不要登录、未登录怎么办」的判断**收口到一处**,
|
||||
* 页面里不再散落 `if (userStore.isLogin)`。见《页面渲染框架》§3.4。
|
||||
*
|
||||
* ⚠️ 设计约束(微信审核要求):
|
||||
* 未登录时**只做页内提示**,由用户点击后才跳登录页 —— **绝不自动跳转**。
|
||||
*
|
||||
* 用法:
|
||||
* ```ts
|
||||
* const { isLogin, needLogin, goLogin, requireLogin } = usePageAuth('required')
|
||||
* // 或省略参数:自动按当前页面在 PAGE_REGISTRY 里的声明判定(策略只有一处声明)
|
||||
* const { canRender } = usePageAuth()
|
||||
* ```
|
||||
*/
|
||||
|
||||
import { computed } from 'vue'
|
||||
import type { ComputedRef } from 'vue'
|
||||
import { useUserStore } from '@/store/modules/user'
|
||||
import { getPageByPath } from '@/router/pages'
|
||||
import type { AuthMode } from '@/router/pages'
|
||||
import { LOGIN_PAGE, getCurrentRoute } from '@/utils/auth-guard'
|
||||
|
||||
export interface UsePageAuthReturn {
|
||||
/** 解析后的登录策略 */
|
||||
auth: ComputedRef<AuthMode>
|
||||
/** 是否已登录 */
|
||||
isLogin: ComputedRef<boolean>
|
||||
/** 是否允许渲染真实内容(仅 `required` 未登录时为 false) */
|
||||
canRender: ComputedRef<boolean>
|
||||
/** 是否该展示「请先登录」(= `required` 且未登录) */
|
||||
needLogin: ComputedRef<boolean>
|
||||
/** 直接跳登录页(带 `redirect` 回本页) */
|
||||
goLogin: () => void
|
||||
/** 未登录时先弹确认框、确认后再跳登录页;已登录则什么都不做 */
|
||||
requireLogin: (tips?: string) => void
|
||||
}
|
||||
|
||||
/**
|
||||
* 页面未登记到 `PAGE_REGISTRY` 时的兜底策略
|
||||
* 取最严格的 `required` —— 宁可多提示一次,也不要漏掉保护
|
||||
*/
|
||||
const FALLBACK_AUTH: AuthMode = 'required'
|
||||
|
||||
export function usePageAuth(auth?: AuthMode): UsePageAuthReturn {
|
||||
const userStore = useUserStore()
|
||||
|
||||
// 不传 auth 时按「当前页面」从静态路由表取,保证策略只有一处声明
|
||||
const mode = computed<AuthMode>(() => {
|
||||
if (auth) return auth
|
||||
|
||||
const page = getPageByPath(getCurrentRoute())
|
||||
if (!page) {
|
||||
console.warn(`[usePageAuth] 当前页面未登记到 PAGE_REGISTRY,按 "${FALLBACK_AUTH}" 处理`)
|
||||
}
|
||||
return page?.auth ?? FALLBACK_AUTH
|
||||
})
|
||||
|
||||
const isLogin = computed<boolean>(() => userStore.isLogin)
|
||||
const needLogin = computed<boolean>(() => mode.value === 'required' && !isLogin.value)
|
||||
const canRender = computed<boolean>(() => !needLogin.value)
|
||||
|
||||
/** 跳登录页,带 `redirect` 回本页(复用 `LOGIN_PAGE`,不新造路径) */
|
||||
const goLogin = (): void => {
|
||||
const current = getCurrentRoute()
|
||||
const query =
|
||||
current && current !== LOGIN_PAGE ? `?redirect=${encodeURIComponent(current)}` : ''
|
||||
uni.navigateTo({ url: `${LOGIN_PAGE}${query}` })
|
||||
}
|
||||
|
||||
/** 未登录时弹确认框引导登录(用户确认后才跳,不自动跳转) */
|
||||
const requireLogin = (tips = '该功能需要登录后使用'): void => {
|
||||
if (isLogin.value) return
|
||||
uni.showModal({
|
||||
title: '提示',
|
||||
content: tips,
|
||||
confirmText: '去登录',
|
||||
success: (res) => {
|
||||
if (res.confirm) goLogin()
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
return { auth: mode, isLogin, canRender, needLogin, goLogin, requireLogin }
|
||||
}
|
||||
4
src/env.d.ts
vendored
4
src/env.d.ts
vendored
@ -4,6 +4,10 @@
|
||||
interface ImportMetaEnv {
|
||||
/** 接口根地址,见 .env.development / .env.production */
|
||||
readonly VITE_APP_BASE_API: string
|
||||
/** 请求头 platform:后端网关校验(白名单 web / app / wx / miniProgram,大小写不敏感);本项目为 miniProgram */
|
||||
readonly VITE_APP_PLATFORM: string
|
||||
/** 请求头 project:后端网关切学校验,白名单 all / wms */
|
||||
readonly VITE_APP_PROJECT: string
|
||||
}
|
||||
|
||||
interface ImportMeta {
|
||||
|
||||
@ -8,28 +8,10 @@
|
||||
}
|
||||
},
|
||||
"pages": [
|
||||
{
|
||||
"path": "pages/login/login",
|
||||
"style": {
|
||||
"navigationBarTitleText": "登录"
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "pages/index/index",
|
||||
"style": {
|
||||
"navigationBarTitleText": "工作台"
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "pages/task/task",
|
||||
"style": {
|
||||
"navigationBarTitleText": "任务"
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "pages/inventory/inventory",
|
||||
"style": {
|
||||
"navigationBarTitleText": "库存"
|
||||
"navigationBarTitleText": "首页"
|
||||
}
|
||||
},
|
||||
{
|
||||
@ -37,6 +19,37 @@
|
||||
"style": {
|
||||
"navigationBarTitleText": "我的"
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "pages/login/login",
|
||||
"style": {
|
||||
"navigationBarTitleText": "登录"
|
||||
}
|
||||
}
|
||||
],
|
||||
"subPackages": [
|
||||
{
|
||||
"root": "pagesA",
|
||||
"pages": [
|
||||
{
|
||||
"path": "demo/public",
|
||||
"style": {
|
||||
"navigationBarTitleText": "公开示例"
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "demo/required",
|
||||
"style": {
|
||||
"navigationBarTitleText": "需登录示例"
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "test/index",
|
||||
"style": {
|
||||
"navigationBarTitleText": "测试页"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"tabBar": {
|
||||
@ -47,15 +60,7 @@
|
||||
"list": [
|
||||
{
|
||||
"pagePath": "pages/index/index",
|
||||
"text": "工作台"
|
||||
},
|
||||
{
|
||||
"pagePath": "pages/task/task",
|
||||
"text": "任务"
|
||||
},
|
||||
{
|
||||
"pagePath": "pages/inventory/inventory",
|
||||
"text": "库存"
|
||||
"text": "首页"
|
||||
},
|
||||
{
|
||||
"pagePath": "pages/mine/mine",
|
||||
@ -66,25 +71,29 @@
|
||||
"condition": {
|
||||
"current": 0,
|
||||
"list": [
|
||||
{
|
||||
"name": "首页",
|
||||
"path": "pages/index/index"
|
||||
},
|
||||
{
|
||||
"name": "登录",
|
||||
"path": "pages/login/login"
|
||||
},
|
||||
{
|
||||
"name": "工作台",
|
||||
"path": "pages/index/index"
|
||||
},
|
||||
{
|
||||
"name": "任务",
|
||||
"path": "pages/task/task"
|
||||
},
|
||||
{
|
||||
"name": "库存",
|
||||
"path": "pages/inventory/inventory"
|
||||
},
|
||||
{
|
||||
"name": "我的",
|
||||
"path": "pages/mine/mine"
|
||||
},
|
||||
{
|
||||
"name": "公开示例页",
|
||||
"path": "pagesA/demo/public"
|
||||
},
|
||||
{
|
||||
"name": "需登录示例页",
|
||||
"path": "pagesA/demo/required"
|
||||
},
|
||||
{
|
||||
"name": "测试页",
|
||||
"path": "pagesA/test/index"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
@ -2,24 +2,49 @@
|
||||
<view class="page">
|
||||
<!-- 顶部欢迎区 -->
|
||||
<view class="hero">
|
||||
<view class="hero__title">工作台</view>
|
||||
<view class="hero__desc">WMS 仓储管理 · 微信小程序端</view>
|
||||
<view class="hero__title">首页</view>
|
||||
<view class="hero__desc">{{ heroDesc }}</view>
|
||||
</view>
|
||||
|
||||
<!-- 常用功能入口 -->
|
||||
<!-- 业务入口:未登录取本地公共入口,登录后取后端菜单(分组标题 + 子项九宫格) -->
|
||||
<view class="card">
|
||||
<view class="card__title">常用功能</view>
|
||||
<view class="grid">
|
||||
<view
|
||||
v-for="item in entries"
|
||||
:key="item.key"
|
||||
class="grid__item"
|
||||
@click="onEntry(item)"
|
||||
>
|
||||
<up-icon :name="item.icon" :color="item.color" size="26"></up-icon>
|
||||
<text class="grid__item-text">{{ item.text }}</text>
|
||||
|
||||
<!-- 登录后菜单尚未取到时的加载态(避免闪一下空态文案) -->
|
||||
<view v-if="loading" class="loading">
|
||||
<up-loading-icon mode="circle" size="18" text="加载中"></up-loading-icon>
|
||||
</view>
|
||||
|
||||
<!-- 有入口:分组标题 + 子项九宫格 -->
|
||||
<view v-else-if="sections.length" class="sections">
|
||||
<view v-for="section in sections" :key="section.key" class="section">
|
||||
<view v-if="section.title" class="section__title">{{ section.title }}</view>
|
||||
<view class="grid">
|
||||
<view
|
||||
v-for="item in section.leaves"
|
||||
:key="item.key"
|
||||
class="grid__item"
|
||||
@click="onEntry(item)"
|
||||
>
|
||||
<up-icon :name="item.icon || 'grid'" color="#2979ff" size="26"></up-icon>
|
||||
<text class="grid__item-text">{{ item.title }}</text>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
|
||||
<!-- 无内容 / 接口失败:统一空态文案,不白屏(§3.5.1) -->
|
||||
<empty-state v-else @retry="loadEntries(true)">
|
||||
<template v-if="!isLogin" #action>
|
||||
<up-button
|
||||
type="primary"
|
||||
shape="circle"
|
||||
size="small"
|
||||
text="去登录"
|
||||
@click="goLogin"
|
||||
></up-button>
|
||||
</template>
|
||||
</empty-state>
|
||||
</view>
|
||||
|
||||
<!-- 运行信息:用于确认各端编译正常 -->
|
||||
@ -34,36 +59,75 @@
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
import { ref } from 'vue'
|
||||
import { computed, ref } from 'vue'
|
||||
import { onShow } from '@dcloudio/uni-app'
|
||||
|
||||
interface EntryItem {
|
||||
key: string
|
||||
text: string
|
||||
icon: string
|
||||
color: string
|
||||
}
|
||||
import { useUserStore } from '@/store/modules/user'
|
||||
import { usePermissionStore } from '@/store/modules/permission'
|
||||
import { usePageAuth } from '@/composables/usePageAuth'
|
||||
import { LOCAL_PUBLIC_ENTRIES, toSections } from '@/router/entries'
|
||||
import type { EntryLeaf } from '@/router/entries'
|
||||
import { navigateToPath } from '@/utils/navigate'
|
||||
|
||||
const version = ref(uni.$u.config.v)
|
||||
const platform = ref(uni.getSystemInfoSync().uniPlatform)
|
||||
|
||||
// 业务入口。对应页面将放入分包(pagesA/B/C),待第 3 节注册分包后接入跳转
|
||||
const entries = ref<EntryItem[]>([
|
||||
{ key: 'inbound', text: '入库', icon: 'bag', color: '#2979ff' },
|
||||
{ key: 'outbound', text: '出库', icon: 'car', color: '#19be6b' },
|
||||
{ key: 'stocktaking', text: '盘点', icon: 'list', color: '#ff9900' },
|
||||
{ key: 'scan', text: '扫码', icon: 'scan', color: '#303133' },
|
||||
{ key: 'inventory', text: '库存查询', icon: 'search', color: '#909399' },
|
||||
{ key: 'transfer', text: '调拨', icon: 'server-man', color: '#8a56e2' }
|
||||
])
|
||||
const userStore = useUserStore()
|
||||
const permissionStore = usePermissionStore()
|
||||
// 本页是 public:未登录也能正常浏览
|
||||
const { isLogin, goLogin, requireLogin } = usePageAuth('public')
|
||||
|
||||
const onEntry = (item: EntryItem) => {
|
||||
uni.$u.toast(`${item.text}:功能开发中`)
|
||||
const loading = ref(false)
|
||||
|
||||
/**
|
||||
* 入口来源(见《页面渲染框架》§3.5):
|
||||
* - 未登录 → 本地公共入口清单(确定性,不依赖后端是否配置)
|
||||
* - 已登录 → 后端菜单 × PAGE_REGISTRY 的可见入口树
|
||||
*/
|
||||
const sections = computed(() =>
|
||||
toSections(isLogin.value ? permissionStore.entries : LOCAL_PUBLIC_ENTRIES)
|
||||
)
|
||||
|
||||
const heroDesc = computed(() => {
|
||||
if (!isLogin.value) return 'WMS 仓储管理 · 微信小程序端'
|
||||
const parts = [
|
||||
userStore.userName,
|
||||
userStore.roleTypeLabel,
|
||||
userStore.currentEmployee?.store_name
|
||||
].filter(Boolean)
|
||||
return parts.length ? parts.join(' · ') : 'WMS 仓储管理 · 微信小程序端'
|
||||
})
|
||||
|
||||
/**
|
||||
* 拉取用户信息(= 菜单 + 权限点,失败提示由 request 层统一 toast)
|
||||
* @param force 是否强制刷新(“重试”按钮用;onShow 不传,避免切 Tab 就重拉)
|
||||
*/
|
||||
const loadEntries = async (force = false) => {
|
||||
if (!userStore.isLogin) return
|
||||
if (permissionStore.loaded && !force) return
|
||||
|
||||
loading.value = true
|
||||
try {
|
||||
await userStore.getInfo()
|
||||
} catch {
|
||||
// 失败 → sections 为空 → 走空态文案 + 「重试」
|
||||
} finally {
|
||||
loading.value = false
|
||||
}
|
||||
}
|
||||
|
||||
// onShow:tabBar 页切换只触发 onShow、不触发 onLoad
|
||||
/** 点击入口:需登录而未登录 → 页内引导(不自动跳转);否则按 tabBar 与否跳转 */
|
||||
const onEntry = (item: EntryLeaf) => {
|
||||
if (item.auth === 'required' && !isLogin.value) {
|
||||
requireLogin(`「${item.title}」需要登录后使用`)
|
||||
return
|
||||
}
|
||||
navigateToPath(item.path, item.title)
|
||||
}
|
||||
|
||||
// onShow:tabBar 页切换只触发 onShow、不触发 onLoad;
|
||||
// 已加载过会直接返回,所以放在这里既能在冷启动补拉,也不会重复请求
|
||||
onShow(() => {
|
||||
// TODO 第 5 节接入请求后,在此刷新待办数量等看板数据
|
||||
loadEntries()
|
||||
})
|
||||
</script>
|
||||
|
||||
@ -105,6 +169,25 @@ onShow(() => {
|
||||
}
|
||||
}
|
||||
|
||||
.sections {
|
||||
padding-bottom: 8rpx;
|
||||
}
|
||||
|
||||
.section {
|
||||
&__title {
|
||||
padding: 16rpx 32rpx 0;
|
||||
font-size: 26rpx;
|
||||
color: #909399;
|
||||
}
|
||||
}
|
||||
|
||||
.loading {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 56rpx 0;
|
||||
}
|
||||
|
||||
.grid {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
|
||||
@ -1,92 +0,0 @@
|
||||
<template>
|
||||
<view class="page">
|
||||
<!-- 搜索区 -->
|
||||
<view class="search">
|
||||
<up-search
|
||||
v-model="keyword"
|
||||
placeholder="搜索商品 / 条码 / 库位"
|
||||
@search="onSearch"
|
||||
></up-search>
|
||||
</view>
|
||||
|
||||
<!-- 扫码入口:仓储场景最高频操作 -->
|
||||
<view class="actions">
|
||||
<up-button
|
||||
type="primary"
|
||||
size="small"
|
||||
icon="scan"
|
||||
text="扫码查询"
|
||||
@click="onScan"
|
||||
></up-button>
|
||||
</view>
|
||||
|
||||
<!-- 结果区:接口接入前保持空态 -->
|
||||
<view class="body">
|
||||
<up-empty v-if="list.length === 0" mode="data" :text="emptyText"></up-empty>
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
import { computed, ref } from 'vue'
|
||||
import { onShow } from '@dcloudio/uni-app'
|
||||
|
||||
const keyword = ref('')
|
||||
|
||||
// 库存列表数据,第 5 节接入接口后替换
|
||||
const list = ref<unknown[]>([])
|
||||
|
||||
const emptyText = computed(() =>
|
||||
keyword.value ? `没有找到「${keyword.value}」的库存记录` : '请输入条件查询库存'
|
||||
)
|
||||
|
||||
const onSearch = () => {
|
||||
// TODO 第 5 节接入请求后调用库存查询接口
|
||||
uni.$u.toast('查询功能待接入接口')
|
||||
}
|
||||
|
||||
/**
|
||||
* 扫码查询
|
||||
* 注意:uni.scanCode 属隐私接口,真机需先在微信公众平台配置
|
||||
* 《小程序用户隐私保护指引》并声明「摄像头」,否则会被拦截(见清单第 7 节)
|
||||
*/
|
||||
const onScan = () => {
|
||||
uni.scanCode({
|
||||
scanType: ['barCode', 'qrCode'],
|
||||
success: (res) => {
|
||||
keyword.value = res.result
|
||||
onSearch()
|
||||
},
|
||||
fail: () => {
|
||||
uni.$u.toast('未完成扫码')
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
// onShow:tabBar 页切换只触发 onShow、不触发 onLoad
|
||||
onShow(() => {
|
||||
// TODO 第 5 节接入请求后,在此刷新库存列表
|
||||
})
|
||||
</script>
|
||||
|
||||
<style lang="scss" scoped>
|
||||
.page {
|
||||
min-height: 100vh;
|
||||
background-color: #f5f6fa;
|
||||
}
|
||||
|
||||
.search {
|
||||
padding: 16rpx 24rpx 0;
|
||||
background-color: #ffffff;
|
||||
}
|
||||
|
||||
.actions {
|
||||
display: flex;
|
||||
padding: 20rpx 24rpx;
|
||||
background-color: #ffffff;
|
||||
}
|
||||
|
||||
.body {
|
||||
padding-top: 24rpx;
|
||||
}
|
||||
</style>
|
||||
@ -5,7 +5,9 @@
|
||||
:logo="logo"
|
||||
title="WMS 小程序"
|
||||
desc="仓储管理系统 · 微信小程序端"
|
||||
show-cancel
|
||||
@success="onLoginSuccess"
|
||||
@cancel="onCancel"
|
||||
></login-panel>
|
||||
|
||||
<view class="login-page__tip">登录后可使用入库、出库、盘点等全部功能</view>
|
||||
@ -17,12 +19,14 @@
|
||||
/**
|
||||
* 登录页
|
||||
*
|
||||
* 本页同时是**小程序的启动页**(pages.json 的 pages 数组第一项):
|
||||
* - 未登录:停留在登录/注册
|
||||
* - 已登录(上次登录留下的 token 仍有效):直接进工作台,不闪登录表单
|
||||
* ⚠️ 本页**不是启动页**,也不会在打开小程序时被自动跳转
|
||||
* (微信审核要求:登录必须由用户主动触发)。
|
||||
* 当前入口:`pages/mine/mine` 的「登录 / 注册」按钮(或点击头像区)。
|
||||
*
|
||||
* 与 new3 的对应关系:new3 靠 permission.ts 把未登录用户重定向到 /login?redirect=xxx,
|
||||
* 小程序端由 `utils/auth-guard.ts` 的全局跳转拦截承担同样职责。
|
||||
* 三种去向:
|
||||
* - 取消 → 有来源页则返回上一页;无来源页则退回 redirect 指定页 / 首页
|
||||
* - 登录成功 → 回跳 redirect 指定的来源页,缺省进首页
|
||||
* - 已登录进入本页 → 直接放行,不停留在登录表单
|
||||
*/
|
||||
|
||||
import { ref } from 'vue'
|
||||
@ -35,12 +39,7 @@ import { LOGIN_PAGE } from '@/utils/auth-guard'
|
||||
const HOME_PAGE = '/pages/index/index'
|
||||
|
||||
/** tabBar 页面清单:这些页面只能用 switchTab 进入 */
|
||||
const TAB_PAGES = [
|
||||
HOME_PAGE,
|
||||
'/pages/task/task',
|
||||
'/pages/inventory/inventory',
|
||||
'/pages/mine/mine'
|
||||
]
|
||||
const TAB_PAGES = [HOME_PAGE, '/pages/mine/mine']
|
||||
|
||||
const logo = ref('/static/logo.png')
|
||||
|
||||
@ -66,13 +65,27 @@ const onLoginSuccess = () => {
|
||||
goAfterLogin()
|
||||
}
|
||||
|
||||
/**
|
||||
* 取消登录:返回来源页
|
||||
* - 从「我的」等页面 navigateTo 进来:页面栈有上一页 → 直接返回
|
||||
* - 无来源页(如 401 兜底 reLaunch 进来):退回 redirect 指定页 / 首页
|
||||
*/
|
||||
const onCancel = () => {
|
||||
const pages = getCurrentPages()
|
||||
if (pages.length > 1) {
|
||||
uni.navigateBack()
|
||||
return
|
||||
}
|
||||
goAfterLogin()
|
||||
}
|
||||
|
||||
onLoad((options) => {
|
||||
if (options?.redirect) {
|
||||
redirect.value = decodeURIComponent(options.redirect)
|
||||
}
|
||||
})
|
||||
|
||||
// 已有 token(本次启动前登录过)直接放行,避免重复登录
|
||||
// 已登录(含直接进入本页的场景)直接放行,避免重复登录
|
||||
onShow(() => {
|
||||
if (getToken()) goAfterLogin()
|
||||
})
|
||||
|
||||
@ -12,6 +12,54 @@
|
||||
<up-icon v-if="!userStore.isLogin" name="arrow-right" color="#ffffff" size="16"></up-icon>
|
||||
</view>
|
||||
|
||||
<!-- 登录入口:仅未登录时显示(微信要求登录由用户主动触发) -->
|
||||
<view v-if="!userStore.isLogin" class="entry">
|
||||
<up-button type="primary" shape="circle" text="登录 / 注册" @click="onLogin"></up-button>
|
||||
</view>
|
||||
|
||||
<!-- 身份信息:登录后显示,数据来自 user.info 的 employees[](不改数据库、无额外接口) -->
|
||||
<view v-if="userStore.isLogin" class="card">
|
||||
<view class="card__title">身份信息</view>
|
||||
|
||||
<up-cell-group v-if="identity" :border="false">
|
||||
<up-cell title="姓名" :value="identity?.real_name || userName" :border="false"></up-cell>
|
||||
<up-cell title="身份类型" :value="userStore.roleTypeLabel || '-'" :border="false"></up-cell>
|
||||
<up-cell title="所属组织" :value="identity?.store_name || '-'" :border="false"></up-cell>
|
||||
<up-cell title="员工 ID" :value="identity ? String(identity.id) : '-'" :border="false"></up-cell>
|
||||
<up-cell title="授权到期" :value="authEndText" :border="false"></up-cell>
|
||||
<!-- 仅多身份时出现:身份切换入口 -->
|
||||
<up-cell
|
||||
v-if="userStore.hasMultipleEmployees"
|
||||
title="切换身份"
|
||||
:value="`${userStore.employees.length} 个可选`"
|
||||
is-link
|
||||
:border="false"
|
||||
@click="onSwitchIdentity"
|
||||
></up-cell>
|
||||
</up-cell-group>
|
||||
|
||||
<view v-else class="card__note" @click="loadIdentity">身份信息加载中…点此重试</view>
|
||||
</view>
|
||||
|
||||
<!-- 功能菜单:登录后由后端菜单驱动;无菜单时整卡不渲染,避免空卡片占位 -->
|
||||
<view v-if="userStore.isLogin && menuSections.length" class="card">
|
||||
<view class="card__title">功能菜单</view>
|
||||
<view v-for="section in menuSections" :key="section.key" class="menu">
|
||||
<view v-if="section.title" class="menu__title">{{ section.title }}</view>
|
||||
<up-cell-group :border="false">
|
||||
<up-cell
|
||||
v-for="item in section.leaves"
|
||||
:key="item.key"
|
||||
:title="item.title"
|
||||
:icon="item.icon"
|
||||
is-link
|
||||
:border="false"
|
||||
@click="onMenuTap(item)"
|
||||
></up-cell>
|
||||
</up-cell-group>
|
||||
</view>
|
||||
</view>
|
||||
|
||||
<!-- 运行信息与常用项 -->
|
||||
<view class="card">
|
||||
<up-cell-group :border="false">
|
||||
@ -21,7 +69,7 @@
|
||||
</up-cell-group>
|
||||
</view>
|
||||
|
||||
<view class="footer">
|
||||
<view v-if="userStore.isLogin" class="footer">
|
||||
<up-button type="info" :plain="true" text="退出登录" @click="onLogout"></up-button>
|
||||
</view>
|
||||
</view>
|
||||
@ -31,28 +79,118 @@
|
||||
import { computed, ref } from 'vue'
|
||||
import { onShow } from '@dcloudio/uni-app'
|
||||
import { useUserStore } from '@/store/modules/user'
|
||||
import { usePermissionStore } from '@/store/modules/permission'
|
||||
import { usePageAuth } from '@/composables/usePageAuth'
|
||||
import { toSections } from '@/router/entries'
|
||||
import type { EntryLeaf } from '@/router/entries'
|
||||
import { getToken } from '@/utils/auth'
|
||||
import { LOGIN_PAGE } from '@/utils/auth-guard'
|
||||
import { navigateToPath } from '@/utils/navigate'
|
||||
|
||||
const version = ref(uni.$u.config.v)
|
||||
const platform = ref(uni.getSystemInfoSync().uniPlatform)
|
||||
|
||||
const userStore = useUserStore()
|
||||
const permissionStore = usePermissionStore()
|
||||
|
||||
const userName = computed(() => {
|
||||
if (!userStore.isLogin) return '未登录'
|
||||
return userStore.userName || '已登录'
|
||||
})
|
||||
|
||||
const userDesc = computed(() => {
|
||||
if (!userStore.isLogin) return '点击登录后使用完整功能'
|
||||
return userStore.employeeId ? `员工 ID:${userStore.employeeId}` : '已登录'
|
||||
/** 当前身份(登录后由 user.info 的 employees[] 计算得出) */
|
||||
const identity = computed(() => userStore.currentEmployee)
|
||||
|
||||
/** 授权到期展示:后端 null / 空 表示长期有效 */
|
||||
const authEndText = computed(() => {
|
||||
const end = identity.value?.auth_end
|
||||
if (!end) return '长期有效'
|
||||
return String(end).slice(0, 10)
|
||||
})
|
||||
|
||||
/** 未登录时点击头部跳登录页(已登录则不做任何事) */
|
||||
const userDesc = computed(() => {
|
||||
if (!userStore.isLogin) return '点击登录后使用完整功能'
|
||||
const parts = [userStore.roleTypeLabel, identity.value?.store_name].filter(Boolean)
|
||||
return parts.length ? parts.join(' · ') : '已登录'
|
||||
})
|
||||
|
||||
/** 拉取 / 重试用户信息(身份信息来源于 user.info,无额外接口) */
|
||||
const loadIdentity = () => {
|
||||
userStore.getInfo().catch(() => {
|
||||
// 失败提示由 request 层统一 toast
|
||||
})
|
||||
}
|
||||
|
||||
/**
|
||||
* 选择要切换到的身份
|
||||
* 入口仅在多身份时出现;用 `showActionSheet` 避免额外页面与组件
|
||||
*/
|
||||
const onSwitchIdentity = () => {
|
||||
const list = userStore.employees
|
||||
if (list.length < 2) return
|
||||
|
||||
// 微信 showActionSheet 的 itemList 最多 6 项:超出时保证「当前身份」仍在列表里
|
||||
const MAX_ITEMS = 6
|
||||
let visible = list
|
||||
if (list.length > MAX_ITEMS) {
|
||||
const current = list.find((item) => item.id === userStore.currentEmployeeId)
|
||||
const rest = list.filter((item) => item.id !== userStore.currentEmployeeId)
|
||||
visible = (current ? [current, ...rest] : rest).slice(0, MAX_ITEMS)
|
||||
uni.$u.toast(`身份较多,仅显示前 ${MAX_ITEMS} 个`)
|
||||
}
|
||||
|
||||
const itemList = visible.map((item) => {
|
||||
const label =
|
||||
[item.store_name, item.real_name].filter(Boolean).join(' · ') || `身份 ${item.id}`
|
||||
return item.id === userStore.currentEmployeeId ? `${label}(当前)` : label
|
||||
})
|
||||
|
||||
uni.showActionSheet({
|
||||
itemList,
|
||||
success: (res) => {
|
||||
const target = visible[res.tapIndex]
|
||||
if (!target || target.id === userStore.currentEmployeeId) return
|
||||
doChangeRole(target.id)
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
/** 执行切换:换发 token → 重拉 user.info(失败提示由 request 层统一处理) */
|
||||
const doChangeRole = async (roleId: number) => {
|
||||
uni.showLoading({ title: '切换中', mask: true })
|
||||
try {
|
||||
await userStore.changeRole(roleId)
|
||||
uni.hideLoading()
|
||||
uni.$u.toast('身份已切换')
|
||||
} catch {
|
||||
uni.hideLoading()
|
||||
// store 内已回滚选中身份,此处只需提示
|
||||
uni.$u.toast('切换失败,请稍后再试')
|
||||
}
|
||||
}
|
||||
|
||||
/** 本页是公共页面(auth: 'optional'),登录跳转统一走 usePageAuth:
|
||||
* 会自动带 redirect 回本页(同时作为「取消」与「登录成功」的回跳目标) */
|
||||
const { goLogin, requireLogin } = usePageAuth('optional')
|
||||
|
||||
/** 进入登录页 */
|
||||
const onLogin = () => goLogin()
|
||||
|
||||
/** 功能菜单:与首页九宫格**同源**(都是 permissionStore.entries) */
|
||||
const menuSections = computed(() => toSections(permissionStore.entries))
|
||||
|
||||
/** 点击功能菜单(本卡仅登录后显示,这里的登录判断只是兜底) */
|
||||
const onMenuTap = (item: EntryLeaf) => {
|
||||
if (item.auth === 'required' && !userStore.isLogin) {
|
||||
requireLogin(`「${item.title}」需要登录后使用`)
|
||||
return
|
||||
}
|
||||
navigateToPath(item.path, item.title)
|
||||
}
|
||||
|
||||
/** 未登录时点击头部同样进登录页(已登录则不做任何事) */
|
||||
const onProfileTap = () => {
|
||||
if (userStore.isLogin) return
|
||||
uni.navigateTo({ url: LOGIN_PAGE })
|
||||
onLogin()
|
||||
}
|
||||
|
||||
const onClearCache = () => {
|
||||
@ -82,7 +220,9 @@ const onLogout = () => {
|
||||
if (!res.confirm) return
|
||||
// logout 内部已做兜底:后端不可用也会清理本地登录态
|
||||
await userStore.logout()
|
||||
uni.reLaunch({ url: LOGIN_PAGE })
|
||||
// 退出后停留在本页:页面会自动切回「未登录」态并显示登录入口
|
||||
// 不强制跳转登录页 —— 与「登录由用户主动触发」的约定保持一致
|
||||
uni.$u.toast('已退出登录')
|
||||
}
|
||||
})
|
||||
}
|
||||
@ -93,10 +233,10 @@ onShow(() => {
|
||||
// (request 层在 401/过期时会直接清存储,此处保证界面同步)
|
||||
userStore.token = getToken()
|
||||
if (!userStore.isLogin) return
|
||||
if (userStore.userName) return
|
||||
// 已拉到用户信息(含身份列表)则跳过,避免每次切 Tab 都发请求
|
||||
if (userStore.userName || userStore.employees.length) return
|
||||
|
||||
// 首次进入且尚未拉取过用户信息时补齐(失败提示由 request 层统一处理)
|
||||
userStore.getInfo().catch(() => {})
|
||||
loadIdentity()
|
||||
})
|
||||
</script>
|
||||
|
||||
@ -140,11 +280,37 @@ onShow(() => {
|
||||
}
|
||||
}
|
||||
|
||||
.entry {
|
||||
margin: 24rpx;
|
||||
}
|
||||
|
||||
.card {
|
||||
margin: 24rpx;
|
||||
background-color: #ffffff;
|
||||
border-radius: 16rpx;
|
||||
overflow: hidden;
|
||||
|
||||
&__title {
|
||||
padding: 24rpx 32rpx 8rpx;
|
||||
font-size: 28rpx;
|
||||
font-weight: 600;
|
||||
color: #303133;
|
||||
}
|
||||
|
||||
&__note {
|
||||
padding: 0 32rpx 24rpx;
|
||||
font-size: 24rpx;
|
||||
color: #909399;
|
||||
text-align: center;
|
||||
}
|
||||
}
|
||||
|
||||
.menu {
|
||||
&__title {
|
||||
padding: 8rpx 32rpx 0;
|
||||
font-size: 26rpx;
|
||||
color: #909399;
|
||||
}
|
||||
}
|
||||
|
||||
.footer {
|
||||
|
||||
@ -1,111 +0,0 @@
|
||||
<template>
|
||||
<view class="page">
|
||||
<!-- 搜索区 -->
|
||||
<view class="search">
|
||||
<up-search
|
||||
v-model="keyword"
|
||||
placeholder="搜索单号 / 商品名称"
|
||||
@search="onSearch"
|
||||
></up-search>
|
||||
</view>
|
||||
|
||||
<!-- 状态分段:用原生 view 实现,避免额外组件依赖 -->
|
||||
<view class="segment">
|
||||
<view
|
||||
v-for="(item, index) in segments"
|
||||
:key="item"
|
||||
class="segment__item"
|
||||
:class="{ 'segment__item--active': index === activeIndex }"
|
||||
@click="onSegmentChange(index)"
|
||||
>
|
||||
{{ item }}
|
||||
</view>
|
||||
</view>
|
||||
|
||||
<!-- 列表区:接口接入前保持空态 -->
|
||||
<view class="body">
|
||||
<up-empty v-if="list.length === 0" mode="list" :text="emptyText"></up-empty>
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
import { computed, ref } from 'vue'
|
||||
import { onLoad, onShow } from '@dcloudio/uni-app'
|
||||
|
||||
const segments = ['待处理', '已处理', '全部']
|
||||
const activeIndex = ref(0)
|
||||
const keyword = ref('')
|
||||
|
||||
// 任务列表数据,第 5 节接入接口后替换
|
||||
const list = ref<unknown[]>([])
|
||||
|
||||
const emptyText = computed(() =>
|
||||
keyword.value ? `没有找到「${keyword.value}」相关任务` : '暂无任务'
|
||||
)
|
||||
|
||||
const onSearch = () => {
|
||||
// TODO 第 5 节接入请求后调用任务列表接口
|
||||
uni.$u.toast('搜索功能待接入接口')
|
||||
}
|
||||
|
||||
const onSegmentChange = (index: number) => {
|
||||
activeIndex.value = index
|
||||
}
|
||||
|
||||
// onLoad:读取路由参数,做一次性初始化
|
||||
onLoad((options) => {
|
||||
const status = options?.status
|
||||
if (!status) return
|
||||
const index = segments.indexOf(status)
|
||||
if (index > -1) activeIndex.value = index
|
||||
})
|
||||
|
||||
// onShow:tabBar 页切换只触发 onShow、不触发 onLoad,列表刷新应放在这里
|
||||
onShow(() => {
|
||||
// TODO 第 5 节接入请求后,在此刷新当前分段的列表
|
||||
})
|
||||
</script>
|
||||
|
||||
<style lang="scss" scoped>
|
||||
.page {
|
||||
min-height: 100vh;
|
||||
background-color: #f5f6fa;
|
||||
}
|
||||
|
||||
.search {
|
||||
padding: 16rpx 24rpx 0;
|
||||
background-color: #ffffff;
|
||||
}
|
||||
|
||||
.segment {
|
||||
display: flex;
|
||||
background-color: #ffffff;
|
||||
padding: 16rpx 24rpx 20rpx;
|
||||
|
||||
&__item {
|
||||
flex: 1;
|
||||
height: 64rpx;
|
||||
line-height: 64rpx;
|
||||
text-align: center;
|
||||
font-size: 28rpx;
|
||||
color: #606266;
|
||||
background-color: #f5f6fa;
|
||||
border-radius: 8rpx;
|
||||
margin-right: 16rpx;
|
||||
|
||||
&:last-child {
|
||||
margin-right: 0;
|
||||
}
|
||||
|
||||
&--active {
|
||||
color: #ffffff;
|
||||
background-color: #2979ff;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
.body {
|
||||
padding-top: 24rpx;
|
||||
}
|
||||
</style>
|
||||
70
src/pagesA/demo/public.vue
Normal file
70
src/pagesA/demo/public.vue
Normal file
@ -0,0 +1,70 @@
|
||||
<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' 且未设 hidden,因此会
|
||||
<text class="text--strong">自动出现在未登录时的首页九宫格</text>
|
||||
里(LOCAL_PUBLIC_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>
|
||||
116
src/pagesA/demo/required.vue
Normal file
116
src/pagesA/demo/required.vue
Normal file
@ -0,0 +1,116 @@
|
||||
<template>
|
||||
<view class="page">
|
||||
<!-- required 未登录:页内「请先登录」+ 去登录,**不自动跳转** -->
|
||||
<auth-gate auth="required">
|
||||
<template #default>
|
||||
<view class="card">
|
||||
<view class="card__title">当前身份</view>
|
||||
<up-cell-group :border="false">
|
||||
<up-cell title="姓名" :value="userStore.userName || '-'" :border="false"></up-cell>
|
||||
<up-cell title="身份类型" :value="userStore.roleTypeLabel || '-'" :border="false"></up-cell>
|
||||
<up-cell title="所属组织" :value="userStore.currentEmployee?.store_name || '-'" :border="false"></up-cell>
|
||||
</up-cell-group>
|
||||
</view>
|
||||
|
||||
<view class="card">
|
||||
<view class="card__title">按钮级权限示例</view>
|
||||
<view class="text">用 checkPermission() 控制按钮显隐(示例权限点:store.getStoreRoles)。</view>
|
||||
<view class="actions">
|
||||
<up-button
|
||||
v-if="canViewRoles"
|
||||
type="primary"
|
||||
shape="circle"
|
||||
size="small"
|
||||
text="有权限才显示的按钮"
|
||||
@click="onGuardedTap"
|
||||
></up-button>
|
||||
<view v-else class="text text--warn">
|
||||
当前账号没有 store.getStoreRoles 权限 → 按钮不渲染(这是预期行为,不是 bug)
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
|
||||
<view class="card">
|
||||
<view class="card__title">账号权限点(共 {{ userStore.permissions.length }} 个)</view>
|
||||
<view v-if="!userStore.permissions.length" class="text">
|
||||
接口未下发 permissions —— 可回头核对后端是否按端返回 type='api' 的权限点。
|
||||
</view>
|
||||
<view v-else class="text">
|
||||
<view v-for="item in permissionPreview" :key="item" class="perm">{{ item }}</view>
|
||||
<view v-if="userStore.permissions.length > permissionPreview.length" class="perm">
|
||||
…共 {{ userStore.permissions.length }} 个
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
</auth-gate>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
/**
|
||||
* 框架示例页:`required`(需登录)
|
||||
*
|
||||
* 用途:验证「页内请先登录」体验 + 按钮级权限判断(`checkPermission`)。
|
||||
*
|
||||
* ⚠️ 这是「页面渲染框架」的示例页,业务页上线后可直接删除
|
||||
* (删除时同步清理:pages.json 的 subPackages、PAGE_REGISTRY、condition)。
|
||||
*/
|
||||
import { computed } from 'vue'
|
||||
import { useUserStore } from '@/store/modules/user'
|
||||
|
||||
const userStore = useUserStore()
|
||||
|
||||
/** 页面按钮级权限:无该权限时整块不渲染 */
|
||||
const canViewRoles = computed(() => userStore.checkPermission('store.getStoreRoles'))
|
||||
|
||||
/** 权限点只展示前 20 个,避免页面被刷屏 */
|
||||
const permissionPreview = computed(() => userStore.permissions.slice(0, 20))
|
||||
|
||||
const onGuardedTap = () => {
|
||||
uni.$u.toast('有权限,按钮可点')
|
||||
}
|
||||
</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;
|
||||
|
||||
&--warn {
|
||||
color: #ff9900;
|
||||
}
|
||||
}
|
||||
|
||||
.perm {
|
||||
font-size: 24rpx;
|
||||
color: #909399;
|
||||
}
|
||||
|
||||
.actions {
|
||||
padding: 8rpx 32rpx 24rpx;
|
||||
}
|
||||
</style>
|
||||
157
src/pagesA/test/index.vue
Normal file
157
src/pagesA/test/index.vue
Normal file
@ -0,0 +1,157 @@
|
||||
<template>
|
||||
<view class="page">
|
||||
<auth-gate auth="required">
|
||||
<template #default>
|
||||
<view class="card">
|
||||
<view class="card__title">页面信息</view>
|
||||
<up-cell-group :border="false">
|
||||
<up-cell title="逻辑路径" value="/test/index" :border="false"></up-cell>
|
||||
<up-cell title="物理路径" value="pagesA/test/index" :border="false"></up-cell>
|
||||
<up-cell
|
||||
title="后端数据源"
|
||||
value="wms_permission id=627"
|
||||
:border="false"
|
||||
></up-cell>
|
||||
</up-cell-group>
|
||||
</view>
|
||||
|
||||
<view class="card">
|
||||
<view class="card__title">当前账号</view>
|
||||
<up-cell-group :border="false">
|
||||
<up-cell title="姓名" :value="userStore.userName || '-'" :border="false"></up-cell>
|
||||
<up-cell title="身份类型" :value="userStore.roleTypeLabel || '-'" :border="false"></up-cell>
|
||||
<up-cell
|
||||
title="所属组织"
|
||||
:value="userStore.currentEmployee?.store_name || '-'"
|
||||
:border="false"
|
||||
></up-cell>
|
||||
<up-cell
|
||||
title="权限点数"
|
||||
:value="String(userStore.permissions.length)"
|
||||
:border="false"
|
||||
></up-cell>
|
||||
</up-cell-group>
|
||||
</view>
|
||||
|
||||
<view class="card">
|
||||
<view class="card__title">
|
||||
后端菜单(根节点 {{ permissionStore.menus.length }} 个)
|
||||
</view>
|
||||
<view v-if="!permissionStore.menus.length" class="text text--warn">
|
||||
后端没有下发任何菜单 → 说明 platform=miniProgram 时 menus 未取自
|
||||
miniprogram_pages,或当前账号的角色未授权 627。
|
||||
</view>
|
||||
<template v-else>
|
||||
<view class="text">
|
||||
下列 path 若包含 /test/index,说明后端已按 miniprogram_pages 下发。
|
||||
</view>
|
||||
<view v-for="item in menuPaths" :key="item" class="code">{{ item }}</view>
|
||||
<view v-if="menuPaths.length >= 30" class="text">…(只显示前 30 条)</view>
|
||||
</template>
|
||||
</view>
|
||||
|
||||
<view class="card">
|
||||
<view class="card__title">入口解析结果</view>
|
||||
<up-cell-group :border="false">
|
||||
<up-cell
|
||||
title="可见入口数"
|
||||
:value="String(permissionStore.leafCount)"
|
||||
:border="false"
|
||||
></up-cell>
|
||||
<up-cell
|
||||
title="未登记 key"
|
||||
:value="permissionStore.missing.length ? `${permissionStore.missing.length} 个` : '无'"
|
||||
:border="false"
|
||||
></up-cell>
|
||||
</up-cell-group>
|
||||
<view v-if="permissionStore.missing.length" class="text text--warn">
|
||||
以下 key 后端下发了但本地未登记(会被忽略):
|
||||
</view>
|
||||
<view v-for="item in permissionStore.missing.slice(0, 10)" :key="item" class="code">
|
||||
{{ item }}
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
</auth-gate>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
/**
|
||||
* 测试页 —— 验证「后端 miniprogram_pages → 首页常用功能入口」整条链路
|
||||
*
|
||||
* 对应 `wms_permission` id = 627(type='miniprogram_pages',path='/test/index')。
|
||||
* 已加入 `pages.json` 的 `condition`,微信开发者工具「编译模式」可直达。
|
||||
*
|
||||
* ⚠️ 这是链路验证页,验证完成后可删除
|
||||
* (删除时同步清理:pages.json 的 subPackages / condition、PAGE_REGISTRY、以及数据库 627 行)。
|
||||
*/
|
||||
import { computed } from 'vue'
|
||||
import { useUserStore } from '@/store/modules/user'
|
||||
import { usePermissionStore } from '@/store/modules/permission'
|
||||
import type { MenuNode } from '@/router/entries'
|
||||
|
||||
const userStore = useUserStore()
|
||||
const permissionStore = usePermissionStore()
|
||||
|
||||
/** 把后端菜单树拍平成 path 列表(最多 30 条),便于直接核对 */
|
||||
const menuPaths = computed<string[]>(() => {
|
||||
const out: string[] = []
|
||||
|
||||
const walk = (nodes: MenuNode[]): void => {
|
||||
for (const node of nodes) {
|
||||
if (out.length >= 30) return
|
||||
if (node.path) out.push(node.path)
|
||||
const children = node.children
|
||||
if (children && children.length) walk(children)
|
||||
}
|
||||
}
|
||||
|
||||
walk(permissionStore.menus)
|
||||
return out
|
||||
})
|
||||
</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;
|
||||
|
||||
&--warn {
|
||||
color: #ff9900;
|
||||
}
|
||||
}
|
||||
|
||||
.code {
|
||||
margin: 0 32rpx 8rpx;
|
||||
padding: 6rpx 16rpx;
|
||||
font-size: 24rpx;
|
||||
color: #2979ff;
|
||||
background-color: #f2f6ff;
|
||||
border-radius: 6rpx;
|
||||
word-break: break-all;
|
||||
}
|
||||
</style>
|
||||
250
src/router/entries.ts
Normal file
250
src/router/entries.ts
Normal file
@ -0,0 +1,250 @@
|
||||
/**
|
||||
* 后端菜单 → 可见入口树
|
||||
*
|
||||
* 职责:把 `user.info` 下发的 `menus`(`wms_permission` 序列化后的树)与本地
|
||||
* `PAGE_REGISTRY`(静态路由表)做交集,产出 UI 可直接渲染的入口树。
|
||||
*
|
||||
* 三条兜底规则(对齐 new3 `resolveComponent` 的兜底思想,见《页面渲染框架》§3.3):
|
||||
* | 情况 | 处理 |
|
||||
* |---|---|
|
||||
* | 菜单项 key 命中 `PAGE_REGISTRY` | 收进结果,携带本地 `path` / `auth` / `title` |
|
||||
* | 未命中 | **忽略该项**,记入 `missing`(不影响其它入口,由调用方告警) |
|
||||
* | 分组节点无子项命中 | 整组丢弃(避免渲染出空分组) |
|
||||
* | `hidden = 1` | 不进导航入口 |
|
||||
*
|
||||
* ⚠️ **输出固定为两层**(`EntryGroup.children` 只能是 `EntryLeaf`):
|
||||
* 小程序首页是「分组标题 + 子项九宫格」(决策点 4),
|
||||
* 所以更深的层级会被**拉平**到所属根分组里,让 UI 不必处理任意深度。
|
||||
*/
|
||||
|
||||
import { PAGE_REGISTRY, getPageByKey } from './pages'
|
||||
import type { AuthMode, PageMeta } from './pages'
|
||||
|
||||
/** 后端菜单节点(`user.info` 的 `menus[]`) */
|
||||
export interface MenuNode {
|
||||
/** 逻辑路径,与 `PAGE_REGISTRY` 的 `key` 对齐(后端只认这个) */
|
||||
path?: string
|
||||
/** Web 端的组件路径;小程序端忽略 */
|
||||
component?: string
|
||||
/** 路由名(后端唯一标识,排障用) */
|
||||
name?: string
|
||||
redirect?: string
|
||||
/** 后端为 tinyint(0 显示 / 1 隐藏),也兼容布尔 */
|
||||
hidden?: boolean | number | string
|
||||
alwaysShow?: boolean
|
||||
meta?: {
|
||||
title?: string
|
||||
icon?: string | null
|
||||
[key: string]: any
|
||||
} | null
|
||||
children?: MenuNode[] | null
|
||||
[key: string]: any
|
||||
}
|
||||
|
||||
/** 叶子入口:可跳转的页面 */
|
||||
export interface EntryLeaf {
|
||||
kind: 'leaf'
|
||||
/** 逻辑路径(= `PAGE_REGISTRY.key`) */
|
||||
key: string
|
||||
/** 物理页面路径,跳转用(必须走这里,不要用后端的 path) */
|
||||
path: string
|
||||
title: string
|
||||
icon?: string
|
||||
/** 登录策略,页面据此做三态渲染 */
|
||||
auth: AuthMode
|
||||
/** tabBar 页必须用 `uni.switchTab` 跳转 */
|
||||
tabBar?: boolean
|
||||
}
|
||||
|
||||
/** 分组入口:只作标题,不可跳转 */
|
||||
export interface EntryGroup {
|
||||
kind: 'group'
|
||||
/** 分组标识(后端菜单的 path / name,仅作 key) */
|
||||
key: string
|
||||
title: string
|
||||
icon?: string
|
||||
children: EntryLeaf[]
|
||||
}
|
||||
|
||||
export type EntryNode = EntryLeaf | EntryGroup
|
||||
|
||||
export interface GenerateEntriesResult {
|
||||
entries: EntryNode[]
|
||||
/** 后端下发但本地未登记的 key(多半是 pages.json / PAGE_REGISTRY 漏登记) */
|
||||
missing: string[]
|
||||
}
|
||||
|
||||
/** 后端 `hidden` 可能是 0/1、布尔或字符串 */
|
||||
function isHidden(value: MenuNode['hidden']): boolean {
|
||||
return value === true || value === 1 || value === '1'
|
||||
}
|
||||
|
||||
/**
|
||||
* 该页面是否**可以作为导航入口**展示
|
||||
*
|
||||
* ⚠️ 「本地公共入口」与「后端菜单」两个来源**共用这一个口径**:
|
||||
* - `tabBar`:底部 tab 本身就是入口,再进九宫格会变成「点首页跳首页」
|
||||
* - `hidden`:静态声明了「不作为入口展示」(首页 / 我的 / 登录 / 需登录示例)
|
||||
*
|
||||
* 后端菜单下发了一个 `hidden` 的页面时也会被过滤掉 —— 两处口径不一致会出现
|
||||
* 「后端配了 /home,九宫格里就多出一个首页入口」这类诡异现象。
|
||||
*/
|
||||
function isEntryVisible(meta: PageMeta): boolean {
|
||||
return !meta.tabBar && !meta.hidden
|
||||
}
|
||||
|
||||
/**
|
||||
* 递归收集叶子(命中静态路由表且未隐藏的菜单项)
|
||||
* 分组节点只看子项 —— 分组自身的 `path` 不作为页面
|
||||
*/
|
||||
function collectLeaves(nodes: MenuNode[], sink: EntryLeaf[], missing: string[]): void {
|
||||
for (const node of nodes) {
|
||||
const children = node.children ?? []
|
||||
|
||||
if (children.length) {
|
||||
collectLeaves(children, sink, missing)
|
||||
continue
|
||||
}
|
||||
|
||||
const key = node.path
|
||||
if (!key) continue
|
||||
|
||||
const meta = getPageByKey(key)
|
||||
if (!meta) {
|
||||
// 后端下发、本地没登记 → 忽略这一项,记入 missing(不抛错、不影响其它入口)
|
||||
missing.push(key)
|
||||
continue
|
||||
}
|
||||
|
||||
if (isHidden(node.hidden)) continue
|
||||
// 本地声明「不作为入口」(首页 / 我的 / 登录等)同样过滤,与公共入口口径一致
|
||||
if (!isEntryVisible(meta)) continue
|
||||
|
||||
sink.push({
|
||||
kind: 'leaf',
|
||||
key: meta.key,
|
||||
path: meta.path,
|
||||
// 展示名/图标优先用后端下发的,缺省回退本地路由表
|
||||
title: node.meta?.title || meta.title,
|
||||
icon: node.meta?.icon || meta.icon,
|
||||
auth: meta.auth,
|
||||
tabBar: meta.tabBar
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 菜单树 × `PAGE_REGISTRY` → 可见入口树(最多两层)
|
||||
*
|
||||
* 纯函数:不做网络请求、不写 store,便于单独验证。
|
||||
*/
|
||||
export function generateEntries(menus: MenuNode[] | null | undefined): GenerateEntriesResult {
|
||||
const entries: EntryNode[] = []
|
||||
const missing: string[] = []
|
||||
/** 已收进结果的叶子 key,用于去重(后端菜单重复配置时不重复渲染) */
|
||||
const seen = new Set<string>()
|
||||
|
||||
for (const root of menus ?? []) {
|
||||
const children = root.children ?? []
|
||||
|
||||
// ① 根节点本身就是叶子(如后端直接下发一个没有分组的页面)
|
||||
if (!children.length) {
|
||||
const leaves: EntryLeaf[] = []
|
||||
collectLeaves([root], leaves, missing)
|
||||
for (const leaf of leaves) {
|
||||
if (seen.has(leaf.key)) continue
|
||||
seen.add(leaf.key)
|
||||
entries.push(leaf)
|
||||
}
|
||||
continue
|
||||
}
|
||||
|
||||
// ② 分组节点
|
||||
if (isHidden(root.hidden)) continue
|
||||
|
||||
const leaves: EntryLeaf[] = []
|
||||
collectLeaves(children, leaves, missing)
|
||||
|
||||
const fresh = leaves.filter((leaf) => !seen.has(leaf.key))
|
||||
// 分组内一个都没命中 → 整组丢弃,避免渲染出空分组
|
||||
if (!fresh.length) continue
|
||||
|
||||
fresh.forEach((leaf) => seen.add(leaf.key))
|
||||
entries.push({
|
||||
kind: 'group',
|
||||
key: root.path || root.name || '',
|
||||
title: root.meta?.title || root.path || root.name || '',
|
||||
icon: root.meta?.icon || undefined,
|
||||
children: fresh
|
||||
})
|
||||
}
|
||||
|
||||
return { entries, missing: Array.from(new Set(missing)) }
|
||||
}
|
||||
|
||||
/**
|
||||
* 本地公共入口清单 —— 未登录时首页九宫格的**兜底内容**
|
||||
*
|
||||
* 为什么不用后端菜单:这是为了保「未登录可见什么」是**确定性**的 ——
|
||||
* 不依赖后端是否配置、也不受接口/网络故障影响,微信审核时更可控。
|
||||
* 后端 `miniprogram_pages` 只需描述「登录后能看到什么」。见《页面渲染框架》§3.5。
|
||||
*
|
||||
* 筛选条件:`auth === 'public'` **且** `isEntryVisible(page)`
|
||||
* (与「后端菜单」共用同一可见性口径,避免两个来源规则不一致)
|
||||
*
|
||||
* ⚠️ 当前清单里只有 `pagesA/demo/public`(示例页)。
|
||||
* 以后新增公开业务页(如公告页),只要在 `PAGE_REGISTRY` 里标 `auth: 'public'`
|
||||
* 且不设 `hidden`,就会**自动出现**在这里,无需改本文件。
|
||||
* 若一个满足条件的页面都没有,首页会渲染 §3.5.1 的统一空态文案,而不是白屏。
|
||||
*/
|
||||
export const LOCAL_PUBLIC_ENTRIES: EntryLeaf[] = PAGE_REGISTRY.filter(
|
||||
(page) => page.auth === 'public' && isEntryVisible(page)
|
||||
).map((page) => ({
|
||||
kind: 'leaf' as const,
|
||||
key: page.key,
|
||||
path: page.path,
|
||||
title: page.title,
|
||||
icon: page.icon,
|
||||
auth: page.auth,
|
||||
tabBar: page.tabBar
|
||||
}))
|
||||
|
||||
/** 页面直接渲染用的「一层分组」结构 */
|
||||
export interface EntrySection {
|
||||
/** 分组标识(连续顶层叶子合成的段用生成 key) */
|
||||
key: string
|
||||
/** 分组标题;空字符串表示「无标题的一段」 */
|
||||
title: string
|
||||
leaves: EntryLeaf[]
|
||||
}
|
||||
|
||||
/**
|
||||
* 把入口树拍平成「一层分组」,供页面直接 `v-for` 渲染
|
||||
*
|
||||
* - 分组节点 → 一个带标题的 section(「分组标题 + 子项九宫格」里的标题)
|
||||
* - **连续的**顶层叶子 → 合成一个无标题 section(避免每个叶子各占一行)
|
||||
*
|
||||
* 首页与「我的」共用它,保证两处渲染口径一致。
|
||||
*/
|
||||
export function toSections(nodes: EntryNode[]): EntrySection[] {
|
||||
const sections: EntrySection[] = []
|
||||
let loose: EntryLeaf[] = []
|
||||
|
||||
const flush = (): void => {
|
||||
if (!loose.length) return
|
||||
sections.push({ key: `loose-${sections.length}`, title: '', leaves: loose })
|
||||
loose = []
|
||||
}
|
||||
|
||||
for (const node of nodes) {
|
||||
if (node.kind === 'group') {
|
||||
flush()
|
||||
sections.push({ key: node.key, title: node.title, leaves: node.children })
|
||||
} else {
|
||||
loose.push(node)
|
||||
}
|
||||
}
|
||||
flush()
|
||||
|
||||
return sections
|
||||
}
|
||||
141
src/router/pages.ts
Normal file
141
src/router/pages.ts
Normal file
@ -0,0 +1,141 @@
|
||||
/**
|
||||
* 静态路由表(PAGE_REGISTRY)
|
||||
*
|
||||
* 为什么需要它:`pages.json` 只服务于**编译**(微信只认 pages / style / subPackages / tabBar),
|
||||
* 运行时代码里**读不出来**。而后端 `user.info` 下发的菜单只给**逻辑路径**
|
||||
* (`wms_permission.path`,形如 `/inbound/list`),前端必须持有一份
|
||||
* 「逻辑路径 → 物理页面」的运行时映射,才能渲染入口并跳转。
|
||||
*
|
||||
* 三条约定(务必遵守):
|
||||
* 1. `key` = 逻辑路径,**必须与后端 `wms_permission.path`(type='miniprogram_pages')一致**
|
||||
* 2. `path` = 物理页面路径,**必须与 `pages.json` 完全一致**(页面挪分包 / 改目录名只改这一处)
|
||||
* 3. **只登记真实存在的页面** —— 登记了 `pages.json` 里没有的页面,用户点进去必然失败
|
||||
* (用 `npm run check:pages` 校验 1/2/3 是否成立)
|
||||
*
|
||||
* 与 new3 的 `router/map.ts`(`componentMap`)是同一个思想:
|
||||
* **后端只给逻辑标识,前端持有「标识 → 真实页面」的映射**。
|
||||
*
|
||||
* 详见《页面渲染框架-设计与任务清单.md》§3.2
|
||||
*/
|
||||
|
||||
/** 页面登录策略 —— 见设计文档 §3.4 */
|
||||
export type AuthMode = 'public' | 'optional' | 'required'
|
||||
|
||||
export interface PageMeta {
|
||||
/** 逻辑路径:与后端 `wms_permission.path` 对齐(后端只需知道这个,不感知分包/目录) */
|
||||
key: string
|
||||
/** 小程序物理页面路径(必须与 `pages.json` 一致,不带 `.vue` 后缀、不带前导 `/`) */
|
||||
path: string
|
||||
/** 页面标题:后端菜单未下发 `meta_title` 时的兜底显示名 */
|
||||
title: string
|
||||
/** uview-plus 图标名:后端菜单未下发 `meta_icon` 时的兜底 */
|
||||
icon?: string
|
||||
/**
|
||||
* 登录策略:
|
||||
* - `public` 未登录即可看完整内容
|
||||
* - `optional` 未登录渲染占位/引导,已登录渲染真实数据
|
||||
* - `required` 未登录页内提示「请先登录」(**不自动跳转**)
|
||||
*/
|
||||
auth: AuthMode
|
||||
/** 是否 tabBar 页 —— 跳转必须用 `uni.switchTab`,不能用 `navigateTo` */
|
||||
tabBar?: boolean
|
||||
/** 是否不进导航入口(九宫格 / 功能菜单):可被跳转,但不作为入口展示 */
|
||||
hidden?: boolean
|
||||
}
|
||||
|
||||
export const PAGE_REGISTRY: PageMeta[] = [
|
||||
// ─────────────── 公共页面:无需登录即可访问,不会被拦截 ───────────────
|
||||
{
|
||||
key: '/home',
|
||||
path: 'pages/index/index',
|
||||
title: '首页',
|
||||
icon: 'home',
|
||||
auth: 'public',
|
||||
tabBar: true,
|
||||
// tabBar 本身就是入口,不再进九宫格
|
||||
hidden: true
|
||||
},
|
||||
{
|
||||
key: '/mine',
|
||||
path: 'pages/mine/mine',
|
||||
title: '我的',
|
||||
icon: 'account',
|
||||
auth: 'optional',
|
||||
tabBar: true,
|
||||
hidden: true
|
||||
},
|
||||
{
|
||||
key: '/login',
|
||||
path: 'pages/login/login',
|
||||
title: '登录 / 注册',
|
||||
icon: 'account-fill',
|
||||
auth: 'public',
|
||||
// 由「我的」页主动进入,不作为入口展示
|
||||
hidden: true
|
||||
},
|
||||
|
||||
// ──────── 框架示例页(分包 pagesA):验证三态渲染与权限,业务页上线后可删 ────────
|
||||
{
|
||||
key: '/demo/public',
|
||||
path: 'pagesA/demo/public',
|
||||
title: '公开示例',
|
||||
icon: 'info-circle',
|
||||
auth: 'public'
|
||||
// 不设 hidden → 未登录时会自动出现在首页九宫格(LOCAL_PUBLIC_ENTRIES)
|
||||
},
|
||||
{
|
||||
key: '/demo/required',
|
||||
path: 'pagesA/demo/required',
|
||||
title: '需登录示例',
|
||||
icon: 'lock',
|
||||
auth: 'required',
|
||||
// 需登录的页不进公共入口;登录后由后端菜单下发才出现在九宫格
|
||||
hidden: true
|
||||
},
|
||||
{
|
||||
key: '/test/index',
|
||||
path: 'pagesA/test/index',
|
||||
title: '测试页',
|
||||
icon: 'grid',
|
||||
auth: 'required'
|
||||
// 不设 hidden → 登录后由后端菜单(wms_permission id=627)下发生效,出现在首页「常用功能」
|
||||
},
|
||||
|
||||
// ─────────────── 业务页(分包):待页面文件就绪后再启用 ───────────────
|
||||
// ⚠️ pagesA / pagesB / pagesC 目前只有 .gitkeep 占位,**先不登记**:
|
||||
// 登记了 pages.json 里没有的页面 = 用户点进去必然失败。
|
||||
// 启用步骤:① 建页面文件 → ② 注册到 pages.json 的 subPackages → ③ 打开下面的注释。
|
||||
// { key: '/inbound/list', path: 'pagesA/inbound/list', title: '入库', icon: 'bag', auth: 'required' },
|
||||
// { key: '/outbound/list', path: 'pagesB/outbound/list', title: '出库', icon: 'car', auth: 'required' },
|
||||
// { key: '/stocktaking/list', path: 'pagesC/stocktaking/list', title: '盘点', icon: 'list', auth: 'required' },
|
||||
// { key: '/inventory/list', path: 'pagesC/inventory/list', title: '库存查询', icon: 'search', auth: 'required' }
|
||||
]
|
||||
|
||||
/** 逻辑路径 → 页面元数据(菜单渲染 / 跳转时查表用) */
|
||||
export const PAGE_MAP = new Map<string, PageMeta>(
|
||||
PAGE_REGISTRY.map((page) => [page.key, page])
|
||||
)
|
||||
|
||||
/** 物理路径 → 页面元数据(「当前页面反查元数据」时用) */
|
||||
export const PAGE_BY_PATH = new Map<string, PageMeta>(
|
||||
PAGE_REGISTRY.map((page) => [page.path, page])
|
||||
)
|
||||
|
||||
/** 按逻辑路径取页面元数据 */
|
||||
export function getPageByKey(key: string): PageMeta | undefined {
|
||||
return PAGE_MAP.get(key)
|
||||
}
|
||||
|
||||
/**
|
||||
* 按物理路径取页面元数据
|
||||
* 兼容带前导 `/` 的写法(如 `getCurrentPages()` 与手写路径两种习惯)
|
||||
*/
|
||||
export function getPageByPath(path: string): PageMeta | undefined {
|
||||
return PAGE_BY_PATH.get(path.replace(/^\//, ''))
|
||||
}
|
||||
|
||||
/** 是否为 tabBar 页 —— 决定跳转用 `switchTab` 还是 `navigateTo` */
|
||||
export function isTabBarPage(keyOrPath: string): boolean {
|
||||
const page = getPageByKey(keyOrPath) || getPageByPath(keyOrPath)
|
||||
return !!page?.tabBar
|
||||
}
|
||||
84
src/store/modules/permission.ts
Normal file
84
src/store/modules/permission.ts
Normal file
@ -0,0 +1,84 @@
|
||||
/**
|
||||
* 权限 / 菜单 Store —— 页面渲染框架的数据中枢
|
||||
*
|
||||
* 输入:`user.info` 的 `menus`(页面树)
|
||||
* 产出:`entries`(菜单 × `PAGE_REGISTRY` 后的可见入口树),供首页九宫格 / 「我的」功能菜单直接渲染
|
||||
*
|
||||
* 调用时机(见《页面渲染框架》阶段 2):
|
||||
* - `userStore.getInfo()` 成功后 → `loadFromMenus(user.menus)`
|
||||
* · 覆盖「登录成功后」「启动时带 token」「切换身份后」三条路径
|
||||
* - `userStore.resetToken()` / request 层 401 → `reset()`
|
||||
* · 退出登录、清缓存、token 失效都要清,避免旧身份的入口残留
|
||||
*
|
||||
* ⚠️ 本 store **不依赖 api 层**(只依赖 `router/entries`),
|
||||
* 因此 `utils/request.ts` 可以安全地静态引入它,不会形成循环引用。
|
||||
*/
|
||||
|
||||
import { defineStore } from 'pinia'
|
||||
import { generateEntries } from '@/router/entries'
|
||||
import type { EntryNode, MenuNode } from '@/router/entries'
|
||||
|
||||
interface PermissionState {
|
||||
/** 后端原始菜单树(保留原始数据,便于排障) */
|
||||
menus: MenuNode[]
|
||||
/** 菜单 × 静态路由表后的可见入口树(UI 直接渲染) */
|
||||
entries: EntryNode[]
|
||||
/** 后端下发但本地未登记的 key(用于告警 / 排查) */
|
||||
missing: string[]
|
||||
/** 是否已完成过至少一次加载(区分「未加载」与「加载后确实为空」) */
|
||||
loaded: boolean
|
||||
}
|
||||
|
||||
export const usePermissionStore = defineStore('permission', {
|
||||
state: (): PermissionState => ({
|
||||
menus: [],
|
||||
entries: [],
|
||||
missing: [],
|
||||
loaded: false
|
||||
}),
|
||||
|
||||
getters: {
|
||||
/** 是否有可渲染的入口 —— 为 false 时 UI 走统一空态文案(见 §3.5.1) */
|
||||
hasEntries: (state): boolean => state.entries.length > 0,
|
||||
/** 叶子入口总数(分组按子项数展开) */
|
||||
leafCount: (state): number =>
|
||||
state.entries.reduce(
|
||||
(sum, node) => sum + (node.kind === 'group' ? node.children.length : 1),
|
||||
0
|
||||
)
|
||||
},
|
||||
|
||||
actions: {
|
||||
/**
|
||||
* 用 `user.info` 的 menus 重建入口树
|
||||
*
|
||||
* 后端当前尚未配置 `miniprogram_pages`(0 条)→ `entries` 会是空数组,
|
||||
* 这是**预期行为**:UI 回退到本地公共入口 + 空态文案,不报错。
|
||||
*/
|
||||
loadFromMenus(menus: MenuNode[] | null | undefined): void {
|
||||
const { entries, missing } = generateEntries(menus)
|
||||
|
||||
this.menus = menus ?? []
|
||||
this.entries = entries
|
||||
this.missing = missing
|
||||
this.loaded = true
|
||||
|
||||
if (missing.length) {
|
||||
// 后端下发但本地未登记:多半是 pages.json / PAGE_REGISTRY 漏登记了新页面。
|
||||
// 只告警不抛错 —— 忽略这些项,其余入口照常渲染(对齐 §3.3 的兜底规则)。
|
||||
console.warn(
|
||||
`[permission] 后端菜单有 ${missing.length} 个页面未在 PAGE_REGISTRY 登记,已忽略:`,
|
||||
missing
|
||||
)
|
||||
}
|
||||
},
|
||||
|
||||
/** 清空菜单与入口缓存(退出登录 / 401 / 清缓存时调用) */
|
||||
reset(): void {
|
||||
this.menus = []
|
||||
this.entries = []
|
||||
this.missing = []
|
||||
this.loaded = false
|
||||
}
|
||||
}
|
||||
})
|
||||
@ -2,9 +2,9 @@
|
||||
* 用户 / 登录态 Store
|
||||
*
|
||||
* 对应 new3(Web 端)的 `src/stores/modules/user.ts`。
|
||||
* 已裁剪的部分(属后续「页面渲染框架」步骤,本次不做):
|
||||
* - changeRole(切换角色/仓库,需配合页签与用户偏好重置)
|
||||
* - 打印组件连接、用户偏好加载
|
||||
* 已实现:登录 / 注册 / 用户信息 / 退出;身份列表与当前身份展示;`changeRole` 切换身份;
|
||||
* 与权限 store 联动(`getInfo` → 灌菜单,`resetToken` → 清菜单)
|
||||
* 未移植:打印组件连接、用户偏好加载
|
||||
*
|
||||
* token 的**唯一真实来源是 utils/auth 的本地存储**,本 store 的 token 仅为 UI 响应式副本。
|
||||
*/
|
||||
@ -15,12 +15,45 @@ import {
|
||||
login as apiLogin,
|
||||
register as apiRegister,
|
||||
getInfo as apiGetInfo,
|
||||
changeRole as apiChangeRole,
|
||||
logout as apiLogout
|
||||
} from '@/api/user/user'
|
||||
import type { EmployeeInfo } from '@/api/user/user'
|
||||
import { usePermissionStore } from './permission'
|
||||
|
||||
/** 登录请求携带的端标记:与 Web 端(desktop / mobile)区分,小程序端固定 mobile */
|
||||
const DEVICE = 'mobile'
|
||||
|
||||
/** 身份类型(后端 `role_type`)→ 展示文案;未知值直接显示原值 */
|
||||
const ROLE_TYPE_LABEL: Record<string, string> = {
|
||||
warehouse: '仓库',
|
||||
store: '货主',
|
||||
platform: '平台',
|
||||
admin: '管理员'
|
||||
}
|
||||
|
||||
/** 授权是否已过期(`null` / 空表示长期有效) */
|
||||
function isAuthExpired(authEnd?: string | null): boolean {
|
||||
if (!authEnd) return false
|
||||
// iOS 不支持 'YYYY-MM-DD' 格式,统一换成 '/' 分隔再解析
|
||||
const end = new Date(String(authEnd).replace(/-/g, '/')).getTime()
|
||||
if (Number.isNaN(end)) return false
|
||||
return end < Date.now()
|
||||
}
|
||||
|
||||
/**
|
||||
* 选默认身份:优先主身份(`is_primary=1`),其次授权未过期的,最后取第一个
|
||||
* (与《页面渲染框架》§4.2 的默认身份规则一致)
|
||||
*/
|
||||
function pickDefaultEmployeeId(list: EmployeeInfo[]): number {
|
||||
if (!list.length) return 0
|
||||
const primary = list.find((item) => Number(item.is_primary) === 1)
|
||||
if (primary) return primary.id
|
||||
const valid = list.find((item) => !isAuthExpired(item.auth_end))
|
||||
if (valid) return valid.id
|
||||
return list[0].id
|
||||
}
|
||||
|
||||
interface UserInfo {
|
||||
[key: string]: any
|
||||
}
|
||||
@ -30,6 +63,10 @@ interface UserState {
|
||||
user: UserInfo
|
||||
roleId: number
|
||||
permissions: string[]
|
||||
/** 该账号的全部可用身份(来自 user.info 的 `employees[]`) */
|
||||
employees: EmployeeInfo[]
|
||||
/** 当前选中身份 = `employees[].id`;0 表示尚未确定 */
|
||||
currentEmployeeId: number
|
||||
}
|
||||
|
||||
export const useUserStore = defineStore('user', {
|
||||
@ -37,7 +74,9 @@ export const useUserStore = defineStore('user', {
|
||||
token: getToken(),
|
||||
user: {},
|
||||
roleId: 0,
|
||||
permissions: []
|
||||
permissions: [],
|
||||
employees: [],
|
||||
currentEmployeeId: 0
|
||||
}),
|
||||
|
||||
getters: {
|
||||
@ -47,7 +86,19 @@ export const useUserStore = defineStore('user', {
|
||||
userName: (state): string =>
|
||||
state.user.employees_name || state.user.username || state.user.name || '',
|
||||
/** 员工 ID */
|
||||
employeeId: (state): number => state.user.employees_id || state.roleId || 0
|
||||
employeeId: (state): number => state.user.employees_id || state.roleId || 0,
|
||||
/** 当前选中的身份(未登录 / 未拉到 user.info 时为 undefined) */
|
||||
currentEmployee(state): EmployeeInfo | undefined {
|
||||
return state.employees.find((item) => item.id === state.currentEmployeeId)
|
||||
},
|
||||
/** 当前身份类型文案:仓库 / 货主 / …(未知类型回退为原值) */
|
||||
roleTypeLabel(state): string {
|
||||
const type =
|
||||
state.employees.find((item) => item.id === state.currentEmployeeId)?.role_type || ''
|
||||
return ROLE_TYPE_LABEL[type] || type
|
||||
},
|
||||
/** 是否拥有多个身份(为后续 `changeRole` 切换做准备) */
|
||||
hasMultipleEmployees: (state): boolean => state.employees.length > 1
|
||||
},
|
||||
|
||||
actions: {
|
||||
@ -66,6 +117,11 @@ export const useUserStore = defineStore('user', {
|
||||
|
||||
setToken(token)
|
||||
this.token = token
|
||||
|
||||
// 登录成功后统一拉一次用户信息(菜单 / 权限点 / 身份):
|
||||
// 放在 store 里可保证「任何登录入口」都会触发,页面渲染框架才有输入。
|
||||
// 失败不阻塞登录 —— token 已到手,菜单为空时 UI 走空态文案并支持重试。
|
||||
await this.getInfo().catch(() => {})
|
||||
return true
|
||||
},
|
||||
|
||||
@ -95,9 +151,90 @@ export const useUserStore = defineStore('user', {
|
||||
this.user = user
|
||||
this.permissions = user.permissions || []
|
||||
this.roleId = user.employees_id || 0
|
||||
// 身份列表 + 当前身份(优先以后端会话的 employees_id 为准)
|
||||
this.setEmployees(user.employees || [], user.employees_id || 0)
|
||||
// 菜单 → 可见入口树(首页九宫格 / 「我的」功能菜单的渲染输入)
|
||||
usePermissionStore().loadFromMenus(user.menus || [])
|
||||
return user
|
||||
},
|
||||
|
||||
/**
|
||||
* 写入可用身份列表并锁定「当前身份」
|
||||
*
|
||||
* 优先级(避免展示的身份与后端会话不一致):
|
||||
* ① 本地已选身份仍在列表中 → 保留(刷新 user.info 不会被莫名切换)
|
||||
* ② 后端会话当前身份(`user.info` 的 `employees_id`)在列表中 → 以其为准
|
||||
* ③ 都没有 → 按默认规则挑(主身份 → 授权未过期 → 第一个)
|
||||
*/
|
||||
setEmployees(list: EmployeeInfo[], serverEmployeeId = 0): void {
|
||||
this.employees = Array.isArray(list) ? list : []
|
||||
const has = (id: number): boolean =>
|
||||
!!id && this.employees.some((item) => item.id === id)
|
||||
|
||||
if (has(this.currentEmployeeId)) return
|
||||
if (has(serverEmployeeId)) {
|
||||
this.currentEmployeeId = serverEmployeeId
|
||||
return
|
||||
}
|
||||
this.currentEmployeeId = pickDefaultEmployeeId(this.employees)
|
||||
},
|
||||
|
||||
/**
|
||||
* 仅移动「当前身份」指针(不发请求)
|
||||
* 传 `0` 表示重置为未确定;传不存在的 id 会被忽略
|
||||
*/
|
||||
setCurrentEmployee(employeeId: number): void {
|
||||
const exists = this.employees.some((item) => item.id === employeeId)
|
||||
if (employeeId && !exists) return
|
||||
this.currentEmployeeId = employeeId
|
||||
},
|
||||
|
||||
/**
|
||||
* 切换当前身份(角色 / 仓库)
|
||||
*
|
||||
* 流程(与 new3 一致,见《页面渲染框架》§4.2):
|
||||
* ① `user.changeRole({ roleId, device })`
|
||||
* ② 若回传 `token` → 写新 token(未回传则沿用旧 token)
|
||||
* ③ 重调 `user.info` 重建 `menus` / `permissions`
|
||||
*
|
||||
* 注意:**只有切换接口本身失败才回滚选中身份**;
|
||||
* 后续 `getInfo` 失败不回滚 —— 此时后端身份已切,回滚反而会造成前后端不一致。
|
||||
*/
|
||||
async changeRole(roleId: number): Promise<void> {
|
||||
if (!roleId) {
|
||||
throw new Error('切换身份失败:缺少 roleId')
|
||||
}
|
||||
if (roleId === this.currentEmployeeId) return
|
||||
|
||||
const previousId = this.currentEmployeeId
|
||||
// 乐观更新:界面立即反映选择
|
||||
this.setCurrentEmployee(roleId)
|
||||
|
||||
let resp: Awaited<ReturnType<typeof apiChangeRole>>
|
||||
try {
|
||||
resp = await apiChangeRole({ roleId, device: DEVICE })
|
||||
} catch (err) {
|
||||
this.setCurrentEmployee(previousId)
|
||||
throw err
|
||||
}
|
||||
|
||||
// 后端可能换发 token(new3 行为)
|
||||
const token = resp.data?.token || ''
|
||||
if (token) {
|
||||
setToken(token)
|
||||
this.token = token
|
||||
}
|
||||
|
||||
// 后端直接回传 user 时先落库;菜单/权限仍以下面重拉的 user.info 为准
|
||||
const user = resp.data?.user
|
||||
if (user) {
|
||||
this.user = user
|
||||
if (user.permissions) this.permissions = user.permissions
|
||||
}
|
||||
|
||||
await this.getInfo()
|
||||
},
|
||||
|
||||
/** 退出登录:先通知后端,无论成功与否都要清掉本地登录态 */
|
||||
async logout(): Promise<void> {
|
||||
try {
|
||||
@ -116,6 +253,10 @@ export const useUserStore = defineStore('user', {
|
||||
this.user = {}
|
||||
this.roleId = 0
|
||||
this.permissions = []
|
||||
this.employees = []
|
||||
this.currentEmployeeId = 0
|
||||
// 菜单/入口一并清空:退出登录、401、清缓存都不能让旧身份的入口残留
|
||||
usePermissionStore().reset()
|
||||
},
|
||||
|
||||
/** 更新 token(响应头续期的场景由 request 层写入存储,这里同步内存副本) */
|
||||
|
||||
@ -1,22 +1,25 @@
|
||||
/**
|
||||
* 登录守卫
|
||||
* 登录跳转与鉴权兜底
|
||||
*
|
||||
* 对应 new3(Web 端)的 `src/permission.ts`:
|
||||
* Web 端靠 vue-router 的 beforeEach 拦截未登录访问,
|
||||
* 小程序没有路由守卫,改用 `uni.addInterceptor` 拦截所有跳转 API,效果等价。
|
||||
* ⚠️ 设计约定(微信审核要求):**不在打开小程序时强制跳转登录页**
|
||||
* - 启动页是首页,未登录也能正常浏览
|
||||
* - 登录入口在「我的」页,由用户主动点击进入
|
||||
* - 登录页提供「取消」,可返回来源页
|
||||
*
|
||||
* 覆盖范围:navigateTo / redirectTo / reLaunch / switchTab 四个跳转 API,
|
||||
* 基本等同于「页面级」访问控制。
|
||||
* 本模块只负责「**按需**导向登录页」:
|
||||
* 1. 请求命中 HTTP 401 / token 失效(见 `utils/request.ts`)
|
||||
* → 带来源页参数跳登录页
|
||||
* 2. 登录成功后由 `pages/login/login.vue` 回跳来源页
|
||||
*
|
||||
* 历史说明:曾用 `uni.addInterceptor` 拦截所有跳转 API、未登录一律导向登录页,
|
||||
* 因违反「不能一打开就强制登录」的要求**已移除**。
|
||||
* 若后续需要对个别页面做前置校验,建议在页面内用
|
||||
* `useUserStore().isLogin` 自行判断并引导,不要恢复全局拦截。
|
||||
*/
|
||||
|
||||
import { getToken } from './auth'
|
||||
|
||||
/** 登录页路径(路由拦截与 401 跳转的唯一来源,改路径只需改这里) */
|
||||
/** 登录页路径(所有跳转登录页的唯一来源,改路径只需改这里) */
|
||||
export const LOGIN_PAGE = '/pages/login/login'
|
||||
|
||||
/** 免登录白名单 */
|
||||
const WHITE_LIST: string[] = [LOGIN_PAGE]
|
||||
|
||||
/** 跳转登录页的节流标记,避免并发 401 触发多次 reLaunch */
|
||||
let redirecting = false
|
||||
|
||||
@ -43,33 +46,10 @@ export function redirectToLogin(redirect?: string): void {
|
||||
uni.reLaunch({
|
||||
url: `${LOGIN_PAGE}${query}`,
|
||||
complete: () => {
|
||||
// 留出缓冲:reLaunch 完成前若再触发拦截,也不重复跳转
|
||||
// 留出缓冲:并发 401 时也不重复跳转
|
||||
setTimeout(() => {
|
||||
redirecting = false
|
||||
}, 800)
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
/**
|
||||
* 注册全局路由拦截:未登录时阻止跳转并导向登录页
|
||||
* 需在应用启动时调用一次(见 App.vue 的 onLaunch)
|
||||
*/
|
||||
export function setupAuthGuard(): void {
|
||||
const apis = ['navigateTo', 'redirectTo', 'reLaunch', 'switchTab'] as const
|
||||
|
||||
apis.forEach((api) => {
|
||||
uni.addInterceptor(api, {
|
||||
invoke(args: { url?: string }) {
|
||||
const path = (args?.url || '').split('?')[0]
|
||||
// 白名单与无路径的调用(如 navigateBack 的占位)直接放行
|
||||
if (!path || WHITE_LIST.includes(path)) return args
|
||||
if (getToken()) return args
|
||||
|
||||
// 返回 false 取消本次跳转,同时导向登录页
|
||||
redirectToLogin(args.url)
|
||||
return false
|
||||
}
|
||||
})
|
||||
})
|
||||
}
|
||||
|
||||
34
src/utils/navigate.ts
Normal file
34
src/utils/navigate.ts
Normal file
@ -0,0 +1,34 @@
|
||||
/**
|
||||
* 统一的页面跳转
|
||||
*
|
||||
* 为什么要收口:小程序里跳 **tabBar 页必须用 `uni.switchTab`**(用 `navigateTo` 会失败),
|
||||
* 而「是不是 tabBar 页」的信息在 `PAGE_REGISTRY` 里。
|
||||
* 业务代码只负责给「物理页面路径」,由这里决定用哪个 API。
|
||||
*/
|
||||
|
||||
import { isTabBarPage } from '@/router/pages'
|
||||
|
||||
/**
|
||||
* 跳到指定物理页面
|
||||
* @param path 物理页面路径(`PAGE_REGISTRY.path`,带不带前导 `/` 都行)
|
||||
* @param title 失败提示里显示的页面名
|
||||
*/
|
||||
export function navigateToPath(path: string, title = '该页面'): void {
|
||||
if (!path) return
|
||||
|
||||
const url = `/${path.replace(/^\//, '')}`
|
||||
|
||||
if (isTabBarPage(path)) {
|
||||
// tabBar 页只能用 switchTab
|
||||
uni.switchTab({ url })
|
||||
return
|
||||
}
|
||||
|
||||
uni.navigateTo({
|
||||
url,
|
||||
fail: () => {
|
||||
// 最常见原因:页面没注册进 pages.json(静态路由表漂移)→ 跑 `npm run check:pages` 排查
|
||||
uni.$u.toast(`「${title}」暂未开放`)
|
||||
}
|
||||
})
|
||||
}
|
||||
@ -11,26 +11,44 @@
|
||||
* 与 new3 的差异(小程序端限制所致):
|
||||
* - axios → uni.request
|
||||
* - new3 的 `isSystemApi` 标记在那边**从未被消费**(死字段),故不移植
|
||||
* - 不反向依赖 Pinia store,避免 request ↔ store ↔ api 的循环引用;
|
||||
* - **不引入 userStore**:会形成 request → userStore → api → request 的循环引用;
|
||||
* token 以 utils/auth 的本地存储为唯一来源
|
||||
* - 但**会引入 permissionStore**(它只依赖 router/entries、不依赖 api,不构成循环),
|
||||
* 用于在 401 时清掉菜单缓存
|
||||
*
|
||||
* ───────────────── 已实测的后端契约(勿随意改动)─────────────────
|
||||
* 1. 请求头 `platform` / `project` 由网关切学校验,**非白名单值直接返回 HTTP 400 且响应体为空**:
|
||||
* - platform 白名单:web / app / wx / miniprogram
|
||||
* - project 白名单:all / wms
|
||||
* 故二者交由 .env 配置,不要硬编码平台编码。
|
||||
* 2. 未登录 / token 失效:**HTTP 401 + 空响应体**(不是业务码)。
|
||||
* 3. 业务响应:`{ flag, code, message, success, data }`
|
||||
* - 成功:flag='success' / success=true,code 可能是 200、1 等多种值
|
||||
* - 失败:flag='failure' / success=false,**code 恒为 0**
|
||||
* ⇒ 判断成败**必须看 flag / success**,仅看 code 会把失败当成功。
|
||||
*/
|
||||
|
||||
import { getToken, removeToken, setToken } from './auth'
|
||||
import { redirectToLogin } from './auth-guard'
|
||||
import { usePermissionStore } from '@/store/modules/permission'
|
||||
|
||||
/** 接口根地址,来自 .env.[mode] */
|
||||
const BASE_URL = (import.meta.env.VITE_APP_BASE_API as string) || ''
|
||||
|
||||
/** 请求头 platform 标记:小程序端与 Web 端('web')区分,便于后端统计来源 */
|
||||
let platform = 'web'
|
||||
// #ifdef MP-WEIXIN
|
||||
platform = 'mp-weixin'
|
||||
// #endif
|
||||
/**
|
||||
* 请求头 platform:后端网关校验,非白名单直接 HTTP 400
|
||||
* (实测白名单:web / app / wx / miniProgram,**大小写不敏感**;mp-weixin / h5 / mp / mobile 等被拒)
|
||||
* 本项目固定(由后端约定):miniProgram
|
||||
*/
|
||||
const PLATFORM = (import.meta.env.VITE_APP_PLATFORM as string) || 'miniProgram'
|
||||
|
||||
/** 业务成功码:后端 /system 网关以 code=1 表示成功,其余为兼容保留 */
|
||||
const SUCCESS_CODES = [1, 0, 200, 20000]
|
||||
/** 请求头 project:后端同样校验(实测白名单:all / wms) */
|
||||
const PROJECT = (import.meta.env.VITE_APP_PROJECT as string) || 'all'
|
||||
|
||||
/** 登录失效业务码:命中后清 token 并回登录页 */
|
||||
/**
|
||||
* 登录失效业务码:本后端实际用 **HTTP 401(空响应体)** 表达未登录,
|
||||
* 这几个码作为兼容兜底保留(来自 new3 的 vue-element-admin 遗留码,后端未使用)。
|
||||
*/
|
||||
const TOKEN_EXPIRED_CODES = [401, 50008, 50012, 50014]
|
||||
|
||||
/** 无权限业务码 */
|
||||
@ -76,12 +94,32 @@ const HTTP_STATUS_MAP: Record<number, string> = {
|
||||
505: 'HTTP 版本不受支持'
|
||||
}
|
||||
|
||||
/** 后端统一响应结构 */
|
||||
/** 后端统一响应结构(/system 网关) */
|
||||
export interface BizResponse<T = any> {
|
||||
/** 业务结果标识:'success' | 'failure' */
|
||||
flag?: string
|
||||
/** 业务结果布尔值,与 flag 等价 */
|
||||
success?: boolean
|
||||
/** 业务码:成功可能是 200 / 1 等多种,**失败恒为 0**,故不可单独用它判成败 */
|
||||
code: number
|
||||
message?: string
|
||||
msg?: string
|
||||
data: T
|
||||
[key: string]: any
|
||||
}
|
||||
|
||||
/**
|
||||
* 业务成功判定
|
||||
*
|
||||
* ⚠️ 必须基于 flag / success,不能只看 code:
|
||||
* 实测成功响应 code 为 200(user.login)或 1(storage.inventory.list),
|
||||
* 而失败响应 code 恒为 0 —— 若把 0 当成功,会把失败静默当成成功处理。
|
||||
*/
|
||||
function isBizSuccess(body: BizResponse): boolean {
|
||||
if (typeof body.success === 'boolean') return body.success
|
||||
if (typeof body.flag === 'string') return body.flag === 'success'
|
||||
// 两个字段都缺失时,退回旧的成功码判定
|
||||
return body.code === 1 || body.code === 200 || body.code === 20000
|
||||
}
|
||||
|
||||
export interface RequestOptions {
|
||||
@ -146,6 +184,22 @@ function syncRenewedToken(header: Record<string, string>): void {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 登录失效:清掉本地 token 与菜单缓存,然后再跳登录页
|
||||
*
|
||||
* ⚠️ 必须 `removeToken()`:否则跳登录页后,登录页 `onShow` 里的
|
||||
* `if (getToken()) goAfterLogin()` 会立刻把用户送回刚才那个页面
|
||||
* → 再次 401 → 死循环。
|
||||
*/
|
||||
function clearSession(): void {
|
||||
removeToken()
|
||||
try {
|
||||
usePermissionStore().reset()
|
||||
} catch {
|
||||
// Pinia 尚未安装(极早期请求)时忽略:此时也没有可清的菜单缓存
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 发起请求
|
||||
* @returns 后端响应体(未解包 data,与 new3 的拦截器行为一致)
|
||||
@ -176,8 +230,8 @@ export default function request<T = any>(options: RequestOptions): Promise<BizRe
|
||||
timeout,
|
||||
header: {
|
||||
'content-type': 'application/json',
|
||||
platform,
|
||||
project: 'all',
|
||||
platform: PLATFORM,
|
||||
project: PROJECT,
|
||||
...(token ? { Authorization: `Bearer ${token}` } : {}),
|
||||
...header
|
||||
},
|
||||
@ -190,6 +244,7 @@ export default function request<T = any>(options: RequestOptions): Promise<BizRe
|
||||
// ── HTTP 层:非 2xx ──
|
||||
if (status < 200 || status >= 300) {
|
||||
if (status === 401) {
|
||||
clearSession()
|
||||
redirectToLogin()
|
||||
reject(new Error('未授权,请重新登录'))
|
||||
return
|
||||
@ -208,12 +263,13 @@ export default function request<T = any>(options: RequestOptions): Promise<BizRe
|
||||
return
|
||||
}
|
||||
|
||||
// ── 业务层:非成功码 ──
|
||||
if (!SUCCESS_CODES.includes(body.code)) {
|
||||
// ── 业务层:失败(以 flag / success 判定,见 isBizSuccess 注释)──
|
||||
if (!isBizSuccess(body)) {
|
||||
const message =
|
||||
body.message || body.msg || ERROR_CODE_MAP[body.code] || '请求失败'
|
||||
|
||||
if (TOKEN_EXPIRED_CODES.includes(body.code)) {
|
||||
clearSession()
|
||||
redirectToLogin()
|
||||
reject(new Error(message))
|
||||
return
|
||||
|
||||
169
微信小程序开发清单.md
169
微信小程序开发清单.md
@ -18,16 +18,24 @@
|
||||
| 应用名称 | ✅ 已配置 | `WMS 小程序` |
|
||||
| 按需注入 / 分包优化 | ✅ 已开启 | 产物 `app.json` 已含 `lazyCodeLoading` |
|
||||
| 目录结构(第 2 节) | ✅ 已完成 | 已建 `api` / `components` / `composables` / `store` / `utils` / 分包目录 |
|
||||
| 页面框架(tabBar) | ✅ 已完成 | 4 个底部 Tab:工作台 / 任务 / 库存 / 我的(纯文字)|
|
||||
| 页面框架(tabBar) | ✅ 已完成 | **2 个底部 Tab:首页 / 我的**(纯文字);「任务」「库存」页已按要求移除 |
|
||||
| tabBar 图标 | ❌ 待补充 | 需本地图片 ≤ 40KB、81×81px |
|
||||
| 分包(pages.json 注册) | ❌ 未注册 | 目录已建,待第 3 节注册到 `subPackages` |
|
||||
| 分包(pages.json 注册) | 🚧 部分注册 | `pagesA` 已注册(当前放框架示例页);`pagesB` / `pagesC` 待业务页一起注册 |
|
||||
| 请求封装(第 5 节) | ✅ 已完成 | `utils/request.ts`,对齐 new3,含 token 注入 / 响应头续期 / 401 处理 |
|
||||
| 登录鉴权(第 6 节) | ✅ 已完成 | 账号密码登录 + 注册;`pages/login/login` 为启动页;`utils/auth-guard.ts` 全局跳转拦截 |
|
||||
| 登录鉴权(第 6 节) | ✅ 已完成 | 账号密码登录 + 注册;登录入口在「我的」页(启动页为首页,不强制登录);401 按需引导登录 |
|
||||
| Pinia 状态管理(第 8 节) | ✅ 已完成 | `pinia@2.1.7`(Vue 3.4 兼容版),见 `store/modules/user.ts` |
|
||||
| 环境变量(第 11 节) | ✅ 已完成 | `.env.development` / `.env.production` 的 `VITE_APP_BASE_API` |
|
||||
| 环境变量(第 11 节) | ✅ 已完成 | `.env.development` / `.env.production`:`VITE_APP_BASE_API` / `VITE_APP_PLATFORM` / `VITE_APP_PROJECT` |
|
||||
| 静态路由表(阶段 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/*` 两个示例页 |
|
||||
| 页面渲染框架 | 🚧 开发中(阶段 1、2、2.5、3、4 已完成) | 见第 12 节与《页面渲染框架-设计与任务清单.md》 |
|
||||
| 身份(角色/仓库)展示 | ✅ 已完成 | 「我的」页登录后显示:姓名 / 身份类型 / 所属组织 / 员工 ID / 授权到期;数据来自 `user.info` 的 `employees[]`,**不改数据库** |
|
||||
| 身份切换 `changeRole` | 🚧 已实现待联调 | 入口在「我的」页(多身份时出现);接口已实测存在,返回结构待后端确认 |
|
||||
| 微信一键登录 / 扫码登录 | ❌ 未做 | 属另一条链路(`uni.login` → `user.loginByCode`),本次范围外 |
|
||||
|
||||
> 已知坑:同时跑两个 `dev:mp-weixin` 进程会写坏产物,导致预览报
|
||||
> 📄 **配套文档**:`页面渲染框架-设计与任务清单.md` —— 菜单 / 权限 / 页面渲染的决策与任务清单(第 12 节为摘要)
|
||||
> ⚠️ **已知坑**:同时跑两个 `dev:mp-weixin` 进程会写坏产物,导致预览报
|
||||
> `ENOENT ... common/assets.js`。详见第 9 节。
|
||||
|
||||
---
|
||||
@ -112,6 +120,8 @@ d:\wechat\
|
||||
├── tsconfig.json # TS 配置
|
||||
├── vite.config.ts # Vite 配置(挂载 uni 插件)
|
||||
├── 微信小程序开发清单.md # 本清单
|
||||
├── scripts/
|
||||
│ └── check-pages.mjs # 静态路由表 ↔ pages.json 一致性校验
|
||||
└── src/
|
||||
├── main.ts # 应用入口
|
||||
├── App.vue # 根组件(全局样式 + 应用生命周期)
|
||||
@ -123,21 +133,27 @@ d:\wechat\
|
||||
├── api/ # 接口层
|
||||
│ └── user/user.ts # 登录 / 注册 / 用户信息 / 退出(/system 网关)
|
||||
├── components/ # 全局组件(easycom 扫描)
|
||||
│ ├── auth-gate/auth-gate.vue # 三态渲染(public / optional / required)
|
||||
│ ├── empty-state/empty-state.vue # 统一空态/失败提示 + 「重试」
|
||||
│ └── login-panel/login-panel.vue # 登录 / 注册面板组件
|
||||
├── composables/ # 组合式函数
|
||||
│ └── usePageAuth.ts # 页面登录策略与「去登录」跳转
|
||||
├── router/ # 静态路由表与入口树生成
|
||||
│ ├── pages.ts # PAGE_REGISTRY / PAGE_MAP / PAGE_BY_PATH / isTabBarPage
|
||||
│ └── entries.ts # generateEntries():菜单 × 路由表 → 可见入口树(纯函数)
|
||||
├── store/ # 状态管理(Pinia)
|
||||
│ └── modules/user.ts # 登录态(token / 用户信息 / 权限点)
|
||||
│ └── modules/ # user.ts(登录态/身份/权限点)、permission.ts(菜单与可见入口)
|
||||
├── utils/ # 工具函数
|
||||
│ ├── auth.ts # token 本地存取(唯一写入方)
|
||||
│ ├── auth-guard.ts # 全局跳转拦截(等价 new3 的 permission.ts)
|
||||
│ ├── auth-guard.ts # 登录跳转(LOGIN_PAGE / redirectToLogin,不做全局拦截)
|
||||
│ ├── navigate.ts # 统一跳转(自动区分 switchTab / navigateTo)
|
||||
│ └── request.ts # uni.request 封装
|
||||
├── pages/ # 主包页面(启动页 + tabBar 页)
|
||||
│ ├── login/login.vue # 登录 / 注册页(pages 第一项 = 启动页)
|
||||
│ ├── index/index.vue # 工作台
|
||||
│ ├── task/task.vue # 任务
|
||||
│ ├── inventory/inventory.vue # 库存
|
||||
│ ├── login/login.vue # 登录 / 注册页(非启动页,由「我的」页主动进入)
|
||||
│ ├── index/index.vue # 首页(启动页):入口由 permissionStore / 本地公共清单驱动
|
||||
│ └── mine/mine.vue # 我的
|
||||
├── pagesA/ # 分包 A(规划:入库,待注册)
|
||||
├── pagesA/ # 分包 A(已注册;当前放框架示例页)
|
||||
│ └── demo/ # public.vue(公开示例)、required.vue(需登录 + 按钮级权限示例)
|
||||
├── pagesB/ # 分包 B(规划:出库,待注册)
|
||||
├── pagesC/ # 分包 C(规划:库存/盘点,待注册)
|
||||
└── static/ # 静态资源
|
||||
@ -189,8 +205,11 @@ d:\wechat\
|
||||
| 本地存储单个 key | 1 MB |
|
||||
| 本地存储总量 | 10 MB |
|
||||
|
||||
- [ ] **规划分包**(`src/pages.json` → `subPackages`)
|
||||
- [x] **规划分包**(`src/pages.json` → `subPackages`)—— 🚧 已注册 `pagesA`(放框架示例页)
|
||||
原则:主包只放 tabBar 页 + 启动必需页 + 公共资源;业务模块全部下沉到分包。
|
||||
✅ 已实测:产物 `app.json` 含 `subPackages`,页面落在 `dist/build/mp-weixin/pagesA/**`;
|
||||
`npm run check:pages` 能校验分包页的可达性(`PAGE_REGISTRY.path` 用 `pagesA/demo/public` 这种全路径)。
|
||||
待办:`pagesB`(出库)/ `pagesC`(库存/盘点)随业务页一起注册。
|
||||
```jsonc
|
||||
"subPackages": [
|
||||
{ "root": "pagesA", "pages": [ { "path": "inbound/list", "style": { ... } } ] }
|
||||
@ -213,22 +232,26 @@ d:\wechat\
|
||||
|
||||
## 4. 页面与导航
|
||||
|
||||
- [x] **配置 tabBar** ✅(4 个纯文字 Tab)
|
||||
- [x] **配置 tabBar** ✅(2 个纯文字 Tab:首页 / 我的)
|
||||
|
||||
| Tab | 页面路径 | 页面内容 |
|
||||
|---|---|---|
|
||||
| 工作台 | `pages/index/index` | 业务入口九宫格(入库/出库/盘点/扫码/库存查询/调拨)+ 运行信息 |
|
||||
| 任务 | `pages/task/task` | 待处理/已处理/全部 分段 + 空态 |
|
||||
| 库存 | `pages/inventory/inventory` | 搜索 + 扫码查询 + 空态 |
|
||||
| 我的 | `pages/mine/mine` | 登录态展示(未登录可点击去登录)+ 运行信息 + 清除缓存 + 退出登录 |
|
||||
| 首页 | `pages/index/index` | 业务入口九宫格(未登录取本地公共入口;登录后取后端菜单,支持「分组标题 + 子项」两层)+ 运行信息 |
|
||||
| 我的 | `pages/mine/mine` | 未登录:「登录 / 注册」按钮;已登录:登录态展示 + 退出登录;另有运行信息 + 清除缓存 |
|
||||
|
||||
约定(务必遵守):
|
||||
- `list` 最少 2 个、最多 5 个;**tabBar 页必须在主包**,不能放分包
|
||||
- 跳转到 tabBar 页只能用 `uni.switchTab`,**不能**用 `navigateTo` / `redirectTo`
|
||||
- tabBar 页首次进入触发 `onLoad` + `onShow`,之后切换**只触发 `onShow`**(数据刷新放 `onShow`)
|
||||
|
||||
> 实测确认:产物 `app.json` 已包含完整 `tabBar` 配置与 4 个页面;
|
||||
> 实测确认:产物 `app.json` 已包含完整 `tabBar` 配置与 3 个页面(index / mine / login);
|
||||
> 各页面 `usingComponents` 只包含自己用到的组件,按需引入正常。
|
||||
>
|
||||
> 📌 **2026-09-19 页面精简**:按需求移除「任务」「库存」两个 tab 页
|
||||
> (`pages/task/task.vue`、`pages/inventory/inventory.vue` 已删除,
|
||||
> `pages.json` 的 `pages` / `tabBar.list` / `condition.list` 三处已同步清理)。
|
||||
> 首页九宫格里的「库存查询」入口是**规划中的分包页面占位**(见 `pagesC`),
|
||||
> 与已移除的「库存」tab 不是同一个东西,故保留。
|
||||
|
||||
- [ ] **补充 tabBar 图标(待办)**
|
||||
当前为**纯文字 Tab**(`iconPath` 是可选字段,不带图标也能正常运行)。
|
||||
@ -237,22 +260,22 @@ d:\wechat\
|
||||
再在 `pages.json` 的 `tabBar.list` 各项目补上 `iconPath` 与 `selectedIconPath`。
|
||||
|
||||
- [x] **确认首页与标题** ✅
|
||||
标题已由模板默认值 `uni-app` 改为实际业务名:工作台 / 任务 / 库存 / 我的;
|
||||
标题已由模板默认值 `uni-app` 改为实际业务名:首页 / 我的 / 登录;
|
||||
`globalStyle` 兜底标题为 `WMS 小程序`。
|
||||
**启动页由 `pages` 数组第一项决定**:第 6 节接入登录后,第一项已改为 `pages/login/login`
|
||||
(登录 / 注册页),原 `pages/index/index` 退为第二个页面(tabBar 首页)。
|
||||
原因:内部仓储工具必须登录后才能用,从登录页启动可避免首屏闪出工作台与未授权请求。
|
||||
未登录访问其他页面由 `utils/auth-guard.ts` 的全局跳转拦截兜底。
|
||||
**启动页由 `pages` 数组第一项决定**,当前为 `pages/index/index`(首页)。
|
||||
⚠️ **不得把登录页设为首项**:微信审核要求打开小程序不能直接强制登录
|
||||
(未登录也必须有可浏览的内容)。登录页 `pages/login/login` 排在末位,
|
||||
由用户从「我的」页主动进入,详见第 6 节。
|
||||
|
||||
- [x] **配置页面级启动模式(开发提效)** ✅
|
||||
`src/pages.json` → `condition` 已配置 4 个编译模式,**仅开发期生效**。
|
||||
`src/pages.json` → `condition` 已配置 3 个编译模式(首页 / 登录 / 我的),**仅开发期生效**。
|
||||
微信开发者工具顶部「编译模式」下拉即可直达对应页面。
|
||||
|
||||
- [x] **约定页面生命周期用法** ✅(已在页面中示范)
|
||||
- 页面级:`onLoad`(取参、初始化)、`onShow`(刷新数据)、`onReachBottom`(分页加载)、`onPullDownRefresh`(下拉刷新)
|
||||
- 组合式 API 下从 `@dcloudio/uni-app` 引入对应 Hook
|
||||
- 开启下拉刷新需同时设置 `enablePullDownRefresh: true` 并调用 `uni.stopPullDownRefresh()`
|
||||
> `pages/task/task.vue` 示范了 `onLoad` 读路由参数 + `onShow` 刷列表;
|
||||
> `pages/mine/mine.vue` 示范了在 `onShow` 刷新登录态;
|
||||
> 各 tabBar 页的 `onShow` 已留好接口接入位置(第 5 节)。
|
||||
|
||||
- [ ] **列表性能**(待接口接入后落实)
|
||||
@ -270,10 +293,37 @@ d:\wechat\
|
||||
位置:`src/utils/request.ts`(基于 `uni.request` 二次封装,行为对齐 new3 的 axios 封装)。
|
||||
已覆盖:baseURL(`.env` 的 `VITE_APP_BASE_API`)、超时、`platform` / `project` 请求头、
|
||||
`Authorization: Bearer <token>` 注入、响应头新 token 自动回写(续期场景)、
|
||||
业务码判定(`code=1` 为成功)、错误码文案映射、401 / 50008 / 50012 / 50014 → 清登录态回登录页、
|
||||
可选 `loading` 文案、失败统一 toast。
|
||||
**业务成败判定走 `flag` / `success`**(不能用 `code`,见下条)、错误码文案映射、
|
||||
HTTP 401 → 清登录态并带来源页回登录页、可选 `loading` 文案、失败统一 toast。
|
||||
> 注:new3 里的 `isSystemApi` 标记在 Web 端**从未被消费**(死字段),未移植。
|
||||
|
||||
- [x] **后端 /system 网关契约(实测,务必遵守)** ✅
|
||||
|
||||
| 项 | 实测结果 |
|
||||
|---|---|
|
||||
| `platform` 请求头 | **网关校验**,非白名单 → HTTP 400 且响应体为空。白名单:`web` / `app` / `wx` / **`miniProgram`**(**大小写不敏感**);本项目固定 `miniProgram` |
|
||||
| `project` 请求头 | 同样校验。白名单:`all` / `wms`;本项目固定 `all` |
|
||||
| 未登录 / token 失效 | **HTTP 401 + 空响应体**(不是业务码) |
|
||||
| 业务成功 | `{flag:"success", success:true, code: 200 或 1, data}` |
|
||||
| 业务失败 | `{flag:"failure", success:false, code: 0, message, data:null}` |
|
||||
|
||||
⚠️ **四个坑(已踩并修复)**:
|
||||
1. **不要用 uni-app 的平台名 `mp-weixin` 当 `platform`** —— 网关直接返回 400 + 空 body,
|
||||
前端只能显示通用「请求参数错误」,根因极难定位。故平台编码统一放
|
||||
`.env`(`VITE_APP_PLATFORM` / `VITE_APP_PROJECT`),不在代码里硬编码。
|
||||
2. **`code` 不能用来判成败** —— 失败响应 `code` 恒为 `0`,而 new3 的
|
||||
`SUCCESS_CODES = [200, 20000, 1, 0]` 把 `0` 当成功,**会把失败静默当成成功**
|
||||
(表现为密码错也不报错)。本项目已改为看 `flag` / `success`。
|
||||
3. `50008 / 50012 / 50014` 是 vue-element-admin 的遗留码,后端并不使用;
|
||||
真正的登录失效信号是 **HTTP 401**。
|
||||
4. **401 后必须 `removeToken()`** —— 否则跳登录页后,登录页 `onShow` 里的
|
||||
`if (getToken()) goAfterLogin()` 会把用户**立刻弹回**刚才那个页面
|
||||
→ 再次 401 → **死循环**。现已收口为 `utils/request.ts` 的
|
||||
`clearSession()`(`removeToken()` + 清空权限 store 缓存)+ 跳登录页。
|
||||
|
||||
> 排查手法(有效):直接用 PowerShell `Invoke-WebRequest` 打后端,逐变量对比状态码;
|
||||
> 用假账号探测能区分「参数被拒(400)」与「账号错误(200 + business message)」。
|
||||
|
||||
- [ ] **控制并发**
|
||||
微信小程序 `wx.request` 并发上限 **10 个**,批量场景(如批量提交盘点)需自行排队或分批。
|
||||
|
||||
@ -288,7 +338,7 @@ d:\wechat\
|
||||
## 6. 登录、鉴权与用户信息
|
||||
|
||||
- [x] **登录流程(账号密码版,对齐 new3)** ✅
|
||||
启动页 `pages/login/login` → 组件 `components/login-panel/` →
|
||||
入口 `pages/login/login`(**非启动页**,由「我的」页主动进入)→ 组件 `components/login-panel/` →
|
||||
`store/modules/user.ts` 的 `login()` → `api/user/user.ts` 的 `user.login`
|
||||
(`POST /system?method=user.login&v=1.0×tamp=...`,body `{ username, password, device }`)
|
||||
→ 响应 `data.token` 写入 `utils/auth.ts`。
|
||||
@ -303,11 +353,23 @@ d:\wechat\
|
||||
统一存于 `utils/auth.ts`(小程序无 Cookie,故用 `uni.getStorageSync`,key = `token`)。
|
||||
token 失效由 `utils/request.ts` 统一兜底(清存储 → `reLaunch` 登录页)。
|
||||
|
||||
- [x] **未登录访问控制** ✅
|
||||
`utils/auth-guard.ts` 用 `uni.addInterceptor` 拦截
|
||||
`navigateTo` / `redirectTo` / `reLaunch` / `switchTab`,
|
||||
未登录且目标非白名单时取消跳转并导向 `/pages/login/login?redirect=<来源页>`,
|
||||
登录成功后自动回跳来源页。等价于 new3 的 `permission.ts` + `router.beforeEach`。
|
||||
- [x] **登录入口与取消(微信审核要求,务必遵守)** ✅
|
||||
⚠️ **打开小程序不得直接跳登录页**,登录必须由用户主动触发:
|
||||
- 启动页 = 首页(`pages/index/index`),未登录可正常浏览
|
||||
- 登录入口 = 「我的」页的「登录 / 注册」按钮(点头像区同样可进入)
|
||||
- 登录页有「取消」:页面栈有上一页则 `navigateBack` 返回来源页,
|
||||
否则退回 `redirect` 指定页 / 首页
|
||||
- 登录成功:回跳 `redirect` 指定页(tabBar 页用 `switchTab`,其余用 `redirectTo`)
|
||||
- 退出登录:**停留在「我的」页**并自动切回未登录态,不强制跳登录页
|
||||
|
||||
- [x] **未登录访问控制(改为按需,不做全局拦截)** ✅
|
||||
`utils/auth-guard.ts` 只保留 `LOGIN_PAGE` / `getCurrentRoute()` / `redirectToLogin()`。
|
||||
**已移除**原先用 `uni.addInterceptor` 拦截 4 个跳转 API、未登录一律导向登录页的做法
|
||||
—— 那等价于「一打开就强制登录」,会被审核驳回。
|
||||
现在的兜底是「**按需触发**」:请求命中 **HTTP 401** 时(见 `utils/request.ts`)
|
||||
带着来源页跳登录,重新登录后自动回到刚才的页面。
|
||||
若后续需要给个别页面做前置校验,在页面内用 `userStore.isLogin` 自行判断并引导,
|
||||
**不要恢复全局拦截**。
|
||||
|
||||
- [ ] **不要使用 `getUserProfile`**
|
||||
该接口自 2022 年 10 月起已被微信回收,返回匿名数据。
|
||||
@ -456,7 +518,8 @@ d:\wechat\
|
||||
- [x] **区分环境** ✅
|
||||
已建 `.env.development`(`http://192.168.11.56:6060/`,与 new3 开发环境同一后端)
|
||||
与 `.env.production`(`https://qimen.wms.gztbyc.com/`,⚠️ 上线前按实际情况确认)。
|
||||
业务代码统一走 `import.meta.env.VITE_APP_BASE_API`。
|
||||
业务代码统一走 `import.meta.env.VITE_APP_BASE_API`;
|
||||
`VITE_APP_PLATFORM`(`miniProgram`)/ `VITE_APP_PROJECT`(`all`)为后端网关校验的请求头(契约见第 5 节)。
|
||||
> 实测验证:生产构建产物 `utils/request.js` 只含生产域名,开发地址未被混入。
|
||||
> 待补:`.env.staging`(测试环境)暂未配置,需要时按同样方式新增即可。
|
||||
|
||||
@ -465,6 +528,41 @@ d:\wechat\
|
||||
|
||||
---
|
||||
|
||||
## 12. 页面渲染框架(配套文档摘要)
|
||||
|
||||
菜单 / 权限 / 页面渲染的设计与任务清单独立维护在 **`页面渲染框架-设计与任务清单.md`**,
|
||||
本节只记录与本清单强相关的**已确认结论**,避免两处漂移。
|
||||
|
||||
| 项 | 结论 |
|
||||
|---|---|
|
||||
| 页面渲染驱动 | 后端 `user.info` 的 `menus`(页面树)+ `permissions`(权限点);**小程序不能动态注册路由**,靠本地静态路由表映射 |
|
||||
| 静态路由表 | ✅ 已实现:`src/router/pages.ts` 的 `PAGE_REGISTRY`(`key` = 逻辑路径 ↔ `path` = 物理页面,带 `auth` / `tabBar` / `hidden`);**只登记 pages.json 里真实存在的页面** |
|
||||
| 防漂移 | `npm run check:pages`:校验 `PAGE_REGISTRY.path` 已在 `pages.json` 注册、`key` 不重复;有未登记页面则告警 |
|
||||
| 权限 store | ✅ 已实现(阶段 2):`src/store/modules/permission.ts`(`menus` / `entries` / `missing` / `loaded`,动作 `loadFromMenus()` / `reset()`) |
|
||||
| 入口树生成 | ✅ 已实现:`src/router/entries.ts` 的 `generateEntries()`;未命中路由表的菜单项忽略并计入 `missing`,分组无子项则整组丢弃,输出**固定两层** |
|
||||
| `getInfo()` 触发时机 | ✅ 已收口:登录成功(`login()`)/ 启动带 token(`App.onLaunch`)/ 切换身份(`changeRole()`);`resetToken()` 联动清空权限 store |
|
||||
| 三态渲染 | ✅ 已实现(阶段 3):页面用 `<auth-gate auth="...">` 包裹即可,页面内不再写 `if (isLogin)`;`usePageAuth()` 的 `auth` 参数可省略(自动按当前页从 `PAGE_REGISTRY` 取) |
|
||||
| 「去登录」唯一实现 | ✅ `usePageAuth.goLogin()`:复用 `LOGIN_PAGE` + 自动带 `redirect` 回本页;**未登录一律不自动跳转** |
|
||||
| 本地公共入口 | `LOCAL_PUBLIC_ENTRIES`(`router/entries.ts`)= `auth === 'public' && !tabBar && !hidden`;当前为空数组 → 首页走空态文案(预期) |
|
||||
| 空态组件 | ✅ `components/empty-state/`:默认文案「服务器出差了,请稍后再试」+ 「重试」,可再挂一个「去登录」动作位 |
|
||||
| 可见性口径 | `isEntryVisible(meta) = !tabBar && !hidden`,**本地公共清单与后端菜单共用**(避免两处规则不一致) |
|
||||
| 首页入口渲染 | ✅ 已接入(阶段 4):`loading` → `sections`(分组标题 + 子项九宫格)→ `empty-state`(含重试,未登录额外给「去登录」);数据源:未登录 = `LOCAL_PUBLIC_ENTRIES`,已登录 = `permissionStore.entries` |
|
||||
| 「我的」功能菜单 | ✅ 已接入:与首页**同源**(`toSections(permissionStore.entries)`);`entries` 为空时整卡不渲染 |
|
||||
| 统一跳转 | ✅ `utils/navigate.ts`:按 `PAGE_REGISTRY` 自动决定 `switchTab` / `navigateTo`,失败提示「暂未开放」 |
|
||||
| 框架示例页 | `pagesA/demo/public`(`public`,未登录九宫格可见)、`pagesA/demo/required`(`required` + 按钮级权限示例);已加入开发编译模式,业务页上线后可删 |
|
||||
| 页面归属 | 「首页」`public`、「我的」`optional` —— **两者都是公共页面**(无需登录即可访问,不被拦截) |
|
||||
| 后端菜单 `path` | 用**逻辑路径**(如 `/inbound/list`),由前端映射到物理页面 |
|
||||
| 未登录九宫格 | **仅显示公共入口**;为空/请求失败时渲染空态文案(详见《页面渲染框架》§3.5.1) |
|
||||
| 空态文案(已确认) | 「未登录且为空」与「已登录拿不到数据」**统一**使用「服务器出差了,请稍后再试」+ 「重试」按钮 |
|
||||
| `required` 页未登录 | 页内「请先登录」+ 按钮,**不自动跳转** |
|
||||
| 角色/仓库切换 | `user.changeRole({ roleId })`,`roleId` = `user.info` 的 `employees[].id`;✅ 接口已实测存在(无 token 调用 → 401) |
|
||||
| 当前身份状态 | `userStore` 已含 `employees` / `currentEmployeeId`;默认身份:本地已选 > 后端会话 `employees_id` > `is_primary` > 授权未过期 > 第一个 |
|
||||
| 身份展示 | ✅ 已完成(2026-09-19):「我的」页登录后显示身份信息卡片(姓名/类型/组织/员工 ID/授权到期) |
|
||||
| 身份切换 | 🚧 已实现待联调(2026-09-19):多身份时「我的」页出现「切换身份」行,选后调 `user.changeRole` → 换 token → 重拉 `user.info` |
|
||||
| 请求头 | `platform: miniProgram` / `project: all`(见第 5 节契约) |
|
||||
|
||||
---
|
||||
|
||||
## 附录 A:常用命令
|
||||
|
||||
| 命令 | 作用 |
|
||||
@ -474,6 +572,7 @@ d:\wechat\
|
||||
| `npm run dev:h5` | H5 开发调试 |
|
||||
| `npm run build:h5` | H5 生产构建 |
|
||||
| `npm run type-check` | 类型检查(vue-tsc) |
|
||||
| `npm run check:pages` | 静态路由表一致性校验(`PAGE_REGISTRY` ↔ `pages.json`),出错返回退出码 1 |
|
||||
|
||||
## 附录 B:关键文件职责速查
|
||||
|
||||
|
||||
689
页面渲染框架-设计与任务清单.md
Normal file
689
页面渲染框架-设计与任务清单.md
Normal file
@ -0,0 +1,689 @@
|
||||
# 小程序页面渲染框架 · 设计与下一步任务清单
|
||||
|
||||
> 项目:`wms_mp_weixin`(WMS 微信小程序端)
|
||||
> 参考:`new3`(Web 管理端,动态路由)、`cankao`(shopro 小程序,后端菜单驱动)
|
||||
> 状态:**决策已确认,开发中**。阶段 1、2、3、4 与阶段 2.5 已完成;阶段 2.5 待联调,阶段 5 待验证。
|
||||
> 编写日期:2026-09-19
|
||||
> 变更记录:
|
||||
> - 2026-09-19 页面精简 —— 仅保留「首页」「我的」两个 tab 页,「任务」「库存」页已移除
|
||||
> - 2026-09-19 **决策确认** —— 见 §4;「工作台」更名为「首页」;`platform` 定为 `miniProgram`
|
||||
> - 2026-09-19 **契约补充** —— `user.changeRole` 入参确认为 `employees[].id`;空态文案见 §3.5.1
|
||||
> - 2026-09-19 **空态文案确认** —— 「未登录且为空」与「已登录拿不到数据」**统一使用**「服务器出差了,请稍后再试」
|
||||
> - 2026-09-19 **开发进度** —— `userStore` 新增身份状态(`employees` / `currentEmployeeId`)+「我的」页身份信息卡片已实现(不改数据库)
|
||||
> - 2026-09-19 **阶段 2.5 完成** —— `user.changeRole` + `userStore.changeRole()` + 「我的」页切换身份入口;
|
||||
> 实测网关确认 **接口已存在**(无 token 调用 → HTTP 401;不存在的方法 → HTTP 500),返回结构仍待后端确认
|
||||
> - 2026-09-19 **阶段 1 完成** —— 新增 `src/router/pages.ts`(`PAGE_REGISTRY` / `PAGE_MAP` / `PAGE_BY_PATH` + 查询小工具)
|
||||
> 与 `npm run check:pages` 一致性校验脚本;新增 `hidden` 字段用于区分「公共页面」与「可作为九宫格入口的页面」
|
||||
> - 2026-09-19 **阶段 2 完成** —— 新增 `router/entries.ts`(菜单 × 路由表 → 入口树,纯函数)
|
||||
> 与 `store/modules/permission.ts`;`getInfo()` 触发时机收口到「登录成功 / 启动带 token / 切换身份」,
|
||||
> `resetToken()` 联动 `permissionStore.reset()`;
|
||||
> 顺带修掉一个真 bug:**401 时未清 token**,导致登录页 `onShow` 把用户弹回原页 → 401 死循环
|
||||
> - 2026-09-19 **阶段 3 完成** —— 新增 `composables/usePageAuth.ts`、`components/auth-gate/`(三态渲染)、
|
||||
> `components/empty-state/`(统一空态文案 + 重试);`LOCAL_PUBLIC_ENTRIES` 落在 `router/entries.ts`;
|
||||
> 「去登录」收口到 `usePageAuth.goLogin()`,`mine.vue` 已改用它
|
||||
> - 2026-09-19 **阶段 4 完成** —— 首页九宫格改为权限 store 驱动(分组标题 + 子项九宫格两层渲染);
|
||||
> 「我的」新增功能菜单;新增 `pagesA/demo/public`(`public`)与 `pagesA/demo/required`(`required` + 按钮级权限示例);
|
||||
> 新增 `utils/navigate.ts` 统一跳转;**修掉一个真缺陷**:本地路由表的 `hidden` 未被后端菜单口径遵守
|
||||
|
||||
---
|
||||
|
||||
## 0. 结论摘要(TL;DR)
|
||||
|
||||
1. **后端的权限体系已经完全支持多端**:`wms_permission.type` 枚举里**已经预留 `miniprogram_pages`(小程序页面)**,小程序不需要新建任何表。
|
||||
2. **但该类型目前是 0 条数据** —— 这是"等待后端补充设计"的核心内容,需要后端补页面数据 + 给角色授权。
|
||||
3. `user.info` 返回的两块数据就是渲染框架的全部输入:
|
||||
- `data.menus` → 菜单树(Web 端样本对应 `type='web_pages'`)
|
||||
- `data.permissions` → 权限点字符串数组(= `type='api'` 的 `path`,已逐条验证)
|
||||
4. **小程序端不能照搬 new3 的动态路由**(`router.addRoute`):小程序所有页面必须编译期注册在 `pages.json`。
|
||||
正确做法 = **本地静态路由表 + 后端菜单只做筛选/排序/可见性**(即 cankao 的思路)。
|
||||
5. **登录策略遵循微信审核要求**:未登录也能浏览,登录由用户从「我的」主动触发(现已实现)。
|
||||
页面按 `public` / `optional` / `required` 三态渲染,未登录时**页内提示**而非强制跳转。
|
||||
6. **决策点已全部确认**(详见 §4):
|
||||
- 「首页」「我的」为**公共页面**(无需登录即可访问)
|
||||
- 后端 `path` 用**逻辑路径**;未登录时九宫格**仅显示公共入口**
|
||||
- `required` 页未登录 → **页内「请先登录」+ 按钮**(不自动跳转)
|
||||
- **本期做 `changeRole`**(角色/仓库切换)
|
||||
- 请求头固定 `platform: miniProgram` / `project: all`;登录后用 `user.info` 获取菜单与权限
|
||||
|
||||
---
|
||||
|
||||
## 1. 已核实的数据契约(含证据)
|
||||
|
||||
### 1.1 `wms_permission` 表结构(实测)
|
||||
|
||||
```sql
|
||||
-- 数据库 wms
|
||||
id int PK
|
||||
path varchar 路由路径 / **API 方法名**(随 type 变化,见下表)
|
||||
component varchar 组件路径(web 端为 Layout 或 @/views/xxx;非 web 端多为空)
|
||||
name varchar 路由名称(有索引 MUL)
|
||||
redirect varchar 重定向路径
|
||||
meta_title varchar 页面标题
|
||||
meta_icon varchar 图标
|
||||
hidden tinyint 0 显示 / 1 隐藏
|
||||
always_show tinyint 是否始终显示
|
||||
parent_id int 父级 ID(根节点为 NULL)
|
||||
sort int 排序
|
||||
status tinyint 0 禁用 / 1 启用
|
||||
type enum **权限类型**(见下)
|
||||
created_at / update_at
|
||||
```
|
||||
|
||||
`type` 枚举原文:
|
||||
|
||||
```
|
||||
web_pages:电脑端页面 pda_pages:PDA页面 btns:按钮权限 api:接口权限
|
||||
miniprogram_pages:小程序页面 block:功能模块 workerstation_pages:工作台菜单
|
||||
```
|
||||
|
||||
### 1.2 各类型现有数据量(实测)
|
||||
|
||||
| type | 条数 | 启用 | `path` 字段含义 |
|
||||
|---|---|---|---|
|
||||
| `api` | 259 | 259 | **API 方法名**,如 `warehouse.create`、`store.getStoreRoles` |
|
||||
| `web_pages` | 89 | 89 | Web 路由路径,如 `/order`、`/storage` |
|
||||
| `pda_pages` | 47 | 46 | PDA 页面路径 |
|
||||
| `block` | 12 | 12 | 功能模块标识 |
|
||||
| `workerstation_pages` | 3 | 3 | 工作台菜单路径,如 `/order`、`/catchWeight` |
|
||||
| **`miniprogram_pages`** | **0** | — | **⚠️ 待后端补充** |
|
||||
|
||||
> 参照 `workerstation_pages` 的形态:`component` 为空字符串(分组/入口节点不需要组件),
|
||||
> 可直接作为 `miniprogram_pages` 的建模模板。
|
||||
|
||||
### 1.3 权限链路(实测表结构)
|
||||
|
||||
```
|
||||
wms_account 登录账号(id/username/phone/email/password_hash/real_name/status/last_login_ip)
|
||||
│
|
||||
▼
|
||||
wms_account_store_employee 账号在某个货主下的员工身份(id/store_id/is_primary/real_name/auth_end/role_type)
|
||||
│ ← 即 user.info 返回的 data.employees[]
|
||||
▼
|
||||
wms_employee_role employee_id ↔ role_id
|
||||
│
|
||||
▼
|
||||
wms_role 角色(id/role_code/role_name/role_type/scope/is_system/status/store_id/pid/**permissions**)
|
||||
│ permissions = '*'(全量) 或 '[13,18,48,...]'(wms_permission.id 列表)
|
||||
▼
|
||||
wms_permission 按 type 过滤出「该端的页面」+「api 权限点」
|
||||
```
|
||||
|
||||
**关键点**:`wms_role.permissions` 存的是 **`wms_permission.id` 的 JSON 数组**(或 `*`),
|
||||
不是权限点字符串。后端负责把它展开成最终结果返回给前端。
|
||||
|
||||
### 1.4 `user.info` 返回结构(取自 new3 真实抓包样本)
|
||||
|
||||
```jsonc
|
||||
{
|
||||
"flag": "success", "code": 200, "message": "获取成功{}", "success": true,
|
||||
"data": {
|
||||
"id": 3, "status": 1, "avatar": "...",
|
||||
"auth_end": "2099-12-26",
|
||||
"employees_id": 34, "employees_name": "殷建铭",
|
||||
"loginIp": "...", "store_id": 1000028, "store_name": "天豹云仓",
|
||||
"store_type": "warehouse", // warehouse | store ...
|
||||
"userRole": "customer",
|
||||
"platform_code": "web", // ★ 与请求头 platform 对应
|
||||
"employees": [ // 该账号在多个货主下的身份
|
||||
{ "id": 34, "store_id": 1000028, "store_name": "天豹云仓",
|
||||
"is_primary": 0, "real_name": "殷建铭", "auth_end": "2099-12-26", "role_type": "warehouse" }
|
||||
],
|
||||
"menus": [ // ★ 页面树(渲染框架的核心输入)
|
||||
{
|
||||
"path": "/order", "component": "Layout", "name": "Order",
|
||||
"redirect": "", "hidden": false, "alwaysShow": false,
|
||||
"meta": { "title": "订单", "icon": null },
|
||||
"children": [ /* 递归同构 */ ]
|
||||
}
|
||||
],
|
||||
"permissions": [ // ★ 接口权限点(= type='api' 的 path)
|
||||
"dashboard.hotOrderRank", "store.getStoreRoles", "store.auditApply"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**已验证的对应关系**(逐条比对,非推测):
|
||||
|
||||
| 结论 | 证据 |
|
||||
|---|---|
|
||||
| `menus` = `type='web_pages'` 的树(样本 platform_code='web') | 样本 16 个根节点与 `web_pages` 中 `parent_id IS NULL` 的 16 行**完全一致**(path/component/name/meta_title/sort 逐条对上) |
|
||||
| `permissions` = `type='api'` 的 `path` 列表 | 样本含 `store.getStoreRoles`、`store.auditApply`,正是 `wms_permission` 中 id=52、53 两行的 `path` |
|
||||
| 父节点 `component='Layout'`,叶子为 `@/views/...` | 样本 `/order` → `Layout`;`/auth/approve` → `@/views/auth/approve` |
|
||||
| 菜单是**真树**(children 非空) | 样本 `/storage` children=15、`/setting` children=12、`/auth/approve` children=0 |
|
||||
|
||||
**⇒ 结论**:`user.info` 按**请求头 `platform`** 决定用哪个 `type` 过滤页面:
|
||||
`platform: web` → `web_pages`;`platform: miniProgram` → `miniprogram_pages`。
|
||||
这解释了为什么网关卡会校验 `platform`(它不是统计标记,而是**权限过滤维度**)。
|
||||
|
||||
**本项目固定取值(已确认)**:
|
||||
|
||||
| 请求头 | 取值 | 实测说明 |
|
||||
|---|---|---|
|
||||
| `platform` | **`miniProgram`** | 网关卡白名单为 `web` / `app` / `wx` / `miniProgram`,且**大小写不敏感** |
|
||||
| `project` | **`all`** | 白名单 `all` / `wms`;其余值(含空)直接 400 |
|
||||
|
||||
配置位置:`.env.development` / `.env.production` 的 `VITE_APP_PLATFORM` / `VITE_APP_PROJECT`,
|
||||
代码侧见 `utils/request.ts` 的 `PLATFORM` / `PROJECT` 常量(仅作 `.env` 缺失时的兜底)。
|
||||
|
||||
> ⚠️ **排查提示**:若登录后 `menus` 为空且 `permissions` 异常,先把 `VITE_APP_PLATFORM` 改成全小写
|
||||
> `miniprogram` 试一次 —— 排除后端 `platform_code` 精确匹配(大小写敏感)的可能。
|
||||
> 网关卡两种写法都放行,改一行 `.env` 即可。
|
||||
|
||||
---
|
||||
|
||||
## 2. 参考项目的设计对比
|
||||
|
||||
| 维度 | new3(Web,Vue3 + vue-router) | cankao(小程序,uni-app Vue2) | wechat 应取 |
|
||||
|---|---|---|---|
|
||||
| 页面注册 | `router.addRoute()` **运行时动态注册** | `pages.json` **编译期静态注册** | ✅ cankao |
|
||||
| 后端菜单作用 | `transformMenusToRoutes(menus)` 生成路由 | `common.pages` 返回菜单树 → 首页九宫格渲染 | ✅ 折中(见第 3 节) |
|
||||
| 菜单 → 页面映射 | `router/map.ts` 的 `componentMap`(字符串键 → 动态 import) | 后端直接给 `url`,前端 `navigateTo` | ✅ new3 的映射表思想 |
|
||||
| 兜底策略 | 未命中 `componentMap` → `import.meta.glob` → 再未命中 → `404.vue` | 无兜底 | ✅ new3 思想(改为"忽略 + 告警") |
|
||||
| 页面准入 | `router.beforeEach` 白名单 + `getToken()`,未登录重定向 `/login?redirect=` | `pages.json` 的 `meta.auth` + 全局守卫 → 弹登录框 + `next(false)` | ✅ cankao(页内提示,不跳转) |
|
||||
| 布局 | `Layout` + `Sidebar` + `TopMenu` + `Breadcrumb` + `TaskView` 页签 + `keep-alive` 缓存 | 小程序原生 tabBar + 页面内导航 | ❌ 全部不搬 |
|
||||
| 图标 | `SvgIcon` + `vite-plugin-svg-icons` | uview 图标 | ❌ 用 uview-plus `up-icon` |
|
||||
| 进度条 | `nprogress` | 无 | ❌ 不适用 |
|
||||
|
||||
### 小程序硬约束(决定了不能照搬 new3)
|
||||
|
||||
1. **所有页面必须编译期注册在 `pages.json`**,`app.json` 里没有的页面运行时不复存在 → `addRoute` 无对应能力。
|
||||
2. **没有全局路由守卫**:`uni.addInterceptor` 只能拦 JS 跳转 API,拦不住 tabBar 点击与启动页。
|
||||
(且上一轮已按审核要求移除全局强制登录拦截。)
|
||||
3. **没有 keep-alive / 页签**:用原生页面栈 + tabBar 替代。
|
||||
4. **没有 DOM**:`Layout`/`Sidebar` 这类基于 DOM 的布局组件不适用。
|
||||
|
||||
---
|
||||
|
||||
## 3. 小程序端渲染框架设计(方案)
|
||||
|
||||
### 3.1 分层
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["user.info<br/>menus(树) + permissions(权限点)"] --> B["store/modules/permission.ts"]
|
||||
B --> C["generateEntries(menus)<br/>菜单 × PAGE_REGISTRY → 可见入口树"]
|
||||
C --> D1["首页:入口九宫格"]
|
||||
C --> D2["我的页:功能菜单"]
|
||||
C --> D3["任意页面:入口/按钮可见性"]
|
||||
B --> E["hasPermission(code)<br/>权限点判断"]
|
||||
|
||||
F["router/pages.ts<br/>PAGE_REGISTRY(静态路由表)"] --> C
|
||||
|
||||
G["composables/usePageAuth.ts<br/>+ components/auth-gate"] --> H["页面级三态渲染<br/>public / optional / required"]
|
||||
B --> G
|
||||
```
|
||||
|
||||
### 3.2 静态路由表 `PAGE_REGISTRY`(替代 `pages.json` 的运行时元数据)
|
||||
|
||||
`pages.json` 只为**编译**服务(微信只认 `pages`/`style`/`subPackages`/`tabBar`),
|
||||
在代码里它**读不出来**。因此新增一份运行时可用的页面清单:
|
||||
|
||||
```ts
|
||||
// src/router/pages.ts(✅ 已实现,2026-09-19)
|
||||
export type AuthMode = 'public' | 'optional' | 'required'
|
||||
|
||||
export interface PageMeta {
|
||||
/** 逻辑路径:与后端 wms_permission.path 对齐 */
|
||||
key: string
|
||||
/** 小程序物理页面路径(必须与 pages.json 一致,不带前导 /) */
|
||||
path: string
|
||||
title: string
|
||||
icon?: string
|
||||
auth: AuthMode
|
||||
/** tabBar 页:跳转必须用 switchTab */
|
||||
tabBar?: boolean
|
||||
/** 不进导航入口(可被跳转,但不进九宫格/功能菜单) */
|
||||
hidden?: boolean
|
||||
}
|
||||
|
||||
export const PAGE_REGISTRY: PageMeta[] = [
|
||||
{ key: '/home', path: 'pages/index/index', title: '首页', icon: 'home', auth: 'public', tabBar: true, hidden: true },
|
||||
{ key: '/mine', path: 'pages/mine/mine', title: '我的', icon: 'account', auth: 'optional', tabBar: true, hidden: true },
|
||||
{ key: '/login', path: 'pages/login/login', title: '登录 / 注册', icon: 'account-fill', auth: 'public', hidden: true },
|
||||
// 业务页(分包):待页面文件 + pages.json.subPackages 就绪后再启用(当前为注释示例)
|
||||
]
|
||||
|
||||
export const PAGE_MAP = new Map(PAGE_REGISTRY.map((p) => [p.key, p])) // key → meta
|
||||
export const PAGE_BY_PATH = new Map(PAGE_REGISTRY.map((p) => [p.path, p])) // path → meta
|
||||
// 附带 getPageByKey() / getPageByPath() / isTabBarPage() 三个小工具
|
||||
```
|
||||
|
||||
**为什么多了一个 `hidden` 字段**:阶段 3 的 `LOCAL_PUBLIC_ENTRIES` 若简单等于
|
||||
「所有 `auth === 'public'` 的页面」,会把「首页」也塞进九宫格。因此「能不能作为入口」被抽成
|
||||
`isEntryVisible(meta) = !meta.tabBar && !meta.hidden`,**两个来源(本地公共清单 / 后端菜单)共用它**。
|
||||
|
||||
**只登记真实存在的页面(重要)**:`pagesA/B/C` 目前只有 `.gitkeep` 占位,所以**没有**登记它们
|
||||
—— 登记了 `pages.json` 里没有的页面,用户点进去必然失败。示例条目以**注释形式**留在文件里,
|
||||
待页面建好 + 注册到 `pages.json.subPackages` 后再启用。
|
||||
|
||||
> 与 new3 的 `componentMap` 是同一个思想:**后端只给逻辑标识,前端持有"标识 → 真实页面"的映射**。
|
||||
> 好处:页面从主包挪到分包、改目录名,都只改前端一处;后端不必知道编译期路径。
|
||||
|
||||
**防漂移(已实现)**:新增 `npm run check:pages`(`scripts/check-pages.mjs`),校验三件事:
|
||||
① `PAGE_REGISTRY[].path` 必须已注册在 `pages.json`;② `key` 不重复;
|
||||
③ `pages.json` 已注册但未登记的页面 → **告警**(不阻断)。
|
||||
已实测:正常时打印「PAGE_REGISTRY 3 条 / 已注册 3 个页面」;故意插入未注册页面时报错并**退出码 1**。
|
||||
(实现为 Node 正则解析 `pages.ts`,所以条目要保持「字面量对象 + 单引号」写法;
|
||||
反过来,`pages.json` 里允许写注释 —— 解析器是按字符状态机去注释的。)
|
||||
|
||||
### 3.3 权限 store + 入口树生成(✅ 已实现)
|
||||
|
||||
拆成两个文件,**职责分离**(菜单 → 路由表的映射属路由域,不塞进 store):
|
||||
|
||||
| 文件 | 职责 |
|
||||
|---|---|
|
||||
| `src/router/entries.ts` | 纯函数 `generateEntries(menus)` → `{ entries, missing }`;类型 `MenuNode` / `EntryLeaf` / `EntryGroup` / `EntryNode` |
|
||||
| `src/store/modules/permission.ts` | 持有 `menus` / `entries` / `missing` / `loaded`;动作 `loadFromMenus()` / `reset()` |
|
||||
|
||||
```ts
|
||||
// src/store/modules/permission.ts
|
||||
state: {
|
||||
menus: MenuNode[] // 后端原始菜单树(排障用)
|
||||
entries: EntryNode[] // 经 PAGE_REGISTRY 过滤后的可见入口树(供 UI 渲染)
|
||||
missing: string[] // 后端下发但本地未注册的 key(用于告警/排查)
|
||||
loaded: boolean // 区分「未加载」与「加载后确实为空」
|
||||
}
|
||||
getters: { hasEntries, leafCount }
|
||||
actions: {
|
||||
loadFromMenus(menus) // userStore.getInfo() 成功后调用
|
||||
reset() // 退出登录 / 401 / 清缓存时调用
|
||||
}
|
||||
```
|
||||
|
||||
**入口树固定两层**:`EntryGroup.children` 的类型就是 `EntryLeaf[]` ——
|
||||
首页是「分组标题 + 子项九宫格」(决策点 4),所以后端菜单即使嵌套更深,
|
||||
也会被**拉平**到所属根分组,UI 不必处理任意深度。
|
||||
|
||||
**触发时机(统一收口,已实现)**
|
||||
|
||||
| 场景 | 触发点 |
|
||||
|---|---|
|
||||
| 登录成功 | `userStore.login()` 末尾 `await this.getInfo()`(失败不阻塞登录) |
|
||||
| 启动时带 token | `App.vue` 的 `onLaunch`:有 token 就 `getInfo()` |
|
||||
| 切换身份后 | `userStore.changeRole()` 末尾重调 `getInfo()` |
|
||||
| 退出 / 401 / 清缓存 | `userStore.resetToken()` → `permissionStore.reset()` |
|
||||
|
||||
**401 额外修复了一个真 bug**:`utils/request.ts` 在 401 时原本**只跳登录页、不删 token**,
|
||||
而登录页 `onShow` 里有 `if (getToken()) goAfterLogin()` → 用户被立刻送回刚才那个页面
|
||||
→ 再次 401 → **死循环**。现改为 `clearSession()`(`removeToken()` + `permissionStore.reset()`)+ 跳登录页。
|
||||
|
||||
> request 层仍**不引入 userStore**(会形成 request → userStore → api → request 循环引用);
|
||||
> 但权限 store 只依赖 `router/entries`、**不依赖 api**,所以引入它是安全的、不构成循环。
|
||||
|
||||
**`generateEntries()` 的兜底规则**(对齐 new3 `resolveComponent` 的兜底思想):
|
||||
|
||||
| 情况 | 处理 |
|
||||
|---|---|
|
||||
| 菜单项 key 命中 `PAGE_REGISTRY` | 收进 `entries`,携带 title/icon/auth |
|
||||
| 未命中 | **忽略该项**,记入 `missing` 并 `console.warn` |
|
||||
| 分组节点无子项命中 | 整组丢弃(避免空分组) |
|
||||
| 菜单项 `hidden = 1` | 不进导航入口(但可能仍需被 `permissions` 引用) |
|
||||
| 页面上标了 `hidden` 或 `tabBar`(本地路由表) | **同样不进入口** —— 与公共清单共用 `isEntryVisible(meta)` 口径 |
|
||||
| 全部为 0 条(如后端还没配 `miniprogram_pages`) | `entries` 为空 → UI 回退到**本地公共入口清单**(见 3.5) |
|
||||
| 最终仍为空 / 接口失败 | 渲染**统一兜底文案**「服务器出差了,请稍后再试」(见 3.5.1) |
|
||||
|
||||
**上述规则已逐条用用例验证**(把 `entries.ts` 编译为 CJS 后用 Node 跑,**16 项断言全通过**):
|
||||
命中 → 收进并带本地 `path`/`auth`;未命中 → 进 `missing` 且**不影响其它入口**;
|
||||
分组全空 → 整组丢弃;`hidden=1` → 剔除且**不**记 missing(是「隐藏」不是「没登记」);
|
||||
同 key 重复 → 去重;`menus` 为 `null` / `undefined` / `[]` → 不抛错;
|
||||
后端未给 `meta.title`/`meta.icon` → 回退本地路由表;分组节点自身的 `path` **不**进 missing。
|
||||
|
||||
> ⚠️ **实测提醒(当前的预期行为)**:后端现在下发的是 `web_pages` 路径(如 `/order`、`/storage`),
|
||||
> 与小程序本地登记的逻辑路径(`/home` 等)**必然全部不匹配**
|
||||
> → `entries` 为空 + `console.warn` 列出全部 missing → UI 走空态文案。
|
||||
> 这**不是 bug**,等后端补上 `miniprogram_pages`(§6 第 1、2 条)后自动生效,前端无需改动。
|
||||
|
||||
### 3.4 页面三态渲染:`public` / `optional` / `required`
|
||||
|
||||
这是"有些页面登录前和登录后显示不同内容、有些页面未登录也能显示"的统一解法:
|
||||
**把策略声明在页面清单里,把判断收口到一个组件里**,页面内不再散落 `if (isLogin)`。
|
||||
|
||||
> **「公共页面」的定义(已确认)**:无需登录即可访问。
|
||||
> **`public` 和 `optional` 都属于公共页面**,二者都**不会**被 auth-gate 拦截,
|
||||
> 区别只在「未登录时是否显示不同内容」。
|
||||
|
||||
| auth | 需登录才能访问? | 未登录时 | 已登录时 | 典型页面 |
|
||||
|---|---|---|---|---|
|
||||
| `public` | ❌ 不需要 | 正常渲染完整内容 | 正常渲染(可附加个性化) | **首页**、公告/帮助、公开查询页 |
|
||||
| `optional` | ❌ 不需要 | 渲染**占位/引导**内容(空态、"登录后查看") | 渲染真实数据 | **我的**、个人数据看板 |
|
||||
| `required` | ✅ 需要 | 渲染**「请先登录」**提示 + 「去登录」按钮(**不自动跳转**) | 正常渲染 | 作业页(入库/出库/盘点) |
|
||||
|
||||
配套三个小件(✅ 已实现):
|
||||
|
||||
```vue
|
||||
<!-- src/components/auth-gate/auth-gate.vue -->
|
||||
<auth-gate auth="required">
|
||||
<template #default><!-- 已登录内容 --></template>
|
||||
</auth-gate>
|
||||
|
||||
<auth-gate auth="optional">
|
||||
<template #default><!-- 已登录内容 --></template>
|
||||
<template #guest><!-- 未登录自定义占位,不传则用内置引导 --></template>
|
||||
</auth-gate>
|
||||
```
|
||||
|
||||
```ts
|
||||
// src/composables/usePageAuth.ts
|
||||
const { isLogin, canRender, needLogin, goLogin, requireLogin } = usePageAuth('required')
|
||||
// 省略参数 → 自动按当前页在 PAGE_REGISTRY 里的声明判定(策略只有一处声明)
|
||||
const { canRender } = usePageAuth()
|
||||
```
|
||||
|
||||
```vue
|
||||
<!-- src/components/empty-state/empty-state.vue -->
|
||||
<empty-state @retry="load" />
|
||||
<empty-state @retry="load"> <!-- 未登录时可再挂一个「去登录」 -->
|
||||
<template #action><up-button text="去登录" /></template>
|
||||
</empty-state>
|
||||
```
|
||||
|
||||
| 实现决策 | 说明 |
|
||||
|---|---|
|
||||
| `usePageAuth(auth?)` 参数可省略 | 省略时按 `getCurrentRoute()` 从 `PAGE_REGISTRY` 取 `auth`;**未登记页面按 `required` 兜底** + `console.warn`(宁可多提示,不可漏保护) |
|
||||
| 未登录**不自动跳转** | `redirectToLogin()` 只在 401 时用;页面内的引导一律走 `requireLogin()`(弹框确认后才跳)或 `goLogin()`(用户点按钮) |
|
||||
| 「去登录」只有一条实现 | `usePageAuth.goLogin()` 内部复用 `LOGIN_PAGE` 并自动带 `redirect` 回本页;`pages/mine/mine.vue` 已改用它,不再自己拼 URL |
|
||||
| ❌ 不单独建 `guest-placeholder` 组件 | `auth-gate` 的内置引导已覆盖两种语气(`required` → 「请先登录」;`optional` → 「登录后查看」),再拆一个组件只会多一层间接 |
|
||||
| ✅ 新增 `empty-state` 组件 | §3.5.1 的空态/失败文案 + 「重试」按钮需**多页复用**(首页、我的),且要能再挂一个「去登录」动作位,所以这里值得独立组件 |
|
||||
|
||||
> **编译验证**:用临时用法把两个组件接进首页跑了一次 `build:mp-weixin`,产物里
|
||||
> `auth-gate.wxml` 的三分支(默认 slot / `guest` slot / 内置引导)与
|
||||
> `empty-state.wxml` 的 `slot name="action"` 条件渲染都正确生成;
|
||||
> 移除临时用法后两个组件**不再进包**(easycom 按需引入生效)。
|
||||
|
||||
### 3.5 未登录态的入口渲染(关键设计)
|
||||
|
||||
> 微信审核要求:未登录也必须有可浏览的内容,且**不能自动跳登录页**。
|
||||
|
||||
```
|
||||
未登录:
|
||||
首页九宫格 ← LOCAL_PUBLIC_ENTRIES(前端本地维护的公共入口清单,只含 auth: 'public' 的页面)
|
||||
✅ 当前有 1 个(pagesA/demo/public 示例页);若一个都没有 → 渲染空态文案(见 3.5.1),不白屏
|
||||
tabBar 2 个 Tab(首页 / 我的)正常可用(两者都是公共页面)
|
||||
「我的」显示「登录 / 注册」按钮
|
||||
点 required 入口 → 页内「请先登录」+ 去登录按钮
|
||||
|
||||
已登录:
|
||||
首页九宫格 ← permissionStore.entries(后端菜单 × PAGE_REGISTRY,按角色/权限过滤)
|
||||
⚠️ 后端未配 miniprogram_pages 时 entries 为空 → 同样走空态文案 + 「重试」
|
||||
「我的」显示身份信息(姓名/类型/组织/员工 ID/授权到期)+ 功能菜单(仅 entries 非空时)+ 退出登录
|
||||
点 required 入口 → 正常进入
|
||||
```
|
||||
|
||||
**为什么公共入口用本地清单而不是后端?**
|
||||
- 保证"未登录可见"是**确定性**的,不依赖后端是否配置、不受网络/接口故障影响(审核时更可控)
|
||||
- 后端 `miniprogram_pages` 只需描述"登录后能看到什么"
|
||||
- 若将来需要运营侧控制公共入口,再让后端加字段(见 §6 建议)
|
||||
|
||||
### 3.5.1 九宫格空态 / 失败提示文案(已确认)
|
||||
|
||||
| 场景 | 展示文案 |
|
||||
|---|---|
|
||||
| 未登录 + 九宫格为空 | 「**服务器出差了,请稍后再试**」(✅ 已确认) |
|
||||
| 已登录 + 菜单为空(后端未配 `miniprogram_pages`) | 同上 |
|
||||
| 已登录 + 接口失败 / 返回空数据 | 同上 |
|
||||
|
||||
统一要求:**不能白屏**;文案下方配套一个「重试」按钮(未登录场景可同时给「去登录」)。
|
||||
|
||||
> ✅ **已确认(2026-09-19)**:客户拍板——**两种场景统一用同一句**「服务器出差了,请稍后再试」,
|
||||
> **不**做「未登录引导文案」的区分(即上表即为最终行为)。
|
||||
|
||||
### 3.6 渲染调用链(最终形态)
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant U as 用户
|
||||
participant P as 页面
|
||||
participant S as permissionStore
|
||||
participant R as request
|
||||
|
||||
Note over U,S: 未登录
|
||||
U->>P: 打开小程序(启动页=首页)
|
||||
P->>S: 读取 entries
|
||||
S-->>P: 空 → 回退 LOCAL_PUBLIC_ENTRIES
|
||||
P-->>U: 渲染公共入口 + 正常可浏览
|
||||
|
||||
Note over U,R: 登录
|
||||
U->>P: 我的 → 登录 / 注册
|
||||
P->>R: user.login
|
||||
R-->>P: data.token
|
||||
P->>R: user.info
|
||||
R-->>S: menus + permissions
|
||||
S->>S: generateEntries(menus) × PAGE_REGISTRY
|
||||
S-->>P: 可见入口树
|
||||
P-->>U: 首页/我的 按权限渲染
|
||||
|
||||
Note over U,R: token 失效
|
||||
R->>S: 401 → reset()
|
||||
R->>P: 回未登录态(带 redirect 跳登录)
|
||||
```
|
||||
|
||||
### 3.7 复用现有代码的接入点(已经就绪)
|
||||
|
||||
| 已有 | 位置 | 在框架中的角色 |
|
||||
|---|---|---|
|
||||
| `userStore.getInfo()` | `store/modules/user.ts` | 已能拉到 `menus` / `permissions`(类型已声明 `menus?: any[]`) |
|
||||
| `userStore.permissions` / `checkPermission()` | 同上 | 权限点判断,可直接用 |
|
||||
| `redirectToLogin(redirect?)` | `utils/auth-guard.ts` | 401 时带来源页跳登录 |
|
||||
| 「我的」页登录入口 + 登录页「取消」 | `pages/mine/mine.vue`、`pages/login/login.vue` | 已符合审核要求,无需改动 |
|
||||
| `LOGIN_PAGE` 常量 | `utils/auth-guard.ts` | 跳登录页的唯一来源 |
|
||||
|
||||
**需要调整的一处**:目前 `getInfo()` 只在「我的」页 `onShow` 里触发。
|
||||
✅ **已调整(阶段 2)**:改为「登录成功 `login()` / 启动时带 token `App.onLaunch` / 切换身份 `changeRole()`」
|
||||
统一触发;「我的」页的 `onShow` 保留为**兑底重试**(仅在信息未拉到时才请求)。
|
||||
|
||||
---
|
||||
|
||||
## 4. 已确认的决策(2026-09-19 拍板)
|
||||
|
||||
| # | 决策点 | **确认结论** | 对实现的影响 |
|
||||
|---|---|---|---|
|
||||
| 1 | 未登录可见的入口清单由谁定义 | **前端本地清单** `LOCAL_PUBLIC_ENTRIES` | 未登录渲染不依赖后端/网络,审核可控;后端 `guest_visible` 作为将来可选升级 |
|
||||
| 2 | 后端菜单 `path` 形态 | **逻辑路径**(如 `/inbound/list`) | 前端维护 `PAGE_REGISTRY`;页面挪分包/改目录不用改数据库 |
|
||||
| 3 | `required` 页未登录交互 | **页内「请先登录」+ 按钮**(不自动跳转) | 需 `auth-gate` 组件 + `usePageAuth()` |
|
||||
| 4 | 首页菜单分组呈现 | **分组标题 + 子项九宫格**(cankao 形态) | 首页需支持"分组 → 子项"两层渲染 |
|
||||
| 5 | 角色/仓库切换 `changeRole` | **本期做** | 新增切换接口 + 切换后重建菜单/权限,见 §4.2 |
|
||||
| 6 | `platform` → `type` 映射 | `platform: **miniProgram**` / `project: **all**` | 已在 `.env` 落地;实测网关卡大小写不敏感 |
|
||||
| 7 | 未登录九宫格内容 | **仅公共入口** | 未登录时可能为空 → 必须做空态引导 |
|
||||
|
||||
**选择理由(简述)**
|
||||
|
||||
- **1**:本地清单保证"未登录一定有内容可看",不依赖后端进度与网络;后端字段将来可作为覆盖(本地兜底 + 后端覆盖)
|
||||
- **2**:"页面在主包还是分包"是构建期决策,后端不该感知;同一套菜单模型可复用到 PDA / 工作台端
|
||||
- **3**:审核最稳;跳转式登录在审核员视角接近"强制登录"
|
||||
- **4**:与 cankao 一致,实现成本最低;待入口真多到一屏放不下再升级为分组 Tab
|
||||
- **5**:本期一并做,避免以后把"是否登录"模型二次返工成"以哪个身份登录"
|
||||
- **7**:规避"诱导登录"判定
|
||||
|
||||
### 4.1 页面归属(已确认)
|
||||
|
||||
| 页面 | 物理路径 | 是否公共页面 | auth | 说明 |
|
||||
|---|---|---|---|---|
|
||||
| **首页** | `pages/index/index` | ✅ 是 | `public` | tabBar 第 1 项(启动页);内容与登录态无关 |
|
||||
| **我的** | `pages/mine/mine` | ✅ 是 | `optional` | tabBar 第 2 项;页面可访问,**内容分登录前/后** |
|
||||
| 登录页 | `pages/login/login` | — | — | 非 tabBar;由用户从「我的」主动进入 |
|
||||
|
||||
> 两者都是**公共页面**(无需登录、无需权限即可显示),因此**不会**出现登录拦截。
|
||||
|
||||
### 4.2 `changeRole` 实现要点(本期新增)
|
||||
|
||||
数据来源:`user.info` 返回的 `data.employees[]` —— 一个账号在多个货主/仓库下的身份。
|
||||
|
||||
| 项 | 说明 |
|
||||
|---|---|
|
||||
| 可切换项 | `employees[]`(`id` / `store_id` / `store_name` / `real_name` / `role_type` / `is_primary` / `auth_end`) |
|
||||
| 切换入口 | 「我的」页(仅登录后可见):展示当前身份 + 「切换」;多身份时该行出现,点开用 `uni.showActionSheet` 选(当前身份标「(当前)」) |
|
||||
| 调用接口 | `user.changeRole({ roleId, device })`<br>✅ **入参已确认:`roleId` = `employees[].id`**(与 new3 一致)<br>✅ **接口已实测存在**(无 token 调用 → HTTP 401;而不存在的方法 → HTTP 500) |
|
||||
| 返回处理 | new3:返回 `data.user` + `data.token` → **换发 token**、重设 `user`<br>✅ 已按“两种都可能”兼容实现:有 `token` 则写新 token(未回传则沿用旧 token);有 `user` 先落库,最后统一重拉 `user.info` 为准 |
|
||||
| 切换后必做 | ① 写新 token ✅;② 重调 `user.info` 重建 `menus`/`permissions` ✅;③ `permissionStore.reset()` 后重建 `entries` ✅(阶段 2 已接入);④ 首页九宫格 / 我的菜单刷新 ⏳(待阶段 4) |
|
||||
| 失败处理 | ✅ **只有切换接口本身失败才回滚**已选身份;后续 `getInfo` 失败不回滚(此时后端已切换,回滚反而造成前后端不一致) |
|
||||
| 默认身份 | 优先级:① 本地已选身份仍在列表中 → 保留;② `user.info` 的 `employees_id`(后端会话身份)在列表中 → 以其为准;③ 都没有 → 主身份(`is_primary`)→ 授权未过期 → 第一个<br>✅ **已实现**(`setEmployees` / `pickDefaultEmployeeId`)<br>⚠️ 保留“本地优先”的原因:本地指针只会被“后端下发的值”或“已确认成功的 `changeRole`”写入;若改成完全以后端为准,一旦 `changeRole` 成功后 `employees_id` 未及时更新,界面会立刻弹回旧身份 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 下一步任务清单
|
||||
|
||||
### 阶段 0 · 契约确认(前后端对齐,不写业务代码)
|
||||
|
||||
- [x] **确认 `platform` 头 → `wms_permission.type` 的映射表** ✅ 已确认:`web` → `web_pages`,`miniProgram` → `miniprogram_pages`(`app` → 待补)
|
||||
- [x] **确认小程序端应使用的 `platform` 取值** ✅ 已确认:**`miniProgram`**(网关卡**大小写不敏感**,`wx` 亦放行,但以 `miniProgram` 为准)
|
||||
- [ ] 确认 `user.info` 在 `platform=miniprogram` 时返回的 `menus` 是否取自 `miniprogram_pages`
|
||||
- [ ] 确认 `permissions[]` 是否仍返回 `type='api'` 的全集(小程序端是否需要按端过滤)
|
||||
- [ ] 与后端敲定**小程序页面 `path` 的命名规范**(逻辑路径 vs 物理路径,见决策点 2)
|
||||
- [ ] 与后端敲定**分组节点**的表示(参照 `workerstation_pages`:`component` 留空)
|
||||
- [ ] 确认 `hidden` 在小程序端的语义(不进导航但可被跳转?)
|
||||
|
||||
### 阶段 1 · 前端静态路由表
|
||||
|
||||
- [x] 新增 `src/router/pages.ts`:`PageMeta` 类型 + `PAGE_REGISTRY` + `PAGE_MAP`(另附 `PAGE_BY_PATH`)✅ 2026-09-19
|
||||
- [x] 盘点现有 2 个 tabBar 页(首页 / 我的)+ 已规划的分包页,登记 `key / path / title / icon / auth / tabBar`
|
||||
✅ 已登记 3 个**真实存在**的页面(首页 / 我的 / 登录)。分包页 `pagesA/B/C` 目前只有 `.gitkeep`,
|
||||
**故意不登记**(登记不存在的页面 = 点击必失败),示例以注释形式留在文件里
|
||||
- [x] (可选)加一致性校验脚本:`PAGE_REGISTRY.path` 必须存在于 `pages.json`,否则构建告警
|
||||
✅ 已实现:`npm run check:pages`(`scripts/check-pages.mjs`);实测能检出未注册页面并返回**退出码 1**
|
||||
- [x] (可选)给 `pages.json` 各页面补 `meta: { title, auth }` —— ❌ **决定不做**:
|
||||
`pages.json` 是编译期文件、运行时读不出来,补 meta 只会形成第二份真相、必然漂移
|
||||
|
||||
### 阶段 2 · 权限 store
|
||||
|
||||
- [x] 新增 `src/store/modules/permission.ts`:`menus` / `entries` / `missing` / `loaded` ✅ 2026-09-19
|
||||
- [x] 实现 `generateEntries(menus)`:菜单树 × `PAGE_REGISTRY` → 可见入口树(含未命中告警、空分组剔除)
|
||||
✅ 放在 `src/router/entries.ts`(纯函数);**16 项断言用例全通过**(见 §3.3)
|
||||
- [x] 实现 `reset()`:退出登录、401、清缓存时调用 ✅ 2026-09-19
|
||||
- [x] `userStore.logout()` / `resetToken()` 里联动调用 `permissionStore.reset()` ✅(`logout` 走 `resetToken`)
|
||||
- [x] 把 `getInfo()` 的调用时机改为**登录成功后 + 启动时带 token** 统一触发(不再只在「我的」页)
|
||||
✅ 登录 → `login()` 内;启动 → `App.vue` `onLaunch`;切换身份 → `changeRole()` 内
|
||||
- [x] `getInfo()` 成功后把 `menus` / `permissions` 灌进 permission store
|
||||
✅ `menus` → `permissionStore.loadFromMenus()`;`permissions` 仍在 `userStore`(`checkPermission()`),本期不动
|
||||
|
||||
### 阶段 2.5 · 角色/仓库切换 `changeRole`(本期确认要做)
|
||||
|
||||
- [x] 确认 `user.changeRole` 入参:**`roleId` = `employees[].id`**(与 new3 一致)✅
|
||||
- [x] `api/user/user.ts` 新增 `changeRole({ roleId, device })` ✅ 2026-09-19
|
||||
- [x] `userStore` 新增 `changeRole(action)`:换发 token → 重设 `user` → 重调 `getInfo()` → 重建权限 ✅ 2026-09-19
|
||||
- [x] `userStore` 新增「当前身份」状态(`employees[]` + `currentEmployeeId` + `setEmployees()` 默认身份选择)✅ 2026-09-19
|
||||
- [x] `userStore` 新增 `setCurrentEmployee()` 切换方法(配合 `changeRole` 调用)✅ 2026-09-19
|
||||
- [x] `permissionStore.reset()` 后重建 `entries`(避免旧身份的菜单残留)✅ 2026-09-19(阶段 2 完成后已接入)
|
||||
- [x] 「我的」页新增**身份展示**(姓名 / 身份类型 / 所属组织 / 员工 ID / 授权到期)✅ 2026-09-19
|
||||
- [x] 「我的」页新增「**切换身份 / 仓库**」入口(仅登录后显示,多身份时出现)✅ 2026-09-19
|
||||
- [ ] 验证:切换后首页九宫格 / 我的菜单立即按新身份刷新;旧身份入口不残留 —— ⏳ 待阶段 4 页面接入后联调
|
||||
|
||||
### 阶段 3 · 登录态与页面渲染策略
|
||||
|
||||
- [x] 新增 `src/composables/usePageAuth.ts`:按 `auth` 返回 `isLogin` / `canRender` / `requireLogin()`
|
||||
✅ 2026-09-19(`auth` 可省略,自动按当前页从 `PAGE_REGISTRY` 取;额外提供 `goLogin` / `needLogin`)
|
||||
- [x] 新增 `src/components/auth-gate/auth-gate.vue`:三态渲染 + 内置「请先登录」+「去登录」按钮 ✅ 2026-09-19
|
||||
- [x] (可选)新增 `src/components/guest-placeholder/`:未登录占位(骨架/空态/引导)
|
||||
❌ **决定不建** —— 已折进 `auth-gate` 的内置引导(两种语气);
|
||||
改为新增 `components/empty-state/`,承担 §3.5.1 的空态/失败文案 + 「重试」按钮
|
||||
- [x] `LOCAL_PUBLIC_ENTRIES`:本地公共入口清单(只含 `auth: 'public'` 的页面)
|
||||
✅ 定义在 `src/router/entries.ts`(筛选 `auth === 'public' && !tabBar && !hidden`);
|
||||
**当前为空数组**(3 个已登记页面都不满足)→ 首页会走空态文案,属预期
|
||||
- [x] 首页九宫格**空态 / 失败提示**:按 §3.5.1 的文案规范渲染(含「重试」按钮),不能白屏
|
||||
✅ 已提供 `components/empty-state/`(默认文案即 §3.5.1 那句,可挂「去登录」动作位);**首页接入在阶段 4**
|
||||
- [x] 统一「去登录」的跳转:带 `redirect` 回本页(复用 `LOGIN_PAGE`,不新造路径)
|
||||
✅ `usePageAuth.goLogin()` 为唯一实现;`pages/mine/mine.vue` 已改用(删掉自己拼 URL 的写法)
|
||||
|
||||
### 阶段 4 · 页面接入
|
||||
|
||||
- [x] `pages/index/index.vue`:九宫格改为 permission store 驱动,且支持**「分组标题 + 子项九宫格」两层渲染**;
|
||||
未登录回退 `LOCAL_PUBLIC_ENTRIES`;无内容 / 请求失败时按 §3.5.1 渲染空态文案
|
||||
✅ 2026-09-19:三个分支(`loading` → `sections` → `empty-state`);
|
||||
分组/叶子拍平共用 `toSections()`,与「我的」口径一致
|
||||
- [x] `pages/mine/mine.vue`:已登录时展示**「身份信息」卡片**(数据来自 `user.info` 的 `employees[]`,不改数据库)✅ 2026-09-19
|
||||
- [x] `pages/mine/mine.vue`:已登录时展示「功能菜单」(来自 entries);未登录保持现状
|
||||
✅ 2026-09-19:与首页**同源**(`toSections(permissionStore.entries)`);
|
||||
⚠️ `entries` 为空时**整卡不渲染**(不在「我的」再堆一份空态,「首页」才是空态的归属地)
|
||||
- [x] 新增一个**未登录可用的公开页**作为 `public` 示例(原计划的「库存」tab 已于 2026-09-19 精简移除)
|
||||
✅ `pagesA/demo/public`(分包,`auth: 'public'`,不设 `hidden`)
|
||||
- [x] 至少再造 1 个 `required` 页示例,验证「页内请先登录」体验
|
||||
✅ `pagesA/demo/required`(分包,`auth: 'required'`);已加入 `pages.json` 的 `condition`
|
||||
开发编译模式,微信开发者工具下拉即可直达
|
||||
- [x] 页面按钮级权限:用 `checkPermission('xxx.yyy')` 控制显隐(示例 1~2 处)
|
||||
✅ `pagesA/demo/required.vue`:`store.getStoreRoles` 有权限才渲染按钮,
|
||||
否则显示一句说明;该页还列出当前账号的权限点(前 20 个)作联调参照
|
||||
|
||||
> 阶段 4 额外做了两件事(不在原清单里,但属工程必需):
|
||||
> ① **`pages.json` 注册了 `subPackages`**(`root: pagesA`)—— 顺便销掉了《开发清单》第 3 节的「分包未注册」;
|
||||
> ② 新增 `utils/navigate.ts` 统一跳转(自动区分 `switchTab` / `navigateTo`),首页与我的共用。
|
||||
|
||||
### 阶段 5 · 验证与文档
|
||||
|
||||
- [ ] 未登录:启动进首页 → 可正常浏览 → 「我的」看到登录入口 → 点登录 → 可取消返回
|
||||
🔧 可用微信开发者工具的**编译模式**直达:首页 / 我的 / 登录 / 公开示例页 / 需登录示例页
|
||||
- [ ] 登录后:九宫格按后端菜单出现 → 无权限项不出现 → 「我的」显示姓名/身份类型/所属组织
|
||||
- [ ] 后端未配 `miniprogram_pages` 时(现状):不白屏、不报错,回退公共入口 + 控制台告警
|
||||
- [ ] 空态:九宫格为空 / 接口失败时展示 §3.5.1 的文案,不出现白屏或裸露报错
|
||||
- [ ] 401 / token 过期:回退未登录态、清空 permission store、带 `redirect` 跳登录可正常回跳
|
||||
⚠️ 该路径已顺带修了一个死循环 bug(401 未清 token → 登录页把人弹回原页),待真机复验
|
||||
- [ ] 退出登录:permission store 清空、「我的」切回未登录态
|
||||
- [ ] 更新《微信小程序开发清单.md》(新增"页面渲染框架"章节)
|
||||
|
||||
---
|
||||
|
||||
## 6. 给后端的补充需求清单
|
||||
|
||||
> 这些是"等待后端补充设计接入功能"的具体内容。
|
||||
|
||||
### 必需
|
||||
|
||||
1. **补充 `wms_permission` 中 `type='miniprogram_pages'` 的页面数据**(当前 0 条)
|
||||
- 字段建议(参照 `workerstation_pages`):
|
||||
| 字段 | 小程序端用法建议 |
|
||||
|---|---|
|
||||
| `path` | 小程序页面**逻辑路径**(如 `/home`、`/inbound/list`)—— **已确认用逻辑路径**,前端负责映射到物理页面 |
|
||||
| `component` | 分组节点留空;叶子节点可留空(小程序无需组件路径) |
|
||||
| `name` | 唯一标识(用于日志/排查) |
|
||||
| `meta_title` | 菜单显示名 |
|
||||
| `meta_icon` | 图标名(建议直接给 uview-plus 合法图标名) |
|
||||
| `parent_id` | 分组层级(NULL 为根) |
|
||||
| `sort` | 排序 |
|
||||
| `status` | 启用/禁用 |
|
||||
| `type` | `'miniprogram_pages'` |
|
||||
2. **给角色授权**:在 `wms_role.permissions` 中加入上述 `wms_permission.id`
|
||||
3. **确认并固化 `platform` 头 → `type` 的映射**:
|
||||
`platform: web` → `web_pages`;`platform: miniProgram` → `miniprogram_pages`。
|
||||
本项目已固定 `platform: miniProgram` / `project: all`(网关卡实测**大小写不敏感**)。
|
||||
4. **明确 `user.info` 在小程序端返回 `menus` 的来源**(按 `platform` 过滤 `type`)
|
||||
5. `user.changeRole` 接口:✅ **已实测存在**(`POST /system?method=user.changeRole` 无 token 调用返回 **HTTP 401**;
|
||||
对照不存在的方法返回 HTTP 500)。入参 ✅ 已确认 `roleId` = `employees[].id`;
|
||||
⏳ **仍需后端确认返回结构**:是否返回 `data.user` + `data.token`(用于换发 token)。
|
||||
前端已按“两种都可能”实现:有 `token` 就换、有 `user` 就落库,最后统一重调 `user.info`(见 §4.2)
|
||||
|
||||
### 建议(可选,能省掉前端硬编码)
|
||||
|
||||
5. `wms_permission` 增加 **`guest_visible`(tinyint)** 字段 → 由运营侧控制"未登录可见"的页面,
|
||||
前端即可去掉 `LOCAL_PUBLIC_ENTRIES` 硬编码(对应 §4 决策点 1 的平滑升级路径)
|
||||
6. `user.info` 的 `data` 增加 **`authMode`** 或直接返回 `guestVisible`,让页面三态由后端驱动
|
||||
7. 后续如需按端裁剪 `permissions[]`(减少下发体积),建议增加 `platform` 维度过滤
|
||||
|
||||
---
|
||||
|
||||
## 7. 明确排除项(从 new3 移植清单中剔除)
|
||||
|
||||
| 排除项 | 原因 |
|
||||
|---|---|
|
||||
| `router.addRoute()` / `transformMenusToRoutes` 动态注册 | 小程序页面编译期固定,运行时不支持 |
|
||||
| `router/map.ts` 的 `() => import('@/views/...')` 动态 import | 小程序无此机制;改为 `PAGE_REGISTRY` 的静态映射 |
|
||||
| `import.meta.glob('@/views/**/*.vue')` 兜底 | 同上;改为"忽略 + 告警 + 回退公共入口" |
|
||||
| `layout/**`(`Layout`/`AppMain`/`Navbar`/`TopMenu`) | 无 DOM,且小程序布局是页面自带的 |
|
||||
| `Sidebar/*` + `Breadcrumb` | 小程序导航靠 tabBar + 页面标题 |
|
||||
| `TaskView` 页签 + `tagsView` store + `keep-alive` 缓存 | 小程序用原生页面栈,无页签/缓存概念 |
|
||||
| `SvgIcon` + `vite-plugin-svg-icons` | 统一用 uview-plus 的 `up-icon` |
|
||||
| `nprogress` | 小程序无浏览器进度条 |
|
||||
| `/redirect` 软刷新页 | 小程序无 vue-router 刷新语义 |
|
||||
| 用户偏好 `userPreference` / 域名品牌 `frontBrand` / 多语言 | 已由 new3 移植清单 §6 排除,本期继续不做 |
|
||||
|
||||
---
|
||||
|
||||
## 8. 附:一条已经踩过的坑(供设计时参考)
|
||||
|
||||
**`platform` 请求头不是"统计标记",而是权限过滤维度。**
|
||||
|
||||
- 网关卡对 `platform` 做**白名单校验**:实测放行 `web` / `app` / `wx` / `miniProgram`
|
||||
(**且大小写不敏感**:`miniProgram` / `MiniProgram` / `MINIPROGRAM` / `miniprogram` 全部 200),
|
||||
其余(含 uni-app 的平台名 `mp-weixin`)直接返回 **HTTP 400 + 空响应体**,
|
||||
前端只能显示通用「请求参数错误」,极难定位。
|
||||
- 本次已排查并修复(详见《微信小程序开发清单》第 5 节"后端 /system 网关契约")。
|
||||
- 设计启示:**平台编码必须与权限模型的 `type` 维度一致**,建议把映射关系固化在后端文档里,
|
||||
前端只通过 `.env` 的 `VITE_APP_PLATFORM` 配置(本项目当前值 `miniProgram`)。
|
||||
Loading…
x
Reference in New Issue
Block a user