# deposit_manager

**Repository Path**: nas-tool/deposit_manager

## Basic Information

- **Project Name**: deposit_manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 鸿蒙存单管理软件

## 项目简介

这是一个基于 HarmonyOS Next 开发的存单管理应用,参考"亿亿口袋"的设计理念,提供本地存储的存单管理功能,无需联网即可使用。

## 功能特性

### 核心功能
- **存单管理**: 添加、查看、编辑、删除存单信息
- **银行管理**: 支持15家常见银行快速选择,支持自定义银行
- **利息计算**: 自动计算存单利息和到期本息合计
- **状态跟踪**: 支持存储中、已取出、已转存等状态管理
- **到期提醒**: 显示存单到期状态和剩余天数

### 统计分析
- **总览统计**: 存单数量、存款总额、利息总额
- **银行分布**: 按银行统计存款金额占比
- **存期分布**: 按存期统计存单数量分布

### 设置功能
- **主题切换**: 支持蓝色、绿色、紫色、橙色四种主题
- **数据管理**: 支持清空所有存单数据
- **应用信息**: 显示版本号等基本信息

## 技术栈

- **开发语言**: ArkTS
- **开发工具**: DevEco Studio 4.0+
- **最低API版本**: API 11
- **目标API版本**: API 12
- **本地存储**: Preferences (用户首选项)

## 项目结构

```
deposit-manager-harmonyos/
├── entry/
│   ├── src/
│   │   └── main/
│   │       ├── ets/
│   │       │   ├── entryability/      # Ability入口
│   │       │   │   └── EntryAbility.ets
│   │       │   ├── model/             # 数据模型
│   │       │   │   └── DepositModel.ets
│   │       │   ├── storage/           # 存储管理
│   │       │   │   └── StorageManager.ets
│   │       │   ├── utils/             # 工具类
│   │       │   │   ├── DateUtils.ets
│   │       │   │   ├── NumberUtils.ets
│   │       │   │   └── GenerateId.ets
│   │       │   ├── pages/             # 页面
│   │       │   │   ├── Home.ets
│   │       │   │   ├── Index.ets
│   │       │   │   ├── AddDeposit.ets
│   │       │   │   ├── DepositDetail.ets
│   │       │   │   ├── Statistics.ets
│   │       │   │   └── Settings.ets
│   │       │   └── App.ets
│   │       ├── resources/            # 资源文件
│   │       │   └── base/
│   │       │       ├── element/
│   │       │       │   ├── color.json
│   │       │       │   └── string.json
│   │       │       ├── media/
│   │       │       └── profile/
│   │       │           └── main_pages.json
│   │       └── module.json5          # 模块配置
│   ├── build-profile.json5           # 构建配置
│   └── hvigorfile.ts                 # 构建脚本
├── build-profile.json5               # 应用构建配置
├── hvigorfile.ts                     # 应用构建脚本
└── oh-package.json5                  # 项目依赖配置
```

## 快速开始

### 环境准备

1. 安装 DevEco Studio 4.0 或更高版本
2. 配置 HarmonyOS SDK (API 11 或更高版本)
3. 准备一台鸿蒙设备或模拟器

### 导入项目

1. 打开 DevEco Studio
2. 选择 `File -> Open`
3. 选择 `deposit-manager-harmonyos` 项目目录
4. 等待依赖下载和项目同步

### 运行项目

1. 连接鸿蒙设备或启动模拟器
2. 点击工具栏的运行按钮或按 `Shift + F10`
3. 等待应用安装并启动

## 数据模型

### 存单 (Deposit)

```typescript
interface Deposit {
  id: string;                    // 存单ID
  bankName: string;              // 银行名称
  depositAmount: number;         // 存款金额
  depositDate: number;           // 存款日期(时间戳)
  maturityDate: number;          // 到期日期(时间戳)
  interestRate: number;         // 年利率(%)
  interestPeriod: number;        // 存期(月)
  interestAmount: number;        // 利息金额
  maturityAmount: number;        // 到期本息合计
  status: DepositStatus;         // 存单状态
  remark?: string;               // 备注
  createTime: number;            // 创建时间
  updateTime: number;            // 更新时间
}
```

### 存单状态 (DepositStatus)

- `SAVED`: 存储中
- `MATURITYD`: 已到期
- `WITHDRAWN`: 已取出
- `RENEWED`: 已转存

## 存储机制

应用使用 HarmonyOS 的 `Preferences` 进行本地数据持久化:

- 数据存储在应用沙箱内部
- 支持 Key-Value 键值对存储
- 自动同步到持久化文件
- 无需联网,完全本地存储

## 主要页面

### 1. 首页 (Home)
- Tab导航栏,包含存单、统计、设置三个标签页

### 2. 存单列表 (Index)
- 显示所有存单的列表视图
- 顶部统计卡片(存款总额、利息总额、本息合计)
- 支持刷新和添加存单

### 3. 添加存单 (AddDeposit)
- 银行选择(常见银行快速选择/自定义银行)
- 存款金额输入
- 存款日期选择
- 存期选择(3/6/12/24/36/60个月)
- 年利率输入
- 收益预览(利息金额、到期本息、到期日期)
- 备注输入

### 4. 存单详情 (DepositDetail)
- 显示存单完整信息
- 状态管理(存储中/已取出/已转存)
- 支持删除存单
- 到期状态提醒

### 5. 统计分析 (Statistics)
- 总览统计(存单数量、存款总额、利息总额)
- 银行分布统计
- 存期分布统计
- 支持按状态筛选

### 6. 设置 (Settings)
- 主题切换(蓝/绿/紫/橙)
- 数据管理(清空数据)
- 应用信息

## 注意事项

1. **图标资源**: 需要在 `entry/src/main/resources/base/media/` 目录下添加应用图标 `app_icon.png`
2. **权限申请**: 应用使用 Preferences 本地存储,无需申请额外权限
3. **API版本**: 最低要求 API 11,建议使用 API 12
4. **数据安全**: 数据存储在应用沙箱内,应用卸载后数据会清除

## 未来计划

- [ ] 添加数据导出功能
- [ ] 支持数据导入
- [ ] 添加提醒功能
- [ ] 支持多种存期类型
- [ ] 添加图表展示
- [ ] 支持暗黑模式

## 许可证

MIT License

## 联系方式

如有问题或建议,欢迎反馈。