Files
xlxumu/docs/operations/用户手册文档.md

665 lines
15 KiB
Markdown
Raw Permalink Normal View History

# 用户手册文档
## 版本历史
| 版本 | 日期 | 作者 | 变更说明 |
|------|------|------|----------|
| 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+ | 最新版本 |
---
*本手册将根据系统更新和用户反馈持续完善*