优推编辑部 个人记账这件事，乍看似乎只是简单地把收入和支出记录下来，可一旦深入开发，背后却有不少技术难题等着你。比如，如何确保账户余额不出错？多账本的数据该如何分开管理？账单导入时又该怎么避免重复记录？这些都是开发者在设想出一个可持续的记账产品时，需要认真考虑的问题。 Smart Ledger是一个开源的记账系统，使用Node.js、Express和MySQL搭建后端，前端则用原生HTML、CSS和JavaScript实现，覆盖了H5移动端和PC桌面端两个界面。令人惊喜的是，这个项目还整合了自然语言记账、小票识别、语音输入、账单分析等多种功能，真的是个全能选手。 我觉得，这个项目的设计非常值得一看，尤其是它如何处理复杂的工程问题和用户需求。
项目定位：别低估记账系统的复杂性
很多人第一次想设计记账系统时，可能会简单地建立一张账单表，记录金额、类型、时间和备注。这种方案虽然能应付简单的记账，但一旦涉及到真实的家庭场景，问题就来了。 一个成熟的记账系统需要考虑的事情可不少： - 钱从哪个账户流出，流入哪个账户？ - 转账时如何保证两个账户余额都能同步更新？ - 用户如果修改或删除账单，账户余额如何处理？ - 家庭账本中有多少成员，各自有什么权限？ - 分类如何支持多级结构和自定义？ - 如何从微信和支付宝中导入账单？ - 消费趋势的分析，怎样预测月末结余？ - 如何给用户推送还款及信用卡账单提醒？ 这也就是说，记账系统可不是简单的表单应用，而是一个轻量级的财务管理系统，涉及到账户一致性、权限管理、数据迁移等多方面的需求。 在Smart Ledger中，前后端都放在同一个代码仓库中维护。后端处理业务逻辑和数据一致性，前端则负责用户界面和数据展示。这种设计简化了部署过程，特别适合想要自托管或学习全栈开发的用户。
整体架构：一套API，两套独立前端
这个项目采用了一种典型的前后端分离架构，但又有着各自独立的页面设计。浏览器
│
├── H5 移动端：底部导航、移动页面
├── PC 桌面端：侧边栏、顶部导航、桌面页面
│
▼
Node.js + Express 后端
│
├── 认证与权限中间件
├── 业务路由
├── 数据库访问层
├── 定时任务
├── 文件上传
└── AI 服务适配层
│
▼
MySQL 数据库PC端和H5端虽然共享同一套后端API，但它们的页面结构、导航方式和交互脚本是分开的。PC端的布局适合展示复杂数据，而移动端则强调快速记账和简短操作。
这种架构的好处明显。首先，用户体验上，桌面端可以展示更多信息，而移动端则更专注于快速操作。其次，业务逻辑的处理统一，避免了不同端口出现数据不一致的风险。
不过，独立维护两套页面也提高了开发成本，公共组件和请求逻辑需要分别维护。更合理的做法是共享一些核心代码，但保留页面布局和交互的独立性。
数据模型：围绕账本建立数据边界
在记账系统中，重要的不仅仅是“账单”一个实体，还有用户、账本、账户、分类和通知等多个部分如何有效协作。 简单说来，账本就是数据的边界。家庭账本、旅行账本和个人账本之间要分开管理。设计时采用了逻辑删除字段，这在记账和财务场景中是非常关键的。已删除的账单仍然保留，方便后期查找和审计。 我觉得这样的设计非常人性化，允许用户在需要的时候恢复数据，避免了因误操作造成的损失。
账户与账单的关系
账户可以分为现金、银行卡、信用卡等，账单则应包含详细信息，比如收支类型、金额、交易日期等。 在转账时，必须确保两个账户的余额同步更新。这个过程背后涉及的逻辑必须要严谨，不能因为程序出错留下一些未更新的账户情况。
分类体系
系统预设了一些分类，还允许用户自定义分类。在删除分类时，历史账单依然能保留原来的分类，这一点设计得很巧妙。 这也让我想到，记账应用的实现并不是简单的功能堆砌，而是要考虑到用户习惯及未来可能的需求变化。
并发记账：金融场景下的一致性问题
在记账时，转账操作是最容易出现并发问题的场景。想象一下，如果两个请求同时进行，未加锁的情况下可能就会产生错误的余额更新。 为了解决这个问题，项目使用了数据库事务和行锁手段来保证数据一致性。这种方法的基础是确保所有操作都是在一个事务中完成的，降低了出现数据不一致的几率。 我觉得这样的设计在实战中很有效，不仅能保证数据的准确性，还能减少开发者的维护负担。
余额审计：每一笔变化都可追溯
记账系统的一个核心功能就是要实时掌握账户余额，还要知道“为什么”余额发生变化。这就需要一套完整的审计记录，把每一次的收入、支出和转账都记录下来。 我觉得这样的设计不仅让用户更有掌控感，也能在发生问题时快速追溯，真的是非常实用。
账单导入：真实数据的复杂性
最后，账单导入是个很有挑战性的功能，因为它涉及到用户从各种外部应用导出数据。这些数据的格式和编码可能各不相同，开发者需要花心思处理这些差异。 通过独立的解析模块，项目在导入数据前先进行格式和编码的检测，确保数据的准确性和完整性。我觉得这是个很聪明的设计，能提升用户体验，也减少了后期数据处理的麻烦。 总的来说，Smart Ledger作为一个开源的记账系统，无论是在技术设计还是用户体验上都值得借鉴。实际体验下来，你会发现，记账并不是一件简单的事情，而是需要严谨且细致的管理。
