Files
kt-financial-system/apps/web-finance
你的用户名 675fe0a1a8 feat: 增强财务管理系统功能与分析能力
主要更新:
- 🎯 新增综合分析仪表板,包含关键指标卡片、预算对比、智能洞察等组件
- 📊 增强数据可视化能力,新增标签云分析、时间维度分析等图表
- 📱 优化移动端响应式设计,改进触控交互体验
- 🔧 新增多个API模块(base、budget、tag),完善数据管理
- 🗂️ 重构路由结构,新增贷款、快速添加、设置、统计等独立模块
- 🔄 优化数据导入导出功能,增强数据迁移能力
- 🐛 修复多个已知问题,提升系统稳定性

技术改进:
- 使用IndexedDB提升本地存储性能
- 实现模拟API服务,支持离线开发
- 增加自动化测试脚本,确保功能稳定
- 优化打包配置,提升构建效率

文件变更:
- 新增42个文件
- 修改55个文件
- 包含测试脚本、配置文件、组件和API模块

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-24 16:41:58 +08:00
..

TokenRecords 财务管理系统 (VbenAdmin 版本)

基于 VbenAdmin 框架构建的现代化财务管理系统,提供完整的收支记录、分类管理、人员管理和贷款管理功能。

功能特性

核心功能

  • 交易管理:记录和管理所有收支交易,支持多币种、多状态管理
  • 分类管理:灵活的收支分类体系,支持自定义分类
  • 人员管理:管理交易相关人员,支持多角色(付款人、收款人、借款人、出借人)
  • 贷款管理:完整的贷款和还款记录管理,自动计算还款进度

技术特性

  • 现代化技术栈Vue 3 + TypeScript + Vite + Pinia + Ant Design Vue
  • 本地存储:使用 IndexedDB 进行数据持久化,支持离线使用
  • Mock API:完整的 Mock 数据服务,方便开发和测试
  • 响应式设计:适配各种屏幕尺寸
  • 国际化支持:内置中文语言包,可扩展多语言

快速开始

安装依赖

pnpm install

启动开发服务器

pnpm dev:finance

访问系统

项目结构

src/
├── api/                 # API 接口
│   ├── finance/        # 财务相关 API
│   └── mock/           # Mock 数据服务
├── store/              # 状态管理
│   └── modules/        # 业务模块
├── types/              # TypeScript 类型定义
├── utils/              # 工具函数
│   ├── db.ts          # IndexedDB 工具
│   └── data-migration.ts # 数据迁移工具
├── views/              # 页面组件
│   ├── finance/       # 财务管理页面
│   ├── analytics/     # 统计分析页面
│   └── tools/         # 系统工具页面
├── router/            # 路由配置
└── locales/           # 国际化配置

数据存储

系统使用 IndexedDB 作为本地存储方案,支持:

  • 自动数据持久化
  • 事务支持
  • 索引查询
  • 数据备份和恢复

数据迁移

如果您有旧版本的数据(存储在 localStorage系统会在启动时自动检测并迁移到新的存储系统。

开发指南

添加新功能

  1. types/finance.ts 中定义数据类型
  2. api/finance/ 中创建 API 接口
  3. store/modules/ 中创建状态管理
  4. views/ 中创建页面组件
  5. router/routes/modules/ 中配置路由

Mock 数据

Mock 数据服务位于 api/mock/finance-service.ts,可以根据需要修改初始数据或添加新的 Mock 接口。

测试

运行 Playwright 测试:

node test-finance-system.js

部署

构建生产版本

pnpm build:finance

构建产物将生成在 dist 目录中。

技术支持

许可证

MIT