feat: implement automation feature

2026-03-18 23:39:12 +01:00
parent 576d0366de
commit ef4424e267
121 changed files with 4544 additions and 1055 deletions
@@ -0,0 +1,224 @@
+import * as schema from '@cio/db/schema';
+
+import { AppError, ErrorCodes } from '@api/utils/errors';
+import type { TCourse, TOrganization } from '@db/types';
+import type { TCourseLandingPageMetadataUpdate, TCourseLandingPageUpdate } from '@cio/utils/validation/course';
+
+import { db } from '@cio/db/drizzle';
+import { env } from '@api/config/env';
+import { eq } from 'drizzle-orm';
+import { generateSlug } from '@cio/utils/functions';
+import { getCourseById } from '@cio/db/queries/course';
+import { getCourseOrganizationId } from '@cio/db/queries/tag';
+import { getDashboardBaseUrl } from '@api/config/dashboard-url';
+import { getOrganizationById } from '@cio/db/queries/organization';
+import { updateCourse } from '@api/services/course/course';
+
+type CourseLandingPageUpdateResult = {
+  course: TCourse;
+  courseUrl: string;
+  bannerImageUrl: string | null;
+};
+
+async function generateUniqueCourseSlug(baseSlug: string): Promise<string> {
+  let suffix = 0;
+  let candidate = baseSlug;
+
+  while (true) {
+    const existing = await db
+      .select({ id: schema.course.id })
+      .from(schema.course)
+      .where(eq(schema.course.slug, candidate))
+      .limit(1);
+
+    if (existing.length === 0) {
+      return candidate;
+    }
+
+    suffix += 1;
+    candidate = `${baseSlug}-${suffix}`;
+  }
+}
+
+async function ensureCourseSlug(courseId: string, title: string | null | undefined): Promise<string> {
+  const [course] = await getCourseById(courseId);
+  if (course?.slug) {
+    return course.slug;
+  }
+
+  const baseSlug = generateSlug(title, { fallback: 'course' });
+  const uniqueSlug = await generateUniqueCourseSlug(baseSlug);
+  await updateCourse(courseId, { slug: uniqueSlug });
+  return uniqueSlug;
+}
+
+function buildCourseBaseUrl(organization: TOrganization) {
+  if (organization.customDomain && organization.isCustomDomainVerified) {
+    return `https://${organization.customDomain}`;
+  }
+
+  return getDashboardBaseUrl(organization.siteName ?? undefined);
+}
+
+async function resolveCourseUrl(organizationId: string, courseId: string, title: string) {
+  const organization = await getOrganizationById(organizationId);
+  if (!organization) {
+    throw new AppError('Organization not found', ErrorCodes.ORG_NOT_FOUND, 404);
+  }
+
+  const slug = await ensureCourseSlug(courseId, title);
+  return `${buildCourseBaseUrl(organization)}/course/${encodeURIComponent(slug)}`;
+}
+
+async function resolveUnsplashBannerImage(courseTitle: string, query?: string) {
+  if (!env.UNSPLASH_API_KEY) {
+    return null;
+  }
+
+  const searchQuery = (query?.trim() || courseTitle.trim() || 'education').slice(0, 120);
+  const response = await fetch(
+    `https://api.unsplash.com/search/photos?page=1&per_page=15&auto=format&fit=crop&w=2970&q=80&client_id=${env.UNSPLASH_API_KEY}&query=${encodeURIComponent(searchQuery)}`,
+    { method: 'GET' }
+  );
+
+  if (!response.ok) {
+    return null;
+  }
+
+  const data = (await response.json()) as {
+    results?: Array<{
+      urls?: {
+        regular?: string;
+      };
+    }>;
+  };
+
+  const photos = data.results ?? [];
+  if (photos.length === 0) {
+    return null;
+  }
+
+  const photo = photos[Math.floor(Math.random() * photos.length)];
+  return photo?.urls?.regular ?? null;
+}
+
+async function resolveLandingPageImage(
+  courseTitle: string,
+  payload: Pick<TCourseLandingPageUpdate, 'generateImage' | 'imageQuery' | 'imageUrl'>
+) {
+  if (payload.imageUrl) {
+    return payload.imageUrl;
+  }
+
+  if (!payload.generateImage && !payload.imageQuery) {
+    return null;
+  }
+
+  try {
+    return await resolveUnsplashBannerImage(courseTitle, payload.imageQuery);
+  } catch (error) {
+    console.error('resolveLandingPageImage error:', error);
+    return null;
+  }
+}
+
+function mergeLandingPageMetadata(
+  existing: TCourse['metadata'] | null | undefined,
+  update: TCourseLandingPageMetadataUpdate | undefined
+): TCourse['metadata'] | undefined {
+  if (!update) {
+    return existing ?? undefined;
+  }
+
+  const current: NonNullable<TCourse['metadata']> = {
+    goals: '',
+    description: '',
+    requirements: '',
+    allowNewStudent: true,
+    ...(existing ?? {})
+  };
+
+  return {
+    ...current,
+    ...update,
+    reward: update.reward
+      ? {
+          show: update.reward.show ?? current.reward?.show ?? false,
+          description: update.reward.description ?? current.reward?.description ?? ''
+        }
+      : current.reward,
+    instructor: update.instructor
+      ? {
+          name: update.instructor.name ?? current.instructor?.name ?? '',
+          role: update.instructor.role ?? current.instructor?.role ?? '',
+          coursesNo: update.instructor.coursesNo ?? current.instructor?.coursesNo ?? 0,
+          description: update.instructor.description ?? current.instructor?.description ?? '',
+          imgUrl: update.instructor.imgUrl ?? current.instructor?.imgUrl ?? ''
+        }
+      : current.instructor,
+    certificate: update.certificate
+      ? {
+          templateUrl: update.certificate.templateUrl ?? current.certificate?.templateUrl ?? ''
+        }
+      : current.certificate,
+    sectionDisplay: update.sectionDisplay
+      ? { ...(current.sectionDisplay ?? {}), ...update.sectionDisplay }
+      : current.sectionDisplay,
+    reviews: update.reviews ?? current.reviews,
+    lessonTabsOrder: update.lessonTabsOrder ?? current.lessonTabsOrder
+  };
+}
+
+function normalizeReviews(reviews: NonNullable<TCourse['metadata']>['reviews'] | undefined) {
+  return reviews?.map((review, index) => ({
+    id: review.id ?? Date.now() + index,
+    hide: review.hide ?? false,
+    name: review.name,
+    avatar_url: review.avatar_url,
+    rating: review.rating,
+    created_at: review.created_at ?? Date.now(),
+    description: review.description
+  }));
+}
+
+export async function updateCourseLandingPageService(
+  courseId: string,
+  payload: TCourseLandingPageUpdate
+): Promise<CourseLandingPageUpdateResult> {
+  const [existingCourse] = await getCourseById(courseId);
+  if (!existingCourse) {
+    throw new AppError('Course not found', ErrorCodes.COURSE_NOT_FOUND, 404);
+  }
+
+  const nextTitle = payload.title ?? existingCourse.title;
+  const metadata = mergeLandingPageMetadata(existingCourse.metadata ?? undefined, payload.metadata);
+  const imageUrl = await resolveLandingPageImage(nextTitle, payload);
+
+  const updatedCourse = await updateCourse(courseId, {
+    title: payload.title,
+    description: payload.description,
+    overview: payload.overview,
+    cost: payload.cost,
+    currency: payload.currency,
+    metadata: metadata
+      ? {
+          ...metadata,
+          reviews: normalizeReviews(metadata.reviews)
+        }
+      : undefined,
+    ...(imageUrl ? { logo: imageUrl, bannerImage: imageUrl } : {})
+  });
+
+  const organizationId = await getCourseOrganizationId(courseId);
+  if (!organizationId) {
+    throw new AppError('Course organization not found', ErrorCodes.COURSE_NOT_FOUND, 404);
+  }
+
+  const courseUrl = await resolveCourseUrl(organizationId, courseId, updatedCourse.title);
+
+  return {
+    course: updatedCourse,
+    courseUrl,
+    bannerImageUrl: updatedCourse.logo || imageUrl || null
+  };
+}