# hello-park

**Repository Path**: skyl4537/hello-park

## Basic Information

- **Project Name**: hello-park
- **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-04-02
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 停车场算费系统 🅿️

基于 AI 的停车场收费规则解析和费用计算系统。

## 功能特性

- 📤 **图片上传**: 上传停车场收费规则牌子图片
- 🤖 **AI 解析**: 调用 Claude API 自动解析收费规则为结构化数据
- 💰 **费用计算**: 根据入场/出场时间自动计算停车费用
- 🎨 **现代化界面**: Vue 3 + TypeScript 构建

## 技术栈

- **前端**: Vue 3 + TypeScript + Vite
- **后端**: Python + FastAPI
- **AI**: Claude API (claude-3-7-sonnet)

## 项目结构

```
hello-park/
├── backend/                    # FastAPI 后端
│   ├── main.py                # API 入口
│   ├── models.py              # 数据模型
│   ├── services/
│   │   ├── claude_service.py  # Claude API 调用
│   │   └── fee_calculator.py  # 算费引擎
│   └── requirements.txt
│
└── frontend/                   # Vue 3 前端
    ├── src/
    │   ├── components/        # Vue 组件
    │   ├── types/             # TypeScript 类型
    │   ├── api.ts             # API 调用
    │   ├── App.vue            # 主应用
    │   └── main.ts            # 入口
    ├── package.json
    └── vite.config.ts
```

## 快速开始

### 1. 安装依赖

**后端:**
```bash
cd backend
pip install -r requirements.txt
```

**前端:**
```bash
cd frontend
npm install
```

### 2. 配置环境变量

设置 Claude API Key:

```bash
# Windows
set ANTHROPIC_API_KEY=your_api_key_here

# Linux/Mac
export ANTHROPIC_API_KEY=your_api_key_here
```

### 3. 启动服务

**启动后端** (端口 8000):
```bash
cd backend
uvicorn main:app --reload
```

**启动前端** (端口 5173):
```bash
cd frontend
npm run dev
```

### 4. 访问应用

打开浏览器访问: http://localhost:5173

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/rules/parse` | 上传图片解析规则 |
| GET | `/api/rules/{id}` | 获取规则详情 |
| GET | `/api/rules` | 获取所有规则 |
| POST | `/api/calculate` | 计算停车费用 |
| DELETE | `/api/rules/{id}` | 删除规则 |

## 使用说明

1. **上传收费规则图片**: 点击或拖拽上传停车场收费规则图片
2. **AI 解析**: 点击"开始解析"，Claude 会自动提取收费规则
3. **查看规则**: 解析结果会显示在中间区域
4. **计算费用**: 选择入场和出场时间，点击"计算费用"

## 支持的收费规则类型

- 按小时计费 (首小时 + 后续小时)
- 按天计费
- 特殊时段计费 (白天/夜间/周末)
- 日封顶价格
- 免费时段

## 开发

### 后端开发
```bash
cd backend
uvicorn main:app --reload
```

### 前端开发
```bash
cd frontend
npm run dev
```

### 前端构建
```bash
cd frontend
npm run build
```

## 注意事项

- 需要有效的 Claude API Key
- 支持的图片格式: JPG, PNG, GIF, WebP
- 时区使用本地时区