bmall-mcp 1.4.3 → 1.6.0

package/.kiro/steering/bmall/iOS/1-foundation/component_rules.md

@@ -0,0 +1,102 @@
+---
+inclusion: manual
+---
+# bmall UI 组件使用规范
+
+> **说明**: 定义 bmall UI 组件的使用规范
+
+---
+
+## JDBMToastView - 轻提示
+
+### 基本规范
+
+**[必须]** 引入头文件 `#import <JDBMUIKitModule/JDBMToastView.h>`
+**[必须]** 文字不超过 20 个字
+**[禁止]** 连续显示多个 Toast
+
+### 常用示例
+
+```objective-c
+// 成功提示（居中）
+[JDBMToastView showWithMessage:@"保存成功" 
+                     toastType:JDBMToastViewTypeSuccess 
+                  positionType:JDBMToastViewPositionTypeCenter];
+
+// 错误提示（居中）
+[JDBMToastView showWithMessage:@"网络连接失败" 
+                     toastType:JDBMToastViewTypeError 
+                  positionType:JDBMToastViewPositionTypeCenter];
+
+// 普通提示（底部）
+[JDBMToastView showWithMessage:@"已添加到购物车" 
+                     toastType:JDBMToastViewTypeTips 
+                  positionType:JDBMToastViewPositionTypeBottom];
+```
+
+---
+
+## JDBMProgressHUD - 网络加载框
+
+### 基本规范
+
+**[必须]** 引入头文件 `#import <JDBMUIKitModule/JDBMProgressHUD.h>`
+**[必须]** 显示和隐藏必须成对出现
+**[建议]** 在 ViewModel 的 loadingBlock 中控制显示/隐藏
+**[禁止]** 长时间显示加载框（超过 30 秒）
+
+### 常用示例
+
+```objective-c
+// 显示加载框
+[JDBMProgressHUD showLoading];
+
+// 隐藏加载框
+[JDBMProgressHUD hideLoading];
+
+// ✅ 推荐：在 Controller 的 bindViewModel 中使用
+self.viewModel.loadingBlock = ^(BOOL isLoading) {
+    if (isLoading) {
+        [JDBMProgressHUD showLoading];
+    } else {
+        [JDBMProgressHUD hideLoading];
+    }
+};
+```
+
+---
+
+## JDBMSimpleAlertView - 弹窗
+
+### 基本规范
+
+**[必须]** 引入头文件 `#import <JDBMUIKitModule/JDBMSimpleAlertView.h>`
+**[必须]** 使用 `WEAK_SELF` 避免循环引用
+**[建议]** 标题不超过 15 个字，详细说明放在 `contentStr`
+**[禁止]** 在弹窗回调中再次弹窗
+
+### 常用示例
+
+```objective-c
+// 确认操作（双按钮）
+JDBMSimpleAlertView *alertView = [JDBMSimpleAlertView initWithTitle:@"确定删除吗？" 
+                                                        contentStr:@"删除后将无法恢复" 
+                                                         cancelStr:@"取消" 
+                                                         submitStr:@"确定"];
+WEAK_SELF
+[alertView setClickSubmitBlock:^{
+    [weakSelf.viewModel deleteItem];
+}];
+[alertView showAction];
+
+// 提示信息（单按钮）
+JDBMSimpleAlertView *alertView = [JDBMSimpleAlertView initWithTitle:@"操作成功" 
+                                                         contentStr:nil 
+                                                          cancelStr:nil 
+                                                          submitStr:@"确定"];
+[alertView showAction];
+```
+
+
+
+

package/.kiro/steering/bmall/iOS/1-foundation/design_rules.md

