CNProSafe 完整使用手册

B2B PPE 外贸独立站 · 前台操作 & 后台管理 · v2.0

📑 目录一、账号与登录二、前台（买家端）三、管理后台总览四、产品管理五、询价管理六、报价管理七、订单管理八、样品订单九、买家管理十、联系消息十一、内容管理十二、营销系统十三、系统设置十四、客服系统十五、支付系统十六、SEO 与多语言十七、常见操作流程十八、常见问题

一、账号与登录

角色	登录地址	用户名	密码	权限说明
超级管理员	https://cnprosafe.com/admin/login	`admin`	`Admin123!`	全部功能 + 用户管理
内容编辑	https://cnprosafe.com/admin/login	`自行创建`	`自行创建`	产品/内容/询价/报价/订单（不含系统设置）
买家测试	https://cnprosafe.com/buyer/login	`自行注册`	`自行注册`	前台买家完整功能

买家注册

访问 https://cnprosafe.com/buyer/register，填写邮箱、密码、公司名称、联系人、国家 → 提交。新注册买家状态为 pending，需管理员在后台审批后才能登录。

也支持 Google 一键登录：点击 "Sign in with Google" 按钮，首次登录自动创建账号并激活。

密码相关

忘记密码：https://cnprosafe.com/buyer/forgot-password → 输入邮箱 → 收重置邮件 → 点击链接设置新密码
修改密码：登录后 → Profile → Change Password（需输入当前密码）

⚠ 有BUG 可整理反馈给开发团队

二、前台（买家端）功能

2.1 网站首页

访问 https://cnprosafe.com/en（英文）或 https://cnprosafe.com/es（西班牙语），页面结构：

区域	说明
顶部导航栏	Products、Industries、About、Blog、Contact + 语言切换 + 询价篮图标
Hero Banner	品牌主视觉大图 + 标题 + CTA 按钮（Get Quote / View Products）
Product Categories	按品类展示入口卡片
Featured Products	精选产品展示区
Industry Applications	行业解决方案
Certificates	ISO / CE / ANSI 认证 Logo 墙
Why Choose Us	优势说明（OEM/ODM、快速交货、全球物流）
Testimonials	客户评价轮播
Trusted By Clients	合作客户 Logo 墙
FAQ Section	常见问题手风琴
Final CTA	底部行动号召
Footer	公司信息、快速链接、联系方式、社交媒体、Newsletter 订阅

2.2 产品浏览与搜索

产品列表页 https://cnprosafe.com/en/products：

左侧分类筛选栏（支持多级分类）
顶部搜索框（支持 AI 混合搜索：关键词 + 语义匹配）
排序：默认按 sort_order，支持价格排序
分页浏览
产品卡片：封面图、标题、SKU、价格区间、MOQ、认证标签

产品详情页 https://cnprosafe.com/en/products/{slug}：

图片画廊：点击放大（Lightbox），支持多图切换
变体选择器：Size / Color / Material 等选项，切换变体实时更新 SKU 和价格
价格阶梯表：不同数量区间的单价（如 1000-2999 pcs: $5.00, 3000-4999 pcs: $4.50）
Addon 配件：可选附加项（如 Logo 印刷、定制包装）
规格参数：产品详细规格表
认证信息：适用标准和证书
SEO 信息：Meta Title / Description / Keywords（对搜索引擎可见）
操作按钮：Add to Inquiry / Request Sample / Quick Quote / Product Compare

2.3 询价篮（Inquiry Basket）

在任意产品详情页点击 "Add to Inquiry"，产品加入右上角购物篮图标（显示数量角标）

可跨多个产品添加，每个产品可选变体、数量、Addon

点击购物篮图标 → 进入 https://cnprosafe.com/en/inquiry-basket

查看产品列表（显示 SKU、数量、MOQ 警示），可增减数量或删除

填写联系表单：Name、Email（必填）、Company、Phone、Country、Destination Port、Incoterms、Message

可选上传附件（图纸/规格书，最大 5MB）

提交 → 跳转到成功页，显示询价编号（INQ-YYYYMMDD-XXXX）

💡 询价篮数据自动保存到浏览器 IndexedDB + 已登录买家同步到服务器，换设备可恢复。

