# CarCost

**Repository Path**: miss4826/car-cost

## Basic Information

- **Project Name**: CarCost
- **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-02-24
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# CarCost - 车辆费用管理应用

一款基于 .NET MAUI 开发的跨平台移动应用，用于全面管理车辆的各项费用支出，包括加油/充电、保养、保险、维修等记录。

## 功能特性

- **车辆管理**：支持添加多辆车辆，设置默认车辆
- **能源记录**：记录加油/充电详情，自动计算单价和油耗
- **费用记录**：跟踪各类车辆支出
- **保险记录**：管理交强险、商业险、车船税等
- **保养记录**：记录保养维修历史
- **数据导入导出**：支持数据的备份和恢复

## 技术栈

- **前端框架**：.NET MAUI
- **后端框架**：Entity Framework Core
- **数据库**：SQLite
- **架构模式**：MVVM

## 项目结构

```
CarCost/
├── CarCost.Core/           # 核心数据层
│   ├── Entities/           # 数据实体
│   ├── Migrations/         # 数据库迁移
│   ├── Models/            # 数据模型
│   └── Responses/         # 响应模型
├── CarCost/               # MAUI 应用
│   ├── ViewModels/        # 视图模型
│   ├── Views/             # 页面视图
│   ├── Services/          # 业务服务
│   └── ObservableRequests/ # 可观察请求对象
└── CarCost.slnx           # 解决方案文件
```

## 数据实体

| 实体 | 说明 |
|------|------|
| VehicleEntity | 车辆信息 |
| EnergyRecordEntity | 能源记录（加油/充电） |
| EnergyTypeEntity | 能源类型 |
| ExpenseRecordEntity | 费用记录 |
| ExpenseTypeEntity | 费用类型 |
| InsuranceRecordEntity | 保险记录 |
| MaintenanceRecordEntity | 保养记录 |

## 快速开始

### 环境要求

- .NET 8.0+
- Visual Studio 2022 或 VS Code
- Android SDK / iOS SDK（根据目标平台）

### 构建运行

```bash
# 克隆项目
git clone https://gitee.com/miss4826/car-cost.git

# 还原依赖
dotnet restore

# 运行项目
dotnet run --project CarCost
```

### 选择目标平台

```bash
# Android
dotnet run --project CarCost -f net8.0-android

# iOS
dotnet run --project CarCost -f net8.0-ios

# Windows
dotnet run --project CarCost -f net8.0-windows
```

## 主要页面

- **首页**：车辆概览和快速入口
- **能源记录**：加油/充电记录列表和新增
- **费用记录**：日常支出管理
- **保险记录**：保险信息管理
- **保养记录**：保养维修历史
- **设置**：数据导入导出、重置等

## 许可证

MIT License