verify-activity-detail-redesign.md 15 KB

核验报告:活动详情与活动管理改进(活动简介 / 海报模板 / 详情页美化)

  • 核验日期:2026-10-24
  • 核验智能体:xxx(独立核验,不信任实现方报告,一切以代码实际为准)
  • 核验范围:cfc-frontend(活动列表/创建/详情/海报组件)+ cfc-backend(实体/DTO/Controller/Service/迁移/schema.sql)
  • 工作区现状说明(核验完成时点,避免混淆):
    • 本次核验对象 = 上述三项需求对应的活动模块改动(已提交部分见下述 commit;工作区未提交部分见其后两条)。
    • 工作区中另有两个并行会话的 Java 改动(ActivityController.myRegistrations 增加 status 参数、ActivityRegistrationService.getMyRegistrations 增加 status 筛选),对应的是「我的活动筛选芯片」需求,与本次三项活动详情/活动管理需求无关;本核验未处理、未修改这两个文件。已在重新编译时确认整仓工作区 mvn clean compile -q 仍 exit=0。
    • 目录中另存在其他会话产出的 verify-my-activities-rules.md(同目录,untracked),非本报告内容。
  • 相关 commit(实现方已提交的既有工作):188d93659(intro 字段)、a8291fa4e/71fcf956d(海报模板)、8f9367277(创建页主办方+模板选择)、dc4e42f46(详情页报名情况)、bc363eb69(ActivityPoster 移入 pages 子包)、8841ebaff(ActivityPoster :key 修复)
  • 工作区未提交改动(本次核验对象之一):cfc-frontend/pages/activity/index.vue(plainText + loadData(refresh)),以及本核验会话顺手修正的 create.vue / activity-detail.vue

一、逐项核验结果

1. 活动简介字段(前端表单 + 展示 + 后端支撑 + 空值兜底)

结论:PASS(本会话修复 2 处前端缺陷后;修复前为 FAIL)

子项 结果 证据
后端实体字段 PASS Activity.intro(cfc-backend/.../entity/Activity.java L23,注释"活动简介(纯文本短摘要,用于活动列表卡片展示)")
后端 DTO 透传 PASS ActivityDTO.intro(L13)+ ActivityDTO.from() L92 dto.setIntro(activity.getIntro())(detail/list 均走 from())
后端接口支持 PASS ActivityController.create/update 直接绑定 Activity 实体(L45/L57),intro 随 JSON 持久化;ActivityService.create/update 用 this.save/updateById,detail/list 返回 DTO 含 intro
数据库列 PASS 迁移388 ensureColumn("activities","intro",...)(DatabaseInitializer L3118-3119);schema.sql L2134 intro VARCHAR(200) 同步
列表展示 PASS index.vue 卡片 L140 `{{ plainText(act.intro
创建/编辑表单输入 修复前 FAIL → 本会话已修复 create.vue 原无 intro 输入框、buildPayload 不提交、loadDetail 不回显。本会话已补齐(见"二、已做修正")
详情页展示 修复前 FAIL → 本会话已修复 activity-detail.vue 原只用 activity.description(L108/L300)。已改为 intro 优先、description 兜底
旧数据空值兜底 PASS 列表卡片 v-if 空则不渲染;detail.vue `v-if="activity.intro

2. 数据库迁移(幂等 + 不破坏已有数据)

结论:PASS

  • 迁移388(intro / poster_template_id):DatabaseInitializer.ensureColumn()(L5129-5142)——try { ALTER ADD COLUMN } catch,捕获 Duplicate/'already exists' 后跳过,其余异常重抛;可重复执行,ADD COLUMN 不触碰已有行数据。
  • 迁移381(activity_poster_templates 表 + 3 套默认模板):createActivityPosterTemplatesTable()(L12702-12733)——CREATE TABLE IF NOT EXISTS + 种子数据 INSERT IGNORE ... VALUES(按名称唯一键幂等),整体 try-catch。
  • schema.sql 三处同步:activities.intro(L2134)、activities.poster_template_id(L2155)、activity_poster_templates 表(L5409)与实体/迁移一致。
  • 未发现会破坏已有活动数据的 DDL(全是 ADD COLUMN / CREATE TABLE IF NOT EXISTS / INSERT IGNORE)。
  • 小瑕疵(不影响功能):迁移编号 388 与 389 在 DatabaseInitializer 中被复用(388=activities.intro 与 poster_template_id;389=activities.tags 与 special_price_deals),见"四、遗留问题 4"。

3. 海报模板(模板定义 + 灵活性 + 渲染兜底)

结论:部分 FAIL(模板配置灵活性未达需求声明)/ 渲染路径兜底 PASS

