Base de Datos

TalentBricksAI usa PostgreSQL con Prisma ORM. Los modelos se definen en app/schema.prisma.

Diagrama de Relaciones

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│    User     │────▶│ Enrollment  │◀────│   Course    │
└─────────────┘     └─────────────┘     └─────────────┘
       │                   │                   │
       │                   │                   │
       ▼                   ▼                   ▼
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ Certificate │     │LessonProgress│◀───│   Lesson    │
└─────────────┘     └─────────────┘     └─────────────┘

Modelos de Cursos

Course (Curso)

model Course {
  id             Int        @id @default(autoincrement())
  createdAt      DateTime   @default(now())
  updatedAt      DateTime   @updatedAt
  title          String
  slug           String     @unique
  description    String
  thumbnail      String?
  price          Int        // en centavos (USD)
  currency       String     @default("USD")
  difficulty     Difficulty @default(BEGINNER)
  category       String
  isPublished    Boolean    @default(false)
  instructorName String     @default("TalentBricksAI")

  lessons      Lesson[]
  enrollments  Enrollment[]
  certificates Certificate[]
}

enum Difficulty {
  BEGINNER
  INTERMEDIATE
  ADVANCED
}

Campo	Tipo	Descripcion
id	Int	ID autoincremental
slug	String	URL-friendly identifier, unico
price	Int	Precio en centavos (2900 = $29.00)
difficulty	Enum	BEGINNER, INTERMEDIATE, ADVANCED
isPublished	Boolean	Solo cursos publicados son visibles
instructorName	String	Nombre del instructor del curso

Lesson (Leccion)

model Lesson {
  id          Int       @id @default(autoincrement())
  createdAt   DateTime  @default(now())
  courseId    Int
  course      Course    @relation(fields: [courseId], references: [id])
  title       String
  description String?
  order       Int
  duration    Int       // en segundos
  videoUrl    String
  content     String?   // markdown content
  isPreview   Boolean   @default(false)

  progress    LessonProgress[]
}

Campo	Tipo	Descripcion
order	Int	Orden de la leccion en el curso
duration	Int	Duracion en segundos
videoUrl	String	URL del video (S3/CloudFront)
isPreview	Boolean	Lecciones preview son accesibles sin enrollment

Enrollment (Inscripcion)

model Enrollment {
  id          Int       @id @default(autoincrement())
  createdAt   DateTime  @default(now())
  userId      Int
  user        User      @relation(fields: [userId], references: [id])
  courseId    Int
  course      Course    @relation(fields: [courseId], references: [id])
  completedAt DateTime?

  progress    LessonProgress[]

  @@unique([userId, courseId])
}

El constraint @@unique([userId, courseId]) asegura que un usuario solo puede tener una inscripcion por curso.

LessonProgress (Progreso de Leccion)

model LessonProgress {
  id            Int       @id @default(autoincrement())
  updatedAt     DateTime  @updatedAt
  userId        Int
  lessonId      Int
  lesson        Lesson    @relation(fields: [lessonId], references: [id])
  enrollmentId  Int
  enrollment    Enrollment @relation(fields: [enrollmentId], references: [id])
  watchedSeconds Int      @default(0)
  isCompleted   Boolean   @default(false)

  @@unique([userId, lessonId])
}

Campo	Tipo	Descripcion
watchedSeconds	Int	Segundos vistos del video
isCompleted	Boolean	Leccion marcada como completada

Certificate (Certificado)

model Certificate {
  id                    Int       @id @default(autoincrement())
  createdAt             DateTime  @default(now())
  userId                String
  user                  User      @relation(fields: [userId], references: [id])
  courseId              Int
  course                Course    @relation(fields: [courseId], references: [id])
  verificationCode      String    @unique @default(uuid())

  // Snapshot data (capturado al momento de generacion)
  studentName           String
  courseTitle           String
  instructorName        String
  totalDurationMinutes  Int

  @@unique([userId, courseId])
  @@index([verificationCode])
}

Campo	Tipo	Descripcion
verificationCode	String	UUID unico para verificacion publica
studentName	String	Nombre del estudiante (snapshot)
courseTitle	String	Titulo del curso (snapshot)
instructorName	String	Nombre del instructor (snapshot)
totalDurationMinutes	Int	Duracion total en minutos (snapshot)

Datos Snapshot

Los datos se guardan como “snapshot” porque si el curso cambia de nombre o instructor despues de emitir el certificado, el certificado mantiene la informacion original.

Modelo User (Actualizado)

model User {
  id               Int       @id @default(autoincrement())
  createdAt        DateTime  @default(now())

  // Campos existentes
  isAdmin          Boolean   @default(false)
  subscriptionStatus String?
  // ...otros campos existentes

  // Nuevas relaciones para cursos
  enrollments      Enrollment[]
  certificates     Certificate[]
}

Comandos de Base de Datos

# Iniciar PostgreSQL (dejar corriendo)
wasp db start

# Crear migracion despues de cambiar schema.prisma
wasp db migrate-dev

# Abrir Prisma Studio (GUI para ver datos)
wasp db studio

# Ejecutar seed script
wasp db seed

Consultas Comunes

Obtener cursos publicados con lecciones

const courses = await context.entities.Course.findMany({
  where: { isPublished: true },
  include: {
    lessons: {
      orderBy: { order: 'asc' }
    }
  }
});

Obtener enrollments de un usuario con progreso

const enrollments = await context.entities.Enrollment.findMany({
  where: { userId: context.user.id },
  include: {
    course: {
      include: {
        lessons: true
      }
    },
    progress: true
  }
});

Calcular progreso de un curso

const enrollment = await context.entities.Enrollment.findUnique({
  where: { userId_courseId: { userId, courseId } },
  include: {
    course: { include: { lessons: true } },
    progress: { where: { isCompleted: true } }
  }
});

const totalLessons = enrollment.course.lessons.length;
const completedLessons = enrollment.progress.length;
const progressPercent = Math.round((completedLessons / totalLessons) * 100);

Indices Recomendados

Para optimizar consultas frecuentes:

model Course {
  // ...
  @@index([isPublished])
  @@index([category])
}

model Lesson {
  // ...
  @@index([courseId, order])
}

model Enrollment {
  // ...
  @@index([userId])
  @@index([courseId])
}