使用 pgledger-ui 可视化账本
我一直在开发一个用纯 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 还融入了几个主要理念:
一切皆可链接和点击
通常,在调试问题时,你一开始会意识到某个账本账户的余额与预期不符。然后,你想查看该账户的转入和转出转账。也许你还想跨转账追踪某个元数据键(例如 payment_id)。随着调试继续,你可能会从一个账户追踪到一笔转账,再到另一个账户,以此类推。使用 pgledger-ui 时,每个实体都会显示相关实体,你可以点击其中任何一个来追踪资金流。这甚至包括元数据键,因此你可以查看共享相同键值对的相关转账。
搜索
找到你想要的内容应该很容易,因此 pgledger-ui 有一个单一、通用的搜索框。你可以按 ID、账户名、幂等键、元数据值等搜索,它会显示所有实体中的所有匹配项。例如,如果你按层级给账户命名(例如 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。 ↩