2.4 样品申请

产品详情页点击 "Request Sample" → 弹出表单：填写姓名、邮箱、国家、地址、快递偏好、数量、尺寸/颜色备注 → 提交。样品订单由管理后台审核定价后发送付款链接。

2.5 快速报价（Quick Quote）

产品详情页点击 "Quick Quote" → 弹窗直接填写姓名、邮箱、公司、数量、留言 → 提交即创建询价。

2.6 产品对比

产品详情页点击 "Compare" → 加入对比栏（底部悬浮）。最多对比 4 个产品，可查看规格差异。

2.7 联系表单

访问 https://cnprosafe.com/en/contact：填写姓名、邮箱、公司、电话、产品类别、数量、贸易条款、主题、留言、附件 → 提交。系统自动创建 Inquiry + Contact Message，互相通过 inquiryNo 关联。

2.8 买家门户

买家登录后访问 https://cnprosafe.com/buyer/dashboard：

页面	功能
Dashboard	活动总览：询价数/报价数/订单数/样品数 + 时间线（所有活动按时间排列，点击跳转详情）
Orders	订单列表 → 订单详情（四步进度条：confirmed → in_production → shipped → delivered）+ 产品明细 + 物流单号
Samples	样品列表 → 详情（产品/SKU/数量/快递/物流状态/付款状态）
Quick Order	快速下单页面
Profile	编辑公司名、联系人、国家、电话

2.9 公开页面一览

页面	URL	内容
行业应用	https://cnprosafe.com/en/industries	按行业分类展示产品方案
认证资质	https://cnprosafe.com/en/certifications	ISO/CE/ANSI/CSA 证书列表（可下载 PDF）
案例展示	https://cnprosafe.com/en/case-studies	客户成功案例图文
下载中心	https://cnprosafe.com/en/download	产品手册/规格书 PDF 下载
博客	https://cnprosafe.com/en/blog	行业文章列表 → 文章详情
FAQ	https://cnprosafe.com/en/faq	常见问题（手风琴展开）
关于我们	https://cnprosafe.com/en/about	公司介绍、工厂展示、团队
客服中心	https://cnprosafe.com/en/support-dashboard	AI Chat + Live Chat + WhatsApp 三合一
搜索	https://cnprosafe.com/en/search?q=xxx	全站产品搜索（AI 混合搜索）
报价查看	`https://cnprosafe.com/en/quote/{token}`	买家通过邮件 Token 链接查看报价并接受/拒绝
询价成功	`https://cnprosafe.com/en/inquiry/success?no=XXX`	询价提交成功确认页
服务条款	https://cnprosafe.com/en/terms	Terms of Service
隐私政策	https://cnprosafe.com/en/privacy-policy	Privacy Policy
Cookie 政策	https://cnprosafe.com/en/cookie-policy	Cookie Policy
自定义页面	`https://cnprosafe.com/en/pages/{slug}`	管理员可创建任意自定义页面

2.10 客服组件

全站右下角悬浮客服按钮（Support FAB），点击展开：

AI Chat：智能客服机器人，回答产品、价格、MOQ、交期等问题。支持产品上下文（在当前产品页打开时自动关联产品信息）
Live Chat：实时人工聊天（WebSocket），输入姓名和问题后等待管理员接入
WhatsApp：多代理 WhatsApp 联系（Sophie Han / Export Sales），点击自动跳转 WhatsApp
Quote：快捷跳转询价篮

2.11 多语言

支持 5 种语言：EN（英语）、ES（西班牙语）、FR（法语）、AR（阿拉伯语-RTL）、PT（葡萄牙语）。顶部导航栏切换，URL 前缀：/en /es /fr /ar /pt。

在管理后台编辑任意内容时，切换 locale tab 即可编辑对应语言版本。未翻译的内容自动 fallback 到英文。

三、管理后台总览

访问 https://cnprosafe.com/admin/login，使用管理员账号登录。

左侧菜单导航

