소스 검색

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

- update completion status from 100% (4/4) to 80% (4/5)
- add story 5: home page product list data reading (in progress)
- update acceptance criteria and completion definition
- add story 5 technical details and implementation plan
- update story completion status tracking table
yourname 1 개월 전
부모
커밋
10ff0f4625
1개의 변경된 파일36개의 추가작업 그리고 4개의 파일을 삭제
  1. 36 4
      docs/prd/epic-001-tcb-shop-theme-integration.md

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

@@ -4,9 +4,9 @@
 将tcb-shop-demo包中的主题、样式和设计规范分析并集成到当前小程序项目中,提升UI一致性和用户体验,同时保持现有系统的完整性。
 
 ## 当前进度
-- **完成度**: 100% (4/4 故事完成)
+- **完成度**: 80% (4/5 故事完成)
 - **已集成**: 主题变量、颜色系统、字体系统、布局工具类、组件样式、首页UI重构
-- **待完成**: 
+- **待完成**: 首页商品列表数据读取
 
 ## 史诗描述
 
@@ -34,6 +34,17 @@
      - `tcb-shop-demo/components/goods-card/index.wxml` - 商品卡片组件
      - `tcb-shop-demo/components/goods-card/index.wxss` - 商品卡片样式
 
+5. 🔄 **故事5:首页商品列表数据读取** - 在首页增加商品列表数据读取功能,替换模拟数据 (进行中)
+   - **目标文件**: `mini/src/pages/index/index.tsx`
+   - **参考实现**: `mini/src/pages/goods-list/index.tsx`
+   - **技术要点**:
+     - 使用 `useInfiniteQuery` 支持分页和加载更多功能
+     - 集成 `goodsClient` API 调用
+     - 保持现有 `GoodsData` 接口兼容性
+     - 添加加载状态和错误处理
+     - 保持现有事件处理逻辑
+     - 实现触底加载更多功能
+
 ## 兼容性要求
 
 - [ ] 现有API保持不变
@@ -49,7 +60,7 @@
 
 ## 完成定义
 
-- [x] 所有故事完成且验收标准满足 (4/4 完成)
+- [ ] 所有故事完成且验收标准满足 (4/5 完成)
 - [x] 现有功能通过测试验证
 - [x] 集成点正常工作
 - [x] 文档适当更新
@@ -142,6 +153,7 @@
 - ✅ 现有功能无回归
 - ✅ UI一致性显著提升
 - ✅ 开发效率提高(通过工具类复用)
+- 🔄 首页商品数据真实化
 
 ## 故事完成状态
 
@@ -199,4 +211,24 @@
   - 修复了首页TypeScript错误(未使用变量和导入问题)
   - 更新了TDesign Swiper组件配置,设置高度为300rpx
   - 与现有TabBarLayout完全兼容
-  - 首页组件TypeScript编译正常,无错误
+  - 首页组件TypeScript编译正常,无错误
+
+### 故事5:首页商品列表数据读取 🔄 (进行中)
+- **计划日期**: 2025-11-20
+- **实施者**: James (Full Stack Developer)
+- **技术分析**:
+  - **当前状态**: 首页使用模拟数据 `mockGoodsList`
+  - **目标状态**: 使用 `goodsClient` API 获取真实商品数据
+  - **参考实现**: `mini/src/pages/goods-list/index.tsx` 中的商品列表数据读取逻辑
+  - **技术要点**:
+    - 使用 `useInfiniteQuery` 支持分页和加载更多功能
+    - 集成 `goodsClient.$get()` API 调用
+    - 数据转换:将API返回的商品数据转换为 `GoodsData` 接口格式
+    - 保持现有事件处理逻辑(商品点击、添加到购物车等)
+    - 添加加载状态和错误处理
+    - 保持与现有 `GoodsList` 和 `GoodsCard` 组件的兼容性
+    - 实现触底加载更多功能
+  - **兼容性要求**:
+    - 保持现有 `GoodsData` 接口不变
+    - 保持现有事件处理函数签名不变
+    - 保持现有UI结构和样式不变