---
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` — 完整模块化规范与案例