feat(前端): 公司 tab(store+组件+G1 双向对账)+ §9.3 引导文案承载
批次 1 的 tab 机制半边:默认选中 id 最小的启用公司、不允许「全部」;「该不该画 tab 条」只住 store 一处(组件里再数一遍 length 就是第二把尺子);两家全停用时 activeId 为 null ⇒ 整条不渲染,不画出按钮为零的空 tab 条。 G1 双向对账 + 跨端常量钉子(后端 SUPER_ADMIN_ONLY_KEYS ↔ 前端 SUPER_ADMIN_ONLY_MENU_KEYS 由代码执行地相等,读不到/抽不到/空集三种都判红) + pageFiles↔routes.ts load() 对账,把 Task 8-12 的接线欠债钉成会红的尺子。 §9.3 的「行数会随 tab 变」由既有引导文案承载(8 页 + C 类 2 页各一句,句子抽成 常量防手抄差异),不新做页头控件/提示条。 已知一条刻意红灯:company-tab-wiring.test.ts 的正向半支在 Task 12 接线完成前必红 (plan 19 Step 8 明令),下一条补齐接线的提交收敛它。全量 1726 例仅此 1 红, vue-tsc --noEmit 通过。 AdminLayout.vue / operation-guides.ts / company-config-entry-super-only.test.ts 三支文件此刻同时带着另一路会话的未提交改动,本提交按 hunk 逐行只入自己的部分。
This commit is contained in:
@@ -14,6 +14,7 @@ import {
|
||||
import GlobalErrorContainer from '@/layout/GlobalErrorContainer.vue'
|
||||
import NotificationBell from '@/components/NotificationBell.vue'
|
||||
import OperationGuide from '@/layout/OperationGuide.vue'
|
||||
import CompanyTabs from '@/layout/CompanyTabs.vue'
|
||||
import { crumbsForActiveRoute, resolveDocumentTitle, updateDocumentTitle } from '@/layout/title-breadcrumb'
|
||||
import {
|
||||
LOGOUT_CONFIRM_CANCEL,
|
||||
@@ -113,6 +114,7 @@ async function signOut() {
|
||||
<el-breadcrumb v-if="breadcrumbs.length > 1" class="admin-breadcrumb" separator="/">
|
||||
<el-breadcrumb-item v-for="crumb in breadcrumbs" :key="crumb.key">{{ crumb.name }}</el-breadcrumb-item>
|
||||
</el-breadcrumb>
|
||||
<CompanyTabs />
|
||||
<OperationGuide />
|
||||
<GlobalErrorContainer />
|
||||
<el-alert v-if="session.error" :title="session.error" type="error" show-icon :closable="false" />
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
<script setup lang="ts">
|
||||
/** 页面上方的公司 tab(spec §4、§9.3):只有超管看得到,选中哪家由哪一枚 tab 带 is-active 表达——
|
||||
* 这里不再挂第二处"这家是谁"的文案(§12 第 5 条把页头提示条算未批的界面暴露),
|
||||
* 观感说明走 operation-guides 的引导文案。 */
|
||||
import { computed, watch } from 'vue'
|
||||
import { COMPANY_STATUS_ACTIVE } from '@/api/companies-dto'
|
||||
import { useCompanyTabStore } from '@/stores/company-tab'
|
||||
import { useAdminSessionStore } from '@/stores/admin-session'
|
||||
|
||||
const tab = useCompanyTabStore()
|
||||
const session = useAdminSessionStore()
|
||||
const tabs = computed(() => tab.companies.filter((c) => c.status === COMPANY_STATUS_ACTIVE))
|
||||
const show = computed(() => tab.visibleForOperator)
|
||||
|
||||
watch(() => session.isSuperAdmin, (v) => { if (v) void tab.initialize() }, { immediate: true })
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div v-if="show" class="company-tabs" role="tablist" aria-label="按公司查看数据">
|
||||
<button
|
||||
v-for="item in tabs"
|
||||
:key="item.id"
|
||||
type="button"
|
||||
role="tab"
|
||||
class="company-tab"
|
||||
:class="{ 'is-active': item.id === tab.activeId }"
|
||||
:aria-selected="item.id === tab.activeId"
|
||||
@click="tab.setActiveId(item.id)"
|
||||
>{{ item.companyName }}</button>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
/* 只给上面那几枚 tab 上样式:tab 条本身不产出任何文字节点,公司名一律来自 item.companyName。 */
|
||||
.company-tabs {
|
||||
display: flex; flex-wrap: wrap; align-items: flex-end; gap: 4px;
|
||||
margin: 0 0 14px; padding: 0 2px;
|
||||
border-bottom: 1px solid var(--admin-border);
|
||||
}
|
||||
.company-tab {
|
||||
padding: 6px 16px;
|
||||
border: 1px solid transparent; border-bottom: 0;
|
||||
border-radius: 10px 10px 0 0;
|
||||
background: none; cursor: pointer;
|
||||
font: inherit; font-size: 13px; line-height: 1.7;
|
||||
color: var(--admin-sidebar-text);
|
||||
}
|
||||
.company-tab:hover { color: var(--admin-primary-strong); background: var(--admin-primary-soft); }
|
||||
.company-tab.is-active {
|
||||
border-color: var(--admin-border);
|
||||
background: #fff;
|
||||
color: var(--admin-primary-strong); font-weight: 650;
|
||||
box-shadow: inset 0 -2px 0 var(--admin-primary);
|
||||
}
|
||||
</style>
|
||||
@@ -1,5 +1,8 @@
|
||||
<script setup lang="ts">
|
||||
/** 当前页面操作提示条:对齐旧版 admin-interactions.js 的 adminOperationGuide(14 页有独立文案,余用通用 fallback)。
|
||||
/** 当前页面操作提示条:对齐旧版 admin-interactions.js 的 adminOperationGuide。每页文案逐条登记在
|
||||
* OPERATION_GUIDES 里,条数**不在这里数**(写死一个页数就会过期:公司 tab 那批把 group-manage 从
|
||||
* 通用 fallback 改成自带文案时,上一版注释里的数字就已经是错的了)——分母由 align-operation-guide
|
||||
* 那组用例按路由注册表钉着。
|
||||
* 挂在 AdminLayout 内容区顶部,随 route.meta.menuKey 切换文案;折叠态存 localStorage。 */
|
||||
import { computed, ref, watch } from 'vue'
|
||||
import { useRoute } from 'vue-router'
|
||||
|
||||
@@ -0,0 +1,17 @@
|
||||
/** 公司 tab 的两支纯函数(store 与护栏用例共用,不依赖 pinia / 组件)。
|
||||
* import 用相对路径 + 显式 `.ts`:本文件被 tests 以 `node --test` 直接 import,而测试侧没有
|
||||
* vite 的 `@` 别名解析器,写成 `@/api/...` 会 ERR_MODULE_NOT_FOUND(护栏因此读源码而非常规 import,
|
||||
* 见 tests/company-tab-wiring.test.ts 用 readSource 的原因)。 */
|
||||
import { COMPANY_STATUS_ACTIVE, type CompanyItem } from '../api/companies-dto.ts'
|
||||
|
||||
/** 超管的读范围公司。非超管恒 null——它的公司是固定的,下传一个常数只会让人以为这页在按公司筛。 */
|
||||
export function companyIdForRequest(isSuperAdmin: boolean, activeId: number | null): number | null {
|
||||
return isSuperAdmin ? activeId : null
|
||||
}
|
||||
|
||||
/** 「默认选中第一家」= id 最小的启用公司(spec §4 口径:不是超管自己所属公司,也不是返回顺序首条)。 */
|
||||
export function firstSelectableCompanyId(companies: readonly CompanyItem[]): number | null {
|
||||
const active = companies.filter((c) => c.status === COMPANY_STATUS_ACTIVE && c.id > 0)
|
||||
if (!active.length) return null
|
||||
return active.reduce((min, c) => (c.id < min ? c.id : min), active[0].id)
|
||||
}
|
||||
@@ -1,6 +1,8 @@
|
||||
/**
|
||||
* 每菜单页的操作提示(guides)文案,对齐旧版 backend/static/admin-interactions.js 的 guides 表原文
|
||||
* (除 group-manage / duplicate-check 用通用 fallback)。key = 路由 meta.menuKey。
|
||||
* (duplicate-check 为例外页不展示)。key = 路由 meta.menuKey。
|
||||
* 2026-10-05 公司 tab 起有**两处故意偏离**「原文」:group-manage 由通用 fallback 改为自带文案,
|
||||
* 参与 tab 的 8 页与不参与 tab 的 C 类 2 页在原文之后各追加一句——见下方三个 *_NOTE 常量。
|
||||
*/
|
||||
export interface OperationGuideData {
|
||||
text: string
|
||||
@@ -15,6 +17,22 @@ export const OPERATION_GUIDE_FALLBACK: OperationGuideData = {
|
||||
/** 折叠状态 localStorage key(沿用旧版 shufuAdminGuideCollapsed 语义)。 */
|
||||
export const OPERATION_GUIDE_STORAGE_KEY = 'shufuAdminGuideCollapsed'
|
||||
|
||||
/** §9.3 的承载:公司 tab 改的是「行数观感」,只写进既有引导文案,不做页头控件/提示条
|
||||
* (§12 第 5 条把那种提示条算未批的界面暴露;当前哪一家由 is-active 的 tab 表达,一处事实不留两处)。
|
||||
* 这句必须以「超级管理员」开头、不能写成祈使式的「由上方 tab 决定」:引导文案按 menuKey 取、
|
||||
* 不分支角色,而非超管根本看不到 tab 条(company-tab store 的 visibleForOperator 里有 isSuperAdmin)。
|
||||
* 这一句由参与 tab 的 8 页共用、不各抄一遍——文案差一个字,护栏就只盯得住其中一页。
|
||||
* 由 tests/align-operation-guide.test.ts 的 guide_copy_carries_company_tab_note_for_every_scoped_page
|
||||
* 按 COMPANY_SCOPED_PAGES 逐页盯着(分母取注册表,加第 9 页忘了补文案会当场红)。 */
|
||||
const COMPANY_TAB_GUIDE_NOTE = ' 超级管理员可用页面上方的公司 tab 切换公司,切换后行数会变化——行数变少不是数据丢了。'
|
||||
|
||||
/** §5 的承载:注册表里显式 companyScoped:false 的 C 类页要的是**另一句**——"这页不参与",
|
||||
* 不是"会随 tab 变"。同一支护栏反向钉它(不得带 COMPANY_TAB_GUIDE_NOTE)。 */
|
||||
const COMPANY_SCOPE_NOT_APPLIED_NOTE = ' 本页全平台共享,不按公司区分:超级管理员切换上方公司 tab 时它不会变,这不是筛选坏了。'
|
||||
|
||||
/** §6.3 归属口径:店铺落哪家由「负责人」决定,与 tab 无关——这条与直觉相反,不写在界面上就会被报成 bug。 */
|
||||
const SHOP_OWNER_COMPANY_NOTE = ' 店铺归哪家公司由「负责人」决定,不由公司 tab 决定:负责人选自己,店铺就落在你自己那家。'
|
||||
|
||||
export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
|
||||
admin_users: {
|
||||
text: '先用筛选定位账号,再编辑角色和菜单权限;删除账号会要求二次确认。',
|
||||
@@ -24,9 +42,17 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
|
||||
text: '菜单会影响后台和软件端的可见范围。先填写名称并选择对应页面,再设置上级菜单;顺序直接拖动列表左侧手柄调整。',
|
||||
steps: ['新增或调整菜单', '设置层级', '拖动排序'],
|
||||
},
|
||||
admin_group_manage: OPERATION_GUIDE_FALLBACK,
|
||||
admin_group_manage: {
|
||||
// 2026-10-05 公司 tab(spec §9.3):这页改为**自带文案**,故意偏离文件头「沿用旧版原文」的约定——
|
||||
// tab 那句不能塞进 OPERATION_GUIDE_FALLBACK(fallback 会被没进 tab 的页共用,等于把 tab 端给它们)。
|
||||
// 也不写「跨公司的分组彼此看不见」:那是 Task 11 Step 3 明确没做的半边(附B 记了这条部分强度)。
|
||||
text: '数据权限分组决定"哪些账号能看到哪些店铺",分组按负责人和归属账号聚拢。超级管理员切换上方公司 tab 后,列表只保留当前公司账号相关的分组。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE,
|
||||
steps: ['选择分组', '维护负责人与归属账号', '核对店铺可见范围'],
|
||||
},
|
||||
admin_user_secrets: {
|
||||
text: '用户密钥按账号绑定,列表只展示脱敏值。可对单条立即检测连通性;清空后该用户需要重新配置密钥。',
|
||||
text: '用户密钥按账号绑定,列表只展示脱敏值。可对单条立即检测连通性;清空后该用户需要重新配置密钥。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE,
|
||||
steps: ['筛选用户或状态', '立即检测连通性', '必要时清空'],
|
||||
},
|
||||
admin_companies: {
|
||||
@@ -46,7 +72,8 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
|
||||
steps: ['筛选店铺', '打开配置抽屉', '保存或导出'],
|
||||
},
|
||||
admin_product_categories: {
|
||||
text: '类目树支持展开查看层级。搜索、编辑和删除都在同一列表中完成。',
|
||||
text: '类目树支持展开查看层级。搜索、编辑和删除都在同一列表中完成。'
|
||||
+ COMPANY_SCOPE_NOT_APPLIED_NOTE,
|
||||
steps: ['搜索类目', '展开层级', '新增或编辑'],
|
||||
},
|
||||
admin_skip_price_asin: {
|
||||
@@ -54,11 +81,14 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
|
||||
steps: ['筛选店铺', '打开配置抽屉', '保存或批量导入'],
|
||||
},
|
||||
admin_shop_keys: {
|
||||
text: '紫鸟令牌属于敏感配置。白名单状态可悬停查看检测详情,编辑前请先核对账号名称。',
|
||||
text: '紫鸟令牌属于敏感配置。白名单状态可悬停查看检测详情,编辑前请先核对账号名称。'
|
||||
+ COMPANY_SCOPE_NOT_APPLIED_NOTE,
|
||||
steps: ['新增或筛选密钥', '查看白名单状态', '编辑或删除'],
|
||||
},
|
||||
admin_shop_manage: {
|
||||
text: '店铺信息按分组管理。长商城名会自动缩略,悬停即可查看完整内容。',
|
||||
text: '店铺信息按分组管理。长商城名会自动缩略,悬停即可查看完整内容。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE
|
||||
+ SHOP_OWNER_COMPANY_NOTE,
|
||||
steps: ['选择分组', '维护店铺信息', '筛选核对结果'],
|
||||
},
|
||||
admin_shop_data_crawl_tasks: {
|
||||
@@ -67,11 +97,13 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
|
||||
},
|
||||
// admin_shop_data_duplicate_check(店铺撞款监控)为例外页:不展示全局提示条,不参与对齐。
|
||||
admin_image_video_tasks: {
|
||||
text: '可先使用筛选缩小任务范围,再查看任务状态、结果和权限范围。',
|
||||
text: '可先使用筛选缩小任务范围,再查看任务状态、结果和权限范围。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE,
|
||||
steps: ['设置筛选', '查看任务结果', '按需处理任务'],
|
||||
},
|
||||
admin_history: {
|
||||
text: '生成记录可按用户和时间范围回溯,用于核对结果文件和执行时间。',
|
||||
text: '生成记录可按用户和时间范围回溯,用于核对结果文件和执行时间。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE,
|
||||
steps: ['设置时间范围', '筛选记录', '查看结果预览'],
|
||||
},
|
||||
admin_version: {
|
||||
@@ -87,15 +119,18 @@ export const OPERATION_GUIDES: Record<string, OperationGuideData> = {
|
||||
steps: ['上传草稿', '确认更新日志', '发布或设为最新'],
|
||||
},
|
||||
admin_device_logs: {
|
||||
text: '桌面客户端与麦象采集机上报的日志按来源、日期和关键字筛选;可查看日志尾部、下载完整文件或删除云端记录,云端日志按保留期自动清理。',
|
||||
text: '桌面客户端与麦象采集机上报的日志按来源、日期和关键字筛选;可查看日志尾部、下载完整文件或删除云端记录,云端日志按保留期自动清理。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE,
|
||||
steps: ['选择来源与日期', '查看或下载日志', '必要时删除'],
|
||||
},
|
||||
admin_user_secret_usage: {
|
||||
text: '按日期范围统计各用户的密钥调用次数(货源查询与外观专利按 LLM 请求次数、代理按提取次数),用于评估用户资源损耗。',
|
||||
text: '按日期范围统计各用户的密钥调用次数(货源查询与外观专利按 LLM 请求次数、代理按提取次数),用于评估用户资源损耗。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE,
|
||||
steps: ['选择日期范围', '筛选用户或分组', '核对各模块次数'],
|
||||
},
|
||||
admin_task_center: {
|
||||
text: '按账号、业务、状态、店铺和创建时间筛出客户端任务,点任务查看明细与分组结果;顶部汇总卡给当前在跑与疑似卡住的总量。',
|
||||
text: '按账号、业务、状态、店铺和创建时间筛出客户端任务,点任务查看明细与分组结果;顶部汇总卡给当前在跑与疑似卡住的总量。'
|
||||
+ COMPANY_TAB_GUIDE_NOTE,
|
||||
steps: ['按条件筛任务', '查看任务明细', '核对汇总卡'],
|
||||
},
|
||||
}
|
||||
|
||||
@@ -0,0 +1,50 @@
|
||||
import { defineStore } from 'pinia'
|
||||
import { fetchCompanies } from '@/api/companies'
|
||||
import type { CompanyItem } from '@/api/companies-dto'
|
||||
import { useAdminSessionStore } from '@/stores/admin-session'
|
||||
import { firstSelectableCompanyId, companyIdForRequest } from '@/layout/company-tab-model'
|
||||
|
||||
/** 公司 tab 的状态。成员 user ids **不在这里缓存**——每次请求交后端解析,
|
||||
* 否则"改了成员没刷新页面"会出现一个看起来筛了、实际按旧名单筛的范围。 */
|
||||
export const useCompanyTabStore = defineStore('company-tab', {
|
||||
state: () => ({
|
||||
companies: [] as CompanyItem[],
|
||||
activeId: null as number | null,
|
||||
loading: false,
|
||||
loaded: false,
|
||||
}),
|
||||
getters: {
|
||||
/** 只有超管需要这份目录(Task 2 之后非超管连 GET 都不该发)。
|
||||
* 「该不该画 tab 条」这条判断**只住在这里**:组件里再写一遍 `length > 1` 就是第二把尺子,
|
||||
* 将来改口径会两边不一致。loaded 也计入——没拉完之前不画,免得先闪出一条空 tab。
|
||||
* `activeId !== null` 是「存在至少一家启用公司」——activeId 由 firstSelectableCompanyId 算,
|
||||
* 用的就是同一把尺子,不是第二处判定。缺它的话两家全停用时 `companies.length > 1` 仍成立,
|
||||
* 会画出一条容器在、按钮为零的空 tab 条(超管会把它报成"tab 坏了"而不是"公司都停了")。 */
|
||||
visibleForOperator(): boolean {
|
||||
return this.loaded
|
||||
&& useAdminSessionStore().isSuperAdmin
|
||||
&& this.companies.length > 1
|
||||
&& this.activeId !== null
|
||||
},
|
||||
requestCompanyId(): number | null {
|
||||
return companyIdForRequest(useAdminSessionStore().isSuperAdmin, this.activeId)
|
||||
},
|
||||
},
|
||||
actions: {
|
||||
async initialize() {
|
||||
const session = useAdminSessionStore()
|
||||
if (this.loaded || this.loading || !session.isSuperAdmin) return
|
||||
this.loading = true
|
||||
try {
|
||||
this.companies = await fetchCompanies()
|
||||
this.activeId = firstSelectableCompanyId(this.companies)
|
||||
this.loaded = true
|
||||
} finally {
|
||||
this.loading = false
|
||||
}
|
||||
},
|
||||
setActiveId(id: number) {
|
||||
this.activeId = id
|
||||
},
|
||||
},
|
||||
})
|
||||
Reference in New Issue
Block a user