# RAV — Registro de Acesso de Veículos

<p align="center">
  <img src="https://img.shields.io/badge/PHP-%3E%3D%207.4-8892BF?style=for-the-badge&logo=php" alt="PHP Version">
  <img src="https://img.shields.io/badge/MySQL-8.0-4479A1?style=for-the-badge&logo=mysql" alt="Database">
  <img src="https://img.shields.io/badge/Bootstrap-5.3-7952B3?style=for-the-badge&logo=bootstrap" alt="Frontend">
  <img src="https://img.shields.io/badge/Status-Pronto%20para%20Uso-success?style=for-the-badge" alt="Status">
</p>

O **RAV** é um sistema completo e dinâmico para **Registro de Acesso de Veículos** em unidades de ensino técnico e tecnológico. O projeto foi projetado para modernizar o controle de entrada e saída na guarita/portaria, proporcionando maior rastreabilidade, rapidez na busca de condutores e veículos cadastrados, além de gerar relatórios consolidados e estatísticas de uso do pátio escolar.

---

##  Principais Recursos

- **Controle em Tempo Real:** Registro simplificado e monitoramento instantâneo de veículos que entram ou saem da unidade, exibindo o status de permanência.
- **Gestão de Condutores:** Cadastro unificado contendo detalhes de curso, período, módulo ou cargo da comunidade escolar.
- **Painel Administrativo:** Permite gerenciar as unidades cadastradas, novos usuários do sistema (administradores ou portaria) e associar veículos a condutores.
- **Relatórios & Gráficos:** Dashboard com geração de estatísticas visuais dinâmicas sobre o tráfego do pátio.
- **Interface Responsiva & Acessibilidade:** Painel totalmente adaptável para dispositivos móveis (smartphones/tablets), com suporte a contraste (Dark/Light mode) e controle de redimensionamento do tamanho da fonte.

---

##  Como Executar o Projeto Localmente

Siga o passo a passo abaixo para configurar o ambiente de desenvolvimento local e deixar o sistema totalmente funcional.

###  Pré-requisitos
Você precisará de uma pilha de servidores locais que suporte PHP e MySQL/MariaDB. As ferramentas recomendadas são:
- [Laragon](https://laragon.org/) (Recomendado para ambiente Windows - já vem pré-configurado)
- [XAMPP](https://www.apachefriends.org/)
- **PHP** (versão 7.4 ou superior, preferencialmente 8.x)
- **MySQL / MariaDB**

---

### 🚀 Passo a Passo de Configuração

#### 1. Mover os Arquivos para a Pasta do Servidor
Copie a pasta completa do projeto `rav-etec` para o diretório público do seu servidor web:
- Se estiver utilizando o **Laragon**: `C:\laragon\www\rav-etec`
- Se estiver utilizando o **XAMPP**: `C:\xampp\htdocs\rav-etec`

#### 2. Iniciar os Serviços de Servidor e Banco de Dados
Abra o painel de controle do seu servidor local (Laragon ou XAMPP) e inicie os módulos do **Apache** e do **MySQL** clicando em **Start** (ou "Iniciar Tudo").

#### 3. Criar e Importar o Banco de Dados (SQL)
O projeto inclui um script SQL pronto para a criação do banco de dados na pasta `sql/`.
1. Acesse a interface do seu gerenciador do banco de dados (geralmente o phpMyAdmin em `http://localhost/phpmyadmin` ou HeidiSQL).
2. Crie uma nova base de dados chamada **`rav`** com codificação de caracteres `utf8mb4_unicode_ci`.
3. Selecione o banco de dados `rav` criado, clique na aba **Importar** (Import) e selecione o arquivo SQL do projeto:
   - Caminho do arquivo: `sql/rav.sql` (localizado dentro do projeto).
4. Clique em **Executar** (Go/Import) para carregar a estrutura das tabelas e os dados padrão necessários para testes.

> [!NOTE]
> O script SQL criará automaticamente todas as tabelas necessárias, os relacionamentos por chave estrangeira, índices de performance e inserirá registros de exemplo, incluindo endereços institucionais e contas pré-configuradas.

#### 4. Configurar a Conexão no PHP
Se o seu ambiente local do MySQL utiliza uma senha de acesso ou porta customizada, você deve ajustar essas credenciais. Abra o arquivo [conn.php](file:///c:/laragon/www/rav-etec/conn.php) no editor e altere os campos abaixo:
```php
$host = "localhost";
$dbname = "rav";
$username = "root"; // Usuário padrão do MySQL
$password = "";     // Coloque a sua senha local (no Laragon o padrão é vazio "")
```

#### 5. Acessar a Aplicação
Com os servidores rodando e o banco de dados carregado, abra o navegador e acesse:
- **No Laragon (URL Dinâmica):** `http://rav-etec.test`
- **Por URL padrão:** `http://localhost/rav-etec/`

---

## Credenciais para Testes

Para navegar por todas as funcionalidades administrativas e operacionais imediatamente, utilize as seguintes credenciais pré-configuradas no banco de dados:

1. **Código da Unidade (Identificador Etec):** `etec123` (solicitado na tela de login)

2. **Perfil Administrativo (Gestão Completa):**
   - **E-mail:** `admin@etec.sp.gov.br`
   - **Senha:** `admin123`
   - *Funcionalidade:* Acesso ao painel gerencial [painel-admin.php](file:///c:/laragon/www/rav-etec/painel-admin.php), permitindo visualizar relatórios avançados, gerenciar usuários, cadastrar condutores, vincular novos veículos e alterar configurações gerais.

3. **Perfil de Portaria (Operação na Guarita):**
   - **E-mail:** `portaria@etec.sp.gov.br`
   - **Senha:** `portaria123`
   - *Funcionalidade:* Acesso à tela operacional de guarita [estacionamento.php](file:///c:/laragon/www/rav-etec/estacionamento.php), otimizada para buscas rápidas, controle e liberação de entrada e saída de veículos.

---

