Laravel Learn Manage System (LMS)

Ideia de estruturação da pagina de cursos.

courses

id: id;
title: string (60);
subtitle: string (120);
description: text;
course_level_id: int references id course_levels;
cover_path: string; // References image on disk
paid: bool (false);
author_id: int references id users;

course_levels

id: int
name: string (20) 

Na issue #7, sugeri a criação de relação polifórmicas para a manipulação de Imagens.

Em seguida @NicolasPereira da Lib laravel-medialibrary

Abrir está issue, para discutimos sobre.

Essa é a modelagem básica do que eu estou pensando em fazer para a aula de um módulo.

lesson_types

id: int
name: string
slug: string

Seed: Video, Texto e Quiz

course_module_lessons:

id: uuid
title: string
description: string
type_id: int references id on lesson_types
content: text (polymorphic - url - text)
duration: time

Também estava vendo de utilizar o streaming da Azure para o projeto e deixar como padrão. Se tiverem alguma sugestão de como iremos fazer isso, favor deixar ai.

https://www.youtube.com/watch?v=Visn8ZBfSWs

Agora que já temos o fluxo de editar perfil do usuário temos que implementar a funcionalidade de foto de perfil do usuário na nossa plataforma!

Estamos utilizando a biblioteca da Spatie, Laravel Media Library, a implementação é bem tranquila!

Já tem uma implementação parecida com a thumbnail do curso.

Caso alguém queira implementar e tiver dificuldades pode me chamar!

Eu instalei e subi hoje o projeto na minha máquina para que possa começar a contribuir. Durante o processo percebi que tive alguns problemas não documentados que podem ser chatos de resolver, eu traduzi as intruções do README (até porque ele já está em Português na primeira metade) e adicionei as instruções que foram necessárias para rodar o projeto com sucesso.

Durante o PR #15 , me incomodou o fato de todos os providers estarem sendo chamados dentro da app.php, ignorando a responsabilidade de cada.

Tive a ideia, de utilizar um único provider e carrega-los dinamicamente através da instrução:

$this->app->register($provider);

Mas antes, eu precisava mapea-los. Para a solução do problema, tomei a liberdade em criar um domínio "Core", onde o mesmo irá mapear e gerenciar os domínios.

Para o mapeamento, precisei criar um entrypoint, para localização do domínio ou seja a partir de agora, para o funcionamento correto, cada Domínio, deve ter um arquivo chamado Domain.php, estendendo a classe \LMS\Core\Contracts\DomainInterface;

namespace LMS\Course;

use LMS\Core\Contracts\DomainInterface;

class Domain extends DomainInterface {}

Para o registrar um provider

basta adicionar o método registerProvider retornando um array com os respectivos providers:

    public function registerProvider(): array
    {
        return [
            \Spatie\Permission\PermissionServiceProvider::class,
            \LMS\Auth\Providers\AuthServiceProvider::class
        ];
    }

PS: Criei toda a estrutura no namespace \LMS, porém tenho minhas dúvidas, se não é melhor o mesmo está contido em um Namespace próprio.

Source Tree Overview:

├── Database
│   ├── migrations
│   │   ├── 2021_07_01_230819_create_courses_table.php
│   │   ├── 2021_07_01_230827_create_course_levels_table.php
│   │   └── 2021_07_01_230902_create_course_status_table.php
│   └── seeders
├── Http
│   ├── Controllers
│   │   ├── CoursesController.php
│   │   └── ViewController.php
│   └── Requests
│       └── CreateCourseRequest.php
├── Models
│   ├── Course.php
│   ├── Level.php
│   └── Status.php
├── Providers
│   └── CourseServiceProvider.php
├── Repositories
│   └── CourseRepository.php
└── Resources
    ├── lang
    └── views
        ├── courses.blade.php
        └── newCourse.blade.php

A ideia é implementar a lib do Spatie pra facilitar o trabalho, porém vamos precisar de alguém mais experiente pra fazer a review.

Vou começar uma PoC e coloco deixo o link do PR aqui pra ver se faz sentido.

https://spatie.be/docs/laravel-permission/v4/basic-usage/basic-usage

├── Landing │ ├── Repositories │ │ ├── LandingRepository.php

Verifiquei que no LandingRepository.php estavam sendo feitas duas queries para cada método que pega as informações dos cursos. Ajustei para que somente uma query seja feita por método, o que aumenta em 50% a performance. Aproveitei que estava mexendo nesse arquivo e refatorei algumas funções que estavam se repetindo.

