1.1 About the Executive Dashboard

The Executive Dashboard is a dedicated app built for Salvation Army leadership and management. It provides a consolidated, real-time view of analytics and statistics across every territory that participates in the theological education programme.

Key characteristics:

• Read-only access -- you can view data and generate insights but cannot modify any records. All administrative actions (approvals, grading, enrollment changes) must be performed through the main Web Admin panel or mobile app.
• Cross-territory visibility -- aggregated data from Kenya, Rwanda, Burundi, Zimbabwe, and all other participating territories in a single view.
• Separate application -- the Executive Dashboard is distinct from the Web Admin panel. It presents information specifically tailored for strategic decision-making.

1.2 System Requirements

1.3 Logging In

The Executive Dashboard uses the same three-step authentication flow as the main platform. You must hold an Admin account to log in.

Step 1 -- Enter Credentials

Open the Executive Dashboard app or navigate to the dashboard URL in your browser. Enter your username and password, then select Login.

Step 2 -- OTP Verification

A one-time password (OTP) is sent to the phone number or email associated with your account. Enter the OTP code in the verification field and select Verify.

Step 3 -- Dashboard Redirect

After successful verification you are redirected to the main dashboard screen. All analytics load automatically.

1.4 Dashboard Layout

The interface is organised into three areas:

• Header Bar -- contains the College logo, a date range filter dropdown, a manual refresh button, and a logout button.
• Main Area -- a scrollable grid of stat cards and charts. On mobile devices, cards and charts stack vertically in a single column. On wider screens, they arrange in a responsive grid.
• Pull-to-Refresh -- on the mobile app, pull down on the main area to trigger a data refresh.

The main area contains:

• Stat Cards at the top (Total Students, Active Users, Pending, Marked, etc.)
• Row 1 Charts: Enrollment Trends (line chart) and Territory Breakdown (bar chart)
• Row 2 Charts: Assignment Analytics and Exam Analytics
• Row 3 Charts: Approval Statistics and Advanced Analytics

2.1 Stat Cards

The top row of the dashboard displays summary stat cards that provide an at-a-glance view of platform health.

Each card displays a single numeric value. If a date filter is active, the numbers reflect only the selected period.

2.2 Understanding the Numbers

• The numbers you see may be up to a few minutes old to ensure fast page loading.
• To get the latest data, use the Refresh button in the header bar.

3.1 12-Month Enrollment Trend

This line chart shows the number of new student enrollments per month over the last 12 months.

• X-axis: Months, labelled from the oldest month on the left to the current month on the right.
• Y-axis: Number of new enrollments in that month.
• Data points: Each point on the line represents the enrollment count for one calendar month.

3.2 Reading the Chart

• Spikes typically correspond to intake periods when new cohorts are admitted.
• Seasonal patterns may appear around academic year start dates, which vary by territory.
• A sustained upward slope indicates growing programme adoption.
• A declining trend may warrant investigation into enrollment barriers or communication gaps.

Hover over (or tap on mobile) any data point to see the exact count and month label in a tooltip.

4.1 Students by Territory

This bar chart shows the total number of enrolled students per territory.

• Each bar represents one territory (for example, Kenya, Rwanda, Burundi, Zimbabwe).
• The height of each bar corresponds to the student count in that territory.
• Bars are colour-coded for easy visual distinction.

4.2 Comparing Territories

Use this chart to:

• Identify high-enrollment territories that may need additional tutor resources or infrastructure support.
• Spot low-enrollment territories where outreach or promotional efforts could be increased.
• Inform resource allocation decisions such as tutor assignments, exam scheduling, and material distribution.

Tap on any bar to see the exact student count displayed in a tooltip.

5.1 Submission Rates

This metric shows the percentage of assignments that have been submitted by students out of the total number of assignments distributed.

• Displayed as a percentage with a visual progress indicator.
• A low submission rate may indicate students are struggling with the material, have not received notifications, or face connectivity issues.

5.2 Marking Progress

This section shows how many submitted assignments have been marked versus those still pending review.

• Marked: assignments that a tutor has reviewed and scored.
• Pending: assignments submitted by students but not yet graded.
• A subject-level breakdown is provided so you can identify which subjects have marking backlogs.

5.3 Score Distribution

Average assignment scores are displayed across subjects, giving insight into:

• Which subjects students find most challenging (lower average scores).
• Which subjects have consistently high performance.
• Whether score distributions are healthy or skewed.

6.1 Pass/Fail Rates

This chart displays the percentage of students who passed versus those who failed, based on the grading thresholds configured in the system (default: 50% pass mark).

• Can be viewed as an aggregate across all subjects or filtered by individual subject or territory.
• A pie chart or stacked bar provides the visual breakdown.

6.2 Performance by Subject

A ranked list or bar chart showing which subjects have the highest and lowest pass rates. Use this to:

• Identify subjects that may need curriculum review or additional tutor support.
• Recognise high-performing subjects where best practices could be shared.

6.3 Retake Statistics

Shows the number of students who have attempted an exam more than once.

• Retake count: total number of retake attempts across the platform.
• Retake rate: percentage of exam attempts that are retakes rather than first attempts.
• High retake rates on a specific subject may suggest the exam is too difficult or the learning materials need improvement.

7.1 Pending Approvals Count

The platform uses a two-stage approval process for student enrollment:

