后台管理完整指南

本指南整合了分类管理、用户管理、新闻管理、产品管理、招聘管理、页面管理等所有后台功能的使用说明。

快速开始

登录后台

访问：http://localhost:3000/login

默认账号：admin / admin123

注意： 首次登录后请修改默认密码

后台结构

┌─────────────────────────────────────┐
│  后台管理              [logo]  │
├─────────────────────────────────────┤
│                                     │
│  仪表盘                             │
│  新闻管理                            │
│  产品管理                            │
│  招聘管理                            │
│  分类管理                            │
│  页面管理                            │
│  公司信息                            │
│  站点设置                            │
│  缓存管理                            │
│  用户管理                            │
│                                     │
│  [返回前台] [退出登录]               │
└─────────────────────────────────────┘

新闻管理

功能概述

新闻管理用于发布和管理网站新闻动态，支持富文本编辑、图片上传、分类管理等功能。

新闻列表

访问路径： /admin/news

功能：

✅ 查看所有新闻（草稿和已发布）
✅ 编辑、删除新闻
✅ 发布/取消发布状态
✅ 按创建时间排序

添加新闻

访问路径： /admin/news/new

必填字段：

标题（最多200字符）
分类
内容（支持富文本）

可选字段：

摘要（最多500字符）
图片URL（支持本地上传或外部链接）
发布状态

编辑新闻

访问路径： /admin/news/[id]

操作：

修改所有字段
删除新闻
切换发布状态

新闻分类

默认分类：

公司新闻
行业动态
技术文章
案例分享

注意： 也可以在分类管理中添加自定义分类

产品管理

功能概述

产品管理用于管理公司产品信息，包括产品图片、详细描述、应用场景、技术规格等。

产品列表

访问路径： /admin/products

功能：

✅ 查看所有产品（草稿和已发布）
✅ 编辑、删除产品
✅ 发布/取消发布状态
✅ 按排序权重排序

添加产品

访问路径： /admin/products/new

必填字段：

产品名称（最多200字符）
产品描述
产品分类
应用场景

可选字段：

产品图片（支持本地上传或外部链接）
产品详情（富文本）
产品特性（JSON数组）
技术规格（JSON数组）
薪资范围
发布状态
排序（数字越小越靠前）

产品详情编辑

产品详情使用富文本编辑器，可以：

添加标题、列表
插入图片
设置格式（粗体、斜体、下划线）
添加链接

招聘管理

功能概述

招聘管理用于发布和管理公司招聘职位，应聘者可查看职位详情并投递简历。

职位列表

访问路径： /admin/jobs

功能：

✅ 查看所有职位（草稿和已发布）
✅ 编辑、删除职位
✅ 发布/取消发布状态
✅ 按排序权重排序

添加职位

访问路径： /admin/jobs/new

必填字段：

职位名称（最多200字符）
所属部门
工作地点
职位描述（富文本）
任职要求（富文本）

可选字段：

薪资范围（如：15-25K·14薪）
发布状态
排序

编辑职位

访问路径： /admin/jobs/[id]

操作：

修改所有字段
删除职位
切换发布状态

前台展示

职位列表页： /careers

显示所有已发布的职位
显示部门、地点、薪资信息
点击查看详情

职位详情页： /careers/[id]

完整职位信息
职位描述和任职要求
邮箱投递方式

分类管理

功能概述

分类管理用于管理系统分类，包括新闻分类和产品分类。

分类列表

访问路径： /admin/categories

布局：

新闻分类区域
产品分类区域
每个分类显示：名称、排序、操作按钮

添加分类

必填字段：

分类名称（最多50字符）
分类类型（新闻分类/产品分类）
排序（数字越小越靠前）

编辑分类

操作：

修改分类名称
修改排序
删除分类（检查是否被使用）

分类规则

唯一性约束： 同类型下分类名称唯一

删除保护： 如果分类下有内容，不允许删除

