douglascarlos-dev / clientes-gestor

Software Web para cadastro de clientes com URL amigável usando PHP Orientado a Objetos, MVC, banco de dados Postgresql com PDO, CAPTCHA, PDF, API de CEP e upload de imagem

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.

clientes-gestor's Issues

Formulário endereço

Adicionar formulário de endereço.

hCaptcha

Adicionar hcaptcha na página de login.

Data de criação e alteração

Adicionar no cadastro do cliente a data de criação e alteração de um cadastro

Busca

Em situações com muitos cadastros uma busca pode levar tempo.
Adicionar um mecanismo de busca de forma a se localizar um cadastro mais rapidamente.

API REST para LANDING PAGES

Criar uma API REST para captura de dados de landing pages.

• Campos adicionais podem não estar disponíveis no momento mas devem ser previstas a sua adição.
• Um desafio de segurança pode ser requerido de forma adicional para proteção.
• Mecanismos para validar o e-mail e o telefone são fundamentais.
• A página de validação pode entregar um arquivo de recompensa.

Relatório de cadastro.

Um relatório bem formatado para exportar um cadastro faz se necessário caso requerido a impressão do cadastro.

Foto

Adicionar foto ao cadastro do cliente.

CEP Correios

Criar uma funcionalidade que preenche automaticamente o Estado e a Cidade ao informa o CEP.

BANCO DE DADOS

ALGUÉM TERIA O BANCO DE DADOS EM ARQUIVO .SQL?

Página de login

Criar uma página de login para acesso ao software.

Compromissos

Criar uma funcionalidade de controle de compromissos.
Ela deve pode ser usada com diversos tipos de compromissos a fim de se adequar com a necessidade do usuário do sistema.

Alguns compromissos que deve ser possível cadastrar:

• Consulta;
• Exame;
• Mensalidade;
• Parcela;
• Visita;

Possíveis campos:

• Título;
• Descrição;
• Data;
• Documento relacionado;
• Valor;
• Tag de status(Ex: Pago, Agendado, Entrar em Contato, Confirmado...)