# 个人账单应用

一个现代化的个人财务管理应用，支持自动读取支付通知记账、手动记账、数据分析和云同步功能。

## 技术栈

- **前端**: Vue.js 3 + Tailwind CSS + TypeScript
- **移动端**: Capacitor.js (Android)
- **后端**: Node.js + Express.js + MongoDB
- **数据库**: SQLite (本地) + MongoDB (云端)

## 核心功能

- 🔔 自动读取支付宝、微信等支付通知进行记账
- 📝 手动添加、编辑、删除交易记录
- 🔍 强大的搜索和筛选功能
- 📊 数据分析和趋势图表
- ☁️ 云端同步和离线支持
- 🎨 现代化的 neumorphic 设计风格

## 开发环境

- **开发平台**: Windows 11
- **服务器**: 阿里云 Ubuntu 24.04
- **Git 服务器**: 阿里云自建

## 项目结构

```
bill/
├── frontend/          # Vue.js 前端应用
├── backend/           # Node.js 后端 API
├── .kiro/            # Kiro IDE 配置和规格文档
│   └── specs/        # 项目规格说明
├── android/          # Android 项目 (Capacitor 生成)
└── docs/             # 项目文档
```

## 开发计划

项目采用离线优先的开发策略：

1. ✅ 建立 Git 版本控制和基础架构
2. 🔄 实现本地数据模型和离线功能
3. 📱 开发核心交易管理界面
4. 🔔 集成通知监听和自动记账
5. 📊 添加数据分析和图表功能
6. ☁️ 后期添加云端同步功能

## 快速开始

### 前端开发

```bash
cd frontend
npm install
npm run dev
```

### 后端开发

```bash
cd backend
npm install
npm run dev
```

### Android 构建

```bash
cd frontend
npm run build
npx cap sync android
npx cap open android
```

## 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。