# 規(guī)則名稱


## 基礎(chǔ)規(guī)范
- 明確的技術(shù)要求和實(shí)現(xiàn)標(biāo)準(zhǔn)


## 強(qiáng)制行為
- 必須執(zhí)行的具體操作和約束


## 禁止行為  
- 嚴(yán)格禁止的操作和做法，需要避免的常見錯(cuò)誤


## 示例代碼
- 具體的代碼示例和最佳實(shí)踐
- 也通過 [文件名](mdc:路徑) 引用外部示例

# AI協(xié)作執(zhí)行規(guī)則


## 規(guī)則分類
- basic/下的通用規(guī)則: 必須調(diào)用，通用基礎(chǔ)規(guī)范
- modules/下的模塊規(guī)則: 按需調(diào)用，架構(gòu)分層規(guī)范  
- workflow/下的流程規(guī)則: 按需調(diào)用，業(yè)務(wù)場(chǎng)景規(guī)范


## 執(zhí)行流程
1. 識(shí)別場(chǎng)景 → 調(diào)用相關(guān)規(guī)則
2. 讀取示例代碼 → 作為生成參考
3. 執(zhí)行強(qiáng)制/禁止行為 → 確保代碼質(zhì)量
4. 應(yīng)用設(shè)計(jì)原則 → 組件化、單一職責(zé)、分層設(shè)計(jì)


## 質(zhì)量保障
- 所有規(guī)則必須100%執(zhí)行，重點(diǎn)關(guān)注強(qiáng)制行為和禁止行為

# 代碼質(zhì)量分規(guī)范（通用規(guī)則）


## 強(qiáng)制行為


- 所有請(qǐng)求必須采用 HTTPS 協(xié)議
- 確保第三方庫安全可靠


## 禁止行為


- 代碼復(fù)雜度限制
  - 單個(gè)文件不得超過 500 行
  - 條件復(fù)雜度不得超過 10
  - 單個(gè)函數(shù)不得超過 199 行
  - 超過限制時(shí)，應(yīng)優(yōu)先按功能模塊拆分為多個(gè)函數(shù)或文件
- 禁止使用非得物域名的外部 CDN 資源
- 禁止在代碼中包含明文密碼或硬編碼 token
- 禁止出現(xiàn)敏感詞
- 避免重復(fù)代碼塊
- 不允許單詞拼寫錯(cuò)誤或不符合命名規(guī)范
- 避免在前端直接進(jìn)行金額計(jì)算(導(dǎo)致精度丟失)
- 禁止使用魔數(shù)(如 a === '3')，應(yīng)使用常量(如 a === statusMap.login)

# API接口生成規(guī)范（模塊規(guī)則）


## 存放位置規(guī)范（按優(yōu)先級(jí)）
- [p0] 頁面級(jí)API：src/pages/{pageName}/services/{modules}.ts
- [p1] 全局API：src/services/{modules}.ts
- 類型文件：對(duì)應(yīng)的 .interface.ts 文件


## 標(biāo)準(zhǔn)代碼模板
```
import { request } from '@/utils/request';
import { UniversalResp } from '@/utils/request-operation';
import { IUserListReq, IUserListDataRes } from './interface';


/**
 * 獲取用戶列表
 * @param data 請(qǐng)求參數(shù)
 */
export const fetchUserListApi = async (data: IUserListReq) => {
  return request.post<UniversalResp<IUserListDataRes>>(
    '/api/user/list',
    data
  );
};
```
## 強(qiáng)制行為
- 使用MCP Server的mooncake_get_api_details工具獲取接口詳情
- 響應(yīng)數(shù)據(jù)必須使用UniversalResp<T>泛型包裝
- 接口命名采用fetch{ApiFileName}Api格式
- 類型定義必須完整，包含完整字段注釋

# pro-table生成新頁面（流程規(guī)則）
深入研究代碼并理解[insert feature]是如何工作的。一旦你明白了，讓我知道，我將提供我的任務(wù)給你。


##  工作流程
按以下流程進(jìn)行任務(wù)執(zhí)行，如果評(píng)估存在非必須流程，可跳過。
- MCP讀取接口信息
- 從用戶輸入中提取以下信息：
   - 列表名稱
   - 篩選項(xiàng)（需標(biāo)記hideInTable）
   - 展示項(xiàng)（需標(biāo)記hideInSearch）
   - 操作項(xiàng)
   - 工具欄按鈕
- 評(píng)估完整的需求內(nèi)容復(fù)雜度，考慮未來的擴(kuò)展性，合理設(shè)計(jì)分層目錄結(jié)構(gòu)
    - 各個(gè)模塊保持單一職責(zé)，考慮合理的業(yè)務(wù)組件拆分，避免大量代碼都在頁面主入口文件
    - 使用命令行批量創(chuàng)建目錄文件（包含各類文件ts、tsx、less等）
    - 文件暫不生成代碼
- 配置頁面的路由信息
- 生成類型文件，確保所有類型定義清晰
- 生成constants文件，定義所需常量
- 生成services文件，實(shí)現(xiàn)數(shù)據(jù)服務(wù)
- 生成所需的 hooks 文件
- 生成頁面（必需）和components（如需）文件 完成UI層


## 強(qiáng)制行為
- 使用pro-table進(jìn)行開發(fā)，包括篩選表單，符合最佳實(shí)踐
- 篩選項(xiàng)和列表項(xiàng)配置創(chuàng)建useColumns.tsx聲明，篩選項(xiàng)（需標(biāo)記hideInTable）、展示項(xiàng)（需標(biāo)記hideInSearch）
- 左側(cè)字段按需固定，操作項(xiàng)右側(cè)固定，最多顯示兩個(gè)，超出折疊顯示
- 文本左對(duì)齊，數(shù)字右對(duì)齊，狀態(tài)枚舉居中顯示
- 分頁設(shè)置支持10、20、50、100
- .....


# 禁止行為
.....

.cursor/rules/
├── ai.mdc              # AI協(xié)作總綱
├── basic/              # 基礎(chǔ)規(guī)范目錄
│   ├── basic.mdc
│   ├── code-quality.mdc
│   ├── ts.mdc
│   ├── style.mdc
│   ├── comment.mdc
│   ├── code-names.mdc
│   └── lint.mdc
├── modules/            # 模塊規(guī)范目錄
│   ├── components.mdc
│   ├── pages.mdc
│   ├── hooks.mdc
│   ├── service.mdc
│   ├── constants.mdc
│   ├── utils.mdc
│   └── route.mdc
└── workflow/           # 流程規(guī)范目錄
    ├── curd-page.mdc
    ├── log.mdc
    └── send-buried.mdc
    └── ......

# AI協(xié)作執(zhí)行規(guī)則


## 規(guī)則分類
- basic/下的通用規(guī)則: 必須調(diào)用，通用基礎(chǔ)規(guī)范
- modules/下的模塊規(guī)則: 按需調(diào)用，架構(gòu)分層規(guī)范  
- workflow/下的流程規(guī)則: 按需調(diào)用，業(yè)務(wù)場(chǎng)景規(guī)范


## 執(zhí)行流程
1. 識(shí)別場(chǎng)景 → 調(diào)用相關(guān)規(guī)則
2. 讀取示例代碼 → 作為生成參考
3. 執(zhí)行強(qiáng)制/禁止行為 → 確保代碼質(zhì)量
4. 應(yīng)用設(shè)計(jì)原則 → 組件化、單一職責(zé)、分層設(shè)計(jì)


## 質(zhì)量保障
所有規(guī)則必須100%執(zhí)行，重點(diǎn)關(guān)注強(qiáng)制行為和禁止行為