进京证助手 🚗
一款基于 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