Keep Accounts - 智能记账应用

项目概述

Keep Accounts是一款基于HarmonyOS开发的智能记账应用，帮助用户轻松记录和管理个人财务，实现财务可视化和数据分析。

技术栈

• 开发框架：HarmonyOS ArkTS 4.0
• 路由管理：HM Router
• 数据库：ArkData + ibest-orm
• 状态管理：ArkUI状态管理
• 组件库：自定义组件 + ArkUI基础组件

功能清单

已完成功能

1. 债务记录功能

• ✅ 数据模型优化（Person, Relationship, RelationshipTransaction）
• ✅ DAO层实现（DebtorDao, LoanDao, LoanRepaymentDao）
• ✅ 事务管理支持
• ✅ 错误处理机制

2. 永久投资组合计算功能

• ✅ 投资组合管理工具类（PortfolioManager）
• ✅ 类型错误修复
• ✅ 支持多种投资组合配置（永久型、保守型、稳健型、激进型）
• ✅ 投资组合计算逻辑

3. 金额计算功能

• ✅ 安全的表达式计算（替代eval）
• ✅ 支持键盘输入处理
• ✅ 支持多种运算场景（正数、负数、小数）
• ✅ 单元测试覆盖

4. 基础框架搭建

• ✅ 项目结构搭建
• ✅ 数据库初始化
• ✅ 数据模型定义
• ✅ DAO层实现
• ✅ 测试框架配置

待完成功能

1. 首页功能

• ⏳ 展示最近的收支记录
• ⏳ 提供快速记账入口
• ⏳ 显示财务概览信息

2. 财富管理

• ⏳ 账本管理（创建、编辑、删除）
• ⏳ 收支明细展示
• ⏳ 财务统计

3. 记账功能

• ⏳ 快速记账
• ⏳ 分类管理
• ⏳ 时间选择
• ⏳ 金额输入

4. 统计分析

• ⏳ 收支统计图表
• ⏳ 分类统计
• ⏳ 趋势分析
• ⏳ 月度报表
• ⏳ 投资组合分析报告

5. 系统设置

• ⏳ 主题切换
• ⏳ 数据备份
• ⏳ 账户管理

项目结构

entry/src/main/ets/
├── components/          # 通用组件
├── constants/           # 常量定义
├── dao/                 # 数据访问层
├── dialog/              # 对话框组件
├── dto/                 # 数据传输对象
├── entryability/        # 应用入口
├── enums/               # 枚举定义
├── manager/             # 业务管理类
├── models/              # 数据模型
├── pages/               # 页面组件
├── utils/               # 工具类
└── view/                # 视图层

核心模块说明

债务记录模块

• DebtorDao：处理债务人信息的CRUD操作
• LoanDao：处理贷款记录的CRUD操作和还款金额更新
• LoanRepaymentDao：处理贷款还款记录的CRUD操作

投资组合模块

• PortfolioManager：投资组合管理工具类，包含：
  • 投资组合配置获取
  • 投资组合计算
  • 预期收益计算
  • 重新平衡建议
  • 风险等级评估

开发指南

环境要求

• HarmonyOS SDK 4.0+
• DevEco Studio 4.0+
• Node.js 16.13.1+

安装依赖

npm install

编译运行

1. 在DevEco Studio中打开项目
2. 连接HarmonyOS设备或模拟器
3. 点击运行按钮编译并运行应用

测试

单元测试

npm run test

类型检查

npm run typecheck

代码 lint

npm run lint

文档

• 产品设计文档
• 产品需求文档
• 功能细化文档
• 功能设计文档

贡献

欢迎提交Issue和Pull Request来帮助改进项目。

许可证

MIT License

联系方式

如有问题或建议，欢迎联系开发团队。