初始化项目结构并添加官网首页

2025-12-08 15:22:56 +08:00
commit f776972645
44 changed files with 2593 additions and 0 deletions
--- a/docs/后端开发文档.md
+++ b/docs/后端开发文档.md
--- a/docs/后端架构文档.md
+++ b/docs/后端架构文档.md
--- a/docs/后端管理开发文档.md
+++ b/docs/后端管理开发文档.md
--- a/docs/后端管理需求文档.md
+++ b/docs/后端管理需求文档.md
--- a/docs/安全文档.md
+++ b/docs/安全文档.md
--- a/docs/官网需求文档.md
+++ b/docs/官网需求文档.md
@@ -0,0 +1,46 @@
+# 云南智慧牛产业平台 - 官网需求文档
+
+## 1. 概述
+云南智慧牛产业平台官网是平台对外的门户窗口，主要承担品牌展示、信息发布、用户引导和政策宣传等功能。
+
+## 2. 核心功能模块
+
+### 2.1 首页
+- **轮播图**：全屏视差滚动展示平台核心价值、最新活动或政策亮点。
+- **平台简介**：简要介绍“云南智慧牛产业平台”的背景、使命和愿景。
+- **核心服务**：以卡片形式展示智慧养殖、牛只交易、金融服务、政府监管四大核心板块入口。
+- **平台数据**：可视化展示平台入驻企业数、牛只总数、交易额等关键指标（集成 ECharts 图表）。
+- **合作伙伴**：展示合作的政府机构、金融机构、大型养殖企业 Logo（支持懒加载）。
+
+### 2.2 关于我们
+- **平台背景**：详细介绍项目背景、发展历程。
+- **发展历程**：时间轴展示关键里程碑。
+- **联系我们**：提供联系方式、地址、地图导航。
+
+### 2.3 解决方案
+- **智慧养殖**：介绍养殖管理系统的功能亮点（牛只档案、健康监测等）。
+- **牛只交易**：介绍交易流程、安全保障机制。
+- **金融赋能**：介绍活体抵押贷、养殖保险等金融产品。
+- **政府监管**：介绍全链条监管功能。
+
+### 2.4 新闻中心
+- **行业资讯**：畜牧业相关新闻。
+- **政策法规**：国家及云南省相关畜牧业政策。
+- **平台动态**：平台版本更新、活动发布等。
+
+### 2.5 帮助中心 / 联系我们
+- **常见问题**：FAQ 列表。
+- **在线留言**：提供表单提交合作意向。
+- **联系方式**：电话、邮箱、地址展示。
+
+## 3. 非功能需求
+- **响应式设计**：基于 Bootstrap 3 Grid 系统，兼容主流浏览器（IE9+），适配 PC 和移动端。
+- **性能优化**：使用 CDN 加速静态资源加载（Bootstrap, jQuery, ECharts）。
+- **SEO优化**：HTML5 语义化标签，针对“云南智慧牛”、“畜牧管理”等关键词优化 Meta 标签。
+- **交互体验**：界面简洁大气，操作流畅。
+
+## 4. 技术栈
+- **核心技术**：HTML5 + CSS3 + JavaScript (jQuery 1.12.4)
+- **UI 框架**：Bootstrap 3.4.1 (响应式布局 & 组件)
+- **数据可视化**：ECharts 5.4.3
+- **兼容性**：支持 IE9+, Chrome, Firefox, Safari, Edge
--- a/docs/小程序app开发文档.md
+++ b/docs/小程序app开发文档.md
--- a/docs/小程序app接口设计文档.md
+++ b/docs/小程序app接口设计文档.md
--- a/docs/小程序app需求文档.md
+++ b/docs/小程序app需求文档.md
--- a/docs/小程序架构文档.md
+++ b/docs/小程序架构文档.md
--- a/docs/数据库设计文档.md
+++ b/docs/数据库设计文档.md
@@ -0,0 +1,82 @@
+# 云南智慧牛产业平台 - 数据库设计文档
+
+## 1. 设计规范
+- **数据库引擎**: MySQL 8.0 InnoDB
+- **字符集**: utf8mb4_general_ci
+- **命名规范**: 小写下划线命名法 (snake_case)
+- **主键策略**: 分布式雪花算法 ID (BIGINT)
+
+## 2. 核心表结构
+
+### 2.1 用户中心
+#### 用户表 (`sys_user`)
+| 字段名 | 类型 | 长度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | BIGINT | 20 | 主键ID |
+| username | VARCHAR | 50 | 用户名 |
+| password | VARCHAR | 100 | 密码(BCrypt) |
+| phone | VARCHAR | 20 | 手机号 |
+| user_type | TINYINT | 4 | 用户类型(1:养殖户 2:交易商 3:监管员 4:银行) |
+| status | TINYINT | 4 | 状态(0:禁用 1:正常) |
+| create_time | DATETIME | | 创建时间 |
+
+#### 企业/牧场表 (`sys_farm`)
+| 字段名 | 类型 | 长度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | BIGINT | 20 | 主键ID |
+| user_id | BIGINT | 20 | 关联用户ID |
+| farm_name | VARCHAR | 100 | 牧场名称 |
+| address | VARCHAR | 200 | 详细地址 |
+| license_no | VARCHAR | 50 | 防疫合格证号 |
+| scale | INT | 11 | 养殖规模 |
+
+### 2.2 智慧养殖
+#### 牛只档案表 (`biz_cattle`)
+| 字段名 | 类型 | 长度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | BIGINT | 20 | 主键ID |
+| farm_id | BIGINT | 20 | 所属牧场ID |
+| ear_tag | VARCHAR | 50 | 耳标号(唯一) |
+| breed | VARCHAR | 50 | 品种 |
+| gender | TINYINT | 4 | 性别(1:公 2:母) |
+| birth_date | DATE | | 出生日期 |
+| weight | DECIMAL | 10,2 | 当前体重(kg) |
+| status | TINYINT | 4 | 状态(1:在栏 2:出栏 3:死亡) |
+
+#### 健康记录表 (`biz_health_record`)
+| 字段名 | 类型 | 长度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | BIGINT | 20 | 主键ID |
+| cattle_id | BIGINT | 20 | 牛只ID |
+| record_type | TINYINT | 4 | 类型(1:免疫 2:诊疗 3:检疫) |
+| description | TEXT | | 详情描述 |
+| operate_time | DATETIME | | 操作时间 |
+| operator | VARCHAR | 50 | 操作人 |
+
+### 2.3 交易中心
+#### 交易订单表 (`trade_order`)
+| 字段名 | 类型 | 长度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | BIGINT | 20 | 主键ID |
+| order_no | VARCHAR | 64 | 订单编号 |
+| seller_id | BIGINT | 20 | 卖家ID |
+| buyer_id | BIGINT | 20 | 买家ID |
+| amount | DECIMAL | 12,2 | 交易金额 |
+| status | TINYINT | 4 | 状态(0:待付款 1:待发货 2:运输中 3:已完成) |
+| cattle_ids | JSON | | 关联牛只ID列表 |
+
+### 2.4 基础信息
+#### 新闻资讯表 (`cms_news`)
+| 字段名 | 类型 | 长度 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | BIGINT | 20 | 主键ID |
+| title | VARCHAR | 200 | 标题 |
+| category | VARCHAR | 50 | 分类(policy/industry/platform) |
+| content | LONGTEXT | | 内容(HTML) |
+| view_count | INT | 11 | 浏览量 |
+| publish_time | DATETIME | | 发布时间 |
+
+## 3. 索引设计
+- `sys_user`: `uk_username` (username), `uk_phone` (phone)
+- `biz_cattle`: `uk_ear_tag` (ear_tag), `idx_farm_id` (farm_id)
+- `trade_order`: `uk_order_no` (order_no), `idx_seller` (seller_id), `idx_buyer` (buyer_id)
--- a/docs/整个项目的架构文档.md
+++ b/docs/整个项目的架构文档.md
@@ -0,0 +1,87 @@
+# 云南智慧牛产业平台 - 总体架构文档
+
+## 1. 架构概述
+本平台采用前后端分离的微服务/模块化单体架构，旨在构建一个覆盖肉牛产业全生命周期的数字化服务体系。平台由官网门户、管理后台、微信小程序和后端服务四大核心部分组成。
+
+## 2. 技术架构图
+```mermaid
+graph TD
+    User[用户/企业/政府] -->|HTTPS| Gateway[Nginx 网关]
+    
+    subgraph "前端应用层 (Frontend)"
+        Gateway -->|/| Website[官网门户 (Vue3 + Bootstrap5)]
+        Gateway -->|/admin| Admin[管理后台 (Vue3 + Element Plus)]
+        Gateway -->|/api| Backend[后端服务 API]
+        User -->|微信| MiniProgram[微信小程序 (Uni-app)]
+        MiniProgram -->|HTTPS| Backend
+    end
+
+    subgraph "后端服务层 (Backend)"
+        Backend[Java Spring Boot / Node.js NestJS]
+        Backend --> Service1[用户中心]
+        Backend --> Service2[牛只档案]
+        Backend --> Service3[交易中心]
+        Backend --> Service4[金融服务]
+    end
+
+    subgraph "数据存储层 (Data)"
+        Backend --> MySQL[(MySQL 主数据库)]
+        Backend --> Redis[(Redis 缓存)]
+        Backend --> OSS[(对象存储 - 图片/视频)]
+    end
+```
+
+## 3. 技术栈选型
+
+### 3.1 前端层
+- **官网门户 (Website)**
+    - **框架**: Vue 3 + Vite
+    - **UI库**: Bootstrap 5 (响应式适配)
+    - **图表**: ECharts 5
+    - **说明**: 侧重于品牌展示和信息发布，要求SEO友好和极致的响应式体验。
+
+- **管理后台 (Admin System)**
+    - **框架**: Vue 3 + Vite
+    - **UI库**: Element Plus
+    - **状态管理**: Pinia
+    - **说明**: 侧重于复杂表单处理、数据管理和权限控制。
+
+- **移动端/小程序 (Mini Program)**
+    - **框架**: Uni-app (Vue 3 语法)
+    - **说明**: 一套代码编译发布到微信小程序、H5等多端，方便养殖户和监管员现场作业。
+
+### 3.2 后端层 (Backend)
+- **开发语言**: Java (推荐) 或 Node.js
+- **核心框架**: Spring Boot 3 (Java) 或 NestJS (Node.js)
+- **ORM框架**: MyBatis-Plus / TypeORM
+- **API规范**: RESTful API + Swagger/OpenAPI 文档
+
+### 3.3 数据层
+- **关系型数据库**: MySQL 8.0 (存储业务数据)
+- **缓存数据库**: Redis 6.0 (会话管理、热点数据)
+- **文件存储**: MinIO 或 阿里云 OSS (牛只照片、监控视频)
+
+### 3.4 基础设施 & 运维
+- **操作系统**: CentOS 10
+- **容器化**: Docker + Docker Compose
+- **反向代理**: Nginx
+- **CI/CD**: Jenkins 或 GitLab CI (规划中)
+
+## 4. 核心业务流程
+1. **数据采集**: 养殖户通过小程序录入牛只信息（出生、防疫、称重）。
+2. **数据上链**: 关键数据（如检疫证明）存证，确保不可篡改。
+3. **交易撮合**: 买卖双方在平台发布需求，平台进行匹配并提供资金托管。
+4. **金融授信**: 银行根据养殖户的资产数据（牛只数量、价值）进行授信放款。
+5. **监管预警**: 异常移动、疫情风险自动触发预警推送给政府监管端。
+
+## 5. 目录结构规划
+```
+/
+├── website/          # 官网源代码 (Vue3 + Bootstrap)
+├── admin-system/     # 管理后台源代码 (Vue3 + Element Plus) - 待初始化
+├── mini-program/     # 小程序源代码 (Uni-app) - 待初始化
+├── backend/          # 后端服务源代码 (Spring Boot) - 待初始化
+├── docs/             # 项目文档
+├── scripts/          # 运维脚本
+└── README.md         # 项目入口说明
+```
--- a/docs/整个项目需求文档.md
+++ b/docs/整个项目需求文档.md
@@ -0,0 +1,48 @@
+# 云南智慧牛产业平台 - 需求规格说明书
+
+## 1. 项目背景
+云南省肉牛产业基础雄厚，但长期存在“散、小、乱”的问题，面临信息不对称、融资难、监管难等挑战。本项目旨在利用物联网、大数据等新一代信息技术，搭建全省统一的肉牛产业服务平台，实现全产业链的数字化转型。
+
+## 2. 项目目标
+1. **建立牛只电子身份证**：实现一牛一码，全生命周期可追溯。
+2. **构建可信交易体系**：解决活体交易中的信任问题，降低交易成本。
+3. **创新金融服务模式**：利用生物资产数字化，盘活养殖户资产，引入金融活水。
+4. **提升政府监管效能**：实现疫情精准防控和产业发展科学决策。
+
+## 3. 用户角色
+- **养殖户/企业**：牛只录入、日常养殖管理、发布买卖信息、申请贷款/保险。
+- **交易商/经纪人**：浏览牛源、发布收购需求、参与竞价。
+- **金融机构**：查看资产评估报告、审批贷款、保险理赔。
+- **政府监管部门**：查看产业大数据、防疫监管、屠宰检疫。
+- **普通访客**：浏览行业资讯、政策法规、平台公示信息。
+
+## 4. 功能需求概览
+
+### 4.1 智慧养殖模块
+- **档案管理**：牛只基本信息（品种、月龄、体重）、系谱信息。
+- **繁育管理**：发情监测、配种记录、妊娠检查、产犊记录。
+- **健康管理**：免疫记录、诊疗记录、用药记录。
+- **环境监测**：集成温湿度、氨气等传感器数据。
+
+### 4.2 牛只交易模块
+- **供需大厅**：买卖信息发布与搜索。
+- **在线竞拍**：直播看牛、在线出价、保证金管理。
+- **资金托管**：第三方支付集成，确认收货后分账。
+- **物流运输**：运输车辆预约、轨迹实时追踪。
+
+### 4.3 金融服务模块
+- **资产评估**：基于养殖数据的牛只价值动态评估模型。
+- **活体抵押**：在线申请抵押贷款，电子耳标+电子围栏远程监管。
+- **养殖保险**：在线投保、一键报案、远程定损。
+
+### 4.4 政府监管模块
+- **产业地图**：全省肉牛存栏分布热力图。
+- **防疫追溯**：疫苗发放核销、免疫覆盖率统计。
+- **检疫出证**：电子检疫证申请与核验。
+- **无害化处理**：病死牛处理流程全记录。
+
+## 5. 非功能需求
+- **高并发**：支持全省 50万+ 养殖户同时在线。
+- **高可用**：系统可用性 >= 99.9%。
+- **数据安全**：核心数据加密存储，符合等保三级要求。
+- **易用性**：针对农村用户群体优化界面，提供语音输入等便捷功能。
--- a/docs/测试文档.md
+++ b/docs/测试文档.md
--- a/docs/用户手册文档.md
+++ b/docs/用户手册文档.md
--- a/docs/管理后台开发文档.md
+++ b/docs/管理后台开发文档.md
--- a/docs/管理后台接口设计文档.md
+++ b/docs/管理后台接口设计文档.md
--- a/docs/管理后台架构文档.md
+++ b/docs/管理后台架构文档.md
--- a/docs/管理后台需求文档.md
+++ b/docs/管理后台需求文档.md
--- a/docs/运维文档.md
+++ b/docs/运维文档.md
--- a/docs/部署文档.md
+++ b/docs/部署文档.md
@@ -0,0 +1,121 @@
+# 云南智慧牛产业平台 - 部署与运维文档
+
+## 1. 部署环境
+- **操作系统**: CentOS 10 64位
+- **Web服务器**: Nginx 1.24+
+- **容器引擎**: Docker 24.0+
+- **容器编排**: Docker Compose 2.20+
+
+## 2. 目录结构规范
+服务器根目录建议为 `/opt/caiyunniu/`：
+```
+/opt/caiyunniu/
+├── docker-compose.yml    # 容器编排文件
+├── nginx/
+│   ├── conf.d/           # Nginx 配置文件
+│   ├── certs/            # SSL 证书
+│   └── html/             # 前端静态资源
+│       ├── website/      # 官网构建产物 (dist)
+│       └── admin/        # 管理后台构建产物 (dist)
+├── mysql/
+│   ├── data/             # 数据库数据卷
+│   └── init/             # 初始化 SQL 脚本
+├── redis/
+│   └── data/             # Redis 数据卷
+└── logs/                 # 应用日志
+```
+
+## 3. 前端部署 (Website)
+
+### 3.1 本地构建
+在开发机执行：
+```bash
+cd website
+npm install
+npm run build
+```
+构建完成后，生成的 `dist` 目录即为部署包。
+
+### 3.2 上传文件
+将 `dist` 目录内容上传至服务器：
+```bash
+scp -r dist/* user@server_ip:/opt/caiyunniu/nginx/html/website/
+```
+
+### 3.3 Nginx 配置示例
+```nginx
+server {
+    listen 80;
+    server_name www.caiyunniu.com;
+
+    # 强制跳转 HTTPS
+    return 301 https://$host$request_uri;
+}
+
+server {
+    listen 443 ssl http2;
+    server_name www.caiyunniu.com;
+
+    ssl_certificate /etc/nginx/certs/caiyunniu.pem;
+    ssl_certificate_key /etc/nginx/certs/caiyunniu.key;
+
+    # 官网前端
+    location / {
+        root /usr/share/nginx/html/website;
+        index index.html;
+        try_files $uri $uri/ /index.html; # Vue Router History 模式支持
+    }
+
+    # 后端 API 代理
+    location /api/ {
+        proxy_pass http://backend-service:8080/;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+## 4. 后端部署 (Backend)
+
+### 4.1 Docker 镜像构建
+在后端项目根目录创建 `Dockerfile`：
+```dockerfile
+FROM openjdk:17-jdk-alpine
+VOLUME /tmp
+COPY target/*.jar app.jar
+ENTRYPOINT ["java","-jar","/app.jar"]
+```
+
+### 4.2 Docker Compose 编排
+```yaml
+version: '3'
+services:
+  backend-service:
+    build: ./backend
+    ports:
+      - "8080:8080"
+    environment:
+      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/caiyunniu?useSSL=false
+      - SPRING_REDIS_HOST=redis
+    depends_on:
+      - mysql
+      - redis
+
+  mysql:
+    image: mysql:8.0
+    environment:
+      MYSQL_ROOT_PASSWORD: strong_password
+    volumes:
+      - ./mysql/data:/var/lib/mysql
+
+  redis:
+    image: redis:6.0
+    volumes:
+      - ./redis/data:/data
+```
+
+## 5. 运维常用命令
+- **启动所有服务**: `docker-compose up -d`
+- **查看日志**: `docker-compose logs -f backend-service`
+- **重启服务**: `docker-compose restart backend-service`
+- **Nginx 重载配置**: `docker exec -it nginx nginx -s reload`