一级菜单	二级菜单
📊 Dashboard	数据概览（统计卡片 + 图表）
📦 Products	产品列表 / 创建 / 编辑 / 导入导出
📋 Inquiries	询价列表 / 详情 / 状态管理
💰 Quotes	报价列表 / 创建 / 编辑 / 发送 / PDF 下载
📦 Orders	订单列表 / 详情 / 状态更新 / 物流
💬 Contacts	联系消息列表 / 回复线程
👥 Buyers	买家列表 / 审批 / 价格组 / 批量操作
📝 Content	Homepage / About / Industries / Case Studies / FAQs / Certificates / Downloads / Posts / Testimonials / Pages / Samples / Live Chat / WhatsApp / Chat Logs
📧 Marketing	Campaigns / Templates / Subscribers / Config
📈 Analytics	网站流量分析
🖼 Assets	媒体资源库（上传/浏览/删除）
⚙ Settings	Site / Layout / Email Templates / Users / PayPal / Price Tiers / AI Forwarding / Notification Channels / Support / Embeddings / Operations / Logs
🏷 Categories	产品分类管理

四、产品管理

4.1 产品列表

Products → 列表页。支持：

按分类（Category）筛选
按状态筛选：published draft deleted
按关键词搜索（SKU / Slug / Title）
分页浏览

4.2 创建产品

Products → Create Product

Basic Info：选择 Category、SKU、Slug、封面图（上传自动上 OSS）、MOQ、样品是否可用、交货时间、价格区间

Translations：切换 EN/ES/FR/AR/PT Tab，填写各语言版本：Title、Description、Short Description、Specs（JSON）、Certifications（逗号分隔或 JSON 数组）、Meta Title、Meta Description、Keywords

Status：选择 published（上线）/ draft（草稿）

Featured：勾选 Is Featured 则出现在首页精选产品区

保存 → 自动同步 AI 向量嵌入（用于语义搜索）→ 自动清除 Redis 缓存

4.3 变体管理

开启 Has Variants 开关
添加 Option（如 Size: S, M, L, XL / Color: Red, Blue, Black）
点击 "Generate Variants" → 自动生成所有组合（如 S-Red, S-Blue, M-Red, M-Blue...）
为每个变体设置：独立 SKU、价格、价格阶梯（Price Tiers）、MOQ、图片、样品可用性、交货时间
变体列表可拖拽排序

4.4 Addon 管理

在产品编辑页的 Addons 区域：添加附加选项（如 Logo 印刷、定制包装盒、加急生产）。每个 Addon 可设置：名称、描述、图片、价格、收费类型（one_time / per_unit）、是否必选、是否启用。

4.5 产品图片

产品详情页 → Images 区域：上传多张图片（自动 OSS），拖拽排序，可删除。

4.6 批量导入/导出

导出：Products → Export CSV → 下载全部产品数据
导入：Products → Import CSV → 选择 CSV 文件 → 系统解析并创建/更新产品（返回 created / updated / errors 统计）

五、询价管理

5.1 列表

Inquiries → 可按以下条件筛选：

Status：new / processing / quoted / won / lost / spam
SLA：ok overdue critical（自动计算：超过 24h 未首次响应 → overdue，超过 72h → critical）
Keyword：搜索询价编号、买家姓名、公司名

5.2 详情

点击进入后显示：

买家信息：姓名、邮箱、电话、公司、国家、时区、IP
产品明细：SKU、产品名、数量、变体、Addon、自定义字段（customFields JSON）
附件：文件名 + 下载链接
贸易条款：Incoterms、Destination Port、Port of Loading
消息内容
来源：website / contact_form / quick_quote
SLA 状态 + 首次响应时间
Quality Score（AI 评分）

5.3 操作

更改状态（new → processing → quoted → won / lost）
分配跟进人（Assign To）
添加内部备注（Admin Notes）
一键创建报价（Create Quote）

六、报价管理

6.1 创建报价

Quotes → Create Quote → 选择关联的 Inquiry

系统自动填入买家信息和产品明细

填写每项产品的单价（Unit Price）→ 自动计算小计（Subtotal）

设置运费（Shipping Cost）、折扣（Discount）、税费（Tax）

设置贸易条款（Incoterms）、付款条款（Payment Terms）、交期（Delivery Time）、有效期（Valid Until）

添加备注（可分别设置对内备注和买家可见备注）

