🌾 禾盈慧

智农兴业，用了禾盈慧，不愁当掌柜

📖 项目介绍

禾盈慧是一个综合性农业数字化平台，通过"融资 + 销售 + 服务 + 数据"四位一体模式，为农户、技术专家、银行/投资方、买家/采购商提供全方位的智慧农业解决方案。

🎨 设计特色

• 品牌色彩: 禾青绿（#2E7D32）+ 丰收黄（#F6C945）
• 响应式设计: 桌面端优先策略
• 完全中文化: 界面和交互完全本土化

⚡ 技术栈

• 前端框架: Vue 3 + TypeScript
• 构建工具: Vite
• 路由管理: Vue Router
• 状态管理: Pinia
• 样式方案: Tailwind CSS
• 图标组件: Lucide Vue

🏗️ 项目结构

/
├── .env.example                 # 环境变量配置模板
├── .env.development            # 开发环境配置
├── .env.production             # 生产环境配置
├── src/                          # 源代码目录
│   ├── components/               # Vue组件
│   │   ├── shared/              # 共享基础组件
│   │   ├── layout/              # 布局组件
│   │   └── home/                # 首页业务组件
│   ├── pages/                   # 页面组件
│   ├── router/                  # 路由配置
│   ├── stores/                  # 状态管理
│   ├── types/                   # TypeScript类型定义
│   └── styles/                  # 全局样式
├── App.vue                      # 根组件
├── main.ts                      # 应用入口
├── index.html                   # HTML模板
├── vite.config.ts              # Vite配置
├── tailwind.config.js          # Tailwind配置
└── package.json                # 项目依赖

🚀 快速开始

环境要求

• Node.js 20.19.5
• npm 10.8.2

环境配置

1. 复制环境变量模板文件：

cp .env.example .env.development

2. 根据需要修改 .env.development 中的配置：

# 主要配置项
VITE_API_BASE_URL=http://localhost:3000/api    # 后端API地址 (NestJS默认3000端口)
VITE_BACKEND_URL=http://localhost:3000         # 后端服务地址
VITE_APP_TITLE=禾盈慧农业数字化平台 (开发环境) # 应用标题
VITE_CAPTCHA_CODE=hyh6                         # 开发环境验证码

安装依赖

npm install

启动开发服务器

npm run dev

构建生产版本

npm run build

预览生产构建

npm run preview

📱 响应式断点

/* 桌面端优先策略 */
xl: '1280px'    /* 大屏桌面 */
lg: '1024px'    /* 桌面 */
md: '768px'     /* 平板 */
sm: '640px'     /* 大屏手机 */

🎨 设计系统

色彩系统

--primary-green: #2E7D32;      /* 禾青绿 */
--harvest-yellow: #F6C945;     /* 丰收黄 */
--info-blue: #1E88E5;          /* 信息蓝 */

字体系统

• 主字体: Inter, PingFang SC, Microsoft YaHei
• 基准字体大小: 14px（桌面端16px）

📋 开发规范

组件命名

• 页面组件：PascalCase (HomePage.vue)
• 业务组件：PascalCase (FinancialProducts.vue)
• 基础组件：PascalCase (Button.vue)

样式规范

• 优先使用Tailwind CSS工具类
• 桌面端优先响应式设计
• 保持设计系统一致性

代码规范

• 使用TypeScript进行类型约束
• 遵循Vue 3 Composition API最佳实践
• 保持组件单一职责原则

🤝 贡献指南

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

📞 联系我们

• 官网: https://www.heyinghui.com
• 邮箱: service@heyinghui.com
• 电话: 400-8888-6666

---

禾盈慧团队 © 2025 - 让农业更智慧，让收益更丰盈