# AccoumtSystem

**Repository Path**: ltttu/accoumt-system

## Basic Information

- **Project Name**: AccoumtSystem
- **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-06-18
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 财务记账系统

基于 PyQt6 的 AI 智能分类桌面记账软件

## 当前进度

✅ **Phase 1: 项目基础架构** 已完成
- 项目目录结构搭建
- 数据模型定义（Bill, CategoryConfig）
- 数据存储层（CSVRepository, JSONConfigStore）
- 主窗口框架（深色主题、左侧菜单、顶部工具栏、QTabWidget）

✅ **Phase 2: 记账录入功能** 已完成
- 表单式录入界面（日期、类型、分类、金额、备注）
- 快速命令行录入（2段/3段格式解析）
- AI 智能分类引擎（jieba分词 + 关键词匹配）
- 弱匹配弹窗交互（2个候选选择）
- 手动触发智能分类按钮

🚧 **Phase 3-8**: 开发中

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 运行程序

```bash
python src/main.py
```

## 项目结构

```
accoumt-system/
├── src/
│   ├── main.py              # 程序入口
│   ├── models/              # 数据模型
│   │   ├── bill.py          # 账单模型
│   │   └── category.py      # 分类配置模型
│   ├── core/                # 核心业务逻辑
│   │   ├── csv_repository.py      # CSV 数据仓储
│   │   └── json_config_store.py   # JSON 配置存储
│   ├── ui/                  # UI 组件
│   │   └── main_window.py   # 主窗口
│   └── utils/               # 工具函数
│       └── theme.py         # 主题样式
├── data/                    # 数据存储
│   ├── bills.csv            # 账单数据（自动生成）
│   ├── categories.json      # 分类配置（自动生成）
│   ├── settings.json        # 用户设置（自动生成）
│   └── backups/             # 备份文件
├── requirements.txt         # Python 依赖
└── README.md
```

## 功能特性

- ✅ 基础框架搭建
- ✅ 双模式记账录入（表单 + 快速命令行）
- ✅ AI 智能分类（jieba 分词 + 关键词匹配）
- 🚧 账单管理（CSV 存储、搜索过滤）
- 🚧 数据统计（matplotlib 图表）
- 🚧 Excel/PDF 导入导出
- 🚧 系统设置（主题切换、分类管理、预算配置）

## 技术栈

- **GUI 框架**: PyQt6
- **中文分词**: jieba
- **数据处理**: pandas
- **图表绘制**: matplotlib
- **图标资源**: FontAwesome

## 开发计划

详见 `openspec/changes/ai-finance-accounting-system/tasks.md`

## 许可证

MIT License