年卡跨淡旺季的有效期模型:不可用日期、次数与顺延规则

年卡是票务系统里规则密度高于单次票的一类产品。它同时涉及有效期、可用日期、使用次数、实名绑定与顺延策略,一旦跨过淡旺季切换,这几个维度会互相干扰。本文给出一套可落地的年卡有效期模型,并说明换季时哪些字段需要重算、哪些必须冻结。

一、年卡的五个维度

单次票只需要回答"这张票能不能在某个日期使用"。年卡要回答五个问题:

| 维度 | 含义 | 换季是否受影响 |

|---|---|---|

| 有效期 | 卡从激活到失效的时间区间 | 否(但可能被顺延影响) |

| 可用日期 | 哪些日期可用(工作日/周末/节假日/特定排除日) | 是(淡季可能新增不可用日) |

| 使用次数 | 有效期内可使用次数(不限次 / N 次) | 否 |

| 实名绑定 | 是否绑定持卡人、是否可转让 | 否 |

| 顺延规则 | 不可抗力或闭园时是否延长有效期 | 是(闭园、限流可能触发) |

关键结论:换季影响的是"可用日期"和"顺延规则"两个维度,有效期与次数不应在换季时被重算。

二、有效期模型:区间 + 日历

不要用"激活日 + 365 天"这种单一算法。可行模型是三层:

```

年卡实例

├── validity: start_date, end_date # 有效区间(可被顺延修改)

├── calendar: { # 可用日历(按规则版本生成)

│ weekday_mask: 0b1111111, # 周一至周日可用位

│ exclude_dates: 2026-10-01, ..., # 排除日(节假日、维护日)

│ exclude_ranges: \[2026-12-20, 2027-01-05],

│ rule_version: 3

│ }

└── usage: { limit: null | N, used: n, records: ... }

```

日历按"规则版本"生成,而不是在每次核销时实时判断。换季时新增不可用日期,只需发布新版本日历,历史核销记录不受影响。

```sql

CREATE TABLE annual_card (

card_no VARCHAR(32) PRIMARY KEY,

holder_id VARCHAR(64) NOT NULL,

start_date DATE NOT NULL,

end_date DATE NOT NULL, -- 可被顺延修改

calendar_ver INT NOT NULL, -- 指向日历规则版本

usage_limit INT NULL, -- NULL = 不限次

usage_used INT NOT NULL DEFAULT 0,

status VARCHAR(16) NOT NULL -- ACTIVE / SUSPENDED / EXPIRED / REFUNDED

);

```

三、不可用日期的三种写法与代价

| 写法 | 实现 | 换季调整成本 | 风险 |

|---|---|---|---|

| 白名单(只列可用日) | 维护可用日期集合 | 高(每次换季重列) | 漏列即"卡不能用",投诉集中 |

| 黑名单(列不可用日) | 维护排除日期集合 | 低(只加不减) | 排除日叠加后可用日被挤压 |

| 位图 + 规则版本 | weekday_mask + 排除区间 + 版本 | 低(发新版) | 需要版本管理与回滚能力 |

实践中推荐第三种:位图解决"每周哪几天可用",排除区间解决"节假日与维护期",版本解决"规则变更可追溯"。

四、顺延规则:什么时候该延长

顺延是年卡争议集中的地方。触发条件通常有三类:

  1. 闭园:景区因天气、检修、政策原因停止开放;

  2. 限流导致无法预约:淡季限流收紧,持卡人多次约不到;

  3. 不可抗力:公共卫生事件、自然灾害。

工程上要区分"应顺延"与"不应顺延":

| 情形 | 是否顺延 | 判据 |

|---|---|---|

| 全天闭园 | 应顺延 | 当日无任何入园记录且公告闭园 |

| 部分时段关闭 | 视合同 | 若影响超过阈值(如单日 4 小时)可折算 |

| 限流约满 | 通常不顺延 | 卡本身未受限,属于供给约束 |

| 持卡人自身原因 | 不顺延 | 无系统侧事件 |

顺延的实现方式建议用"延长 end_date + 写入顺延流水",而不是"作废重发"。前者保留卡的连续性,后者会产生大量新卡号与对账问题。

五、换季时的四个动作

  1. 冻结有效期与次数:换季不重算 start_date/end_date 与 usage_limit;

  2. 发布新日历版本:新增不可用日期,旧版本保留可查;

  3. 重算剩余可用日:按新日历计算剩余可用天数,用于对外展示与客服解释;

  4. 生成顺延候选清单:把闭园日与限流约满日列出来,按合同判定是否顺延,人工确认后写入流水。

六、可验证的判据

给三类角色各一条判据:

  • 产品:一张年卡在换季前后,剩余可用天数是否能解释清楚来源(有效期 - 排除日 - 已用日);
  • 研发:换季发布是否只改日历版本号,而不改卡实例的有效期字段;
  • 运营:客服能否在 30 秒内查到某张卡某天为什么不可用(命中哪条排除规则)。

七、结论

年卡真正的难点不是有效期,是可用日期算不清。

换季不是改价,是把三套规则同时搬家。

能配置不等于配置对了;配错了,比不能配更贵。

年卡模型的本质是把"时间"拆成三个可独立演进的维度:区间、日历、次数。拆开之后,换季只是日历换版本,其余两个维度保持稳定------这也是判断一套票务系统年卡模块是否成熟的标志。

(本文为工程实践总结,涉及的产品规则因景区而异。)

相关推荐
奶油话梅糖5 分钟前
3 天 1,705 Star:DeepSeek 开源官方聊天前端——零后端纯静态,浏览器直连 API
前端·开源
Linye22 分钟前
HTML 流程图连线交叉看不清?聊聊画布避障折线与跳弧实现
前端·人工智能
山楂树の23 分钟前
Java 字符串高效处理:StringBuilder、StringBuffer、StringJoiner
java·开发语言
城北徐宫41 分钟前
MySQL数据类型整理
数据库·mysql
接着奏乐接着舞_42 分钟前
Electron 白屏问题排查及解决记录
前端
htzyl2061 小时前
前端监控最容易写错的 18 个地方:从平均值到 beforeunload
前端·浏览器
鹿鹿鹿鹿isNotDefined1 小时前
布局更新后,canvas 重新绘制,出现了只持续一帧的闪烁?!
前端·javascript·vue.js
zhanlang02171 小时前
HTML 零基础入门到企业实战【第六章 表格标签】6.3 单元格合并:跨行 rowspan、跨列 colspan 实战技巧
前端·html
技术分享官1 小时前
Geejing WebBuilder 新手指导:用 Wb.Button 按钮组件跑通企业级快速开发平台的前后端闭环
前端·javascript·低代码
SameX1 小时前
ArkTS 没有 AbortController 怎么取消 setTimeout 链用自增 token 的做法
前端