FFD-HotelSide 酒店端设计文档 Webview版 1.0.1

项目文档 开发文档 设计文档

create by jyo on 2019-07-15
contact code0515@outlook.com
cellphone 18658167755

简介

FFD公司，自助机产品V2架构，现代化技术开发，以WebSrv作为数据支撑，客户端以WebView形式作为展现，其中桌面端Electron包装以实现对硬件DLL的js调用支持，以便更快的迭代及更灵活的扩展配置；

技术架构

客户端前端

env：

钉钉-素材文件发送和沟通
tgit 腾讯git，请自行注册，注册后手动修改用户名，并将用户名提供，将开发者加入到项目组中
windows32Bit/windows64Bit
推荐.net4.6.1+dotnetcore2.2
NODEJS 10
Yarn
electron-chromely https://github.com/chromelyapps/Chromely
chromely-react https://github.com/chromelyapps/demo-projects/tree/master/angular-react-vue
前端项目集成入服务端
zkweb-framework  https://github.com/zkweb-framework/ZKWeb
    拖取后可使用tools文件夹内的ProjectCreator.Gui.Windows作脚手架工具
    或者这部分工作待服务端同学操作

ide

c#
    vs2019
    vscode
    JetBrains rider

• electron

  • chromely .net-core/.net 461 -win_x64 -win_x86
  • js-dll

• html5

  • react
  • Redux
  • webpack
  • yarn
  • typescript
  • ant design pro
  • axios

• qiniu-cdn

• grip++

服务端

使用zkweb framwork，环境dotnetcore2.2+ 或者 .net4.6.1

• csharp
• zkweb framework 框架
• sqlite3
• qiniu
• frp
• windows server

业务功能模块

客户端

1.0.1 自助入住机客户端的前端元素尺寸需要兼容等比缩放1080x1920 立式矩形

客户端的打开目标页面url可直接在ini文件中配置
其中Admin端需要对接Grip++ 报表
demo可提供一个简单的报表输出

• 自助入住机-Electron ◓
• 自助开票机-Electron ◓
• 自助机后台-ADMIN-Electron ◓
• ThinDemo-Electron
  
  • ArcSoftFace-虹软人脸识别 ▲
  • IDCardReader-身份证读卡器
  • Lock-Reader/Writer-门锁读写卡机
  • Camera/Video-视频摄像头
    
    • 开/关API
    • 拍照API
  • UnionPay-Keyboard-银联键盘
  • UnionPay-CardReader-银联读卡器
  • QRScaner-二维码扫码器
  • Printer-打印机
  • F3-CardMachine-F3发卡机
    
    • 无卡API
    • 少卡API
  • Infrared-红外线
    
    • 开/关API
  • LedLight-LED灯带
    
    • 开/关API
  • Grip++ 报表

角色

• 实施维护：ThinDemo 所有的硬件接口都会通过JS-DLL的方式对原有的C# DLL再做一次支持JS回调的转换封装，用以确认各个硬件基本功能正常与否
• 宾客：
  
  • 入住机
  • 开票机
• 酒店管理：
  
  • 后台Admin

服务端

NLog作为日志组件，配置namespace定义不同路径的日志
DAO/SERVER/ACTION 层单元测试，覆盖率报告

• srv-manager ▲
  
  • 维护各个服务 手动操作安装/卸载/启用/停用状态及呈现状态 by winform
  • 各服务状态装卸启停的操作日志记录可查阅
  • 各服务运行所在设备IP，端口
  • api-for-serviceStatus 提供各客户端启动时做状态检查
  • 管控下列FRP,SelfMachineSrv,HotelAdminSrv
  • 该服务运行于我方Windows设备上
• FRP-client-service ▲
  
  • exe程序以windows服务的形式运行
  • 运行状态可于srvManager内查看
  • 待服务端调试完成后对接
  • 该服务运行于我方Windows设备上
• websrv-selfMachine ▲
  
  • module:onePage by ReactJS
  • api-for-machine-onePage
  • 提供Health
  • 该服务运行于我方Windows设备上
• websrv-hotelAdmin ▲
  
  • module:onePage by ReactJS
  • api-for-admin-onePage
  • module:external Api
  • module:machineSetting Api
  • 提供Health
  • 该服务运行于我方Windows设备上
• apisrv-PMS酒店PMS系统
  
  • 提供Health接口
  • 该服务可放置于非我方Windows设备上
• apisrv-PSB公安管理系统
  
  • 提供Health接口
  • 该服务可放置于非我方Windows设备上

God Bless Us