保存 → 点击 Send → 生成唯一 Token → 邮件发送 Quote 链接给买家

6.2 报价状态

状态	说明
draft	草稿，未发送
sent	已发送，等待买家查看
viewed	买家已查看
accepted	买家已接受 → Inquiry 自动变为 "won" → 引导付款
rejected	买家已拒绝 → Inquiry 自动变为 "lost"
expired	已过期（超过 Valid Until）

6.3 买家接受后

买家接受报价 → 系统跳转支付页面（Payment Method Selector）→ 选择 PayPal 或银行转账 → 完成付款 → 系统自动创建 Order → Inquiry → Quote → Order 全链路可追溯。

6.4 PDF 下载

Quotes → 详情页 → Download PDF → 生成专业报价单 PDF（含公司 Logo、产品表、金额、条款）。

七、订单管理

7.1 订单创建

订单由系统自动创建（买家接受报价并付款后），也可管理员手动在后台 Orders → Create 创建。

7.2 订单状态流转

状态	说明	下一步
confirmed	已确认	→ in_production
in_production	生产中	→ shipped
shipped	已发货（填写 Tracking Number）	→ delivered
delivered	已签收	终点
cancelled	已取消	终点

7.3 订单管理操作

编辑订单状态、物流单号、发货方式、运费、实收金额、货币
查看关联的 Inquiry 和 Quote（完整追溯链）
查看产品明细（只读）
买家端实时可见订单状态变更

八、样品订单

8.1 流程

买家在前端产品页提交 "Request Sample"

管理员：Content → Samples → 列表查看

审核样品请求 → 设置收费类型（Free / Fixed Price）→ 填入价格、运费

点击 "Send Payment" → 生成 PayPal 付款链接 → 邮件发送给买家

买家完成付款 → PayPal capture 回调 → 系统自动更新为 paid

管理员填写物流单号 → 更新状态为 shipped → 买家可追踪

8.2 样品订单字段

字段	说明
Charge Type	FREE / FIXED_PRICE
Fixed Price / Shipping Cost	固定价格和运费
Payment Status	pending / paid / refunded
Courier Pref / Account	快递偏好和账号
Tracking Number	物流追踪号
Dimensions / Weight	包裹尺寸和重量
Admin Notes	内部备注（买家不可见）
Estimated Delivery	预计送达日期

九、买家管理

9.1 买家状态

状态	说明
pending	待审批（新注册默认）
active	正常
suspended	已停用（无法登录）
rejected	已拒绝

9.2 操作

审批：Buyers → 筛选 pending → 查看详情 → Update Status → active
批量审批：勾选多个买家 → Batch Update Status
价格组：为不同买家分配 tier_1 / tier_2 / tier_3，影响所有产品价格计算（自动应用对应折扣率）
查看订单历史：Buyer 详情页 → Orders 标签，展示该买家所有询价/报价/订单/样品记录
搜索：按邮箱或公司名搜索

十、联系消息

10.1 列表

Contacts → 按已读/未读筛选 → 点击进入详情。

10.2 回复线程

查看原始消息
Reply：填写标题和正文 → 发送邮件 → 自动记录到回复线程（outbound）
Record Inbound：手动记录买家的邮件回复（inbound）
完整线程展示（按时间排序）

十一、内容管理

11.1 Homepage 首页编辑

Content → Homepage → 可配置的区块：

Hero Banner：大图、标题、副标题、CTA 按钮文字和链接
Product Categories：展示哪些分类
Featured Products：精选产品（默认取 isFeatured=1 的产品）
Industry Applications：行业入口卡片
Certificates：展示哪些证书
Why Choose Us：文字 + 图标列表
Testimonials：轮播的客户评价
Final CTA：底部行动号召

11.2 About / Industries / Case Studies

分别编辑对应页面的内容区块。支持多语言和图片上传。

11.3 FAQs

列表：按 sort_order 排序
创建/编辑：Category、Question、Answer、Sort Order、Active 开关
翻译：切换 locale tab 编辑各语言版本（存储到 faq_translations 表）

11.4 Certificates 认证管理

字段：Name、Cert No、Issuing Body、Standard、Valid From/Until、Image、File（PDF）、Scope
前台展示在 https://cnprosafe.com/en/certifications 和首页证书墙

