<p> <a href="https://wujies.cn" target="_blank" rel="nofollow"> <img width="100" src="https://wujies.cn/brand/logo-stacked.svg" alt="Wujies 无界 logo"> </a> </p>
<p><b>报价管理</b>,报价单与价格库:客户报价单、明细加价、税率运费、价格库导入导出。</p> <p> <a rel="nofollow"><img alt="应用版本" src="https://img.shields.io/badge/app-1.0.4-111111?style=flat-square"></a> <a rel="nofollow"><img alt="应用编码" src="https://img.shields.io/badge/code-quote-0057FE?style=flat-square"></a> <a rel="nofollow"><img alt="License" src="https://img.shields.io/badge/license-MIT-green?style=flat-square"></a> <br> <a rel="nofollow">功能特性</a> <a rel="nofollow">预览</a> <a rel="nofollow">安装</a> <a rel="nofollow">设置</a> <a rel="nofollow">常见问题</a> <a href="https://docs.wujies.cn/docs/wujies/5.x/platform/plugin" rel="nofollow">插件开发</a> <a href="https://gitee.com/wujies" rel="nofollow">Gitee</a> </p>
Wujies 无界平台(wujies.cn)的报价应用,一个插件一个仓库:
- 后台:应用市场装上后多一个「报价管理」菜单,前端是远程应用(
frontend/,6 个文件), 管客户报价单、明细加价、税率运费与价格库导入导出。 - 前台:一个由 CMS 主题直出的公开页 ——
/site/quote(询价目录,读价格库那一本切片),POST /site/quote/apply站内接单建单、/site/quote/workbench工作台;模板与样式都在本仓库里 (见「公开页与自带样式」)。
应用编码 quote | 应用版本 1.0.4 | 后端构件 wujies-quote-plugin
✨ 功能特性
- 🧾 报价单 — 客户名称 / 联系人 / 电话、明细行、状态(草稿等)、税率、运费、优惠与备注,支持导出。
- 💰 三种加价方式 — 明细行按百分比加价、固定金额加价或直接手填销售价(成本价按
priceId回价格库取快照)。 - 📚 价格库 — 分类 / 产品 / 型号 / 规格 / 流量(m³/h 与 L/S 两种单位)/ 扬程 / 功率 / 价格类型 / 单位 / 状态。
- 📥 标准模板导入 —
importTemplate下模板、importData导入,只认标准列(见「价格库导入模板」)。 - 📤 导出 — 报价单与价格库各有一套导出(
quote:order:export/quote:price:export)。 - 🔢 单号生成 —
GET /quote/generateQuoteNo取号,报价单号由后端统一发(quote:order:generateNo)。 - 🌐 前台询价目录 —
/site/quote一屏 20 个产品,筛选 / 搜索 / 分页 / 已选行全走 query。 - 📝 匿名询价单 — 目录页就地提交,服务端校验后建单并 302 回目录(刷新不会重复建单)。
- 💬 在线询价工作台 —
/site/quote/workbench为访客建好友关系与会话,建完由页面跳会员中心 IM 页。 - 🔐 多租户 — 三张表都带
tenant_id,与平台其它应用同一套租户口径。
📸 预览
报价管理主界面

