liufumingren 78cee0fe1a feat(doc): 首页登录分流 + 文档站(简易 CMS / 静态 HTML / sitemap)
- 首页:`/` 未登录原地显示登录页(不再跳 /login),已登录直接进 `/dashboard`;
  看板路由由 `/` 迁到 `/dashboard`,侧边栏「首页」与无权限回跳同步;
  桌面端「工具 → 打开配置页」的 `/?token=` 免登录仍然可用
- 文档站:`/doc/**` 由后端整站生成静态 HTML(顶部分类 tab 全局切换、左侧栏目 → 内容页、
  右侧本页目录);`/sitemap.txt` 新链接追加到末尾,下架 / 删除的会被清理
- 平台管理 · 文档管理(`/admin/doc`):分类 / 栏目 / 内容页(Markdown)简易 CMS,
  内容页有编辑表单与列表,保存后自动重生成目录与静态页面
- 登录页右下角、顶栏(登录后)、看板右上角新增进入文档站的链接
- 部署:nginx 模板为 `/doc`、`/doc/`、`/sitemap.txt` 增加反代(否则会落到 SPA 回退);
  Vite dev server 增加同名代理;`middleware/frontend.js` 排除这些路径
- 登录页插画改为内联 SVG(沿用工作区已有的未提交改动)
- 测试:新增 Markdown 渲染单测;后端 218 个用例通过,前端 typecheck / build 通过

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 20:33:46 +08:00

