rosercode/ledgerly
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
53 Commits 1 Branch 0 Tags
f0956f65872d5eaa0d5956789cd1aa6079e81846
Commit Graph
16 Commits
Author SHA1 Message Date
rosercode bfd314a38e feat: 设置页新增分区目录导航并支持 URL 锚点，统计面板图表点击跳转可关闭 
设置页由单一长列表改为「目录 + 分区」结构：桌面左侧吸附目录、小屏/平板顶部横向条目条，点击可平滑定位并同步 URL 锚点（支持 /settings#<slug> 深链与浏览器前进后退）；同时为统计面板图表补充用户级「点击跳转明细」开关（默认开启），面板与设置页两处入口实时联动。

变更内容：
- 设置页目录导航：Settings.vue 分区 slug 化，点击 push / 滚动 replace 同步 URL，显式跳转期间暂停滚动联动并用 ResizeObserver 持续对齐、用户主动滚动后解除；修复悬停样式覆盖高亮、并让选中项自动滚入视野；Layout.vue 在 route.hash 非空时跳过滚动位置恢复；router 对同路径纯 hash 变更提前放行；messages.ts 新增目录三语文案。
- 统计面板图表点击开关：后端新增用户级偏好 `chartClickNavigation`（DTO/Controller/Service，未配置默认开启）；前端共享 composable `useChartClickNavigation`；Dashboard.vue 增加关闭守卫、提示显隐与光标联动及面板快捷开关；DisplayConfigPanel.vue 新增开关；messages.ts 新增三语文案。
- 说明：复用通用键值表 t_user_preference，不改动建表脚本与实体/Mapper；未配置默认开启，老用户无感知。
 2026-10-13 17:42:08 +08:00
rosercode 6439d336d4 chore: 前后端引入代码检查工具并整改存量问题 
为统一前后端代码规范与质量，前端引入 ESLint + Prettier，后端在 Spotless 之外新增 Checkstyle 与 SpotBugs，检查接入构建与打包流程并失败即阻断，同时一次性整改全部存量告警，检查范围为后端主源码与前端源码。

变更内容：
- 前端新增 ESLint（flat config）与 Prettier 配置及 lint / lint:fix / format / format:check 脚本，并新增对应开发依赖
- 后端 build.gradle 应用 checkstyle 与 com.github.spotbugs 插件，新增 gradle/checkstyle/checkstyle.xml、suppressions.xml 与 gradle/spotbugs/exclude.xml
- 新增 Gradle frontendLint 任务并作为 frontendBuild 前置，新增 lint 聚合任务（Spotless + Checkstyle + SpotBugs + 前端 ESLint）
- 修复后端 Checkstyle 1 处（补花括号）与 SpotBugs 17 处（getParent() 判空、拆装箱冗余、异常捕获与日志、volatile 同步等），并按设计豁免值对象引用暴露等告警
- 修复前端规则问题（未使用变量、无意义赋值、v-for key、v-html 安全提示）并格式化存量文件
- README 补充依赖安装、代码检查与打包说明

说明：
- SpotBugs 工具版本固定为 4.8.6，规避其 BCEL 与 Spring Boot BOM 选定 commons-lang3 3.14.0 的 NoSuchMethodError
- 检查范围仅主源码，src/test/ 本地测试不纳入 Checkstyle/SpotBugs
- 前端格式化统一为无分号、单引号、行宽 120、LF，与 .gitattributes 保持一致
 2026-10-12 13:06:10 +08:00
rosercode 007e6727a6 feat: 新增日历页面并设为默认首页 
新增日历页以月视图展示每日收支汇总、以年视图展示每月汇总，支持月份切换、统计口径过滤与当日明细查看，并将日历置于侧边导航首位、作为访问 / 的默认落地页。

变更内容：
- 新增 `views/Calendar.vue`：月视图按日展示收入/支出/结余与当月合计，年视图以 12 月网格展示每月汇总并可点击进入该月，表头支持上一/下一期、年与月下拉跳转、「今天」及月/年视图切换
- 日历支持统计口径过滤（仅计入统计/全部记录/仅不计入，持久化于 `ledgerly.calendar.statsScope`），仅作用于汇总、不影响当日明细
- 点击日期弹出当日明细浮窗（顶部显示当日收入/支出/结余合计），明细行在条目主行展示金额，可点击打开完整账单详情（只读）并跳转到收支记录按当日筛选
- 视图模式持久化于 `ledgerly.calendar.view`，当前视图与年月同步到 URL（`?view=month|year&y=YYYY&m=MM`），月/年无数据时显示空状态
- `TransactionDetailModal` 新增 `editable` 属性（默认 true）以支持只读场景；`utils/navItems.ts` 将日历置于导航首位；`router` 与 `Login` 默认跳转由统计面板改为日历；补充导航、存储键与 `layout.calendar`、`calendar.*` 三语文案
 2026-09-30 17:50:21 +08:00
