// AppShell — 登录后整体布局:左侧栏 + 顶栏 + Tab 条 + 内容区 // 替代原 AppLayout.tsx;多 Tab 状态存 localStorage 恢复。 // // 【Tab 设计取舍说明】 // 内容区直接由 react-router 渲染当前路由,切 Tab = navigate(), // 不做 keep-alive(切 Tab 重新挂载组件)。 // 原因:keep-alive 需要将所有 Tab 内容同时挂载在 DOM 中,对 amis 渲染宿主 // 会产生大量隐藏实例,内存/副作用难以控制。当前阶段优先保证正确性, // keep-alive 作为后续优化项。 import { useCallback, useEffect, useRef, useState } from 'react'; import { Outlet, useLocation, useNavigate } from 'react-router-dom'; import { getProfile } from '../auth/token'; import { collectLeaves, fetchMenu } from '../api/menu'; import type { MenuLeaf } from '../api/menu'; import { fetchTodo } from '../api/todo'; import { fetchUnreadCount } from '../api/notice'; import { APPROVAL_COMPLETED_EVENT, OPEN_APPROVAL_DRAWER_EVENT, type ApprovalDrawerRequest, } from '../amis/approvalActionEvents'; import { MESSAGE_DETAIL_CHANGED_EVENT, OPEN_MESSAGE_DETAIL_EVENT, type MessageDetailRequest, } from '../amis/messageActionEvents'; import { ApprovalDrawer } from '../components/ApprovalDrawer'; import { MessageDetailDialog } from '../components/MessageDetailDialog'; import { ToastHost } from '../components/ui/Toast'; import { Topbar } from './Topbar'; import { SideMenu } from './SideMenu'; import { TabBar } from './TabBar'; import type { Tab } from './TabBar'; import { SettingsDrawer, initTheme } from './SettingsDrawer'; import { NoticeDrawer } from './NoticeDrawer'; import { TabTitleContext } from './TabTitleContext'; const TABS_KEY = 'eip4-tabs'; const ACTIVE_KEY = 'eip4-active-tab'; // 待办 badge 轮询间隔(毫秒),每 60 秒刷新一次 const TODO_POLL_INTERVAL = 60_000; // 初始 Tab:「工作台」作为保底 Tab,不可关闭 const TODO_TAB: Tab = { key: '/workbench', title: '工作台' }; // 非 /page/:id 的单例功能路由 → Tab 标题。navigate 到这些路由时自动开成独立 Tab, // 避免「盖」在当前选中 Tab 上(见下方地址同步 useEffect)。 const SINGLETON_TAB_TITLES: Record = { '/design-center': '设计中心', }; function loadTabs(): Tab[] { try { const raw = localStorage.getItem(TABS_KEY); if (raw) { const parsed = JSON.parse(raw) as Tab[]; if (Array.isArray(parsed) && parsed.length) return parsed; } } catch { // 忽略 } return [TODO_TAB]; } function loadActiveKey(tabs: Tab[]): string { try { const a = localStorage.getItem(ACTIVE_KEY); if (a && tabs.some((t) => t.key === a)) return a; } catch { // 忽略 } return tabs[0].key; } // 初始化主题(刷新后恢复 localStorage 中的设置) initTheme(); export function AppShell() { const navigate = useNavigate(); const location = useLocation(); const [tabs, setTabs] = useState(loadTabs); const [activeKey, setActiveKey] = useState(() => loadActiveKey(loadTabs())); const [collapsed, setCollapsed] = useState(false); const [showSettings, setShowSettings] = useState(false); const [leaves, setLeaves] = useState([]); // 顶栏铃铛真实待办数(F1-3:接真实 API) const [todoBadge, setTodoBadge] = useState(undefined); // F2-11 消息未读数 const [noticeBadge, setNoticeBadge] = useState(undefined); const [showNotice, setShowNotice] = useState(false); const [approvalRequest, setApprovalRequest] = useState(null); const [messageRequest, setMessageRequest] = useState(null); const pollTimer = useRef | null>(null); const noticePollTimer = useRef | null>(null); const profile = getProfile(); // 同步 activeKey 跟随浏览器地址(直接输入 URL / 后退前进) // F2-13:直开 /page/:id 深链接时,若 Tab 不存在则自动新增并激活;title 先用 id 占位, // PageRenderPage 拉到 schema 后通过 updateTabTitle 回填真实标题。 useEffect(() => { const path = location.pathname; if (tabs.some((t) => t.key === path)) { setActiveKey(path); } else if (path.startsWith('/page/')) { const templateId = path.slice('/page/'.length); setTabs((prev) => { if (prev.some((t) => t.key === path)) return prev; return [...prev, { key: path, title: templateId }]; }); setActiveKey(path); } else { // 非 /page/ 的单例功能路由(如顶栏「设计中心」入口):也自动开成独立 Tab, // 否则 navigate() 只换 Outlet 内容、不建 Tab → 设计中心「盖」在当前选中 Tab 上、 // Tab 条仍高亮旧页(用户反馈「覆盖当前选中 tab」)。 const title = SINGLETON_TAB_TITLES[path]; if (title) { setTabs((prev) => { if (prev.some((t) => t.key === path)) return prev; return [...prev, { key: path, title }]; }); setActiveKey(path); } } }, [location.pathname, tabs]); // 持久化 tabs useEffect(() => { try { localStorage.setItem(TABS_KEY, JSON.stringify(tabs)); } catch { // 忽略 } }, [tabs]); // 持久化 activeKey useEffect(() => { try { localStorage.setItem(ACTIVE_KEY, activeKey); } catch { // 忽略 } }, [activeKey]); // 加载菜单叶子供全局搜索使用(404/失败时 leaves 为空,搜索框显示空结果) useEffect(() => { fetchMenu() .then((data) => { const all: MenuLeaf[] = []; for (const root of data.roots ?? []) { all.push(...collectLeaves(root.children ?? [], [root.name])); } setLeaves(all); }) .catch(() => { // 忽略,搜索降级为空结果 }); }, []); // 顶栏铃铛:每 TODO_POLL_INTERVAL 轮询一次待办数(503 时 badge 清零不报错) useEffect(() => { const loadBadge = () => { fetchTodo(0, 1) .then((r) => { if (r.unavailable) { setTodoBadge(undefined); return; } // 当前 API 无 totalCount,用 items 数量作近似(maxResults=1 不准确) // 实际拉取少量条目仅做"有无"判断;完整 count 等待后端 GET /api/todo/count 端点 fetchTodo(0, 200).then((full) => { if (!full.unavailable) setTodoBadge(full.items.length || undefined); }).catch(() => setTodoBadge(undefined)); }) .catch(() => setTodoBadge(undefined)); }; loadBadge(); pollTimer.current = setInterval(loadBadge, TODO_POLL_INTERVAL); return () => { if (pollTimer.current) clearInterval(pollTimer.current); }; }, []); // F2-11 消息未读数轮询(60s,与待办同频) useEffect(() => { const loadNoticeBadge = () => { fetchUnreadCount() .then((n) => setNoticeBadge(n > 0 ? n : undefined)) .catch(() => setNoticeBadge(undefined)); }; loadNoticeBadge(); noticePollTimer.current = setInterval(loadNoticeBadge, TODO_POLL_INTERVAL); return () => { if (noticePollTimer.current) clearInterval(noticePollTimer.current); }; }, []); // 转换页 amis action → 全局审批抽屉。taskId 走办理/已办详情;businessKey/processInstanceId 走只读历史查看。 useEffect(() => { const openApprovalDrawer = (event: Event) => { const detail = (event as CustomEvent).detail; if (!detail?.taskId && !detail?.businessKey && !detail?.processInstanceId) return; setApprovalRequest(detail); }; window.addEventListener(OPEN_APPROVAL_DRAWER_EVENT, openApprovalDrawer); return () => window.removeEventListener(OPEN_APPROVAL_DRAWER_EVENT, openApprovalDrawer); }, []); // 转换页 amis action → 全局消息详情弹窗。收到消息打开时由弹窗调用后端置已读。 useEffect(() => { const openMessageDetail = (event: Event) => { const detail = (event as CustomEvent).detail; if (!detail) return; if (detail.kind === 'received' && !detail.receiveId) return; if (detail.kind === 'sent' && !detail.messageId) return; setMessageRequest(detail); }; window.addEventListener(OPEN_MESSAGE_DETAIL_EVENT, openMessageDetail); return () => window.removeEventListener(OPEN_MESSAGE_DETAIL_EVENT, openMessageDetail); }, []); const handleApprovalCompleted = useCallback(() => { const detail = approvalRequest; setApprovalRequest(null); fetchTodo(0, 200) .then((full) => { if (!full.unavailable) setTodoBadge(full.items.length || undefined); }) .catch(() => setTodoBadge(undefined)); window.setTimeout(() => { window.dispatchEvent(new CustomEvent(APPROVAL_COMPLETED_EVENT, { detail })); }, 0); }, [approvalRequest]); const handleMessageReadChange = useCallback(() => { fetchUnreadCount() .then((n) => setNoticeBadge(n > 0 ? n : undefined)) .catch(() => setNoticeBadge(undefined)); window.setTimeout(() => { window.dispatchEvent(new CustomEvent(MESSAGE_DETAIL_CHANGED_EVENT)); }, 0); }, []); // F2-13:回填 Tab 标题(PageRenderPage 拿到 schema title 后调用) const updateTabTitle = useCallback((path: string, title: string) => { setTabs((prev) => prev.map((t) => (t.key === path && t.title !== title ? { ...t, title } : t)), ); }, []); // 打开/激活一个 Tab const openTab = useCallback( (key: string, title: string) => { setTabs((prev) => { if (prev.some((t) => t.key === key)) return prev; return [...prev, { key, title }]; }); setActiveKey(key); navigate(key); }, [navigate], ); // 从菜单点击触发(templateId → /page/:templateId) const handleMenuOpen = useCallback( (templateId: string) => { if (templateId === '__todo__') { openTab('/todo', '待办'); return; } if (templateId === '__workbench__') { openTab('/workbench', '工作台'); return; } openTab(`/page/${templateId}`, templateId); }, [openTab], ); // 全局搜索点击(叶子 templateId) const handleSearchOpen = useCallback( (templateId: string) => { // 用菜单 leaves 找到真实 title const leaf = leaves.find((l) => l.templateId === templateId); openTab(`/page/${templateId}`, leaf?.name ?? templateId); }, [openTab, leaves], ); // 切换 Tab(只切换路由,不增删) const handleActive = useCallback( (key: string) => { setActiveKey(key); navigate(key); }, [navigate], ); // 关闭 Tab const handleClose = useCallback( (key: string) => { setTabs((prev) => { const next = prev.filter((t) => t.key !== key); // 至少保留「待办」tab const safe = next.length ? next : [TODO_TAB]; // 若关闭的是当前激活 tab,激活相邻 tab(优先右侧) if (key === activeKey) { const idx = prev.findIndex((t) => t.key === key); const nextActive = safe[Math.min(idx, safe.length - 1)].key; setActiveKey(nextActive); navigate(nextActive); } return safe; }); }, [activeKey, navigate], ); return (
handleActive('/todo')} onOpenNotice={() => setShowNotice(true)} onOpenTemplate={handleSearchOpen} onOpenSettings={() => setShowSettings(true)} />
setCollapsed((c) => !c)} />
{/* react-router Outlet 渲染当前路由内容 */}
{showSettings ? setShowSettings(false)} /> : null} {/* F2-11 消息中心抽屉 */} {showNotice ? ( setShowNotice(false)} onReadChange={() => { fetchUnreadCount() .then((n) => setNoticeBadge(n > 0 ? n : undefined)) .catch(() => setNoticeBadge(undefined)); }} /> ) : null} {approvalRequest ? ( setApprovalRequest(null)} onCompleted={handleApprovalCompleted} /> ) : null} {messageRequest ? ( setMessageRequest(null)} onReadChange={handleMessageReadChange} /> ) : null}
); }