# 用户手册文档

## 版本历史
| 版本 | 日期 | 作者 | 变更说明 |
|------|------|------|----------|
| 1.0 | 2024-01-20 | 产品团队 | 初始版本 |

## 1. 系统概述

### 1.1 产品介绍
畜牧养殖管理平台是一个集成化的数字化管理系统，为畜牧养殖企业提供全方位的管理解决方案。系统包含管理后台、小程序应用和官方网站三个主要部分。

### 1.2 系统架构
```mermaid
graph TB
    subgraph "用户端"
        A[官方网站]
        B[小程序应用]
        C[管理后台]
    end
    
    subgraph "服务端"
        D[API网关]
        E[业务服务]
        F[数据库]
    end
    
    A --> D
    B --> D
    C --> D
    D --> E
    E --> F
```

### 1.3 主要功能模块
- **农场管理**：农场信息、设施管理、环境监控
- **动物管理**：动物档案、健康记录、繁殖管理
- **饲料管理**：饲料库存、配方管理、投喂记录
- **生产管理**：产品记录、质量检测、销售管理
- **财务管理**：成本核算、收支记录、报表分析
- **用户管理**：权限控制、角色分配、操作审计

## 2. 快速入门

### 2.1 系统要求

#### 2.1.1 硬件要求
- **CPU**：双核2.0GHz以上
- **内存**：4GB以上
- **存储**：100GB可用空间
- **网络**：稳定的互联网连接

#### 2.1.2 软件要求
- **操作系统**：Windows 10/macOS 10.14/Ubuntu 18.04以上
- **浏览器**：Chrome 80+/Firefox 75+/Safari 13+/Edge 80+
- **移动设备**：iOS 12+/Android 8.0+

### 2.2 账号注册与登录

#### 2.2.1 注册流程
1. 访问官网 https://www.xlxumu.com
2. 点击"立即注册"按钮
3. 填写基本信息：
   - 企业名称
   - 联系人姓名
   - 手机号码
   - 邮箱地址
   - 设置密码
4. 验证手机号码
5. 完成注册

#### 2.2.2 登录方式
- **网页登录**：https://admin.xlxumu.com
- **小程序登录**：微信搜索"畜牧管理"
- **支持登录方式**：
  - 手机号+密码
  - 邮箱+密码
  - 微信授权登录
  - 短信验证码登录

### 2.3 首次使用配置

#### 2.3.1 企业信息设置
```
系统设置 → 企业信息
- 企业名称
- 统一社会信用代码
- 法人代表
- 联系地址
- 联系电话
- 企业简介
```

#### 2.3.2 用户权限配置
```
用户管理 → 角色管理
- 创建角色
- 分配权限
- 添加用户
- 角色绑定
```

## 3. 管理后台使用指南

### 3.1 系统导航

#### 3.1.1 主菜单结构
```
├── 首页仪表板
├── 农场管理
│   ├── 农场列表
│   ├── 设施管理
│   └── 环境监控
├── 动物管理
│   ├── 动物档案
│   ├── 健康记录
│   ├── 繁殖管理
│   └── 疫苗接种
├── 饲料管理
│   ├── 饲料库存
│   ├── 配方管理
│   ├── 投喂记录
│   └── 采购管理
├── 生产管理
│   ├── 产品记录
│   ├── 质量检测
│   ├── 销售管理
│   └── 库存管理
├── 财务管理
│   ├── 成本核算
│   ├── 收支记录
│   ├── 报表分析
│   └── 预算管理
├── 系统管理
│   ├── 用户管理
│   ├── 角色权限
│   ├── 系统设置
│   └── 操作日志
```

### 3.2 农场管理

#### 3.2.1 创建农场
1. 进入"农场管理" → "农场列表"
2. 点击"新增农场"按钮
3. 填写农场基本信息：
   ```
   - 农场名称：必填，不超过50字符
   - 农场地址：详细地址信息
   - 农场面积：单位为亩
   - 养殖类型：猪、牛、羊、鸡等
   - 负责人：选择系统用户
   - 联系电话：11位手机号码
   - 农场简介：可选，不超过500字符
   ```
4. 上传农场照片（可选）
5. 点击"保存"完成创建

