fastadmin_tailored/docs/奖品商品模板统一说明.md

奖品商品模板统一说明

背景

在抽奖活动系统中，奖品选择商品和任务规格选择商品使用了不同的显示模板，导致商品信息展示不一致。

修改内容

统一前的模板差异

奖品商品模板 (prize-goods-template)：

• 只显示基本信息：商品名称、价格
• 样式简单，信息不够详细

任务商品模板 (task-goods-template) 和 规则商品模板 (goods-list-template)：

• 显示详细信息：商品名称、价格、规格类型、编码、分类、类型
• 价格高亮显示，信息更全面

统一后的模板格式

现在所有商品选择模板都使用统一的显示格式：

1. 商品名称：支持 name 或 title 字段
2. 商品类型标签：红色标签显示商品类型
3. 价格信息：红色高亮显示，字体加粗
4. 规格类型：蓝色(单规格)或橙色(多规格)标签
5. 商品详情：灰色文字显示编码、分类、类型信息

模板结构

<div style="font-size: 14px; color: #333; margin-bottom: 4px; line-height: 1.4;">
    <!-- 商品类型标签 -->
    <% if(type_text) { %>
    <span class="label label-danger"><%=type_text%></span>
    <% } %>
    <!-- 商品名称 -->
    <%=name || title%>
</div>

<div style="font-size: 12px; color: #666; margin-bottom: 2px;">
    <!-- 价格信息 -->
    <% if(price) { %>
    <span style="color: #e74c3c; font-weight: bold;">¥<%=price%></span>
    <% } %>
    <!-- 规格类型 -->
    <% if(spec_type !== undefined) { %>
    <span class="label label-info/warning">单规格/多规格</span>
    <% } %>
</div>

<div style="font-size: 11px; color: #999;">
    <!-- 商品详细信息 -->
    <span>编码: <%=goods_sn%></span>
    <span>分类: <%=category.name%></span>
    <span>类型: <%=type_name%></span>
</div>

涉及文件

• application/admin/view/lottery/activity/scripttpl.html
  • 统一了 prize-goods-template 模板格式
  • 保持了 task-goods-template 和 goods-list-template 原有格式

优势

1. 界面一致性：所有商品选择界面显示格式统一
2. 信息完整性：奖品商品也显示完整的商品信息
3. 用户体验：统一的界面风格提升用户体验
4. 维护便利性：减少重复代码，便于统一维护

兼容性

• 保持了原有的表单字段名称和数据结构
• 不影响现有的JavaScript处理逻辑
• 向下兼容所有现有功能