0514.1

.cursor/rules/nextjs.mdc

@@ -0,0 +1,50 @@
+---
+description: 
+globs: 
+alwaysApply: true
+---
+Always respond in 中文
+
+## 注意事项
+
+### 相关规范文档(项目根目录下，需要时请查看)
+- 数据模型结构：模型定义-团队级.txt 和 模型定义-系统级.txt
+- 自定义钩子使用文档：README-hooks.md
+- 数据库连接模块使用指南：README-DB.md
+- API请求规范与最佳实践：README-API.md
+- UI设计规范：README-UI.md
+- 工具函数已在src\utils\index.ts中导出
+- 钩子在src\hooks\index.ts，请查看相关使用方式，禁止使用src\store
+
+### 开发规范
+- 现在已启用TypeScript严格模式，不要出现类型错误，禁止出现未使用变量
+- UI使用Ant Design 5.X 注意兼容性问题
+- api路由不需要auth，禁止使用auth！！！
+- 前端UI、API请求都要符合我们现有的规范（可查看相关文件）
+- 开发时，单文件代码严格限制在700行以内（含注释） 不要画蛇添足！ 
+- 禁止使用any类型！ 
+- 必须包含三级注释体系：  
+    ▸ 文件头注释（作者:阿瑞/功能/版本）  
+    ▸ 模块级注释（逻辑分段说明）  
+    ▸ 关键代码行注释（复杂逻辑解释）    
+- 当前在Windows 11环境下使用PowerShell终端进行开发，禁用类Unix命令，使用`Get-ChildItem` 替代ls  ；
+- 已使用pnpm run dev启动了项目，禁止重复启动
+- 当修改超过300行的文件时，确保每次修改代码行数 ≤ 100行，分多次修改。
+
+## 补充说明
+
+1. 适当使用useMemo、React.memo来优化性能和防止不必要的重新渲染；
+2. 尽量少使用第三方库，优先使用原生功能或已有依赖；  
+3. 创建模块化样式文件（Modular Stylesheet），命名遵循[name].module.css约定；
+4. 创建新组件时，遵循项目的目录组织结构和命名规范；
+5. 最好是模块化能够复用的；
+6. 创建前端页面时，复杂样式时应分离样式文件，创建`page.module.css`使用`import styles from './page.module.css';`引入样式；
+7. 已有UI组件已在`src\components\ui`路径下，使用时可查看具体代码获取使用方法；
+8. 不使用`import { toast } from 'sonner';`这个第三方组件，使用`src\components\ui\Notification.tsx`这个组件；
+9. 数据模型定义在`src\models\system`（系统级）和`src\models\team（团队及）文件中；
+10. 避免重复定义类型！！！数据模型接口定义在`src\models\system\types`（系统级）和`src\models\team\types`（团队级）文件中；
+11. 当执行终端命令时，先解释这个命令的作用；如果要使用pnpm安装包时，先解释为什么需要这个包；  
+
+## 数据库说明
+
+数据库是docker中搭建的，可以使用这个命令进入数据库：  docker exec -it my-mysql mysql -uroot -p"aiwoQwo520.."