1. ETO Approval -- the Education Training Officer for the student's territory reviews and approves the enrollment.
2. Admin Final Approval -- a platform administrator gives final confirmation.

This section shows:

• Number of students awaiting ETO approval (first stage).
• Number of students awaiting Admin approval (second stage).
• Total pending across both stages.

7.2 Approval Turnaround

Displays metrics on how quickly approvals are being processed:

• Average time to ETO approval: the mean number of days between a student's enrollment request and ETO sign-off.
• Average time to Admin approval: the mean number of days between ETO approval and final Admin approval.
• Longer turnaround times may indicate that ETOs or Admins need reminders, or that the volume of requests exceeds capacity.

8.1 Subject-Territory Matrix

A table or heatmap grid showing student count per subject per territory.

• Cells with higher numbers are highlighted in darker shades.
• Helps identify which subjects are popular in which territories.
• Useful for deciding where to allocate tutors who specialise in specific subjects.

8.2 New vs Continuing Students

A grouped bar chart comparing fresh enrollments against continuing students in each territory.

• New students: those who enrolled within the current academic session.
• Continuing students: those who were already enrolled from a previous session.
• Useful for understanding retention rates and whether the programme is attracting new participants or primarily retaining existing ones.

8.3 Marking Progress by Subject

A series of horizontal progress bars, one per subject, showing the percentage of assignments that have been marked.

• Subjects with low marking completion percentages represent bottlenecks in the grading workflow.
• Helps leadership follow up with specific tutors or territories where marking is lagging.

9.1 Date Range Filter

The date filter in the header bar controls the time window for all metrics and charts on the dashboard.

When you change the filter:

1. All stat cards update to reflect only data within the selected period.
2. All charts re-render with the filtered dataset.
3. The selected filter persists until you change it or log out.

9.2 Refreshing Data

The dashboard data is stored temporarily to ensure fast load times. To get the latest data:

• Desktop/Web: Click the Refresh button (circular arrow icon) in the header bar.
• Mobile App: Pull down on the main scrollable area to trigger a pull-to-refresh.
• After refresh, all stat cards and charts reload with the most recent data.

10.1 Notification Events

The dashboard receives notifications for the following three event types:

10.2 Notification Bell

The notification bell icon is located in the header bar of the dashboard, next to the date filter and refresh buttons.

• Badge count: A red badge on the bell icon shows the number of unread notifications. For example, if three events occurred since you last checked, the badge displays "3".
• Opening the panel: Tap or click the bell icon to open the notification panel. The panel slides in from the right and lists all recent notifications in reverse chronological order (newest first).
• Mark as read: Tap a single notification to mark it as read. Its background changes from highlighted to normal, and the badge count decrements by one.
• Mark all as read: Tap the "Mark All as Read" button at the top of the notification panel to mark every notification as read. The badge count resets to zero.
• Clear all: Tap "Clear All" at the top of the panel to remove all notifications from the list entirely. This also resets the badge count to zero.
• Swipe to dismiss: On the mobile app, swipe a notification card to the left or right to dismiss it individually from the list.

10.3 Enabling and Disabling Notifications

Push notifications require permission from your device or browser.

Android

1. Open your device Settings.
2. Navigate to Apps > Executive Dashboard > Notifications.
3. Toggle notifications on or off as desired.

iOS

1. Open Settings > Notifications > Executive Dashboard.
2. Toggle "Allow Notifications" on or off.

Web Browser (Chrome / Firefox / Edge)

1. When you first open the dashboard, the browser may prompt you to allow notifications. Select "Allow" to receive push notifications.
2. To change this later, click the lock icon (or site settings icon) in the browser address bar and adjust the notification permission.

10.4 Troubleshooting: Not Receiving Notifications

If you are not receiving push notifications on the Executive Dashboard:

1. Check notification permissions. Verify that the device or browser has granted notification permission to the app (see Section 10.3).
2. Check your internet connection. Push notifications require an active internet connection. If the device is offline, notifications will not be delivered until connectivity is restored.
3. Restart the app. Close the Executive Dashboard completely and reopen it. This forces the app to re-establish its notification connection.
4. Contact your system administrator. If no users are receiving notifications, there may be a system-wide issue that needs to be resolved by the IT team.

11.1 Charts Not Loading

If one or more charts fail to render or show a loading spinner indefinitely:

1. Check your internet connection. The dashboard requires a live connection to load data.
2. Try the Refresh button. A temporary network error may have caused the initial load to fail.
3. Clear your browser cache (if using the web version). Go to your browser settings, clear cached data, and reload the page.
4. Restart the app (if using the mobile version). Close the app completely and reopen it.
5. If the problem persists, the system may be temporarily unavailable. Wait a few minutes and try again.

11.2 Data Seems Outdated

• There is a short delay between when data changes and when it appears on the dashboard. This delay is typically under five minutes.
• Use the Refresh button to request the latest data.
• If data still appears stale after refreshing, contact your system administrator to check that everything is running correctly.

11.3 Login Issues

11.4 Support Contact

For issues that cannot be resolved using the steps above, contact the platform support team:

• Email: Reach out to your regional system administrator.
• In-platform: Use the main application's chat feature to message an administrator.
• Escalation: If the issue affects multiple users or an entire territory, notify your Territorial Commander for coordinated support.

When reporting an issue, include:

1. A description of the problem.
2. The device and browser or app version you are using.
3. The date and time the issue occurred.
4. Any error messages displayed on screen (a screenshot is helpful).