进京证助手
一款基于 UniApp 开发的进京证申请与管理助手应用，帮助非京牌车主快速查询、申请和管理进京证。
[!WARNING] 本项目是学习交流项目，建议申请进京证使用 [北京交警]官方 APP，此项目仅供学习交流使用，不可用于商业用途。
功能特性
进京证状态查询
- 实时查询当前进京证状态（六环内/六环外）
- 显示证件有效期和剩余天数
- 通行状态一目了然（允许行驶/禁止行驶）
在线申请办理
- 支持六环内、六环外进京证申请
- 自动填充车辆和驾驶员信息
- 可选择进京日期和目的地
自动续签提醒
- 进京证到期前自动提醒
- 六环外证件支持自动发起续签申请
- 可在设置中开启/关闭自动续签
系统通知
- 应用切换至后台时发送状态通知
- 申请成功时发送系统通知
历史记录
- 查看历史申请记录
- 显示每次申请的状态和有效期
其他功能
- 蓝牙设备连接管理
- 六环内进京证剩余次数显示（每年限 12 次）
- 精美的 UI 设计，支持下拉刷新
应用截图
 允许行驶状态 |  禁止行驶状态 |
 申请办理 |  设置页面 |
待开发功能
- 自动连接车载蓝牙 - 自动检测并连接车载蓝牙设备
- 声音预警功能 - 进入限行区域或证件即将到期时语音提醒
技术栈
- 框架: UniApp + Vue 3
- 构建工具: Vite
- 样式: TailwindCSS
- 包管理: pnpm
快速开始
环境要求
- Node.js >= 22 (LTS)
- pnpm
安装依赖
pnpm install 开发运行
使用 HBuilderX 导入项目后，选择对应平台运行即可：
- 打开 HBuilderX
- 导入项目：文件 → 导入 → 从本地目录导入
- 运行：运行 → 运行到浏览器/小程序模拟器/手机或模拟器
打包构建
使用 HBuilderX 进行打包：
- 发行 → 原生 App-云打包（ App ）
- 发行 → 小程序-微信（微信小程序）
- 发行 → 网站-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 才能正常使用。首次使用请：
- 打开应用，点击"前往登录"
- 在 WebView 中登录北京交警平台
- 登录成功后 Token 将自动保存
License
MIT License
Select Language