基于承诺的进度报告

Posted on 2026-03-30

我需要向某人汇报一下过去几个月应用程序的更新内容，包括新增功能、改进之处以及技术方面的提升（如果有的话）。一个智能体仅用了两分钟，根据我提供的简单提示就生成了以下信息。我让它扫描git log并据此生成更新。提交信息一直都很重要，但现在更是如此，因为它们（连同代码）是了解实际开发工作的最终权威来源。

跳跃平台——变更概要（2026年2月1日至3月29日）

产品特性及改进

付款与结账

  • Apple Pay 和 Google Pay — 顾客现在可以在手机上使用 Apple Pay 或 Google Pay 进行支付，结账速度就像买杯咖啡一样快。
  • 更智能的电子邮件拼写错误检测——如果客户在结账时不小心输入了“gmial.com”或类似内容，则会弹出一个有用的窗口，建议在他们完成购买之前进行更正——从而减少错过的确认电子邮件。
  • 付款进度指示器— 在 PayPal 付款过程中，客户现在可以看到清晰的逐步进度条，因此他们永远不会怀疑他们的购买是否成功。
  • 更清晰的支付错误——当支付出现问题时，客户会看到具体的、有用的消息，而不是通用的错误信息——这使得重试或解决问题变得更加容易。
  • 优化支付处理——现在，购买交易会根据货币自动路由到最佳支付处理商，这意味着组织者可以享受更低的费用，客户可以享受更快的处理速度。
  • 重新设计的数量选择器— 现在，票据数量选择器使用简洁的品牌化 +/- 按钮，在移动设备上更容易点击。

门票和订单

  • 短信订单详情— 购买后，顾客可以给自己发送包含订单详情链接的短信 — 当他们需要在门口用手机快速访问订单详情时非常方便。
  • 可分享的订单链接— 现在每个订单都有自己的链接，客户无需登录即可打开，方便将订单信息转发给朋友或从任何设备查看详细信息。
  • 发票生成——客户和组织者现在可以为任何订单生成和下载正式发票——可用于费用报告、会计或税务目的。
  • 自动票务分组——多次购买门票的老客户将看到所有门票自动分组在一起——无需再在单独的电子邮件中查找。
  • 与朋友一起购买团体票——顾客可以分享邀请链接，让朋友加入他们的团体票，从而轻松协调活动中每个人的座位安排。
  • 胸牌打印——举办会议或社交活动的组织者现在可以直接从该平台为与会者打印姓名胸牌。
  • Apple Wallet Passs — 门票可以保存到 Apple Wallet 中，以便在活动入口处一键访问 — 无需翻找电子邮件。
  • 更智能的换票通知——当门票换到不同的放映时间时，系统会自动发送更新后的确认邮件，以便客户始终拥有正确的详细信息。

活动与产品

  • 产品选项和变体— 销售商品、食品或其他物品的组织者现在可以提供尺寸和颜色等选项，每个选项都有自己的价格 — 顾客可以看到一个简洁的选择器，价格会自动更新。
  • 数字产品——组织者可以销售数字下载产品（例如录音、指南），并在购买后立即发送自动交付电子邮件。
  • 相关活动推荐— 活动页面现在可以突出显示相关节目或产品，帮助顾客发现更多他们可能喜欢的内容。
  • 现在所有组织者都可以提供附加服务——每个组织者现在都可以在门票之外提供附加服务（停车、商品、VIP升级）——此前这仅限于部分帐户。
  • 灵活的定价显示——组织者可以设置特殊的“覆盖”价格，这些价格始终对顾客可见，这对于早期促销或团体交易非常有用。

通行证和订阅

  • 重新设计的通行证体验——通行证系统进行了重大更新，管理页面更加清晰，使组织者更容易进行设置，客户也更容易了解他们能获得什么。
  • 每月自动付款——提供通行证产品的组织者现在每月自动收到收入——无需手动申请付款。

