feat: implement DASHBOARD_ORIGIN for invite and email links, enhancing self-hosted configuration and updating related documentation

apps/api/src/services/course/invite.ts

@@ -19,7 +19,7 @@ import { ROLE } from '@cio/utils/constants';
 import type { TCreateCourseInvite } from '@cio/utils/validation/course/invite';
 import crypto from 'node:crypto';
 import { db } from '@cio/db/drizzle';
-import { env } from '@api/config/env';
+import { getDashboardBaseUrl } from '@api/config/dashboard-url';
 import { getCourseTeachers } from '@cio/db/queries/course/people';
 import { getProfileById } from '@cio/db/queries/auth';
 import { buildEmailFromName, sendEmail } from '@cio/email';
@@ -150,20 +150,12 @@ function getInviteStatus(invite: {
   return 'ACTIVE';
 }
 
-function getAppBaseUrl(orgSiteName?: string): string {
-  if (env.NODE_ENV === 'development') {
-    return 'http://localhost:5173';
-  }
-  const subdomain = orgSiteName && orgSiteName !== 'app' ? orgSiteName : 'app';
-  return `https://${subdomain}.classroomio.com`;
-}
-
 /**
  * Builds the course enroll URL for invite links (emails, etc.).
- * Uses org subdomain in production.
+ * Uses DASHBOARD_URL when set (self-hosted), otherwise org subdomain in production.
  */
 export function buildEnrollLink(courseSlug: string, token: string, orgSiteName?: string): string {
-  const base = getAppBaseUrl(orgSiteName);
+  const base = getDashboardBaseUrl(orgSiteName);
   return `${base}/course/${encodeURIComponent(courseSlug)}/enroll?invite_token=${encodeURIComponent(token)}`;
 }
 

apps/api/src/services/course/people.ts

@@ -11,7 +11,7 @@ import {
 import { ROLE } from '@cio/utils/constants';
 import type { TAddCourseMembers } from '@cio/utils/validation/course/people';
 import type { TGroupmember } from '@cio/db/types';
-import { env } from '@api/config/env';
+import { getDashboardBaseUrl } from '@api/config/dashboard-url';
 import { getCourseWithOrgData } from '@cio/db/queries/course';
 import { getProfileById } from '@cio/db/queries/auth';
 import { buildEmailFromName, sendEmail } from '@cio/email';
@@ -176,7 +176,7 @@ export async function addMembers(courseId: string, members: TAddCourseMembers) {
     const addedMembers = await Promise.all(members.map((member) => addCourseMember(courseId, member)));
 
     // Send welcome emails for teachers (TUTOR role = 2, ADMIN role = 1)
-    const baseUrl = env.NODE_ENV === 'development' ? 'http://localhost:5173' : 'https://app.classroomio.com';
+    const baseUrl = getDashboardBaseUrl(orgSiteName);
     const inviteLink = `${baseUrl}/org/${orgSiteName}/courses`;
 
     // Send welcome emails to teachers