Wujies 无界平台
应用

报价管理(quote)

报价单与价格库怎么维护、公开询价页与 cms 主题壳的关系,以及收不到询价时查哪。

应用编码 quote,本页对应应用版本 1.0.3(引擎要求 >=5.6.2 <6.0.0),许可 MIT,仓库 wujies-quote-plugin。

报价管两摊:报价单(明细行加价、税率、运费、优惠,状态在 draft → sent → accepted / cancelled 之间流转)和价格库(可从 Excel 批量导入的产品台账,每行持拿货价)。对外有一屏公开询价页 /site/quote,读价格库的上架切片,匿名提交进来落成草稿报价单。依赖 im 标了 optional,它只影响那一页上的「进入在线询价工作台」一条链,不装别的都照常。

与商城没有代码耦合:本应用只声明 im(可选),价格库与商城商品是两张各管各的台账,导入导出都只认 quote_price。

适用场景是访客留需求、业务员在后台改价出单。要让公开页带价直接下单,现状不支持,也没有开关能打开。

装它

没有必装依赖,任何部署都能直接装。MIT 许可,不走购买与激活(各授权档位的差异见 授权档位)。装成功后侧栏多一个「报价管理」,下面一项:

菜单路由需要的权限码
报价单系统indexquote:order:list

页面里是两个页签(报价单、价格库),所以按钮码分两组:quote:order:query / add / edit / remove / export / status / generateNo,和 quote:price:list / query / add / edit / remove / export / import。页签本身没有独立开关,想让人看不到价格库页签,收掉整组 quote:price:* 即可。

