Admin – Mobile App

The Mobile App is linked to the desktop app and designed to be used on a web browser.
It is also managed from BOS Tools.

How to Add Users to the Mobile App

1. Login to BOS Tools.
2. Click Admin (BOS).
3. Right click the applicable company and select View/Edit Users from the context menu.
4. Click Edit (button) on the top row.
5. On the top row, type in the details of the new user:
   1. Status = Enabled.
   2. Desktop = Enabled.
   3. Mobile = Enabled.
   4. Username = Type the person’s username.
   5. Email = Type the person’s email address.
      • Note: This must be a valid email address because the user’s login credentials are emailed to them.
6. Right click the Username and select Assign Database from the context menu.
7. Move the databases that the user can have access to from the Available to the Selected section.
   • Note: To revoke access: move the databases from the Selected to the Available section.
8. Click OK (button).
9. Close the popup using the X in the corner.
10. Right click the Username and select Invite to Mobile from the context menu.
    • Note: The user is now activated for mobile. An invitation email with login details and a link to open the app is sent to the user.

---

How To Release a New Mobile Version

The Mobile app does not need to be upgraded for each new Desktop version.

1. Update the code on the main branch for the front- and backends.
2. Login to BOS Tools.
3. Click Mobile Releases on the Tile menu.
4. Select a Desktop Version from dropdown list next to Release.
   • Note: The dropdown list contains the desktop versions that have already been released.
5. Click Release (button)
   • Note: This action does the following:
     • Creates a new S3 bucket, Route 53 entry and CloudFront Distribution.
     • Copies the Frontend App from Code Commit to the new S3 bucket.
     • Creates a new Lambda for the backend.
     • Updates the frontend environment variable with the URL of the new backend.
     • Creates a versioned branch that can be checked out and updated later.
6. Associate the new mobile release with a desktop release:
   1. Close the Mobile Versions popup.
   2. Click Versions & Scripts on the Tile Menu.
   3. Click Menu (button) > Versions.
   4. Click Edit (button).
   5. Click the Mobile Version column next to the desktop version and select the corresponding mobile version from the dropdown list.
   6. Click Save (button).
   7. Close the popup.

---

How To Update a Mobile Version

1. Check out the version branch.
2. Update the code.
3. Commit and Push to branch.
4. Login to BOS Tools.
5. Click Mobile Releases on the Tile menu.
6. Right click a version and select Update Frontend from the context menu.
7. Right click a version and select Update Backend from the context menu. 
8. Close the popup.

---

Architecture

• The mobile app is a browser-based app consisting of a Node.js backend and a Vue.js frontend.
• Frontend:
  • Single page app uploaded to S3.
  • Each version has its own Bucket: e.g. [1-0-0.bos.quickeasysoftware.com](http://1-0-0.bos.quickeasysoftware.com).
  • The Frontend backets are hosted in Singapore and distributed to other regions using CloudFront.
• Backend: Lambda function.

---

Version Control

• The Desktop application is the primary Version Number which is linked to the Database.
• The Desktop Versions table contains a Mobile Version field which indicates the Mobile Version that is compatible with the Desktop Version.
• When a User logs into a database, the Mobile Version linked to the database is retrieved and the user is directed to the applicable app.
• The version number displayed on the menu inside the app is the Mobile Version number.
• The source code is stored on AWS Code Commit.
• Versions are managed in AWS Code Commit as branches.

---