Plataforma de E-Learning

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy. Lição 88 de 91.

Desafio

Fácil

Vamos criar uma Plataforma de E-Learning que gerencia cursos, estudantes e instrutores. Este desafio abrangente reúne herança, interfaces, encapsulamento e padrões de projeto em um sistema coeso.

Você organizará seu código em seis arquivos:

User.php: Crie uma classe abstrata User que servirá como base tanto para estudantes quanto para instrutores. Use promoção de construtor para id (int) e name (string), ambos públicos e somente leitura. Inclua um método abstrato getRole(): string que as classes filhas deverão implementar.
Student.php: Inclua o arquivo User. Crie uma classe Student que estenda User. Os estudantes devem controlar seus cursos matriculados em um array privado e seu progresso (porcentagem concluída) para cada curso. Implemente:
- getRole(): string: retorna "Student"
- enrollInCourse(Course $course): string: matricula o estudante se o curso tiver capacidade; retorna uma mensagem de sucesso ou falha
- getEnrolledCourses(): array: retorna o array de cursos matriculados
- updateProgress(string $courseTitle, int $percent): void: define o progresso de um curso (0-100)
- getProgress(string $courseTitle): int: retorna a porcentagem de progresso ou 0 se não estiver matriculado
Instructor.php: Inclua o arquivo User. Crie uma classe Instructor que estenda User. Os instrutores podem criar e gerenciar cursos. Implemente:
- getRole(): string: retorna "Instructor"
- createCourse(string $title, int $capacity): Course: cria e retorna um novo Course com este instrutor atribuído
Course.php: Inclua o arquivo Instructor. Crie uma classe Course com promoção de construtor para title (string, público e somente leitura), instructor (Instructor, público e somente leitura) e capacity (int, privado). Controle os estudantes matriculados em um array privado. Implemente:
- getCapacity(): int: retorna a capacidade máxima
- getEnrolledCount(): int: retorna a quantidade atual de matrículas
- hasCapacity(): bool: retorna true se mais estudantes puderem se matricular
- addStudent(Student $student): bool: adiciona o estudante se a capacidade permitir; retorna o status de sucesso
- getStudents(): array: retorna o array de estudantes matriculados
Platform.php: Inclua os arquivos Course e Student. Crie uma classe Platform que gerencie todo o sistema. Armazene cursos e usuários em arrays privados. Implemente:
- addCourse(Course $course): void: adiciona um curso à plataforma
- findCourse(string $title): ?Course: encontra um curso pelo título
- enrollStudent(Student $student, string $courseTitle): string: matricula um estudante em um curso. Retorne "Course not found", "Course is full" ou "[name] enrolled in [title]"
- getCourseStats(string $title): string: retorna "[title]: [enrolled]/[capacity] students" ou "Course not found"
main.php: Inclua o arquivo Platform. Você receberá três entradas: dados do instrutor (JSON), cursos a serem criados (JSON) e operações a serem realizadas (JSON).
Formato do JSON do instrutor:
```
{"id": 1, "name": "Dr. Smith"}
```
Formato do JSON dos cursos:
```
[{"title": "PHP Basics", "capacity": 2}, {"title": "OOP Mastery", "capacity": 3}]
```
Formato do JSON das operações:
```
[{"type": "enroll", "student_id": 1, "student_name": "Alice", "course": "PHP Basics"}, {"type": "progress", "student_id": 1, "course": "PHP Basics", "percent": 50}, {"type": "stats", "course": "PHP Basics"}]
```
Crie a plataforma, o instrutor e todos os cursos (usando o método createCourse do instrutor). Adicione os cursos à plataforma. Em seguida, processe cada operação:
- "enroll": Crie um novo Student e matricule-o; imprima o resultado de enrollStudent()
- "progress": Atualize o progresso do estudante; imprima "[name] progress in [course]: [percent]%"
- "stats": Imprima o resultado de getCourseStats()
Mantenha o controle dos estudantes criados pelos seus IDs para que você possa atualizar o progresso deles posteriormente. Imprima o resultado de cada operação em uma nova linha.

Este desafio demonstra como a herança cria uma hierarquia de usuários organizada, o encapsulamento protege os dados de matrícula e a plataforma atua como uma coordenadora que gerencia os relacionamentos entre cursos, estudantes e instrutores.

Experimente você mesmo

<?php

require_once 'Platform.php';

// Ler entradas
$instructorData = (array)json_decode(trim(fgets(STDIN)), true);
$coursesData = (array)json_decode(trim(fgets(STDIN)), true);
$operations = (array)json_decode(trim(fgets(STDIN)), true);

// TODO: Criar a plataforma

// TODO: Criar o instrutor a partir de instructorData

// TODO: Criar todos os cursos usando o método createCourse do instrutor
// e adicioná-los à plataforma

// TODO: Acompanhar os estudantes criados pelo seu ID
$students = [];

// TODO: Processar cada operação
foreach ($operations as $op) {
    $operation = (array)$op;
    
    // TODO: Lidar com a operação "enroll"
    // Criar um novo Student e matriculá-lo
    // Imprimir o resultado de enrollStudent()
    
    // TODO: Lidar com a operação "progress"
    // Atualizar o progresso do estudante
    // Imprima "[name] progress in [course]: [percent]%"
    
    // TODO: Lidar com a operação "stats"
    // Imprima o resultado de getCourseStats()
}

?>