Skip to content

BrainsWorking/WebHorario

Repository files navigation

Sistema de Horários

Sistema de controle de horários escolares para a empresa ACME (fictícia).

Requisitos

  • XAMPP, WAMPP, LAMPP, EasyPHP e similares, ou instalação na mão do PHP e MySQL.
  • Composer

Instalação

Ao clonar, vá até a pasta do projeto, e execute no console:

composer install

Logo após:

php artisan serve

Eentre então no seu navegador em localhost:8000

Padrões (Convenções)

Nomenclatura

  • Nomes de rotas, rotas e métodos de rotas devem coincidir e devem ser verbos e ter seus nomes no singular:
    Ex: Route::name('turno.cadastrar')->get('turno/cadastrar', 'TurnoController@cadastrar'); Obs: Perceba, todos utilizam o nome "cadastrar" e "turno".

  • O index é uma exceção, pois é a lista, este deve estar no plural no nome, e o index é omitido no nome e na rota também:
    Ex: Ex: Route::name('turnos')->get('turnos/', 'TurnoController@index');

  • O mesmo também vale para as views, devem estar contidas dentro da pasta com o nome do modelo e os arquivos devem estar como verbos no singular, sendo apenas o index a exceção;

  • Nomes dos métodos no controller e sufixos de rotas (baseados na convenção em inglês, a frente está o método de request):

    • index: Lista de resultados, página inicial; (GET)
    • cadastrar: Form de cadastro; (GET)
    • salvar: Método que põe o valor do form no banco; (POST)
    • editar: Form de edição; (GET)
    • atualizar: Atualiza os dados no banco; (PATCH)
    • deletar: Remove do banco de dados; (GET)
    • formModelo: Para nome do arquivo de terá o form de criação e edição. Ex.: formCurso, formDisciplina.
    • Obs: Os demais métodos devem seguir este padrão, sendo sempre verbos;

Pastas fora do padrão

  • App/Helpers: Esta pasta guarda arquivos que contém apenas funções que poderão ser executadas em qualquer local do projeto;