diff --git a/crop-x/docs/开发项目规范.md b/crop-x/docs/开发项目规范.md index 569f7ab..bbf6405 100644 --- a/crop-x/docs/开发项目规范.md +++ b/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:统计分析页面开发经验 ### 总体开发经验总结 diff --git a/crop-x/env/.env.dev b/crop-x/env/.env.dev index a300eea..8be0fea 100644 --- a/crop-x/env/.env.dev +++ b/crop-x/env/.env.dev @@ -5,7 +5,10 @@ NODE_ENV=development FRONTEND_BASE_URL=https://cavin-smart-crop-ui-app.dev.maimaiag.com # 后端 API 地址 -BACKEND_BASE_URL=http://pengcode.tech:8080 +BACKEND_BASE_URL=https://gitea-admin-hm-smart-agri-app.dev.maimaiag.com/ + +# OpenAPI 生成配置 +API_BASE_URL=https://gitea-admin-hm-smart-agri-app.dev.maimaiag.com # API 版本 API_VERSION=v1 diff --git a/crop-x/src/app/(app)/ai-crop-model/data-center/external/page.tsx b/crop-x/src/app/(app)/ai-crop-model/data-center/external/page.tsx deleted file mode 100644 index 4528c79..0000000 --- a/crop-x/src/app/(app)/ai-crop-model/data-center/external/page.tsx +++ /dev/null @@ -1,18 +0,0 @@ -'use client'; - -import { Card } from '@/components/ui/card'; - -export default function ExternalPage() { - return ( -
- 页面路径: /ai-crop-model/data-center/external -
-- 页面路径: /ai-crop-model/data-center/iot -
-;
+ case 'FTP传输':
+ return {dataSource.provider}
++ {dataSource.description} +
+总数据源
++ {state.statistics.totalSources} +
+活跃数据源
++ {state.statistics.activeSources} +
+总数据点
++ {state.statistics.totalDataPoints.toLocaleString()} +
+活跃率
++ {activeRate}% +
+多源数据智能接入,构建全面精准的农业数据底座
+外部数据源
+{activeExternalSources}/{totalExternalSources}
+正常运行
+物联设备
+3/5
+在线设备
+数据质量
+{dataQuality.accuracy}%
+准确率
+异常告警
+2
+待处理
+多源数据接入功能:
+IoT设备管理和数据采集监控中心
+外部数据源
+{activeExternalSources}/{totalExternalSources}
+正常运行
+物联设备
+{onlineDevices}/{totalDevices}
+在线设备
+数据质量
+{dataQuality.accuracy}%
+准确率
+异常告警
+{offlineDevices + faultDevices}
+待处理
+物联设备数据接入功能:
+在线设备
+{onlineDevices}
+离线设备
+{offlineDevices}
+故障设备
+{faultDevices}
+数据采集率
+98.5%
+- 基于OpenAPI规范自动生成的所有接口示例,点击按钮即可测试 + 基于OpenAPI规范自动生成的所有接口示例,支持分类测试和批量调用
{example.description}
+{example.description}
- {/* 示例参数 */} -
- {JSON.stringify(example.exampleParams, null, 2)}
-
- ) : (
- 无参数
- )} + {/* 示例参数 */} + {example.exampleParams && ( +
+ {JSON.stringify(example.exampleParams, null, 2)}
+
+
+ {examplesResults[example.id].error
+ ? JSON.stringify(examplesResults[example.id].error, null, 2)
+ : JSON.stringify(examplesResults[example.id].data, null, 2)
+ }
+
+
- {JSON.stringify(example.expectedOutput, null, 2)}
-
-
- {examplesResults[example.id].error
- ? JSON.stringify(examplesResults[example.id].error, null, 2)
- : JSON.stringify(examplesResults[example.id].data, null, 2)
- }
-
- {Object.values(examplesResults).filter(r => r?.success).length} @@ -642,11 +1265,32 @@ function ApiExamplesPage() {
+ {Object.values(examplesResults).filter(r => r !== undefined).length} +
+已测试
+{apiExamples.length}
总计
+ 成功率: {apiExamples.length > 0 ? Math.round((Object.values(examplesResults).filter(r => r?.success).length / apiExamples.length) * 100) : 0}% +
+