11.5 Downloads 下载管理

上传 PDF/文档，前台 https://cnprosafe.com/en/download 展示。

11.6 Posts 博客

创建/编辑：Title、Slug、Content（富文本编辑器）、Cover Image、Excerpt、Category、Tags
翻译：切换 locale 编辑多语言版本
SEO：Meta Title、Meta Description、Keywords
状态：draft / published
前台 https://cnprosafe.com/en/blog 列表 + https://cnprosafe.com/en/blog/{slug} 详情

11.7 Testimonials 客户评价

字段：Client Name、Company、Logo、Position/Title、Review Text、Rating（星级）、Locale（按语言过滤展示）
前台首页 Testimonials 轮播

11.8 Pages 自定义页面

Content → Pages → 创建自定义页面（标题、Slug、内容-富文本）。自动生成路由 https://cnprosafe.com/en/pages/{slug}。可删除。

11.9 Live Chat 实时聊天

Content → Live Chat → 等待中的会话列表 → 点击接入 → 实时聊天面板（WebSocket）。支持：发送消息、查看访客信息、关闭会话、主动联系在线访客（Proactive Chat）。

11.10 WhatsApp 管理

Content → WhatsApp → 管理 WhatsApp 代理信息（姓名、职位、手机号、头像、欢迎语）。

11.11 Chat Logs

AI 聊天记录查看：按 session 查看对话历史。

十二、营销系统

12.1 Campaigns 营销活动

Marketing → Campaigns → Create

Step 1 — Template：选择邮件模板（可使用系统模板或自定义模板）

Step 2 — Content：编辑邮件标题、正文（富文本编辑器）、可插入产品卡片（Product Picker）

Step 3 — Recipients：选择收件人（全部订阅者 / 按标签筛选 / CSV 导入）

Step 4 — Preview & Send：预览邮件 → 发送测试邮件 → 确认发送 → 后台异步批量发送

发送后可查看统计数据：发送数、打开数、点击数、退订数。

12.2 Templates 模板管理

创建/编辑邮件模板（富文本编辑器）
支持变量：{{name}} {{email}} {{company}} 等
预览 + 测试发送

12.3 Subscribers 订阅者

列表：所有 Newsletter 订阅者
导入/导出 CSV
退订管理

12.4 Config 配置

发件人名称/邮箱、发送频率限制、退订页链接。

十三、系统设置

13.1 Site 站点信息

Settings → Site：站点名称、标语、Logo、联系方式（邮箱/电话/地址/传真）、社交媒体链接（Facebook/LinkedIn/YouTube）、SEO 默认值、Google OAuth Client ID。

13.2 Layout 布局

Settings → Layout：Header 配置（Logo、导航菜单、自定义页面链接）、Footer 配置（版权信息、快速链接）、Promo Bar（顶部公告栏，支持多条轮播）。

13.3 Email Templates 邮件模板

管理系统自动发送的邮件模板：

模板 Key	触发时机	可用变量
inquiry_confirmation	买家提交询价	name, inquiryNo, email, company, country, message
quote_sent	管理员发送报价	name, quoteNo, currency, subtotal, shippingCost, total, deliveryTime, incoterms, paymentTerms, validUntil, buyerEmail, itemsTable, itemsText
quote_accepted	买家接受报价	同上
status_update	订单状态变更	name, inquiryNo, status, notes

可编辑 HTML/Text 双版本、预览、测试发送、复制模板。

13.4 Users 管理员账号

列表（仅 super_admin 可见）
创建：Username、Password、Email、Display Name、Role（admin / editor / super_admin）
编辑：修改邮箱、显示名、角色、密码
停用/启用
重新生成 Access Key（用于 API 访问）

13.5 PayPal 支付配置

Settings → PayPal：

Sandbox / Live 双模式独立配置
OAuth 一键连接（无需手动输入 Client ID/Secret）
支付方式开关：PayPal、Credit Card（via PayPal）、Bank Transfer
银行转账信息配置（Bank Name、Account Name、Account Number、IBAN、SWIFT、Instructions）
PayPal 按钮样式：颜色、形状、标签、布局
Pay Later / Venmo 开关
订单状态映射（付款后自动设置什么订单状态）

