Skip to content

Module 1: Getting Started

Audience: All users Prerequisite: None

Learning Objectives

By the end of this module, trainees will be able to:

  • Download and install OvApp on an Android device
  • Launch the app and grant required permissions
  • Select their role from the role selection screen

Flow Diagram

The following diagram shows the complete Getting Started flow from download to role selection:

flowchart TD
    A[Start] --> B{Choose Download Method}
    B -->|Scan QR Code| C[Scan QR with Phone Camera]
    B -->|Copy Link| D[Open Link in Browser]
    C --> E[APK File Downloads]
    D --> E
    E --> F{Install Blocked?}
    F -->|Yes| G[Enable Unknown Sources in Settings]
    G --> H[Install OvApp]
    F -->|No| H
    H --> I[Launch OvApp]
    I --> J[Grant Location Permission]
    J --> K[Grant Bluetooth Permission]
    K --> L[Role Selection Screen]
    L --> M{Select Your Role}
    M -->|Attendant| N[Attendant Dashboard]
    M -->|Sales Rep| O[Sales Rep Dashboard]
    M -->|Rider| P[Rider Login]
    M -->|Keypad| Q[Keypad Interface]
    M -->|BLE Device Manager| R[BLE Device Manager]

    style A fill:#4CAF50,color:#fff
    style L fill:#2196F3,color:#fff
    style N fill:#FF9800,color:#fff
    style O fill:#FF9800,color:#fff
    style P fill:#FF9800,color:#fff
    style Q fill:#FF9800,color:#fff
    style R fill:#FF9800,color:#fff

Visual Reference

Download Options

Trainees can download OvApp using either method:

OvApp QR Code

Scan this QR code with your phone camera, or copy the download link below.

Download link: https://apps.omnivoltaic.com/prod/oves.apk

Role Selection Screen

After installation and permissions, the role selection screen appears:

Role Selection

The main screen showing all available roles in OvApp.

Lesson 1.1 -- Downloading OvApp (5 min)

Key Points

  • OvApp is distributed as an APK file, not via the Play Store
  • Two download methods are available:

Hands-On Exercise

  1. Using your phone, download the OvApp APK using either method
  2. Locate the downloaded file in your Downloads folder
  3. Install the app (allow "Unknown sources" if prompted)

Common Issues

Issue Solution
"Install blocked" message Go to Settings > Security > enable "Unknown sources"
Download doesn't start Try a different browser (Chrome recommended)
File not found after download Check the Downloads app or File Manager

Lesson 1.2 -- First Launch & Permissions (5 min)

Key Points

  • On first launch, the app requests permissions:
    • Location -- needed for station maps and routing
    • Bluetooth -- needed for BLE device communication
  • Both permissions are essential for full functionality

Hands-On Exercise

  1. Open OvApp
  2. Grant Location permission when prompted
  3. Grant Bluetooth permission when prompted

Lesson 1.3 -- Role Selection (5 min)

Key Points

  • The role selection screen is the entry point to OvApp
  • Available roles: Attendant, Sales Representative, Rider, Keypad, BLE Device Manager
  • Each role unlocks a different set of features and workflows
  • Choose the role that matches your job function

Hands-On Exercise

  1. On the role selection screen, identify which role applies to you
  2. Tap your role to enter the app
  3. Observe the interface that loads -- note the navigation options available

Use Cases

Use Case 1: New Employee First Setup

Scenario: A newly hired station attendant receives their Android phone and needs to set up OvApp for the first time.

Steps:

  1. The supervisor shares the QR code or download link
  2. The employee scans the QR code and downloads the APK
  3. They enable "Unknown sources" and install the app
  4. On first launch, they grant Location and Bluetooth permissions
  5. They select the Attendant role

Expected Outcome: The employee sees the Attendant login screen and is ready for Module 4 training.

Use Case 2: Rider Receives Device from Sales Rep

Scenario: A customer has just been onboarded by a sales rep and needs to install the Rider App on their personal phone.

Steps:

  1. The sales rep shows the customer the QR code on the Getting Started page
  2. The customer scans it and downloads OvApp
  3. They install the APK and grant permissions
  4. They select the Rider role
  5. They log in with the phone number and temporary password provided by the sales rep

Expected Outcome: The customer sees their Home screen with vehicle and subscription details.

Knowledge Check

  1. What are the two ways to download OvApp?
  2. What permissions does OvApp need on first launch and why?
  3. What happens if you select the wrong role?
  4. Where do you find the APK file after downloading?
  5. Name at least three roles available in OvApp.

Assessment Rubric -- Module 1

Criteria Expert (4) Competent (3) Developing (2) Novice (1)
Download & Install Downloads, installs, and troubleshoots "Unknown Sources" without any help Downloads and installs independently Needs one prompt (e.g. reminded to enable Unknown Sources) Cannot complete installation without step-by-step guidance
Permissions Grants all permissions immediately and explains why each is needed Grants all permissions when prompted Grants permissions but unsure why they are needed Skips or denies permissions
Role Selection Selects correct role and can explain what each role does Selects correct role without hesitation Selects correct role after brief hesitation or one wrong tap Cannot identify which role to select
Knowledge Check Answers all 5 questions correctly Answers 4 of 5 correctly Answers 3 of 5 correctly Answers fewer than 3 correctly

Pass: Average score of 3.0 or above across all criteria.