前台与会员端另有三条边界要在装的时候心里有数:

  1. /site/quote 由 内容中心 的主题壳直出。没装 cms 时这条路径返回 404 且响应体为空,宿主日志留一行「前台页要渲染但没有主题壳」的 WARN,后台两页签照常。
  2. 自带样式 /site/apps/quote/quote.css 由本插件自己的资源端点发出。插件各自类加载器,主题那侧读不到本插件 jar 里的文件,谁的文件谁发;这条链在这台部署热加载过一次 quote 才生效(见「出问题查什么」)。
  3. C 端那个 /quote 询价页在会员端站点 wujies-web 里,不在本仓库;本应用为它提供 /portal/quote/** 接口。

配它

没有全局配置:客户、供应商、税率、运费、优惠、付款 / 质保 / 交货条款、品牌名,全部逐单在页面里填。要提前定口径的是下面几处。

加价模型。报价明细的售价由该行的拿货价推出来,加价方式三选一:百分比、固定额、直接手填,支持一次应用到全部行。报价单的合计按成本、明细额、加价额、税费分列存储,税率运费优惠逐单填。价格库本身只存拿货价,加价只发生在报价单这一层。

公开页展示什么。/site/quote 列价格库里状态为上架的行,每页 20 条,搜索命中分类、产品名称、型号、规格、价格类型五列。这一屏刻意不印任何价格:表里存的那列是拿货价,直出模板不渲染它,也没有开关能打开。对外报价走表单,改价出正式单在后台与会员端。判断「要不要让访客看到价」时,现状是看不到,要看到就得改模板重构建。价格库某一行下架或删除,公开页同步消失;这屏的商品集合完全跟着价格库的状态列走。

SEO 的口径也写死在直出代码里:规范地址固定 /site/quote,带搜索词、翻页或表单回跳参数的屏加 noindex,搜索引擎不会替你把筛选页收录出去。筛选、搜索、分页、已选行和回执全部走 query 不走路径段,加第二个条件时切片页还拼得出来。这一屏没有详情页:一条记录的型号与参数已在列表里摆完,另开一屏只是给导入数据多出几百个抓取入口。

QuoteSiteLinks 里两个地址的写法各有来由。APPLY_API_URL 挂本应用自己的 /site 前缀,表单 POST 走同源、匿名可达,不需要会员端的登录态与 clientid。APPLY_URL 是会员端 SPA 的在线询价那一屏(建单后逐行改加价、算总价),只给相对路径 /quote:本站与会员端同域、按路径前缀区分,写死域名会把本地、测试、线上三种部署写成两种。

匿名收单口径。「我要询价」表单同源 POST 到 /site/quote/apply,成功 302 回列表带 done=报价单号(格式 BJ + 八位日期 + 六位随机数,表上的唯一索引兜底),失败回带 err=(items / quantity / fields / save 四个码之一)。硬口径:每单最多 20 行明细,数量 0.01 到 999999,文本列各有长度上限,电话要匹配 ^\+?[0-9][0-9 -]{5,19}$,另有一个名为 website 的蜜罐字段,机器人填了它就被当作没提交静默处理。进来的单落为草稿,备注自动带「前台询价页提交」前缀,管理员在报价单页签里筛。这一屏没有验证码也没有限流可用(宿主那两道都不为 /site/** 开门),真被刷到收不住时,代码留的出口是把表单指向会员端那条需要登录的询价链,匿名口子随之关闭,改法在 QuoteSiteLinks 一个常量。

提交之后这一屏不再露出任何客户数据:直出页对报价单与明细只写不读,访客刷新页面看不到自己刚提交的单,也看不到别人的;跟进全部回后台。

在线询价工作台(可选的 im)。公开页上那条链要求登录,做的事是按单反查会员、必要时发起好友申请、确保一对一会话(两边都查),会话为空时补一句默认开场话术(「您好,我是从在线询价页过来的,想咨询报价单的事。」),然后把人带到会员中心的消息页。超级管理员账号点它会直接被拒(「当前登录的就是超级管理员…」),这条链是给实际接待的业务账号用的。不装 im,点它得到「应用「即时通讯」未安装或未启用…」,报价自己的页面与数据不受影响。见 即时通讯。

用它

管理员在「报价单系统」两个页签里干活。价格库页签:下载导入模板、Excel 批量导入(导入痕迹记录源文件名、工作表、行号,便于回对),单个产品也可手工加行、手工改拿货价。

报价单页签:从价格库选行或手工加行,逐行选加价方式(百分比 / 固定额 / 直接填售价)并可一次应用到全部行,再填税率、运费、优惠;状态按已发送、成交、作废推进,两页签都支持导出。

会员在 C 端 /quote 页(wujies-web 的报价页,不在本仓库)发起在线询价,可调 /portal/quote/price/list 看上架产品、提交自己的询价,落库同样是草稿报价单;改价与出正式报价单回后台做。

访客能看 /site/quote 并提交询价表单;看不到别人提交的单,也看不到拿货价。

出问题查什么

现象先看什么
/site/quote 返回 404、白页是否装了 cms;没主题壳时这一屏按设计就是 404 空响应体,看宿主日志的 WARN
装了 cms 仍然 404主题壳取自内容中心的装载状态,确认 cms 处于已加载而不只是已安装(热加载与重启的差别见 在部署里使用应用)
页面样式全无、/site/apps/quote/quote.css 取到的是 JSON 错误体资源端点要热加载一次 quote 才注册(光构建只更新资源);判路由是否命中要看 content-type,未命中的 /site/** 回的是 JSON 不是 404 页
提交询价没反应也没报错蜜罐字段 website 被填会按未提交处理;地址栏带回 err= 时按四个码对号:行数、数量、字段长度 / 电话格式、保存失败
想在公开页看到谁提交过哪些询价这一屏按「只写不读」设计:报价单上的客户数据从不出现在直出页里,管理员回后台报价单页签查
点「进入在线询价工作台」报应用未安装或未启用im 未装或未启用,这条链是 quote 唯一用到 im 的地方
工作台提示当前登录的就是超级管理员换实际负责接待的业务账号登录再点,会话与消息落在那个账号上
会员端提交询价报「询价产品不存在或已下架」价格库对应行被下架或删除;公开页列表同步只剩上架行
导入 Excel 失败或串列用「下载模板」出的表头填;导入结果里有源行号,按行号回对原表
公开页搜索搜不到某个产品搜索只命中分类、产品名称、型号、规格、价格类型五列,写在这五列之外的文案匹配不到
报价单合计与预期差一笔合计按成本、明细、加价、税费分列落库;先对回该行的拿货价、加价值与税率,本应用没有默认税率可继承
后台两个页签整个起不来后端 jar(backend/wujies-quote-plugin-1.0.3.jar)是否随包装载;装载操作见 在部署里使用应用
新建报价想先看单号规则页面新增时调 GET /quote/generateQuoteNo(需要 quote:order:generateNo 按钮码),单号唯一性由表上的唯一索引兜底

实现索引

项值
数据表quote_order、quote_item、quote_price
后台接口前缀/quote(报价单:列表、导出、单号生成、状态流转)、/quote/price(价格库:导入导出与增删改)
会员端/portal/quote/**(上架产品浏览与提交询价,需登录)
公开端GET /site/quote(直出列表页)、POST /site/quote/apply(匿名提交)、GET /site/quote/workbench(工作台转接,需登录)
自带静态资源/site/apps/quote/**,由 QuoteSiteAssetController 发出(扩展名白名单,缓存 5 分钟)
随包产物后台前端 frontend/index.js 与后端 backend/wujies-quote-plugin-1.0.3.jar(清单 assets 声明)
前台模板site-templates/quote-list.html(仓库里唯一的直出模板);样式 .apply 那一族只被这一屏使用
卡片脱敏层QuoteSiteCard 是公开页唯一的取数出口:拿货价 costPrice、导入溯源(sourceName / sourceSheet / sourceRow)、status(已由查询筛过)、remark 与审计字段都不进这一层,字段名连 toString 里也不出现。字段清单以 C 端 wujies-web/src/views/quote/index.vue 实际印出的那几项为准(价格那一格写「报价确认后发送」)。这一层用 JavaBean 而不用 record:模板表达式按 getter 取值,record 的访问器读不出来
迁移脚本migrations/01-create-quote-tables.sql
源码cn/wujies/quote

那三张表同时也是卸载时的删除依据:AppPurgeService 从迁移脚本里解析 CREATE TABLE 得到「本应用声明的表」,迁移脚本一经执行内容不可改(摘要记账规则见 数据库迁移)。

联机状态:/portal/quote/price/list 带 token 与裸请求都调过(200 与 401);/site/quote 直出整屏、quote.css 资源端点(要热加载一次才注册)与 im 工作台那条链,都没在这台部署上走通过(未联机验证)。

目录