Software Crud Datagrid - Php Mysql

Descrição

Manual do Portal DataGrid

Sumário

1. Introdução ao Portal DataGrid
2. Instalação e Configuração Inicial
3. Interface Principal
4. Área Administrativa
5. Uso do DataGrid
6. Formulários de Entrada de Dados
7. Configurações Avançadas
8. Internacionalização
9. Solução de Problemas Comuns
10. Apêndices

1. Introdução ao Portal DataGrid

O Portal DataGrid é uma aplicação web flexível e poderosa para visualização, gerenciamento e manipulação de dados de banco de dados. Desenvolvido em PHP, oferece uma interface intuitiva e recursos avançados para trabalhar com dados de forma eficiente.

Recursos Principais

Visualização de Dados: Grade interativa com paginação e ordenação
Filtragem Avançada: Múltiplos critérios de filtro
Exportação: Suporte para PDF, Excel, Word, JSON, XML e HTML
Relações Mestre-Detalhe: Visualização de dados relacionados
Formulários Dinâmicos: Entrada e edição de dados
Personalização: Temas customizáveis e formatação flexível
Internacionalização: Suporte a múltiplos idiomas

Requisitos do Sistema

Componente | Versão Mínima
Servidor Web | Apache/Nginx
PHP | 8.1.28 ou superior
MySQL/MariaDB | 10.6.21 ou superior
Navegador | Chrome 90+, Firefox 88+, Edge 90+, Safari 14+

Arquitetura da Aplicação

O Portal DataGrid é dividido em duas áreas principais:

1. Área Pública: Interface de visualização de dados para usuários finais
2. Área Administrativa: Interface de configuração e gerenciamento

2. Instalação e Configuração Inicial

Processo de Instalação

1. Download: Obtenha o pacote de instalação do Portal DataGrid
2. Extração: Extraia os arquivos no diretório do servidor web
3. Configuração: Acesse a URL da aplicação e siga o assistente de instalação
4. Banco de Dados: Configure a conexão com o banco de dados

Configuração da Conexão com o Banco de Dados

Para configurar a conexão com o banco de dados:

1. Acesse a área administrativa
2. Navegue para "Configuração de Banco de Dados"
3. Preencha os campos obrigatórios:
- Servidor: Endereço do servidor MySQL/MariaDB
- Nome do Banco: Nome da base de dados
- Usuário: Nome de usuário para conexão
- Senha: Senha do usuário
- Porta: Porta de conexão (padrão: 3306)
4. Selecione as versões do PHP e MySQL/MariaDB
5. Clique em "Testar Conexão" para validar
6. Clique em "Salvar" para confirmar as configurações

Configuração Inicial Básica

Após a instalação, execute as seguintes configurações:

Tabelas: Defina quais tabelas serão visualizadas
Campos: Configure quais campos de cada tabela serão exibidos
Aparência: Personalize o tema e layout da aplicação

3. Interface Principal

A interface principal é onde os usuários visualizam e interagem com os dados configurados.

Página Inicial

A página inicial apresenta:

Lista das tabelas disponíveis para visualização
Menu de navegação principal
Seletor de idiomas (se habilitado)
Links para funcionalidades principais

Visualização do DataGrid

O DataGrid oferece uma interface rica para visualização de dados:

Componentes Principais

Cabeçalho
Título da tabela/visualização
Botões de ação (Filtrar, Exportar, Formulário)
Informações de contexto

Grade de Dados
Cabeçalhos de coluna com ordenação
Linhas de dados com formatação
Indicadores visuais (cores, ícones)

Rodapé
Controles de paginação
Informações de registros
Seletor de registros por página

Elementos de Navegação

Barra de Navegação Superior
Logo: Identidade visual da aplicação
Menu Principal: Acesso às principais funcionalidades
Área Administrativa: Link para configurações (se habilitado)
Seletor de Idiomas: Alternância entre idiomas disponíveis

Área de Filtros
Interface para filtragem de dados:
Campo: Seleção do campo para filtro
Operador: Tipo de comparação (igual, contém, maior que, etc.)
Valor: Valor de referência para o filtro
Ações: Aplicar, limpar ou modificar filtros

