node-resource-utils 0.0.0-stage → 1.1.7

package/resources/src/app/change-password/ChangePasswordForm.tsx

@@ -0,0 +1,174 @@
+'use client';
+
+import { useState } from 'react';
+import { useRouter } from 'next/navigation';
+import { signOut } from 'next-auth/react';
+import { Alert, App, Button, Card, Form, Input, Typography } from 'antd';
+import { LockOutlined, SafetyCertificateOutlined } from '@ant-design/icons';
+import { fs, MILITARY } from '@/lib/theme';
+import { formRules } from '@/lib/formRules';
+
+const { Title, Text } = Typography;
+
+type ApiResp = { code: number; data?: unknown; message?: string };
+
+/**
+ * 管理员重置密码后，用户登录看到的第一屏。
+ * 改密成功后直接退出登录，强制用新密码重新认证 ——
+ * 避免旧 JWT 里的 mustChangePassword 标记继续生效，逻辑最简单也最不容易出错。
+ */
+export default function ChangePasswordForm({
+  username,
+  displayName,
+}: {
+  username: string;
+  displayName: string;
+}) {
+  const router = useRouter();
+  const { message } = App.useApp();
+  const [loading, setLoading] = useState(false);
+  const [form] = Form.useForm<{ oldPassword: string; newPassword: string; confirm: string }>();
+
+  const onFinish = async (values: {
+    oldPassword: string;
+    newPassword: string;
+    confirm: string;
+  }) => {
+    setLoading(true);
+    try {
+      const r = await fetch('/api/auth/change-password', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          oldPassword: values.oldPassword,
+          newPassword: values.newPassword,
+        }),
+      });
+      const j = (await r.json()) as ApiResp;
+      if (j.code !== 0) {
+        message.error(j.message || '修改失败');
+        return;
+      }
+
+      message.success('密码修改成功，请使用新密码重新登录');
+      await signOut({ redirect: false });
+      router.push('/login');
+      router.refresh();
+    } catch (e) {
+      message.error(`修改失败：${String(e)}`);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div
+      style={{
+        minHeight: '100vh',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: 24,
+        backgroundImage:
+          'var(--wb-brand-bg)',
+      }}
+    >
+      <Card
+        style={{
+          width: '100%',
+          maxWidth: 440,
+          borderRadius: 14,
+          boxShadow: 'var(--wb-brand-shadow)',
+        }}
+      >
+        <div style={{ textAlign: 'center', marginBottom: 20 }}>
+          <div
+            style={{
+              width: 44,
+              height: 44,
+              borderRadius: 12,
+              margin: '0 auto 12px',
+              display: 'grid',
+              placeItems: 'center',
+              background: MILITARY.soft,
+              border: `1px solid ${MILITARY.softStrong}`,
+              color: MILITARY.primary,
+            }}
+          >
+            <SafetyCertificateOutlined style={{ fontSize: fs(22) }} />
+          </div>
+          <Title level={3} style={{ marginBottom: 4 }}>
+            请先修改密码
+          </Title>
+          <Text type="secondary">
+            {displayName}（{username}）
+          </Text>
+        </div>
+
+        <Alert
+          type="warning"
+          showIcon
+          style={{ marginBottom: 18 }}
+          title="管理员已重置你的密码"
+          description="为保障账号安全，首次登录必须设置新密码，完成后请用新密码重新登录。"
+        />
+
+        <Form form={form} layout="vertical" onFinish={onFinish} requiredMark={false}>
+          <Form.Item
+            name="oldPassword"
+            label="当前密码"
+            rules={[{ required: true, message: '请输入当前密码' }]}
+          >
+            <Input.Password
+              prefix={<LockOutlined />}
+              placeholder="管理员重置后的密码"
+              autoComplete="current-password"
+            />
+          </Form.Item>
+          <Form.Item
+            name="newPassword"
+            label="新密码"
+            rules={formRules('password', { label: '新密码', required: true })}
+          >
+            <Input.Password
+              prefix={<LockOutlined />}
+              maxLength={64}
+              placeholder="6-64 位，不能含空格，不能与原密码相同"
+              autoComplete="new-password"
+            />
+          </Form.Item>
+          <Form.Item
+            name="confirm"
+            label="确认新密码"
+            dependencies={['newPassword']}
+            rules={[
+              { required: true, message: '请再次输入新密码' },
+              ({ getFieldValue }) => ({
+                validator: (_r, value) =>
+                  !value || getFieldValue('newPassword') === value
+                    ? Promise.resolve()
+                    : Promise.reject(new Error('两次输入的密码不一致')),
+              }),
+            ]}
+          >
+            <Input.Password
+              prefix={<LockOutlined />}
+              maxLength={64}
+              placeholder="再次输入"
+              autoComplete="new-password"
+            />
+          </Form.Item>
+          <Button type="primary" htmlType="submit" block size="large" loading={loading}>
+            修改密码
+          </Button>
+        </Form>
+
+        <div style={{ textAlign: 'center', marginTop: 14 }}>
+          <Button type="link" size="small" onClick={() => void signOut({ callbackUrl: '/login' })}>
+            退出登录
+          </Button>
+        </div>
+      </Card>
+    </div>
+  );
+}

package/resources/src/app/change-password/page.tsx

@@ -0,0 +1,19 @@
+import { redirect } from 'next/navigation';
+import { currentUser } from '@/auth';
+import ChangePasswordForm from './ChangePasswordForm';
+
+export const dynamic = 'force-dynamic';
+
+/**
+ * 首次登录强制改密页。
+ *
+ * 放在 (admin) 布局之外：那个布局会把 mustChangePassword 的用户重定向到本页，
+ * 如果本页也在布局里，就会自己跳自己，形成死循环。
+ */
+export default async function ChangePasswordPage() {
+  const user = await currentUser();
+  if (!user) redirect('/login');
+  if (!user.mustChangePassword) redirect('/dashboard');
+
+  return <ChangePasswordForm username={user.username} displayName={user.name} />;
+}