https://github.com/DanielHe4rt/basement-lms/blob/76c1a3f43c0a0ba07e1014aff47cc325f427dcf2/LMS/Landing/Repositories/LandingRepository.php#L26

1. O código $model->where('paid', true) está seendo feita duas vezes dentro de uma mesma função. Essa chamada duplicada pode causar problemas de performance, ainda mais por se tratar da landing page.
2. O código que faz a variável $courseTime está sendo repetido três vezes durante a classe. Tamo junto primo.

├── Http │ ├── Controllers │ │ ├──MeController.php │ │ └── ViewController.php │ └── Requests │ │ ├──UpdateMeRequest.php ├── Models │ ├── User.php │ ├── Address.php ├── Observers │ └── UserObserver.php ├── Providers │ └── UserProvider.php ├── Repositories │ ├── MeRepository.php ├── Resources │ └── views │ ├─── profile.blade.php | ├─── editProfile.blade.php ├── Domain.php

Realizei a implementação da tela de editar usuários seguindo o layout proposto pela @vitoriazoche, conversamos um pouco sobre algumas melhorias e afins.

Realizei a criação de um mutator para o campo username, visto que utilizavamos em mais de uma tela do sistema e futuramente utilizaremos no fórum.

Realizei algumas melhorias também no arquivo profile.blade.php

ps: Ainda não fiz a implementação de foto de perfil para o usuário, por isso está tudo estático! Após a aprovação desse PR vou puxar essa demanda, quero fazer separado pra manter um fluxo de entregas mais limpo e fazer PR's menores.

é nozes

Eu tava pensando em uma parada bem importante que acabamos esquecendo: deveria ser tudo editável!

Quando falamos em um management system a premissa é que pelo menos os campso base seja editável, pique WP etc.

Podemos ver como implementar isso usando DB e mais o que precisar.

A ideia seria ter algo parecido com os posts dos CMS da vida, ex: Wordpress, onde vc pode criar todo o conteúdo do curso e ele fica como rascunho, com isso vc pode ver como vai ficar a página do curso e voltar editar alguma informação que acabou ficando errada antes de publicar.

Comportamento esperado:

• Botão visualizar (o texto pode ser qq outro) esse link vai abrir a tela do curso em uma nova aba, enquanto tiver rascunho somente o criador do curso pode visualiza-lo.

Acabei de subir o sistema de homologação e queria que fossem documentadas melhorias de UI ou até mesmo de fluxo do sistema que estão possivelmente estáticos.

Qualquer dúvida, pode me pingar aqui ou em qualquer rede social.

Caso você tenha interesse em contribuir pro nosso projeto, eu acabei esquecendo de fazer a flag published_at da entidade Course coexistir com o resto do sistema.

A ideia é que se a flag for preenchida, ele sair para modo publicado e outras pessoas terem acesso.

Ideia: criar dois métodos na entidade Course para manipular essa flag.

public function publish(): void
{
// preencher o published_at
}

public function unpublish(): void
{
// setar o published_at como vazio
}

Já pra interagir com o front-end eu não tenho ideias mas sei que vocês vão dar um jeito :p

A Udemy possui um serviço bem legal de avisos, onde o criador de conteúdo pode disparar e-mails com um aviso sobre novos módulos do curso, ou sobre novos cursos, lives e afins.

Acredito que seria interessante essa implementação no Basement-LMS

O projeto já conta com o Sails que permite com que o DEV tenha uma ótima DEVXP, mas seria interessante informar os requisitos de instalação do projeto tanto para quem prefere usar o servidor embutido do Laravel, quem usa Apache local e para quem futuramente quiser rodar esse projeto on premisse já que o Sails é uma ferramente projetada para desenvolvimento e não para produção.

Ex: As libs spatie/temporary-directory v.2.0 e spatie/laravel-medialibrary v.9.6.4 requerem PHP 8 e isso é uma informação importante pois quem utiliza Debian, CentOS, Rocky Linux e Fedora como servidor não tem essa versão do PHP disponível nos repositórios oficiais. Sendo necessário usar Docker.

É uma tarefa simples, mas que pode ajudar muitas pessoas que querem começar a contribuir com o projeto a encontrar uma primeira issue e isso pode ajudar muitas outras pessoas que querem rodar o projeto, testar e usar.