生产管理系统 - 全领域数据感知中心开发

crop-x/docs/开发项目规范.md

@@ -1,5 +1,41 @@
 # 开发项目规范
 
+## 通用开发规约
+
+### 1. 文件头部注释规范（filekorolheader）
+
+**规范要求：**
+所有页面文件（page.tsx）必须在最上方添加filekorolheader注释，说明文件对应的页面功能、路径和用途。
+
+**格式标准：**
+```tsx
+/**
+ * filekorolheader: [页面名称] - [功能描述]
+ * 功能：[主要功能列表]
+ * 路径：[页面路由路径]
+ * 规范：[遵循的特殊规范说明]
+ */
+```
+
+**示例：**
+```tsx
+/**
+ * filekorolheader: 物联设备数据接入页面 - IoT设备数据管理中心
+ * 功能：设备列表管理、实时数据监控、数据对比分析、报告生成
+ * 路径：/ai-crop-model/data-sense-center/iot
+ * 规范：遵循crop-x/docs/开发项目规范.md，使用useReducer状态管理，shadcn语义化样式
+ */
+```
+
+**实施要点：**
+- 必须放在文件最顶部，在'use client'之前
+- 页面名称要准确反映业务功能
+- 功能描述要简明扼要，列出核心功能
+- 路径必须是完整的路由路径
+- 如有特殊规范遵循，需要在规范字段说明
+
+---
+
 ## path：land-information/archive/statistics，name：统计分析页面开发经验
 
 ### 总体开发经验总结