ZhuZhangBao · Construction Site Accounting · v1.0.0
面向 建筑工地、小型施工团队、包工头 的记账管理 App。覆盖 工地工程款(合同/收款/结清/归档)、
工人薪资(日薪/发薪/预支/在职)、杂项收支 三大场景,配套 月度报表 + Excel 导出 + SQL 备份。
App 端 Expo (React Native),后端 Spring Boot 3.2 + MyBatis Plus + MySQL + Redis,
AI 助手是独立 FastAPI + LangChain Tool Calling 服务,基于通义千问,支持自然语言查询/创建/分析所有数据。
6 个核心页面真实截图 · 点击下方缩略图切换主视图






点击缩略图切换主视图 · 流式 AI 对话 + Tool Calling
8 大核心模块,以「AI 智能助手」为先,从工地工程到薪资发放,闭环管理工地财务。
把工地账本「说一句话就记一笔」:自然语言问「李师傅本月做了多少工、欠多少钱」,Agent 自动调工具查工地流水并整理成回复; 说「给李师傅发 5000」,会先给预览等你确认才落库。
底层用 LangGraph 有向图 替代黑盒循环,关键节点(工具校验 / 输出校验 / 写操作人工审批)固定路径, try/retry/fallback 容错,Checkpointer 断点存续,崩溃不丢上下文。
CRUD + 收款流水 + 协商结清 + 多状态流转 + 归档。每次新增收款自动重算 owed,owed ≤ 0 自动转"已结清"。
日薪录入 → 自动累加 total/pending wage;发薪 → 必须 ≤ pending wage;预支 + 在职 / 离职 状态管理,支持按工地关联。
工具采购、餐饮招待、办公费用、废料变卖等非项目直接收支,收入 / 支出两类型,按分类与日期检索。
月度收款趋势、年度汇总、单工地收益、单工人薪资。支持 Excel 导出 + SQL 全量备份。
年度总览(收入/支出/工地在建数)+ 待收款工地 + 待发薪工人 聚合,开 App 一眼看到要做的事。
关键读路径(列表/汇总/报表)走 Redis 缓存,失败兜底直查 DB 业务无感。Redisson 看门狗续期可重入锁,进程间共享对话历史。
Spring Security + JWT(jjwt 0.12.5),24h 有效期,前端 AsyncStorage 持久化,401 自动登出。Token 黑名单 / 幂等 token 也走 Redis。
三端协同:App 通过 REST 调后端;AI 助手独立部署,调后端 API 完成操作。