# egg-farm

**Repository Path**: x-lai/egg-farm

## Basic Information

- **Project Name**: egg-farm
- **Description**: 蛋鸡养殖管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-09
- **Last Updated**: 2026-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 蛋鸡场养殖管理系统

> 面向**中小型蛋鸡养殖场**的 Android 离线录入与看板系统。
> 手机在鸡舍无网环境下照样能录，指标当场算出来。

## 这个仓库放什么

| 内容 | 说明 |
|---|---|
| `egg-farm-v1.2.apk` | 可直接安装的安卓安装包（release 正式签名） |
| `version.json` | 版本信息。手机 APP 靠它判断有没有新版 |

**仓库本身不含源码。** 源码与数据库在作者的本地项目目录，仓库存的是**发布物**。
这样任何时候从 Releases 都能直接下载安装，不依赖源码环境。

## 安装

1. 下载 `egg-farm-v1.2.apk`
2. 手机浏览器打开，或把 apk 传到手机后点开
3. 系统会提示"允许安装未知来源应用"——同意即可

**首次使用提示**：APP 启动后会做一次设备自检，显示数据库结构是否完好。
看到「✅ 数据库层完全正常」再进录入。

## 升级到新版本

打开 APP → 首页底部「**检查更新**」。

- 有新版会弹窗提示，点「立即下载」
- 下载完会**先校验 MD5**，通过才让你安装
- 断网时会提示「连不上更新服务器」，**不影响正常使用**——录入是纯离线的

> ⚠️ **重要**：各版本必须用同一个签名密钥。
> 首次安装请用 `v1.2`（release 签名）。
> 如果手机上装过 debug 签名的测试版，**必须先卸载**才能装上正式版
> （Android 报"与已安装版本签名不符"就是签名不同）。

## 数据说明

- 数据库在安装时从安装包释放到手机私有目录，**首次启动约需十几秒**
- 数据只存在手机上，**卸载 APP 会一并删除**，请谨慎
- 完整的管理与看板上电脑端使用

## 功能范围

**已实现**

- 每日录入：生产日报、环境记录、设备运行、光照执行
- 主数据维护：场、栋舍、批次、人员、设备
- 录入当场校验（产蛋率不能超 100%、耗料异常提示、氨气超标拦截等）
- 录完立刻回算产蛋率、破蛋率、死淘率、料蛋比
- 查看当天告警

**尚未实现**

- 手机与电脑的数据同步（手机录的数据暂不回传电脑）
- 记录列表（只能录，不能在手机上查历史）
- 补录：日期字段暂固定为当天

## 使用前提

- Android 7.0 及以上
- 首次启动需十几秒释放数据库，请勿中途退出

---

## 版本记录

| 版本 | 日期 | 说明 |
|---|---|---|
| v1.0 | 2026-10-09 | 首个版本：9 张表录入 + 主数据维护 + 录入校验 + 指标回算 + 在线更新 |
| v1.1 | 2026-10-15 | 数据库损坏自动恢复；大小屏自适应（dp 换算、字号分档、触摸目标放大） |
| v1.2 | 2026-10-15 | 修复底部按钮被系统导航键遮挡；隐私加固：界面提示文字改中性示例、数据库文件重建清除残余数据 |

## 其他

- 离线优先：断网时全部功能可用，在线只用于查更新
- 源码与完整文档不在本仓库，如需获取请联系作者