---
description: 萧康云医项目全局编码规则
alwaysApply: true
---

# 全局规则

- 代码、包、方法、结构体、接口、关键业务分支、复杂判断、关键配置均需要编写清晰的中文注释。
- 注释要说明业务意图、输入输出、边界条件和注意事项，避免只重复代码字面含义。
- 模块职责要清晰，避免跨层调用、重复实现和无关逻辑混入。
- 新增或修改功能时，优先遵循项目已有目录结构、命名方式、封装习惯和错误处理方式。
- 公共能力应沉淀为可复用模块或组件，避免在多个页面、控制器或服务中复制粘贴。