lingyue-zhibao/.cursor/rules/rules.mdc

---
alwaysApply: true
---

## 需要告知

每次告诉我本次chat使用的模型

## 代码设计

设计逻辑参考 `a_docs/灵越智报2.0程序设计详解.md`

## 代码规范

1.  **项目结构规范**
    *   统一父POM管理依赖版本，子模块按业务或功能划分。
    *   模块命名清晰，遵循`服务名-功能`格式（如`user-service`, `gateway-module`）。

2.  **接口定义与契约**
    *   内部服务间HTTP API优先使用OpenAPI 3.0（SpringDoc）定义，并明确版本。
    *   Feign Client接口需声明在独立模块，供消费者依赖；方法名与路径遵循RESTful风格。

3.  **配置管理**
    *   敏感配置必须加密，环境相关配置与代码分离。

4.  **服务治理与容错**
    *   服务注册发现：使用Spring Cloud原生客户端（如Nacos Discovery），确保实例元数据规范。
    *   熔断降级：统一使用Resilience4j，定义合理的熔断策略和降级逻辑。
    *   链路追踪：全服务集成Sleuth，日志中必须包含TraceID。

5.  **日志与监控**
    *   日志格式统一为JSON，包含时间、级别、服务名、TraceID等关键字段。
    *   核心接口需通过Micrometer暴露指标，并与监控系统集成。

6.  **安全与部署**
    *   配置文件禁止提交敏感信息（如密码、密钥）。
    *   容器化部署时，健康检查接口（`/actuator/health`）必须启用。

7.  **版本约束**
    *   统一Spring Boot、Spring Cloud、Spring Cloud Alibaba的版本映射，避免兼容性问题。

## 代码检查

chat进行新代码修改或新增，结束后检查整体逻辑