rosercode 0e1443c59e feat: 新增智能查数（自然语言转 SQL 只读查询） 
新增「智能查数」功能：用户用自然语言提问，由大模型生成一条只读 SQL，经安全校验后在当前用户数据上执行，前端按结果形状自适应渲染为统计卡片、表格或图表。入口位于侧边栏，仅在 AI 启用时显示。

变更内容：
- 后端新增 AiSqlQueryService 与 POST /api/ai/sql，新增 AiCallType.SQL 用量记录与提示词模板 ai-sql-system.tpl
- 新增安全网关 TextToSqlGuard：仅允许单条 SELECT，拒绝写操作、多语句、危险函数与 SELECT INTO/FOR UPDATE；校验表白名单与 schema 前缀；递归注入 user_id 隔离（主表加 WHERE、JOIN 加 ON，覆盖括号连接与 CTE）；结果上限 1000
- 表结构改由 TextToSqlSchemaProvider 从数据库元数据动态读取（60 秒缓存），白名单与表列中文说明集中在 TextToSqlTables，字段增删改无需调整提示词
- 新增 AiSqlQueryResultVO、AiSqlColumnVO，返回生成的 SQL、列元数据与行数据
- 前端新增智能查数页 SqlQuery.vue（路由 /smart-query），按结果形状渲染单行统计卡片、多行动态表格并支持柱状图与饼图切换
- 渠道列用 getChannelLabel 本地化展示，生成的 SQL 用 sql-formatter 缩进、highlight.js 高亮并支持复制
- 新增共享 useAiEnabled 状态，侧边栏「智能查数」菜单仅 AI 启用时显示，设置页保存 AI 配置后即时刷新
- 设置页与收支记录页文案补充智能查数相关三语文案

依赖与清理：
- 新增前端依赖 sql-formatter、highlight.js
- 移除仓库内测试文件 LedgerlyApplicationTests、PromptTemplateServiceTest、AiPromptPayloadPrivacyTest，此后测试源码不再纳入提交

说明：
- 表结构动态读取保证字段变更零维护，仅可查表白名单需显式登记
- 安全网关对 JOIN 条件注入 ON 子句以保证 LEFT JOIN 语义，并对括号连接与 CTE 递归处理
 2026-09-24 10:38:24 +08:00
rosercode e0fa1abec5 feat: 表格分页支持统一配置并记忆各表格每页条数 
- 后端新增聚合用户偏好 paginationPrefs（每页条数候选列表与默认每页条数），提供 GET/PUT /api/setting/pagination-prefs，默认候选 [10,20,50,100]、默认每页 20，非法值自动过滤并回退
- 后端新增 /category/page、/tag/page、/channel/page、/email-bill/configs/page、/email-bill/sender-rules/page 分页接口，原全量接口保持不变以免影响下拉、筛选、AI 与导出
- 前端新增共享 composables/usePageSizeOptions.ts 与 useTablePageSize.ts，所有表格统一取用候选列表并记住各自上次选择的每页条数，优先级为表格记忆 > 全局默认 > 20
- 各表格上次选择以聚合偏好 finance.pagination.tablePageSizes 存于本机 localStorage，收支记录页旧的 filterPrefs.pageSize 自动迁移
- 设置页外观设置新增「表格每页条数选项」分组，可增删候选值并配置默认每页条数，保存后全局即时生效
- 路由守卫在已登录时预加载分页偏好，保证表格页首次渲染即使用配置值
- 前端分类、标签、渠道、邮箱配置、发件人规则表格接入后端分页
- 补充中文、英文、日文三语文案
 2026-09-23 11:14:54 +08:00
