# CarCost API

车辆费用追踪后端 API，使用 FastAPI + SQLAlchemy + PostgreSQL 构建。

## 项目结构

```
api/
├── main.py              # FastAPI 入口
├── config.py            # 配置管理
├── database.py          # 数据库连接
├── models.py            # SQLAlchemy 模型
├── schemas.py           # Pydantic 数据模型
├── requirements.txt     # 依赖
├── routers/             # API 路由
│   ├── vehicles.py      # 车辆管理
│   ├── fuel_records.py  # 加油记录
│   ├── costs.py         # 费用记录
│   └── dashboard.py     # 仪表板
└── .env                 # 环境变量（不提交）
```

## 快速开始

### 1. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env 文件，设置 DATABASE_URL
```

### 2. 安装依赖

```bash
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```

### 3. 启动服务

```bash
python main.py
# 或
uvicorn main:app --host 0.0.0.0 --port 7030 --reload
```

### 4. 访问文档

- API 文档: http://localhost:7030/docs
- 健康检查: http://localhost:7030/health

## API 路由

所有路由前缀为 `/carcost`:

- `GET/POST  /carcost/vehicles/*` - 车辆管理
- `GET/POST  /carcost/fuel-records/*` - 加油记录
- `GET/POST  /carcost/costs/*` - 费用记录
- `GET       /carcost/dashboard/*` - 仪表板数据

## 技术栈

- **FastAPI**: Web 框架
- **SQLAlchemy 2.0**: ORM
- **PostgreSQL**: 数据库
- **Pydantic**: 数据验证
- **python-dotenv**: 环境变量管理