# jizhang

**Repository Path**: rocrunning/jizhang

## Basic Information

- **Project Name**: jizhang
- **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-07-24
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SNAP 记账复刻版

参考 iOS App Store 中的 SNAP 记账应用，使用 Go + Vue 复刻的跨平台记账应用。

## 功能

- 用户注册 / 登录（JWT）
- 首页月度收支概览 + 每日支出柱状图 + 按日期分组的账单列表
- 记一笔：支出 / 收入、金额、分类、细分、备注
- 统计页：月 / 年切换、支出排行、结余趋势、分类环形图
- 分类管理：自定义分类与细分
- 账单 CSV 导入 / 导出
- 响应式移动端 UI，支持 Capacitor 打包为 iOS / Android 应用

## 技术栈

- 后端：Go 1.22 / Gin / GORM / SQLite / JWT
- 前端：Vue 3 / TypeScript / Vite / Pinia / ECharts / Capacitor

## 快速开始

### 启动后端

```bash
cd backend
go mod tidy
go run main.go
```

Windows 用户建议显式指定 SQLite 数据库路径：

```powershell
$env:DB_PATH='C:\data\snap_accounts.db'
go run main.go
```

### 启动前端

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

浏览器访问 `http://localhost:5173`。

## 跨平台打包

```bash
cd frontend
npm run build
npx cap add ios      # 首次
npx cap sync ios
npx cap open ios

npx cap add android  # 首次
npx cap sync android
npx cap open android
```

> iOS 打包需要 macOS + Xcode；Android 需要 Android Studio。