模板定义(管理端):PASS

  • 实体 ActivityPosterTemplate:name / templateKey(gradient|minimal|card) / mainColor / darkColor / lightColor / bgColors(JSON) / qrSize / sortOrder / status。
  • 管理端 PosterTemplateManage.vue(cfc-web)支持模板 CRUD:名称、类型、主色、深色、浅色、可选背景色板(动态增删)、二维码尺寸、排序、启停。
  • 后端 AdminPosterTemplateController(list/save/delete,均 @PostMapping,符合项目"统一 POST"规范)+ PosterTemplateController(小程序端 list,仅返回 status=1 启用模板)。
  • 小程序端可选用模板:create.vue 的模板选择+预览(selectPosterTemplate/openPosterPreview)、activity-detail.vue 生成海报时拉取模板(generatePoster L804-810)。

配置灵活性:FAIL(相对需求声明)

  • 需求声明"标题、时间、地点、简介、二维码、背景图等元素的位置与样式可配置"。
  • 实际:模板只能配置整体配色 + 二维码尺寸;元素位置与字体/尺寸样式在 ActivityPoster._renderPoster/_drawInfoCard 中为硬编码(coverY=148、卡片高 210、labelFs=12/valueFs=14/titleFs=22、行距、二维码 y 坐标等),模板字段无任何布局项。即"元素位置与样式可配置"未实现。
  • 评估:本次改动相对内置三套模板(此前 ContentSharePoster)灵活度有小幅提升(配色/色板/二维码尺寸可配),但与需求文档承诺的"元素级可配置"存在明显差距。

渲染路径兜底:PASS(缺元素不报错)

  • 无管理端模板(templates 空)→ tplOptions 回退内置三套(L139-146)。
  • bgColors JSON 解析失败 → 回退默认七色(L161-170)。
  • 模板缺 mainColor/darkColor/lightColor → || '#F97316' 等兜底(L172-182)。
  • 二维码缺失 / 写入失败 → _drawQrPlaceholder(L540-553)。
  • 封面图缺失 / 下载失败 / 图片信息读取失败 → _drawCoverPlaceholder(L359-376)。
  • intro 为空 → 不绘制简介块;长标题/长简介 → _drawWrappedText 按行宽截断加 ..(L555-581)。
  • qrSize 缺省 → prop 默认 100。

4. Java 代码编译

结论:PASS

cd cfc-backend && mvn clean compile -q   # 退出码 0(多次复跑确认,Java 8 / Maven 3.8.7)
  • 核验时点工作区的全部 Java 改动(含并行会话的 myRegistrations status 筛选)已覆盖编译,均通过。
  • 本次核验对象(活动简介/海报/详情页)未涉及新增 Java 代码,后端改动均在此前已提交 commit 中。

5. 详情页美化未破坏原有功能

结论:PASS

  • 报名:detail.vue onRegister → submitRegistration → doCreateOrder(付费跳 order-pay / 免费直达),按钮 v-if="canRegister"(L137-144)可用。
  • 分享:shareMixin + setShareInfo(L489);分享按钮在底部栏(L132-135 生成海报入口,微信原生分享走 onShareAppMessage mixin)。
  • 海报生成与预览:generatePoster(拉二维码 + 模板,L786-836)→ ActivityPoster 组件(show/title/intro/startTime/location/priceText/qrCodeBase64/template/templates 等 props 齐全)→ savePoster 保存相册。
  • 签到:onCheckin(L535-587)+ 能量扣减弹窗;取消报名(L600-630);评价(L632-698)。
  • 语法与未定义引用:对 index.vue / create.vue / activity-detail.vue / ActivityPoster.vue 四个文件 script 段做 node --check,全部通过,无未定义变量、无截断。
  • index.vue 改动安全:plainText() 纯函数、无副作用;loadData(refresh) 三个加载方法均正确消费 refresh(重置 page=1 + 清空数组,见 L684-787),避免返回详情页后旧数据翻倍;模板未引入小程序禁用模式(无 ?.、无 :key 表达式、无 CSS Grid)。
  • 详情页信息层级:封面 → 标题/标签/状态 → 元信息卡片(时间/截止/地点/人数/费用)→ 报名情况(脱敏统计+进度条+最近报名人)→ 活动介绍 → 付费提示 → 关联内容 → 底部操作栏,卡片化 + 品牌色令牌($brand-primary 等)一致。

6. 缺陷清单

见"四、遗留问题"。


二、本核验会话已做的修正(顺手修正,与核验对象直接相关)

文件 修正内容 说明
cfc-frontend/pages/activity/create.vue ① 活动描述上方新增"活动简介" textarea(maxlength=200,placeholder 注明用于列表卡片与海报摘要);② data.form 增加 intro: '';③ loadDetail() 回显 `self.form.intro = d.intro
cfc-frontend/pages/activity/activity-detail/activity-detail.vue ① 介绍区块 `v-if="activity.intro

说明:以上修正仅涉及前端两个活动页面,未触碰 BASIC 会员配额相关文件,未改任何构建产物,未执行任何打包命令。


