添加 IntelliJ IDEA 项目配置文件

This commit is contained in:
ylweng
2025-09-02 01:23:16 +08:00
commit 59cfe620fe
25 changed files with 6734 additions and 0 deletions

View File

@@ -0,0 +1,207 @@
# Live Cattle Procurement Intelligent Digital System - Product Requirements Document
## Version History
| Version | Date | Author | Description |
|---------|------|--------|-------------|
| v1.0 | 2024-01-20 | Product Manager | Initial PRD |
## 1. Project Overview
### 1.1 Project Background
To address issues of information opacity, non-standard processes, and difficult risk control in live cattle procurement, develop a digital management system for live cattle procurement SOP.
### 1.2 Project Objectives
- Achieve standardized, digital management of procurement processes
- Improve procurement efficiency and reduce operational risks
- Ensure traceable cattle quality and secure transactions
### 1.3 Success Criteria
- 30% reduction in procurement process time
- Operational error rate reduced to below 1%
- Customer satisfaction rate reaches 95% or higher
## 2. User Roles and Use Cases
### 2.1 User Roles
| Role | Responsibilities | System Permissions |
|------|-----------------|-------------------|
| Purchaser | Initiate procurement needs, confirm acceptance, approve payments | Order creation, acceptance confirmation, payment approval |
| Trader | Forward orders, manage suppliers, handle fund settlement | Order management, supplier management, settlement processing |
| Supplier | Prepare cattle, manage loading, provide documents | Cattle information maintenance, loading management, document upload |
| Driver | Execute transportation, report status, handle document transfer | Transport tracking, status reporting, document confirmation |
| Internal Staff | Internal operations and management | Internal system access and management functions |
### 2.2 Core Use Cases
1. **Procurement Order Management** - Purchaser creates orders, trader forwards orders
2. **Cattle Verification Management** - Supplier prepares cattle, uploads quarantine certificates
3. **Transport Tracking Management** - Driver reports real-time transport status
4. **Arrival Acceptance Management** - Purchaser confirms acceptance, handles exceptions
5. **Settlement Payment Management** - Automatic calculation of payments, online payment
## 3. Functional Requirements
### 3.1 Procurement Planning Phase
#### User Story: As a Purchaser, I want to create procurement orders, so that procurement requirements are clear
**Acceptance Criteria:**
- Given the purchaser logs into the system
- When filling in "Procurement Order" information
- Then the system generates a pending confirmation order
- And includes complete information such as breed, weight, quantity, unit price
#### User Story: As a Trader, I want to review supplier qualifications, so that supplier compliance is ensured
**Acceptance Criteria:**
- Given the trader views supplier information
- When verifying business license and quarantine certificate issuance capability
- Then the system records review results
- And supports document file upload and viewing
### 3.2 Pre-loading Preparation
#### User Story: As a Driver, I want to complete vehicle registration, so that transport vehicles are compliant
**Acceptance Criteria:**
- Given the driver prepares for loading
- When uploading empty truck weighing video and disinfection certificate
- Then the system verifies video completeness
- And on-site veterinarian confirms disinfection certificate online
#### User Story: As a Supplier, I want to prepare cattle verification, so that cattle meet requirements
**Acceptance Criteria:**
- Given the supplier prepares for loading
- When providing "Animal Quarantine Qualification Certificate"
- And ensuring empty water and empty trough time ≥ 8 hours
- Then the system records verification information
- And supports weight range configuration for different breeds
### 3.3 Transport Delivery
#### User Story: As a Driver, I want to report real-time transport status, so that the purchasing party knows transport progress
**Acceptance Criteria:**
- Given the driver is during transport
- When automatically reporting location and cattle status every 10 minutes
- Then the system records transport trajectory
- And supports video status reporting
#### User Story: As a Purchaser, I want to perform arrival acceptance, so that cattle quality is ensured
**Acceptance Criteria:**
- Given within 2 hours after cattle arrival
- When the purchaser accepts the cattle
- Then the system records acceptance results
- And supports exception situation recording and handling
### 3.4 Settlement Payment
#### User Story: As a System, I want to automatically calculate settlement amount, so that manual errors are reduced
**Acceptance Criteria:**
- Given acceptance is completed
- When the system obtains loading weight and unit price
- Then automatically calculates: loading weight × unit price - advance payment
- And generates settlement statement
#### User Story: As a Purchaser, I want to make online payment of balance, so that transaction is completed
**Acceptance Criteria:**
- Given within 3 hours after acceptance
- When the purchaser confirms the settlement statement
- Then the system supports online payment
- And generates payment voucher
### 3.5 Exception Handling
#### User Story: As a System, I want to automatically calculate penalty fees, so that违约处理 is standardized
**Acceptance Criteria:**
- Given违约情况 occurs
- When the system identifies违约类型
- Then calculates penalty at 0.5% of daily contract amount
- And generates违约处理单
## 4. Non-Functional Requirements
### 4.1 Performance Requirements
- System response time: < 2 seconds
- Concurrent users: Support 100+ users online simultaneously
- Data storage: Video files permanently saved
### 4.2 Security Requirements
- Data transmission encryption: HTTPS protocol
- Identity authentication: Multi-factor authentication
- Permission control: Role-based access control
- Data backup: Automatic daily backup
### 4.3 Reliability Requirements
- System availability: 99.9%
- Fault recovery: < 30 minutes
- Data consistency: Transaction integrity guarantee
## 5. Technical Architecture
### 5.1 Mini-Program Matrix (uni-app Technology)
- **Client Mini-Program**: For purchasers to create orders and track progress
- **Supplier Mini-Program**: For suppliers to manage cattle preparation and documents
- **Driver Mini-Program**: For drivers to report transport status and locations
- **Internal Staff Mini-Program**: For internal operations and management
### 5.2 Unified System Architecture
- **Single Database**: All three systems (Website, Admin System, Mini-Programs) use the same database
- **Unified User Center**: Single sign-on across all platforms with consistent authentication
- **Consistent Interaction Design**: Unified UI/UX design standards across all interfaces
- **Real-time Data Sync**: WebSocket-based real-time data synchronization
### 5.3 System Integration
- **API Gateway**: Unified API management and authentication
- **Microservices Architecture**: Modular service design for scalability
- **Message Queue**: Asynchronous processing for better performance
- **Cloud Storage**: Secure file and video storage solution
## 6. Prototype Description
### 6.1 Interface Key Elements
- **Dashboard View**: Visualized procurement process status
- **Order Management**: Integrated order creation, review, and tracking
- **Map View**: Real-time transport trajectory display
- **Video Monitoring**: Loading and unloading process video viewing
- **Settlement Center**: Automatic calculation, online payment
### 6.2 Interaction Flow
1. Purchaser creates order Trader confirms forwarding Supplier accepts order
2. Supplier prepares cattle Uploads certificate documents Driver vehicle registration
3. Loading monitoring Transport tracking Arrival acceptance
4. System automatic settlement Online payment Document archiving
## 7. Scope Definition
### This Version Includes:
- Complete digital management of live cattle procurement process
- Full functionality for five user roles (including internal staff)
- Dual order process (PurchaserTraderSupplier)
- Real-time transport tracking and status reporting
- Automated settlement and payment processing
- Uni-app based mini-program matrix
- Unified database and user center
- Consistent interaction design across all platforms
### This Version Excludes:
- Cattle breeding management functionality
- Sales-side functionality
- Complex financial accounting functions
- Multi-language support
## 8. Priority Ranking
### P0 (Highest Priority)
- Procurement order creation and management
- Cattle verification and document management
- Real-time transport status tracking
- Arrival acceptance and exception handling
- Unified user authentication system
- Real-time data synchronization
### P1 (High Priority)
- Automated settlement calculation
- Online payment functionality
- Document archiving and management
- Data statistics and analysis
- Mini-program development (uni-app)
- API gateway implementation
### P2 (Medium Priority)
- Mobile APP development
- System integration interfaces
- Advanced reporting functionality
- Message notification system
- Performance optimization
- Security enhancement features

