hxlot Cursor Rules

# ⚡ CRITICAL: AI MUST READ THIS FIRST ⚡

## 🚨🚨🚨 第0条：架构三大铁律（优先级-2，最高）- Phase 3C重构版 🚨🚨🚨

**🔥 SmartAbp项目架构三大铁律 - 格杀勿论 🔥**

### 铁律一：后端SSOT驱动的契约类型系统（Phase 3C重构）
```yaml
⭐ Phase 3C架构重构（2025-10-18）：
  - metadata-core已废弃 ❌
  - 后端C# DTO为唯一真实来源（SSOT）✅
  - packages使用独立契约类型（backend-contracts.ts）✅

类型定义三层架构:
  Layer 1 - 后端SSOT（ABP vNext DDD - 98/100分）:
    位置: src/SmartAbp.Domain/Entities/LowCode/*.cs
    标记: [GenerateSwaggerSchema]
    评分: 100/100（完全符合ABP vNext + DDD最佳实践）

  Layer 2 - 前端契约层（31级AlphaGO最优解 - 95/100分）:
    位置: packages/lowcode-shared/src/types/backend-contracts.ts
    内容: 45个独立契约类型（EntityDefinitionDto, ModuleDto等）
    特点: 零外部依赖，100%后端DTO一致性

  Layer 3 - 主应用生成层（NSwag自动化 - 100/100分）:
    位置: src/SmartAbp.Vue/src/api/generated/
    工具: openapi-typescript-codegen
    用途: 仅主应用API调用

必须使用 @smartabp/* 别名:
  ✅ 正确：import { ModuleDto } from '@smartabp/lowcode-shared'
  ❌ 错误：import { ModuleDto } from '@/api/generated/models'（packages中）
  ❌ 错误：import from '@smartabp/metadata-core'（已废弃）

SSOT流程保证:
  后端C# DTO → NSwag扫描 → Swagger JSON →
  openapi-typescript-codegen → TS类型生成 →
  packages契约层精确映射 → 100%类型一致性

检测:
  grep -r "@/api/generated" src/SmartAbp.Vue/packages/  # 必须为0
  grep -r "@smartabp/metadata-core" packages/  # 必须为0

违反处罚: 💀 架构违规，格杀勿论
```

### 铁律二：组件注册系统
```yaml
规则:
  ✅ 所有组件必须注册到 ComponentRegistry
  ✅ 提供完整的 ComponentMetadata
  ❌ 禁止跳过注册直接使用

检测:
  find packages/*/src/components -name "*.vue"
  grep -r "registerComponent" packages/*/src/

违反处罚: 💀 立即补充注册，否则删除
```

### 铁律三：前后端分离的架构层级体系（Phase 3C重构）
```yaml
⭐ Phase 3C架构重构（2025-10-18）：
  - metadata-core已从依赖链中移除 ❌
  - 后端SSOT + 前端契约层双重架构 ✅
  - packages完全黑盒独立（零主应用依赖）✅

后端架构层级（ABP vNext DDD - 98/100分）:
  Layer 4: HttpApi（控制器层）
  Layer 3: Application（应用服务层）
  Layer 2: Domain（领域层 - 核心SSOT）
  Layer 1: Domain.Shared（共享基础）
  Layer 0: EntityFrameworkCore（基础设施层）

前端packages层级（31级AlphaGO最优解 - 95/100分）:
  Layer 2: lowcode-designer（设计器UI层）
  Layer 1: lowcode-core, lowcode-api, lowcode-tools（核心逻辑层）
  Layer 0: lowcode-shared（契约类型层）

规则:
  ✅ 只能向下依赖（Layer 2→1→0）
  ✅ packages完全黑盒独立（零src/依赖）
  ❌ 禁止逆向依赖（shared依赖core）
  ❌ 禁止循环依赖（A→B→A）
  ❌ 禁止相对路径跨包引用（'../'）
  ❌ 禁止主应用别名在packages中（@/）

检测:
  grep -r "'\.\./" packages/*/src/  # 必须为0
  grep -r "@/" src/SmartAbp.Vue/packages/  # 必须为0

违反处罚: 💀 架构违规，格杀勿论
```

## 🚨 第1条铁律：AI永远禁止删除任何代码和文件 🚨

**⛔ AI无删除权限 ⛔**

