科王溯源云使用指南

科王溯源云是由博兴县科王网络服务工作室研发的一套面向生产制造、厨具商贸等企业的“进销存＋一物一码溯源报修”一体化管理系统。

系统定位

系统以“让每一件产品都能被追溯、每一次报修都有迹可循”为核心目标，把企业日常的采购、销售、库存管理与产品溯源、客户扫码报修结合起来，帮助企业在降本增效的同时提升产品信誉与售后服务水平。

系统采用 PHP＋MySQL 多租户服务器架构，一套系统、一个数据库即可同时承载多家工厂入驻使用。各工厂的数据在数据库层面按企业专属标识严格隔离，互不可见、互不串通，既保证多厂共用的集约成本，又守住各企业独立数据的私密性。

核心功能一览

进销存主线：企业经营看板、基础档案（商品/供应商/客户）、采购入库、销售出库、库存与补货预警、库存盘点、仓库调拨、退货、往来欠款、账目报销与各类统计报表；一物一码主线：SN 码生成、标签打印、客户扫码溯源、电子保修卡、一键分享、在线报修与维修派单。

管理端：平台管理员负责工厂入驻审核、企业代码分配、试用与正式版开通、续费与到期管理，并通过“安全体检”做整站安全体检与企业数据隔离体检；工厂账号负责本厂业务与系统设置。每厂最多三个账号，注册须经平台审核。

多租户架构

科王溯源云采用多租户服务器版设计：一套系统一个数据库可容纳多家工厂。各厂业务数据统一存放在 kv_store 表，以 factory_id（企业 ID）+ data_key（数据名）作为唯一键；同时 factorys、users、sn_index 等表也都带有 factory_id 归属字段。

工厂注册、登录、业务读写全部以“当前登录企业的 factory_id”为边界：读取数据时按本厂 ID 强制过滤，所以任何一家工厂都无法看到或操作其他工厂的数据，真正做到“一套系统、多家共用、各管各账”。

企业代码与 SN 防串号

平台可为每家审核通过的企业分配一个企业代码（格式为 1 个字母＋3 位数字，如 A001，一次性分配、永久有效）。该代码会被嵌入到企业生成的 SN 码中，从编码源头杜绝多厂串号；建议各企业在平台分配后避免留空，便于后续识别与对账。

每件出厂产品还会获得一个全局唯一的 SN 码，由“企业代码＋年月日＋排序号”组成（如 A00120261108000001）。客户扫码时，系统依据 SN 码自动定位到对应产品及其所属工厂，展示完整追溯链路。

企业数据隔离体检（平台自检）

为了让你“看得见”隔离是否正常，平台端的「安全体检」页面内置了一张企业数据隔离体检看板：它按企业逐家统计业务数据行数、账号数、SN 码数，并自动检查三类风险——是否存在属于“不存在的企业 ID”的孤儿数据、平台层（ID=0）是否混入了企业业务数据、SN 码是否出现跨厂重复。全部正常时显示“隔离机制健康”，出现异常会红字列明，便于第一时间排查。

系统按岗位划分权限，各角色只能看到与自己工作相关的菜单和数据。同一家工厂最多可开 3 个账号。

环境要求

部署步骤

1. 把程序包解压后，将全部文件上传到网站根目录（wwwroot）。
2. 修改 db_config.php，填写你的数据库主机、库名、用户名、密码（默认已预填一套，请按实际改）。
3. 用 phpMyAdmin 或命令行导入建库脚本，创建 4 张核心表：factorys、kv_store、sn_index、users。
4. 浏览器访问站点首页，首次会自动初始化表结构与平台账号；平台初始口令会一次性写入 backups/initial_platform.txt。
5. 用初始口令登录平台后台，立即修改密码，然后删除该初始口令文件。
6. 确认根目录 .htaccess（Apache）或 web.config（IIS）已生效，禁止下载备份/数据文件、禁止目录浏览。
7. 登录后在「安全体检」页面逐项核对，全部显示“通过”即为部署安全达标。

平台管理员是系统的“总管家”，负责企业入驻、套餐开通、到期管理以及整站安全。以下为主要模块。

企业入驻审核与企业代码

工厂自助注册后进入“待审核”状态，平台在后台审核营业执照等资料、决定是否通过。通过后为每家分配唯一企业代码（1 字母＋3 位数字，如 A001），用于嵌入 SN 码防串号。审核不通过的企业无法登录业务后台。