#### 3.2.2 设施管理
**添加设施**
1. 选择农场 → 点击"设施管理"
2. 点击"添加设施"
3. 填写设施信息：
   ```
   - 设施名称：如"1号猪舍"
   - 设施类型：猪舍、牛舍、饲料仓库等
   - 建设时间：选择日期
   - 容量：可容纳动物数量
   - 状态：正常使用/维修中/停用
   - 备注：设施特殊说明
   ```

**设施维护记录**
1. 选择设施 → 点击"维护记录"
2. 记录维护信息：
   - 维护日期
   - 维护类型：日常保养/故障维修/设备更换
   - 维护内容
   - 维护人员
   - 费用支出

#### 3.2.3 环境监控
**监控指标设置**
```
温度监控：
- 正常范围：18-25°C
- 告警阈值：<15°C 或 >30°C

湿度监控：
- 正常范围：50-70%
- 告警阈值：<40% 或 >80%

空气质量：
- CO2浓度：<3000ppm
- NH3浓度：<25ppm
```

**查看监控数据**
1. 进入"环境监控"页面
2. 选择农场和时间范围
3. 查看实时数据和历史趋势
4. 设置告警通知方式

### 3.3 动物管理

#### 3.3.1 动物档案管理
**添加动物**
1. 进入"动物管理" → "动物档案"
2. 点击"添加动物"
3. 填写动物信息：
   ```
   基本信息：
   - 动物编号：系统自动生成或手动输入
   - 动物类型：猪、牛、羊、鸡等
   - 品种：具体品种名称
   - 性别：公/母
   - 出生日期：选择日期
   - 来源：自繁/外购
   - 所在农场：选择农场
   - 所在栏舍：选择具体位置
   
   外观特征：
   - 毛色：描述动物毛色
   - 体重：当前体重（kg）
   - 体长：体长测量值（cm）
   - 特殊标记：耳标、纹身等
   
   健康状态：
   - 健康状况：健康/患病/康复
   - 疫苗接种：已接种疫苗列表
   - 用药记录：历史用药情况
   ```

**批量导入动物**
1. 下载导入模板
2. 按模板格式填写动物信息
3. 上传Excel文件
4. 系统验证数据格式
5. 确认导入

#### 3.3.2 健康记录管理
**记录健康检查**
1. 选择动物 → 点击"健康记录"
2. 添加检查记录：
   ```
   - 检查日期：选择日期
   - 检查人员：兽医或饲养员
   - 体温：正常范围36-39°C
   - 体重：当前体重
   - 精神状态：良好/一般/萎靡
   - 食欲：正常/减退/废绝
   - 呼吸：正常/急促/困难
   - 粪便：正常/稀软/腹泻/便秘
   - 其他症状：详细描述
   - 诊断结果：健康/疑似患病/确诊患病
   - 处理措施：用药/隔离/观察
   ```

**疾病管理**
1. 记录疾病信息：
   - 疾病名称
   - 发病时间
   - 症状描述
   - 治疗方案
   - 用药记录
   - 康复情况

#### 3.3.3 繁殖管理
**配种记录**
```
配种信息：
- 母畜编号：选择母畜
- 公畜编号：选择公畜或精液来源
- 配种日期：配种时间
- 配种方式：自然交配/人工授精
- 操作人员：负责人员
- 预产期：自动计算或手动输入
- 备注：特殊情况说明
```

**产仔记录**
```
产仔信息：
- 产仔日期：实际产仔时间
- 产仔数量：活产/死产数量
- 仔畜性别：公母比例
- 平均体重：新生仔畜体重
- 助产情况：是否需要助产
- 产后状况：母畜和仔畜健康状况
```

### 3.4 饲料管理

#### 3.4.1 饲料库存管理
**添加饲料**
1. 进入"饲料管理" → "饲料库存"
2. 点击"添加饲料"
3. 填写饲料信息：
   ```
   基本信息：
   - 饲料名称：如"玉米"、"豆粕"
   - 饲料类型：精料/粗料/添加剂
   - 规格：包装规格
   - 供应商：供应商名称
   - 生产日期：生产时间
   - 保质期：有效期限
   - 存储位置：仓库位置
   
   营养成分：
   - 粗蛋白：含量百分比
   - 粗脂肪：含量百分比
   - 粗纤维：含量百分比
   - 水分：含量百分比
   - 能量：代谢能值
   ```

**库存盘点**
1. 选择盘点日期
2. 选择盘点仓库
3. 录入实际库存数量
4. 系统自动计算盈亏
5. 生成盘点报告