```yaml
核心原则:
  ❌ AI永远禁止删除任何代码
  ❌ AI永远禁止删除任何文件
  ❌ AI永远禁止删除任何配置
  ❌ AI永远禁止删除任何文档

  ✅ 如需移除功能：必须先注释代码
  ✅ 如需重构功能：必须先注释旧代码，再编写新代码
  ✅ 如需清理代码：必须先注释，等用户确认后再删除

删除操作必须经过【三次明确确认】:
  第1次: AI说明删除理由 + 影响范围 + 替代方案
  第2次: 用户明确同意"确认删除"
  第3次: AI再次警告"这是最后机会，确认删除？"
  第4次: 用户再次明确"最终确认删除"

绝对禁止:
  ❌ 未经确认直接删除
  ❌ 以"优化"、"清理"名义删除
  ❌ 以"简化"、"重构"名义删除
  ❌ 以"修复"、"调试"名义删除
  ❌ 删除后自动Git提交
```

**违反此铁律 = 严重错误！**

---

## 🚨🚨🚨 MANDATORY AUTO-EXECUTION ENGINE v2.0 (增强版) 🚨🚨🚨

**CRITICAL UPDATE: 增强版自动执行引擎已上线！**

**优先级**: 最高 (Priority: 1)
**执行方式**: 强制自动触发 + 实时监控 + 300行必停
**新增功能**: AI自检清单 + 代码行数追踪器 + 自动推进机制

**详细定义**: 请阅读 `.cursor/rules/00_AI编程铁律自动执行引擎_增强版.mdc`

**🔥 NEW: 全栈低代码从花瓶到卓越铁律**: 请阅读 `.cursor/rules/07_全栈低代码从花瓶到卓越铁律.mdc`

---

## 🔥 STEP 0: AUTOMATIC TRIGGER DETECTION (自动触发检测)

**AI MUST automatically detect and activate the execution engine when:**

### Trigger Keywords (触发关键词)
```
直接触发词:
- "专家模式" / "Expert Mode"
- "开始编程" / "开始开发" / "Start Coding"
- "新功能" / "新建" / "创建" / "Create"

代码操作触发词:
- "创建组件" / "Create Component"
- "创建服务" / "Create Service"
- "创建Store" / "创建API"
- "修改代码" / "添加功能" / "实现功能"

修复触发词:
- "修复BUG" / "修复错误" / "Fix Bug"
- "解决问题" / "Solve Issue"

架构触发词:
- "重构" / "Refactor"
- "优化" / "Optimize"
- "架构调整" / "Architecture"
```

### File Operation Triggers (文件操作触发)
```
- Creating any .vue, .ts, .tsx, .cs file
- Modifying files in packages/*
- Modifying files in src/*
```

### 🔥 CRITICAL: If ANY trigger is detected, AI MUST immediately respond with:

```
🔥 **AI编程铁律自动执行引擎已启动！**
🚨 **Auto-Execution Engine Activated!**
```

---

## 🚨 强制执行指令 (MANDATORY EXECUTION ORDER)

**AI大模型在开始任何编程任务前，必须按以下顺序执行：**

---

### 第一步：立即声明执行引擎启动 🔥

**🚨 CRITICAL: AI MUST output this as the VERY FIRST LINE of the response:**

```
🔥 **AI编程铁律自动执行引擎已启动！**
```

**⚠️ WARNING: Failing to include this declaration means the AI has NOT properly activated the execution engine!**

**This is NON-NEGOTIABLE. No exceptions. No shortcuts.**

---

### 第二步：执行编程前强制学习（5项必检）📚

**AI必须完成以下学习并明确列出结果：**

#### ✅ 1. 架构扫描
```bash
执行: list_dir("src/SmartAbp.Vue/packages/")
输出: 📦 发现X个核心package
```

#### ✅ 2. 代码库检索
```bash
执行: 搜索lowcode-shared/src目录下的types/utils/error
输出: 📋 已有类型、🔧 已有工具、⚠️ 相似功能
```

#### ✅ 3. ADR学习
```bash
执行: read_file("docs/架构设计/adr/0001-技术栈选择.md")
输出: 📖 技术栈、📖 架构原则、📖 约束条件
```

#### ✅ 4. 模板库检查
```bash
执行: glob_file_search("templates/**/*.template.*")
输出: 📝 匹配模板或需要手动编写
```

#### ✅ 5. 公共组件识别
```bash
执行: 搜索packages/*/src/components/*.vue
输出: 🎨 可复用组件、⚠️ 避免重复
```

