
# 教育E卡通校园消费平台需求

## logs
### 2024-08-19
1. 退款问题发生的原因：
   - T+1:微信自动提现；
   - 退款时，需充值到微信账户上；
   - 主体名和银行账户名不一致。

2. 退款问题解决方案：
   - 使主体名与账户名一致，修改食堂户账户名。已与发财处沟通，发财处正在咨询是否合规，如果合规，则可以操作；
   - 家长登记。家长必须登记自己的银行账户名，以便退款时提现；
   - 延迟退款。在有足够微信账户余额时，再退款。

## 整体需求
1. 项目名称：苏州教育E卡通校园数字人民币应用试点项目
2. 项目基本功能要求：
   1. 使用教育E卡通、市民卡、二维码等方式进行消费；
   2. 家长在微信端、苏周到端，使用微信、数字人民币等支付方式，给学生食堂账户充值；
   3. 消费POS机支持有线、无线等连接模式；
   4. 食堂管理平台部署在教育城域网，支持多学校功能。  

---
### 一、 学生/家长端（H5）：
学生、家长在教育E卡通家长端页面查询、充值食堂账户。
1. 家长使用教育E卡通用户体系，登录E卡通平台；食堂家长端与E卡通平台用户体系打通；
2. 家长在微信公众号、苏周到APP等途径，使用微信（必选）、数字人民币（必选）、支付宝等（可选）其他支付方式，给学生食堂账户充值；数字人民币需有协议支付、硬钱包（子钱包）支付；（二期）
3. 家长可自由选择充值金额；
4. 家长可查看账户余额、充值明细、消费明细、定期消费汇总等资金账单；
5. 需设置账户余额告警，账户低于指定额度，发送消息通知学生家长充值；通知方式需支持短信通知、微信模板消息、APP通知等；
6. 需设置账户消费提醒：学生消费完成以后，发消息通知家长消费详情、账户余额等消费账单；
7. 家长可发起退款申请；退款需后台学校审核，结果通知家长。
8. 菜单展示：每天、每周食堂菜单展示给家长；更新菜单时，家长可收到通知；
9. 家长端支持账户冻结、解冻功能。



### 二、消费POS端
学生、教职工在学校食堂消费，通过刷卡或扫码，从对应用户账户中扣款。
1. 食堂消费POS机刷卡支持计价和计次消费；支持苏州市民卡、江苏交通一卡通卡刷卡；
2. 带扫码功能的POS机，支持微信扫码（被扫）、数字人民币（被扫）等其他支付方式；
3. POS机支持在网络不通畅的情况下离线刷卡；
4. 支持查看每日明细、每日汇总；
5. 支持消费撤销；
6. 支持语音播报；
7. 支持电源、电池供电；断电时至少持续供电3小时；
8. 双面屏展示；
9. 可受远程监控，可远程升级；
10. 支持有线连接、无线网络。无线模式需支持NB-IoT或4G，数据通过VPN连接到内网；
11. 需提供设备与平台间的接口：
    1.  设备注册、认证等接口；
    2.  设备签到签退等接口；
    3.  设备监测、维护、升级等接口；
    4.  白名单、黑名单、用户、账户同步等接口；
    5.  刷卡订单、二维码支付订单同步等接口；
    6.  其他可能涉及到的接口。

### 三、食堂后台管理平台
学校管理员在后管平台可对学生、教职工账户进行管理。
1. 用户管理：
   1. 用户分组：功能；
   2. 用户账户信息同步：与教育E卡通基础数据库同步。分为每天定时同步、实时同步、手动同步三种；
   3. 用户账户分为同步账户（不可修改卡号等信息）、平台手动账户（可修改信息）
   4. 支持用户（账户）冻结、解冻；
   5. 新增、修改、删除用户；

2. 设备管理：
   1. 新增设备；
   2. 更换、删除设备；
   3. 查看设备清单、状态；
   4. 远程维护、升级；
   5. 设备同步。
3. 订单管理：
   1. 订单同步；
   2. 订单查询；
   3. 订单处理、订单退款；
4. 财务管理
   1. 账户充值、批量充值；
   2. 账户退款、批量退款；退款原路返还，支持部分金额退款；退款时可设置余额允许为负；
   3. 财务报表；充值、消费、退款等报表；
   4. 财务对账；每日、每月、按日期等方式的对账单统计，明细帐；账单下载；资金账单等；

5. 支付管理
   1. 支付渠道管理：微信、数字人民币等支付渠道配置；
   2. 支持自定义充值渠道（补贴发放等）；
   3. 扣款方式管理：按金额、按次等多种扣款形式；
   4. 账户充值管理：充值方式配置。

6. 菜单管理：录入每日菜单，支持图文，可按天录入；
7. 多商户管理：
   1. 各模块，需每个商户独立运行；（SaaS租户模式）
   2. 商户配置：开设、关闭、商户管理员配置等基础操作；
8. 安全管理：
   1. 操作记录等日志信息。
   2. 后台管理员权限分配等相关设置。
9.  接口管理：
    1.  对接设备的接口：
        1.  设备注册、认证等接口；
        2.  设备签到签退等接口；
        3.  设备监测、维护、升级等接口；
        4.  白名单、黑名单、用户、账户同步等接口；
        5.  刷卡订单、二维码支付订单同步等接口；
        6.  其他可能涉及到的POS接口。
    2.  提供给学校的数据接口：
        1.  消费明细接口；
        2.  充值明细接口；
        3.  账户余额接口；
    3.  回流到教育E卡通平台的接口：
        1.  消费明细接口；
        2.  充值明细接口；
        3.  账户余额接口；

### 四、教育E卡通平台改造（不属于食堂平台需求）
1. 支持自定义学生自编号（学号）功能。后台批量导入学生学号后，卡面打印出学号，而不是E卡通号；
    1. 增加学生自编号字段；
    2. 卡片上印刷的编号，是学生自编号；
    3. 学生自编号默认就是教育E卡通号（10位）；
    4. 编码规则：不高于12位的字母+数字+英文字符组合。
    5. 学生自编号可在基础数据平台修改，修改后，同步到卡务的号码为新的自编号；
    6. 学生自编号支持批量导入。批量导入方式，可与学校导出的花名册匹配；
    7. 学校花名册下载功能，增加学生自编号的字段。

### 五、首个试点学校
1. 23台支持刷卡的pos机；
2. 6台支持刷卡、二维码的pos机；
3. 一台支持数币的二维码或硬钱包支付POS机（数币功能也可以集成在上面6台中）；
4. 3年免费质保及售后服务，超过3年按不高于5000元/年支付服务费。包括流量费。
5. 要求合同签署后一个月完成E卡通刷卡、数币充值消费等功能，其他功能在3个月内完成。

### 立达中学数字人民币试点
苏州立达中学，在2023年上线了食堂数字人民币支付的试点工作，主要实现如下功能：
1. 在学生食堂账户中，引入数字人民币校园钱包储值账户，学生可以通过充值数字人民币钱包来购买学校食堂消费平台的储值金。在绑定学生教育E卡通后，学生在食堂就餐时可以刷卡，消费金额将从储值账户中扣除。
2. 在教职工食堂消费中，引入数字人民币消费POS机，教职工可通过数字人民币APP，出示数字人民币二维码，进行食堂消费。
目前，数字人民币在食堂的试点工作处于试运行阶段，运行情况良好。在下个学期开学时，该功能将正式上线。
