<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>,企业库:工商信息的查询、新增、修改、删除、Excel 导入导出,另带两个前台公开页与一组对外开放门户接口。</p> <p> <a rel="nofollow"><img alt="应用版本" src="https://img.shields.io/badge/app-1.0.5-111111?style=flat-square"></a> <a rel="nofollow"><img alt="应用编码" src="https://img.shields.io/badge/code-enterprise-0057FE?style=flat-square"></a> <a rel="nofollow"><img alt="License" src="https://img.shields.io/badge/license-commercial-orange?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)的企业数据应用,一个插件一个仓库:后端 Maven 模块在仓库根,
前端远程应用在 frontend/。
- 后台:应用市场装上后多一个「企业数据 → 企业库」菜单,前端是远程应用(
frontend/,7 个文件), 带查询 / 新增 / 修改 / 删除 / 导出 / 导入六个按钮权限(enterprise:company:*)。 - 前台:两个由 CMS 主题直出的公开页 ——
/site/company(企业查询)、/site/company/{id}(单家企业详情), 模板在本仓库src/main/resources/site-templates/(见「公开页与自带样式」)。 - 对外:门户接口
/portal/enterprise/company/list、/portal/enterprise/company/{id}, 与后台用同一套 service,公开口径固定status='0'。
应用编码 enterprise | 应用版本 1.0.5 | 后端构件 wujies-enterprise-plugin | 清单 type = app
| 引擎 >=5.6.2 <6.0.0
✨ 功能特性
- 🏢 企业库 — 工商信息的分页查询、单条详情、新增、修改、批量删除(
enterprise:company:*六个按钮权限)。 - 📤 Excel 导出 — 导出当前筛选结果(
ExcelUtil+EnterpriseCompanyVo),走POST /enterprise/company/export。 - 📥 Excel 导入 — 上传爱企查格式工作簿即建一个后台导入任务,返回
taskId;前端轮询GET /enterprise/company/importProgress/{taskId}看进度,不必等整份文件跑完。 模板由POST /enterprise/company/importTemplate现场导出(EnterpriseCompanyImportVo,表名「爱企查企业数据导入模板」)。 - 🔎 前台企业查询 —
/site/company一屏:统计块 + 搜索条件 + 企业卡片列表,筛选条件全走 query。 - 📄 前台企业详情 —
/site/company/{id}整页noindex,联系方式不在公开页出现。 - 🌐 对外开放接口 —
/portal/enterprise/company/list、/portal/enterprise/company/{id}, 控制器级@SaIgnore匿名可读,只吐status='0'的企业。 - 🔐 多租户 — 企业表是
TenantEntity,租户过滤由宿主拦截器统一收口。
📸 预览
企业库:企业数据统计 + 搜索条件 + 企业数据列表

