家庭记账（Family Expense Tracker）

面向国内 20~40 岁双职工家庭的离线优先安卓记账应用。核心设计理念是"约定大于配置"：用户只需要输入金额，分类、账户、成员等字段由系统按约定默认值 + 本地热度推荐自动填充，把"记一笔"的摩擦降到最低。

核心特性

• 极速记账：唯一必填 = 金额；推荐位 Top3 一键预选；首页模板卡点一下整笔记完
• 先记后理：拿不准分类的先存进"待整理"，晚间批量滑动归类，每笔 ≤2 秒
• 热度推荐：时间衰减热度引擎（半衰期 14 天）统一驱动推荐位 / 分类排序 / 模板卡，纯本地学习，零上云
• 二级分类：默认预置一套（餐饮→早餐/外卖/咖啡奶茶…），可在分类管理自由微调
• 预算管控：月度总预算 + 进度条三级预警（绿/黄/红）
• 统计报表：分类占比环形图、Top 排行（Compose Canvas 自绘，零图表依赖）
• 数据安全：一键 JSON 备份 / 恢复 + 五类对账摘要；数据仅存本机，零网络、零第三方 SDK
• 家庭多用户：成员管理、一键切换用户、每笔流水归属清晰
• 自动化：周期记账（房租/工资自动入账）、回收站 30 天清理

技术栈

层	技术
语言 / UI	Kotlin 2.0 · Jetpack Compose（BOM 2024.09）
架构	MVVM + Repository，domain / data / ui 三层（domain 纯 Kotlin 无 Android 依赖）
数据库	Room 2.6（SQLite，金额以分 Long 存储）
后台任务	WorkManager（周期记账 / 回收站清理）
图表	Compose Canvas 自绘
构建	AGP 8.7.3 · Gradle 8.10.2 · JDK 21 · minSdk 26 / targetSdk 36

项目结构

app/                App 壳与 Compose UI（四 Tab：首页 / 明细 / 报表 / 我的）
core/domain/        领域层纯函数（统计口径 / 推荐引擎 / 预算 / 周期计算）
core/data/          Room 数据层（实体 / DAO / 预置种子 / 备份）
docs/               需求 v1.3 · 概设 v1.1 · 详设 v1.1 · 开发计划
prototype/          H5 交互原型（iPhone 17 Pro 402×874）

文档索引

文档	说明
需求说明书	PRD/SRS v1.3：产品目标、用户故事、业务规则 BR-01~14、验收标准
概要设计	HLD v1.1：能力地图、架构决策 ADR、模块边界
详细设计	LLD v1.1：DDL、类图、热度推荐算法、任务拆解 T1~T11
开发计划	里程碑 M0~M6、提交规范、质量门禁
交互原型	H5 原型，浏览器直接打开即可体验

构建运行

前置：JDK 21、Android SDK（platform 36，模拟器 API 36 x86_64），Gradle 由 wrapper 提供。

./gradlew :core:domain:test            # 领域层测试（JVM 纯函数）
./gradlew :core:data:testDebugUnitTest # 数据层测试（Robolectric）
./gradlew :app:assembleDebug           # 构建 debug APK

APK 输出：app/build/outputs/apk/debug/app-debug.apk

里程碑

里程碑	内容	状态
M0	工程骨架 + 依赖目录	✅ 已合并 master
M1	账本核心（Room schema / 统计口径）	✅ 已合并 master
M2	预算与报表（周期边界 / 聚合 / 演示页）	✅ 已合并 master
M3	热度推荐与智能记账（推荐引擎 / 记账面板 / 待整理）	✅ 已合并 master
M4	自动化 / 数据安全 / 完整 UI（周期记账 / 备份 / 管理页 / 二级分类）	✅ 已合并 master
M5	账单导入（微信/支付宝）、应用锁、深色模式、无障碍	排期中

许可证

MIT © 2026 chiadan