农户信息管理系统
替代纸质台账，连接桌面、Web 和手机采集，把基层信息管理变成可维护的数字流程。
需要维护农户档案、村务台账并进行现场采集的基层工作人员。
需求梳理、多端架构、数据模型、桌面交付、移动采集与安全边界。
FastAPI + React + PostgreSQL；桌面安装链路与 React Native/Expo 手机采集主链路已打通。
01 · WHY IT EXISTS
它为什么会出现
项目最初是 Flask + SQLite 的基础台账，随着真实工作不断加入导入导出、统计、证明材料、权限和手机采集。它不是简单的 CRUD 展示，而是如何把纸质流程逐步变成可维护、可追踪又保护敏感数据的数字系统。
02 · THE PROBLEM
真正要解决的问题
纸质台账重复填写、检索困难，不同表格之间难以同步，也无法支撑移动采集和权限管理。
03 · THE RESPONSE
最终形成的方案
围绕真实基层工作拆分农户、村务台账、文件、统计和移动采集，并通过角色权限控制信息边界。
04 · BUILD LOG
项目不是一次生成的。
重要的不是“AI 写了多少代码”，而是需求怎样在真实使用中逐步变得清楚。
- 01
基础台账启动
从农户信息 CRUD 和 SQLite 单机版本开始。
- 02
持续扩展到 v13
加入导入导出、统计分析、用户权限、数据备份和桌面打包。
- 03
多端主链路
完成 Web、桌面安装和手机权限/采集链路，清理历史冗余文件。
05 · KEY DECISIONS
真正决定项目质量的三个选择。
围绕真实业务对象建模
农户、家庭成员、动态字段、台账和文件分别管理，避免用一张万能表承载所有变化。
公开展示必须脱敏
网站仅展示演示界面，不上传数据库、真实表格、证明材料或业务备份。
多端不是复制三套系统
后端数据与权限统一，桌面、Web 和手机只承担不同使用场景。
农户档案与多类村务台账
文件预览和模板中心
角色权限与操作留痕
Web、移动端与桌面交付
07 · WHAT WAS DELIVERED
已经完成
- 从单机工具演进为多端系统
- 桌面安装与手机采集链路打通
- 完成权限、文件和模板中心
- 仓库清理约 36 MB 冗余
08 · HONEST LIMITS
仍然有限
- 仍有未提交改动需要收敛
- 真实业务数据不能公开演示
- 远端仓库待安全审查后重建
09 · NEXT
下一步
- 完成多端统一验收
- 补齐版本与交付说明
- 通过敏感数据检查后建立私有仓库
10 · KEEP READING
项目、文章和资料库连在一起。
项目页讲“做成了什么”，文章讲“过程发生了什么”，飞书保存可以继续复用的方法与资料。
相关复盘
这个项目的完整复盘还在整理中。可以先阅读飞书资料，或加微信备注“项目”交流。
