ZhuaTech Warranty｜知华科技售后与质保管理系统

用统一权益与工单链路提升售后履约质量并控制质保成本

知华科技售后与质保管理系统产品概览

售后权益与索赔履约平台

系统用序列号串联权益、故障、维修、备件和费用，让每笔质保成本有据可查。

ZhuaTech Warranty 是知华科技（上海如静知华信息科技有限公司）维护的前后端分离企业应用社区源码版。产品、实施与技术服务信息请访问知华科技官网。

已实现业务域

代码	模块	可用能力

全部模块共享可用的台账新增、查询、草稿修改、删除、受控状态流、风险标记、责任人与期限管理，不是静态菜单占位。

核心闭环

服务端校验动作的前置状态，禁止越级流转；创建、修改、删除、审批、设置变更、附件与外部回执均写入审计日志。

领域规则引擎

购买日期、质保期、凭证、除外责任、误用与赔付上限判定。

接口：POST /api/enterprise/warranty/check-coverage
输入使用 Bean Validation 做必填、范围与格式校验
输出包含计算指标、阻断原因、预警和明确决策
相关的正常、异常和边界场景均有 MockMvc 集成测试

企业控制底座

组织与期间维度的控制事项、逾期和状态统计
幂等键防止网络重试产生重复单据
经办人与管理员职责分离，管理员接口单独授权
附件仅登记 SHA-256、大小、介质类型与存储键，办结前强制凭证齐备
JPA 乐观锁保护并发更新，外部适配器回执可追踪
生产 profile 会拒绝默认密码、空数据库密码和 localhost 跨域配置
健康检查、统一异常响应、输入校验与最近 100 条操作审计
组合检索、分页、SLA/逾期看板、责任人负荷与 UTF-8 CSV 导出
单据详情、协作备注和按业务编号聚合的完整操作时间线
流程动作标注 OPERATOR/ADMIN 所需角色，服务端强制校验审批权限
预留 CRM、ERP、WMS、服务商与客户门户的适配器边界，不包含任何真实密钥

详细控制项、接口和上线边界见企业版说明。

技术与目录

frontend/        Vue 3 + Vite 响应式业务工作台
backend/         Java 21 + Spring Boot 4 + Security + JPA
docs/            API、架构、企业能力和测试说明
compose.yaml     MySQL 8 + Backend + Nginx 一键编排

Java 工程包：cn.zhuatech.warranty。前端默认端口：8309。

启动与验收

cp .env.example .env
# 修改全部默认密码后启动
docker compose up --build

本地质量检查：

mvn -f backend/pom.xml test
npm ci --prefix frontend
npm run build --prefix frontend
docker compose config

演示账号仅用于本机体验：admin / admin123、operator / operator123。生产环境必须启用 prod profile，并通过环境变量传入独立强密码和受控跨域域名。

配套文档：API · 架构 · 测试 · 安全政策 · 贡献指南

质保索赔决策

新增维修、换货或赔付前的企业级决策门禁，统一核对质保权益、除外责任、反欺诈、购买凭证、序列号、诊断、估价、库存、客户确认与职责分离。详见企业质保索赔决策说明。

使用与商业授权

本工程仅允许个人非商业性的学习、研究和技术交流，不得商用。商用、SaaS、企业部署、二次销售、软件实施和深度定制须事先取得上海如静知华信息科技有限公司书面授权。

咨询中小企业信息化、AI 转型、OPC 技术支持、软件外包、FDE 外包及项目实施，请访问https://www.zhuatech.cn/或扫描微信二维码。

知华科技微信咨询二维码一知华科技微信咨询二维码二

SEO：质保管理系统、售后管理、Warranty、索赔管理、维修工单、知华科技、上海软件开发、企业信息化、软件项目外包。