rosercode eb358d0ba1 refactor: 前端本地偏好统一为公共存储层 
- 新增 frontend/src/utils/storageKeys.ts 集中维护存储键常量并登记旧键迁移
- 新增 frontend/src/utils/storage.ts 统一 localStorage/sessionStorage 读写与异常容错
- 新增 frontend/src/composables/usePreference.ts 提供 useStringPreference 响应式字符串偏好
- 新增 frontend/src/utils/transactionFilterPrefs.ts 抽出收支筛选偏好字段定义与共享读写
- 存储键统一以 finance. 前缀命名，locale、emailBill.tab、logs.tab 迁移到新键并自动迁移旧值
- 各页面与组件改用公共层，移除重复的 try/catch 与跨组件重复的序列化逻辑
- 认证凭据 token 属登录状态，保持原键名不纳入 finance. 前缀
 2026-09-23 09:41:55 +08:00
rosercode 2ade60da42 feat: AI 图片记账、自定义交易渠道与淘宝/京东账单导入 
- AI 图片记账：多图上传由视觉模型识别，SSE 实时推送进度，提取 rawData，按「类型+金额+时间」检测重复，支持缩略图与来源图片查看
- 自定义交易渠道：新增 t_channel 与渠道管理页，支持新建/改名/删除，并接入统计、导出与 AI 查询/记账/建议提示词
- AI 建议：单条建议新增交易渠道推荐（推荐已有渠道 / AI 新建渠道）
- 账单导入：新增淘宝（xlsx）、京东（CSV）解析器
- 交易：新增批量创建接口，导入时按去重键兜底跳过重复
- 运行目录统一经 AppHome 解析，图片与数据文件落盘规范化
- 前端：AI 记账方式偏好记忆、AI 按钮与输入框对齐、来源图片弹窗支持加载原图
 2026-09-21 16:21:58 +08:00
rosercode 1f520f4376 feat: 用户级偏好配置与外观设置，枚举统一抽取与账单类型后端下发 
- 新增用户偏好表 t_user_preference 与进程内缓存，账单来源统计默认值由全局改为按用户存储（/api/setting）
- 新增外观设置：不计入统计记录支持删除线与灰色标签两种展示样式
- 抽取 ChannelType / TransactionType / StatisticsScope 枚举，替换各处硬编码的渠道、类型与统计口径
- BillType 内聚各来源扩展名，新增 /transaction/import/types 接口，前端改为按后端下发渲染
- 仪表盘趋势图支持点击柱子跳转收支记录并带入筛选条件
- 布局内容区按路由记忆滚动位置；已登录访问登录/注册页自动跳转
 2026-09-21 10:51:15 +08:00
rosercode 9bc858eefc feat: 邮箱账单自动拉取 
- 新增邮箱配置、发件人规则、待处理账单三张表（SQLite/MySQL 双脚本）及 CRUD 接口
- 按邮件发件人匹配账单类型，未命中忽略；发件人规则可配置解压密码与默认分类/标签
- 支持 IMAP IDLE 实时监听、定时兜底与手动立即检查；拉取范围可配置（仅新邮件/最近 N 天/最近 N 封）
- 附件保存至本地 data/email-bill，解析预览后手动导入，复用账单解析与规则引擎
- 立即检查通过 SSE 实时推送执行进度
- 前端新增「邮箱账单」页（邮箱配置/发件人规则/待处理账单三 Tab），支持子路由与 Tab 偏好记忆，配置弹窗提供常用 IMAP 服务器候选项
- 新用户注册自动初始化默认发件人规则（支付宝/微信/美团/招商银行/交通银行）
- 抽取共用账单预览与结果组件，供上传导入与邮箱账单复用

同时包含：
- 统计新增口径筛选（仅计入/全部/仅不计入），支付方式改为后端动态获取
- 统一实体 createdAt/updatedAt 位置至 id 之后，调整部分日志级别
 2026-09-19 17:50:55 +08:00
rosercode c69e76ed4c feat: 支持自定义分类与标签规则并优化 AI 查询交互 
- 新增 t_rule、t_rule_tag 表（MySQL/SQLite 双脚本）与规则引擎，支持关键词（备注/交易对方/商品名称）、收支类型、金额区间组合匹配
- 新增 /api/rule 增删改查与启用停用接口，侧边栏新增「规则管理」页，支持排序与启停
- 账单导入解析阶段批量匹配，返回命中规则与建议分类/标签，预览表格新增「匹配规则/建议」列
- 确认导入时按行重新匹配：规则建议分类优先于面板默认分类，规则标签与默认标签合并去重
- 删除标签时同步清理规则标签关联
- AI 自然语言查询解析后直接应用筛选并搜索，移除二次确认弹窗，成功提示展示识别意图
- 修正登录日志筛选 success 参数类型为 'true'/'false'
 2026-09-18 17:42:59 +08:00
