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