#### 3.4.2 配方管理
**创建饲料配方**
1. 点击"新建配方"
2. 设置配方基本信息：
   ```
   - 配方名称：如"育肥猪配方"
   - 适用动物：猪、牛、羊等
   - 生长阶段：幼畜/育肥/繁殖
   - 配方版本：版本号
   - 创建人员：配方制定人
   - 审核状态：待审核/已审核
   ```

3. 添加配方成分：
   ```
   原料配比：
   - 玉米：60%
   - 豆粕：20%
   - 麸皮：15%
   - 预混料：5%
   
   营养指标：
   - 粗蛋白：≥16%
   - 代谢能：≥3000kcal/kg
   - 粗纤维：≤6%
   ```

#### 3.4.3 投喂记录
**记录投喂信息**
1. 选择投喂日期和时间
2. 选择投喂对象（农场/栏舍）
3. 记录投喂详情：
   ```
   - 饲料类型：使用的饲料或配方
   - 投喂量：实际投喂重量（kg）
   - 投喂次数：当日投喂次数
   - 投喂人员：负责投喂的员工
   - 动物反应：食欲情况
   - 剩料情况：是否有剩余
   - 备注：特殊情况说明
   ```

### 3.5 生产管理

#### 3.5.1 产品记录
**记录产品信息**
```
产品基本信息：
- 产品类型：肉类/蛋类/奶类
- 产品名称：具体产品名
- 生产日期：产品产出时间
- 产量：数量和重量
- 来源动物：产品来源
- 质量等级：A级/B级/C级
- 存储条件：冷藏/冷冻/常温
```

**产品追溯**
1. 扫描产品二维码
2. 查看产品完整信息：
   - 来源农场
   - 动物档案
   - 饲养记录
   - 健康状况
   - 用药记录
   - 检测报告

#### 3.5.2 质量检测
**添加检测记录**
```
检测信息：
- 检测日期：检测时间
- 检测项目：营养成分/药物残留/微生物
- 检测方法：检测标准
- 检测机构：第三方检测机构
- 检测结果：合格/不合格
- 检测报告：上传检测报告文件
```

**不合格产品处理**
1. 标记不合格产品
2. 分析不合格原因
3. 制定处理方案：
   - 销毁处理
   - 降级使用
   - 退回供应商
4. 记录处理结果

### 3.6 财务管理

#### 3.6.1 成本核算
**成本分类**
```
直接成本：
- 饲料成本：饲料采购费用
- 人工成本：饲养员工资
- 医疗成本：疫苗、药品费用
- 水电成本：水费、电费

间接成本：
- 设备折旧：设施设备折旧
- 管理费用：管理人员工资
- 其他费用：保险、税费等
```

**成本核算方法**
1. 选择核算期间
2. 选择核算对象（农场/动物群体）
3. 录入各项成本数据
4. 系统自动计算：
   - 单位成本
   - 总成本
   - 成本构成比例
   - 成本趋势分析

#### 3.6.2 收支记录
**收入记录**
```
销售收入：
- 销售日期：交易时间
- 产品名称：销售产品
- 销售数量：数量和重量
- 销售单价：单位价格
- 销售金额：总金额
- 客户信息：购买方信息
- 付款方式：现金/转账/支票
```

**支出记录**
```
采购支出：
- 采购日期：购买时间
- 采购项目：饲料/设备/药品
- 采购数量：购买数量
- 采购单价：单位价格
- 采购金额：总金额
- 供应商：供应商信息
- 付款方式：付款方式
```

## 4. 小程序使用指南

### 4.1 小程序功能概述
小程序主要面向一线饲养员和现场管理人员，提供便捷的移动端操作功能。

### 4.2 主要功能模块

#### 4.2.1 快速记录
**动物健康记录**
1. 扫描动物耳标或输入编号
2. 快速记录健康状况：
   - 体温测量
   - 精神状态
   - 食欲情况
   - 异常症状
3. 拍照记录（可选）
4. 提交记录

**投喂记录**
1. 选择投喂栏舍
2. 记录投喂信息：
   - 饲料类型
   - 投喂量
   - 投喂时间
3. 记录动物反应
4. 提交记录

#### 4.2.2 任务管理
**查看待办任务**
- 疫苗接种提醒
- 健康检查计划
- 设施维护任务
- 饲料补充提醒