345
docs/官网需求文档.md Normal file
View File

@@ -0,0 +1,345 @@
# 官网需求文档 - 活牛采购智能数字化系统
## 版本历史
| 版本 | 日期 | 作者 | 说明 |
|------|------|------|------|
| v1.0 | 2024-01-25 | 产品经理 | 初版官网需求文档 |
## 1. 项目概述
### 1.1 项目背景
为配合活牛采购智能数字化系统的推广和客户服务,开发专业的企业官网,展示系统功能价值,提供产品介绍和客户服务入口。
### 1.2 项目目标
- 建立专业的企业形象和品牌展示
- 清晰传达活牛采购智能数字化系统的核心价值
- 提供系统功能演示和客户咨询入口
- 支持潜在客户了解和试用系统
### 1.3 成功标准
- 官网访问转化率达到5%以上
- 平均页面停留时间超过2分钟
- 客户咨询量提升50%
- 搜索引擎关键词排名前3
## 2. 目标用户分析
### 2.1 主要用户群体
| 用户类型 | 需求特点 | 访问目的 |
|----------|----------|----------|
| 养殖企业主 | 规模化养殖,采购需求频繁 | 了解系统如何规范采购流程 |
| 贸易商 | 中介服务,需要效率工具 | 寻找订单管理和结算工具 |
| 供应商 | 牛只供应,需要客户资源 | 展示资质,接入采购平台 |
| 行业从业者 | 职业发展,行业信息 | 了解行业动态和技术趋势 |
### 2.2 用户场景
1. **信息获取型**:通过搜索引擎找到官网,了解系统功能
2. **需求明确型**:已有采购需求,直接寻找解决方案
3. **比较选择型**:对比多个系统,评估性价比
4. **售后服务型**:现有客户,需要技术支持
## 3. 功能需求
### 3.1 核心页面功能
#### 3.1.1 首页Landing Page
**用户故事**As a 潜在客户, I want to 快速了解系统价值, so that 决定是否深入了解
**功能要求:**
- 企业LOGO和品牌口号展示
- 核心功能亮点轮播展示
- 客户案例和数据统计展示
- 主要功能模块快捷入口
- 咨询入口和试用申请按钮
#### 3.1.2 产品介绍页
**用户故事**As a 详细调研用户, I want to 深入了解系统功能, so that 评估是否适合
**功能要求:**
- 系统架构和技术栈介绍
- 四大用户角色功能详解
- 采购全流程可视化展示
- 系统特色和优势说明
- 功能演示视频嵌入
#### 3.1.3 解决方案页
**用户故事**As a 有特定需求用户, I want to 找到针对性的解决方案, so that 解决具体问题
**功能要求:**
- 按行业细分解决方案
- 按企业规模定制方案
- 成功案例详细分析
- ROI计算器和效益分析
#### 3.1.4 客户案例页
**用户故事**As a 谨慎决策用户, I want to 查看真实客户反馈, so that 建立信任
**功能要求:**
- 客户成功案例展示
- 客户评价和 testimonials
- 使用数据统计和效果验证
- 案例分类和筛选功能
#### 3.1.5 关于我们页
**用户故事**As a 关注企业背景用户, I want to 了解公司实力, so that 建立合作信心
**功能要求:**
- 公司发展历程和里程碑
- 团队介绍和专家资质
- 合作伙伴和资质认证
- 联系信息和办公地址
#### 3.1.6 新闻动态页
**用户故事**As a 行业关注者, I want to 获取最新资讯, so that 了解行业动态
**功能要求:**
- 行业新闻和公司动态
- 产品更新和技术文章
- 活动信息和会议报道
- 分类筛选和搜索功能
#### 3.1.7 联系我们页
**用户故事**As a 有意向客户, I want to 方便地联系企业, so that 获取详细咨询
**功能要求:**
- 多联系方式(电话、邮箱、微信)
- 在线客服系统集成
- 预约演示表单
- 地图定位和交通指引
### 3.2 交互功能需求
#### 3.2.1 在线咨询系统
**用户故事**As a 潜在客户, I want to 实时咨询问题, so that 快速获得解答
**功能要求:**
- 在线客服聊天窗口
- 常见问题自动回复
- 客服工作时间显示
- 留言和回拨功能
#### 3.2.2 试用申请功能
**用户故事**As a 感兴趣用户, I want to 申请系统试用, so that 体验系统功能
**功能要求:**
- 试用申请表单
- 企业信息收集
- 需求描述字段
- 自动邮件确认
#### 3.2.3 资料下载功能
**用户故事**As a 深入研究用户, I want to 下载详细资料, so that 后续参考
**功能要求:**
- 产品手册PDF下载
- 技术白皮书下载
- 案例研究文档
- 需要联系信息换取资料
#### 3.2.4 预约演示功能
**用户故事**As a 决策者, I want to 预约产品演示, so that 深入了解系统
**功能要求:**
- 在线预约日历
- 时间段选择
- 参会人员信息
- 自动提醒和确认
## 4. 非功能需求
### 4.1 性能要求
- 页面加载时间:< 3秒
- 首屏加载时间< 1.5秒
- 移动端适配完美响应式
- 浏览器兼容性Chrome, Firefox, Safari, Edge
### 4.2 SEO优化要求
- 页面标题和meta描述优化
- 结构化数据标记
- 面包屑导航
- XML网站地图
- 页面速度优化
### 4.3 安全要求
- HTTPS加密传输
- 表单数据验证和过滤
- 防止XSS和CSRF攻击
- 定期安全扫描
### 4.4 可访问性要求
- WCAG 2.1 AA标准合规
- 键盘导航支持
- 屏幕阅读器兼容
- 颜色对比度达标
## 5. 设计规范
### 5.1 视觉设计
**色彩方案**
- 主色调农业绿色(#4CAF50)
- 辅助色深蓝色(#1976D2)
- 中性色灰色调(#f5f5f5, #eeeeee, #9e9e9e)
- 强调色橙色(#FF9800)
**字体规范:**
- 中文思源黑体
- 英文Inter字体
- 字号14px/16px/18px/20px/24px/32px/48px
### 5.2 内容规范
**文案风格**
- 专业但不晦涩
- 简洁明了
- 重点突出
- 呼唤行动
**图片规范:**
- 高质量专业摄影
- 统一风格和色调
- 优化加载性能
- alt标签完整
### 5.3 交互规范
**导航设计**
- 主导航固定顶部
- 面包屑导航
- 页脚全面链接
- 返回顶部按钮
**表单设计:**
- 清晰标签和占位符
- 即时验证反馈
- 进度指示器
- 成功/错误状态
## 6. 技术实施方案
### 6.1 技术栈选择
- **前端技术**HTML5 + Bootstrap 5
- **JavaScript**原生JavaScript + jQuery可选
- **样式框架**Bootstrap 5 + 自定义CSS
- **构建工具**无构建步骤或使用轻量级工具如Gulp
- **响应式设计**Bootstrap网格系统
### 6.2 项目结构
```
website/
├── css/ # 样式文件
│ ├── bootstrap.min.css
│ ├── custom.css # 自定义样式
│ └── responsive.css # 响应式调整
├── js/ # JavaScript文件
│ ├── bootstrap.bundle.min.js
│ ├── jquery.min.js # 可选
│ └── main.js # 主要业务逻辑
├── images/ # 图片资源
│ ├── logo.png
│ ├── hero-banner.jpg
│ └── icons/
├── pages/ # HTML页面文件
│ ├── index.html # 首页
│ ├── product.html # 产品介绍
│ ├── solutions.html # 解决方案
│ ├── cases.html # 客户案例
│ ├── about.html # 关于我们
│ ├── news.html # 新闻动态
│ └── contact.html # 联系我们
├── includes/ # 公共包含文件
│ ├── header.html # 头部导航
│ ├── footer.html # 页脚
│ └── scripts.html # 公共脚本
└── assets/ # 其他静态资源
├── fonts/ # 字体文件
├── docs/ # 文档资料
└── favicon.ico
```
### 6.3 第三方服务集成
- **数据分析**Google Analytics + 百度统计
- **在线客服**腾讯云客服或类似服务
- **邮件服务**SendGrid或Mailchimp
- **地图服务**高德地图API
- **表单处理**Formspree或自定义后端
## 7. 内容策略
### 7.1 核心内容规划
**首页**
- 吸引人的主标语和价值主张
- 关键功能亮点展示
- 客户信任指标用户数交易额等
- 明确的行动号召
**产品页:**
- 系统功能模块详细介绍
- 技术架构和安全性说明
- 移动端和PC端功能对比
- 集成和扩展能力
**解决方案:**
- 按行业分类的解决方案
- 按企业规模的定制方案
- 成功案例引用
- 效益分析和ROI计算
### 7.2 SEO内容规划
**目标关键词**
- 活牛采购系统
- 畜牧业管理软件
- 农产品采购平台
- 养殖业数字化
- 牲畜交易管理
**内容类型:**
- 产品功能详细介绍
- 行业解决方案文章
- 客户案例研究
- 技术白皮书
- 行业趋势分析
## 8. 开发计划
### 8.1 阶段一MVP版本2周
- 首页设计和开发
- 产品介绍页基础版
- 联系页面和表单
- 基础响应式布局
### 8.2 阶段二功能完善2周
- 完整产品功能页面
- 客户案例展示
- 新闻动态系统
- SEO优化实施
### 8.3 阶段三优化增强1周
- 在线客服集成
- 数据分析配置
- 性能优化
- 多语言支持可选
## 9. 成功度量指标
### 9.1 流量指标
- 月访问量目标10,000+
- 跳出率< 40%
- 平均会话时长> 2分钟
- 页面/会话:> 3
### 9.2 转化指标
- 试用申请数月100+
- 咨询表单提交月50+
- 资料下载数月200+
- 预约演示月20+
### 9.3 业务指标
- 销售线索质量评分
- 客户来源渠道分析
- ROI和转化成本
- 客户生命周期价值
## 10. 维护和更新计划
### 10.1 内容更新
- 每月发布2-4篇行业文章
- 季度更新客户案例
- 半年更新产品功能
- 年度进行设计刷新
### 10.2 技术维护
- 每月安全扫描和更新
- 季度性能优化
- 半年技术栈评估
- 年度架构review
---
*本文档为活牛采购智能数字化系统官网的需求规范,用于指导官网的设计、开发和运营工作。*

1990
docs/技术实施方案.md Normal file

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,177 @@
# 活牛采购智能数字化系统 - 产品需求文档
## 版本历史
| 版本 | 日期 | 作者 | 说明 |
|------|------|------|------|
| v1.0 | 2024-01-20 | 产品经理 | 初版PRD |
## 1. 项目概述
### 1.1 项目背景
为解决活牛采购过程中信息不透明、流程不规范、风险控制难等问题,开发活牛采购智能数字化管理系统。
### 1.2 项目目标
- 实现采购流程标准化、数字化管理
- 提高采购效率,降低操作风险
- 确保牛只质量可追溯,交易安全可靠
### 1.3 成功标准
- 采购流程耗时减少30%
- 操作错误率降低至1%以下
- 客户满意度达到95%以上
## 2. 用户角色与用例
### 2.1 用户角色
| 角色 | 职责描述 | 系统权限 |
|------|----------|----------|
| 采购人 | 发起采购需求,验收确认,支付审批 | 订单创建、验收确认、支付审批 |
| 贸易商 | 订单转发,供应商管理,资金结算 | 订单管理、供应商管理、结算处理 |
| 供应商 | 牛只准备,装车管理,单据提供 | 牛只信息维护、装车管理、单据上传 |
| 司机 | 运输执行,状态上报,单据交接 | 运输跟踪、状态上报、单据确认 |
### 2.2 核心用例
1. **采购订单管理** - 采购人创建订单,贸易商转发订单
2. **牛只核验管理** - 供应商准备牛只,上传检疫证明
3. **运输跟踪管理** - 司机实时上报运输状态
4. **到货验收管理** - 采购人验收确认,处理异常
5. **结算支付管理** - 自动计算款项,在线支付
## 3. 功能需求
### 3.1 采购计划阶段
#### 用户故事As a 采购人, I want to 创建采购订单, so that 明确采购需求
**验收标准:**
- Given 采购人登录系统
- When 填写《采购订货单》信息
- Then 系统生成待确认订单
- And 包含品种、重量、数量、单价等完整信息
#### 用户故事As a 贸易商, I want to 审核供应商资质, so that 确保供应商合规
**验收标准:**
- Given 贸易商查看供应商信息
- When 核实营业执照和检疫证明开具能力
- Then 系统记录审核结果
- And 支持证件文件上传和查看
### 3.2 装车前准备
#### 用户故事As a 司机, I want to 完成车辆备案, so that 确保运输车辆合规
**验收标准:**
- Given 司机准备装车
- When 上传空车过磅视频和消毒证明
- Then 系统验证视频完整性
- And 驻场兽医在线确认消毒证明
#### 用户故事As a 供应商, I want to 准备牛只核验, so that 确保牛只符合要求
**验收标准:**
- Given 供应商准备装车
- When 提供《动物检疫合格证明》
- And 确保空水空槽时间≥8小时
- Then 系统记录核验信息
- And 支持不同品种的重量区间配置
### 3.3 运输交付
#### 用户故事As a 司机, I want to 实时上报运输状态, so that 采购方掌握运输进度
**验收标准:**
- Given 司机在运输途中
- When 每10分钟自动上报位置和牛只状态
- Then 系统记录运输轨迹
- And 支持视频状态上报
#### 用户故事As a 采购人, I want to 进行到货验收, so that 确保牛只质量
**验收标准:**
- Given 牛只到岸后2小时内
- When 采购人验收牛只
- Then 系统记录验收结果
- And 支持异常情况记录和处理
### 3.4 结算支付
#### 用户故事As a 系统, I want to 自动计算结算金额, so that 减少人工错误
**验收标准:**
- Given 验收完成
- When 系统获取上车重量和单价
- Then 自动计算:上车重量×单价 - 预付款
- And 生成结算单
#### 用户故事As a 采购人, I want to 在线支付尾款, so that 完成交易
**验收标准:**
- Given 验收后3小时内
- When 采购人确认结算单
- Then 系统支持在线支付
- And 生成支付凭证
### 3.5 异常处理
#### 用户故事As a 系统, I want to 自动计算违约金, so that 规范违约处理
**验收标准:**
- Given 发生违约情况
- When 系统识别违约类型
- Then 按每日合同金额0.5%计算违约金
- And 生成违约处理单
## 4. 非功能需求
### 4.1 性能要求
- 系统响应时间:< 2秒
- 并发用户数支持100+用户同时在线
- 数据存储视频文件永久保存
### 4.2 安全要求
- 数据传输加密HTTPS协议
- 身份认证多因素认证
- 权限控制基于角色的访问控制
- 数据备份每日自动备份
### 4.3 可靠性要求
- 系统可用性99.9%
- 故障恢复< 30分钟
- 数据一致性事务完整性保证
## 5. 原型说明
### 5.1 界面关键元素
- **驾驶舱视图**采购流程状态可视化
- **订单管理**订单创建审核跟踪一体化
- **地图视图**实时运输轨迹展示
- **视频监控**装车卸货过程视频查看
- **结算中心**自动计算在线支付
### 5.2 交互流程
1. 采购人创建订单 贸易商确认转发 供应商接单
2. 供应商准备牛只 上传证明文件 司机车辆备案
3. 装车监控 运输跟踪 到货验收
4. 系统自动结算 在线支付 文件归档
## 6. 范围界定
### 本版本包含:
- 活牛采购全流程数字化管理
- 四类用户角色完整功能
- 双订单流程采购人贸易商供应商
- 运输实时跟踪和状态上报
- 自动化结算和支付处理
### 本版本不包含:
- 牛只养殖管理功能
- 销售端功能
- 复杂的财务核算功能
- 多语言支持
## 7. 优先级排序
### P0最高优先级
- 采购订单创建和管理
- 牛只核验和证件管理
- 运输状态实时跟踪
- 到货验收和异常处理
### P1高优先级
- 自动化结算计算
- 在线支付功能
- 文件归档和管理
- 数据统计和分析
### P2中优先级
- 移动端APP开发
- 系统集成接口
- 高级报表功能
- 消息通知系统