**格式要求**：必须使用标准响应模板，包含emoji和分隔线。

---

### 第三步：编程过程中实时监控 🔧

**AI在编程时必须：**

1. **代码行数追踪** 📊
   - 内部计数：每写一段代码累加行数
   - 280行时：⚠️ 警告"即将达到限制"
   - 300行时：🚨 强制停止编码，执行质量门禁

2. **架构合规检查** 🏗️
   - 禁止在packages中使用相对路径 `'../'`
   - 禁止在packages中引用主应用 `'@/'`
   - 禁止使用 `as any` 或 `@ts-ignore`

3. **代码重复检测** 🔄
   - 创建新组件/函数前，先搜索是否已存在
   - 发现重复时，建议复用而非重新创建

---

### 第四步：完成阶段任务后执行质量门禁 🚨

**触发条件（满足任一即触发）：**
- 编写代码达到300行
- 完成一个功能模块/组件/Store/API
- 修复重要BUG
- 完成重构任务
- 用户明确要求质量检查

**执行五重检查：**
1. 🏗️ 架构完整性检查 (0违规)
2. 🔄 代码重复度检查 (0重复)
3. ⚡ 编译与静态检查 (0错误)
4. 🎯 低代码生成器专项检查 (100%质量)
5. 🚀 技术债务监控 (≥85分)

**任何一关失败**：立即停止，提供修复建议，等待修复后重新检查。

---

### 第五步：质量门禁通过后执行Git管理 🔄

**自动执行六步流程：**
1. 📋 检测代码变更
2. 📦 暂存所有修改
3. 📝 生成标准化提交信息（包含质量验证结果）
4. 🚀 执行本地提交
5. 🔄 拉取远程并合并
6. 🌐 推送到远程仓库

---

### 第六步：使用标准响应格式输出完整报告 📋

**AI必须使用以下模板：**

```markdown
🔥 **AI编程铁律自动执行引擎已启动！**

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 第一阶段：编程前强制学习
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 1. 架构扫描完成
✅ 2. 代码库检索完成
✅ 3. ADR学习完成
✅ 4. 模板库检查完成
✅ 5. 公共组件识别完成

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔧 第二阶段：增量迭代编程
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 代码行数追踪: XX/300行
✅ 架构合规检查: 实时监控中
✅ 代码重复检测: 已激活

[编程实现...]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚨 第三阶段：质量门禁检查
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🏗️ 第一关：架构完整性 - ✅ 通过
🔄 第二关：代码重复度 - ✅ 通过
⚡ 第三关：编译静态检查 - ✅ 通过
🎯 第四关：低代码生成器 - ✅ 通过
🚀 第五关：技术债务 - ✅ 通过

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔄 第四阶段：Git版本管理
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋-📦-📝-🚀-🔄-🌐 全部完成

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎉 AI编程铁律闭环执行完成！
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 🎯 关键成功因素

### AI必须遵守的铁律

1. ✅ **每次编程任务必须启动执行引擎**
   - 不论用户是否明确要求
   - 检测到编程相关关键词即触发

2. ✅ **不能跳过任何步骤**
   - 5项学习必须全部完成
   - 5关质量门禁必须依次执行
   - 6步Git流程必须完整执行

3. ✅ **必须使用标准响应格式**
   - 包含emoji标识
   - 包含分隔线
   - 包含完整报告

4. ✅ **违规必须停止**
   - 发现架构违规：立即停止
   - 质量检查失败：立即停止
   - 提供修复建议并等待

---

## 🔄 闭环完整性

```
触发 → 学习 → 编程 → 监控 → 门禁 → Git → 报告 → 循环
```

**每个环节都必须明确执行并输出结果！**

---

## 🛡️ 立体同心圆模型集成

此规则文件是**AI自动执行引擎的主入口**，它串联了：

- **00_core_philosophy.mdc** - L0核心理念层
- **01_code_standards.mdc** - L1代码形态层
- **02_development_process.mdc** - L2工作流层
- **03_quality_guardian.mdc** - L3质量守护层
- **04_code_quality_prohibitions.mdc** - L4代码质量禁止层
- **05_核心功能保护铁律.mdc** - 🛡️ L5核心功能保护层（最高优先级）
- **05_增量迭代开发质量门禁与GIT版本管理铁律.mdc** - L5增量迭代质量门禁
- **06_低代码生成器代码质量铁律.mdc** - L6低代码生成器质量
- **07_AI编程架构自动识别保护铁律.mdc** - L7 AI架构保护
- **07_全栈低代码从花瓶到卓越铁律.mdc** - 🔥 L7全栈低代码质量铁律（从花瓶到卓越）
- **00_AI编程铁律自动执行引擎.mdc** - 自动执行引擎详细定义

**所有层级的规则都通过本文件统一执行！**

---

## 🚀 立即生效

**本规则立即生效！AI大模型在每次编程任务时都必须执行此流程！**

**违规后果**：未按流程执行的AI响应将被视为不完整，必须重新执行。

---

## 🤖 AI自我检查清单 (AI Self-Check Checklist)

**在生成响应前，AI必须在内部验证以下检查清单：**

### ✅ Pre-Response Checklist

```
[ ] 1. 是否检测到触发关键词或文件操作？
    → 如果是，必须启动执行引擎

