初始化

.cursor/rules/019-modular.mdc

@@ -0,0 +1,41 @@
+---
+description: >
+  模块化架构规范。当新建模块、讨论架构设计、模块划分、
+  依赖方向或 DDD 边界时激活。含模块通信和文件拆分最佳实践。
+alwaysApply: false
+---
+
+# 🧩 Modular Architecture Standards (Core)
+
+## 架构边界
+
+- 模块按业务能力划分，避免按技术层随意切分
+- 模块间通过公开接口通信，禁止引用他模块内部实现
+- 依赖方向单向：UI → Service → Repository → Model
+
+## 拆分与聚合
+
+- 单文件职责单一，超过复杂度阈值立即拆分
+- 公共能力抽到 Case-Database-Frontend-shared/core，业务逻辑保留在业务模块
+- 新增目录优先复用既有模式，避免“再发明一套结构”
+
+## 反模式禁止
+
+- 循环依赖
+- 横向跨层调用（Controller 直连 DB）
+- 超大文件混合业务/状态/展示逻辑
+
+## 评审基线
+
+- 每次改动需回答：边界是否更清晰？耦合是否降低？
+- 新增接口必须说明输入/输出和错误语义
+
+## 验证清单
+
+- [ ] 无循环依赖
+- [ ] 模块边界清晰，可替换性提升
+- [ ] 公共能力与业务能力分层明确
+
+## Tier 3 深度参考
+
+- `.cursor/rules/references/019-modular-deep.md` — 完整模块化规范与案例