Linergy 马来西亚工厂的访客系统定制

Linergy 在马来西亚的工厂投产后，访客管理这件事碰到三个具体的麻烦：来的人证件不一样、说的话不一样、审批还在另一个系统里。这篇文章讲我们在这三处做了什么定制，也讲哪些事到现场还得重新定。

一、这个门口，来的是三种人

一座在马来西亚的制造工厂，门口的人流大致由三部分构成：中方派驻的管理与技术人员，马来西亚本地的员工与来访者，以及其他国家的供应商、审核员与客户。三种人带三种证件——中国身份证、马来西亚身份证（MyKad）、各国护照。

访客登记的头一道工序是把证件信息录进系统。手工录入的问题不在于慢，在于录错与录不全：护照号少一位，姓名拼音与证件上的拼法不一致，事后核对时对不上人。让三类证件在同一台设备、同一个界面上都能读，是这个项目首先要解决的事。

二、证件：三类证件在同一台终端上读取

终端内置证件读取模块，按证件类型分别处理：马来西亚身份证（MyKad）读取卡面信息；各国护照读取资料页与机读区，按护照机读区的格式解析；中国身份证通过读卡器读取芯片信息。三类证件的读取方式不同，界面上是同一个动作。

读出之后统一成一套结构化字段：姓名、证件类型、证件号码、签发国或地区、有效期。字段统一了，后面的环节才不用为每种证件各写一套逻辑——重复到访的比对、黑名单核验、历史到访记录的串联，都按同一份数据结构处理。这也是后面能接门禁、能对接办公系统的前提。

三、语言：界面、语音、凭条三处一起换

多语言不是把界面文字翻译一遍就算完。这个项目里语言出现在三个地方：屏幕上的界面、设备播报的语音、打印出来的访客凭条。三处要同时切换，只翻界面就会出现屏幕上是马来语、语音仍在说中文的情况，门岗反而更乱。

系统支持中文、英文、马来语三种语言。前台可以在设备上切换，访客也可以在自己的预约页面上先选好语言，到现场直接按选定的语言走完登记。凭条按访客选择的语言输出，姓名与证件号原样保留，不做音译。

四、入口：H5，不装 App

预约入口做成 H5，访客用手机浏览器打开链接就能完成预约与登记，不需要下载安装。这一条与海外的手机环境有关：应用商店的可用性、账号地区的限制、安装包的分发，每一步都会掉人。能省掉安装这一步，就省掉了一次流失。

H5 页面承担三件事：访客自助填表、被访人确认、生成到访凭证。凭证是二维码，门岗扫码核验，也可以通过自助终端打印凭条。对访客来说全程只有一个链接，对企业来说不用为外部人员开账号。

五、对接：审批与通知走 Lark

客户内部使用 Lark 办公。访客预约提交后，审批与通知不另开一个入口，直接走 Lark：被访人在 Lark 里收到提醒并完成审批，审批结果回写到访客系统，门岗据此放行。访客系统只负责登记与核验，不要求客户为了访客管理再换一套协作工具。

对接方式为接口对接：预约状态变化时调用 Lark 的接口推送消息，审批结果通过接口回传。这类工作量的多少不取决于我们这边，而取决于客户 Lark 租户开放了哪些权限、有没有可用的测试环境。实施前要把这两件事确认下来，否则联调会一直卡住。

六、还有三件事，得到现场再定

其一，数据存放在哪里。访客信息含证件号码，属敏感信息。马来西亚有个人数据保护法（PDPA），数据存于境内还是境外、保存多久，由客户按自身的合规要求决定，不由供方单方面决定。这一点谈的时候要摆到桌面上。

其二，跨境访问的速度。系统部署的位置与使用的人不在同一个国家，页面打开快不快取决于链路。是否需要专线、是否要在当地再放一台服务器，要看客户的实际网络条件，事先承诺一个延迟数字没有意义，也兑现不了。

其三，当地运维由谁承接。设备在马来西亚、工程师在国内，出故障谁到现场，是客户自己的 IT、当地集成商，还是我们派人过去，三种做法的成本差别很大。这一条要在合同里写明，不能等到设备坏了再谈。

七、常见问题

问：支持哪些证件？
答：目前支持马来西亚身份证（MyKad）、各国护照与中国身份证。其他国家的本地证件需要单独适配，能不能做取决于该证件的读取方式，要先看实物样本再答复，不在电话里承诺。

问：界面语言可以增加吗？
答：现有中文、英文、马来语三种。增加语种的工作量主要在文案翻译与界面排版，不涉及改代码结构，但要逐页校对——只翻词条不校排版，长单词会把按钮撑破。

问：能对接我们自己的办公系统吗？
答：可以，按接口对接。Lark 是这个项目的做法，其他系统同样处理。前提是对方提供接口文档与测试环境，这两样缺一样，工期就只能往后排。

问：这类海外项目的周期怎么算？
答：取决于定制范围。证件与语言的适配可以先做，与办公系统的对接往往拖得比较久，因为要拿到对方租户的接口权限并逐条联调。具体周期按需求清单核算，不给笼统的估计。

八、关于粒子互联

广东粒子互联科技有限公司从事访客管理与门岗通行设备的研发与生产，产品包括访客系统软件平台、自助一体机 LZ-H1 与 LZ-T1、高端款 LZ-WX、桌面自助机 LZ-HTI 与手持访客机 LZ-M1。系统支持证件读取、多语言界面与接口对接，可按项目的证件类型、语言与既有系统做定制开发。

系统私有化部署，安装于客户自有的服务器或机房，访客数据由客户方保管，不由我方留存。海外项目的实施范围、语言与对接清单，按项目单独确认。