📰 Portal de Notícias IFMS

Sistema completo de gerenciamento de notícias e usuários desenvolvido com PHP, MySQL e Bootstrap 5. Projeto acadêmico da disciplina de Desenvolvimento Web II.

✨ Funcionalidades

🔓 Acesso Público (Visitantes)

• Visualização de últimas notícias na página inicial
• Leitura completa de notícias individuais
• Busca por título nas notícias
• Navegação paginada pela listagem de notícias
• Interface responsiva e moderna

🔐 Acesso Restrito (Usuários Logados)

• Sistema de autenticação (login/logout)
• CRUD completo de notícias:
  • Criar nova notícia
  • Editar notícias existentes
  • Excluir notícias (com confirmação)
  • Sugestões de categorias existentes via datalist
• CRUD completo de usuários:
  • Cadastrar novo usuário
  • Editar usuários (senha opcional na edição)
  • Excluir usuários (com confirmação)
• Busca e filtros em todas as listagens
• Paginação (10 registros por página)

🛠️ Tecnologias Utilizadas

• Backend: PHP 8.0+
• Banco de Dados: MySQL/MariaDB
• Frontend:
  • HTML5
  • CSS3 (custom + Bootstrap utilities)
  • Bootstrap 5.3.0
  • JavaScript (vanilla)
• Servidor: XAMPP (Apache + MySQL)
• Arquitetura: MVC simplificado com modularização

📋 Requisitos

• PHP 8.0 ou superior
• MySQL 5.7+ ou MariaDB 10.3+
• Apache 2.4+
• Navegador moderno (Chrome, Firefox, Edge, Safari)

🚀 Instalação e Configuração

1. Clonar o Repositório

git clone https://github.com/seu-usuario/seu-repositorio.git
cd seu-repositorio

2. Configurar o Banco de Dados

Crie o banco de dados e as tabelas executando os scripts SQL:

# Acesse o MySQL
mysql -u root -p

# Crie o banco de dados
CREATE DATABASE jornal CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE jornal;

# Execute os scripts de criação das tabelas
source usuarios.sql;
source noticias.sql;

# (Opcional) Popule com dados de exemplo
source noticias_exemplo.sql;

Ou usando o XAMPP:

C:/xampp/mysql/bin/mysql -u root jornal < usuarios.sql
C:/xampp/mysql/bin/mysql -u root jornal < noticias.sql
C:/xampp/mysql/bin/mysql -u root jornal < noticias_exemplo.sql

3. Configurar Conexão com o Banco

Edite o arquivo config.php com suas credenciais:

return [
    'host' => 'localhost',
    'dbname' => 'jornal',
    'username' => 'root',
    'password' => '', // Sua senha do MySQL
];

4. Configurar o Servidor

Se estiver usando XAMPP:

• Copie a pasta do projeto para C:/xampp/htdocs/
• Acesse via navegador: http://localhost/atv02-04/

Se estiver usando servidor PHP embutido:

php -S localhost:8000

5. Primeiro Acesso

Para fazer login, você precisa criar um usuário diretamente no banco de dados:

INSERT INTO usuarios (nome, email, senha) 
VALUES ('Admin', 'admin@example.com', '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi');
-- Senha padrão: password

Ou crie via interface após acessar a página inicial.

📁 Estrutura do Projeto

atv02-04/
├── config.php              # Configurações do banco de dados
├── funcoes.php             # Funções auxiliares (DB, queries)
├── header.php              # Cabeçalho padrão (navbar + session)
├── footer.php              # Rodapé padrão (créditos)
├── index.php               # Página inicial (cards de notícias)
├── login.php               # Tela de login
├── logout.php              # Script de logout
├── verificar_login.php     # Middleware de autenticação
├── usuarios.sql            # Schema da tabela usuarios
├── noticias.sql            # Schema da tabela noticias
├── noticias_exemplo.sql    # Dados de exemplo (12 notícias)
├── css/
│   └── style.css           # Estilos customizados
├── noticias/
│   ├── noticia_visualizar.php    # Visualizar notícia individual
│   ├── noticias_listar.php       # Listagem com busca e paginação
│   ├── noticias_formulario.php   # Formulário criar/editar
│   ├── noticias_excluir.php      # Exclusão de notícia
│   └── salvar.php                # Handler de insert/update
└── usuarios/
    ├── usuarios_listar.php       # Listagem com busca e paginação
    ├── usuarios_formulario.php   # Formulário criar/editar
    ├── usuarios_excluir.php      # Exclusão de usuário
    └── salvar.php                # Handler de insert/update

🎯 Como Usar

Para Visitantes

1. Acesse a página inicial
2. Navegue pelos cards de notícias
3. Clique em "Ler Mais" para visualizar notícia completa
4. Use "Ver Todas as Notícias" para acessar a listagem completa
5. Use o campo de busca para filtrar por título

Para Usuários Logados

1. Clique em "Entrar" no menu superior
2. Faça login com suas credenciais
3. Acesse "Notícias" → "Cadastrar Nova" para criar notícias
4. Na listagem, clique no título para visualizar ou use os botões "Editar"/"Excluir"
5. Acesse "Usuários" para gerenciar usuários do sistema

🔒 Segurança Implementada

• ✅ Senhas com hash bcrypt (password_hash)
• ✅ Prepared statements (proteção contra SQL Injection)
• ✅ Sanitização de saídas com htmlspecialchars() (proteção XSS)
• ✅ Validação de sessão em rotas protegidas
• ✅ Confirmação em ações destrutivas (exclusão)
• ✅ PDO com tratamento de exceções

🎨 Recursos de Interface

• Design responsivo (mobile-first)
• Tabelas estilizadas com hover e zebra striping
• Cards com hover elevation
• Paginação Bootstrap
• Breadcrumb de navegação
• Alertas contextuais
• Formulários com validação HTML5
• Datalist para sugestões de categorias
• Menu dropdown com informações do usuário logado

📝 Padrões de Código

• Modularização de código (header, footer, funcoes)
• Fetch com PDO::FETCH_OBJ para consistência
• Formulários unificados (create/update)
• Nomenclatura descritiva de variáveis e funções
• Comentários inline em português
• Separação de concerns (apresentação, lógica, dados)

👨‍💻 Desenvolvimento

Desenvolvido por: Talita Mendonça Marques
Curso: Licenciatura em Computação - 6º período
Instituição: IFMS (Instituto Federal de Mato Grosso do Sul)
Disciplina: Desenvolvimento Web II
Professor: Aurelio Vargas Ramos Junior
Ano: 2025

🧑‍💻 Autora

Nome	GitHub	LinkedIn	Instagram
Talita Mendonça Marques

📄 Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.

🤝 Contribuições

Este é um projeto acadêmico, mas sugestões e melhorias são bem-vindas via issues ou pull requests.

---

⭐ Se este projeto foi útil para você, considere deixar uma estrela no repositório!