Jafeng
bc998c35c7
- 建立基础的 Git 仓库结构 - 配置适用于 Vue.js + Node.js + Android 的 .gitignore - 添加项目说明文档和开发计划 - 包含 Kiro IDE 规格文档和项目计划
87 lines
2.0 KiB
Markdown
87 lines
2.0 KiB
Markdown
# 个人账单应用
|
|
|
|
一个现代化的个人财务管理应用，支持自动读取支付通知记账、手动记账、数据分析和云同步功能。
|
|
|
|
## 技术栈
|
|
|
|
- **前端**: 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) 文件了解详情。 |