AI-native personal finance frontend for fast bookkeeping, debt tracking, repayment management, budgeting, and audit-friendly analysis.
 |
 |
 |
 |
LedgerFlow 是一个围绕 “记得快、看得清、能追溯、可优化” 设计的个人财务前端应用。 它强调本地优先、可审计的数据结构，以及面向真实日常使用场景的效率：
- 快速录入交易
- 智能识别与分类
- 预算执行追踪
- 负债 / 还款闭环管理
- 面向月度复盘与异常发现的可视化分析
测试 Demo：
- Transactions：收入/支出/预算/还款统一建模，筛选排序批量操作，退款/冲正关联
- Assistant：自然语言财务问答、账单/截图识别、AI 辅助分类与分析；支持自定义 OpenAI-compatible 接口；支持 AI 信贷管家（识别结果可带去还款管理预填）
- Repayment Management：负债列表 + 还款台账，最低还款/期供计算，登记还款联动回写
- Smart Budget：预算方案、分类级预算跟踪、超预算提醒与执行反馈
- Dashboard：净资产/本月结余总览、趋势与分类结构、异常提醒
- WebDAV：支持备份上传/下载、账单附件上传（可选）
| 模块 | 功能 | 说明 |
|---|---|---|
| 交易（Transactions） | 交易录入 | 快速新增收入/支出/转账等流水 |
| 交易（Transactions） | 列表筛选/排序 | 按时间、分类、状态等筛选与排序 |
| 交易（Transactions） | 批量操作 | 批量改分类、改状态等（按 UI 提供的动作） |
| 交易（Transactions） | 退款/冲正关联 | 支持退款与原交易关联，便于对账追溯 |
| 负债（Repayment Management） | 负债管理 | 维护贷款/分期/信用账单等负债清单 |
| 负债（Repayment Management） | 还款台账 | 记录还款并联动回写余额/期数等状态 |
| 负债（Repayment Management） | 还款计算 | 最低还款/期供等辅助计算（按页面能力） |
| 预算（Smart Budget） | 预算方案与跟踪 | 分类级预算跟踪与执行反馈 |
| 预算（Smart Budget） | 超预算提醒 | 超预算提示与反馈闭环（按 UI 呈现） |
| 看板（Dashboard） | 总览与趋势 | 净资产/本月结余、趋势、分类结构等 |
| AI 助手（Assistant） | 自然语言问答 | 支持财务相关问答与分析 |
| AI 助手（Assistant） | 账单/截图识别 | 支持上传账单/截图进行结构化提炼 |
| AI 助手（Assistant） | AI 辅助分类 | 辅助交易分类与建议 |
| AI 助手（Assistant） | 信贷管家模式 | 信贷结果卡片化展示，可带去还款管理预填 |
| AI 设置（AI Settings） | OpenAI-compatible 接入 | 支持自定义 Base URL / API Key / Model |
| WebDAV | 备份到 WebDAV | 支持备份上传/下载，并显示过程状态与完成提醒 |
| WebDAV | 账单附件上传 | 可选把票据/截图等附件上传到 WebDAV |
注：这是基于当前仓库 UI/代码的「已实现能力」概览；细节以实际页面与版本更新为准。
仓库已提供 docker-compose.yml，默认直接启动即可：
docker compose up -d对应配置写法如下（与你仓库里的 compose 保持一致）：
services:
ledgerflow-web:
image: 34v0wphix/ledgerflow:latest
container_name: ledgerflow-web
ports:
- "${LEDGERFLOW_PORT:-8080}:80"
restart: unless-stopped访问：
http://localhost:8080
可选：自定义端口（例如 18080）：
LEDGERFLOW_PORT=18080 docker compose up -d升级到最新镜像：
docker compose pull
docker compose up -ddocker run -d --name ledgerflow-web -p 8080:80 34v0wphix/ledgerflow:latest应用支持接入 OpenAI-compatible 接口用于：
- 助手问答
- 交易识别与分类
- 预算建议
- 财务趋势分析
通常需要配置：
- Base URL
- API Key
- Model
如果未配置 AI，基础记账、预算、交易管理等本地能力仍可使用。
LedgerFlow 目前支持通过 WebDAV 做两类能力：
- 备份上传 / 下载
- 账单详情附件上传
说明：
- 仅允许合法 HTTPS 地址
- 拒绝 localhost / 内网地址
- 未配置完成时，相关入口会禁用或提示不可用
这里保留最短的开发方式，避免 README 过长。
Requirements：
- Node.js 20+
- npm 10+
npm install
npm run dev常用命令：
npm run test
npm run build
npm run lintThis repository is released under CC BY-NC-SA 4.0. See:
LICENSELICENSES/CC-BY-NC-SA-4.0.md