{
  "descriptionFormat": "MARKDOWN",
  "formatType": "MARKDOWN",
  "assignedTo": "635755195dc8531eeb2e33d9",
  "participant": [
    "635755195dc8531eeb2e33d9"
  ],
  "status": "100005",
  "space": "dd2f708d1702891ff45b6f5d99",
  "spaceIdentifier": "dd2f708d1702891ff45b6f5d99",
  "spaceType": "Project",
  "category": "Req",
  "workitemType": "9uy29901re573f561d69jn40",
  "viewSpaceId": "dd2f708d1702891ff45b6f5d99",
  "spaceId": "dd2f708d1702891ff45b6f5d99",
  "workitemTypeId": "9uy29901re573f561d69jn40",
  "workItemTypeId": "9uy29901re573f561d69jn40",
  "workitemTypeIdentifier": "9uy29901re573f561d69jn40",
  "subject": "【滨州项目】一卡通系统对接：人员余额同步、消费订单与退款信息推送",
  "description": "## 需求背景\n\n滨州项目需要与客户原有一卡通系统对接。客户侧一卡通作为人员、卡和余额的主数据来源；智慧营养健康餐厅系统负责产生消费订单、消费明细和退款/冲正数据，并同步给一卡通用于扣款、对账和留痕。\n\n## 需求范围\n\n### 1. 一卡通同步给本系统\n\n- 人员基础信息：一卡通人员唯一ID、工号/人员编号、姓名、手机号、性别、证件号等。\n- 部门组织信息：部门ID、部门名称、上级部门ID。\n- 身份与状态：身份类别、人员启停状态、在职/离职状态。\n- 卡信息：物理卡号/IC卡号、卡状态（正常、挂失、冻结、退卡）。\n- 余额信息：现金余额、补贴/餐补余额、总余额、更新时间。\n\n### 2. 本系统同步给一卡通\n\n- 消费订单主信息：订单号、设备流水号、人员/卡号、部门快照、消费日期、餐次、下单时间、支付时间、餐厅/档口、设备编号、订单来源、支付类型、在线/离线收款模式。\n- 金额信息：商品原价、订单金额、实付金额、现金支付金额、补贴支付金额、优惠金额、管理费、打包费、消费后现金余额、消费后补贴余额、消费后总余额。\n- 订单状态：支付状态、订单状态、退款状态、已退金额、备注、创建时间、更新时间。\n- 消费明细：订单号、菜品ID/UUID、菜品名称、分类、数量/份数、重量、单价、明细金额、明细优惠/实收金额（如需要）、营养字段（如一卡通需要）。\n- 退款/冲正信息：退款单号、原订单号、人员/卡号、退款总金额、现金退款金额、补贴退款金额、退款原因、申请人、申请时间、审核人、审核时间、退款状态、退款后余额快照。\n\n## 不包含范围\n\n- 本系统不做充值功能。\n- 本系统不做提现功能。\n- 本次不需要同步取餐柜相关信息，包括取餐柜设备编号、柜格编号、存餐/取餐/撤销时间和取餐柜状态。\n\n## 关键对接口径\n\n- 余额主账以一卡通为准，本系统只保存必要的余额快照。\n- 消费同步需支持幂等，建议消费用订单号 + 设备流水号，退款用退款单号。\n- 离线消费恢复后不得重复扣款。\n- 退款需要作为独立数据同步给一卡通，不能只更新原消费订单。\n- 人员离职、卡挂失、卡冻结后，本系统应按一卡通状态限制消费。\n\n## 验收要点\n\n- 能从一卡通同步人员、部门、卡、余额和状态数据，并在本系统消费链路中正确识别人员和卡。\n- 本系统消费订单可按约定字段推送给一卡通，包含现金/补贴拆分金额和消费后余额快照。\n- 本系统消费明细可按订单关联推送给一卡通，满足客户对账需要。\n- 退款/冲正信息可同步给一卡通，支持全额退款、部分退款、现金/补贴拆分退款。\n- 重复推送同一消费订单或退款单时，一卡通侧不会重复扣款或重复退款。\n- 不涉及充值、提现、取餐柜信息同步。"
}