**完成任务**
1. 点击任务项
2. 按要求完成操作
3. 拍照或录入结果
4. 标记任务完成

#### 4.2.3 数据查询
**动物信息查询**
1. 扫描耳标或搜索编号
2. 查看动物详细信息：
   - 基本档案
   - 健康记录
   - 繁殖记录
   - 用药历史

**库存查询**
1. 搜索饲料名称
2. 查看库存信息：
   - 当前库存量
   - 存储位置
   - 保质期
   - 安全库存提醒

### 4.3 离线功能
小程序支持离线操作，在网络不稳定的环境下：
1. 数据本地缓存
2. 离线记录功能
3. 网络恢复后自动同步
4. 冲突数据处理

## 5. 常见问题解答

### 5.1 登录问题

**Q: 忘记密码怎么办？**
A: 
1. 在登录页面点击"忘记密码"
2. 输入注册手机号或邮箱
3. 获取验证码
4. 设置新密码
5. 使用新密码登录

**Q: 账号被锁定怎么办？**
A: 
1. 联系系统管理员
2. 提供账号信息进行身份验证
3. 管理员解锁账号
4. 重新设置密码

### 5.2 数据问题

**Q: 如何批量导入动物数据？**
A:
1. 下载标准导入模板
2. 按模板格式整理数据
3. 检查数据完整性和格式
4. 上传Excel文件
5. 系统验证后确认导入

**Q: 数据录入错误如何修改？**
A:
1. 找到需要修改的记录
2. 点击"编辑"按钮
3. 修改错误信息
4. 保存修改
5. 系统记录修改日志

### 5.3 系统问题

**Q: 系统运行缓慢怎么办？**
A:
1. 检查网络连接状态
2. 清理浏览器缓存
3. 关闭不必要的浏览器标签
4. 联系技术支持

**Q: 数据同步失败怎么办？**
A:
1. 检查网络连接
2. 重新登录系统
3. 手动触发同步
4. 联系技术支持

### 5.4 权限问题

**Q: 无法访问某个功能模块？**
A:
1. 检查用户角色权限
2. 联系系统管理员
3. 申请相应权限
4. 等待权限审批

**Q: 如何申请新功能权限？**
A:
1. 联系直接上级
2. 说明业务需求
3. 填写权限申请表
4. 等待管理员审批

## 6. 系统维护

### 6.1 数据备份
系统每日自动备份数据，包括：
- 数据库完整备份
- 文件系统备份
- 配置文件备份
- 日志文件备份

### 6.2 系统更新
- 系统会定期发布更新版本
- 重要更新会提前通知用户
- 更新期间可能短暂影响服务
- 更新完成后会发布更新说明

### 6.3 性能监控
系统实时监控以下指标：
- 服务器性能状态
- 数据库响应时间
- 网络连接质量
- 用户访问情况

## 7. 技术支持

### 7.1 联系方式
- **技术支持热线**：400-XXX-XXXX
- **工作时间**：周一至周五 9:00-18:00
- **邮箱支持**：support@xlxumu.com
- **在线客服**：系统内置客服功能

### 7.2 支持服务
- **电话支持**：实时技术咨询
- **远程协助**：屏幕共享解决问题
- **现场服务**：重要客户现场支持
- **培训服务**：用户操作培训

### 7.3 服务承诺
- **响应时间**：工作时间内2小时响应
- **解决时间**：一般问题24小时内解决
- **服务质量**：专业技术团队支持
- **持续改进**：根据用户反馈优化系统

## 8. 附录

### 8.1 术语解释
- **农场**：养殖场所的统称
- **栏舍**：动物居住的具体区域
- **耳标**：动物身份识别标识
- **配方**：饲料配制的标准方案
- **追溯**：产品来源信息查询

### 8.2 快捷键说明
- **Ctrl+S**：保存当前操作
- **Ctrl+F**：页面内容搜索
- **Ctrl+Z**：撤销上一步操作
- **F5**：刷新当前页面
- **ESC**：关闭弹出窗口

### 8.3 浏览器兼容性
| 浏览器 | 最低版本 | 推荐版本 |
|--------|----------|----------|
| Chrome | 80+ | 最新版本 |
| Firefox | 75+ | 最新版本 |
| Safari | 13+ | 最新版本 |
| Edge | 80+ | 最新版本 |

---

*本手册将根据系统更新和用户反馈持续完善*