Files
Enterprise-Knowledge-Base/frontend/src/router/index.ts
T
wizardchen 47a183aa65 feat(system-admin): implement bootstrap for system admin promotion and enhance system settings management
- Added WEKNORA_BOOTSTRAP_SYSTEM_ADMIN_EMAIL environment variable to promote a specified user to system admin on startup.
- Introduced a new bootstrap process in `bootstrap.go` to handle the promotion logic.
- Updated `.env.example` to document the new environment variable and its behavior.
- Created new views for managing system administrators and system settings, including listing, promoting, and revoking admin privileges.
- Enhanced the frontend to reflect the new system admin features, including UI elements for admin management and settings configuration.
- Updated API interfaces to support system admin functionalities, ensuring proper data handling and user management.
2026-05-26 21:13:56 +08:00

347 lines
11 KiB
TypeScript

import { createRouter, createWebHistory } from 'vue-router'
import type { RouteLocationNormalized } from 'vue-router'
import { useAuthStore } from '@/stores/auth'
import { autoSetup, getCurrentUser, userInfoFromApi } from '@/api/auth'
/** Lite /桌面 WebView 硬刷新时可能只打开 `/`,用 session 记住上次页面以便恢复 */
const LITE_LAST_PATH_KEY = 'weknora_lite_last_path'
const AUTO_SETUP_FAILED_KEY = 'weknora_auto_setup_failed'
function shouldTryAutoSetup() {
return localStorage.getItem(AUTO_SETUP_FAILED_KEY) !== 'true'
}
function markAutoSetupFailed() {
localStorage.setItem(AUTO_SETUP_FAILED_KEY, 'true')
}
function isLiteEdition(authStore: ReturnType<typeof useAuthStore>) {
return authStore.isLiteMode || localStorage.getItem('weknora_lite_mode') === 'true'
}
function isLiteSpaDefaultEntry(to: RouteLocationNormalized) {
return (
to.path === '/' ||
to.path === '/platform' ||
to.path === '/platform/knowledge-bases' ||
to.name === 'knowledgeBaseList'
)
}
function isSafeLiteRestoreTarget(path: string) {
return path.startsWith('/platform/') && !path.startsWith('/platform/organizations')
}
function hasPendingOIDCCallback() {
if (typeof window === 'undefined') return false
const hash = window.location.hash || ''
return hash.includes('oidc_result=') || hash.includes('oidc_error=')
}
const router = createRouter({
history: createWebHistory(import.meta.env.BASE_URL),
routes: [
{
path: "/",
redirect: "/platform/knowledge-bases",
},
{
path: "/login",
name: "login",
component: () => import("../views/auth/Login.vue"),
meta: { requiresAuth: false, requiresInit: false }
},
{
path: "/join",
name: "joinOrganization",
// 重定向到组织列表页,并将 code 参数转换为 invite_code
redirect: (to) => {
const code = to.query.code as string
return {
path: '/platform/organizations',
query: code ? { invite_code: code } : {}
}
},
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "/knowledgeBase",
name: "home",
component: () => import("../views/knowledge/KnowledgeBase.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "/platform",
name: "Platform",
redirect: "/platform/knowledge-bases",
component: () => import("../views/platform/index.vue"),
meta: { requiresInit: true, requiresAuth: true },
children: [
{
path: "tenant",
redirect: "/platform/settings"
},
{
path: "settings",
name: "settings",
component: () => import("../views/settings/Settings.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "knowledge-bases",
name: "knowledgeBaseList",
component: () => import("../views/knowledge/KnowledgeBaseList.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "knowledge-bases/:kbId",
name: "knowledgeBaseDetail",
component: () => import("../views/knowledge/KnowledgeBase.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "knowledge-search",
// 旧路径保留为重定向,打开全局命令面板(⌘K),带上可选的 q 参数
redirect: (to) => {
const q = to.query.q
return {
path: '/platform/knowledge-bases',
query: typeof q === 'string' ? { cmdk: q } : { cmdk: '' },
}
},
},
{
path: "agents",
name: "agentList",
component: () => import("../views/agent/AgentList.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "creatChat",
name: "globalCreatChat",
component: () => import("../views/creatChat/creatChat.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "knowledge-bases/:kbId/creatChat",
name: "kbCreatChat",
component: () => import("../views/creatChat/creatChat.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "chat/:chatid",
name: "chat",
component: () => import("../views/chat/index.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
{
path: "organizations",
name: "organizationList",
component: () => import("../views/organization/OrganizationList.vue"),
meta: { requiresInit: true, requiresAuth: true }
},
// System administration area — gated to users with
// user.is_system_admin === true. The route guard below honours
// the meta.requiresSystemAdmin flag; non-admins are bounced to
// /platform/knowledge-bases. Real authorisation lives server-side.
{
path: "system",
component: () => import("../views/system/SystemLayout.vue"),
meta: { requiresInit: true, requiresAuth: true, requiresSystemAdmin: true },
redirect: "/platform/system/settings",
children: [
{
// P1 default landing page — the SystemAdmin lands here
// because most platform-level operations involve tweaking
// a setting, not promoting another admin.
path: "settings",
name: "systemSettings",
component: () => import("../views/system/SystemSettings.vue"),
meta: { requiresInit: true, requiresAuth: true, requiresSystemAdmin: true }
},
{
path: "admins",
name: "systemAdmins",
component: () => import("../views/system/SystemAdmins.vue"),
meta: { requiresInit: true, requiresAuth: true, requiresSystemAdmin: true }
},
],
},
],
},
// Dev-only markdown rendering test page
...(import.meta.env.DEV ? [{
path: '/platform/dev/markdown',
name: 'markdownTest',
component: () => import('../views/dev/MarkdownTestPage.vue'),
meta: { requiresAuth: false, requiresInit: false }
}] : []),
],
});
// 持久化 auto-setup / login 返回的认证信息到 store
function persistLoginResponse(authStore: ReturnType<typeof useAuthStore>, response: any) {
if (response.user && response.tenant && response.token) {
authStore.setUser(userInfoFromApi(response.user, response.tenant.id))
authStore.setToken(response.token)
if (response.refresh_token) {
authStore.setRefreshToken(response.refresh_token)
}
authStore.setTenant({
id: String(response.tenant.id) || '',
name: response.tenant.name || '',
api_key: response.tenant.api_key || '',
owner_id: response.user.id || '',
created_at: response.tenant.created_at || new Date().toISOString(),
updated_at: response.tenant.updated_at || new Date().toISOString()
})
}
}
async function hydrateSessionFromToken(authStore: ReturnType<typeof useAuthStore>) {
const token = localStorage.getItem('weknora_token')
if (!token) return false
if (!authStore.token) {
authStore.setToken(token)
}
const storedRefreshToken = localStorage.getItem('weknora_refresh_token')
if (storedRefreshToken && !authStore.refreshToken) {
authStore.setRefreshToken(storedRefreshToken)
}
try {
const response = await getCurrentUser()
const user = response.data?.user
if (!response.success || !user) {
return false
}
authStore.setUser(userInfoFromApi(user, response.data?.tenant?.id))
const tenant = response.data?.tenant
if (tenant) {
authStore.setTenant({
id: String(tenant.id) || '',
name: tenant.name || '',
api_key: tenant.api_key || '',
owner_id: tenant.owner_id || user.id || '',
description: tenant.description,
status: tenant.status,
business: tenant.business,
storage_quota: tenant.storage_quota,
storage_used: tenant.storage_used,
created_at: tenant.created_at || new Date().toISOString(),
updated_at: tenant.updated_at || new Date().toISOString(),
})
}
// Refresh memberships on every page load — same reason as
// App.vue's syncOIDCUserContext: without this the auth store
// would only ever see the snapshot from the original /auth/login
// call, so role changes (and tenant-switch role lookups) would
// be silently stale until the user logged out and back in.
const memberships = response.data?.memberships
if (Array.isArray(memberships)) {
authStore.setMemberships(memberships)
}
return true
} catch {
return false
}
}
let autoSetupAttempted = false
let liteDeepLinkRestoreDone = false
// 路由守卫:检查认证状态和系统初始化状态
router.beforeEach(async (to, from, next) => {
const authStore = useAuthStore()
// OIDC 回跳登录结果依赖 App.vue 在挂载后消费 URL hash。
// 如果这里先按“未登录”拦截到 /login,会导致回调结果没有机会落盘。
if (hasPendingOIDCCallback()) {
next()
return
}
// Lite:硬刷新后若落在默认首页,恢复本次会话中最后访问的 /platform 子路径
if (!liteDeepLinkRestoreDone) {
liteDeepLinkRestoreDone = true
if (isLiteEdition(authStore)) {
const saved = sessionStorage.getItem(LITE_LAST_PATH_KEY)
if (saved && isSafeLiteRestoreTarget(saved) && isLiteSpaDefaultEntry(to)) {
if (saved !== to.fullPath) {
next(saved)
return
}
}
}
}
// 如果访问的是登录页面或初始化页面,直接放行
if (to.meta.requiresAuth === false || to.meta.requiresInit === false) {
// 如果已登录用户访问登录页面,重定向到知识库列表页面
if (to.path === '/login' && authStore.isLoggedIn) {
next('/platform/knowledge-bases')
return
}
next()
return
}
// 检查用户认证状态
if (to.meta.requiresAuth !== false) {
if (!authStore.isLoggedIn) {
const restored = await hydrateSessionFromToken(authStore)
if (restored) {
next(to.fullPath)
return
}
if (!autoSetupAttempted && shouldTryAutoSetup()) {
autoSetupAttempted = true
try {
const response = await autoSetup()
if (response.success) {
persistLoginResponse(authStore, response)
authStore.setLiteMode(true)
next(to.fullPath)
return
} else {
markAutoSetupFailed()
}
} catch {
markAutoSetupFailed()
}
}
next('/login')
return
}
}
// SystemAdmin gate — checked AFTER auth so a non-admin who's logged
// out gets redirected to /login first (consistent with how the rest
// of the auth flow works), and only an authenticated non-admin sees
// the bounce. This is UI-only; the server enforces the real check.
if (to.meta.requiresSystemAdmin === true) {
if (!authStore.isSystemAdmin) {
next('/platform/knowledge-bases')
return
}
}
next()
})
router.afterEach((to) => {
if (!isLiteEdition(useAuthStore())) return
if (to.path === '/login') return
if (!to.path.startsWith('/platform')) return
sessionStorage.setItem(LITE_LAST_PATH_KEY, to.fullPath)
})
export default router