chajia/.cursor/rules/project-rules.mdc

---
description: 项目统一规则入口
alwaysApply: true
---

你在本项目执行任何编码任务前，必须先读取并遵循 `cursor_project_rules` 目录中的规则文件。

强制约束：

 ## 不得脱离 `cursor_project_rules` 的上下文进行实现。
 ## 新功能必须按 `cursor_project_rules/implementation-plan.mdc` 的步骤顺序执行。
 ## 每完成一个步骤，必须在 `implementation-plan.mdc` 中写入：
   - `Done`
   - 两行本次执行记录
 ## 修改代码时保持最小变更，原则：执行修改必须遵循零风险，最小代码修改量，不能因为本次的修改而影响了其他功能正常使用，禁止修改与计划无关的代码。安全第一：不得引入新 bug，不破坏现有逻辑
 ## 对新增或变更逻辑补充对应测试（如项目存在测试框架）。
 ##  要求：
  ### 必须100%精准定位错误根源：具体到哪个文件、第几行（或哪几行）、哪个函数/组件/查询/中间件。
  ### 逐层深度分析错误成因：数据库层（SQL/ORM/索引/事务）、后端逻辑（API、控制器、服务、验证、中间件）、前端（React/Vue/Svelte组件、状态管理、hooks、请求封装）、组件库、构建工具、环境变量、部署配置全部覆盖。
  ### 给出100%能彻底解决的修改方案：直接贴出修改后的完整代码块（只改动必要部分，用```标注语言），并用注释标明「为何这样改」。
  ### 方案必须只能改最少文件、最少行数，杜绝过度重构。
  ### 整场对话诊断+方案总行数控制在100行以内，精炼到底。所有输出的计划或总报告，不得超过100行。现在开始，请先复述你理解的错误现象，然后直接报出「根源在：xxx文件 第xx行」
 ## 所有前端界面文本必须使用中文，在设计前端时，应考虑用户为中文环境下使用，系统应该设计为中文系统，能被看到的都应该翻译为中文，除非是用户特殊说明。
 ## 界面文案必须干净，不得包含需求文档引用标记
  
  ### 并发场景必须考虑：重复提交、资源竞争、原子性、锁机制
  ### 外部调用必须处理：超时、失败、重试、熔断、降级
  ### 所有业务逻辑必须覆盖：异常流程、错误流程、边界场景、反向场景
  ### 禁止只处理理想流程，必须覆盖所有可能出现的异常与风险点
  ### 代码必须稳定、安全、可直接上线，不允许脆弱逻辑请直接输出**完整、健壮、包含所有异常处理与安全机制**的最终代码。
 ## 请在系统开发与初始化流程中，自动完成以下动作：
 ### 从需求文档中提取所有示例、实例、案例、样例数据、演示值、测试用例、状态示例。
 ### 核心响应协议：深度思考优先
 ## If a fix is attempted 3 times without structural improvement in logs or system state, stop all local fixes and perform full root cause re-analysis across all layers (UI, RPA, backend, queue, pricing). Local patching is prohibited until root cause layer is correctly identified.