开发者推出 pgledger-ui,为 PostgreSQL 账本提供可视化界面
来源标题:Visualizing a Ledger with pgledger-ui
开发者为其纯 PostgreSQL 复式记账账本项目 pgledger 推出配套可视化工具 pgledger-ui,可展示账户详情、常见对手方账户、余额随时间变化图表及明细转账记录。该工具通过执行数据库查询并在网页中呈现结果,整体打包为单个 Go 二进制文件。开发者希望它像 pgledger 一样成为可跨应用复用的通用可视化工具。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
2026年11月19日 3 分钟阅读 我一直在用纯 PostgreSQL 做一个账本实现,叫 pgledger。我在之前的文章里写过,我认为更多应用应该使用复式记账账本。 不过,账本一旦集成进来,想从视觉上把它搞清楚就有点难了。资金是怎么流动的?每个用户主要的账户集合是什么?为什么这个账户的余额和我预期的不一样? 在与公司合作的过程中,我经常尝试让账本更直观、更容易理解,用的要么是 Metabase 这样的数据库看板,要么是应用内的自定义代码。 正如 pgledger 的定位是跨应用通用的、可复用的账本,我想我们也可以做一个通用的、可复用的可视化工具。于是 pgledger-ui 诞生了。 下面是查看一个账本账户时的样子,展示了账户详情、最常见的对手方账户、余额随时间变化的图表,以及详细的转账分录: 总的来说,pgledger-ui 相当简单。它执行数据库查询,然后把结果显示在网页上。里面有一些图表和额外的聚合信息。整个东西打包成一个 Go 二进制文件: go run github.com/pgr0ss/pgledger-ui@latest --database-url postgres://user:pass@host:5432/dbname 除此之外,pgledger-ui 里还融入了几个核心理念: 通常,排查问题时,你首先会发现某个账本账户的余额和你预期的不一样。然后,你想看看这个账户的转入和转出。接着,你可能想跨转账追踪某个 metadata key(比如 payment_id)。随着排查的深入,你可能会从一个账户追到一笔转账,再追到另一个账户,如此继续。在 pgledger-ui 里,每个实体都会显示与之相关的实体,你可以点击其中任何一个来追踪资金流。这甚至包括 metadata key,所以你能看到共享同一个 key/value 对的相关转账。 应该能轻松找到你想要的东西,所以 pgledger-ui 提供了一个单一的通用搜索框。你可以按 id、账户名、idempotency key、metadata 值等来搜索,它会显示所有实体中的全部匹配项。例如,如果你按层级给账户命名(比如 user01.available、user01.pending 等),你可以搜索 user01,看到该用户的所有账户和转账。 我喜欢信息密集但不至于让人不知所措的界面。目标是每个页面都展示大量有用的信息,并且让人容易扫视到需要的内容。 通常,从数据库查询数据时,你得到的是基于行的结果。然而,我发现用列式格式来可视化账本往往更有用。 例如,假设你在查看某笔支付的所有转账分录。结果可能是这样的: kind | name | amount ------------------+------------------------+-------- payment_created | user1.external | -50.00 payment_created | user1.receivables | 50.00 payment_received | user1.receivables | -49.50 payment_received | user1.available | 49.50 refund_created | user1.available | -20.00 refund_created | user1.pending_outbound | 20.00 refund_sent | user1.pending_outbound | -20.00 refund_sent | user1.external | 20.00 但同样数据的列式视图是这样的: kind | user1.external | user1.receivables | user1.available | user1.pending_outbound ------------------+----------------+-------------------+-----------------+------------------------ payment_created | -50.00 | 50.00 | | payment_received | | -49.50 | 49.50 | refund_created | | | -20.00 | 20.00 refund_sent | 20.00 | | | -20.00 (示例来自 pgledger 的 reconciliation.sql.out 脚本) PostgreSQL 把这种视图称为 crosstab(在 psql 里叫 crosstabview)。电子表格里的数据透视表可能类似。这也是可视化账本的一种常见方式1。 pgledger-ui 里也有这种视图,尤其是在你通过 metadata key 追踪资金流的时候: 而且你可以把流入/流出分开,让它看起来像标准的账本 T 型账户视图: 请试用一下 pgledger-ui,我很想听听你的想法,尤其是如果你现在就在使用 pgledger 或其他账本的话。你在这个领域还见过其他有用的可视化或工具吗?如果 pgledger-ui 是你有兴趣使用的,请告诉我。 例如,Accounting For Developers, Part I: The Fundamentals 和 T-Accounts Explained: The Visual Grammar of Debits and Credits Behind Every Journal Entry。↩
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。