feat: setup dashboard analytics api (#604)

* feat: setup dashboard analytics api * chore: requested pr fixes * fix: dash analytics server side type * refactor: update Avatar component usage across the dashboard - Replaced custom Avatar component with the new @cio/ui/base/avatar implementation for consistency. - Enhanced avatar rendering with fallback options and improved accessibility. - Cleaned up unused Avatar component files and related functions. - Updated various components to utilize the new Avatar structure, ensuring a uniform appearance and behavior across the application. * chore: remove console.log statements from analytics routes and API calls - Eliminated console.log statements for orgId and siteName in the dash analytics router and DashStatApi class to clean up the code and improve performance. --------- Co-authored-by: Rotimi Best <[email protected]>
2025-12-02 15:27:41 +01:00
parent c7854efae3
commit 9a5aee1ee0
40 changed files with 573 additions and 276 deletions
@@ -0,0 +1,60 @@
+import { AppError, ErrorCodes } from '@api/utils/errors';
+import { getCourseStats, getDashOrgStats, getRecentEnrollments } from '@cio/db/queries/dash';
+
+import { OrganisationAnalytics } from '@api/types';
+import { getOrgIdBySiteName } from '@db/queries';
+
+export async function getOrganisationAnalytics(orgId?: string, siteName?: string): Promise<OrganisationAnalytics> {
+  const analytics: OrganisationAnalytics = {
+    revenue: 0,
+    numberOfCourses: 0,
+    totalStudents: 0,
+    topCourses: [],
+    enrollments: []
+  };
+
+  let resolvedOrgId = orgId;
+
+  if (!resolvedOrgId && siteName) {
+    const [org] = await getOrgIdBySiteName(siteName);
+
+    if (org) {
+      resolvedOrgId = org.id;
+    } else {
+      throw new AppError('Organization not found for the given site name', ErrorCodes.ORG_NOT_FOUND, 404);
+    }
+  }
+
+  try {
+    const [stats, topCourses, enrollments] = await Promise.all([
+      getDashOrgStats(resolvedOrgId!),
+      getCourseStats(resolvedOrgId!),
+      getRecentEnrollments(resolvedOrgId!)
+    ]);
+
+    analytics.revenue = 0;
+    analytics.numberOfCourses = stats?.[0]?.noOfCourses ?? 0;
+    analytics.totalStudents = stats?.[0]?.enrolledStudents ?? 0;
+
+    analytics.topCourses = topCourses.map((c) => ({
+      id: c.courseId,
+      title: c.courseTitle,
+      enrollments: c.totalStudents,
+      completion: c.completionPercentage
+    }));
+
+    analytics.enrollments = enrollments.map((e) => ({
+      id: e.profileId,
+      avatarUrl: e.avatarUrl,
+      name: e.fullname,
+      courseId: e.courseId,
+      course: e.courseTitle,
+      date: e.enrolledAt
+    }));
+
+    return analytics;
+  } catch (error) {
+    console.error('Failed to load organisation analytics:', error);
+    throw new AppError('Failed to load organisation analytics', ErrorCodes.ORG_ANALYTICS_FETCH_FAILED, 500);
+  }
+}
@@ -1,3 +1,4 @@
 export * from './account';
 export * from './media';
 export * from './onboarding';
+export * from './dash';