# 大D的海狮05EV通勤月历 - 功能说明

## 📋 项目概述

本项目是为比亚迪海狮05EV **「三电终身质保」**政策专门设计的通勤里程管理系统。通过可视化月历、实时里程扣减和灵活自定义记录功能，帮助车主科学管理年度行驶里程，确保合规用车、质保长伴。

### 质保核心限制
- **年度总限额**: 30,000 km
- **超限风险**: 超出将影响三电终身质保资格

---

## 📁 版本说明

本项目提供 **两个版本**，适用于不同使用场景：

### 1. byd_multi - 多用户版

**定位**: 支持多人使用的完整版本，适合家庭成员共享或多用户场景。

**目录结构**:
```
byd_multi/
├── data/
│   └── byd_users.db          # SQLite用户数据库
├── api.php                   # API接口
├── auth.php                  # 认证模块
├── db.php                    # 数据库操作
├── config.php                # 配置文件
├── index.php                 # 主入口页面
├── login.php                 # 登录页面
├── register.php              # 注册页面
├── logout.php                # 登出功能
├── activate.php              # 账号激活
├── admin.php                 # 管理员后台
├── admin_users.php           # 用户管理
├── admin_logs.php            # 日志管理
├── profile.php                # 用户资料
├── mail.php                  # 邮件功能
├── help.html                 # 功能说明书
├── test.php                  # 测试页面
├── test_api.php              # API测试
├── test_api2.php             # API测试2
├── test_calendar.php         # 日历测试
├── test_env.php              # 环境测试
├── debug_all.php             # 调试工具
├── diagnose.php               # 诊断工具
├── fix_user.php              # 用户修复工具
└── check_db.php              # 数据库检查
└── check_logs.php            # 日志检查
```

**核心功能**:
- ✅ 用户注册与登录认证
- ✅ 用户权限管理
- ✅ 管理员后台
- ✅ 操作日志记录
- ✅ SQLite数据库存储
- ✅ CSV数据导出导入
- ✅ 月历视图
- ✅ 动态预警系统

**技术架构**:
- 后端: PHP
- 数据库: SQLite
- 数据格式: CSV导出

---

### 2. byd_tracker - 单用户版

**定位**: 轻量级单用户版本，适合个人快速使用，无需注册登录。

**目录结构**:
```
byd_tracker/
├── api.php                   # API接口
├── index.html                # 主页面
├── byd_tracker.html          # 追踪器页面(旧版)
├── byd_tracker_new.html      # 追踪器页面(新版)
├── commute_config.json       # 通勤配置
├── commute_log.csv          # 通勤日志
├── help.html                # 功能说明书
└── index.html                # 入口页面
```

**核心功能**:
- ✅ CSV数据存储
- ✅ JSON配置管理
- ✅ 月历视图
- ✅ 里程计算
- ✅ 预警提示
- ✅ 数据导出

**技术架构**:
- 前端: HTML + JavaScript
- 后端: PHP API
- 数据格式: CSV + JSON

---

## 🎯 核心功能详解

### 📅 月历视图
- 以日历形式直观展示每日通勤记录
- 点击日期即可一键记录
- 所见即所得的操作体验

### 🔄 多端实时同步
- 基于 PHP+CSV 架构
- 手机、电脑、平板登录同一地址
- 数据秒级同步

### 📝 自定义里程记录
- 非固定通勤日可输入实际里程与事由
- 适用于：出差、办事、长途自驾等场景
- 系统精准扣减，账目更真实

### 🚨 动态预警系统
- **蓝色 (≥2000km)**: 安全额度充足
- **橙色 (<1000km)**: 额度紧张，建议增加公共交通
- **红色 (<0km)**: 已超限，立即停止非必要驾驶

### 💾 CSV 导出导入
- 一键导出为 Excel 兼容格式
- 方便本地备份和统计
- 支持跨平台数据迁移

### ⚙️ 参数灵活配置
- 已用基础里程：年初已行驶里程可录入
- 预留里程：为回老家、自驾游预留额度
- 适应不同时期的出行规划

---

## 📊 质保逻辑计算

| 计算项 | 说明 |
|--------|------|
| 年度总限额 | 固定 30,000 km |
| 已用基础里程 | 年初已行驶里程，在设置中录入 |
| 预留灵活里程 | 为回老家、自驾游预留的额度 |
| 通勤可用额度 | = 总限额 - 基础 - 预留 |
| 常规通勤扣减 | 开车默认 140 km/天，公交 0 km |
| 自定义扣减 | 按实际输入里程扣减，含事由备注 |
| 剩余安全额度 | = 通勤可用 - 所有记录 |

---

## 🚗 通勤类型

| 类型 | 标识 | 扣减里程 |
|------|------|---------|
| 通勤开车 | 🚗 | 140 km/天 |
| 公交/停开 | 🚌 | 0 km |
| 自定义/其他 | 📝 | 按实际输入 |

---

## 💡 使用小贴士

1. **精准记录非标行程**
   - 出差、周末自驾或跨区办事请使用「自定义」功能
   - 输入真实里程，避免剩余额度失真

2. **定期备份数据**
   - 建议每月点击「导出CSV」保存到本地
   - 服务器CSV文件建议额外备份

3. **质保政策提醒**
   - 除里程外，请确保：按时保养、非营运性质、首任车主身份

---

## 🔧 技术选型

| 组件 | 多用户版 | 单用户版 |
|------|---------|---------|
| 后端 | PHP | PHP |
| 数据库 | SQLite | JSON |
| 数据存储 | CSV | CSV |
| 用户系统 | ✅ 完整用户体系 | ❌ 无需用户系统 |
| 管理后台 | ✅ 有 | ❌ 无 |

---

## 📆 版本选择建议

- **选择多用户版 (byd_multi)**: 需要多人使用、管理后台、完整用户权限控制
- **选择单用户版 (byd_tracker)**: 个人使用、快速部署、轻量级方案

---

**科学规划 · 灵活记录 · 合规用车 · 质保长伴 🚗⚡**

&copy; 2026 大D的海狮05EV 专属工具 | Version 1.2