package/resources/src/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,56 @@
+import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+import { currentUser } from '@/auth';
+import { getDoc, getDocNeighbors, loadDocs } from '@/lib/docs';
+import { buildSearchEntries, getUserMenuTree } from '@/lib/menu-service';
+import { APP_NAME } from '@/lib/appInfo';
+import DocsHome from '@/components/docs/DocsHome';
+import DocArticle from '@/components/docs/DocArticle';
+
+export const dynamic = 'force-dynamic';
+
+type PageProps = { params: Promise<{ slug?: string[] }> };
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { slug = [] } = await params;
+  if (!slug.length) return { title: `帮助中心 · ${APP_NAME}` };
+
+  const doc = await getDoc(slug);
+  if (!doc) return { title: `文档未找到 · ${APP_NAME}` };
+
+  return {
+    title: `${doc.title} · 帮助中心`,
+    description: doc.description || undefined,
+  };
+}
+
+/**
+ * 文档站路由。
+ *
+ * `/docs`            → 文档首页（搜索、分类、功能速查）
+ * `/docs/<slug...>`  → 单篇文档（正文、右侧目录、上下篇）
+ *
+ * slug 直接对应 `content/docs` 下的 Markdown 路径。内容不存在时走文档站
+ * 自己的 404，而不是把用户甩回后台错误页。
+ */
+export default async function DocsPage({ params }: PageProps) {
+  const { slug = [] } = await params;
+
+  if (!slug.length) {
+    const user = await currentUser();
+    const { nav, stats } = await loadDocs();
+    // 功能速查与系统菜单共用同一棵树：新模块登记菜单后自动出现在文档首页，
+    // 不需要再维护第二份“功能清单”。
+    const menus = user ? await getUserMenuTree(user) : [];
+    const features = buildSearchEntries(menus);
+
+    return <DocsHome appName={APP_NAME} nav={nav} stats={stats} features={features} />;
+  }
+
+  const doc = await getDoc(slug);
+  if (!doc) notFound();
+
+  const { prev, next } = await getDocNeighbors(doc.slug);
+
+  return <DocArticle doc={doc} prev={prev} next={next} />;
+}

package/resources/src/app/docs/layout.tsx

@@ -0,0 +1,34 @@
+import type { Metadata } from 'next';
+import { redirect } from 'next/navigation';
+import { currentUser } from '@/auth';
+import { loadDocs } from '@/lib/docs';
+import { APP_NAME } from '@/lib/appInfo';
+import DocsChrome from '@/components/docs/DocsChrome';
+import '@/components/docs/docs.css';
+
+export const dynamic = 'force-dynamic';
+
+export const metadata: Metadata = {
+  title: `帮助中心 · ${APP_NAME}`,
+  description: `${APP_NAME} 的系统使用手册：功能说明、操作步骤与常见问题。`,
+};
+
+/**
+ * 文档站布局（独立于后台管理外壳）。
+ *
+ * 仍然要求登录：帮助文档会暴露系统模块与权限设计，放在登录后更符合业务系统习惯；
+ * 从后台侧边栏或顶栏进入时天然带着会话，不会出现二次登录。
+ */
+export default async function DocsLayout({ children }: { children: React.ReactNode }) {
+  const user = await currentUser();
+  if (!user) redirect('/login');
+  if (user.mustChangePassword) redirect('/change-password');
+
+  const { nav, stats } = await loadDocs();
+
+  return (
+    <DocsChrome appName={APP_NAME} nav={nav} stats={stats} userName={user.name}>
+      {children}
+    </DocsChrome>
+  );
+}

package/resources/src/app/docs/loading.tsx

@@ -0,0 +1,19 @@
+/** 文档页加载骨架：布局已经直出，只有正文区域等待数据 */
+export default function DocsLoading() {
+  return (
+    <div className="wb-docs-article-layout">
+      <div className="wb-docs-article" aria-label="文档加载中">
+        <div className="wb-skeleton" style={{ width: '36%', height: 13, marginBottom: 20 }} />
+        <div className="wb-skeleton" style={{ width: '62%', height: 32, marginBottom: 14 }} />
+        <div className="wb-skeleton" style={{ width: '78%', height: 14, marginBottom: 30 }} />
+        {[92, 100, 84, 96, 70].map((width, index) => (
+          <div
+            key={index}
+            className="wb-skeleton"
+            style={{ width: `${width}%`, height: 13, marginBottom: index === 4 ? 0 : 11 }}
+          />
+        ))}
+      </div>
+    </div>
+  );
+}

package/resources/src/app/docs/not-found.tsx

@@ -0,0 +1,25 @@
+'use client';
+
+import Link from 'next/link';
+import { FileSearchOutlined } from '@ant-design/icons';
+import { fs } from '@/lib/theme';
+
+/** 文档站内的 404：保持阅读场景，不把用户甩回后台错误页 */
+export default function DocsNotFound() {
+  return (
+    <div className="wb-docs-article-layout">
+      <article className="wb-docs-article">
+        <div className="wb-docs-empty">
+          <FileSearchOutlined style={{ fontSize: fs(30), color: '#8b9181', marginBottom: 10 }} />
+          <h2>没有找到这篇文档</h2>
+          <p>它可能已被移动或删除。可以返回文档首页，或使用顶栏搜索重新查找。</p>
+          <p style={{ marginTop: 16 }}>
+            <Link href="/docs" className="wb-docs-group-enter">
+              返回帮助中心
+            </Link>
+          </p>
+        </div>
+      </article>
+    </div>
+  );
+}