Electron + React 19 + TypeScript + Ant Design 6 + Tailwind CSS 4 【核心架构】 - Electron 主进程(窗口管理、平台检测、图标适配) - Vite 构建链(双产物 dist/ + dist-electron/) - 共享层 shared/(类型、常量、工具函数) - IPC 通信框架 + 安全守卫 【主题系统】 - 蓝紫渐变主题(亮色/暗色双模式) - Ant Design ConfigProvider 适配(lightAlgorithm / darkAlgorithm) - Tailwind CSS 4 @theme 指令 + CSS 变量 - 设计令牌三处同步(tokens.ts / globals.css / antd-theme.ts) 【导航栏】 - 自定义 H5 导航栏替代系统菜单 - 个人版/企业版双布局 - 未登录拦截 + 事件总线驱动登录弹窗 【登录注册】 - Modal 弹层(Portal)+ Tabs 切换 - 登录/注册表单动态字段渲染 - 记住密码 / 自动登录 / 用户协议 【更新系统】 - 自定义 API 版本检查(替代 electron-updater generic provider) - 手动下载 + SHA512 校验 + spawn NSIS 安装 - 渲染进程更新状态机 Hook(useUpdater) - 检查更新按钮 + 下载进度展示 【构建工具链】 - build.mjs 构建总管(--win/--mac/--linux --personal/--enterprise --build/--clean/--sign/--upload/--publish) - scripts/ 自动化脚本(clean / generate-update-info / upload-oss / publish-release) - electron-builder NSIS 安装器(可选路径、多版本打包) - update-info.json 自动生成(fileSize/sha512/changelog/releaseDate) 【代码质量】 - ESLint + TypeScript strict + Prettier - husky + lint-staged(提交前自动检查) - commitlint(规范提交信息) - Playwright E2E + Vitest 单元测试框架 - rollup-plugin-visualizer 打包体积分析 【文档】 - README.md(快速开始 + 目录结构 + 命令速查) - UpdateA.md(发布手册:API/签名/发版流程/数据库) - CHANGELOG.md(更新日志) - .env.example(构建环境变量模板)
148 lines
4.4 KiB
TypeScript
148 lines
4.4 KiB
TypeScript
// ============================================================
|
||
// AnnouncementDrawer — 公告侧拉抽屉(SPA 内部弹出)
|
||
// 数据来源:GET /api/v1/announcements
|
||
// ============================================================
|
||
|
||
import { useEffect, useState, useCallback } from 'react';
|
||
import { Drawer, List, Typography, Empty, Tag, Spin } from 'antd';
|
||
import { NotificationOutlined } from '@ant-design/icons';
|
||
|
||
import { fetchAnnouncements, type Announcement } from '@/services/modules';
|
||
|
||
const { Text, Paragraph } = Typography;
|
||
|
||
// ---------- 辅助 ----------
|
||
|
||
/** 公告类型 → Tag 颜色映射 */
|
||
const typeColorMap: Record<string, string> = {
|
||
system: 'blue',
|
||
feature: 'purple',
|
||
activity: 'orange',
|
||
maintenance: 'red',
|
||
};
|
||
|
||
/** 公告类型 → 中文标签 */
|
||
const typeLabelMap: Record<string, string> = {
|
||
system: '系统',
|
||
feature: '功能',
|
||
activity: '活动',
|
||
maintenance: '维护',
|
||
};
|
||
|
||
/** 格式化日期(YYYY-MM-DD) */
|
||
function formatDate(iso: string): string {
|
||
try {
|
||
return new Date(iso).toLocaleDateString('zh-CN', {
|
||
year: 'numeric',
|
||
month: '2-digit',
|
||
day: '2-digit',
|
||
});
|
||
} catch {
|
||
return iso;
|
||
}
|
||
}
|
||
|
||
// ---------- 组件 ----------
|
||
|
||
interface AnnouncementDrawerProps {
|
||
open: boolean;
|
||
onClose: () => void;
|
||
}
|
||
|
||
export function AnnouncementDrawer({ open, onClose }: AnnouncementDrawerProps) {
|
||
const [list, setList] = useState<Announcement[]>([]);
|
||
const [loading, setLoading] = useState(false);
|
||
const [error, setError] = useState<string | null>(null);
|
||
|
||
// 打开抽屉时请求公告列表
|
||
const loadAnnouncements = useCallback(async () => {
|
||
setLoading(true);
|
||
setError(null);
|
||
try {
|
||
const data = await fetchAnnouncements();
|
||
// 仅展示有效公告
|
||
setList(data.filter((item) => item.is_active));
|
||
} catch (err) {
|
||
setError((err as Error).message || '加载公告失败');
|
||
setList([]);
|
||
} finally {
|
||
setLoading(false);
|
||
}
|
||
}, []);
|
||
|
||
useEffect(() => {
|
||
if (open) {
|
||
loadAnnouncements();
|
||
}
|
||
}, [open, loadAnnouncements]);
|
||
|
||
// ---- 渲染 ----
|
||
|
||
return (
|
||
<Drawer
|
||
title={
|
||
<span className="flex items-center gap-2">
|
||
<NotificationOutlined />
|
||
公告
|
||
</span>
|
||
}
|
||
placement="right"
|
||
size={380}
|
||
open={open}
|
||
onClose={onClose}
|
||
styles={{ body: { padding: 0 } }}
|
||
>
|
||
{loading ? (
|
||
<div className="flex items-center justify-center h-64">
|
||
<Spin description="加载中..." />
|
||
</div>
|
||
) : error ? (
|
||
<div className="flex items-center justify-center h-64">
|
||
<Empty description={error} />
|
||
</div>
|
||
) : list.length === 0 ? (
|
||
<div className="flex items-center justify-center h-64">
|
||
<Empty description="暂无公告" />
|
||
</div>
|
||
) : (
|
||
<List
|
||
dataSource={list}
|
||
renderItem={(item) => (
|
||
<List.Item className="px-6! py-4!">
|
||
<div className="w-full space-y-2">
|
||
{/* 标题 + 类型标签 */}
|
||
<div className="flex items-center justify-between gap-2">
|
||
<Text strong className="text-sm flex-1" ellipsis>
|
||
{item.pinned && '📌 '}
|
||
{item.title}
|
||
</Text>
|
||
<Tag
|
||
color={typeColorMap[item.type] || 'default'}
|
||
className="m-0! text-xs shrink-0"
|
||
>
|
||
{typeLabelMap[item.type] || item.type}
|
||
</Tag>
|
||
</div>
|
||
|
||
{/* 内容 */}
|
||
<Paragraph
|
||
className="mb-0! text-xs"
|
||
type="secondary"
|
||
ellipsis={{ rows: 2 }}
|
||
>
|
||
{item.content}
|
||
</Paragraph>
|
||
|
||
{/* 日期 */}
|
||
<Text type="secondary" className="text-xs">
|
||
{formatDate(item.created_at)}
|
||
</Text>
|
||
</div>
|
||
</List.Item>
|
||
)}
|
||
/>
|
||
)}
|
||
</Drawer>
|
||
);
|
||
}
|