Dashboard tour

The SoftSys Edu Analytics web dashboard (app.softsysanalytics.com) presents the tenant’s processed data across a series of theme-based pages. This page walks through each section so you know where to find every metric.

Authentication and access

To enter the dashboard you can use:

SSO from Moodle: if you have the Moodle plugin installed and the viewer shared secret configured, users with the appropriate capabilities (local/ssea:viewlearnerreport, local/ssea:viewinstructorreport) access from their Moodle profiles without entering credentials.
Direct login: standard email + password flow for tenant administrators.

Once inside, primary navigation lives in the left sidebar.

Overview — Home page

The / page is the entry point and shows the most relevant tenant KPIs.

Featured KPIs:

Total events in the selected period.
Active users (unique users who generated at least one event).
Total sessions (number of detected sessions).
Avg time per user (minutes).
At-risk students (count of users above the threshold).

Controls:

Period selector (7, 30, 90 days, or custom).
Trend chart (events per day/hour).

When to use it: quick review of the tenant’s overall state. Ideal for the first look of the day.

Users — User list

/users shows a paginated table with all active tenant users and their activity summary.

Main columns:

Full name and username.
Last activity (last_seen_at).
Total events.
Total time (minutes).
Risk level (low / medium / high / critical).
Risk score (0–100).

Available filters:

Search by name or username.
Filter by risk level.
Filter by role (student, teacher, manager).
Sort by any column.

Clicking a row opens the user profile (/users/:userId) with a daily timeline of their activity, quiz attempts history, submitted assignments, enrolled courses, and factors that contribute to their risk score.

Courses

/courses lists the courses synced from Moodle with engagement metrics.

Main columns:

Course full name and shortname.
Active users in the period.
Total events.
Avg time per user (minutes).
Completion rate (%).

Drill-down: clicking a course opens its detailed view with activity breakdown, submissions chart, and a list of at-risk students specific to that course.

Enrollment

/enrollment shows enrollment analytics:

Distribution by course.
New enrollment trend over time.
Distribution by role.
Enrollment cohorts (useful for retention).

Grades

/grades shows grade distribution at tenant and course level.

KPIs:

Average, minimum, maximum by course.
Top performers (Top 10 users).
Low performers (for proactive follow-up).
Historical distribution by grade range.

Completion

/completion shows activity and course completion rates.

Views:

Bar per course with % of users who completed.
Detail by activity within a specific course.
Completion funnel (useful to spot activities where users drop off).

At-Risk — At-risk students

/at-risk is one of the most-used pages by teachers and managers. It shows the students flagged at-risk by the detection worker.

Columns:

Name, course, risk level.
Risk score (0–100).
Risk factors (inactivity, low submission rate, low grades).
Days since last activity.
Acknowledgment state (whether a teacher already took action).

Filters:

By score threshold (slider 0.0–1.0).
By course.
Acknowledged / pending.
Sort (score_desc is the most common).

Actions:

Click a student → their detailed profile.
“Acknowledge” button → mark the alert as handled (recorded for audit).

See API — Dashboard REST for the equivalent endpoint.

Alerts

/alerts centralizes active notifications: inactivity, performance drops, completion milestones, grade drops, etc.

Columns:

Alert type (alert_type).
Severity (low, medium, high, critical).
Affected user.
Timestamp.
Descriptive message.
State (pending / acknowledged).

Actions:

Individual acknowledge.
Acknowledge all (useful when reviewing the day’s alerts).

Alerts are generated by the alerts worker in the background every hour, based on tenant-configurable rules.

Reports — Async reports

/reports shows the history of export jobs and lets you create new ones.

View:

Job table with report_type, format (CSV/JSON), state, requested date, and completion date.
Download button for completed jobs (artifacts are kept 7 days in R2).

Available report types:

retention_cohort — retention by enrollment cohort.
activity_funnel — completion funnel by activity.
teacher_course_health — course health from the teacher’s perspective.
student_learning_profile — aggregated student profile.
assessment_performance — assessment performance.
early_warning_summary — early warning summary.

See API — Dashboard REST for the equivalent API flow.

Settings

/settings includes tenant options:

Branding (Enterprise only): logo, primary color, product name.
Custom domains (Enterprise): white-label configuration.
Privacy options: toggle to hide sensitive data, GDPR prefs.
At-Risk thresholds: configure the default critical score.
Time zone: affects how timestamps are shown in views.

Monitors — Saved watchlists

On several pages (Users, Courses, At-Risk) you can save a set of filters as a monitor. A monitor is a named watchlist you can reopen with a single sidebar click.

Typical use cases:

“CS101 students with score > 0.7”
“Courses with completion < 30%”
“Alerts acknowledged this week by Juan”

Monitors are managed via /v1/tenants/:id/monitors in the API (see API — Dashboard REST).

Admin (super-admin only)

If your account has the super-admin role in SoftSys Solutions (normally the internal support team and Enterprise managers), you see an additional /admin/tenants section:

List tenants.
Create sub-tenants (on reseller plans).
Manage API keys.

These endpoints are not documented in the public API — they are for internal management only.

Moodle-embedded view

Students and teachers with the local/ssea:viewlearnerreport or local/ssea:viewinstructorreport capabilities access a reduced view of the dashboard embedded inside Moodle (in an iframe). This view:

Only shows the user’s own data (student) or their assigned courses (teacher).
Uses /v1/tenants/:id/viewer/** endpoints signed with the viewer shared secret.
Does not require the user to have a dashboard account — authentication comes from the Moodle plugin.

See API — Dashboard REST for the available endpoints.

Summary — where to find each thing

Quick view

Overview (/) — global KPIs + trend chart. Daily entry point.

Find a user

Users (/users) — paginated table with search and filters. Click for detailed profile.

Spot problems

At-Risk (/at-risk) + Alerts (/alerts) — prioritized list of students and actionable notifications.

Export data

Reports (/reports) — async jobs with CSV/JSON download (7-day persistence).