# Crop-X 项目完整技术架构方案 (Next.js App Router 版本)
**Session Date:** 2025-10-16
**Facilitator:** Business Analyst Mary
**Project:** 智慧农业系统 crop-x 重构 (Next.js App Router 版本)
---
## 项目概述
基于现有的智慧农业生产管理系统，在根目录下创建全新的 `crop-x` 项目，采用 **Next.js 14 App Router** + React 19 + Zustand + shadcn + Tailwind CSS 技术栈，实现现代化的路由系统、用户认证模块、API管理系统和完整的业务架构。
## 技术栈
- **前端框架**: Next.js 14 + React 19 + TypeScript
- **构建工具**: Next.js 内置构建系统
- **状态管理**: Zustand
- **UI框架**: shadcn/ui + Tailwind CSS
- **路由**: Next.js App Router
- **HTTP客户端**: Axios
- **图标**: Lucide React
- **提示组件**: Sonner
## Next.js App Router 目录结构
```
D:\code\repotest\smart-crop-ui\ # 原项目（保留不变）
├── 📂 crop-x/ # 🆕 全新的重构项目 (Next.js App Router)
│ ├── 📂 app/ # 🆕 Next.js App Router 页面组件 - 7大业务模块完整层级结构
│ │ ├── 📄 layout.tsx # 🆕 根布局组件
│ │ ├── 📄 page.tsx # 🆕 首页组件
│ │ ├── 📄 loading.tsx # 🆕 全局加载组件
│ │ ├── 📄 error.tsx # 🆕 全局错误组件
│ │ ├── 📄 not-found.tsx # 🆕 404页面组件
│ │ ├── 📂 (auth)/ # 🆕 认证路由组
│ │ │ ├── 📄 layout.tsx # 认证布局
│ │ │ ├── 📂 login/ # 登录页面
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 register/ # 注册页面
│ │ │ └── 📄 page.tsx
│ │ ├── 📂 agricultural-machinery/ # 🚙 智能农机管理系统页面
│ │ │ ├── 📄 layout.tsx # 🆕 农机系统布局
│ │ │ ├── 📄 page.tsx # 🆕 农机系统主页面
│ │ │ ├── 📄 loading.tsx # 🆕 农机系统加载组件
│ │ │ ├── 📄 error.tsx # 🆕 农机系统错误组件
│ │ │ ├── 📂 archive/ # B级：农机档案
│ │ │ │ ├── 📄 page.tsx # 🆕 档案主页
│ │ │ │ ├── 📂 machinery-entry/ # C级：农机档案录入与维护
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 classification-management/ # C级：农机分类与标签管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 qr-code-management/ # C级：农机二维码管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 driver-archive/ # B级：驾驶员档案
│ │ │ │ ├── 📄 page.tsx # 🆕 驾驶员档案主页
│ │ │ │ ├── 📂 driver-info-management/ # C级：驾驶员信息管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 driver-task-management/ # C级：驾驶员任务管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 monitoring/ # B级：设备实时监控与定位
│ │ │ │ ├── 📄 page.tsx # 🆕 监控主页
│ │ │ │ ├── 📂 real-time-location-tracking/ # C级：实时位置追踪
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 work-status-monitoring/ # C级：工作状态监控
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 operation-data-monitoring/ # C级：作业数据监控
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 fault-diagnosis/ # B级：远程诊断与故障预警
│ │ │ │ ├── 📄 page.tsx # 🆕 故障诊断主页
│ │ │ │ ├── 📂 fault-warning/ # C级：故障诊断与预警
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 health-assessment/ # C级：健康评估
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 parameter-monitoring/ # C级：运行参数监测
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 precision-operation/ # B级：精准作业管理与支持
│ │ │ │ ├── 📄 page.tsx # 🆕 精准作业主页
│ │ │ │ ├── 📂 operation-record/ # C级：作业数据记录
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 route-planning/ # C级：作业路线规划
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 plan-dispatch/ # C级：作业方案下发
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 driving-cockpit/ # C级：农机驾驶舱
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 data-analysis/ # B级：数据管理与分析报告
│ │ │ │ ├── 📄 page.tsx # 🆕 数据分析主页
│ │ │ │ ├── 📂 operation-analysis/ # C级：作业数据分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 historical-data-comparison/ # C级：历史数据查询与对比
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 scheduling/ # B级：农机管理与调度
│ │ │ │ ├── 📄 page.tsx # 🆕 调度管理主页
│ │ │ │ ├── 📂 task-assignment/ # C级：任务分配
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 real-time-dispatch/ # C级：实时调度监控
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 track-playback/ # C级：农机作业轨迹回放
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 security/ # B级：安全与安防
│ │ │ ├── 📄 page.tsx # 🆕 安全安防主页
│ │ │ └── 📂 geo-fence/ # C级：电子围栏
│ │ │ └── 📄 page.tsx
│ │ ├── 📂 land-information/ # 🌾 地块信息管理系统页面
│ │ │ ├── 📄 layout.tsx # 🆕 地块系统布局
│ │ │ ├── 📄 page.tsx # 🆕 地块系统主页面
│ │ │ ├── 📂 field-management/ # B级：地块档案管理
│ │ │ │ ├── 📄 page.tsx # 🆕 地块档案主页
│ │ │ │ ├── 📂 field-entry/ # C级：地块信息录入
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 classification-management/ # C级：地块分类管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 batch-operation/ # C级：批量操作
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 map-management/ # B级：地图管理
│ │ │ │ ├── 📄 page.tsx # 🆕 地图管理主页
│ │ │ │ ├── 📂 gis-data/ # C级：GIS数据管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 digital-drawing/ # C级：数字化绘制
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 spatial-query/ # C级：空间查询
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 satellite-imagery/ # C级：卫星影像管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 spatial-analysis/ # B级：空间分析
│ │ │ │ ├── 📄 page.tsx # 🆕 空间分析主页
│ │ │ │ ├── 📂 soil-data/ # C级：土壤数据分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 layered-sampling/ # C级：分层采样分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 quality-evaluation/ # C级：质量评价
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 environmental-monitoring/ # B级：环境监测
│ │ │ │ ├── 📄 page.tsx # 🆕 环境监测主页
│ │ │ │ ├── 📂 weather-data/ # C级：气象数据监测
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 sensor-data/ # C级：环境传感器数据
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 monitoring-history/ # C级：监测历史记录
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 suitability-evaluation/ # B级：适宜性评价
│ │ │ │ ├── 📄 page.tsx # 🆕 适宜性评价主页
│ │ │ │ ├── 📂 comprehensive-evaluation/ # C级：综合评价分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 batch-analysis/ # C级：批量分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 crop-recommendation/ # C级：作物推荐分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 weight-configuration/ # C级：权重配置管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 comparative-analysis/ # B级：对比分析
│ │ │ │ ├── 📄 page.tsx # 🆕 对比分析主页
│ │ │ │ ├── 📂 multi-dimensional-metrics/ # C级：多维指标分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 chart-analysis/ # C级：图表分析展示
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 report-generation/ # C级：报告生成管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 risk-warning/ # B级：风险预警
│ │ │ ├── 📄 page.tsx # 🆕 风险预警主页
│ │ │ ├── 📂 real-time-monitoring/ # C级：实时监测预警
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 early-warning-push/ # C级：预警信息推送
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 disposal-tracking/ # C级：处置情况跟踪
│ │ │ └── 📄 page.tsx
│ │ ├── 📂 farming-operation/ # 📋 农事操作管理系统页面
│ │ │ ├── 📄 layout.tsx # 🆕 农事系统布局
│ │ │ ├── 📄 page.tsx # 🆕 农事系统主页面
│ │ │ ├── 📂 farm-planning/ # B级：农事计划管理
│ │ │ │ ├── 📄 page.tsx # 🆕 农事计划主页
│ │ │ │ ├── 📂 plan-formulation/ # C级：计划制定
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 resource-allocation/ # C级：资源分配管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 progress-tracking/ # C级：进度跟踪管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 task-management/ # B级：农事任务管理
│ │ │ │ ├── 📄 page.tsx # 🆕 农事任务主页
│ │ │ │ ├── 📂 task-creation/ # C级：任务创建管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 task-assignment/ # C级：任务分配派发
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 task-status-monitoring/ # C级：任务状态监控
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 task-history-statistics/ # C级：任务历史统计
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 operation-execution/ # B级：农事执行管理
│ │ │ │ ├── 📄 page.tsx # 🆕 农事执行主页
│ │ │ │ ├── 📂 operation-type-management/ # C级：操作类型管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 operation-recording/ # C级：操作记录管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 operation-log-query/ # C级：操作日志查询
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 farming-calendar/ # B级：农事日历管理
│ │ │ │ ├── 📄 page.tsx # 🆕 农事日历主页
│ │ │ │ ├── 📂 calendar-visualization/ # C级：日历可视化视图
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 gantt-chart-management/ # C级：甘特图管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 progress-visualization/ # C级：进度可视化
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 operation-archive/ # B级：农事档案管理
│ │ │ │ ├── 📄 page.tsx # 🆕 农事档案主页
│ │ │ │ ├── 📂 archive-generation/ # C级：档案归集生成
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 full-dimension-view/ # C级：全维视图管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 traceability-tracking/ # C级：追踪溯源管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 knowledge-base/ # B级：知识库管理
│ │ │ │ ├── 📄 page.tsx # 🆕 知识库主页
│ │ │ │ ├── 📂 content-management/ # C级：内容管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 classification-tagging/ # C级：分类标签管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 intelligent-search/ # C级：智能检索功能
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 performance-management/ # B级：绩效管理
│ │ │ │ ├── 📄 page.tsx # 🆕 绩效管理主页
│ │ │ │ ├── 📂 personnel-management/ # C级：人员管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 work-hour-recording/ # C级：工时记录管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 statistical-reports/ # C级：统计报表管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 scheduling-management/ # C级：排班管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 issue-collaboration/ # B级：问题协同管理
│ │ │ ├── 📄 page.tsx # 🆕 问题协同主页
│ │ │ ├── 📂 issue-reporting/ # C级：问题上报管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 processing-assignment/ # C级：处理分派管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 online-collaboration/ # C级：在线协作功能
│ │ │ └── 📄 page.tsx
│ │ ├── 📂 agricultural-asset/ # 📦 农业资产管理系统页面
│ │ │ ├── 📄 layout.tsx # 🆕 资产系统布局
│ │ │ ├── 📄 page.tsx # 🆕 资产系统主页面
│ │ │ ├── 📂 basic-information/ # B级：基础信息管理
│ │ │ │ ├── 📄 page.tsx # 🆕 基础信息主页
│ │ │ │ ├── 📂 asset-entry/ # C级：资产信息录入
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 asset-classification/ # C级：资产分类管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 asset-labeling/ # C级：资产标签管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 procurement-management/ # B级：采购管理
│ │ │ │ ├── 📄 page.tsx # 🆕 采购管理主页
│ │ │ │ ├── 📂 procurement-planning/ # C级：采购计划制定
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 supplier-management/ # C级：供应商管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 procurement-tracking/ # C级：采购跟踪管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 inventory-management/ # B级：库存管理
│ │ │ │ ├── 📄 page.tsx # 🆕 库存管理主页
│ │ │ │ ├── 📂 stock-monitoring/ # C级：库存监控管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 stock-adjustment/ # C级：库存调整管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 inventory-report/ # C级：库存报表管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 material-requisition/ # B级：物资领用管理
│ │ │ │ ├── 📄 page.tsx # 🆕 物资领用主页
│ │ │ │ ├── 📂 requisition-application/ # C级：领用申请管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 approval-workflow/ # C级：审批流程管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 requisition-tracking/ # C级：领用跟踪管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 material-return/ # B级：物资归还管理
│ │ │ │ ├── 📄 page.tsx # 🆕 物资归还主页
│ │ │ │ ├── 📂 return-application/ # C级：归还申请管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 return-approval/ # C级：归还审批管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 return-tracking/ # C级：归还跟踪管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 agricultural-supplies/ # B级：农资农具管理
│ │ │ │ ├── 📄 page.tsx # 🆕 农资农具主页
│ │ │ │ ├── 📂 tool-management/ # C级：农具管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 material-management/ # C级：农资管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 maintenance-tracking/ # C级：维护跟踪管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 visualization-reports/ # B级：可视化报表
│ │ │ ├── 📄 page.tsx # 🆕 可视化报表主页
│ │ │ ├── 📂 asset-statement/ # C级：资产报表管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 inventory-statement/ # C级：库存报表管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 cost-analysis/ # C级：成本分析管理
│ │ │ └── 📄 page.tsx
│ │ ├── 📂 ai-crop-model/ # 🤖 AI作物模型精准决策系统页面
│ │ │ ├── 📄 layout.tsx # 🆕 AI模型系统布局
│ │ │ ├── 📄 page.tsx # 🆕 AI模型系统主页面
│ │ │ ├── 📂 data-perception-center/ # B级：数据感知中心
│ │ │ │ ├── 📄 page.tsx # 🆕 数据感知主页
│ │ │ │ ├── 📂 real-time-data-collection/ # C级：实时数据采集
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 historical-data-analysis/ # C级：历史数据分析
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 multi-source-data-fusion/ # C级：多源数据融合
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 model-integration-center/ # B级：模型接入集成中心
│ │ │ │ ├── 📄 page.tsx # 🆕 模型集成主页
│ │ │ │ ├── 📂 model-access-management/ # C级：模型接入管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 model-version-control/ # C级：模型版本控制
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 api-service-integration/ # C级：API服务集成
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 model-application-center/ # B级：模型应用中心
│ │ │ │ ├── 📄 page.tsx # 🆕 模型应用主页
│ │ │ │ ├── 📂 prediction-analysis/ # C级：预测分析管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 optimization-recommendation/ # C级：优化建议管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 scenario-simulation/ # C级：场景模拟管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 intelligent-decision-generation/ # B级：智能决策生成
│ │ │ │ ├── 📄 page.tsx # 🆕 智能决策主页
│ │ │ │ ├── 📂 decision-engine/ # C级：决策引擎管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 rule-configuration/ # C级：规则配置管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 decision-optimization/ # C级：决策优化管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 intelligent-decision-support/ # B级：智能决策支持
│ │ │ │ ├── 📄 page.tsx # 🆕 智能决策支持主页
│ │ │ │ ├── 📂 decision-visualization/ # C级：决策可视化
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 impact-assessment/ # C级：影响评估管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 decision-tracking/ # C级：决策跟踪管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 decision-application/ # B级：决策应用
│ │ │ │ ├── 📄 page.tsx # 🆕 决策应用主页
│ │ │ │ ├── 📂 automatic-execution/ # C级：自动执行管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 manual-adjustment/ # C级：手动调整管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 feedback-collection/ # C级：反馈收集管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 ai-knowledge-base/ # B级：AI知识库
│ │ │ │ ├── 📄 page.tsx # 🆕 AI知识库主页
│ │ │ │ ├── 📂 model-documentation/ # C级：模型文档管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 case-database/ # C级：案例数据库管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 expert-system/ # C级：专家系统管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 monitoring-center/ # B级：监控中心
│ │ │ ├── 📄 page.tsx # 🆕 监控中心主页
│ │ │ ├── 📂 model-performance/ # C级：模型性能监控
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 decision-quality/ # C级：决策质量监控
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 system-health/ # C级：系统健康监控
│ │ │ └── 📄 page.tsx
│ │ ├── 📂 water-fertilizer-control/ # 💧 水肥一体化控制系统页面
│ │ │ ├── 📄 layout.tsx # 🆕 水肥控制布局
│ │ │ ├── 📄 page.tsx # 🆕 水肥控制主页面
│ │ │ ├── 📂 irrigation-system-management/ # B级：水肥机管理
│ │ │ │ ├── 📄 page.tsx # 🆕 水肥机管理主页
│ │ │ │ ├── 📂 device-registration/ # C级：设备注册管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 status-monitoring/ # C级：状态监控管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 maintenance-management/ # C级：维护管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 smart-irrigation/ # B级：智能灌溉
│ │ │ │ ├── 📄 page.tsx # 🆕 智能灌溉主页
│ │ │ │ ├── 📂 irrigation-planning/ # C级：灌溉计划管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 automated-control/ # C级：自动控制管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 irrigation-optimization/ # C级：灌溉优化管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 fertilizer-formula-management/ # B级：施肥配方管理
│ │ │ │ ├── 📄 page.tsx # 🆕 施肥配方主页
│ │ │ │ ├── 📂 formula-configuration/ # C级：配方配置管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 crop-specific-formulas/ # C级：作物专用配方
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 formula-optimization/ # C级：配方优化管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 integrated-control/ # B级：水肥一体化控制
│ │ │ │ ├── 📄 page.tsx # 🆕 水肥一体化主页
│ │ │ │ ├── 📂 synchronized-control/ # C级：同步控制管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ ├── 📂 precision-application/ # C级：精准施用管理
│ │ │ │ │ └── 📄 page.tsx
│ │ │ │ └── 📂 real-time-adjustment/ # C级：实时调整管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 real-time-monitoring/ # B级：实时监测与预警
│ │ │ ├── 📄 page.tsx # 🆕 实时监测主页
│ │ │ ├── 📂 parameter-display/ # C级：参数显示管理
│ │ │ │ └── 📄 page.tsx
│ │ │ ├── 📂 warning-system/ # C级：预警系统管理
│ │ │ │ └── 📄 page.tsx
│ │ │ └── 📂 historical-analysis/ # C级：历史分析管理
│ │ │ └── 📄 page.tsx
│ │ └── 📂 central-config/ # ⚙️ 中心配置管理系统页面
│ │ ├── 📄 layout.tsx # 🆕 配置系统布局
│ │ ├── 📄 page.tsx # 🆕 配置系统主页面
│ │ ├── 📂 tenant-management/ # B级：租户管理
│ │ │ ├── 📄 page.tsx # 🆕 租户管理主页
│ │ │ ├── 📂 enterprise-audit/ # C级：企业审核
│ │ │ │ └── 📄 page.tsx # 路径: /config/tenant/enterprise-audit
│ │ │ ├── 📂 audit-history/ # C级：审核历史
│ │ │ │ └── 📄 page.tsx # 路径: /config/tenant/audit-history
│ │ │ ├── 📂 enterprise-info/ # C级：企业信息
│ │ │ │ └── 📄 page.tsx # 路径: /config/tenant/enterprise-info
│ │ │ └── 📂 platform-user-management/ # C级：用户管理
│ │ │ └── 📄 page.tsx # 路径: /config/tenant/user-management
│ │ ├── 📂 user-management/ # B级：用户管理
│ │ │ ├── 📄 page.tsx # 🆕 用户管理主页
│ │ │ ├── 📂 employee-management/ # C级：员工管理
│ │ │ │ └── 📄 page.tsx # 路径: /config/user/employee
│ │ │ ├── 📂 role-management/ # C级：角色管理
│ │ │ │ └── 📄 page.tsx # 路径: /config/user/role
│ │ │ ├── 📂 menu-management/ # C级：菜单管理
│ │ │ │ └── 📄 page.tsx # 路径: /config/user/menu
│ │ │ └── 📂 permission-config/ # C级：权限配置管理
│ │ │ └── 📄 page.tsx # 路径: /config/user/permission
│ │ ├── 📂 system-parameters/ # B级：系统参数
│ │ │ ├── 📄 page.tsx # 🆕 系统参数主页
│ │ │ ├── 📂 system-settings/ # C级：系统设置
│ │ │ │ └── 📄 page.tsx # 路径: /config/system/settings
│ │ │ ├── 📂 category-dictionary/ # C级：分类字典
│ │ │ │ └── 📄 page.tsx # 路径: /config/system/category
│ │ │ └── 📂 data-dictionary/ # C级：数据字典
│ │ │ └── 📄 page.tsx # 路径: /config/system/dictionary
│ │ ├── 📂 system-monitor/ # B级：系统监控
│ │ │ ├── 📄 page.tsx # 🆕 系统监控主页
│ │ │ ├── 📂 login-log/ # C级：登录日志
│ │ │ │ └── 📄 page.tsx # 路径: /config/monitor/login-log
│ │ │ ├── 📂 operation-log/ # C级：操作日志
│ │ │ │ └── 📄 page.tsx # 路径: /config/monitor/operation-log
│ │ │ ├── 📂 performance-monitor/ # C级：性能监控
│ │ │ │ └── 📄 page.tsx # 路径: /config/monitor/performance
│ │ │ └── 📂 network-log/ # C级：网络日志
│ │ │ └── 📄 page.tsx # 路径: /config/monitor/network-log
│ │ └── 📂 message-center/ # B级：消息中心
│ │ ├── 📄 page.tsx # 🆕 消息中心主页
│ │ ├── 📂 message-send/ # C级：消息发送
│ │ │ └── 📄 page.tsx # 路径: /config/message/send
│ │ ├── 📂 message-template/ # C级：消息模版
│ │ │ └── 📄 page.tsx # 路径: /config/message/template
│ │ └── 📂 message-log/ # C级：消息日志
│ │ └── 📄 page.tsx # 路径: /config/message/log
│ ├── 📂 components/ # 组件库
│ │ ├── 📂 ui/ # 基础UI组件(shadcn)
│ │ ├── 📂 layout/ # 布局组件
│ │ │ ├── 📄 Header.tsx # 顶部导航
│ │ │ ├── 📄 Sidebar.tsx # 侧边栏
│ │ │ └── 📄 MainLayout.tsx # 主布局
│ │ ├── 📂 common/ # 通用业务组件
│ │ └── 📂 business/ # 业务组件
│ ├── 📂 lib/ # 🆕 工具库 (Next.js 标准)
│ │ ├── 📄 utils.ts # 工具函数
│ │ ├── 📄 validations.ts # 表单验证
│ │ ├── 📄 constants.ts # 常量定义
│ │ └── 📄 helpers.ts # 辅助函数
│ ├── 📂 hooks/ # 自定义Hooks
│ │ ├── 📄 useAuth.ts # 认证Hook
│ │ ├── 📄 usePermission.ts # 权限Hook
│ │ └── 📄 useRouterParams.ts # 路由参数Hook
│ ├── 📂 store/ # Zustand状态管理
│ │ ├── 📄 authStore.ts # 认证状态管理
│ │ ├── 📄 globalStore.ts # 全局状态管理
│ │ └── 📂 [modules]/ # 各业务模块状态管理
│ ├── 📂 types/ # TypeScript类型
│ │ ├── 📄 auth.ts # 认证类型
│ │ ├── 📄 navigation.ts # 导航类型
│ │ └── 📄 business.ts # 业务类型
│ ├── 📂 styles/ # 样式文件
│ │ ├── 📄 globals.css # 全局样式
│ │ └── 📄 components.css # 组件样式
│ ├── 📂 public/ # 🆕 静态资源目录
│ │ ├── 📄 favicon.ico # 网站图标
│ │ ├── 📄 logo.png # 应用Logo
│ │ ├── 📄 manifest.json # PWA配置文件
│ │ └── 📂 images/ # 图片资源
│ ├── 📂 config/ # 🆕 特性优先配置系统
│ │ ├── 📂 types/ # 配置类型定义
│ │ ├── 📂 environments/ # 环境配置
│ │ ├── 📂 features/ # 特性配置
│ │ └── 📄 config-manager.ts # 配置管理器
│ ├── 📂 apis/ # 🆕 API管理系统
│ │ ├── 📄 index.ts # API统一入口
│ │ ├── 📄 interceptor.ts # 请求拦截器
│ │ └── 📂 subModules/ # 7大业务模块API
│ ├── 📄 package.json # 项目配置
│ ├── 📄 next.config.js # Next.js 配置
│ ├── 📄 tailwind.config.js # Tailwind 配置
│ ├── 📄 tsconfig.json # TypeScript 配置
│ ├── 📄 .eslintrc.js # ESLint 配置
│ ├── 📄 .prettierrc # Prettier 配置
│ └── 📄 README.md # 项目说明
```
## Next.js App Router 核心特性
### 1. 路由系统变更
**原 React Router 系统** → **Next.js App Router 系统**
```typescript
// 原路由方式 (React Router)
/agricultural-machinery/archive/machinery-entry
// 新路由方式 (Next.js App Router)
/agricultural-machinery/archive/machinery-entry
```
### 2. 文件命名规范
| React Router | Next.js App Router | 说明 |
|-------------|-------------------|------|
| `index.jsx` | `page.tsx` | 页面组件 |
| - | `layout.tsx` | 布局组件 |
| - | `loading.tsx` | 加载组件 |
| - | `error.tsx` | 错误组件 |
| - | `not-found.tsx` | 404页面 |
| - | `route.ts` | API路由 |
### 3. 布局系统
Next.js App Router 提供了嵌套布局系统：
```typescript
// app/layout.tsx - 根布局
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
{children}
);
}
// app/agricultural-machinery/layout.tsx - 农机系统布局
export default function MachineryLayout({ children }: { children: React.ReactNode }) {
return (
);
}
```
### 4. 路由组和权限控制
使用路由组 `(auth)` 实现权限控制：
```typescript
// app/(auth)/layout.tsx - 认证布局
export default function AuthLayout({ children }: { children: React.ReactNode }) {
return (
{children}
);
}
// app/(auth)/login/page.tsx - 登录页面
export default function LoginPage() {
return ;
}
```
### 5. 数据获取方式
```typescript
// Server Components - 服务器端数据获取
async function getMachineryData() {
const res = await fetch('http://localhost:8080/api/machinery', {
cache: 'no-store'
});
return res.json();
}
export default async function MachineryPage() {
const data = await getMachineryData();
return ;
}
// Client Components - 客户端数据获取
'use client';
import { useState, useEffect } from 'react';
export default function MachineryPage() {
const [data, setData] = useState([]);
useEffect(() => {
fetch('/api/machinery')
.then(res => res.json())
.then(setData);
}, []);
return ;
}
```
### 6. API路由
```typescript
// app/api/machinery/route.ts
import { NextRequest, NextResponse } from 'next/server';
export async function GET(request: NextRequest) {
// 获取农机列表
return NextResponse.json({ machinery: [] });
}
export async function POST(request: NextRequest) {
// 创建农机
const body = await request.json();
return NextResponse.json({ success: true });
}
```
### 7. 错误处理
```typescript
// app/error.tsx - 全局错误处理
'use client';
export default function Error({ error, reset }: { error: Error; reset: () => void }) {
return (
出现了错误！
);
}
// app/agricultural-machinery/error.tsx - 农机系统错误处理
export default function MachineryError({ error }: { error: Error }) {
return (
);
}
```
### 8. 加载状态
```typescript
// app/agricultural-machinery/loading.tsx
export default function MachineryLoading() {
return (
);
}
```
## Next.js App Router 优势
### 1. **性能优化**
- 自动代码分割
- 服务器组件渲染
- 客户端组件按需加载
- 流式渲染支持
### 2. **SEO 友好**
- 服务器端渲染 (SSR)
- 静态站点生成 (SSG)
- 增量静态再生 (ISR)
### 3. **开发体验**
- 文件系统路由
- 内置类型安全
- 热模块替换
- 快速刷新
### 4. **布局系统**
- 嵌套布局
- 共享布局
- 路由组
- 并行路由
## 迁移指南
### 从 React Router 到 Next.js App Router
1. **目录结构迁移**
```
pages/ → app/
index.jsx → page.tsx
```
2. **路由配置移除**
```typescript
// 移除 React Router 配置
// 删除 router/index.js
// 删除路由守卫组件
```
3. **布局组件重构**
```typescript
// 原 Layout.jsx
export default function Layout({ children }) {
return {children}
;
}
// 新 layout.tsx
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
{children}
);
}
```
4. **数据获取重构**
```typescript
// 原 useEffect 方式
useEffect(() => {
fetchData().then(setData);
}, []);
// 新 async/await 方式
const data = await fetchData();
```
5. **导航方式变更**
```typescript
// 原 useNavigate
const navigate = useNavigate();
navigate('/machinery');
// 新 useRouter
const router = useRouter();
router.push('/machinery');
```
---
*本文档基于 Mary 的头脑风暴分析结果生成，为 crop-x 项目提供 Next.js App Router 版本的完整技术架构方案。*