# Projetos Online

SisProj

Sistema Integrado de Gerenciamento Técnico para Radiodifusão e Telecomunicações
Desenvolvido por Falcão Informática

# Visão Geral

O Projetos Online é um sistema web desenvolvido especialmente para a MG Consultores, empresa do segmento de radiodifusão, telecomunicações e engenharia técnica, voltado ao controle de dados sobre:

Sistemas irradiantes (antenas)
Estações transmissoras
Projetos de instalação ou modificação técnica
Documentação legal e técnica (licenças, portarias, protocolos)
Gestão de empresas, usuários e ativos

É utilizado para centralizar informações corporativas, controlar processos regulatórios (ANATEL, Ministério das Comunicações, etc.) e gerar relatórios técnicos e administrativos com segurança e rastreabilidade.

Principais recursos:

Dashboard administrativo
Cadastro e gestão de usuários e empresas
Gerenciamento de sistemas irradiantes (antenas)
Controle de documentação técnica e legal
Upload seguro de documentos
Consultas avançadas com filtros dinâmicos
Layout moderno e responsivo (Bootstrap 5)
Segurança via sessão Redis e CSRF Tokens
Geração de relatórios em Excel e PDF

# Estrutura do Projeto

O SisProj é organizado da seguinte forma:

#/admin Área administrativa (cadastros, relatórios, etc.)

# /user

Área do usuário comum (consultas, relatórios limitados)

# /includes

Includes PHP reutilizáveis (header, footer, session, csrf, etc.)

# /config

Configurações do sistema, conexão DB, variáveis globais

# /assets

CSS, JS, imagens

# /uploads

Avatares e documentos enviados pelos usuários

# /vendor

Bibliotecas externas (Composer)

# .env

Variáveis de ambiente (DB, Redis, etc.)

O login é obrigatório para qualquer acesso.
Sessões são gerenciadas via Redis.
Usuários podem ser inativados pelo administrador.
O login exibe mensagens elegantes (Bootstrap) que desaparecem após 4 segundos.

# Sessão e Segurança

Todas as páginas utilizam session.php ou session_user.php para iniciar sessão.
As variáveis de sessão são salvas no Redis via funções:

setSession($key, $value); $value = getSession($key);

CSRF é protegido através de tokens:

Layout Padrão Includes obrigatórios Todas as páginas devem incluir:

include_once(BASE_PATH . '/includes/header.php'); include_once(BASE_PATH . '/includes/topnav.php'); include_once(BASE_PATH . '/includes/sidebar.php'); include_once(BASE_PATH . '/includes/footer.php'); include_once(BASE_PATH . '/includes/scripts.php'); header.php → HTML inicial, título, meta tags

topnav.php → barra superior com avatar e menu

sidebar.php → menu lateral

footer.php → rodapé

scripts.php → scripts JS globais (Bootstrap, jQuery, etc.)

# Upload de Arquivos

Estrutura de Upload Pasta raiz:

/projetos/-//

Exemplo de nome do arquivo:

PORTARIA-12345-2025-06-30.pdf Caracteres acentuados são removidos do nome das pastas e arquivos.

O upload exige token CSRF.

Layout de Formulários Baseados em Bootstrap 5.

Layout responsivo.

Feedback visual (alerts, validações).

Campos agrupados em cards.

Exemplo:

Consultas e Relatórios Todas as consultas utilizam filtros dinâmicos.

Exportação para Excel disponível (via PhpSpreadsheet).

Layout de relatórios:

Cabeçalho com título

Tabela responsiva Bootstrap

Rodapé fixo (se aplicável)

Relatórios abertos em popup usam layout simplificado sem includes completos.

Mensagens de Feedback Mensagens de sucesso/erro desaparecem após 4 segundos.

Usamos padrão Bootstrap:

Documento cadastrado com sucesso!

# Regras Específicas

CNPJ salvo com formatação no banco (XX.XXX.XXX/0001-XX)

Datas armazenadas no banco em YYYY-MM-DD

Exibição em telas pode usar DD/MM/YYYY

Campos UF devem ser gravados como siglas (e.g., SP) e não IDs

Layout de formulários segue grid Bootstrap 2 colunas em telas grandes

Uso obrigatório do método getConnection() para conexão DB:

$mysqli = getConnection(); Scripts e Plugins Utilizamos:

Bootstrap 5

jQuery

Select2 (para dropdowns dinâmicos)

PhpSpreadsheet (para geração de Excel)

DomPDF (em relatórios PDF)

# Dicas para Desenvolvedores

✅ Sempre use includes padrão. ✅ Nunca grave dados sensíveis sem token CSRF. ✅ Use htmlspecialchars em qualquer saída de texto. ✅ Faça logs de auditoria em alterações importantes (ex.: perfil do usuário). ✅ Teste uploads com arquivos grandes e acentos no nome. ✅ Centralize dados comuns no .env. ✅ Revise permissões antes de liberar novos menus.

# Atualizações Futuras

Integração via API

# Suporte mobile

Nova tela de dashboards com gráficos

Busca global

Logs de auditoria mais detalhados

# Contato / Suporte

Em caso de dúvidas ou suporte técnico:

📧 Email: [email protected]

🌐 Site: www.falcaoinformatica.com.br