155 lines
7.7 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router';
import { getToken } from '@/composables/useAuth';
import { ensureSubjects, hasSubject, isSubjectAdmin } from '@/composables/useSubject';
import { ensurePlatformAdmin } from '@/composables/usePlatformAdmin';
/**
* 路由表(meta.public = 不需要登录)
*
* 手机扫码打开的 `/wechat?spm=…` 也必须是公开路由(扫码的人可能还没登录)。
*
* `meta.adminOnly = true`:业务数据页(设备 / 录像机 / 摄像头 / 工作台 / 扫码记录),
* **只有主体管理员**能进;普通成员直接跳回首页并提示(后端同名接口也返回 403)。
*
* `meta.platformAdmin = true`:**平台管理员**页面(主体管理 / 订单管理 / 套餐管理 / 管理员 / 插件配置),
* 不看主体、不需要选主体;不是平台管理员直接跳回首页(后端同名接口返回 403)。
*/
const routes: RouteRecordRaw[] = [
// 根路径就是入口:**未登录时原地显示登录页**(地址不会跳到 /login),
// 已登录由下面的路由守卫直接送去 /dashboard 看板。
{ path: '/', name: 'root', component: () => import('@/views/LoginView.vue'), meta: { public: true, bare: true } },
{ path: '/login', name: 'login', component: () => import('@/views/LoginView.vue'), meta: { public: true, bare: true } },
{ path: '/forgot', name: 'forgot', component: () => import('@/views/ForgotView.vue'), meta: { public: true, bare: true } },
{ path: '/reset', name: 'reset', component: () => import('@/views/ResetView.vue'), meta: { public: true, bare: true, alwaysShow: true } },
// 手机扫码后打开:确认登录(公开)
{ path: '/wechat', name: 'wechat-confirm', component: () => import('@/views/WechatConfirmView.vue'), meta: { public: true, bare: true } },
// 本机软件(打印服务)公共页:**不需要登录**,Chrome 插件打开 `/local?code=<运单号>`
// 页面自己查 http://localhost:17300/api/query/{code}(状态和结果一起回来),
// 没启动就提示下载/唤起,没登录就唤起软件登录
{
path: '/local',
alias: '/local/',
name: 'local-service',
component: () => import('@/views/LocalServiceView.vue'),
meta: { public: true, bare: true },
},
{ path: '/dashboard', name: 'dashboard', component: () => import('@/views/HomeView.vue'), meta: { allowNoSubject: true } },
// 主体 / 成员:没有主体时只有这个入口(创建主体、切换主体、绑成员)
{ path: '/subjects', name: 'subjects', component: () => import('@/views/SubjectsView.vue'), meta: { allowNoSubject: true } },
{ path: '/devices', name: 'devices', component: () => import('@/views/DevicesView.vue'), meta: { adminOnly: true } },
// 视频接入:NVR → 摄像头 → 工作台
{ path: '/nvrs', name: 'nvrs', component: () => import('@/views/NvrsView.vue'), meta: { adminOnly: true } },
{ path: '/cameras', name: 'cameras', component: () => import('@/views/CamerasView.vue'), meta: { adminOnly: true } },
{ path: '/workstations', name: 'workstations', component: () => import('@/views/WorkstationsView.vue'), meta: { adminOnly: true } },
{ path: '/records', name: 'records', component: () => import('@/views/RecordsView.vue'), meta: { adminOnly: true } },
{ path: '/profile', name: 'profile', component: () => import('@/views/ProfileView.vue'), meta: { allowNoSubject: true } },
// 平台管理(只有平台管理员能进;看的是所有主体 / 所有订单,不需要选主体)
{
path: '/admin/subjects',
name: 'admin-subjects',
component: () => import('@/views/AdminSubjectsView.vue'),
meta: { allowNoSubject: true, platformAdmin: true },
},
{
path: '/admin/orders',
name: 'admin-orders',
component: () => import('@/views/AdminOrdersView.vue'),
meta: { allowNoSubject: true, platformAdmin: true },
},
// 续期套餐:改天数 / 改价 / 上下架(下单只认库里的价格,不用发版)
{
path: '/admin/plans',
name: 'admin-plans',
component: () => import('@/views/AdminPlansView.vue'),
meta: { allowNoSubject: true, platformAdmin: true },
},
{
path: '/admin/members',
name: 'admin-members',
component: () => import('@/views/AdminMembersView.vue'),
meta: { allowNoSubject: true, platformAdmin: true },
},
// Chrome 插件:集中维护单号前缀 / 生效站点 / 跳转模板(插件只拉取执行)
{
path: '/admin/extension',
name: 'admin-extension',
component: () => import('@/views/AdminExtensionView.vue'),
meta: { allowNoSubject: true, platformAdmin: true },
},
// 文档站(简易 CMS):分类 → 栏目 → 内容页;保存后自动生成 /doc/** 静态页面与 sitemap.txt
{
path: '/admin/doc',
name: 'admin-doc',
component: () => import('@/views/AdminDocView.vue'),
meta: { allowNoSubject: true, platformAdmin: true },
},
// 测试页只在开发构建里存在:生产包不包含该路由,也不会产出它的 chunk
...(import.meta.env.DEV
? [{ path: '/test', name: 'test', component: () => import('@/views/TestView.vue'), meta: { adminOnly: true } } as RouteRecordRaw]
: []),
{ path: '/:pathMatch(.*)*', redirect: '/' },
];
export const router = createRouter({
history: createWebHistory(),
routes,
});
router.beforeEach(async (to) => {
const isPublic = Boolean(to.meta.public);
// 桌面端「工具 → 打开配置页」:`?token=<用户 JWT>` 直接登录,并把 token 从地址栏去掉
// ⚠️ 只对需要登录的页面生效:`/reset?token=…` 里的 token 是重置令牌,不是 SSO JWT
// ⚠️ 根路径现在是公开页(未登录显示登录表单),但桌面端正是用 `/?token=…` 免登录进来的,同样要吃 token
const ssoToken = typeof to.query.token === 'string' ? to.query.token : (typeof to.query.sso === 'string' ? to.query.sso : '');
if (ssoToken && (!isPublic || to.name === 'root')) {
localStorage.setItem('packs_token', ssoToken);
const query = { ...to.query };
delete query.token;
delete query.sso;
return { path: to.path, query, replace: true };
}
const logged = Boolean(getToken());
// 根路径:已登录直接进看板;未登录就**原地**渲染登录页(地址保持 `/`,不跳 /login)
if (to.name === 'root') {
return logged ? { name: 'dashboard' } : true;
}
if (!isPublic && !logged) {
return { name: 'login', query: { redirect: to.fullPath } };
}
// 已登录时这些公开页也照常显示(扫码确认页 / 本机软件页 / 重置密码页):
// 它们可能由外部链接直接打开,不该被踢回首页
const alwaysShow = to.meta.alwaysShow === true
|| to.name === 'wechat-confirm'
|| to.name === 'local-service';
if (isPublic && logged && !alwaysShow) {
return { name: 'dashboard' };
}
// 业务页都要主体:没拉过列表先拉一次,没有可用主体就去「主体 / 成员」页创建
if (logged && !isPublic) {
try {
await ensureSubjects();
} catch {
// 后端不可用时不拦路由,让页面自己报错
}
if (to.meta.allowNoSubject !== true && !hasSubject.value) {
return { name: 'subjects', query: { need: '1' } };
}
// 业务数据(设备 / 录像机 / 摄像头 / 工作台 / 扫码记录)只有主体管理员能进
if (to.meta.adminOnly === true && !isSubjectAdmin.value) {
return { name: 'dashboard', query: { denied: '1' } };
}
// 平台管理页只有平台管理员能进(没权限按「被拒绝」处理,与主体管理员那种一致)
if (to.meta.platformAdmin === true) {
const allowed = await ensurePlatformAdmin();
if (!allowed) return { name: 'dashboard', query: { denied: '1' } };
}
}
return true;
});