🚀 安装
环境要求
| 项 | 要求 |
|---|---|
| 平台版本 | >=5.6.2 <6.0.0(app.json 的 engine) |
| 后端构建 | JDK 17+(父 POM 的 java.version 为 17) |
| 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm |
| 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后拉取 |
从应用市场安装
- 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
- 安装时自动执行
migrations/01-create-enterprise-tables.sql(建enterprise_company)。 - 装完刷新菜单,出现「企业数据 → 企业库」即成功。
包里两个产物的路径由 app.json 的 assets 决定:
frontend → frontend/index.js | backend → backend/wujies-enterprise-plugin-1.0.5.jar。
从源码构建
在本仓库根打包(三条命令各管一段,都在本仓库根执行):
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev # ② 开发包:不签名,落 ..\.plugin-dist\enterprise\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 # 后端(前提见「常见问题」里的父 pom 一条)
cd frontend && npm install && npm run build # 前端,产物 dist/index.js + assets/enterprise-app.css最快的开发路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」,
找到 enterprise 这一行点「启动后端」(自动编译并加载 target/classes,同时开启监听)与「启动前端」
(常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR)。全流程见
文档站「插件开发」。
升级与卸载
- 升级:换
app.json的version后重新打包上传;已执行过的迁移脚本不可改内容(账本按(app_code, script)记 checksum),要加表结构就新增02-那样的脚本。 - 卸载:管理端「应用市场」里卸载。表名清单同时是卸载删表的唯一依据(平台从
migrations/里解析CREATE TABLE),所以新加表要新增脚本,别往里写sys_*/app_*平台表。
⚙️ 设置
本应用没有独立的配置页,也没有 sys_config 种子:运行时行为由 app.json 的菜单与 enterprise_company
数据决定。公开页的筛选组(经营状态 / 省份 / 城市)是从这批数据里现查的,没有字典表也没有常量表;
刻意没有「行业」「企业类型」两组 —— 那两列是导入的自由文本,同一件事十几种写法。
菜单入口
| 菜单 | 路径 | 组件键 | 权限前缀 |
|---|---|---|---|
| 企业数据(目录) | enterprise | — | — |
| 企业库 | enterprise/company | remote:enterprise/enterprise/company | enterprise:company:list |
按钮(type=F)六个,逐字取自 app.json:enterprise:company:query / :add / :edit /
:remove / :export / :import。
后端接口:
| 路径 | 说明 |
|---|---|
| /enterprise/company/list | 后台分页查询(enterprise:company:list) |
| /enterprise/company/{id} | 单条详情(enterprise:company:query) |
| POST/PUT /enterprise/company、DELETE /enterprise/company/{ids} | 增 / 改 / 删 |
| POST /enterprise/company/export、/importData、/importTemplate、GET /importProgress/{taskId} | Excel 四件 |
| /portal/enterprise/company/list、/{id} | 门户开放接口(类级 @SaIgnore,只读 status='0') |
| /site/company、/site/company/{id} | 前台公开页(@SaIgnore,text/html;charset=UTF-8) |
🧩 依赖与插件支持
| 项 | 说明 |
|---|---|
| 依赖插件 | 无(app.json 的 dependencies 为空数组) |
| CMS 主题 | 两个公开页由 CMS 主题渲染,壳(头 / 尾 / 导航)经 SDK 的 SiteRenderApi 借用;cms 没装则公开页拿不到壳 |
| 平台存储 | 不涉及上传存储;Excel 导出直接写响应流 |
| 公共 API | 前端走打进包内的 @wujies/api-client,运行期由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例 |
公开页与自带样式
site-templates/ 里那两个模板由 CMS 主题渲染:本插件的 EnterpriseSiteRender 经 SDK 的 SiteRenderApi
向内容中心(cms)借头/尾/导航的壳,EnterpriseSiteController(类级 @RequestMapping(EnterpriseSiteLinks.PUBLIC_BASE),
PUBLIC_BASE = /site)只负责 @SaIgnore + produces=text/html;charset=UTF-8 出整页。
这一屏还没有自己的样式文件:src/main/resources/site-styles/ 在本仓库不存在,筛选那一列整屏沿用主题的
.shop__* 类与 data-cms-shop 钩子(版式照 wujies-mall-plugin 的 shop.html)。样式与静态资源端点下沉进
插件这一步只在图床跑通了,口径见 wujies-gallery-plugin README 的同名小节。
页面上钉死的几条口径(都在 EnterpriseSiteController / EnterpriseSiteLinks 的类注释里):
- 筛选参数走 query 而不是路径段:
province、city、status、q(搜索词,覆盖名称、代码、法人、地址与经营范围)、page;空值整段不拼,第一页不带page,带条件或翻页一律noindex。 - 三组条件是经营状态、省份、城市,全部从这批数据里现查(
listPublic*),没有字典表也没有常量表; 刻意没有行业与企业类型那两组 —— 那两列是导入的自由文本,同一件事十几种写法。 - 每屏条数钉死
LIST_LIMIT = 10:PageQuery不带参数时pageSize = Integer.MAX_VALUE,不钉住就是一次全表扫描。 - 只读,且联系方式(电话 / 邮箱)不在这一页出现,理由见
EnterpriseSiteCard类注释; 详情页整页noindex,id 非数字、企业不存在、已停用一律同一份 404。 - 租户口径沿用宿主拦截器:企业表是租户表(
TenantEntity),匿名请求落在哪个租户由宿主决定。
开发环境
git clone git@gitee.com:wujies/wujies-enterprise-plugin.git
cd wujies-enterprise-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,` 已置空,父版本 1.0.0`) |
| app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets) |
| src/ | Java 源码(21 个文件):两个 controller、IEnterpriseCompanyService + impl、Mapper、domain、site/ 那组公开页类 |
| src/main/resources/mapper/enterprise/EnterpriseCompanyMapper.xml | MyBatis 映射(随插件 jar 走,由平台在加载时注册) |
| migrations/ | 1 个脚本 01-create-enterprise-tables.sql(建 enterprise_company) |
| src/main/resources/site-templates/ | 公开页直出的模板 company-list.html、company-detail.html(见上一节) |
| frontend/ | 远程应用源码(src/ 7 个文件),入口 frontend/src/index.ts |
| docs/screenshots/enterprise.png | 「预览」那一张 |
| package.ps1、package.cmd、keys/ | 打包脚本与包签名密钥(keys/ 已 gitignore,不入库) |
❓ 常见问题
Q:陌生人 clone 后 mvn package 报找不到 wujies-plugins-parent?
父 pom、wujies-common-* 与兄弟插件构件目前只有本地 mvn install 出来的版本,还没发布到 Maven
仓库。本机装过就能通,本机实测 mvn -B -o package -DskipTests 通过。
Q:pom.xml 落出来的 jar 是 wujies-enterprise-plugin-1.0.0.jar,但清单写 1.0.5,装得上吗?
装得上。package.ps1 直接把 target 里现成的 jar 按清单声明的文件名复制进包
(backend/wujies-enterprise-plugin-1.0.5.jar),所以 jar 的真实 Maven 版本与包内文件名不必一致 ——
清单说的是「应用版本」,pom 说的是「构件版本」。assets.backend 与 version 必须同步改:
两者不一致时脚本会告警(历史上一度 version 停在 1.0.0 而 assets.backend 已写 1.0.1)。
Q:打包时提示「找不到插件目录」?
在本仓库根不要传 -Plugin —— 脚本按「仓库根有没有 app.json」判定布局,传了它就去找子目录清单。
Q:前端构建产物里有裸 vue 之类的 import,会不会找不到?
正常。vue / element-plus / @wujies/ui-shared 由宿主 import map 提供单例,属于刻意 external。
Q:导入 Excel 之后页面没变化?
importData 只建任务并按 taskId 返回,真正的解析在后台;用 GET /importProgress/{taskId}
看进度与结果,别用「上传完立刻查列表」判断成功。
Q:公开页没有样式 / 排版跟商城不一样?
本屏没有自己的样式文件(site-styles/ 不存在),全部沿用主题的 .shop__* 类;主题换了版式这里就跟着变。
要自带样式的做法见图床仓 README 的同名节。
🔒 隐私与外部资源
- 不收集、不上报任何遥测;企业数据存本平台数据库,公开页只暴露
status='0'的企业且不含联系方式。 - 前端不引第三方统计脚本;远程应用只经宿主 import map 取共享依赖。
- README 与仓库中不包含任何真实口令、token 或私钥;包签名密钥只在本机
keys/(已 gitignore)。
📄 许可证与致谢
商业授权:需要一枚覆盖本应用的有效授权凭证才允许安装与加载(条文见仓库根目录 LICENSE)。
清单 app.json 里 license 为 UNLICENSED、licenseRequired 为 true;三档口径(社区版 / 专业版 / 企业版)
见官网文档「授权与版本」。
💬 反馈与建议
- 仓库:gitee.com/wujies/wujies-enterprise-plugin
- 文档:插件开发见 docs.wujies.cn,打包见 「打包应用」
参考
wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、
wujies-ui(npm 上 @wujies/* 四件套的源码仓)、
wujies-gallery-plugin(公开页样式已下沉进插件的那一版)、
文档站「插件开发」章节。
评论区需要浏览器启用 JavaScript 才能加载。