一、项目背景

陶瓷卫浴行业产品具有SKU 繁多、陶瓷件易碎、釉面缺陷多、批次追溯难、残次品单独管控等行业特性。传统 Excel 手工台账、通用进销存软件无法区分优等品 / 合格品 / 残次品，难以记录烧裂、针孔、磕碰等质检缺陷，批次追溯、破损退货管理困难。

本 Ceramic Sanitary Ware 管理系统，面向卫浴生产企业与经销商家，整合采购、库存、销售、质检、客户、供应商、数据报表一体化业务流程，实现卫浴产品全生命周期数字化管理，解决陶瓷卫浴行业库存混乱、质检记录零散、业务数据不可追溯等痛点。

二、系统概述

1. 业务定位：陶瓷卫浴产销仓储一体化管理平台，管理马桶、陶瓷台盆、浴室柜、花洒、卫浴五金等产品。

2. 技术架构：后端 SpringBoot（Java）+ MySQL8.0 + Redis；前端 Vue；可部署于 Windows Server / Linux（CentOS7、Ubuntu20.04），支持内网单机部署、局域网多终端访问。

3. 用户角色：系统管理员、仓库管理员、销售人员、质检人员、财务人员。

4. 核心目标：产品档案管理、批次管理、成品质检、多仓库存管控、采购销售业务流转、不良品台账、数据统计追溯。

三、系统功能模块详情

3.1 基础资料管理

1. 产品档案：品类、型号、颜色、规格、材质、包装尺寸、毛净重、陶瓷生产批次、产品图片；产品等级标记：优等品 / 合格品 / 残次品。

2. 供应商档案：供应商名称、联系人、电话、供货品类、结算账期、备注。

3. 客户档案：经销商 / 零售客户信息、客户等级、分级价格体系、客户欠款记录。

4. 仓库与库位管理：多仓库（原料仓、成品仓、次品隔离仓）自定义新增；库位编码维护。

3.2 采购管理

· 采购订单新增、编辑、审核、单据打印

· 采购到货单录入，绑定生产批次

· 采购入库流程，入库前联动质检

· 不合格品自动划入次品仓

· 采购台账、采购对账、历史单据查询

3.3 库存管理（卫浴行业核心模块）

· 常规业务：入库、出库、仓库调拨、盘点单

· 批次管理：陶瓷产品绑定生产批次，实现产品溯源

· 库存预警：设置安全库存，低于阈值自动提醒补货

· 次品专项管理：磕碰、裂釉不良品登记；次品出库、返修、报废流程

· 库存台账，全产品出入库流水查询

3.4 销售管理

· 销售订单录入、审核、发货单生成、销售出库

· 分级价格策略：批发价、零售价，支持单品临时调价

· 客户应收欠款登记、欠款台账查询

· 销售退货管理，破损退货单独标记区分

3.5 质检管理（陶瓷行业特有模块）

· 来料质检、成品出厂质检、出库复检

· 缺陷登记：烧裂、针孔、变形、色差、釉面划痕、磕碰

· 质检结果判定：合格 / 不合格 / 待返修

· 质检电子报告生成，支持导出 PDF/Excel

3.6 数据报表模块

库存汇总报表、采购统计报表、销售统计报表、次品不良统计报表、客户销售排行报表；全部报表支持 Excel 导出。

3.7 系统权限与日志管理

· 账号新增、停用、重置密码

· 角色权限分配，数据权限隔离

· 完整操作日志：记录入库、修改订单、单据删除等操作，便于审计追溯

四、角色权限矩阵

表格

五、系统优点与缺点

✅ 优点

1. 深度适配陶瓷卫浴行业，原生支持批次管理、次品隔离、陶瓷专项质检，区别于普通通用进销存软件。

2. 支持多仓库、海量 SKU，适配马桶、台盆、浴室柜、五金配件混合管理场景。

3. 库存预警功能，减少断货或库存积压；全链路操作日志，业务可追溯，方便对账与责任核查。

4. 报表一键导出，满足财务运营统计需求；多角色分权管控，仓库人员无法随意修改销售价格。

5. 支持本地服务器内网部署，业务数据保存在企业本地服务器，不强制依赖公网。

❌ 缺点

1. 行业定制化程度高，通用性弱，若业务更换为其他品类（家具、建材等）需要大量二次开发。

2. 质检模块仅支持人工录入缺陷，不集成 AI 视觉识别，无法自动识别釉面裂纹，不能替代线下实物质检。