试用 / 正式版开通与续费到期

平台可为每家工厂设置试用期或正式版有效期。系统会在正式版到期前 10 天给企业后台推送续费提醒横幅；到期后账号会被平台禁用，续费后恢复。平台也可临时“暂停服务”（service_pause），暂停期间企业后台显示提示横幅。

安全体检（整站安全自检）

「安全体检」是平台专属的整站体检页，逐项检查并给出处理建议，包括：安装脚本 install.php 是否已落锁、backups 目录是否防下载、uploads 目录是否禁脚本执行、数据库配置文件权限、平台初始口令文件是否已清理、是否启用 HTTPS、会话安全（严格模式/仅Cookie/HttpOnly）、PHP 运行环境扩展、phpinfo 调试页是否残留、近 24 小时全站登录失败统计等。每一项都标注“通过 / 高危 / 中危 / 建议”并用颜色区分。

企业数据隔离体检

同页内置的隔离体检看板，按企业统计业务数据量、账号数、SN 码数，并自动检查孤儿数据、平台层串号、SN 跨厂重复三类风险。正常时显示绿色“隔离机制健康”，异常时红字列明。这是平台确认“各厂数据互不串通”的直观依据。

IP 登录封锁与登录审计

系统对同一 IP 连续登录失败 5 次自动锁定 10 分钟。平台还可在安全体检页手动封锁任意恶意 IP（1 小时～30 天），并在“登录审计”里查看全站每次登录的时间、结果、账号、IP、设备，快速定位异常登录。

登录页设置 / 站内公告 / 套餐配置

平台可配置网站标题、版本号、登录页轮播图与公告、客服电话、平台广告位文案，以及各套餐档位的功能权限与价格展示，统一对外形象。

企业账号登录后，左侧菜单按“企业经营状况 → 进货管理 → 销售管理 → 库存与账务 → 溯源与报修（专业版）→ 系统”分组。以下按分组说明。

① 企业经营看板（登录首屏）

这是企业登录后的首页，也是日常经营的“驾驶舱”。页面顶部汇总今日销售金额、今日出库单数、今日出库数量、今日进货金额四个关键指标；下方列出库存补货预警（库存低于预警阈值的商品及建议补货量）和待办工单（待指派/维修中的报修单）。遇到正式版临期，这里还会叠加一条醒目续费横幅。

② 进货管理

产品入库（buy.php）：录入供应商、进货商品与数量单价，提交后自动增加库存；入库记录（buy_list.php）可按日期/供应商查询历史入库；退供货商（return_buy.php）处理进货退货并冲减库存；进货统计（statistics_buy.php）按时间段汇总进货金额与数量。

③ 销售管理

产品销售（sell.php）：选择客户、商品、数量单价出货，可关联 SN 码完成“一物一码”出厂登记；销售记录（sell_list.php）查询历史销售；客户退货（return_sell.php）／退货记录（return_list.php）处理客户退货与记录；销售统计（statistics_sell.php）按时间段汇总销售业绩。

④ 库存与账务

库存管理（stock.php）：查看各商品实时库存、设置预警下限；库存低于阈值时，首页与扫码页会自动提示补货。仓库管理（warehouse.php）维护多仓库；仓库调拨（transfer.php）做仓库间转移。

基础档案（base_data.php）：统一维护商品、供应商、客户三类主数据，是进销存全流程的起点。删除前系统会提示该档案被多少单据引用，避免误删导致历史单据失去关联。

库存盘点（stocktake.php）：按仓库录入实盘数量，系统自动计算账面数与实盘数的盈亏差异，并据实调整库存、留存盘点历史，方便月度/年度盘点对账。

账目报销（account.php）记录费用收支；应收应付对账（debt.php）汇总客户欠款、供应商应付款，便于催收与付款安排；数据大屏（dashboard.php）把关键经营数据做成可视化大屏，适合投屏展示。

⑤ 溯源与报修（专业版）

一物一码溯源（trace.php）：为产品生成唯一 SN 码、打印标签，管理产品的追溯档案（型号、生产批次、出厂信息、客户信息、保修期限等）。生产环节溯源（prod_trace.php）记录从原料到成品的生产工序节点。

报修工单管理（repair_manage.php）：集中处理客户扫码提交的报修，指派维修师傅、跟踪处理进度、回填维修结果。维修师傅管理（tech_manage.php）维护可派单的师傅名单。溯源维修统计（statistics_trace.php）与货物地区分布（statistics_region.php）给出售后与流向的统计分析。