Controles de Exportação
Botões para exportação de dados:
PDF: Exportação para documento PDF
Excel: Exportação para planilha Excel
Word: Exportação para documento Word
JSON: Exportação em formato JSON
XML: Exportação em formato XML
HTML: Exportação em formato HTML

4. Área Administrativa

A área administrativa é o centro de controle do Portal DataGrid, acessível através do atalho Ctrl+Shift+exemplo ou via link na barra de navegação.

Visão Geral

A área administrativa é organizada em seções específicas:

Menu Lateral Configurável
Configurações de Tabelas: Gerenciamento de tabelas e campos
Configurações de Aparência: Personalização visual
Configurações de Sistema: Configurações gerais
Ferramentas: Utilitários e manutenção

Configuração de Tabelas

Seleção de Tabelas
Defina quais tabelas do banco de dados estarão disponíveis:

1. Acesse "Configuração de Tabelas"
2. Marque as tabelas desejadas
3. Configure permissões de acesso
4. Salve as alterações

Configuração de Campos
Personalize a exibição de campos:

1. Selecione a tabela desejada
2. Marque os campos para exibição
3. Configure nomes personalizados
4. Defina a ordem de exibição
5. Salve as configurações

Configuração de Ordenação
Estabeleça a ordenação padrão:

Campo: Selecione o campo para ordenação
Direção: Ascendente ou Descendente
Ordenação Secundária: Critérios adicionais de ordenação

Configuração de Alinhamento
Defina o alinhamento de cada campo:

Esquerda: Para textos e identificadores
Centro: Para códigos e status
Direita: Para valores numéricos e datas

Configuração de Largura
Especifique a largura de cada campo em pixels:

Largura Fixa: Valor específico em pixels
Largura Automática: Ajuste automático ao conteúdo
Largura Percentual: Baseada na largura total disponível

Configuração de Formatação

Formatação de Datas
Configure a exibição de campos de data:

Formato de Data: dd/mm/yyyy, mm/dd/yyyy, yyyy-mm-dd
Formato de Hora: 24h (HH:MM:SS) ou 12h (HH:MM AM/PM)
Separadores: Escolha entre diferentes separadores

Formatação de Números
Personalize a exibição de valores numéricos:

Separador Decimal: Ponto (.) ou vírgula (,)
Separador de Milhares: Ponto, vírgula ou espaço
Casas Decimais: Número de dígitos após o separador decimal
Prefixo Monetário: R$, $, €, etc.

Configuração de Relações Mestre-Detalhe

Estabeleça relações entre tabelas:

1. Tabela Mestre: Selecione a tabela principal
2. Tabela Detalhe: Selecione a tabela relacionada
3. Campo de Ligação: Configure os campos que estabelecem a relação
4. Campos de Exibição: Selecione quais campos da tabela detalhe serão exibidos
5. Ordenação: Defina a ordenação dos registros relacionados

Configuração de Formulários

Crie formulários para entrada de dados:

Configuração Básica
Campos: Selecione os campos para o formulário
Validações: Configure regras de validação
Máscaras: Aplique máscaras de entrada (CPF, telefone, etc.)
Valores Padrão: Defina valores iniciais para campos

Configuração Avançada
Campos Obrigatórios: Marque campos que devem ser preenchidos
Campos Somente Leitura: Campos que não podem ser editados
Campos Calculados: Campos com valores calculados automaticamente
Validação Personalizada: Regras de validação específicas

Configuração de Temas

Personalize a aparência do Portal DataGrid:

Temas Predefinidos
Tema Claro: Interface com cores claras
Tema Escuro: Interface com cores escuras
Tema Azul: Interface com tons de azul
Tema Verde: Interface com tons de verde

Personalização Avançada
Cores do Cabeçalho: Personalize cores do cabeçalho
Cores do Rodapé: Configure cores do rodapé
Cores das Linhas: Defina cores para linhas alternadas
Fontes: Configure família, tamanho e peso das fontes
Espaçamento: Ajuste margens e espaçamentos

Configuração de Idiomas

Configure o suporte multilíngue:

1. Idioma Padrão: Selecione o idioma principal
2. Idiomas Disponíveis: Marque os idiomas que estarão disponíveis
3. Posição do Seletor: Cabeçalho ou rodapé
4. Estilo do Seletor: Dropdown, bandeiras ou texto

Exportação e Importação de Configurações

Gerencie configurações da aplicação:

Exportação
Configurações Completas: Todas as configurações da aplicação
Configurações Específicas: Apenas configurações selecionadas
Formato: Arquivo JSON com todas as configurações

Importação
Arquivo de Configuração: Selecione o arquivo de configurações
Modo de Importação: Sobrescrever ou mesclar configurações
Validação: Verificação de compatibilidade antes da importação

5. Uso do DataGrid

Navegação e Paginação

O DataGrid oferece controles intuitivos para navegação:

Controles de Paginação
Botões de Navegação: Primeira página, anterior, próxima, última página
Numeração: Clique diretamente em números de página
Registros por Página: Selecione quantos registros exibir
Informações de Contexto: "Mostrando X a Y de Z registros"

Navegação por Teclado
Setas: Navegação entre registros
Page Up/Down: Navegação por páginas
Home/End: Primeiro/último registro da página

Filtragem de Dados

Sistema avançado de filtros:

Filtros Simples
1. Clique em "Filtrar Dados"
2. Selecione o campo desejado
3. Escolha o operador de comparação
4. Digite o valor de referência
5. Clique em "Aplicar"

Operadores Disponíveis
Igual a: Correspondência exata
Contém: Busca por substring
Começa com: Início do valor
Termina com: Final do valor
Maior que: Comparação numérica/data
Menor que: Comparação numérica/data
Entre: Faixa de valores
Está vazio: Campos nulos ou vazios

Filtros Múltiplos
Combinação AND: Todos os filtros devem ser atendidos
Combinação OR: Pelo menos um filtro deve ser atendido
Agrupamento: Agrupar filtros com parênteses

Exportação de Dados

Exporte dados em diversos formatos:

Formatos Suportados
PDF: Documento formatado para impressão
Excel: Planilha editável (.xlsx)
Word: Documento de texto (.docx)
JSON: Formato de dados estruturados
XML: Markup language estruturado
HTML: Página web formatada

Opções de Exportação
Dados Filtrados: Apenas registros que atendem aos filtros
Todos os Dados: Todos os registros da tabela
Campos Selecionados: Apenas campos específicos
Formatação: Manter ou remover formatação

Visualização de Detalhes

Examine registros em detalhes:

1. Clique no botão "Detalhes" na linha do registro
2. Visualize todos os campos configurados
3. Veja dados relacionados (relações mestre-detalhe)
4. Acesse ações específicas do registro

6. Formulários de Entrada de Dados

Os formulários permitem inserir, editar e excluir dados nas tabelas configuradas.

Acessando Formulários

Para trabalhar com formulários:

1. Selecione a tabela desejada na página inicial
2. Clique no botão "Formulário" (se configurado)
3. Escolha a ação desejada (Novo, Editar, Excluir)

Inserindo Dados

Processo de inserção de novos registros:

1. Acessar Formulário: Clique em "Novo Registro"
2. Preencher Campos: Complete todos os campos obrigatórios
3. Validação: O sistema valida os dados automaticamente
4. Salvar: Clique em "Salvar" para confirmar a inserção

Recursos de Entrada
Máscaras de Entrada: Formatação automática para CPF, telefone, etc.
Calendários: Seleção visual de datas
Listas Suspensas: Seleção de valores predefinidos
Validação em Tempo Real: Verificação imediata de dados

Editando Dados

Modificação de registros existentes:

1. Localizar Registro: Use busca ou navegação para encontrar o registro
2. Acessar Edição: Clique no botão "Editar"
3. Modificar Campos: Altere os valores desejados
4. Salvar Alterações: Confirme as modificações

Controles de Edição
Campos Protegidos: Alguns campos podem ser somente leitura
Histórico de Alterações: Rastreamento de modificações
Validação de Integridade: Verificação de regras de negócio

Excluindo Dados

Remoção de registros:

1. Selecionar Registro: Localize o registro a ser excluído
2. Confirmar Exclusão: Clique em "Excluir" e confirme a ação
3. Verificação de Integridade: O sistema verifica dependências
4. Exclusão Definitiva: O registro é removido permanentemente

Proteções de Exclusão
Confirmação Dupla: Duas confirmações necessárias
Verificação de Dependências: Impedimento de exclusão com dados relacionados
Log de Exclusões: Registro de todas as exclusões realizadas

7. Configurações Avançadas

Consultas SQL Personalizadas

Crie visualizações personalizadas usando SQL:

Criação de Consultas
1. Acesse "Configuração de Consultas"
2. Clique em "Nova Consulta"
3. Defina um nome descritivo
4. Digite a consulta SQL
5. Teste a consulta para verificar sintaxe
6. Configure campos de exibição
7. Salve a consulta

Recursos Avançados
Parâmetros Dinâmicos: Use variáveis na consulta
Joins Complexos: Relacione múltiplas tabelas
Funções Agregadas: SUM, COUNT, AVG, etc.
Subconsultas: Consultas aninhadas para dados complexos

Configuração de Cabeçalho e Rodapé

Personalize a identidade visual:

Configuração do Cabeçalho
Título Principal: Nome da aplicação ou sistema
Subtítulo: Descrição adicional ou departamento
Logo: Imagem corporativa
Cores: Esquema de cores personalizado

Configuração do Rodapé
Informações de Copyright: Direitos autorais
Links Úteis: Links para documentação ou suporte
Informações de Versão: Versão da aplicação
Contato: Informações de contato

Configuração da Barra Lateral

Personalize o menu de navegação:

Organização do Menu
Seções Personalizadas: Agrupe itens por categoria
Ordem dos Itens: Arraste e solte para reorganizar
Ícones: Adicione ícones aos itens do menu
Permissões: Configure quem pode ver cada item

Títulos e Descrições
Títulos de Seção: Nomes das categorias do menu
Descrições: Textos explicativos para cada item
Tooltips: Dicas de ajuda para usuários

8. Internacionalização

O Portal DataGrid oferece suporte completo a múltiplos idiomas.

Idiomas Disponíveis

Por padrão, o sistema inclui:
Português (Brasil): pt-BR
Inglês (Estados Unidos): en-US
Espanhol (Espanha): es-ES

Alterando o Idioma

Para alterar o idioma da interface:

1. Localizar Seletor: Encontre o seletor de idiomas (cabeçalho ou rodapé)
2. Selecionar Idioma: Clique no idioma desejado
3. Atualização Automática: A interface é atualizada imediatamente
4. Persistência: A escolha é salva para sessões futuras

Configuração de Idiomas

Personalização do suporte multilíngue:

Configurações Básicas
Idioma Padrão: Idioma inicial da aplicação
Idiomas Ativos: Quais idiomas estarão disponíveis
Detecção Automática: Usar idioma do navegador como padrão

Configurações Visuais
Posição do Seletor: Cabeçalho, rodapé ou menu lateral
Estilo de Exibição:
Dropdown com nomes dos idiomas
Bandeiras dos países
Códigos de idioma (pt, en, es)
Combinação de bandeiras e nomes

Configurações Avançadas
Formatação Regional: Datas, números e moedas por região
Direção do Texto: Suporte a idiomas da direita para esquerda
Fallback: Idioma de fallback para traduções não encontradas

9. Solução de Problemas Comuns

Problemas de Conexão com o Banco de Dados

Quando enfrentar problemas de conexão:

Verificações Iniciais
Dados de Conexão: Confirme servidor, usuário, senha e nome do banco
Status do Servidor: Verifique se o MySQL/MariaDB está rodando
Permissões: Confirme se o usuário tem acesso ao banco
Firewall: Verifique se a porta está liberada

Diagnóstico Avançado
Logs de Erro: Examine os logs para mensagens específicas
Teste de Conexão: Use ferramentas externas para testar a conexão
Versão de Compatibilidade: Verifique compatibilidade entre versões
Configuração do PHP: Confirme extensões MySQL habilitadas

Problemas de Exibição de Dados

Para problemas de visualização:

