silver-knowledge-quick-setup.md 3.6 KB

银龄智库管理后台快速部署检查清单

部署步骤(按顺序执行)

✅ 步骤1:创建页面组件

执行命令:

# 创建页面文件
touch src/client/admin/pages/SilverKnowledges.tsx
touch src/client/admin/pages/SilverKnowledgeForm.tsx

复制代码:

  • SilverKnowledges.tsx 代码复制到对应文件
  • SilverKnowledgeForm.tsx 代码复制到对应文件

✅ 步骤2:更新菜单配置

文件: src/client/admin/menu.tsx

修改内容:

  1. 添加图标导入:

    import { BookOutlined } from '@ant-design/icons';
    
  2. menuItems 数组中添加新菜单项(建议放在银龄库管理后面):

    {
    key: 'silver-knowledges',
    label: '银龄智库发布',
    icon: <BookOutlined />,
    path: '/admin/silver-knowledges',
    permission: 'silver-knowledge:manage'
    }
    

✅ 步骤3:更新路由配置

文件: src/client/admin/routes.tsx

修改内容:

  1. 添加页面导入:

    import { SilverKnowledgesPage } from './pages/SilverKnowledges';
    import { SilverKnowledgeFormPage } from './pages/SilverKnowledgeForm';
    
  2. children 数组中添加路由(建议放在 silver-jobs 后面):

    {
    path: 'silver-knowledges',
    element: <SilverKnowledgesPage />,
    errorElement: <ErrorPage />
    },
    {
    path: 'silver-knowledges/new',
    element: <SilverKnowledgeFormPage />,
    errorElement: <ErrorPage />
    },
    {
    path: 'silver-knowledges/:id/edit',
    element: <SilverKnowledgeFormPage />,
    errorElement: <ErrorPage />
    }
    

✅ 步骤4:安装依赖包

npm install react-quill @types/react-quill dayjs

✅ 步骤5:启动开发服务器

npm run dev

验证清单

功能验证

  • 管理后台左侧菜单显示"银龄智库发布"
  • 点击菜单进入银龄智库列表页面
  • 列表页面显示所有银龄智库内容
  • 点击"新建知识"按钮进入创建页面
  • 表单支持富文本编辑
  • 支持图片和附件上传
  • 支持状态管理(草稿/发布/隐藏)
  • 支持推荐设置
  • 支持编辑和删除操作
  • 支持搜索和筛选功能

权限验证

  • 需要登录才能访问
  • 需要 silver-knowledge:manage 权限
  • 不同权限用户显示对应功能

数据验证

  • 列表正确显示银龄智库数据
  • 创建新知识成功保存
  • 编辑现有知识成功更新
  • 删除操作正确执行

常见问题解决

Q1: 富文本编辑器样式问题

解决: 确保在 src/client/admin/index.tsx 中引入:

import 'react-quill/dist/quill.snow.css';

Q2: 图片上传失败

解决: 检查 MinIO 配置和文件上传权限

Q3: 权限不足

解决: 在数据库中添加对应权限:

INSERT INTO permissions (name, description) VALUES 
('silver-knowledge:manage', '管理银龄智库');

测试账号

使用管理员账号登录后可直接访问:

  • URL: http://localhost:5173/admin/silver-knowledges
  • 菜单:管理后台 → 银龄智库发布

完成标志

  • 左侧菜单显示"银龄智库发布"
  • 可以正常访问 /admin/silver-knowledges
  • 可以创建新的银龄智库内容
  • 可以编辑现有内容
  • 可以删除内容
  • 支持搜索和筛选

后续优化建议

  1. 添加批量操作功能
  2. 添加导出功能
  3. 添加统计分析面板
  4. 优化移动端体验
  5. 添加审核流程

技术支持

如有问题,请参考:

  • 实施指南:silver-knowledge-admin-code-guide.md
  • 完整计划:silver-knowledge-admin-implementation-plan.md