默认分类：

新闻分类（4个）：

公司新闻（排序：0）
行业动态（排序：1）
技术文章（排序：2）
案例分享（排序：3）

产品分类（4个）：

混凝土固化剂（排序：0）
地坪涂料（排序：1）
养护剂（排序：2）
其他（排序：3）

用户管理

功能概述

用户管理用于管理系统后台用户，包括创建、编辑、删除用户以及角色权限管理。

用户列表

访问路径： /admin/users

显示字段：

用户名
姓名
角色（管理员/编辑/查看者）
状态（启用/禁用）
创建时间
操作按钮（编辑/删除）

添加用户

访问路径： /admin/users/new

必填字段：

用户名（3-50字符，字母数字下划线）
密码（6-100字符）
角色（admin/editor/viewer）

可选字段：

姓名
状态（启用/禁用）

编辑用户

访问路径： /admin/users/[id]

操作：

修改用户信息
修改密码
修改角色
删除用户（admin账号受保护）

角色说明

管理员（admin） - 拥有所有权限
编辑（editor） - 可以创建和编辑内容
查看者（viewer） - 只能查看，不能修改

安全规则

不能删除 admin 账号： 防止误操作导致无法登录

删除确认： 删除用户前需要确认

页面管理

功能概述

页面管理用于管理网站静态页面内容，如首页、关于我们、联系我们等。

页面列表

访问路径： /admin/pages

可管理页面：

首页（/）
关于我们（/about）
联系我们（/contact）

编辑页面内容

操作：

选择要编辑的页面
使用富文本编辑器编辑内容
点击保存立即生效

页面内容说明

首页： 轮播图、产品介绍、公司简介等 关于我们： 公司历史、企业文化、团队介绍等 联系我们： 电话、邮箱、地址、地图等

公司信息管理

功能概述

公司信息管理用于配置公司基本信息，这些信息会显示在网站的多个位置。

编辑公司信息

访问路径： /admin/company

可配置字段：

公司名称
公司描述
公司地址
联系电话
电子邮箱
微信号
QQ号

信息展示位置

页脚： 公司名称、简介、联系方式 联系我们页面： 完整的联系信息 职位详情页： 邮箱投递方式

站点设置

功能概述

站点设置用于配置网站的基本信息、SEO参数和社交媒体链接。

站点设置项

访问路径： /admin/settings

可配置项：

基本信息：

网站标题
网站副标题
网站描述

SEO设置：

SEO关键词
ICP备案号

媒体信息：

网站Logo
版权信息

社交媒体：

微信二维码
微博链接
抖音链接
小红书链接

配置建议

网站标题： 简洁明了，包含品牌词 网站描述： 150-160字符，包含核心关键词 SEO关键词： 3-5个核心关键词，用逗号分隔

缓存管理

功能概述

缓存管理用于监控和清理网站缓存，提升网站性能。

缓存统计

访问路径： /admin/cache

统计指标：

缓存命中率
缓存未命中率
最后命中时间
最后未命中时间

缓存操作

清除缓存：

清除单个页面缓存
清除所有缓存
重新验证指定路径

缓存策略：

API响应缓存1小时
前台页面缓存1小时
使用 stale-while-revalidate 策略

富文本编辑器使用指南

编辑器功能

工具栏按钮：

标题（H1-H6）
粗体（B）、斜体（I）、下划线（U）
有序列表、无序列表
链接、图片
对齐方式（左、中、右）

使用技巧

插入图片：

点击图片按钮
输入图片URL
设置宽度和高度（可选）
点击确定

创建链接：

选中要链接的文字
点击链接按钮
输入链接地址
点击确定

格式化文本：

使用标题创建层级结构
使用列表清晰展示要点
使用粗体强调重点

HTML标签速查

<h2>二级标题</h2>
<p>段落内容</p>
<strong>粗体文本</strong>
<ul>
  <li>列表项1</li>
  <li>列表项2</li>
