进京证助手 🚗

一款基于 UniApp 开发的进京证申请与管理助手应用，帮助非京牌车主快速查询、申请和管理进京证。

[!WARNING] 本项目是学习交流项目，建议申请进京证使用 [北京交警]官方 APP，此项目仅供学习交流使用，不可用于商业用途。

本项目 开源地址 https://github.com/skape/BeijingPermitCard

✨ 功能特性

📋 进京证状态查询

• 实时查询当前进京证状态（六环内/六环外）
• 显示证件有效期和剩余天数
• 通行状态一目了然（允许行驶/禁止行驶）

📝 在线申请办理

• 支持六环内、六环外进京证申请
• 自动填充车辆和驾驶员信息
• 可选择进京日期和目的地

🔄 自动续签提醒

• 进京证到期前自动提醒
• 六环外证件支持自动发起续签申请
• 可在设置中开启/关闭自动续签

📱 系统通知

• 应用切换至后台时发送状态通知
• 申请成功时发送系统通知

📜 历史记录

• 查看历史申请记录
• 显示每次申请的状态和有效期

🔧 其他功能

• 蓝牙设备连接管理
• 六环内进京证剩余次数显示（每年限 12 次）
• 精美的 UI 设计，支持下拉刷新

�📸 应用截图

允许行驶状态	禁止行驶状态
申请办理	设置页面

待开发功能

• 自动连接车载蓝牙 - 自动检测并连接车载蓝牙设备
• 声音预警功能 - 进入限行区域或证件即将到期时语音提醒

🛠️ 技术栈

• 框架: UniApp + Vue 3
• 构建工具: Vite
• 样式: TailwindCSS
• 包管理: pnpm

🚀 快速开始

环境要求

• Node.js >= 22 (LTS)
• pnpm

安装依赖

pnpm install

开发运行

使用 HBuilderX 导入项目后，选择对应平台运行即可：

1. 打开 HBuilderX
2. 导入项目：文件 → 导入 → 从本地目录导入
3. 运行：运行 → 运行到浏览器/小程序模拟器/手机或模拟器

打包构建

使用 HBuilderX 进行打包：

1. 发行 → 原生 App-云打包（ App ）
2. 发行 → 小程序-微信（微信小程序）
3. 发行 → 网站-PC Web 或 H5 （ H5 ）

📁 项目结构

src/
├── api/                 # API 接口
├── components/          # 组件
│   ├── HomeHeader.vue      # 首页头部状态卡片
│   ├── HomeActions.vue     # 首页操作区域
│   ├── ApplyModal.vue      # 申请办理弹窗
│   ├── HistoryModal.vue    # 历史记录弹窗
│   ├── SettingsModal.vue   # 设置弹窗
│   ├── BluetoothModal.vue  # 蓝牙管理弹窗
│   ├── PermitModal.vue     # 电子证件预览
│   └── AlertModal.vue      # 通用提示弹窗
├── config/              # 配置文件
├── pages/               # 页面
│   ├── index/              # 首页
│   └── webview/            # WebView 页面
├── static/              # 静态资源
├── utils/               # 工具函数
└── App.vue              # 应用入口

⚙️ 配置说明

Token 配置

应用需要北京交警平台的登录 Token 才能正常使用。首次使用请：

1. 打开应用，点击"前往登录"
2. 在 WebView 中登录北京交警平台
3. 登录成功后 Token 将自动保存

📄 License

MIT License