2026-10-22-activity-poster-redesign.md 4.2 KB

活动专属海报重新设计

日期: 2026-10-22 状态: 已实现 关联: 迁移381 activity_poster_templates 表(specs/2026-10-17-activity-poster-template-design.md)


需求概述

活动详情页「生成海报」此前复用通用分享海报组件 ContentSharePoster,展示内容只有标题、简介摘要、价格与二维码,无法清晰传递活动的时间 / 地点 / 报名截止 / 费用 / 人数限制等关键信息。用户扫码后也无法快速判断是否能报名。

本次改造为:

作为活动参与者,我想在活动海报上直接看到活动时间、地点、报名条件和费用,以便快速判断是否参加,并通过二维码直接报名或查看详情。


方案设计

新组件:ActivityPoster.vue

专用活动海报 Canvas 组件(500×800 设计坐标),与 ContentSharePoster 完全独立:

区域 内容
顶部品牌头(y:0–140) 渐变背景 + 5 色圆点 + 「浠艾福 · 家庭健康俱乐部」
封面图卡片(y:148–350) 白底圆角矩形 + contain 居中绘制封面(无封面时显示品牌渐变占位图)
信息卡片(y:358–568) 类型色条 + 标题(2行)+ 元信息网格(时间/地点/截止/人数/费用)+ 简介(2行)
二维码区(y:584–750) 「长按识别二维码 · 立即报名」CTA + 100rpx 二维码
品牌 Footer(y:758–775) 菱形装饰 + 品牌文字

元信息网格布局(动态列数):

  • ≤2 条:2 列并排
  • 3 条及以上:3 列并排

颜色系统:与 ContentSharePoster 保持一致——渐变/深色/卡片三种模板,维度编码驱动主/深/浅色(body/mind/wisdom/action/wealth),支持管理端模板覆盖(迁移381)。

字号适配:通过 getFontScale() 适配系统字号系数(0.9–1.25 区间)。

活动详情页接入

pages/activity/activity-detail/activity-detail.vue 移除 ContentSharePoster,改用 ActivityPoster,传入以下 prop:

prop 来源 说明
title activity.title 活动标题
intro activity.description 活动详情(canvas 自动 strip HTML 取纯文本)
startTime / endTime activity.startTime / activity.endTime 时间范围(格式化 MM-DD HH:mm)
location activity.location 地点(超长截断至 30 字符)
registrationDeadline activity.registrationDeadline 报名截止(NULL 则不展示此行)
currentParticipants / maxParticipants activity.currentParticipants / activity.maxParticipants 人数(max=0 表示不限制,不展示此行)
priceText 动态计算(家长/孩子常规价+会员价) 与详情页 feeText 口径一致
coverImage getImageUrl(activity.coverImage) 封面图(含完整 URL 拼接)
dimensionCode activity.dimensionCode 五维驱动默认配色
qrCodeBase64 /api/share/qrcode 返回 活动专属邀请码二维码
templates /api/poster-template/list 返回 管理端定义的海报模板(空则内置三套兜底)

与 ContentSharePoster 的分工

场景 使用组件
活动海报(报名导向) ActivityPoster
商品/文章/个人中心海报(通用展示) ContentSharePoster(不变)

验收标准

  • 活动海报清晰展示:标题、时间、地点、报名截止、人数、费用、简介
  • 二维码 CTA 明确为「立即报名」,区别于通用海报的「查看详情」
  • 支持管理端定义的模板切换(渐变/深色/卡片)及背景色板选择
  • 未配置管理端模板时回退内置三套,海报正常出图不白屏
  • 封面图缺失时显示品牌渐变占位图
  • mvn clean compile 通过;两个 .vue 文件 script 语法校验通过
  • 小程序端无可选链、CSS Grid、:key 表达式等违规语法

兼容性说明

  • 商品/文章/个人中心海报仍走 ContentSharePoster,零影响
  • buildPosterSummary / posterSummary 字段已从活动详情页移除(不再使用)
  • 管理端模板表(迁移381)种子数据与 ActivityPoster 颜色系统完全兼容