促销与折扣

  • 买一送一优惠——组织者现在可以创建针对特定活动、客户群体或日期范围的买一送一促销活动——这是填满座位的强大工具。
  • 智能促销定位——可以根据过去的购买记录、活动类型或时间窗口等规则，将促销活动配置为仅向合适的受众展示。
  • 一键促销链接——组织者可以生成一个 URL，当客户点击该 URL 时，会自动应用折扣——非常适合社交媒体帖子、电子邮件或影响者合作。
  • 促销代码二维码— 每个促销代码现在都附带一个可下载的二维码，非常适合打印在传单、海报或活动中的桌卡上。

市场营销与推广活动

  • 直接向购票者发送电子邮件——组织者可以向所有购买了特定活动门票的人发送设计精美的电子邮件——非常适合演出前提醒、演出后感谢或推销未来的活动。
  • 特定场次候补名单提醒——当售罄的场次重新开放时，只有报名参加该特定日期和时间的观众才会收到通知——不再发送无关的“有票了！”邮件。
  • 保存受众筛选器— 组织者可以保存他们喜欢的电子邮件受众筛选器，并在未来的活动中重复使用，从而减少重复发送的设置时间。
  • 活动效果跟踪— 电子邮件活动现在可以显示它们产生的订单数量，因此组织者可以准确地看到哪些活动正在推动门票销售。
  • 电子邮件健康工具— 一款内置工具，可查找并修复客户数据库中的问题电子邮件地址，从而提高电子邮件送达率并减少退信。

结账和表格

  • 自定义结账问题— 组织者可以向结账页面添加自己的问题（例如餐食偏好、T恤尺码、无障碍需求），并新增一个部分标题选项来组织较长的表格。
  • 智能订单履行字段——结账会根据所购商品自动询问正确的信息——商品需要填写收货地址，数字产品则不需要填写地址。

发现与搜索可见性

  • 更好的谷歌搜索结果——活动页面现在以丰富的搜索结果形式出现在谷歌搜索结果中，活动日期、价格范围和地点直接显示在搜索结果列表中——帮助客户更快地找到活动并带来更多点击量。
  • 更及时的搜索结果——搜索引擎现在可以看到活动的准确“最后更新”日期，这意味着即将举行的活动会被更频繁地抓取和索引。
  • Jump Blvd 着陆页— Jump Blvd 的专属着陆页，采用定制设计和搜索引擎优化，使该平台拥有自己的面向公众的形象。
  • 多租户入驻— 加入平台的新组织现在可以通过引导式入驻流程自行完成设置，而无需 Jump 团队的手动帮助。

人工智能与分析

  • Soma AI（品牌重塑） ——内置人工智能助手更名为 Soma AI，外观和感觉焕然一新。
  • 逐步 AI 指南— Soma AI 现在可以通过交互式的逐步教程引导组织者了解平台功能 — 就像拥有一个私人入门教练一样。
  • 历史销售分析——新的分析视图让组织者可以探索其在不同活动和货币下的门票销售历史记录，帮助他们发现趋势并规划未来的定价。
  • AI 对话监控— 一款内部工具，可帮助 Jump 团队审查组织者如何与 Soma AI 互动，从而不断改进 AI 体验。

其他改进

  • 容量感知赠票— 赠票邀请现在会在发放前检查场地容量，因此组织者永远不会意外超售演出门票。
  • 准确的退款跟踪——随着部分退款的发出，可退款金额会实时更新，让组织者清楚地了解任何订单还剩下多少可以退款。
  • 更新后的订单详情页面——管理员订单详情视图经过重新设计，布局更简洁，并添加了快捷操作下拉菜单，使订单管理更加快捷。
  • 更新后的“关于我们”页面——一个焕然一新的公司“关于我们”页面，内容和设计都得到了改进。
  • 正确计算吸收费用的税款— 修复了组织者选择吸收服务费时税款计算错误的问题，确保客户被收取正确的金额。
  • 多币种销售报告— 修复了销售报告，使其在活动以多种货币销售时能够正确显示所有货币。

技术和架构变更