⑥ 系统与审计

个人中心（profile.php）：自助修改本人密码、绑定手机号、查看本人最近登录记录（改密后旧会话立即失效）。

系统设置（system.php）：维护企业标题、出厂手机号/口令、库存预警阈值、保修期限、打印设置、扫码页品牌头图、登录二次验证（密保问题）等。

操作日志（oplog.php）：记录本厂每一次关键操作。支持按日期范围、操作人、操作类型筛选，并可一键导出 CSV（Excel 可直接打开），便于对账与审计留痕。

数据备份（export.php）：一键导出本厂业务数据备份；版本与续费（plan.php）查看当前套餐、剩余天数并发起续费。

客户无需安装任何软件，用手机扫产品上的 SN 二维码即可进入溯源页。这是系统对外最直观的一环。

扫码溯源页展示什么

打开扫码页（scan.php），客户可看到：产品大图 / 品牌宣传图（点击可全屏查看）、产品名称与型号、企业信息、出厂日期、追溯链路、保修信息等。页面按 SN 码自动定位到对应产品与所属企业，绝不会串到别家。

电子保修卡

溯源页提供「电子保修卡」按钮，一键生成含厂家、产品、型号、SN、保修卡号、保修期限、出厂信息、客户与电话的保修卡页面，可直接打印或另存，替代传统纸质保修卡。

一键分享

「分享」按钮优先调用手机系统分享，把“产品名＋SN＋溯源链接”一键发给客户或微信好友；不支持系统分享的环境则自动复制链接，方便转发。

在线报修

客户在溯源页可点「在线报修」：填写故障描述、联系电话，并可上传现场照片（最多 6 张，单张≤3MB，系统只接受真实图片）。提交后生成报修工单，进入企业后台“报修工单管理”，企业指派师傅处理，全程留痕。

密码小眼睛（默认星号）

登录页、注册页的密码输入框右侧有一个“小眼睛”图标。密码默认以星号（••••）显示，点击小眼睛即可临时切换为明文核对，再点一下切回星号。这只是前端显示切换，不影响实际存储与校验。

验证码

登录前需输入图中 4 位数字验证码，用于阻挡自动化撞库与爬虫；看不清可点击图片刷新。

密保二次验证（企业可开）

企业管理员可在「系统设置」中开启密保二次验证：登录时除账号密码外，还需回答预设的密保问题。密保答案只存哈希、不回显，进一步防止密码泄露被盗登录。

登录失败锁定与日志

同一 IP 连续登录失败 5 次自动锁定 10 分钟，成功登录后清零。所有登录（成功/失败）都会记录时间、IP、设备与结果，企业可在「个人中心」看本人的记录，平台可在「安全体检 → 登录审计」看全站记录，并可手动封锁恶意 IP。

系统支持“先试用、后购买，按年续费”的模式，平台统一管理各企业的有效期。

试用期

工厂审核通过后通常先进入试用期，试用期内可体验全部或部分功能（以平台配置的套餐为准）。企业后台顶部实时显示试用剩余天数。

正式版与到期提醒

购买正式版后按有效期使用。系统会在正式版到期前 10 天在企业后台顶部显示黄色续费提醒（含到期日与客服电话）；到期当天后显示红色“已到期”横幅。

到期与续费

到期未续费的账号会被平台禁用，续费后恢复使用。续费请通过平台预留的客服电话或指定渠道办理；平台在「版本与续费（plan.php）」页面展示套餐与剩余天数，方便企业随时查看。

服务暂停

平台因特殊情况（如欠费、违规）可临时暂停某企业服务，暂停期间企业后台会显示“服务已暂停”提示，业务操作受限，待平台恢复后正常。

日常运维要点

定期查看「安全体检」确保各项“通过”；定期导出/整库备份业务数据；留意正式版到期时间，提前续费；为重要账号开启密保二次验证。

升级与定制

系统支持版本升级与按需功能定制。升级前请先备份数据库与程序文件；升级后登录「安全体检」核对，确认安装锁、目录防护等仍生效。

技术支持

部署、升级、报错排查或功能定制需求，请通过平台预留的服务电话或指定渠道联系科王溯源云技术支持。为便于快速定位，反馈问题时请尽量附上操作步骤、报错截图与发生时间。