# JiZhang

**Repository Path**: zhangjun76/ji-zhang

## Basic Information

- **Project Name**: JiZhang
- **Description**: 为学习开发测试的简易页面应用

前端：Vue 3 + Vite + Axios
后端：Python Flask
数据库：SQLite
样式：Tailwind CSS
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-11
- **Last Updated**: 2025-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 记账本

个人开发的简易记账应用，前端基于 **Vue 3** + **Tailwind CSS**，后端采用 **Flask** 与 **SQLite**。项目既可以在浏览器中运行，也能通过 PyWebView 打包为桌面程序，适合学习和自用。

## 功能概览
- 邮箱验证码登录
- 新增、编辑、删除账单
- 自定义收支分类
- 查看分类统计图表

## 本地运行

### 前端（项目根目录执行）
```bash
cd frontend
npm install
npm run dev
```

### 后端（项目根目录执行）
```bash
cd backend
pip install -r requirements.txt
python run.py
```
`backend/dist` 目录提供了 Windows 可执行文件 `jz_app.exe`，无需安装环境即可启动。

## 数据存储位置
开发模式下数据库文件位于 `backend/app/db.sqlite3`。打包运行时，数据会保存到用户主目录 `~/.jizhang/db.sqlite3`，关闭应用后数据依然存在。

## VS Code 推荐插件
- SQLite Viewer
- Tailwind CSS IntelliSense

## 已修复问题
- 缺少收支类型定义字段
- 修改“添加账单”页面的分类时编辑接口不适配
- 列表账单页面：排序未调整，编辑和删除未连接后端，“所有时间”下拉列表改为“所有时间”
- 登录流程及导航栏 UI 优化
- 图表分析页面的分类统计图调整
- 登录验证码五分钟后自动失效

## 个人开发声明
本项目为个人学习和兴趣所作，代码和功能仍在持续完善中，暂不保证适用于生产环境。如有建议或问题，欢迎提出。