Clientes Gestor

Esse projeto faz parte dos meus estudos sobre programação e teste de software.

Software Web para cadastro de clientes. No seu desenvolvimento foi utlizado URL amigável usando PHP Orientado a Objetos, MVC, banco de dados Postgresql com PDO, CAPTCHA, PDF, API de CEP/Endereço e upload de imagem.

Recursos usados no desenvolvimento:

• PHP 8.1.2;
• PostgreSQL 14.5;
• pgModeler 0.9.4;
• HTML;
• Bootstrap v4.6.0;
• jQuery v.3.5.1;
• Apache HTTP Server;
• DBeaver Community Edition;
• Git;
• Visual Studio Code;
• MVC;
• PlantUML;
• hCaptcha;
• Dompdf 2.0.0;
• GD;
• CEP Aberto API V3;

Instalação:

Para começar, você deve simplesmente clonar o repositório do projeto na sua máquina, instalar os pre-requisitos, criar o banco de dados e configurar o arquivo database.php.

Pre-requisitos:

Antes de instalar o projeto, você precisa já ter instalado na sua máquina:

• Apache;
• Ativar o módulo mod_rewrite do Apache;
• PHP;
• Ativar o módulo pgsql do PHP;
• Ativar a extensão GD do PHP;
• Ativar a extensão cURL do PHP;
• Ativar a extensão mbstring do PHP;
• Ativar a extensão SimpleXML do PHP;
• PostgreSQL;

PostgreSQL é um sistema de banco de dados relacional poderoso e testado pelo tempo sendo uma importante opção de código aberto livre para uso comercial sem custos.

Obtendo uma cópia:

# Antes de tudo, clone o projeto
$ git clone https://github.com/douglascarlos-dev/Clientes-Gestor

Configuração:

# Entre na pasta 'model' do projeto e crie um arquivo database.php
# com os dados de conexão do banco de dados PostgreSQL.
<?php
return [
    "host" => "localhost",
    "port" => "5432",
    "dbname" => "",
    "user" => "",
    "password" => "",
    "captcha_secret" => "0x0",
    "captcha_data-sitekey" => "",
    "cepaberto" => ""
];
?>

# Informe o nome da pasta em que o projeto está executando no arquivo index.php
# Exemplo:
define('ENDERECO', '/php-pdo-oop-clean-urls-postgresql'); // ou
define('ENDERECO', '/' . basename(__DIR__)); // ou
define('ENDERECO', '/douglas/' . basename(__DIR__)); // ou
define('ENDERECO', ''); //se executar no dirtorio root.

# Usuário e senha padrão do software: admin

Modelagem do banco

A pasta pgmodeler contem a modelagem do banco usando o programa pgModeler 0.9.4, bem como uma imagem da modelagem e o arquivo sql de criação do banco. É necessario estar instalado o módulo pgsql para php para uma correta comunicação.

Diagrama de classes

A pasta modelagem contem os diagramas de UML criados usando o programa PlantUML, permitindo identificar as classes, métodos, atores e interações utilizadas na execução do software.