Documents the time-slot switch…

# 充电桩峰谷电价分时切换逻辑开发说明

一、业务背景

小区充电桩项目接入电网分时电价，需按充电时段自动匹配电价：

• 谷段：23:00 - 次日 07:00，单价 0.3 元/度
• 峰段：07:00 - 23:00，单价 0.9 元/度
• 计费需精确到充电实际发生的时间区间，而非开始充电时的时段。

二、时段边界定义（关键）

1. 以自然日为基准，谷段跨越午夜，需做跨日处理（如 23:30 属于当日谷段）。

2. 边界时刻归属建议：

• 23:00:00 整点起进入谷段
• 07:00:00 整点起进入峰段

3. 时间源统一使用服务器时间，需明确时区（建议统一东八区），避免设备本地时间漂移。

三、核心计费逻辑

一次充电会话可能跨时段，计费规则如下：

1. 按充电功率/电量采样周期（建议按分钟或按电量增量）拆分电量归属时段。

2. 每个时段电量 × 对应单价，逐段累加得到总电费。

3. 示例（伪逻辑）：

• 22:30 开始充电，24:00 结束
• 22:30–23:00 段电量按 0.9 元/度计
• 23:00–24:00 段电量按 0.3 元/度计

四、边界与异常场景

1. 跨日会话：保证会话 ID 与计费明细不因跨日拆分而重复或丢失。

2. 电量采样误差：边界时刻附近的电量归属需按采样时间戳判定，前后误差控制在单个采样周期内。

3. 价格配置化管理：峰谷时段与单价建议入库配置（含生效日期），便于日后政策调价，不做硬编码。

4. 断电/重连：会话中断续充需保留同一会话，按实际充电明细分段计费。

5. 时间回拨/校时：设备时钟异常时以服务端时间为准。

五、输出要求

1. 每笔订单生成计费明细：分时段电量、单价、小计、总价。

2. 明细供用户端展示与后台对账，金额计算建议使用高精度类型（如分/厘为单位），避免浮点误差。