Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/edssaac/gerenciador-escolar

O Gerenciador Escolar é a solução completa para simplificar a gestão acadêmica em escolas.
https://github.com/edssaac/gerenciador-escolar

bootstrap composer css html javascript jquery mysql php

Last synced: 3 days ago
JSON representation

O Gerenciador Escolar é a solução completa para simplificar a gestão acadêmica em escolas.

Awesome Lists containing this project

README

        

## Apresentação Geral

**Nome do Projeto:** Gerenciador Escolar

**Descrição:**

O Gerenciador Escolar é a solução completa para simplificar a gestão acadêmica em escolas. Com ele, é possível cadastrar alunos, criar turmas,
efetuar matrículas de alunos em turmas e gerar listas de chamada de forma prática e organizada.

Essa aplicação centraliza todas as informações necessárias para uma administração escolar eficaz, proporcionando uma gestão mais ágil e assertiva.

![demo](./public/images/demo/school-manager.gif)

**Objetivo:**

Desenvolver um sistema que atendenda aos requisitos apresentados neste [teste de programação](https://github.com/Edssaac/gerenciador-escolar/blob/main/teste_programacao.pdf).

**Tecnologias Utilizadas:**

![COMPOSER](https://img.shields.io/badge/Composer-885630?style=for-the-badge&logo=composer&logoColor=white)
![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white)
![MYSQL](https://img.shields.io/badge/MySQL-005C84?style=for-the-badge&logo=mysql&logoColor=white)
![HTML](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge&logo=html5&logoColor=white)
![CSS](https://img.shields.io/badge/CSS3-1572B6?style=for-the-badge&logo=css3&logoColor=white)
![BOOTSTRAP](https://img.shields.io/badge/Bootstrap-563D7C?style=for-the-badge&logo=bootstrap&logoColor=white)
![JAVASCRIPT](https://img.shields.io/badge/JavaScript-323330?style=for-the-badge&logo=javascript&logoColor=F7DF1E)
![JQUERY](https://img.shields.io/badge/jQuery-0769AD?style=for-the-badge&logo=jquery&logoColor=white)

## Para Desenvolvedores

Se você é um desenvolvedor interessado em contribuir ou entender melhor o funcionamento do projeto, aqui estão algumas informações adicionais:


**Requisitos de Instalação:**

![COMPOSER](https://img.shields.io/badge/Composer-2.5.5-885630?style=for-the-badge&logo=composer)
![PHP](https://img.shields.io/badge/PHP-7.4.33-777BB4?style=for-the-badge&logo=php)


**Instruções de Instalação:**
1. Clone o repositório do projeto:
```
git clone https://github.com/edssaac/gerenciador-escolar
```

2. Navegue até o diretório do projeto:
```
cd gerenciador-escolar
```

3. Configure o Composer:
```
composer install
```

4. Configure o banco de dados:

```sql
CREATE DATABASE IF NOT EXISTS `school_manager`;

USE `school_manager`;

CREATE TABLE IF NOT EXISTS `student` (
`id` INT NOT NULL AUTO_INCREMENT,
`name` VARCHAR(250) NOT NULL,
`birth_date` DATE NOT NULL,
`cpf` VARCHAR(11) NOT NULL,
PRIMARY KEY (`id`)
);

CREATE TABLE IF NOT EXISTS `class` (
`id` INT NOT NULL AUTO_INCREMENT,
`description` VARCHAR(250) NOT NULL,
`year` SMALLINT SIGNED NOT NULL,
`vacancies` SMALLINT NOT NULL,
PRIMARY KEY (`id`)
);

CREATE TABLE IF NOT EXISTS `registration` (
`id` INT AUTO_INCREMENT,
`id_student` INT,
`id_class` INT,
`registration_date` DATE NOT NULL,
PRIMARY KEY (`id`),
FOREIGN KEY (`id_student`) REFERENCES `student`(`id`),
FOREIGN KEY (`id_class`) REFERENCES `class`(`id`)
);
```

5. Configure o .env com os dados necessários.


**Como Executar:**

Após concluir as etapas de instalação e configuração mencionadas acima, você está pronto para iniciar a aplicação. Siga os passos abaixo:

1. Como esta é uma aplicação simples, você pode usar o servidor embutido do PHP para servir a aplicação.

Abra o terminal e execute o seguinte comando na raiz do projeto:
```
php -S localhost:8080
```
Isso iniciará um servidor local na porta 8080.

2. Uma vez que o servidor esteja em execução, abra seu navegador e acesse a seguinte URL na barra de endereço:
```
http://localhost:8080
```
Isso irá carregar a página inicial da aplicação.

Certifique-se de que o servidor PHP embutido esteja sempre em execução enquanto você estiver trabalhando na aplicação localmente.

Se desejar encerrar o servidor, basta pressionar `ctrl + C` no terminal onde o servidor está sendo executado.

## Contato

[![GitHub](https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white)](https://github.com/edssaac)
[![Gmail](https://img.shields.io/badge/Gmail-D14836?style=for-the-badge&logo=gmail&logoColor=white)](mailto:[email protected])
[![Outlook](https://img.shields.io/badge/Outlook-0078D4?style=for-the-badge&logo=microsoft-outlook&logoColor=white)](mailto:[email protected])
[![Linkedin](https://img.shields.io/badge/LinkedIn-black.svg?style=for-the-badge&logo=linkedin&color=informational)](https://www.linkedin.com/in/edssaac)