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:
2026-10-05 06:06:42 +08:00
parent e43203c878
commit ca78bd27e9
10 changed files with 389 additions and 16 deletions
@@ -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
},
},
})