家庭记账本产品系统Vibe Coding

本项目面向个人和家庭用户的日常财务管理需求，针对传统Excel记账方式中数据分散、统计困难、可视化分析缺失等痛点，打造一款本地运行的桌面记账应用。通过数字化手段统一管理收入、支出、转账、信用消费、账户余额和保险资料，支持Excel历史账目导入与同步，帮助用户实现财务数据的集中化管理与多维度分析。

系统核心功能涵盖个人/家庭财务全生命周期管理：

1. 月度总览与统计汇总——按月展示收入、支出、结余及趋势图、支出占比环图，支持跨年度汇总与备注编辑；
2. 日账单与记一笔——支持逐笔记录收支，按月份区间、收支类型和关键字筛选，提供快速记账弹窗；
3. 月收入/月支出/信用消费——月度交叉表展示，支持Excel式动态列切换、手工月账单CRUD及来源审计；
4. 月余额管理——按月汇总账户余额快照，支持"机构→账户"交叉表钻取，净余额按资产减负债自动计算；
5. MU小金库——独立于家庭账本的资金管理模块，支持六类资金CRUD与同步保护；
6. Excel同步——支持Excel工作簿导入MySQL，含事务、重复检测、试运行和完整审计链；
7. 基础数据管理——账户、分类（两级树）、商户、保单的增删改查与启停管理。

作为项目核心负责人，我主导了从需求分析、架构设计到全栈开发的完整闭环。

架构上采用"React页面→浏览器API封装→Express本地API→MySQL"四层分层结构，前后端完全分离，数据库凭据不进入浏览器代码。

技术栈方面，前端基于React 19 + TypeScript 5 + Vite 7 + Ant Design 5 + Apache ECharts，后端基于Node.js + Express + mysql2，数据库采用MySQL 8，Excel导入模块使用Python + OpenPyXL + PyMySQL。

实现亮点包括：设计月账单（MONTHLY_SUMMARY）与日账单（TRANSACTION）双轨统计机制，通过record_granularity和counting_policy字段精确控制计入策略，防止月账单与日账单混算；构建完整的Excel导入审计链（import_batch→import_sheet→import_row→业务记录），实现数据溯源与防重复导入；设计动态列交叉表组件，月份按行、成员/账户/分类按列实时透视，不存储重复汇总数据；实现"用户-账本"隔离架构，所有业务数据归属ledger_books根节点，支持多账本管理。