refactor: 重构数据库配置为SQLite开发环境并移除冗余文档

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

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