骑手水印相机 (Rider Camera)

专业外卖配送凭证工具 — 打开即拍，自动合成 GPS 水印

---

📱 功能特性

核心功能

• 一键拍照 — 启动即拍，无广告无登录
• 专业水印 — 自动合成时间/地址/坐标/节日祝福
• 音量键拍照 — 支持音量 ± 键触发，适合戴手套操作
• OCR 识别 — 拍摄小票自动提取店名 + 订单号
• 二维码扫描 — 支持外卖码识别解析
• 连拍模式 — 长按连续拍摄多张
• 夜间护眼 — 黑色取景器 + 自动闪光灯联动
• 节日祝福 — 自动匹配节气/节日/黄历信息

水印设计

• 位置：可拖动至任意位置
• 背景：半透明黑底 + 圆角
• 内容：时间 / GPS 地址 / 经纬度 / 骑手信息 / 节日祝福 / 防篡改声明

---

🔐 权限需求（最小权限原则）

权限	用途
📷 CAMERA	拍照核心功能
📍 ACCESS_FINE_LOCATION	水印 GPS 定位
💾 存储权限	照片保存到相册
🌐 联网权限	广告加载 + 时间校准

---

🏗️ 项目架构

lib/
├── main.dart                  # 入口 + Boot 状态机
├── bootstrap/
│   ├── boot_controller.dart   # 启动编排器（权限→服务→状态）
│   └── app_boot_result.dart   # 启动结果 + AppBootState 枚举
├── config/
│   ├── theme_config.dart      # 深色主题
│   └── holiday_config.dart    # 节日配置
├── models/
│   ├── app_state.dart         # 全局应用状态
│   ├── user_state.dart        # 用户状态
│   └── photo_model.dart       # 照片模型
├── services/
│   ├── camera_service.dart    # 相机硬件封装
│   ├── permission_service.dart# 权限请求编排
│   ├── amap_location_service.dart # 高德定位
│   ├── watermark_service.dart # 水印合成
│   ├── decoration_service.dart# 节气/黄历/历史事件/小常识
│   ├── storage_service.dart   # 照片存储
│   ├── ocr_service.dart       # OCR 识别
│   ├── qr_scan_service.dart   # 二维码扫描
│   ├── ai_service.dart        # AI 语义解析
│   ├── ad_service.dart        # 广告服务
│   └── photo_history_service.dart # 历史记录
├── providers/
│   ├── camera_provider.dart   # 相机状态管理
│   └── settings_provider.dart # 设置状态管理
├── utils/
│   └── order_info_parser.dart # 订单信息正则解析器
├── screens/
│   ├── camera_screen.dart     # 主相机界面 (3000+ 行)
│   ├── photo_history_screen.dart
│   ├── stats_screen.dart      # 统计
│   ├── ocr_scanner_screen.dart# OCR 拍照识别
│   ├── qr_scanner_screen.dart # 扫码识别
│   └── watermark_templates_screen.dart
└── widgets/
    ├── camera_controls.dart
    ├── watermark_content_renderer.dart # 统一水印渲染
    ├── draggable_watermark.dart
    ├── zoom_control_widget.dart
    ├── simple_icon_button.dart
    ├── ai_panel.dart
    ├── smart_scan_button.dart
    └── scanned_info_widget.dart

---

🛠️ 编译运行

# 获取依赖
flutter pub get

# Debug APK（快速测试）
flutter build apk --debug

# Release APK（正式分发）
flutter build apk --release

# 代码静态分析
flutter analyze

编译环境

• Flutter SDK: E:\flutter_sdk\
• Android SDK: D:\Android\Sdk
• NDK: 28.2.13676358
• Kotlin: 2.0.21
• AGP: 8.9.1

---

📋 版本历史

版本	内容
v1.7+	Boot 状态机重构、JSON 数据分离、OrderInfoParser 统一解析、代码分析 0 error/0 warning
v1.6	OCR 识别、AI 解析、广告接入
v1.5	水印拖动、连拍模式、节日祝福
v1.4	相册管理、统计功能
v1.3	GPS 定位、高德地图
v1.2	水印自定义、模板管理
v1.1	基础拍照 + 水印合成
v1.0	初始版本

---

📄 许可证

本仓库代码仅供学习参考。未经授权不得用于商业用途。