Group/User Controls

Show or hide the scan button using security groups and personal preferences-perfect for volunteer vs. manager roles.

Real-Time Analytics

Per-operator and per-device success/fail counters for performance tracking and shift feedback.

Configurable Feedback

Toggle success sounds, haptic vibration, and toasts from Settings to match venue noise and device policies.

Manual Lookup Panel

Find attendees by name or email right on the scan screen, then check them in with one tap.

Kiosk Mode

Full-screen, distraction-free layout that hides menus-ideal for front-of-house tablets.

Mobile-Optimized Scan Button

Injects a branded "Tap to Scan" action directly into the event barcode view with responsive spacing for phones and tablets.

Camera Integration via web_mobile

Launches the device camera using the web mobile RPC bridge so staff can scan barcodes without external hardware.

Instant Feedback & Toasts

Success, empty scan, and error states surface haptic vibration, toast notifications, or warnings for clear operator guidance.

Automatic Button Visibility

Detects when the mobile scanner API is unavailable and removes the button to keep desktop workflows uncluttered.

Event Bus Broadcasts

Publishes scan lifecycle events so other scripts can react-trigger badge printing, concierge alerts, or analytics in real time.

Haptic Confirmation

Uses mobile vibration APIs to confirm successful scans even in loud, crowded venues where audio cues are missed.

Manual Fallback Prompts

Guides staff to enter barcodes manually whenever the device returns an empty payload or loses camera permissions.

AI Performance Insights

Feeds the ai.job framework with attendance metrics so Odoo Engineering AI Suite routines can trigger reminders and staffing adjustments.

Security-Aware Design

Respects existing event permissions and never exposes scanning to users lacking access to the barcode interface.

Installation & Setup

1. Install the module: Go to Apps -> Search for "oe_event_mobile_scanner" -> Click Install
2. Verify dependencies: Confirm ``event_barcode`` and ``web_mobile`` are installed on the server
3. Grant access: Assign Event Manager or Event User roles to staff who will scan badges

Basic Usage

1. Open an event: Navigate to Events -> Barcode -> pick the live event you are staffing
2. Launch the scanner: Tap the "Tap to Scan" button on a mobile device running the Odoo mobile web client
3. Confirm check-ins: Watch for vibration, toast messages, or warnings and rescan if an empty payload is returned
4. Review performance: Use the Attendees smart button or Odoo Engineering AI Suite dashboards to monitor attendance levels

Tips & Best Practices

• Test camera permissions on every device before doors open
• Pair scan events with dashboards or signage using core.bus
• Assign devices to entry lanes so each doorway has a dedicated scanner
• Keep a manual entry shortcut handy for badges that are damaged or unreadable

Important Notes

Requires Odoo 12.0 with ``event_barcode`` and ``web_mobile`` installed. Camera access depends on browser support; we recommend the official Odoo mobile app or Chrome-based browsers for best results.

Q: Which Odoo versions are supported?

A: Odoo 12.0 Community and Enterprise with ``event_barcode`` and ``web_mobile`` installed. No enterprise-only components are required.

Q: How do I enable AI features?

A: Install ``oe_ai_job_base`` (already included in dependencies). Then call ``ai_event_scanner_performance`` from your Odoo Engineering AI Suite flows or scheduled jobs to evaluate attendance metrics.

Q: Can I customize the scan button or add automation?

A: Absolutely. The QWeb template, CSS, and JS are modular. Extend ``oe_event_mobile_scanner.scan_view`` or subscribe to ``oe_event_mobile_scanner`` bus events to run your own automation.

Why Choose Odoo Engineering