🚀 安装
环境要求
| 项 | 要求 |
|---|---|
| 平台版本 | >=5.6.2 <6.0.0(app.json 的 engine) |
| 后端构建 | JDK 17+(父 POM 的 java.version 为 17) |
| 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm |
| 前台公开页 | 要装 cms(内容中心)才有主题壳;没装时 /site/quote 回 404 空响应体 |
| 工作台(可选) | im 是 app.json 里标了 optional 的依赖,只影响「在线询价工作台」那一条链 |
| 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后由平台拉取 |
从应用市场安装
- 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
- 安装时自动执行
migrations/下的脚本(建表)。 - 装完刷新菜单,出现「报价管理」即成功。
- 要开前台询价页,把
cms一起装上;要用工作台再装im。
包里两个产物的路径由 app.json 的 assets 决定:
frontend → frontend/index.js | backend → backend/wujies-quote-plugin-1.0.4.jar。
从源码构建
在本仓库根打包(三条命令各管一段,都在本仓库根执行):
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev # ② 开发包:不签名,落 ..\.plugin-dist\quote\dev
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 # ③ 正式包:构建 + 用 keys\private.pem 签名关于上面三条命令的取值口径:
- 判据是「脚本所在仓库根有没有
app.json」,所以在本仓库里不要传-Plugin(它按子目录找清单, 会报「找不到插件目录」);-FrontendProject/-FrontendDist也不用传 —— 独立布局的前端工程固定就是 本仓库frontend/、产物frontend/dist,脚本自己跑npm run build(首次先cd frontend && npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加-SkipBuild。 -SkipFrontend只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有app.json,装上去没有界面。-CheckOnly打出的CHECK|级别|项|说明行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库keys/(private.pem+public.pem,已在.gitignore里),生成或更换用-Keygen(覆盖已有密钥要显式加-KeygenForce,旧钥先整份备份进keys\backup\<时间戳>\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。
手工构建:
mvn -B -o package -DskipTests # 后端(前提见「常见问题」)
cd frontend && npm install && npm run build # 前端,产物 dist/index.js + assets/quote-app.css最快的开发路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」,
找到 quote 这一行点「启动后端」(自动编译并加载 target/classes,同时开启监听)与「启动前端」
(常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR)。全流程见
文档站「插件开发」。
升级与卸载
- 升级:换
app.json的version后重新打包上传;已执行的迁移脚本不可改内容, 要改表结构一律加新编号脚本。 - 卸载:管理端「应用市场」里卸载,平台按
migrations/里CREATE TABLE的清单清理数据表 —— 本仓是三张:quote_order/quote_item/quote_price。
⚙️ 设置
- 后台没有独立配置页:报价单与价格库的参数就是各自列表页上的筛选项与表单字段,没有开关类配置。
- 价格库导入:模板列固定(见「价格库导入模板」),入口在「报价管理 → 报价单系统 → 价格库 → 导入」。
- 公开页样式由本插件自己在
/site/apps/quote/**发出(见「公开页与自带样式」), 主题那侧只拿一份 `` 清单,不在主题里改样式。
菜单入口
| 菜单 | 路径 | 组件键 | 权限前缀 |
|---|---|---|---|
| 报价单系统 | quote/index | remote:quote/quote/index | quote:order:* |
| (价格库,同一页) | — | — | quote:price:* |
价格库没有独立菜单:它的按钮权限(quote:price:list / query / add / edit / remove /
export / import)挂在「报价单系统」这行下面,与 app.json 的 F 行逐字对应。
报价单另有 quote:order:status(改状态)与 quote:order:generateNo(取号)。
前台公开页(匿名,/site/** 前缀):
| 路径 | 页面 |
|---|---|
| GET /site/quote | 询价目录(一屏 20 行,筛选 / 搜索 / 分页 / 已选行) |
| POST /site/quote/apply | 提交询价单,处理完 302 回目录 |
| POST /site/quote/workbench | 建好友关系与会话(需登录态,im 未装时返回失败原因) |
| GET /site/apps/quote/quote.css | 本屏自带样式(见下一节) |
🧩 依赖与插件支持
| 项 | 说明 |
|---|---|
| 依赖插件 | im(app.json 的 dependencies,optional: true):只影响工作台那一条链 |
| CMS 主题 | 公开页 /site/quote 由 CMS 渲染(QuoteSiteRender 通过 SDK 反查 SiteRenderApi);CMS 缺席时返回 404 + 空响应体并 WARN |
| 平台存储 | 不使用;本插件不落文件 |
| 前端依赖 | wujies-im-plugin 在本 pom 里是 provided(工作台要用 IM 的接口),构建顺序上 im 先装 |
| 公共 API | 前端走打进包内的 @wujies/api-client,运行时由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例 |
公开页与自带样式
site-templates/quote-list.html 由 CMS 主题渲染,site-styles/quote/quote.css(.apply 询价单那一族,
18 个类只有 quote-list.html 在渲染)是这一屏自己的样式,由本插件的 QuoteSiteAssetController
在 /site/apps/quote/** 发出,` 清单由 QuoteSiteRender 作为页面变量 appStyles` 交给主题 head。
为什么端点必须跟着插件走:插件各自的类加载器,本仓库的产物主题那侧读不到(模板能跨过去是因为
渲染时应用把加载器交了过来,静态资源是一次独立请求,没有那次交接)—— 谁的文件谁发。
样式里只准用主题的 CSS 变量,:root 那套令牌不在这里重抄一份。
口径见 wujies-cms-plugin README「写主题时必须守住的五条」第 5 条。
⚠️ 热加载前该端点还没生效:QuoteSiteAssetController 是新增类,本机宿主尚未热加载时,
curl http://127.0.0.1:8086/site/apps/quote/quote.css 回的是 application/json 的 404
(未命中的 /site/** 是 200 + JSON,判路由要看 content-type);热加载后才回 200 text/css。
因此主题 wujies-cms-plugin/themes/default/theme.css 里那一段 .apply 样式暂按「先加后删」留着没删。
新增这类直出端点必须热加载一次 quote 才生效,光 mvn -o compile 只更新资源、路由没注册。
资源端的口径:只发 site-styles/quote/ 下的相对路径,拒绝 .. 穿越,扩展名走白名单
(css / js / mjs / svg / png / jpg / jpeg / webp / gif / ico),不在白名单里一律 404;
Cache-Control 是 5 分钟短缓存(链接上没有真版本号,长缓存会把旧样式钉在浏览器里)。
价格库导入模板
报价单系统只导入标准模板,不再自动清洗供应商原始报价表:原始 .xls / .xlsx 由人工整理成
docs/quote_excel_template.md 里的列后,再走「报价管理 → 报价单系统 → 价格库 → 导入」。
- 必填两列:产品名称、拿货价(成本价,必须是数字且不小于 0,空值导入失败)。
- 常用可选列:ID(更新已有数据)、来源 / 来源工作表 / 来源行、分类、型号、规格、 流量 m³/h、流量 L/S、扬程 M、功率 KW、价格类型、单位(默认
台/套)、状态(0正常 /1停用)、备注。 - 同一产品有多种价格时拆成多行,用
价格类型区分(例如ISG等)。 - 「拿货价」是系统算加价报价的基础;明细支持百分比加价、固定金额加价、手工销售价三种。
询价单在前台提交的口径
匿名入口,所以规则都写死在服务端(QuoteSiteController),改之前先看这些上限:
- 一张询价单最多 20 行,单行数量
0.01 ~ 999999;行数与数量个数必须同序等长,不等整单退回。 - 客户名称 / 联系人 / 电话 / 备注按库表宽度截断(160 / 80 / 40 / 500),电话过形状校验 (
^\+?[0-9][0-9 \-]{5,19}$),只挡「随便敲一格」,不验真假。 - 隐藏域
website是蜜罐:填了就当机器人,直接 302 回目录、不建单。 - 成本价、加价、售价一个都不从表单接,服务端按
priceId回价格库取快照 —— 没有「访客填了个价」的单。 - 处理完一律 302 回目录,回执写在 query(
done单号 /err四个错误码闭集:items/quantity/fields/save);单号先过形状校验才印到页面上。 - 每次请求只查这一屏需要的 20 行,匿名查询自己钉分页条数(
PageQuery的缺省值是Integer.MAX_VALUE), 成本价两列都不回显。
开发环境
git clone git@gitee.com:wujies/wujies-quote-plugin.git
cd wujies-quote-plugin打包脚本:本仓库自带完整的 package.ps1(母本在 wujies-plugins 仓库根,各仓用
node scripts/sync-package-script.mjs 同步过来),clone 下来就能在本仓库根直接体检、构建、签名、出包、
生成密钥,不需要回到单体仓库,也不需要手工传产物路径。
前端 SDK:已迁到已发布的 @wujies/* SDK(ui-shared / components / api-client /
ui-plugin-bundler-kit)。frontend/vite.config.ts 只声明 defineRemoteApp({ appCode, root }),
共享依赖一律 external、运行期由宿主 import map 兜到同一份实例;宿主独有工具与业务模块
(@/utils/wujies、@/api/system/*、UserSelect/MemberSelect 等)按原样复制进了 frontend/src/,
proxy?.$modal / useDict / download 与 ImageUpload/UserDetail/Module*Settings 由宿主运行时提供。
本仓库前端可独立构建;要直接落位到宿主,构建前设
WUJIES_FRONTEND_DIST=/app-market-dist/remote-apps。
仓库布局
| 位置 | 内容 |
|---|---|
| pom.xml | Maven 模块(父 pom = cn.wujies.plugins:wujies-plugins-parent,` 已置空;wujies-im-plugin 是 provided`) |
| app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets) |
| src/ | Java 源码(39 个文件):controller / portal / site / fallback / domain / mapper / service |
| src/main/resources/mapper/quote/ | 三个 Mapper XML(报价单 / 明细 / 价格库) |
| migrations/ | 1 个建表脚本:01-create-quote-tables.sql(quote_order / quote_item / quote_price) |
| src/main/resources/site-templates/、site-styles/quote/ | 公开页直出的模板(只有 quote-list.html),和本屏自己的样式(见「公开页与自带样式」) |
| frontend/ | 远程应用源码(src/ 6 个文件),入口 frontend/src/index.ts |
| docs/ | screenshots/quote.png 预览图、quote_excel_template.md 导入模板说明 |
❓ 常见问题
Q:陌生人 clone 后 mvn package 报找不到 wujies-plugins-parent?
父 pom 与 wujies-common-* 目前只有本地 mvn install 出来的版本,还没发布到 Maven 仓库。
本机装过就能通,本机实测 mvn -B -o package -DskipTests 通过。本仓库 pom 还把 im 声明为 provided,
要用工作台就先在 wujies-im-plugin 跑一次 mvn -B -o -DskipTests install。
Q:/site/quote 打不开 / 一片空白?
先确认 cms 装了。QuoteSiteRender 找不到 CMS 时给 404 + 空响应体并 WARN —— 不自己拼裸 HTML
(把「没装内容中心」讲给访客等于播报内部部署状态)。
Q:样式 404,但接口是通的?
QuoteSiteAssetController 需要热加载一次 quote 才注册(光 mvn -o compile 只更新资源、不注册路由)。
判断方法:未命中的 /site/** 回的是 200 + JSON,所以要看 content-type 而不是状态码。
Q:改了前台模板/样式,页面还是旧的?
样式走 5 分钟短缓存(故意不设 immutable);改完清一次浏览器缓存或等 5 分钟。
另注意 frontend/src/index.ts 里 styles 的文件名必须是真实产物名(quote-app.css)——
写错不报错,表现是整站无样式(宿主按清单插 ``,那个文件 404 且无人提示)。
Q:打包时提示「找不到插件目录」?
在本仓库根不要传 -Plugin —— 脚本按「仓库根有没有 app.json」判定布局,传了它就去找子目录清单。
Q:前台提交询价报「字段不完整」/ 直接回目录没反应?
看 err 回执码:items 没选行、quantity 数量为空或越界(0.01 ~ 999999)、fields 姓名或电话不合形状、
save 建单异常(看宿主日志 [quote] 前台询价单建单失败)。行数上限 20,超了整单不进来。
Q:工作台点了没反应?
它要登录态(LoginHelper.isLogin() 真问服务端会话,只解 JWT 会把已注销的旧 token 当有效身份),
且需要 im:未登录 / 当前是超管 / IM 侧拒绝时,失败原因会印在链接旁,不会静默。
🔒 隐私与外部资源
- 不收集、不上报任何遥测;报价单、明细、价格库都只存本平台数据库。
- 匿名询价只收客户自己填的姓名 / 联系人 / 电话 / 备注与所选
priceId,不落 IP、不接第三方统计。 - 本仓库不含任何密钥或凭据;签名密钥只在本机
keys/(已 gitignore)。 - 前台页面外呼只有本平台自己的
/site/*接口与 CMS 主题资源。
📄 许可证与致谢
MIT(条文见仓库根目录 LICENSE,许可口径与 wujies-platform 一致)。
💬 反馈与建议
- 仓库:gitee.com/wujies/wujies-quote-plugin
- 文档:插件开发见 docs.wujies.cn,打包见 「打包应用」
参考
wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、
wujies-ui(npm 上 @wujies/* 四件套的源码仓)、
wujies-cms-plugin(公开页的主题壳,口径见其 README
「写主题时必须守住的五条」)、
文档站「插件开发」章节。
评论区需要浏览器启用 JavaScript 才能加载。