</ul>
<a href="链接地址">链接文字</a>
<img src="图片URL" alt="描述" />

图片上传

上传方式

方式1：本地上传

点击"本地上传"按钮
选择图片文件（JPG/PNG/GIF/WebP）
最大文件大小：5MB
自动生成3个尺寸

方式2：外部URL

直接输入图片URL
支持HTTP和HTTPS
实时预览

图片尺寸

自动生成3个尺寸：

原图（最大质量，webp格式）
中图（800px宽）
缩略图（300px宽）

推荐尺寸：

新闻配图：1200x630px
产品图片：800x600px
职位图片：800x500px

图片格式

支持格式：

JPEG
PNG
GIF
WebP

API接口说明

通用说明

请求格式：

Content-Type: application/json
请求体使用JSON格式

响应格式：

成功：返回数据
失败：返回错误信息 { error: "错误信息" }

缓存头：

大多数GET请求包含缓存头
缓存时间：3600秒
重新验证时间：86400秒

新闻API

GET /api/news              - 获取所有新闻
GET /api/news?published=true - 获取已发布新闻
POST /api/news             - 创建新闻
GET /api/news/[id]        - 获取单个新闻
PUT /api/news/[id]        - 更新新闻
DELETE /api/news/[id]     - 删除新闻

产品API

GET /api/products              - 获取所有产品
GET /api/products?published=true - 获取已发布产品
POST /api/products             - 创建产品
GET /api/products/[id]        - 获取单个产品
PUT /api/products/[id]        - 更新产品
DELETE /api/products/[id]     - 删除产品

招聘API

GET /api/jobs              - 获取所有职位
GET /api/jobs?published=true - 获取已发布职位
POST /api/jobs             - 创建职位
GET /api/jobs/[id]        - 获取单个职位
PUT /api/jobs/[id]        - 更新职位
DELETE /api/jobs/[id]     - 删除职位

分类API

GET /api/categories?type=news     - 获取新闻分类
GET /api/categories?type=product  - 获取产品分类
POST /api/categories              - 创建分类
GET /api/categories/[id]         - 获取单个分类
PUT /api/categories/[id]         - 更新分类
DELETE /api/categories/[id]      - 删除分类

用户API

GET /api/users              - 获取用户列表
POST /api/users             - 创建用户
GET /api/users/[id]        - 获取单个用户
PUT /api/users/[id]        - 更新用户
DELETE /api/users/[id]     - 删除用户

页面API

GET /api/pages            - 获取所有页面
GET /api/pages/[slug]     - 获取单个页面
POST /api/pages           - 更新页面内容

公司信息API

GET /api/company      - 获取公司信息
POST /api/company     - 更新公司信息

站点设置API

GET /api/settings      - 获取所有设置
POST /api/settings     - 批量更新设置

图片上传API

POST /api/upload
Content-Type: multipart/form-data

请求体：
{
  file: File对象
}

响应：
{
  success: true,
  url: "/uploads/filename-original.webp",
  originalUrl: "/uploads/filename-original.webp",
  mediumUrl: "/uploads/filename-medium.webp",
  thumbUrl: "/uploads/filename-thumb.webp"
}

常见问题

Q1: 如何修改默认管理员密码？

登录后台
进入"用户管理"
找到admin用户，点击"编辑"
修改密码
点击"保存"

Q2: 新闻/产品发布后前台不显示？

确认已勾选"已发布"状态
清除浏览器缓存（Ctrl+Shift+R）
检查前台URL是否正确
查看浏览器控制台是否有错误

Q3: 图片上传失败？

检查文件大小是否超过5MB
确认文件格式是否正确（JPG/PNG/GIF/WebP）
检查 /public/uploads 目录权限
查看服务器错误日志

Q4: 分类无法删除？

A: 这是正常的安全机制。系统会检查该分类下是否有内容：

如果有新闻或产品，不允许删除
先将内容移动到其他分类
然后再删除原分类

