Finance Assistant

一个用于记录家庭财务状态的 Web 应用：家庭成员、每月收入、支出、资产、负债、净资产、现金流、储蓄率、负债率、信用卡还款、实际储蓄，以及年度总结。

界面预览

下图使用临时演示数据库生成，不包含本地真实家庭、成员或流水数据。

功能

• 用户名和密码登录。
• 未登录用户可以注册一个新的家庭，并自动成为该家庭的创建者。
• 支持系统管理员、家庭创建者、家庭管理员、家庭普通成员四类视角。
• 首页是仪表盘，只展示家庭或成员的财务状态。
• 支持选择某个家庭的全家汇总，或选择该家庭中的某个成员。
• 流水、金融账户、成员、设置、学习内容拆分到独立导航页。
• 记录、编辑、删除收入、支出、还款、转账/储蓄流水，按月份查看。
• 自定义支出分类。
• 维护家庭成员的金融账户：储蓄卡、信用卡、现金、投资账户、贷款等。
• 账户类型会自动决定它在统计中属于资产还是负债。
• 刷信用卡消费会计入支出并增加负债。
• 信用卡还款不会重复计入支出，只减少资产和负债，并进入当月还款统计。
• 转入储蓄或投资账户可标记为实际储蓄。
• 自动计算本月现金流、还款后现金流、净资产、储蓄率、实际储蓄率和负债率。
• 按支出分类展示本月支出结构。
• 汇总年度收入、支出、结余、还款和实际储蓄。
• 核心财务指标提供鼠标悬浮说明。
• 页面底部提供财务名词解释与使用方法。
• 本地 SQLite 持久化，数据库文件位于 instance/finance.db。

默认账号

本地首次启动会自动创建以下演示账号：

角色	用户名	密码	权限
系统管理员	sysadmin	Admin@123!	可查看和修改所有内容
家庭创建者	creator	Creator@123!	当前家庭最高权限，可编辑/删除成员、重置账号密码、分配家庭管理员
家庭管理员	manager	Manager@123!	可添加成员、维护账户和流水
家庭普通成员	member	Member@123!	只读，只能查看

注册新家庭时，创建注册账号的用户会自动成为该家庭的 家庭创建者。家庭创建者可以在成员页添加家庭成员，并把成员设置为 家庭管理员。

本地运行

python -m pip install -r requirements.txt
python -m flask --app app run --host 127.0.0.1 --port 5000

打开：

http://127.0.0.1:5000

部署提示

当前版本适合部署到 Render、Railway、Fly.io、Azure App Service 等支持 Python/Flask 的平台。云端部署前建议：

• 设置 FLASK_SECRET_KEY 环境变量，生产环境不要使用默认开发密钥。
• 删除或修改默认演示账号密码。
• 把 SQLite 替换为托管数据库。
• 增加 HTTPS 和更完整的密码重置/成员邀请流程。