YZHLX/ THE OPEN LAB
未完成的实验档案
全部项目
PROJECT FILE / 04软件与工作台
已实现2026

Personal Ledger Hub

每一个结果,都能追到来源

把流水、订单、成本和退款放到可追溯的工作台里。我更关心规则是否算对、异常能否解释,而不是把金额做成好看的图。

我负责
业务规则梳理、全栈开发组织、核账与验收
协作方式
个人项目 · AI 辅助开发
技术与工具
Python / FastAPI / React / TypeScript / SQLite / CSV / FIFO
源码
私有仓库,仅公开摘要
Personal Ledger Hub 总览,显示合成数据的收支与订单统计
真实界面的合成数据演示。金额、文件和记录用于测试,不是我的真实经营数据。 点击查看原图 ↗

验证与边界

有依据的进展

  • CSV 编码与布局解析、文件和交易双层去重、来源追溯
  • 订单与成本关联、退款及重付规则、待核实状态
  • 多批次历史成本 FIFO、日期约束、追加式冲正和自动化测试

还没验证,或需要留意

  • 本地优先,未提供面向公网的用户认证与部署保护
  • 资源保险库尚未实现;不接入自动支付或真实资金接口
  • 网站只展示仓库中的合成数据截图,不公开真实订单、金额或交易原文

开发记录问题、取舍与过程

流水不等于业务结果

收款、退款、重付和采购发生在不同时间,只看平台流水很容易重复统计。成本不全时,界面也不应该给出一个貌似精确的利润数字。

我围绕个人收支与订单管理需求构建这个工作台,把“发生了什么”“凭什么这样计算”“还缺什么证据”放进同一条链路。

从文件到结果,留下追溯路径

导入器识别不同编码和账单布局,用文件哈希与交易键处理重复导入。每笔交易保留批次、文件、原始行号与字段快照;人工分类有自己的来源记录。

人民币使用整数分,多批次资产使用整数计量单位,避免浮点累计。成本单元只能结转一次,多件订单没有配齐成本时,利润保持待核实。

退款不是把原记录删掉

已退款订单保留原始证据;重付是关联原单的新订单。部分退回、库存损失和手续费待确认,要分别处理。不知道的成本用空值表达,不能默认为零后继续汇总。

FIFO 也有时间边界:后来到账的批次不能给更早的采购定价。错误登记通过追加式冲正处理;已经确认的业务事实不被静默改写。

我在其中的工作

我梳理真实需求,定义金额与状态语义,借助 AI 编程工具完成实现和测试组织,并通过核账、异常路径检查和浏览器验收迭代规则。网站隐藏了具体业务与凭证,只保留工程机制。

目前的结果

仓库已经形成流水导入、订单、成本与审计追溯的本机应用,保留了后端测试和浏览器验收脚本。资源保险库等模块仍明确未实现。下面的 FIFO 演示只解释规则,使用虚构批次,不接触账本或资金。

一笔成本,是怎样算出来的?FIFO / 虚构数据

先入先出;金额使用整数分。这里只模拟两批普通物料,不连接真实账本。

批次 A · 先入库10 件 / ¥100.00剩余 10 件
批次 B · 后入库10 件 / ¥120.00剩余 10 件

例如结转 12 件:先用 A 的 10 件,再用 B 的 2 件。

这份记录从哪里来

资料核对于 2026-11-12。以下是整理时阅读的文件与记录,不代表本次重新执行了源项目的硬件、部署或完整回归。

  • 功能与状态说明README.md
  • FIFO 成本规格与审查specs/003-usdt-cost/
  • 验收场景与合成数据约定docs/ACCEPTANCE.md
  • 浏览器验收脚本tools/browser-check.mjs

源仓库为私有,仅保留适合公开的摘要。内部地址、凭证、财务原文及个人计划未公开。

下一个项目基于驻波法的光速测量装置