Verificações de Configuração
Tabelas Habilitadas: Confirme se a tabela está ativa
Campos Configurados: Verifique se os campos estão habilitados
Filtros Aplicados: Remova filtros que possam estar limitando resultados
Permissões de Acesso: Confirme permissões de leitura na tabela

Problemas de Formatação
Encoding de Caracteres: Verifique UTF-8 no banco e aplicação
Tipos de Dados: Confirme se os tipos de dados estão corretos
Formatação de Campos: Verifique configurações de formatação
Consultas Personalizadas: Valide sintaxe SQL das consultas

Problemas com Formulários

Soluções para problemas em formulários:

Problemas de Estrutura
Chave Primária: Confirme se a tabela tem chave primária definida
Campos Obrigatórios: Verifique se todos os campos obrigatórios estão preenchidos
Tipos de Dados: Confirme compatibilidade entre formulário e banco
Relacionamentos: Verifique integridade referencial

Problemas de Validação
Regras de Validação: Revise regras configuradas
Máscaras de Entrada: Verifique se as máscaras estão corretas
Valores Padrão: Confirme se valores padrão são válidos
javascript. Verifique se há erros de JavaScript no navegador

Problemas com Exportação

Solucionando problemas de exportação:

Verificações de Sistema
Formatos Habilitados: Confirme se o formato está disponível
Permissões de Arquivo: Verifique permissões de escrita no diretório temporário
Extensões PHP: Confirme se extensões necessárias estão instaladas
Limite de Memória: Verifique se há memória suficiente para exportações grandes

Problemas Específicos por Formato
PDF: Verifique biblioteca de PDF instalada
Excel: Confirme extensão php-zip habilitada
XML: Verifique extensão php-xml instalada
Grandes Volumes: Considere exportação em lotes para grandes quantidades de dados

10. Apêndices

Atalhos de Teclado

Principais atalhos para agilizar o trabalho:

Atalho | Função
Ctrl+Shift+exemplo | Acessar área administrativa
Ctrl+F | Focar no campo de busca
Esc | Fechar diálogos ou painéis abertos
Enter | Confirmar ação ou aplicar filtro
Tab | Navegar entre campos
Shift+Tab | Navegação reversa entre campos
Ctrl+S | Salvar formulário (quando aplicável)
Ctrl+N | Novo registro (quando aplicável)

Requisitos de Sistema Detalhados

Servidor
PHP
Versões suportadas: 8.1.28 - 8.2.12
Extensões obrigatórias: mysqli, pdo, pdo_mysql, json, xml, mbstring, gd
Extensões recomendadas: zip, curl, openssl

Banco de Dados
MySQL: 8.0.25 - 8.0.35
MariaDB: 10.6.21 - 10.9.8
Engines suportadas: InnoDB, MyISAM

Servidor Web
Apache 2.4+ com mod_rewrite
Nginx 1.18+ com PHP-FPM
IIS 10+ com PHP configurado

Cliente
Navegadores Suportados
Google Chrome 90+
Mozilla Firefox 88+
Microsoft Edge 90+
Safari 14+
Opera 76+

Resolução Mínima
Desktop: 1024x768
Tablet: 768x1024
Mobile: 375x667

Referência de Funções de Formatação

Formatação de Data
Formatos Disponíveis:
- dd/mm/yyyy (31/12/2023)
- mm/dd/yyyy (12/31/2023)
- yyyy-mm-dd (2023-12-31)
- dd-mm-yyyy (31-12-2023)
- yyyy/mm/dd (2023/12/31)

Separadores Suportados: / - . (espaço)

Formatação de Hora
Formatos Disponíveis:
- HH:MM:SS (23:59:59)
- HH:MM (23:59)
- HH:MM AM/PM (11:59 PM)
- HH:MM:SS AM/PM (11:59:59 PM)

Formatação de Número
Configurações:
- Separador Decimal: . ou ,
- Separador de Milhares: . , ou (espaço)
- Casas Decimais: 0-8
- Notação Científica: Suportada

Formatação Monetária
Prefixos Suportados:
- R$ (Real Brasileiro)
- $ (Dólar)
- € (Euro)
- £ (Libra)
- ¥ (Iene)
- Personalizado

Garantia do vendedor: 6 meses