Personal Ledger Hub
每一个结果,都能追到来源
把流水、订单、成本和退款放到可追溯的工作台里。我更关心规则是否算对、异常能否解释,而不是把金额做成好看的图。
- 我负责
- 业务规则梳理、全栈开发组织、核账与验收
- 协作方式
- 个人项目 · AI 辅助开发
- 技术与工具
- Python / FastAPI / React / TypeScript / SQLite / CSV / FIFO
- 源码
- 私有仓库,仅公开摘要

验证与边界
有依据的进展
- CSV 编码与布局解析、文件和交易双层去重、来源追溯
- 订单与成本关联、退款及重付规则、待核实状态
- 多批次历史成本 FIFO、日期约束、追加式冲正和自动化测试
还没验证,或需要留意
- 本地优先,未提供面向公网的用户认证与部署保护
- 资源保险库尚未实现;不接入自动支付或真实资金接口
- 网站只展示仓库中的合成数据截图,不公开真实订单、金额或交易原文
开发记录问题、取舍与过程
流水不等于业务结果
收款、退款、重付和采购发生在不同时间,只看平台流水很容易重复统计。成本不全时,界面也不应该给出一个貌似精确的利润数字。
我围绕个人收支与订单管理需求构建这个工作台,把“发生了什么”“凭什么这样计算”“还缺什么证据”放进同一条链路。
从文件到结果,留下追溯路径
导入器识别不同编码和账单布局,用文件哈希与交易键处理重复导入。每笔交易保留批次、文件、原始行号与字段快照;人工分类有自己的来源记录。
人民币使用整数分,多批次资产使用整数计量单位,避免浮点累计。成本单元只能结转一次,多件订单没有配齐成本时,利润保持待核实。
退款不是把原记录删掉
已退款订单保留原始证据;重付是关联原单的新订单。部分退回、库存损失和手续费待确认,要分别处理。不知道的成本用空值表达,不能默认为零后继续汇总。
FIFO 也有时间边界:后来到账的批次不能给更早的采购定价。错误登记通过追加式冲正处理;已经确认的业务事实不被静默改写。
我在其中的工作
我梳理真实需求,定义金额与状态语义,借助 AI 编程工具完成实现和测试组织,并通过核账、异常路径检查和浏览器验收迭代规则。网站隐藏了具体业务与凭证,只保留工程机制。
目前的结果
仓库已经形成流水导入、订单、成本与审计追溯的本机应用,保留了后端测试和浏览器验收脚本。资源保险库等模块仍明确未实现。下面的 FIFO 演示只解释规则,使用虚构批次,不接触账本或资金。
先入先出;金额使用整数分。这里只模拟两批普通物料,不连接真实账本。
例如结转 12 件:先用 A 的 10 件,再用 B 的 2 件。
这份记录从哪里来
资料核对于 2026-11-12。以下是整理时阅读的文件与记录,不代表本次重新执行了源项目的硬件、部署或完整回归。
- 功能与状态说明
README.md - FIFO 成本规格与审查
specs/003-usdt-cost/ - 验收场景与合成数据约定
docs/ACCEPTANCE.md - 浏览器验收脚本
tools/browser-check.mjs
源仓库为私有,仅保留适合公开的摘要。内部地址、凭证、财务原文及个人计划未公开。