企业库(enterprise)
装上企业库后怎么导 Excel、公开口径由哪个字段决定、对外门户接口是哪一条且免不免登录。
应用编码 enterprise,本页对应应用版本 1.0.3(引擎要求 >=5.6.2 <6.0.0),许可 UNLICENSED 且需授权(licenseRequired),仓库 wujies-enterprise-plugin。
enterprise 管企业工商信息的一张宽表:后台增删改查、Excel 批量导入导出,再对外暴露一份可匿名读取的企业数据。
dependencies 为空,可单独装。它没有配置页,也没有写进 sys_config 的应用级开关,行为由数据本身(主要是每行的 status 列)和导入文件的格式决定。
本插件自带一份 EnterpriseCompanyMapper.xml(少数带 Mapper XML 的插件之一),前台两张 HTML 模板在 site-templates/company-list.html、company-detail.html。
装它
任何部署可直接装。装成功后侧栏多一个「企业数据」,下面只有一个企业库页,页上六个操作按钮随之而来:
| 菜单 / 按钮 | 权限码 |
|---|---|
| 企业库(页面) | enterprise:company:list |
| 查询 | enterprise:company:query |
| 新增 | enterprise:company:add |
| 修改 | enterprise:company:edit |
| 删除 | enterprise:company:remove |
| 导出 | enterprise:company:export |
| 导入 | enterprise:company:import |
按钮权限码要在清单里声明齐全,否则新装实例的页面上不会出现导入、导出这些操作项。
前端一共 7 个文件(入口 frontend/src/index.ts、页面 index.vue/detail.vue、api/enterprise/company/ 两层、以及类型声明),打包时按 app.json 的 assets.frontend 落到远端,页面加载靠宿主的 remote: 加载器把视图键 enterprise/enterprise/company 找到。
导出与后台管理都受 tenant_id 行拦截,租户配置见 配置指南。
配它
企业库没有设置页,两件事决定它的表现。
第一件是导入来源。点模板下载(POST /enterprise/company/importTemplate)拿到的表头,对应 EnterpriseCompanyImportVo 标注的 27 列:企业名称、经营状态、法定代表人、注册资本、实缴资本、成立日期、核准日期、营业期限、所属省份、所属城市、所属区县、电话、更多电话、邮箱、更多邮箱、统一社会信用代码、纳税人识别号、工商注册号、组织机构代码、参保人数、企业类型、所属行业、曾用名、注册地址、最新年报地址、网址、经营范围。
模板按爱企查导出格式排版,解析时 headRowNumber(3) 跳过前三行、数据从第四行读起,别改动表头行。
Excel 读写用 FastExcel(cn.idev.excel.FastExcel,经 wujies-common-excel 与 ExcelUtil 接入),批量写按 500 条一批、匹配查询按 800 条一批。
第二件是公开口径。对外那份只回 status = '0' 的企业,这一条在前台门户接口与 /site 页里都固定带上,后台管理列表不受它限制。
这里的 status 是平台通用的行状态(0 正常、1 停用),跟爱企查导入进来的"经营状态"文本列 business_status 是两回事。
要下架某家企业,把它的 status 改成非 0。
用它
管理员在「企业数据 → 企业库」单条维护,或批量导入导出。接口前缀 /enterprise/company,逐条挂 enterprise:company:* 权限码,导出用 POST /export。列表与统计都按逻辑删除走(del_flag = '0' 才回),删除操作只把标志翻成 2。
导入走异步任务:POST /enterprise/company/importData(multipart,需 enterprise:company:import)收到文件后立刻返回一个 taskId 并提示「文件上传成功,已创建后台导入任务」,真正的解析、匹配、写库在后台线程跑,前端用 GET /enterprise/company/importProgress/{taskId} 轮询。任务登记在内存、保留两小时后过期,届时再查报「导入任务不存在或已过期」。
任务生命周期里能读到的字段:状态 waiting/running/success/failed,阶段 upload/parsing/matching/importing/done,再配进度百分比与新增/更新/跳过条数。去重先看统一社会信用代码、没有再看企业名称;空文件报「导入企业数据不能为空,请确认文件是否为爱企查导出格式」。这套导入的运行期表现未做联机验证。
访客读的对外门户接口是 /portal/enterprise/company(GET /list、GET /{id}),类上 @SaIgnore,匿名即可访问,底层与后台同一套服务,只是固定 status = '0'。
前台直出的 HTML 页是 /site/company、/site/company/{id},同样 @SaIgnore,列表支持 province/city/status/q/page 查询串、每页 10 条,详情页带 noindex、刻意不展示联系方式。筛选项的取值来自 business_status/province/city 三列在公开企业里的去重值,各取前 60 条。
出问题查什么
| 现象 | 先看 |
|---|---|
| 导入后条数为 0 或报「不能为空」 | 文件是不是爱企查导出格式、表头有没有被改动(前三行是模板头,数据从第四行起) |
| 导入任务查不到进度 | 任务只在内存保留两小时,超时或重启后要重新导,taskId 是否传对 |
| 前台某家企业不显示 | 该行 status 是否为 0,非 0 的企业不进对外接口 |
| 页面上没有导入 / 导出按钮 | 六个按钮权限码是否都声明并授权给了当前角色 |
/site/company 打不开 | 是否装了 cms;无主题时这几屏不存在 |
| 前台筛选面板某项为空 | 那是按公开企业(status = '0')去重出来的取值,没有公开行就没有该项,各列最多取前 60 条 |
| 想拿模板却报 403 | POST /enterprise/company/importTemplate 与其余 CRUD 不同,方法上没有 @SaCheckPermission,只要登录可访问;被挡多半是登录态过期 |
| 装完侧栏没有「企业数据」 | 菜单树在登录时生成,重建入口见 在部署里使用应用 |
实现索引
| 项 | 值 |
|---|---|
| 数据表 | enterprise_company(含 tenant_id、status、del_flag 与 idx_enterprise_status(status, del_flag) 索引) |
| 后台接口前缀 | /enterprise/company(list、export、importData、importProgress、importTemplate 与增删改查) |
| 对外门户接口 | /portal/enterprise/company/**(@SaIgnore,匿名 JSON,固定 status = '0') |
| 前台页 | /site/company、/site/company/{id}(@SaIgnore,HTML,由 cms 主题直出) |
| Excel 组件 | FastExcel(cn.idev.excel),headRowNumber(3),27 列模板 |
| 迁移脚本 | migrations/01-create-enterprise-tables.sql |
| 源码 | cn/wujies/enterprise |
这张表也是卸载时的删除依据:AppPurgeService 从迁移脚本解析 CREATE TABLE 得到「本应用声明的表」。
迁移脚本一经执行内容不可改(摘要记账见 数据库迁移)。
/enterprise/company 走权限码、两条对外接口走 @SaIgnore 的鉴权差异,见 接口与权限参考;通用排查见 故障排查。