Frequently Asked Questions

1. Open Safari on your iPhone.
2. Go to your app's URL (the one that looks like https://app--on-the-3s-8d87e855.base44.apps.
3. Tap the Share icon at the bottom of the screen. It looks like a square with an arrow pointing up.
4. In the menu that appears, scroll down and tap "Add to Home Screen".
5. You can change the name of the app icon if you want, then tap "Add" in the top-right corner.

An icon for "On the 3's" will now be on your home screen. Tapping it will open the app directly.

Add an answer to this item. 

1. Open the Chrome browser on your Android phone.
2. Go to your app's URL (the one that looks like https://app--on-the-3s-8d87e855.base44.app.
3. Tap the three-dot menu icon in the top-right corner.
4. From the menu, tap "Add to Home screen" or "Install app".
5. A confirmation box will pop up. Tap "Add" or "Install".

The "On the 3's" app icon will be added to your phone's home screen or app drawer, ready for you to use anytime.

Add an answer to this item. 

We've implemented a complete organization admin system:

✅ What's New:

• Three-tier role system: Super Admin → Organization Admin → Client
• Organization admins can manage their own organization's clients and generate reports
• Super admins can assign organization admins when creating/editing organizations
• Different navigation menus based on user role
• Organization admins are identified with a green "Admin" badge in the organization cards

🔒 Permissions:

• Super Admins: Full access to everything
• Organization Admins: Can only see and manage their own organization's data
• Clients: Access to their personal dashboard and family services

• Google-based login system
• Role-based access (Admin, Organization Admin, Client)
• Organization assignment and management

• GPS location tracking with configurable frequency
• Geofenced location management (add/edit locations with radius)
• Real-time geofence enter/exit detection and logging
• Interactive maps with user position and approved locations

• Manual biometric check-ins with photo verification
• Random check-in requests with location requirements
• Automatic check-in generation and scheduling
• Compliance tracking (on-time vs missed check-ins)

• Random alcohol test requests with time limits
• Manual alcohol data upload via CSV
• BAC level tracking and pass/fail status
• Automatic test generation and scheduling

• Curfew violation detection with GPS tracking
• Real-time alerts for pending check-ins and tests
• Comprehensive activity logging (dismissed notifications, permission changes, etc.)
• Battery level monitoring and low battery warnings

• Panic button with video recording and location tracking
• Emergency contact notification system
• Live camera feed during emergencies
• Screen wake lock to prevent interruptions

• Multi-organization support with admin roles
• Client assignment to organizations
• Organization-specific reporting and settings
• Appointment scheduling between organizations and clients
• Secure messaging system between organizations and clients

• Automated report generation (daily/weekly/monthly)
• Client compliance statistics and dashboards
• Activity logs with filtering and search
• Export capabilities for compliance data

• Progressive Web App (PWA) - installable on mobile devices
• QR code for easy app installation
• Responsive design for mobile and desktop
• Permission monitoring (camera, location access)
• App lifecycle tracking (backgrounding, closing)

• Client billing and case management
• Service configuration (enable/disable features per client)
• Location management with geofence settings
• User action audit trail
• Real-time compliance alerts and notifications

• Appointment scheduling calendar
• Secure messaging between organizations and clients
• Email notifications for appointments and violations
• Real-time alert system for compliance issues

This system provides end-to-end monitoring and compliance management for organizations that need to track client locations, sobriety, and appointment compliance.

This process is broken into three phases: 1. Onboard the Admin, 2. Create the Organization, and 3. Assign the Clients.

Before you can create an organization, the person who will manage it (the Organization Admin) must have an account in the system.

1. Invite the Admin User: Use the platform's user invitation system to send an invite to the designated Organization Admin's Google email address.
2. User Login is Required: The Organization Admin must accept the invitation and log in at least once using their Google account. This action creates their official User record in the database, making them available for the next step. Their default role will be user for now.

Now that the admin's user account exists, you can formally create their organization and assign them to it.

1. Navigate to Organizations: From the main portal, go to the Organizations page.
2. Create New Organization: Click the "New Organization" button.
3. Fill Out the Form:
   • Organization Name: Enter the official name of the organization.
   • Organization Admin Email: This is the most critical step. Enter the exact Google email address of the user you onboarded in Phase 1.
   • Reporting Settings: Configure reporting frequency and recipients as needed.

1. Save the Organization: When you click "Save," two important things happen automatically in the background:
   • The Organization record is created.
   • The system finds the user with the matching email, updates their role to organization_admin, and links their account directly to this new organization.

This single action correctly establishes the organization and assigns its designated administrator with the appropriate permissions.

With the organization and its admin in place, you can now add the individual clients who belong to it.

1. Invite Client Users: Just like with the admin, invite each client via their Google email. They must also log in at least once to create their user account in the system.
2. Navigate to Manage Clients: On the Organizations page, find the card for the new organization and click the "Manage Clients" button.
3. Add Clients by Email: In the dialog box, enter the email address of a client you onboarded in step 1 and click "Add". Repeat this for all clients belonging to this organization.
   • Behind the scenes: This action links the client's User record to the organization_id, officially placing them under that organization's management.

1. Add Client-Specific Data: Finally, go to the Reporting page and its "Client Data" tab. Here you can find the newly added clients and fill out their detailed profiles (billing info, emergency contacts, etc.) by clicking the "Edit" icon.