@@ -0,0 +1,375 @@
+---
+inclusion: manual
+---
+# 设计规范使用规范
+
+> **说明**: 一站式设计规范，AI 只需读这个文档就能实现 UI 代码  
+> **完整宏定义**: 查看源码 `JDBMUIKitModule/ColorMacro.h`、`FontMacro.h` 等
+
+---
+
+## 颜色使用规范
+
+### 基本规范
+
+**颜色使用原则**：
+- **标准色使用宏定义**：优先使用 `ColorMacro.h` 中定义的 `tdd_color_xxx` 宏
+- **非标色使用 Category**：设计稿中的非标准色使用 `UIColor (JDCategory)` 扩展
+
+**具体规范**：
+- **[必须]** 标准色必须使用 `ColorMacro.h` 中定义的常量
+- **[必须]** 引入头文件 `#import <JDBMUIKitModule/ColorMacro.h>`
+- **[重要]** `tdd_color_xxx` 宏定义已经是 `UIColor` 对象，可以直接使用
+- **[必须]** 非标准色或需要透明度时，使用 `UIColor (JDCategory)` 扩展
+- **[必须]** 引入头文件 `#import <JDUIColorCategoryModule/UIColorAdditions.h>`
+- **[禁止]** 在代码中硬编码颜色值（如 `[UIColor colorWithRed:...]`）
+
+### 常用颜色清单
+
+**文本色**：
+```objective-c
+tdd_color_font_400  // #1A1A1A - 主要文本（标题、重要信息）
+tdd_color_font_300  // #666666 - 次要文本（正文、描述）
+tdd_color_font_200  // #999999 - 辅助文本（提示、说明）
+tdd_color_font_100  // #CCCCCC - 禁用文本
+```
+
+**品牌色**：
+```objective-c
+tdd_color_brand_normal  // #F82C45 - 品牌色（按钮、强调）
+tdd_color_brand_gradient_normal_1  // #FF4E63 - 渐变起点
+tdd_color_brand_gradient_normal_2  // #F82C45 - 渐变终点
+```
+
+**功能色**：
+```objective-c
+tdd_color_success_normal  // #00C38F - 成功提示
+tdd_color_error          // #F82C45 - 错误提示
+tdd_color_warning        // #DE851C - 警告提示
+tdd_color_nfos_normal    // #4D84FE - 信息提示
+```
+
+**填充色**：
+```objective-c
+tdd_color_fill_200  // #F4F6F6 - 页面背景
+tdd_color_fill_100  // #FAFAFA - 卡片背景
+tdd_color_white     // #FFFFFF - 白色
+```
+
+**线条色**：
+```objective-c
+tdd_color_line_100  // #F4F4F4 - 分割线
+tdd_color_line_200  // #EBEBEB - 边框
+```
+
+**黑色透明度**：
+```objective-c
+tdd_color_black_80  // 黑色 80% - 深色遮罩
+tdd_color_black_50  // 黑色 50% - 遮罩
+tdd_color_black_10  // 黑色 10% - 浅色遮罩
+```
+
+> 💡 **完整颜色清单**: 查看源码 `JDBMUIKitModule/ColorMacro.h`
+
+### 完整示例
+
+```objective-c
+// 引入头文件
+#import <JDBMUIKitModule/ColorMacro.h>
+#import <JDUIColorCategoryModule/UIColorAdditions.h>
+
+// ✅ 标准色：直接使用宏定义（已经是 UIColor 对象）
+_titleLabel.textColor = tdd_color_font_400;  // 主要文本色
+_descLabel.textColor = tdd_color_font_300;  // 次要文本色
+_hintLabel.textColor = tdd_color_font_200;  // 辅助文本色
+_brandButton.backgroundColor = tdd_color_brand_normal;  // 品牌色
+
+// ✅ 非标色：使用 UIColor (JDCategory) 扩展
+_customView.backgroundColor = [UIColor colorWithHex:@"#F5A623"];  // 设计稿中的非标准色
+
+// ✅ 需要透明度：使用 UIColor (JDCategory) 扩展
+_maskView.backgroundColor = [UIColor colorWithHex:@"#000000" alpha:0.5];
+
+// ✅ 使用颜色工具宏（BMColor 是 ColorMacro.h 中定义的宏）
+_anotherView.backgroundColor = BMColor(@"#F82C45");
+
+// ❌ 禁止：硬编码颜色值
+_label.textColor = [UIColor colorWithRed:26/255.0 green:26/255.0 blue:26/255.0 alpha:1.0];
+```
+
+### 渐变色使用
+
+```objective-c
+// 引入头文件
+#import <JDBMUIKitModule/ColorMacro.h>
+
+// 品牌渐变按钮（tdd_color_xxx 已经是 UIColor 对象）
+CAGradientLayer *gradientLayer = [CAGradientLayer layer];
+gradientLayer.colors = @[
+    (__bridge id)tdd_color_brand_gradient_normal_1.CGColor,
+    (__bridge id)tdd_color_brand_gradient_normal_2.CGColor
+];
+gradientLayer.startPoint = CGPointMake(0, 0);
+gradientLayer.endPoint = CGPointMake(1, 0);
+gradientLayer.frame = button.bounds;
+[button.layer insertSublayer:gradientLayer atIndex:0];
+```
+
+
+
+---
+
+## 字体使用规范
+
+### 基本规范
+
+**字体使用原则**：
+- **标准字号使用宏定义**：优先使用 `FontMacro.h` 中定义的 `tdd_font_size_x` 宏
+- **非标字号使用扩展类**：设计稿中的非标准字号使用 `UIFont (BMFont)` 扩展
+
+**具体规范**：
+- **[必须]** 标准字号必须使用 `FontMacro.h` 中定义的常量
+- **[必须]** 引入头文件 `#import <JDBMUIKitModule/FontMacro.h>`
+- **[必须]** 使用 `UIFont (BMFont)` 扩展设置字体（支持字重）
+- **[必须]** 引入头文件 `#import <JDBMUIKitModule/UIFont+BMFont.h>`
+- **[建议]** 使用 `BMFont(x)` 宏快速创建字体（默认 Regular 字重）
+- **[建议]** 使用适配宏（`tdd_font_size_x_adapter`）以支持不同屏幕尺寸
+- **[禁止]** 在代码中硬编码字体大小（如 `[UIFont systemFontOfSize:16]`）
+
+### 常用字体大小清单
+
+```objective-c
+tdd_font_size_1  // 30pt - 超大标题
+tdd_font_size_2  // 24pt - 大标题
+tdd_font_size_3  // 20pt - 中标题
+tdd_font_size_4  // 18pt - 小标题
+tdd_font_size_5  // 16pt - 正文
+tdd_font_size_6  // 14pt - 辅助文字
+tdd_font_size_7  // 12pt - 小字
+tdd_font_size_8  // 10pt - 极小字
+```
+
+**适配宏（支持不同屏幕尺寸）**：
+```objective-c
+tdd_font_size_1_adapter  // 30pt * 屏幕适配系数
+tdd_font_size_2_adapter  // 24pt * 屏幕适配系数
+tdd_font_size_5_adapter  // 16pt * 屏幕适配系数
+// ... 其他适配宏
+```
+
+> 💡 **完整字体清单**: 查看源码 `JDBMUIKitModule/FontMacro.h`
+
+### 完整示例
+
+```objective-c
+// 引入头文件
+#import <JDBMUIKitModule/FontMacro.h>
+#import <JDBMUIKitModule/UIFont+BMFont.h>
+
+// ✅ 标准字号：使用 BMFont 宏（推荐，默认 Regular 字重）
+_label.font = BMFont(tdd_font_size_5);  // 16pt 正文
+
+// ✅ 标准字号 + 指定字重
+_titleLabel.font = [UIFont bm_fontWithType:BMFontTypePFSCSemibold size:tdd_font_size_2];  // 24pt 半粗体
+_subtitleLabel.font = [UIFont bm_fontWithType:BMFontTypePFSCMedium size:tdd_font_size_4];  // 18pt 中等字重
+_bodyLabel.font = [UIFont bm_fontWithType:BMFontTypePFSCRegular size:tdd_font_size_5];  // 16pt 正文
+
+// ✅ 标准字号：使用适配宏（支持不同屏幕尺寸）
+_adaptiveLabel.font = BMFont(tdd_font_size_5_adapter);
+
+// ✅ 非标字号：使用 UIFont (BMFont) 扩展
+_customLabel.font = [UIFont bm_fontWithType:BMFontTypePFSCRegular size:15];  // 设计稿中的非标准字号
+_customBoldLabel.font = [UIFont bm_fontWithType:BMFontTypePFSCSemibold size:15];  // 非标字号 + 半粗体
+
+// ✅ 非标字号：使用自适应字体
+_adaptiveCustomLabel.font = [UIFont bm_fontWithType:BMFontTypePFSCRegular adapterSize:15];
+
+// ❌ 禁止：硬编码字体大小
+_label.font = [UIFont systemFontOfSize:16];
+```
+
+> 💡 **完整字体类型**: 参考 `../4-library/category_library.md`
+
+---
+
+## 间距使用规范
+
+### 基本规范
+
+- **[必须]** 间距遵循 8pt 网格系统
+- **[必须]** 引入头文件 `#import <JDBMUIKitModule/RadiusMacro.h>`
+- **[建议]** 使用 `space_x` 宏定义楼层卡片间隔
+- **[建议]** 其他间距使用 8 的倍数（8、16、24、32）
+
+### 常用间距清单
+
+```objective-c
+space_1  // 0pt - 无间隔
+space_2  // 8pt - 小间距（楼层卡片间隔）
+space_3  // 8pt - 小间距
+```
+
+**标准间距值**（8pt 网格系统）：
+```objective-c
+4pt   // 元素内部微调
+8pt   // 相关元素之间（小间距）
+16pt  // 组件之间（中间距）
+24pt  // 区块之间（大间距）
+32pt  // 页面区域之间（超大间距）
+```
+
+> 💡 **完整间距清单**: 查看源码 `JDBMUIKitModule/RadiusMacro.h`
+
+### 完整示例
+
+```objective-c
+// 引入头文件
+#import <JDBMUIKitModule/RadiusMacro.h>
+
+// ✅ 推荐：使用间距常量
+[view mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.top.equalTo(superview).offset(space_2);  // 8pt
+    make.left.equalTo(superview).offset(16);  // 页面边距
+    make.right.equalTo(superview).offset(-16);
+}];
+
+// ✅ 推荐：使用 8 的倍数
+[cardView mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.top.equalTo(titleLabel.mas_bottom).offset(24);  // 大间距
+    make.left.right.equalTo(self.view).inset(16);  // 页面边距
+}];
+
+// ❌ 禁止：使用非 8 的倍数
+[view mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.top.equalTo(superview).offset(15);  // 不符合 8pt 网格
+}];
+```
+
+
+
+
+
+---
+
+## 圆角使用规范
+
+### 基本规范
+
+- **[必须]** 所有圆角必须使用 `RadiusMacro.h` 中定义的常量
+- **[必须]** 引入头文件 `#import <JDBMUIKitModule/RadiusMacro.h>`
+- **[建议]** 根据元素大小选择合适的圆角
+
+### 常用圆角清单
+
+```objective-c
+tdd_border_radius_2   // 4pt - 小按钮、标签
+tdd_border_radius_5   // 8pt - 中按钮、输入框、卡片
+tdd_border_radius_10  // 6pt - 大卡片
+```
+
+> 💡 **完整圆角清单**: 查看源码 `JDBMUIKitModule/RadiusMacro.h`
+
+### 完整示例
+
+```objective-c
+// 引入头文件
+#import <JDBMUIKitModule/RadiusMacro.h>
+
+// ✅ 推荐：使用圆角常量
+view.layer.cornerRadius = tdd_border_radius_5;  // 8pt
+view.layer.masksToBounds = YES;
+
+// ✅ 推荐：圆形按钮
+button.layer.cornerRadius = button.frame.size.width / 2.0f;
+button.layer.masksToBounds = YES;
+
+// ❌ 禁止：硬编码圆角值
+view.layer.cornerRadius = 8.0f;
+```
+
+
+
+---
+
+## 安全区域使用规范
+
+### 基本规范
+
+- **[必须]** 使用 `SizeMacro.h` 中定义的安全区域常量
+- **[必须]** 引入头文件 `#import <JDBMUIKitModule/SizeMacro.h>`
+- **[必须]** 适配全面屏和非全面屏
+
+### 常用安全区域清单
+
+```objective-c
+kIsIphoneX_or_later   // 判断是否是全面屏
+kBottom_SafeHeight    // 底部安全区域高度（全面屏: 34, 非全面屏: 0）
+kNavStatusBarHeight   // 导航栏+状态栏高度（全面屏: 88, 非全面屏: 64）
+kStatusBarHeight      // 状态栏高度（全面屏: 44, 非全面屏: 20）
+```
+
+> 💡 **完整尺寸清单**: 查看源码 `JDBMUIKitModule/SizeMacro.h`
+
+### 完整示例
+
+```objective-c
+// 引入头文件
+#import <JDBMUIKitModule/SizeMacro.h>
+
+// ✅ 推荐：使用安全区域常量
+[view mas_makeConstraints:^(MASConstraintMaker *make) {
+    make.top.equalTo(superview).offset(kNavStatusBarHeight);  // 导航栏高度
+    make.bottom.equalTo(superview).offset(-kBottom_SafeHeight);  // 底部安全区域
+}];
+
+// ✅ 推荐：判断是否是全面屏
+if (kIsIphoneX_or_later) {
+    // 全面屏特殊处理
+}
+```
+
+
+
+---
+
+## 价格使用规范
+
+### 基本规范
+
+- **[必须]** 所有价格显示必须使用 `PriceMacro.h` 中定义的宏
+- **[必须]** 引入头文件 `#import <JDBMUIKitModule/PriceMacro.h>`
+- **[建议]** 根据场景选择合适的价格梯度
+
+### 常用价格梯度清单
+
+```objective-c
+tdd_price_1(price)  // 优惠券（字号：18 + 30 + 18）
+tdd_price_2(price)  // 商详主页（字号：14 + 20 + 20）
+tdd_price_3(price)  // 结算页底部（字号：14 + 24 + 14）
+tdd_price_4(price)  // 商详浮层（字号：12 + 16 + 16）
+tdd_price_5(price)  // 常用价格、搜索、购物车（字号：12 + 18 + 12）
+tdd_price_6(price)  // 订单、结算（字号：14 + 14 + 14）
+tdd_price_7(price)  // 促销场景（字号：12 + 12 + 12）
+```
+
+> 💡 **完整价格清单**: 查看源码 `JDBMUIKitModule/PriceMacro.h`
+
+### 完整示例
+
+```objective-c
+// 引入头文件
+#import <JDBMUIKitModule/PriceMacro.h>
+
+// ✅ 推荐：使用价格宏
+UILabel *priceLabel = tdd_price_5(@"99.00");  // 常用价格样式
+[self.view addSubview:priceLabel];
+
+// ✅ 推荐：设置价格颜色
+priceLabel.textColor = tdd_color_brand_normal;
+```
+
+
+
+
+
+