13.6 Price Tiers 价格阶梯

Settings → Price Tiers：配置价格组（tier_1 / tier_2 / tier_3），每个 tier 设置：名称、折扣率（%）、MOQ 要求。买家分配对应 tier 后，所有产品价格自动应用折扣。

13.7 AI Forwarding

Settings → AI Forwarding：配置客户消息自动转发规则。可设置关键词匹配 → 转发到指定邮箱。

13.8 Notification Channels 通知渠道

Settings → Notification Channels：

Email：买家确认邮件 + 管理员通知邮件开关
Webhooks：飞书 / 钉钉 / Slack / 企业微信 / 通用 Webhook（URL + 开关）
CRM：HubSpot / Zoho 集成（API Key + Module 配置）

13.9 Support 客服配置

Settings → Support：客服 Widget 全量配置（等同于 application.yml 中的 support 段），包括：

渠道开关：AI / WhatsApp / Quote / Live Chat
营业时间、GDPR 开关和提示文字
WhatsApp：多代理、欢迎语、品牌色、按钮样式、自动弹出
Chat：欢迎消息、离线提示

13.10 Embeddings 向量嵌入

Settings → Embeddings：查看 AI 嵌入索引状态、重建索引、清除索引。

13.11 Operations 运营配置

Settings → Operations：

询价表单字段自定义（增删字段、设置必填/可选、选项值）
反垃圾设置：Honeypot 开关、企业邮箱强制、免费邮箱域名黑名单
Sticky Bar 配置（电话/WhatsApp/客服按钮）

13.12 Logs 操作日志

Settings → Logs：查看所有管理操作记录（谁、什么时候、做了什么）。

十四、客服系统

14.1 AI 智能客服

全站右下角悬浮按钮 → AI Tab
自动回答产品相关问题（价格、MOQ、交期、认证、材质）
产品上下文感知：在产品页打开时自动关联当前产品
管理员可在 Content → Chat Logs 查看对话历史
支持配置第三方 AI API（Settings → AI Forwarding → Chat API Config）

14.2 Live Chat 实时聊天

访客输入姓名 + 问题 → 点击 Start Chat
系统 WebSocket 连接到管理员面板
管理员在 Content → Live Chat 看到等待列表 → 点击接入
双方实时聊天、管理员可看到"访客正在输入..."
关闭会话、访客离线自动发邮件通知
支持管理员主动发起聊天（Proactive Chat）

14.3 WhatsApp

多代理：Sophie Han（Sales Manager）、Export Sales（MOQ & Pricing）
点击代理 → 跳转 WhatsApp（带预填消息）
GDPR 同意复选框
手机/桌面自适应显示
点击追踪记录

十五、支付系统

15.1 支付方式

方式	说明
PayPal	标准 PayPal 支付（支持 PayPal 余额、银行卡）
Credit/Debit Card	通过 PayPal 的信用卡支付（无需 PayPal 账号）
Bank Transfer	银行转账（显示银行信息，管理员手动确认）

15.2 支付流程

买家接受报价 → 页面展示 Payment Method Selector

选择支付方式 → 点击 Pay

PayPal：跳转 PayPal → 登录 → 确认付款 → 返回网站

Bank Transfer：显示银行信息 → 买家线下转账 → 管理员确认到账

付款成功 → 系统自动创建 Order → 更新相关实体状态

15.3 双重保障

同步回调：PayPal 付款后立即重定向到 /api/v1/paypal/capture，实时捕获
异步 Webhook：PayPal 同时发送 Webhook 通知，防止回调丢失
幂等保护：CAS 原子更新防止重复创建订单

十六、SEO 与多语言

16.1 SEO 配置

每个产品/博客/页面独立设置 Meta Title、Meta Description、Keywords
全局默认 SEO 值：Settings → Site → SEO Defaults
自动生成 sitemap.xml（含产品、博客、自定义页面）
自动生成 robots.txt
JSON-LD 结构化数据（Product Schema、Organization Schema、Breadcrumb Schema）
hreflang 标签（告诉搜索引擎多语言版本关系）
Google Analytics + UTM 追踪

