bmall-mcp 1.0.0 → 1.0.2

package/.kiro/steering/bmall/Web/README.md

@@ -0,0 +1,20 @@
+# Web 开发规范
+
+本目录包含Web开发相关的规范和最佳实践。
+
+## 目录
+
+- [编码规范](./coding_guidelines.md) - HTML、CSS 和 JavaScript 编码规范
+- [框架规范](./framework_guidelines.md) - React、Vue、Angular等框架使用规范
+- [架构规范](./architecture_guidelines.md) - 前端架构规范
+- [UI规范](./ui_guidelines.md) - UI设计和实现规范
+- [性能优化](./performance_guidelines.md) - 性能优化最佳实践
+- [安全规范](./security_guidelines.md) - 安全相关最佳实践
+- [可访问性](./accessibility_guidelines.md) - Web可访问性规范
+
+## 相关资源
+
+- [MDN Web 文档](https://developer.mozilla.org/zh-CN/)
+- [W3C 标准](https://www.w3.org/standards/)
+- [Web.dev](https://web.dev/) - 现代Web开发指南
+- [Lighthouse](https://developers.google.com/web/tools/lighthouse) - 网站性能分析工具 

package/.kiro/steering/bmall/iOS/README.md

@@ -0,0 +1,273 @@
+# iOS AI 辅助开发规范体系
+
+> **版本**: v2.1  
+> **更新日期**: 2025-11-28  
+> **目的**: 为 AI 辅助开发提供完整的规范体系
+
+---
+
+## 📋 快速导航
+
+- **AI 入口**: [ai_workflow.md](ai_workflow.md) - AI 工作流程导航
+- **设计阶段**: [tech_design_workflow.md](tech_design_workflow.md) - 生成技术设计文档
+- **编码阶段**: [coding_rules_index.md](coding_rules_index.md) - 生成代码
+- **流程审计**: [WORKFLOW_AUDIT.md](WORKFLOW_AUDIT.md) - 流程完整性检查
+
+---
+
+## 🎯 体系概述
+
+### 什么是这个规范体系
+
+这是一套**专为 AI 设计的开发规范文档集合**，用于：
+
+1. **指导 AI 生成代码** - 从 PRD 到代码的完整流程
+2. **统一代码标准** - 确保生成的代码符合团队规范
+3. **提升开发效率** - 自动化需求分析和代码生成
+4. **保证代码质量** - 通过规范约束避免常见错误
+
+### 核心设计原则
+
+- **流程化** - 明确的阶段划分（设计 → 编码）
+- **模板化** - 提供完整的代码模板
+- **场景化** - 根据编码场景选择规范
+- **精简化** - 只保留 AI 需要的核心信息
+
+---
+
+## 📂 完整工作流程
+
+```
+PRD + 设计稿 + 接口文档
+    ↓
+ai_workflow.md (入口导航)
+    ↓
+设计阶段 (tech_design_workflow.md)
+    ├─ 1. 读取输入材料
+    ├─ 2. 生成 requirements.md (等待用户确认)
+    ├─ 3. 检查现有代码
+    ├─ 4. 输出改动范围确认 (等待用户确认)
+    ├─ 5-7. 提取信息、规划架构
+    └─ 8. 生成 design.md
+    ↓
+编码阶段 (coding_rules_index.md)
+    ├─ 1. 读取 design.md
+    ├─ 2. 按顺序生成代码
+    │   ├─ 公共 Model/API/View
+    │   ├─ 页面 Model/API
+    │   └─ 页面 View/ViewModel/Controller
+    └─ 3. 根据场景选择规范
+    ↓
+代码文件 (.h/.m)
+```
+
+---
+
+## 📁 目录结构
+
+```
+.kiro/steering/iOS/
+│
+├── README.md                    # 本文档（给人看）
+├── ai_workflow.md               # AI 入口（给 AI 看）
+├── tech_design_workflow.md      # 设计阶段指南
+├── coding_rules_index.md        # 编码阶段指南
+├── WORKFLOW_AUDIT.md            # 流程审计报告
+│
+├── architecture/                # 架构规范
+│   └── objc_mvvm_rules.md      # MVVM 架构
+│
+├── coding/                      # 编码规范
+│   ├── naming_rules.md         # 命名规范
+│   ├── style_rules.md          # 代码风格
+│   ├── safety_rules.md         # 安全规范
+│   ├── view_rules.md           # View 层规范
+│   ├── controller_rules.md     # Controller 层规范
+│   ├── viewmodel_rules.md      # ViewModel 层规范
+│   ├── model_rules.md          # Model 层规范
+│   ├── network_rules.md        # 网络层规范
+│   ├── design_rules.md         # 设计规范
+│   ├── component_rules.md      # 组件使用规范
+│   └── third_party_rules.md    # 第三方库规范
+│
+├── library/                     # 基础规范
+│   ├── project_structure.md    # 项目结构
+│   ├── component_library.md    # 组件库清单
+│   ├── utils_library.md        # 工具类清单
+│   └── category_library.md     # Category 扩展清单
+│
+├── templates/                   # 代码模板
+│   ├── requirements_template.md      # Requirements 模板
+│   ├── change_scope_template.md      # 改动范围确认模板
+│   ├── tech_design_template.md       # 技术设计文档模板
+│   ├── view_template.md              # View 层代码模板
+│   ├── controller_template.md        # Controller 层代码模板
+│   └── viewmodel_template.md         # ViewModel 层代码模板
+│
+└── tools/                       # 工具指南
+    └── input_processing.md     # 输入材料处理指南
+```
+
+---
+
+## 🚀 快速开始
+
+### 对于 AI
+
+1. 读取 [ai_workflow.md](ai_workflow.md) 了解全局流程
+2. 根据阶段读取对应指南：
+   - 设计阶段 → [tech_design_workflow.md](tech_design_workflow.md)
+   - 编码阶段 → [coding_rules_index.md](coding_rules_index.md)
+3. 根据场景选择具体规范
+
+### 对于开发者
+
+1. 阅读本文档了解体系结构
+2. 查看 [WORKFLOW_AUDIT.md](WORKFLOW_AUDIT.md) 了解流程完整性
+3. 根据需要查阅具体规范文档
+
+---
+
+## 📊 关键文档说明
+
+### 核心流程文档
+
+| 文档 | 作用 | 读者 |
+|------|------|------|
+| ai_workflow.md | 全局流程导航 | AI |
+| tech_design_workflow.md | 设计阶段详细指南 | AI |
+| coding_rules_index.md | 编码阶段详细指南 | AI |
+| WORKFLOW_AUDIT.md | 流程完整性审计 | 人类 |
+
+### 模板文档
+
+| 文档 | 作用 |
+|------|------|
+| requirements_template.md | 生成需求文档 |
+| change_scope_template.md | 确认改动范围 |
+| tech_design_template.md | 生成技术设计文档 |
+| view_template.md | 生成 View 代码 |
+| controller_template.md | 生成 Controller 代码 |
+| viewmodel_template.md | 生成 ViewModel 代码 |
+
+### 规范文档
+
+**架构规范**：
+- objc_mvvm_rules.md - MVVM 架构规范
+
+**编码规范**（11个）：
+- naming_rules.md - 命名规范
+- style_rules.md - 代码风格
+- safety_rules.md - 安全规范
+- view_rules.md - View 层规范
+- controller_rules.md - Controller 层规范
+- viewmodel_rules.md - ViewModel 层规范
+- model_rules.md - Model 层规范
+- network_rules.md - 网络层规范
+- design_rules.md - 设计规范
+- component_rules.md - 组件使用规范
+- third_party_rules.md - 第三方库规范
+
+**基础规范**（4个）：
+- project_structure.md - 项目结构
+- component_library.md - 组件库清单
+- utils_library.md - 工具类清单
+- category_library.md - Category 扩展清单
+
+---
+
+## 🔄 维护规范
+
+### 更新频率
+
+| 文档类型 | 更新频率 | 触发条件 |
+|---------|---------|---------|
+| 核心流程文档 | 每月 | 流程优化 |
+| 规范文档 | 每月 | 规范调整 |
+| 模板文档 | 持续 | 模板优化 |
+
+### 更新流程
+
+1. 发现问题或改进点
+2. 讨论方案
+3. 更新文档
+4. 更新版本号
+5. 通知团队
+
+### 版本管理
+
+**版本号规则**：`主版本.次版本.修订版本`
+
+- **主版本**：架构性变更
+- **次版本**：功能性变更
+- **修订版本**：内容优化
+
+**当前版本**：v2.1
+
+---
+
+## 📈 版本历史
+
+### v2.1 (2025-11-28)
+
+**优化**：
+- ✅ 重命名 `ios_rules_index.md` → `coding_rules_index.md`
+- ✅ 重命名 `scope_and_tech_stack_template.md` → `change_scope_template.md`
+- ✅ 在 `coding_rules_index.md` 增加操作步骤
+- ✅ 精简所有文档，删除冗余内容
+- ✅ 创建 `WORKFLOW_AUDIT.md` 流程审计报告
+
+### v2.0 (2025-11-27)
+
+**重构**：
+- ✅ 大幅精简所有规范文档
+- ✅ 优化文档结构
+- ✅ 增加模板文档
+
+### v1.0 (2025-11-27)
+
+**初始版本**：
+- ✅ 创建基础规范体系
+
+---
+
+## 💡 使用建议
+
+### 对于 AI
+
+1. **始终从 ai_workflow.md 开始**
+2. **严格遵循流程**（设计 → 编码）
+3. **等待用户确认**（requirements.md 和改动范围）
+4. **根据场景选择规范**（不要全部读取）
+
+### 对于开发者
+
+1. **理解整体流程**（阅读本文档）
+2. **查看流程审计**（WORKFLOW_AUDIT.md）
+3. **按需查阅规范**（不需要全部阅读）
+4. **及时反馈问题**（帮助优化规范）
+
+---
+
+## 📞 联系方式
+
+- **技术负责人**: [崔宝印]
+- **规范维护**: [崔宝印]
+- **问题反馈**: [崔宝印]
+
+---
+
+## 📝 总结
+
+这是一套**专为 AI 设计的完整开发规范体系**，包含：
+
+- ✅ 2 个核心流程文档（设计 + 编码）
+- ✅ 6 个模板文档
+- ✅ 16 个规范文档
+- ✅ 1 个流程审计报告
+
+**目标**：让 AI 能够从 PRD 到代码的完整自动化开发。
+
+**现状**：流程完整性 100%，可执行性 100%。
+
+**下一步**：根据实际使用情况持续优化。

package/.kiro/steering/bmall/iOS/ai_workflow.md

@@ -0,0 +1,53 @@
+# AI 辅助开发工作流
+
+> **说明**: 从需求到代码的完整流程导航
+
+---
+
+## 完整流程
+
+```
+PRD + 设计稿 + 接口文档
+    ↓
+设计阶段 (tech_design_workflow.md)
+    ├─ 生成 requirements.md
+    ├─ 检查现有代码
+    ├─ 输出改动范围确认
+    └─ 生成 design.md
+    ↓
+编码阶段 (coding_rules_index.md)
+    ├─ 生成 Model/API
+    ├─ 生成 View/ViewModel
+    └─ 生成 Controller
+    ↓
+代码文件 (.h/.m)
+```
+
+---
+
+## 阶段 1：设计阶段
+
+**详细指南**：[tech_design_workflow.md](mdc:tech_design_workflow.md)
+
+**输入**：PRD + 设计稿 + 接口文档  
+**输出**：requirements.md + design.md
+
+---
+
+## 阶段 2：编码阶段
+
+**详细指南**：[coding_rules_index.md](mdc:coding_rules_index.md)
+
+**输入**：design.md  
+**输出**：代码文件 (.h/.m)
+
+**生成顺序**：Model/API → View/ViewModel → Controller
+
+---
+
+## 关键原则
+
+- 先复用，后实现
+- 遵循 MVVM 架构
+- 使用设计规范宏定义
+- 使用 JDUtils 验证数据

package/.kiro/steering/bmall/iOS/architecture/objc_mvvm_rules.md

@@ -0,0 +1,98 @@
+---
+inclusion: always
+---
+# Objective-C MVVM 架构规范
+
+> **说明**: 定义 MVVM 架构的核心准则
+
+---
+
+## MVVM 架构层次
+
+- **Model**: 数据模型（数据结构、业务规则）
+- **View**: 视图组件（UI 展示）
+- **ViewController**: 控制器（生命周期管理、用户交互）
+- **ViewModel**: 视图模型（业务逻辑、数据处理）
+- **Net**: 网络层（API 接口封装）
+
+---
+
+## 分层职责
+
+### Model 层
+
+- **[必须]** 只包含数据结构和基本验证逻辑
+- **[必须]** 不依赖其他层
+
+### View 层
+
+- **[必须]** 只负责 UI 展示，不包含业务逻辑
+- **[必须]** 包含两个标准方法：`setupViews`、`setupConstraints`
+- **[必须]** 通过代理模式与控制器通信
+
+### ViewController 层
+
+- **[必须]** 管理视图生命周期和用户交互
+- **[必须]** 不包含业务逻辑
+- **[必须]** 包含三个标准方法：`setupViews`、`setupConstraints`、`bindViewModel`
+
+### ViewModel 层
+
+- **[必须]** 处理业务逻辑并为视图提供数据
+- **[必须]** 不依赖 UIKit 框架
+- **[必须]** 通过 Block 回调与控制器通信
+- **[必须]** 调用 Net 层获取数据
+
+### Net 层
+
+- **[必须]** 封装服务端接口调用
+- **[必须]** 一个接口对应一个 API 类
+- **[详细规范]** 参考 `network_rules.md`
+
+---
+
+## 层间通信
+
+### View → ViewController（代理模式）
+
+```objective-c
+@protocol BMCustomViewDelegate <NSObject>
+- (void)customView:(BMCustomView *)view didTapButton:(UIButton *)button;
+@end
+```
+
+### ViewController → ViewModel（直接调用）
+
+```objective-c
+[self.viewModel fetchData];
+```
+
+### ViewModel → ViewController（Block 回调）
+
+```objective-c
+// ViewModel 中定义
+@property (nonatomic, copy) void (^dataUpdatedBlock)(void);
+@property (nonatomic, copy) void (^errorBlock)(NSString *errorMessage);
+
+// ViewController 中设置
+WEAK_SELF
+self.viewModel.dataUpdatedBlock = ^{
+    STRONG_SELF
+    [strongSelf.tableView reloadData];
+};
+```
+
+### ViewModel → Net（直接调用）
+
+```objective-c
+// ViewModel 中调用 API
+[AIFloatingApi requestEntryConfigWithCompleteBlock:^(NSDictionary *dictionary, NSError *error) {
+    if (error) {
+        // 处理错误
+        return;
+    }
+    // 处理数据
+}];
+```
+
+

package/.kiro/steering/bmall/iOS/coding/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/coding/controller_rules.md

@@ -0,0 +1,105 @@
+---
+inclusion: manual
+---
+# iOS 控制器实现规范
+
+> **说明**: 定义控制器的实现规范（MVVM 架构）  
+> **架构规范**: 参考 `architecture/objc_mvvm_rules.md`
+
+---
+
+## 控制器基本结构
+
+### 基本规范
+
+- **[必须]** 控制器实现三个标准方法：`setupViews`、`setupConstraints`、`bindViewModel`
+- **[必须]** 业务逻辑放在 ViewModel 中
+- **[必须]** 使用 Block 回调进行数据绑定
+- **[必须]** 使用 `WEAK_SELF` 和 `STRONG_SELF` 避免循环引用
+
+### 示例
+
+```objective-c
+@interface BMViewController ()
+@property (nonatomic, strong) BMViewModel *viewModel;
+@property (nonatomic, strong) UITableView *tableView;
+@end
+
+@implementation BMViewController
+
+- (void)viewDidLoad {
+    [super viewDidLoad];
+    [self setupViews];
+    [self setupConstraints];
+    [self bindViewModel];
+}
+
+#pragma mark - Setup Methods
+
+- (void)setupViews {
+    self.view.backgroundColor = tdd_color_fill_200;
+    [self.view addSubview:self.tableView];
+}
+
+- (void)setupConstraints {
+    [self.tableView mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.edges.equalTo(self.view);
+    }];
+}
+
+- (void)bindViewModel {
+    WEAK_SELF
+    
+    // 数据更新回调
+    self.viewModel.dataUpdatedBlock = ^{
+        STRONG_SELF
+        [strongSelf.tableView reloadData];
+    };
+    
+    // 加载状态回调
+    self.viewModel.loadingBlock = ^(BOOL isLoading) {
+        STRONG_SELF
+        if (isLoading) {
+            [JDBMToastView showLoading];
+        } else {
+            [JDBMToastView dismiss];
+        }
+    };
+    
+    // 错误处理回调
+    self.viewModel.errorBlock = ^(NSString *errorMessage) {
+        STRONG_SELF
+        [JDBMToastView showWithMessage:errorMessage 
+                             toastType:JDBMToastViewTypeError 
+                          positionType:JDBMToastViewPositionTypeCenter];
+    };
+    
+    // 加载数据
+    [self.viewModel fetchData];
+}
+
+@end
+```
+
+---
+
+## 事件处理
+
+### 通过 ViewModel 处理
+
+```objective-c
+// ✅ 推荐：通过 ViewModel 处理业务逻辑
+- (void)loginButtonTapped {
+    [self.viewModel loginWithUsername:self.usernameTextField.text
+                             password:self.passwordTextField.text];
+}
+
+// ❌ 错误：控制器直接处理业务逻辑
+- (void)wrongLoginButtonTapped {
+    if (self.usernameTextField.text.length == 0) {
+        [self showAlertWithMessage:@"请输入用户名"];
+        return;
+    }
+    // 直接发起网络请求...
+}
+```