package/.kiro/steering/bmall/iOS/1-foundation/naming_rules.md

@@ -0,0 +1,156 @@
+---
+inclusion: manual
+---
+# iOS 命名规范
+
+> **说明**: 定义类、方法、变量、常量的命名规则  
+> **项目前缀**: 参考 `../4-library/project_structure.md`
+
+---
+
+## 通用规则
+
+- **[必须]** 使用清晰、描述性的名称
+- **[必须]** 所有命名使用英文
+- **[必须]** 避免使用系统保留词
+
+---
+
+## 类命名
+
+### 基本规范
+
+- **[必须]** 使用大驼峰命名法（UpperCamelCase）
+- **[必须]** 使用项目前缀（BM、JDBM）
+- **[必须]** 文件名与类名完全一致
+- **[必须]** 一个文件只包含一个类
+
+### 示例
+
+```objective-c
+// ✅ 正确
+BMUser                  // 用户模型
+BMLoginViewController   // 登录控制器
+BMUserViewModel         // 用户视图模型
+
+// ❌ 错误
+User                    // 缺少前缀
+BMLoginVC               // 使用缩写
+```
+
+### 协议命名
+
+```objective-c
+// ✅ 正确
+BMUserDelegate          // 代理协议
+BMCacheProtocol         // 通用协议
+```
+
+---
+
+## 方法命名
+
+### 基本规范
+
+- **[必须]** 使用小驼峰命名法（lowerCamelCase）
+- **[必须]** 方法名是动词或动词短语
+- **[必须]** 布尔方法以 `is`、`has`、`can`、`should` 开头
+- **[必须]** 初始化方法以 `init` 开头
+
+### 示例
+
+```objective-c
+// ✅ 正确
+- (void)fetchUserDataWithID:(NSString *)userID;
+- (BOOL)isSelected;
+- (void)setupViews;
+
+// ❌ 错误
+- (void)getData;        // 不够具体
+- (BOOL)selected;       // 布尔方法缺少 is 前缀
+```
+
+---
+
+## 变量与属性命名
+
+### 基本规范
+
+- **[必须]** 使用小驼峰命名法
+- **[必须]** 布尔属性使用 `is`、`has`、`should` 前缀
+- **[必须]** 私有实例变量使用下划线前缀
+- **[必须]** 代理属性命名为 `delegate`
+
+### 示例
+
+```objective-c
+// ✅ 正确
+@property (nonatomic, strong) NSString *title;
+@property (nonatomic, assign) BOOL isSelected;
+@property (nonatomic, weak) id<BMViewDelegate> delegate;
+NSMutableArray *_privateItems;  // 私有变量
+
+// ❌ 错误
+@property (nonatomic, strong) NSString *titleString;  // 包含类型信息
+@property (nonatomic, assign) BOOL selected;          // 缺少 is 前缀
+UIButton *btn;                                        // 使用缩写
+```
+
+---
+
+## 常量与枚举命名
+
+### 常量命名
+
+```objective-c
+// ✅ 正确
+static NSString * const kBMDefaultUsername = @"guest";
+static CGFloat const kBMDefaultPadding = 10.0f;
+
+// ❌ 错误
+#define DefaultUsername @"guest"  // 应使用常量
+static NSString * const kDefaultUsername = @"guest";  // 缺少前缀
+```
+
+### 枚举命名
+
+```objective-c
+// ✅ 正确
+typedef NS_ENUM(NSInteger, BMUserType) {
+    BMUserTypeRegular,
+    BMUserTypePremium,
+    BMUserTypeAdmin
+};
+
+// ❌ 错误
+typedef enum {
+    Regular,    // 缺少前缀
+    Premium
+} UserType;     // 应使用 NS_ENUM
+```
+
+---
+
+## 通知命名
+
+```objective-c
+// ✅ 正确
+static NSString * const BMUserDidLoginNotification = @"BMUserDidLoginNotification";
+
+// ❌ 错误
+static NSString * const UserLoggedIn = @"UserLoggedIn";  // 缺少前缀
+```
+
+---
+
+## 图片资源命名
+
+```
+// ✅ 正确
+bm_login_button_normal.png
+bm_icon_settings.png
+
+// ❌ 错误
+loginBtn.png          // 缺少前缀
+BMLoginButton.png     // 使用大写
+```