16.2 多语言

5 种语言：EN / ES / FR / AR / PT
URL 前缀路由：/en /es /fr /ar /pt
管理员编辑内容时切换 locale tab
未翻译内容自动 fallback 到英文
阿拉伯语（AR）自动 RTL 布局
Cookie 记住语言选择（NEXT_LOCALE）

十七、常见操作流程

17.1 完整询价→订单流程

买家浏览产品 → Add to Inquiry → 提交询价篮

管理员：Inquiries → 查看详情 → 分配跟进人

管理员：Create Quote → 填写价格/运费/条款 → Send 给买家

买家：邮件收到 Quote 链接 → 查看 → Accept

买家：选择支付方式 → 完成付款

系统：自动创建 Order（confirmed）

管理员：Orders → 更新状态（in_production → shipped + 物流单号）

买家：买家后台实时查看订单进度

17.2 样品订单流程

买家：产品详情页 → Request Sample → 填写收货信息 → 提交

管理员：Content → Samples → 审核 → 设置价格和运费 → Send Payment

买家：邮件收到付款链接 → PayPal 付款

系统：自动更新为 paid → 管理员填写物流单号 → shipped

17.3 审批新买家

Buyers → 筛选 pending

查看买家信息 → Update Status → active

可选：设置 Price Group

17.4 添加新产品

Products → Create

Basic Info：Category / SKU / Slug / Cover Image / MOQ / Delivery Time / Price Range

EN Tab：Title / Description / Short Desc / Specs / Certifications / SEO

其他语言 Tab：同上

Has Variants：添加 Option → Generate Variants → 设价格/阶梯价/图片

Status → published → Save

17.5 修改首页

Content → Homepage

编辑各区块（Banner / Categories / Featured / Industries / CTA 等）

保存 → 缓存自动清除 → 前端即时生效

17.6 发送营销邮件

Marketing → Campaigns → Create

Step 1：选择模板 / Step 2：编辑内容 / Step 3：选择收件人 / Step 4：预览发送

发送后查看统计

十八、常见问题

Q: 登录后台提示 "Invalid credentials"？

A: 检查用户名密码是否正确。默认 admin / Admin123!。如果忘记密码，需要直接修改数据库 admin_users 表的 password_hash 字段。

Q: 产品发布后前端看不到？

A: 确认 Status 为 published。发布后 Redis 缓存自动清除，可能需要等待几秒。如果还看不到，检查产品是否关联了分类、是否有英文翻译。

Q: 买家注册后无法登录？

A: 新买家默认 pending 状态，需要管理员在 Buyers 审批为 active 后才能登录。Google OAuth 注册的买家自动 active。

Q: 询价提交后没有收到邮件通知？

A: 检查 Settings → Notification Channels → Email 是否开启。检查 SMTP 配置是否正确。检查 Redis 是否运行（邮件队列依赖 Redis）。

Q: 报价发送后买家点链接打不开？

A: Quote Token 链接格式为 https://cnprosafe.com/en/quote/{uuid}，确认 Nginx 代理正确。如果 Nginx 把 /en/ 路由到了前端就没问题。

Q: PayPal 支付后订单没自动创建？

A: 检查 PayPal Webhook 是否配置、capture 端点是否可达。查看服务器日志确认 capture 回调是否成功。管理员可手动在 AdminPaypalController 确认银行转账。

Q: 图片上传失败？

A: 确认 OSS 配置正确（endpoint / access-key / bucket）。确认 file.upload.use-oss: true。检查 OSS bucket 权限（公共读）。

Q: 如何备份数据？

A: 宝塔 → 数据库 → 备份 MySQL。Redis 数据可持久化（RDB/AOF）。上传文件在 OSS 上不会丢失。

Q: 如何添加新语言？

A: 前端 next.config.ts 的 i18n locales 列表添加新语言代码 → 管理后台各内容模块会出现新的 locale tab → 填写翻译内容。阿拉伯语会自动 RTL。

Q: AI 搜索不准确？

A: Settings → Embeddings → Rebuild Index 重建所有产品和 FAQ 的向量嵌入索引。

CNProSafe B2B PPE Platform v2.0 · 完整使用手册 · 2026-07