3. 本地私有化部署模式，需要安排人员维护服务器；服务器宕机将直接导致系统不可用。

4. 移动端功能轻量化，盘点、复杂单据操作建议电脑端操作。

5. 产品图片上传会持续占用服务器磁盘，长期使用需要定期清理冗余图片。

六、标准业务使用流程

1. 管理员登录系统 → 维护基础档案（产品、供应商、客户、仓库）

2. 采购人员创建采购订单，到货后推送质检

3. 质检人员现场检验，录入缺陷，判定合格 / 不良

4. 合格产品入库成品仓；不良品转入次品隔离仓

5. 销售创建客户订单，审核后推送仓库发货出库

6. 定期执行库存盘点，生成盘点报表

7. 财务导出采购、销售、应收、次品统计报表对账

七、保姆级部署教程

7.1 硬件 & 软件环境要求

最低配置：CPU 4 核，内存 8G，硬盘 ≥100G（预留图片存储） 推荐配置：CPU 8 核，内存 16G，SSD 硬盘 操作系统：Windows Server 2016+/ CentOS7 / Ubuntu20.04 必备软件：JDK1.8 / JDK11、MySQL8.0、Redis、Nginx 端口开放：80（前端）、8080（后端接口）、3306（数据库）

部署前置准备

1. 服务器关闭不必要端口，按需放行访问 IP；内网部署可关闭数据库远程访问提升安全。

2. 准备部署包：后端 war 包 ceramic-sanitary.war、数据库脚本ceramic_sanitary.sql、前端 dist 打包文件。

3. 提前规划数据库名称：ceramic_sanitary，记录数据库账号密码。

7.2 Linux 部署步骤（CentOS 示例）

步骤 1：安装 JDK

yum install java-1.8.0-openjdk-devel -y

java -version

输出版本号即安装成功。Windows 系统直接下载 JDK 安装包，配置 JAVA_HOME 环境变量。

步骤 2：安装 MySQL8.0，初始化数据库

1. 安装 MySQL 并设置 root 密码，根据安全需求开启 / 关闭远程访问。

2. 创建业务数据库

CREATE DATABASE ceramic_sanitary DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

1. 导入数据库脚本

mysql -uroot -p ceramic_sanitary < ceramic_sanitary.sql

⚠️必须使用 utf8mb4 编码，防止中文、备注乱码。

步骤 3：安装并启动 Redis

yum install redis -y

systemctl start redis

systemctl enable redis

步骤 4：修改后端配置文件 application.yml

spring:

 datasource:

   url: jdbc:mysql://127.0.0.1:3306/ceramic_sanitary?useUnicode=true&characterEncoding=utf8mb4

   username: root

   password: 【填写你的MySQL密码】

 redis:

   host: 127.0.0.1

   port: 6379

步骤 5：启动后端服务

java -jar ceramic-sanitary.war &

访问接口测试地址：http://服务器IP:8080，确认接口正常。

步骤 6：部署前端 Vue 打包文件 dist

1. 安装 Nginx，将 dist 文件夹放置 nginx html 目录。

2. 修改 nginx 配置，反向代理后端接口

server {

   listen 80;

   server_name localhost;

   root html/dist;

   index index.html;

   location /api {

       proxy_pass http://127.0.0.1:8080;

   }

}

1. 重启 Nginx 服务

systemctl restart nginx

步骤 7：初始化账号，登录系统

· 默认管理员账号：admin，默认密码：123456

⚠️首次登录必须修改默认密码 浏览器访问：http://服务器IP，登录后录入基础数据进行业务测试。

7.3 Windows 部署简要说明

1. Windows 下安装 JDK、MySQL8.0、Redis、Nginx，配置环境变量。

2. 使用 Navicat 执行 SQL 脚本创建数据库。

3. 修改 application.yml 配置文件。

4. cmd 执行java -jar ceramic-sanitary.war启动后端。

5. Nginx 部署 dist 前端包，配置反向代理，访问系统。

八、运维方案

1. 数据库自动备份：配置定时任务每日凌晨自动导出 MySQL 备份文件，异地留存备份。

2. 磁盘维护：定期清理无效产品图片、过期单据附件，释放服务器硬盘空间。

3. 日志巡检：定期查看服务日志，捕获异常报错。

4. 账号安全：定期清理闲置账号，强制用户定期修改密码。

5. 版本更新：升级系统前，完整备份数据库与部署文件。

九、故障排查清单

表格