O sistema requer uma instalação do PHP (versão 5) e um banco de dados
PostgreSQL. Esse banco de dados deve ser criado manualmente, e chamar-se
"eleicoes". Se for preciso escolher outro nome, ele deve ser inserido
na linha 2 do arquivo CONEXAO/DBPHP.php.
ATENÇÃO: para evitar problemas de codificação de caracteres,
selecione a codificação LATIN1 para o banco de dados. Não é possível mudar a
codificação depois da criação; ou seja, se ela estiver diferente, será necessário
remover o banco de dados e criá-lo de novo, ou adaptar o arquivo
CONEXAO/DBPHP.php para converter as strings enviadas para o banco.
O sistema precisa dos parâmetros para realizar a conexão ao banco de dados. Esses parâmetros são o nome do usuário do banco de dados, a senha do usuário e o host onde ele se encontra.
Esses parâmetros devem ser colocados no arquivo DBPHP.php, que
se encontra no diretório CONEXAO. A partir da linha 37, são
criadas três variáveis que deverão conter esses parâmetros. Altere essas
linhas para que as três variáveis recebam os valores correspondentes.
A criação da base de dados é feita através da execução de um script.
Para isso, execute o arquivo Scrits.php em seu navegador. Caso
a conexão tenha sido executada corretamente, você verá uma mensagem de
confirmação, e o schema eleicoes terá sido criado,
juntamente com todas as tabelas necessárias para o sistema.
O sistema de Eleições possui um cadastro interno de usuários, com os dados pessoais necessários para seu funcionamento. Esse cadastro deve ser coerente com a base institucional de pessoas, e ele não possui dados de autenticação — ou seja, ele não armazena as senhas de usuários.
A tabela pessoaeleicao armazena, para cada usuário, um
código de identificação. Esse código é específico da instituição,
e será armazenado como uma string alfanumérica de 30 caracteres. No momento
de cadastro ou carregamento de uma pessoa, deve ser informado esse código
de identificação, bem como seus dados pessoais. Nesse momento, o sistema
fará a homologação dos dados da pessoa, para verificar se os dados
informados estão de acordo com os dados da base institucional. Essa operação
é feita também sempre que os dados de uma pessoa forem alterados.
No momento do login, o usuário fornecerá seu código de identificação e sua senha. O sistema então fará a identificação do usuário, para ver se o código fornecido existe no cadastro e se a senha está correta.
Essas duas operações dependem de funções que devem ser implementadas
pelo gerente do sistema, e que dependerão da estrutura da instituição.
Essas funções estão definidas e explicadas no arquivo Funcoes_Pessoa.php,
e devem ser implementadas corretamente para o bom funcionamento
do sistema.
Por default, as funções nunca homologam e autenticam os usuários. Portanto, seu funcionamento deve ser alterado antes que o sistema entre em funcionamento.
O gerente do sistema dispõe de um formulário para cadastro do usuário
inicial, que encontra-se no caminho INICIAL/CadastroUsuarioInicial.php.
Ele deverá informar seus dados pessoais, que serão submetidos
à homologação mencionada no passo acima. Assim que a homologação for bem
sucedida, o usuário será cadastrado, e poderá ser realizado então o login
no módulo de administração, fornecendo o código de identificação e a senha.
Esse script só pode ser executado quando a tabela de pessoas estiver vazia; ou seja, após ele ser utilizado com sucesso, ou após algum dado seja informado manualmente na tabela, ele impedirá o acesso. Mesmo assim, recomenda-se que o arquivo de cadastro seja excluído imediatamente após o seu uso, para que ele não possa ser usado indevidamente por outros usuários.