Q5: 富文本编辑器显示的样式与前台不一致？

编辑器使用内联样式
前台使用全局CSS样式
确保前台有对应的样式类
浏览器控制台查看样式冲突

Q6: 如何备份数据？

数据库文件：prisma/dev.db
定期复制备份该文件
或使用 Prisma Studio 导出数据：

bash npm run prisma:studio

Q7: 如何清除缓存？

登录后台
进入"缓存管理"
点击"清除所有缓存"
或使用API手动清除

Q8: 部署到生产环境需要注意什么？

修改 SESSION_SECRET 为随机字符串
配置正确的 NEXT_PUBLIC_SITE_URL
配置 reCAPTCHA 密钥（如在中国部署需考虑替代方案）
设置文件上传目录权限
配置 PM2 自动启动
配置 Nginx 反向代理
启用 SSL 证书

最佳实践

内容发布流程

撰写内容 - 使用富文本编辑器精心编辑
添加图片 - 使用推荐的图片尺寸
选择分类 - 合理的分类便于用户查找
预览检查 - 保存前检查格式和内容
草稿保存 - 先保存为草稿
发布审核 - 确认无误后发布

命名规范

新闻标题：

简洁明了
包含关键词
吸引眼球

产品名称：

品牌名 + 产品名
标明规格型号
如：浅草混凝土固化剂-L型

职位名称：

职位级别 + 职位名称
如：高级前端工程师
如：销售经理

SEO优化建议

标题优化：

标题包含核心关键词
控制在50字符以内
放置最重要的词在开头

描述优化：

150-160字符
包含2-3个关键词
通顺流畅，自然表达

关键词优化：

3-5个核心关键词
用逗号或空格分隔
避免堆砌关键词

图片优化

文件大小：

尽量控制在500KB以内
使用压缩工具（TinyPNG等）
使用WebP格式（更小）

Alt文本：

描述图片内容
包含相关关键词
有助于SEO和可访问性

安全建议

定期修改密码
限制管理用户数量
启用HTTPS
定期备份数据
监控访问日志

更新日志

v1.0 (2024)

✅ 新闻管理系统
✅ 产品管理系统
✅ 招聘管理系统
✅ 分类管理系统
✅ 用户管理系统
✅ 页面管理系统
✅ 站点设置
✅ 富文本编辑器
✅ 图片上传功能

技术支持

如需帮助，请：

查阅本文档
检查浏览器控制台错误
查看服务器日志
联系开发团队

祝使用愉快！🎉

后台管理完整指南

目录

快速开始

登录后台

后台结构

新闻管理

功能概述

新闻列表

添加新闻

编辑新闻

新闻分类

产品管理

功能概述

产品列表

添加产品

产品详情编辑

招聘管理

功能概述

职位列表

添加职位

编辑职位

前台展示

分类管理

功能概述

分类列表

添加分类

编辑分类

分类规则

用户管理

功能概述

用户列表

添加用户

编辑用户

角色说明

安全规则

页面管理

功能概述

页面列表

编辑页面内容

页面内容说明

公司信息管理

功能概述

编辑公司信息

信息展示位置

站点设置

功能概述

站点设置项

配置建议

缓存管理

功能概述

缓存统计

缓存操作

富文本编辑器使用指南

编辑器功能

使用技巧

HTML标签速查

图片上传

上传方式

图片尺寸

图片格式

API接口说明

通用说明

新闻API

产品API

招聘API

分类API

用户API

页面API

公司信息API

站点设置API

图片上传API

常见问题

Q1: 如何修改默认管理员密码？

Q2: 新闻/产品发布后前台不显示？

Q3: 图片上传失败？

Q4: 分类无法删除？

Q5: 富文本编辑器显示的样式与前台不一致？

Q6: 如何备份数据？

Q7: 如何清除缓存？

Q8: 部署到生产环境需要注意什么？