• Principle of Least Privilege: Users are created with the lowest-level user role first. They are only elevated to organization_admin through an explicit, auditable action by a Super Admin.
• Clear Segregation: This workflow ensures that client user accounts are not mixed up with administrative accounts. Data access is segregated from the moment of creation.
• No Password Management: By relying on Google's secure authentication, you completely avoid the risks associated with handling, storing, and resetting passwords.
• Atomic Association: The act of creating an organization and assigning its admin is a single, atomic operation, which prevents you from accidentally creating "orphan" organizations without anyone to manage them.

Following this structured process will ensure your organization and client data remains secure, organized, and correctly permissioned.

This guide provides a step-by-step walkthrough for administrators to set up, manage, and utilize all features of the platform.

Before you can monitor anyone, you must set up the core components of the system. This phase is typically performed by a Super Admin.

The system is built on user accounts. Before you can assign roles or create organizations, the individuals must exist in the system.

• Action: Use the platform's user management to send email invitations to your initial Organization Admins.
• Crucial Step: Each user must click the link in their invitation and log in at least once with their Google account. This creates their user record and makes them available for assignment.

Organizations are the primary containers for your clients and staff.

• Navigate: Go to the Organizations page from the main admin menu.
• Action: Click "New Organization".
  • Organization Name: Enter the company or group's name.
  • Organization Admin Email: Enter the email of the user you invited in the previous step. This automatically assigns them as the administrator for this specific organization.
  • Reporting Settings: Configure how often automated reports should be sent and who should receive them.
• Result: A new organization is created, and the designated user is granted organization_admin privileges over it.

These are the geofenced zones used for check-ins and other location-based services.

• Navigate: Go to the Locations page.
• Action: Use the form to add new locations. You can add them by address or by dropping a pin on the map.
• Geofence Radius: Define the size of the virtual boundary around the location in meters. This is critical for compliance monitoring.

With the foundation in place, you can now populate your organizations with staff and clients.

1. Invite User: Just like before, ensure the staff member has been invited and has logged in once.
2. Assign to Organization: Go to the Organizations page and click "Manage Clients" on the relevant organization card.
3. Add by Email: Enter the staff member's email and click "Add". They will be added with the default role of "Client".
4. Assign Role: In the user list, click the "Role" button next to their name. A dialog will appear where you can assign them a specific role like Case Manager or Staff, which grants them different levels of permissions.

1. Invite & Login: Ensure the client has been invited and has logged in once.
2. Add to Organization: Go to Organizations -> "Manage Clients" and add the client by email. They are automatically assigned the "Client" role.
3. Guided Onboarding (Client's First Experience): The first time this client logs in, they will be automatically redirected to the Onboarding Page. They will be guided to:
   • Install the App: Add the "On the 3's" app to their phone's home screen for easy access.
   • Grant Permissions: Approve necessary Location and Camera permissions, which are essential for monitoring to function.

1. Enter Client Data: As an admin, navigate to the Reporting page -> Client Data tab. Here you can edit the client's profile to add their billing information, emergency contacts, and other important details.

1. Invite & Login: The person to be protected must also be invited and log in once to create a user account.
2. App Installation: When they first log in, they will be prompted to install the "Safety Shield" app, which has a distinct, victim-focused interface.
3. No Role Assignment Needed: A victim's status is defined by being linked to a client in a Proximity Pair (see next phase), not by an assigned role.

Now you can enable the specific monitoring features for your clients.

• Navigate: All of these features are configured on the Services page.

• Enable the Service: Toggle the switch to enable "Random Check-Ins" or "Random Alcohol Testing" globally.
• Assign Clients: Use the client selector dropdown to add specific clients to the automated service. The system will now automatically send them requests at random intervals.
• Manual Generation: You can also trigger a check-in or test for all assigned clients immediately by using the "Generate Manually" button.

• Prerequisite: Curfew monitoring requires continuous GPS tracking.
• Enable GPS Tracking: First, enable the "GPS Tracking" service and add clients to it. This turns their app into a live location beacon.
• Enable Curfew: Next, enable the "Curfew Monitoring" service. Set the start and end times for the curfew window and assign the same clients. The system will now automatically log violations if they are outside their designated safe zone during curfew hours.

This is the core of the victim protection system.

• Navigate: Go to the Proximity page.
• Action: Click "New Pair".
  • Client Email: The user being monitored.
  • Victim Email: The user being protected.
  • Exclusion Zone: The minimum safe distance in meters.
  • Case Manager Email: The staff member who will receive an instant email alert if a breach occurs.
• How it Works: A background service continuously checks the live locations of both parties. If they get closer than the exclusion zone radius, a permanent Violation Log is created and the case manager is notified.

• Dashboard: Shows the client their approved locations on a map and their recent check-in history.
• Check-In Now: A prominent button allows for manual, biometric-verified check-ins at approved locations.
• Appointments & Messages: Allows clients to view upcoming appointments and communicate securely with their case manager.
• Family Services (Panic Button): A critical safety feature. When held for 3 seconds, it:
  • Starts recording video and audio from their phone.
  • Starts live-tracking their location.
  • Instantly notifies their designated emergency contact.

This app has a simplified, focused interface designed for peace of mind and quick access to help.

• Safety Dashboard: Clearly shows their current protection status and details of the active monitoring pairs.
• Recent Activity: A log of any recent proximity violations.
• Emergency Help: Provides large, clear buttons to Call 911 or access the same Panic Button tools as the client app.

This comprehensive workflow ensures that every feature, from user onboarding to advanced proximity monitoring, is set up securely and effectively.