Unifi-Voucher-Site项目5.1.0版本发布：新增自助服务终端功能

Unifi-Voucher-Site项目5.1.0版本发布：新增自助服务终端功能

unifi-voucher-site UniFi Voucher Site is a web-based platform for generating and managing UniFi network guest vouchers 项目地址: https://gitcode.com/gh_mirrors/un/unifi-voucher-site

Unifi-Voucher-Site是一个基于Node.js开发的WiFi凭证管理系统，主要用于Unifi网络控制器环境下的访客WiFi凭证生成与管理。该系统提供了Web界面，允许管理员轻松创建、管理和分发临时WiFi访问凭证。

5.1.0版本核心更新

本次5.1.0版本主要引入了自助服务终端(Kiosk)功能，这是一项重要的用户体验改进。自助服务终端模式允许访客在无需管理员协助的情况下，自行获取WiFi访问凭证，特别适合部署在酒店大堂、咖啡馆、会议室等公共场所。

新增功能亮点

1. 自助服务终端界面

   • 新增kiosk.ejs模板文件，提供了专门为触摸屏优化的用户界面
   • 添加了kiosk_bg.jpg背景图片，提升终端界面的视觉体验
   • 包含kiosk_example.png示例图片，帮助管理员预览终端界面效果

2. 系统配置增强

   • 在variables.js中新增了KIOSK_ENABLED和KIOSK_VOUCHER_TYPE环境变量配置
     • KIOSK_ENABLED：控制是否启用自助终端功能
     • KIOSK_VOUCHER_TYPE：定义终端生成的凭证类型
   • 默认区域设置调整为'en'，确保邮件发送功能的兼容性

3. 状态监控集成

   • 更新了status.ejs和status.js，新增了对自助终端模块的状态监控
   • 在info.js中添加了终端输出功能，便于调试和日志记录

4. 样式优化

   • 在style.css中实现了计时器样式，提升用户交互体验
   • 导航菜单(navigation.ejs)新增了终端功能链接

5. 后端服务增强

   • 服务器(server.js)新增了/kiosk路由，支持终端功能
   • 在相关路由中添加了kioskEnabled状态检查

6. 部署支持

   • 更新了docker-compose.yml文件，确保容器化部署时终端功能可用

技术实现解析

自助服务终端功能的实现采用了模块化设计思路。前端使用专为触摸操作优化的界面，后端通过环境变量控制功能开关，这种设计提供了良好的灵活性和可配置性。

计时器样式的实现采用了CSS3动画技术，确保在不同设备上都能流畅显示。状态监控功能的增强使得管理员可以实时了解终端模块的运行状况，便于维护和故障排查。

邮件功能的区域设置默认为英语('en')，这一改动提高了国际兼容性，同时保留了根据需要更改为其他语言的能力。

实际应用场景

这一版本特别适合以下场景：

1. 酒店大堂：客人可以自行获取WiFi访问凭证，减少前台工作压力
2. 咖啡馆/餐厅：顾客无需询问密码，通过终端界面即可连接网络
3. 会议场所：参会者可以快速获取临时网络访问权限
4. 零售店铺：为顾客提供便捷的网络接入服务

自助服务终端模式的引入显著提升了用户体验，同时减轻了管理员的工作负担，是Unifi-Voucher-Site向更自动化、更用户友好方向迈进的重要一步。

unifi-voucher-site UniFi Voucher Site is a web-based platform for generating and managing UniFi network guest vouchers 项目地址: https://gitcode.com/gh_mirrors/un/unifi-voucher-site