# 黑马记账APP

**Repository Path**: zhuiyingxia/itheima-accounting-app

## Basic Information

- **Project Name**: 黑马记账APP
- **Description**: 黑马程序员VibeCoding实战开发课程-示例项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-08
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 记账app

个人日常记账桌面应用，帮助您轻松记录和管理每一笔花销。

## ✨ 功能

- **记一笔** — 记录金额、分类、日期、备注，支持小数点后两位
- **账单记录** — 按时间倒序查看所有消费，支持分类筛选
- **月度统计** — 按月查看总支出、各分类占比（饼图 + 柱状图）
- **分类管理** — 支持自定义一级/二级分类（10 个预置大类 + 47 个预置小类锁定保护）

## 🖥️ 运行截图

> 启动后即可看到三栏布局：左侧导航 → 中间内容区 → 右侧详情

## 🛠️ 技术栈

| 类别 | 技术 |
|------|------|
| 桌面框架 | Electron 33 |
| 界面 | React 19 + TypeScript |
| 构建 | Vite 6 |
| 数据库 | SQLite（sql.js） |
| 图表 | ECharts 6 |

## 📦 快速开始

### 环境要求

- [Node.js](https://nodejs.org/) 18 或以上版本
- npm（随 Node.js 一起安装）

### 安装与运行

```bash
# 1. 安装依赖
npm install

# 2. 启动开发模式（自动打开应用窗口）
npm run dev

# 3. 打包为安装程序（Windows）
npm run pack:win

# 4. 打包为安装程序（macOS）
npm run pack:mac
```

## 📁 项目结构

```
├── main.js              # Electron 主进程（窗口管理、SQLite、IPC）
├── preload.js           # 预加载脚本（安全桥接）
├── launch.js            # 开发模式启动器
├── package.json         # 项目配置与依赖
├── tsconfig.json        # TypeScript 配置
├── index.html           # HTML 入口
├── src/
│   ├── main.tsx         # React 入口
│   ├── App.tsx          # 应用主组件（记账、列表、统计、分类管理）
│   ├── App.css          # 全局样式
│   ├── categories.ts   # 分类数据与工具函数
│   ├── env.d.ts         # TypeScript 类型声明
│   └── vite-env.d.ts    # Vite 类型声明
└── vite.config.ts       # Vite 构建配置
```

## 📊 内置分类体系

| 一级大类 | 二级小类 |
|---------|---------|
| 🍜 餐饮 | 早餐、午餐、晚餐、零食水果、外卖、聚餐 |
| 🚗 交通 | 公交地铁、打车、加油、停车、火车高铁、飞机 |
| 🛒 购物 | 日用品、数码产品、家居家装、宠物用品、美妆护肤 |
| 🏠 住房 | 房租、水电、物业、维修、燃气 |
| 🎮 娱乐 | 电影、游戏、旅游、运动健身、KTV、订阅会员 |
| 🏥 医疗 | 门诊、药品、体检、住院 |
| 📚 教育 | 书籍、课程培训、考试报名 |
| 📱 通讯 | 话费、宽带、快递 |
| 👗 服饰 | 衣服、鞋子、包包、配饰 |
| 📦 其他 | 礼品、捐赠、其他 |

> 💡 预置分类不可修改，您可以在应用内自由添加自定义分类。

## 📄 许可证

MIT License