中国 帮助

企业数据

官方 付费 应用

Wujies 无界平台(wujies.cn)的企业数据应用,一个插件一个仓库:后端 Maven 模块在仓库根,

v1.0.5 1 次安装 本季度 1 次

<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 | 引擎 &gt;=5.6.2 &lt;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,租户过滤由宿主拦截器统一收口。

📸 预览

企业库:企业数据统计 + 搜索条件 + 企业数据列表

![企业库:企业数据统计 + 搜索条件 + 企业数据列表](docs/screenshots/enterprise.png)

🚀 安装

环境要求

| 项 | 要求 | |---|---| | 平台版本 | &gt;=5.6.2 &lt;6.0.0(app.json 的 engine) | | 后端构建 | JDK 17+(父 POM 的 java.version 为 17) | | 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm | | 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后拉取 |

从应用市场安装

  1. 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
  2. 安装时自动执行 migrations/01-create-enterprise-tables.sql(建 enterprise_company)。
  3. 装完刷新菜单,出现「企业数据 → 企业库」即成功。

包里两个产物的路径由 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 &amp;&amp; npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加 -SkipBuild。
  • -SkipFrontend 只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有 app.json,装上去没有界面。本应用前后端都有,任何时候都别加它。
  • -CheckOnly 打出的 CHECK|级别|项|说明 行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库 keys/ (private.pem + public.pem,已在 .gitignore 里),生成或更换用 -Keygen (覆盖已有密钥要显式加 -KeygenForce,旧钥先整份备份进 keys\backup\&lt;时间戳&gt;\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。

手工构建(不用打包脚本时):

mvn -B -o package -DskipTests                # 后端(前提见「常见问题」里的父 pom 一条)
cd frontend &amp;&amp; npm install &amp;&amp; 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;三档口径(社区版 / 专业版 / 企业版) 见官网文档「授权与版本」。

💬 反馈与建议

参考

wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、 wujies-ui(npm 上 @wujies/* 四件套的源码仓)、 wujies-gallery-plugin(公开页样式已下沉进插件的那一版)、 文档站「插件开发」章节。

v1.0.5 2026-11-08 平台 >=5.6.2 <6.0.0 116 KB

修复

  • 导入批量写改逐行 insert,避开插件 Mapper 类名反查
  • 同步公钥检查——开源仓 yml 只有环境变量占位符时改比部署仓 keys/package-public.pem

其他

  • enterprise 1.0.4 —— 版本号与包内 jar 名同步
  • 注释瘦身(保留 ≤3 行 why 与文档指针)
v1.0.4 2026-11-08 平台 >=5.6.2 <6.0.0 116 KB

patch 升级 1.0.4

v1.0.1 2026-10-01 平台 >=5.6.2 <6.0.0 188 KB

这个版本没有写更新日志。

评论区需要浏览器启用 JavaScript 才能加载。