rosercode e82e0a4ef9 feat: 新增系统日志记录、查看与自动清理，VO 转换改用 MapStruct 
- 新增访问/登录日志表与拦截器，登录成功/失败均记录，接口访问同时输出到应用日志
- 新增 /api/log/* 查询与 SSE 实时推送，运行日志默认最近 1 小时并支持日期/级别/关键字筛选
- 新增日志定时清理，保留天数可配置（默认 30 天，0 为永久保留）
- 前端新增系统日志页（独立 URL 子路径、标签偏好记忆），入口位于顶部用户下拉菜单
- 实体到视图对象的属性拷贝改用 MapStruct 编译期生成
 2026-09-18 17:18:03 +08:00
rosercode e49b6b7b81 feat: 新增定时账单导入提醒与通知直达导入页 
- 新增通知配置、渠道、发送日志三张表（MySQL/SQLite 双建表脚本）及实体、Mapper、Service、Controller
- 支持邮箱（SMTP）与 Server 酱两种推送渠道，抽象 NotificationSender 工厂统一发送
- 新增 NotificationScheduler 定时任务，按每天/每周/每月周期检查并推送账单导入提醒
- 新增全局通知链接地址配置（/api/app/notification-url），随提醒一并下发
- 前端系统设置页新增「定时通知」面板，支持周期配置、渠道增删改测、立即发送与发送日志
- 新增 /bill-import 直达页，供提醒链接一键打开账单上传弹窗
- 登录支持 redirect 回跳，仅允许站内路径以防开放重定向
 2026-09-18 16:47:09 +08:00
rosercode c1f5d02564 feat: 支持数据库运行时配置与多数据库，重构设置页并完善打包 
- 数据库支持 SQLite / MySQL 运行时配置与切换，未配置时仍可启动，配置后自动建表
- 新增默认分类与标签初始化，注册用户自动创建
- 新增注册开关（默认关闭，可在系统设置开启；无用户时允许创建首个账号）
- 合并数据库、注册与 AI 配置为「系统设置」页，拆分「模型使用情况」独立页面
- AI 一键设置支持新建分类与标签
- 前端构建产物打包进可执行 jar，后端增加 SPA 路由回退
- jar 更名为 finance-app，补全 Gradle Wrapper，移除 archive 任务
- 更新 DeepSeek 模型说明文案
 2026-09-18 12:33:41 +08:00
rosercode 49c70a732d feat: 接入 DeepSeek，新增 AI 分类建议、自然语言查询与智能记账 
- 后端新增 AI 模块：DeepSeek 客户端、用户级配置表 t_ai_config、用量记录表 t_ai_usage
- 批量设置支持 AI 推荐分类与标签，并可一键应用
- 交易列表支持自然语言查询，解析为筛选条件确认后应用
- 支持自然语言记账，解析后预填新增表单
- 新增 AI 设置页：启用开关、API Key、接口地址、模型、连通性测试与用量统计
- 交易列表重排：AI 查询区、已激活筛选标签、备注与查询历史缓存
- 账单导入默认分类下拉补充分类图标
- 顶部用户入口改为下拉菜单（AI 设置 / 退出登录）
 2026-09-17 18:26:03 +08:00
rosercode 65c0d8c550 feat: 新增标签体系、微信账单导入与收支记录体验优化 
- 标签：新增 t_tag / t_transaction_tag 表与标签 CRUD，支持交易打标签、按标签筛选、批量添加/移除标签、导入账单默认标签，新增标签管理页
- 账单导入：新增微信支付 xlsx 解析器（WechatBillParser），支持支付宝 / 微信按类型导入；解析行保存原始完整数据（raw_data）并可在列表查看
- 收支记录：排序移至顶部并改为服务端排序（交易时间 / 金额，记忆偏好）；筛选条件收纳为「更多筛选」弹层；分类筛选显示图标；一键设置支持「计入统计」；导入预览支持关键字 / 类型 / 状态 / 金额筛选
- 数据库：init.sql 新增 raw_data 字段与标签表，新增 init_tags.sql 默认标签种子
- 其他：更新 README 测试账号
 2026-09-17 16:47:26 +08:00
wangshuo 733ed4bb86 feat: 初始化收支管理系统 2026-08-30 14:36:22 +08:00