二维卡，是怎么一回事
一张会收数据的卡。5 分钟读完四件事：它是什么、它和二维码有什么不同、 为什么印出去之后还能变、以及打印前你需要知道的全部。
① 定义
What is a QR Card?
一张会收数据的卡。它由三个各司其职的部分组成——卡面、码、扫码后的页面， 缺一个都只是「贴了二维码的纸」。
卡面
让人在 3 秒内看懂并决定扫不扫：标题说清什么事，CTA 说清扫了做什么， 状态徽章说清还来不来得及。
码
唯一的入口。永远白底深码——这是可扫性红线，任何配色和材质都不能破坏它。
扫码后
与卡面同源视觉的移动页，完成一个明确行动——报名、签到、反馈。 状态与数据实时回流给创建者。
它不是「美化过的二维码」。美化一张码，并不会让它变成一张卡。
② 本质差异
Code vs Card
码是指针（pointer）：指向别处，扫完即弃，自己什么都不是。 卡是对象（object）：有边界、有状态、有唯一行动。
只有一个码
扫完跳去别处，什么都没发生。
没有内容、没有状态、没有结果。
一张卡
看懂、扫了、报上名——名额与状态实时回流。
印出去的纸没变过，卡却一直在变。
| 二维码（Code） | 二维卡（Card） | |
|---|---|---|
| 本质 | 指针：指向别处 | 对象：有自己的职责 |
| 用户看到 | 一团黑白图形，扫了才知道 | 3 秒读懂的一张卡：什么事、做什么、来不来得及 |
| 扫完之后 | 跳走即弃，无痕迹 | 完成一个行动，数据实时回流 |
| 状态 | 恒定不变 | 开放 → 满额 → 候补 → 结束，实时更新 |
| 改内容 | 必须换码重印 | 链接与状态随时改，码不重印 |
③ 印后仍在变
Dynamic Cards
印在纸上的是卡面，活在云上的是状态。一张卡的完整生命周期： 开放 → 满额（自动转候补）→ 候补中 → 已结束（截止自动关闭）→ 复制下一期。 纸不用重印，码不用重生成。
{{ {open:'还在收人：先到先得', full:'满 30 人：自动停止', waitlist:'超员了：兴趣不流失'}[c.content.status] }}
只在关键时刻通知你
满员、候补、截止——每张卡只在这三个瞬间通知创建者，其余时间不打扰。 数据实时回流，不需要导出汇总，也没有大而全的仪表盘。
下一期从这张卡复制
周期性活动不用重做：复制卡、只改日期与名额，二维码不变—— 已经印出去的物料继续有效。
④ 技术
How it's made
一张卡就是一个 card.json：四层结构把「办什么事」 和「长什么样」彻底分开——所以同一张卡可以换成任何配色材质，而内容一个字不丢。
content
办什么事
标题、CTA、字段、名额、截止；链接卡则是 URL 与页面标题。
layout
槽位怎么排
classic 居中 / split 分栏 / minimal 极简——槽位决定谁出现在哪。
style
长什么样
24 套配色 × 12 种材质 × 3 种卡型 × 3 档圆角，自由组合。
widgets
组件与参数
码大小、码色与方圆码点、徽章 tone、CTA 样式——每个组件独立调参。
- 类型守卫 url 卡自动禁用名额进度与状态徽章——不适配的组件在 spec 层就被拦下，不靠人工记忆。
- 流式字号 卡面全部用容器查询（cqw）计字号——同一份实现，从名片到海报一个字不重排。
- 一处渲染 任何页面只要输出同一套 DOM 契约，就能用同一份 card.css 完整还原一张卡——首页工作台、18 个品牌生成器页、行业模板页的预览永远一致。
- 可扫性红线 码区恒白底深码；导出前自动跑纠错等级、对比度、尺寸梯度三项检查。
⑤ 打印指南
Print & Scan Guide
二维卡是印在物理世界里的东西。六条规则，决定扫得出与扫不出。
码区白底深码
这是铁律。深色卡面上，码放白色圆角容器里——生成器已自动处理，导出时不用检查这层。
物理尺寸下限
码边长至少 2cm（手臂距离可扫）；观看距离每增加 1 米，边长再加 1cm——海报按距离换算。
静区不要裁
码四周的留白（至少 4 个模块宽）是识别的一部分——排版时别让设计元素挤进去。
哑光优先
反光铜版纸、亮面膜会反白导致识别失败；哑光纸、哑光膜最稳。
印前实测
正式付印前打一张样，用两台以上手机（最好一台旧款）实际扫一次。
挂载环境
贴在玻璃、金属面上时，留意环境反光与扫码角度；室外物料选耐候覆膜。