三、结论(可否放行)

可以放行(附条件)。

  • 需求1(活动简介):后端支撑完整,列表展示已实现,前端表单/详情展示经本会话补齐后闭环 → PASS。
  • 需求2(海报模板):管理端模板 CRUD、小程序端选择/预览、三种绘制引擎、渲染兜底均健壮 → 放行;但"元素位置与样式可配置"未实现,属需求范围缩水,作为遗留项另行评估,不阻塞本次放行。
  • 需求3(详情页美化):排版、间距、信息层级、按钮均已具备且品牌风格一致,未破坏报名/分享/海报/签到等既有入口 → PASS。
  • 数据库迁移幂等、schema.sql 同步、后端编译通过 → PASS。

放行条件:海报模板"元素位置与样式可配置"作为独立扩展任务立项跟进(见遗留问题 3),在此之前不承诺该能力。


四、遗留问题(清单化)

  1. 【已修复】创建/编辑表单无简介输入、不回显、不提交:原 create.vue 无 intro 输入框。本会话已补齐,回归时可到"创建活动/编辑活动"页验证简介输入、保存后列表与详情展示、编辑回显。
  2. 【已修复】详情页/海报未使用 intro 字段:原 activity-detail.vue 介绍区块与海报 intro 均用 description。已改为 intro 优先、description 兜底;需回归确认 description 富文本在无 intro 时仍正常渲染。
  3. 【未修复 · 需求范围缩水】海报模板不支持元素级位置/样式配置:需求声明"标题、时间、地点、简介、二维码、背景图等元素的位置与样式可配置",实际 ActivityPosterTemplate 仅支持配色 + 二维码尺寸;画布局在 ActivityPoster._renderPoster/_drawInfoCard 硬编码(coverY=148、卡片高 210、字体 12/14/22、二维码坐标等)。
    • 建议改法:activity_poster_templates 增加 layout_config JSON 列(如 {"cover":{"x":28,"y":148,"w":444,"h":202},"title":{"fontSize":22,"lines":2},"infoRows":{...},"qr":{"size":100,...}}),管理端图形化编辑,ActivityPoster 读取后传入绘制函数替换硬编码常量;同时保留现有字段兼容旧模板。DB 侧需新增幂等迁移 + schema.sql 同步。
  4. 【未修复 · 低优先级】迁移编号复用:DatabaseInitializer 中"迁移388"出现两次(activities.intro 与 poster_template_id)、"迁移389"出现两次(activities.tags 与 special_price_deals)。无功能影响(各自幂等),但后续新增迁移时建议避免续用 388/389,就近使用更大编号。
  5. 【未修复 · 观测项】详情页"整体美化"的增量归属:本次工作区美化仅涉及 index.vue(列表页);detail.vue 的卡片化/品牌色/报名情况区块均来自更早的历史 commit(a8291fa4e 海报重设计、dc4e42f46 报名情况、1ff115c5d/6d0db37a2 等美化轮次)。功能与视觉现状满足需求3,但"本次会话具体改了详情页哪些样式"无法从工作区 diff 复核。若需求方需要本次改动的样式级明细,请与实现方确认对应 commit。
  6. 【未修复 · 低优先级】PosterTemplateController 服务层注入名:@Resource private ActivityPosterTemplateService posterTemplateService; Bean 名与字段名一致,符合规范;无问题,仅记录审计过程中已确认。

五、核验方法与证据索引

  • 后端实读:entity/Activity.java、dto/ActivityDTO.java、controller/ActivityController.java、controller/admin/AdminPosterTemplateController.java、controller/PosterTemplateController.java、service/ActivityService.java、config/DatabaseInitializer.java(L3118-3141 ensureColumn / L12702-12733 createActivityPosterTemplatesTable / L5129-5142 ensureColumn 实现)、resources/schema.sql(L2134/2155/5409)。
  • 前端实读:pages/activity/index.vue(changes + L684-787 加载方法 + plainText)、pages/activity/create.vue(表单/回显/payload)、pages/activity/activity-detail/activity-detail.vue(L106-111 介绍区块、L297-319 海报 props、L786-836 生成海报)、pages/activity/components/ActivityPoster.vue(模板解析 L128-189、渲染 L238-648、兜底各分支)。
  • 管理端实读:cfc-web/src/views/admin/PosterTemplateManage.vue(表单可配置项 L76-120)。
  • 编译:cd cfc-backend && mvn clean compile -q → exit=0(核验完成时点,覆盖含并行改动在内的完整工作区)。
  • 前端 script 语法:index.vue / create.vue / activity-detail.vue / ActivityPoster.vue 4 个文件 script 段 node --check 全通过;verify-vue-compile.js 因本机未安装 vue-template-compiler/sass 无法跑完整三段校验,故模板/样式段以人工逐行审查替代(本次未引入新的模板表达式风险)。