美杜莎到灵药的迁移

  • 购物车操作— 将 Medusa 基于 HTTP 的购物车操作（添加/删除行项目、重新计算运费）替换为原生 Elixir 模块（ CartOperations 、 CartContext 、 CheckoutService 、 VariantPriceCalculator ），从而消除了跨服务的 HTTP 开销。
  • 折扣应用— 将折扣/促销代码应用逻辑从 Medusa 迁移到 Elixir，并使用原生 Ecto 操作。
  • 订单总额计算— 各个订单总额（税费、运费、折扣、礼品卡、服务费）现在完全在 Elixir 中计算，取代了 Medusa 依赖项。
  • 服务费计算——服务费现在根据计算时的unit_price计算，而不是根据过时的缓存值计算，从而解决了 PWYL 和吸收定价的准确性问题。
  • 座位分配端点— 将座位分配 API 迁移到 Elixir，以解决 Node.js 在负载下的性能瓶颈。
  • Campaign Stats Sync — 将 SendGrid 活动统计同步功能移至 Elixir，并添加了针对瞬态 API 故障的重试逻辑。
  • 预留座位清理——将 15 分钟预留座位过期任务从 Medusa 迁移到 Oban 工作进程。
  • 订单缓存消除— 将metadata.cache读取替换为直接访问订单表上的 Ecto 列，从而消除过时数据的风险。
  • 获取订单合并— 将Ecommerce.Orders.get_order HTTP 调用替换为直接的Context.Orders.get_order数据库查询，从而降低了延迟。
  • 购物车 API 扩展— 购物车 API 现在返回 Elixir 计算的完整购物车和商品明细总计，使前端能够依赖 Elixir 计算的值。

PayPal 集成大改

  • Dead-View PayPal 控制器— 用传统的 Phoenix 控制器替换了 PayPal LiveView，以避免 LiveView 重新渲染导致的 iframe 销毁问题。
  • 授权状态检查— 现在购物车完成操作前会验证 PayPal 授权状态，防止出现静默支付失败的情况。
  • 通过 PayPal 使用 Apple Pay / Google Pay — 集成 PayPal 高级结账 SDK，支持域名验证、美分到美元转换以及按照 PayPal 文档处理账单联系人。

订单履行和电子邮件系统

  • 产品级履行类型— 添加了product.fulfillment_type_id ，具有派生层次结构（变体 > 产品 > NULL）和Services.Fulfillment模块，用于解析逻辑。
  • 电子邮件编排— 四个独立的履行电子邮件管道（附加代码、数字下载、管理员通知、商品履行），使用 Swoosh/MJML 模板。
  • 异步邮件发送——现在邮件以异步方式发送，以避免阻塞请求处理。

定价引擎

  • 附加定价— 扩展了定价系统，以支持基于组合的定价，包括早鸟价、团体价和覆盖价类型，通过VariantPriceCalculator计算。
  • 动态退款计算—— refundable_amount现在在查询时计算（ total - SUM(issued_refunds) ），而不是存储为可变列。

数据库与性能

  • Ecto 连接池— 切换到 Ecto 管理的连接池，并调整池大小以更好地利用资源。
  • 竞态安全令牌生成— 公共订单令牌使用WHERE public_token IS NULL保护来防止并发订单处理期间出现竞态条件。
  • 变体删除保护— 现有订单引用的变体组合现在受到保护，免遭删除，从而防止数据完整性问题。

前端架构

  • 集中式商店布局— 取消了每个 LiveView 的边距，转而采用单一的布局级间距系统（ store2布局）。
  • 共享 UI 组件— 提取了line_item_display 、 OrderDetailsComponents 、 ccreator_link和OrderHelpers以减少购物车、支付和订单页面之间的模板重复。

可观测性

  • PostHog 事件跟踪— 购物车完成时发送的短信会被跟踪为 PostHog 事件，用于漏斗分析。
  • 电子邮件发送日志记录— 所有外发电子邮件现在都会记录发送元数据，以便进行调试和送达率监控。
  • LLM 聊天查看器— 管理员实时视图，带有分页会话列表、通过 IntersectionObserver 实现无限滚动以及每条消息的元数据（模型、延迟、令牌、评分）。

原文： https://zarar.dev/commit-based-progress-report/