#芙 SPA 技术文档

核对日期：2026-10-14。以活跃仓库及现行实施记录为依据，本文说明实现和配置约定，不证明目标环境已部署或完成真机验收。操作步骤见产品与操作手册。

#阅读入口

#当前项目与责任

#共同技术边界

• 当前双后端共享业务数据库，但不能任意跨域写表；规则与事务通过正式 Service、MyBatis Mapper 和 XML 执行。
• 共享券与培训核心由两宿主以一致版本接入，不能各复制一套金额或权益算法。
• 人民币以整数分保存；积分、件数、时长分别使用自己的协议单位，不能把积分 minor 值直接当人民币分。
• 核心状态、资金资产、库存及核销以服务端成功事实为准；客户端成功回调不能制造最终付款状态。
• 权限同时检查可信身份、具体动作及门店范围；前端菜单隐藏不能代替后端校验。
• 业务日按 Asia/Shanghai 及现有营业日规则处理；未知和未采集保留未知，不补成零。
• 独立分析源为只读采集，ClickHouse 是派生查询结果，不能反向改交易库补平报表。

#变更同步

页面、菜单、接口、资产口径或状态规则变化时，同时更新操作手册及对应技术页。数据库变化更新 schema、precheck、upgrade、verify；实施记录标明代码、验证、部署和验收各自状态。

自动派单排班方案仍属于规划，不能因有设计文档就写成当前已执行流程。本轮来源和验证见更新说明。