Przeglądaj źródła

📝 docs(prd): update TCB shop theme integration progress

- update completion status from 100% (5/5) to 83% (5/6)
- add "homepage carousel to backend ad images" to pending tasks
- add story 6 details for homepage carousel modification
- update completion criteria checkbox status
- add "homepage carousel using backend ad data" to expected benefits
- add detailed implementation plan for story 6 (in progress)
yourname 1 miesiąc temu
rodzic
commit
9f16607397
1 zmienionych plików z 35 dodań i 4 usunięć
  1. 35 4
      docs/prd/epic-001-tcb-shop-theme-integration.md

+ 35 - 4
docs/prd/epic-001-tcb-shop-theme-integration.md

@@ -4,9 +4,9 @@
 将tcb-shop-demo包中的主题、样式和设计规范分析并集成到当前小程序项目中,提升UI一致性和用户体验,同时保持现有系统的完整性。
 
 ## 当前进度
-- **完成度**: 100% (5/5 故事完成)
+- **完成度**: 83% (5/6 故事完成)
 - **已集成**: 主题变量、颜色系统、字体系统、布局工具类、组件样式、首页UI重构、首页商品列表数据读取
-- **待完成**: 
+- **待完成**: 首页轮播图改为后台广告图
 
 ## 史诗描述
 
@@ -45,6 +45,16 @@
      - 保持现有事件处理逻辑
      - 实现触底加载更多功能
 
+6. 🔄 **故事6:首页轮播图改为后台广告图** - 将首页轮播图改为后台广告图,样式高度为图片高度,宽度自适应且居中 (进行中)
+   - **目标文件**: `mini/src/pages/index/index.tsx`
+   - **技术要点**:
+     - 在 `mini/src/api.ts` 中添加 `advertisementClient`
+     - 使用 `useQuery` 获取广告数据
+     - 过滤启用的广告(status=1)
+     - 样式调整:高度为图片高度,宽度自适应且居中
+     - 保持现有轮播图功能(自动播放、指示器等)
+     - 添加加载状态和错误处理
+
 ## 兼容性要求
 
 - [ ] 现有API保持不变
@@ -60,7 +70,7 @@
 
 ## 完成定义
 
-- [x] 所有故事完成且验收标准满足 (5/5 完成)
+- [ ] 所有故事完成且验收标准满足 (5/6 完成)
 - [x] 现有功能通过测试验证
 - [x] 集成点正常工作
 - [x] 文档适当更新
@@ -154,6 +164,7 @@
 - ✅ UI一致性显著提升
 - ✅ 开发效率提高(通过工具类复用)
 - ✅ 首页商品数据真实化
+- 🔄 首页轮播图使用后台广告数据
 
 ## 故事完成状态
 
@@ -226,4 +237,24 @@
   - 保持了与现有 `GoodsList` 和 `GoodsCard` 组件的完全兼容性
   - 保持了现有事件处理逻辑(商品点击、添加到购物车等)
   - 首页组件TypeScript编译正常,无错误
-  - 与现有TabBarLayout完全兼容
+  - 与现有TabBarLayout完全兼容
+
+### 故事6:首页轮播图改为后台广告图 🔄 (进行中)
+- **计划日期**: 2025-11-20
+- **实施者**: James (Full Stack Developer)
+- **技术分析**:
+  - **当前状态**: 首页使用模拟轮播图数据 `imgSrcs`
+  - **目标状态**: 使用 `advertisementClient` API 获取后台广告数据
+  - **API分析**:
+    - 需要在 `mini/src/api.ts` 中添加 `advertisementClient`
+    - 广告API路径:`/api/v1/advertisements`
+    - 需要过滤启用的广告(status=1)
+  - **样式要求**:
+    - 高度为图片高度,宽度自适应且居中
+    - 保持现有轮播图功能(自动播放、指示器等)
+    - 移除固定高度设置(当前为300rpx)
+  - **技术实现**:
+    - 使用 `useQuery` 获取广告数据
+    - 数据转换:提取广告图片URL
+    - 添加加载状态和错误处理
+    - 保持与现有TDesign Swiper组件的兼容性