第一次使用：走通发行与履约

开始前的条件

准备 Node.js 22.13 或更新版本、npm，并在项目根目录安装依赖。浏览器与 API、项目专用本地链需要保持运行。此流程使用开发适配器，不会向真实渠道扣款。

npm ci
npm run dev

正式发行前的业务依赖

1. 商家与权益供应商在「我的 → 与心中上海同行」提交组织资料。这里的客户名称在其他项目交付时按客户品牌替换。
2. 管理员在工作台「审核」通过组织准入。
3. 供应商在「权益供给」创建权益模板并提交审核。
4. 管理员通过权益模板后，商家在「发行」创建作品，选择一个或多个模板并提交发行审核。
5. 管理员通过发行资料后，消费者才能在发现页看到商品。

本地种子数据已经包含审核通过的权益与商品，便于直接验收购买和使用流程。它们不替代正式项目的审核记录。

完成一次购买与使用

1. 用本地消费者账号登录，在「我的 → 实名认证」使用「填入本地测试资料」并完成认证；系统登记本地链上 DID。
2. 从「发现 → 全部藏品」打开作品，查看「收藏权益」与「购买须知」，勾选同意后创建订单。
3. 确认「本地付款」。交付完成后到「藏品」查看新增编号，并展开「链上凭证」核验持有人。
4. 到「权益 → 我的权益」选择门票，完成时段与使用人资料，锁定预约后确认出票。
5. 选择生活权益并出示动态码；供应商在工作台「核销」输入该码并确认一次。
6. 核对消费者的剩余次数、供应商核销记录及资产链上状态。未使用门票可通过票务页退回。

完成的判断标准

• 同一支付或交付请求重试，不增加第二份资产。
• 核销成功仅扣减一次，重复请求、过期码或错误供应商不会再次消费。
• 确认出票只扣一次平台兑换次数；查询入场状态不再扣减。
• 退款或外部返回未知时保留处理中状态，通过原订单继续核实。
• 核对资产编号、订单号、票务流水与审计记录，不以截图或提示语单独认定外部交易完成。

本地测试账号与密码仅在仓库 README 的本地运行章节中列出，不随产品官网公开分发。