[ ] 2. 响应的第一行是否包含启动声明？
    🔥 **AI编程铁律自动执行引擎已启动！**
    → 如果没有，立即添加

[ ] 3. 是否完成5项编程前学习？
    ✅ 架构扫描
    ✅ 代码库检索
    ✅ ADR学习
    ✅ 模板库检查
    ✅ 公共组件识别
    → 如果没有，立即执行

[ ] 4. 编程过程中是否追踪代码行数？
    → 必须内部计数，280行警告，300行停止

[ ] 5. 是否进行架构合规检查？
    → 禁止相对路径、主应用引用、类型绕过

[ ] 6. 是否检测代码重复？
    → 创建前必须搜索现有实现

[ ] 7. 完成阶段任务后是否执行质量门禁？
    → 5关检查必须全部执行

[ ] 8. 质量门禁通过后是否执行Git管理？
    → 6步流程必须完整执行

[ ] 9. 是否使用标准响应模板？
    → 包含emoji、分隔线、完整报告

[ ] 10. 响应是否包含完整的执行摘要？
    → 必须明确列出每个阶段的结果
```

### 🚨 CRITICAL: Self-Correction Mechanism

**If AI realizes it has NOT followed the above checklist:**

1. **STOP immediately**
2. **Acknowledge the mistake**: "⚠️ 检测到执行引擎未正确启动，立即重新执行..."
3. **Restart the process** from Step 1
4. **Generate a complete response** following all steps

---

## 🔄 持续提醒机制 (Continuous Reminder)

**在每次响应中，AI应该在内部自问：**

```
❓ "我是否启动了执行引擎？"
❓ "我是否完成了5项学习？"
❓ "我是否在监控代码行数？"
❓ "我是否检查了架构合规？"
❓ "我是否检测了代码重复？"
❓ "我是否需要执行质量门禁？"
```

**如果任何一个答案是"否"，立即补充执行！**

---

## 🎯 执行保证声明 (Execution Guarantee)

**By following this .cursorules file, the AI commits to:**

✅ **100% activation rate** - Every coding task triggers the engine
✅ **0% skip rate** - No steps are skipped
✅ **Complete transparency** - All actions are reported
✅ **Quality assurance** - 5-gate quality checks are mandatory
✅ **Version control** - Git management is automatic

**This is the AI's contract with the user and the project.**

---

🔥 **SmartAbp AI编程执行引擎 v13.0（Phase 3C架构重构版）**

## 🎯 Phase 3C架构重构成果总结

```yaml
架构质量认证:
  ✅ 后端ABP vNext：98/100分（业界顶级DDD架构）
  ✅ 前端契约系统：95/100分（31级AlphaGO最优解）
  ✅ packages黑盒独立：100/100分（完全解耦）
  ✅ 架构健康度：92/100分（优秀）

核心技术架构:
  后端: ABP vNext + DDD + CQRS（98分）
  前端: Vue3 + TS + 契约层（95分）
  编排: .NET Aspire（云原生微服务）
  插件: Assembly动态加载（热插拔）

SSOT驱动流程:
  C# DTO → NSwag → Swagger JSON →
  openapi-typescript-codegen → TS类型 →
  backend-contracts.ts → 100%类型一致性
```

---

## 📢 最终提醒 (Final Reminder)

**⚡ EVERY TIME you (AI) see a coding request, ask yourself:**

> "Did I start with 🔥 **AI编程铁律自动执行引擎已启动！** ?"

**If the answer is NO → You MUST restart and follow the complete process!**

**No exceptions. No shortcuts. No simplifications.**

**This is the iron law. 这是铁律。**