Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature/remove_workflow_md #21

Open
wants to merge 9 commits into
base: develop
Choose a base branch
from
Open

Feature/remove_workflow_md #21

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
e8c5bd2
Merge pull request #14 from beerandcodeteam/develop
lamarques Aug 5, 2020
1e41e84
feat: Escrita da estrutura base do README
devatreides Aug 10, 2020
0a45e15
feat[README.md]: Inclusão de links atualizados para a lista de contri…
devatreides Aug 10, 2020
a7a56b6
feat[README.md]: Inclusão de texto de issues em 'Contribuicao'
devatreides Aug 10, 2020
34a3c46
feat[README.md]: Inclusão de texto em portugues para a tabela de comp…
devatreides Aug 10, 2020
d3ae194
Merge pull request #16 from beerandcodeteam/feature/documentacao
lamarques Sep 9, 2020
dc9f5ee
feat[Work-flow.md]: conteudo realocado na wiki do repositorio
devatreides Oct 1, 2020
f586785
feat[README.md]: atualizando lista de versoes a serem suportadas
devatreides Oct 1, 2020
a46ae72
feat: mudando nomenclatura no template de issue
devatreides Oct 1, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions ISSUE_TEMPLATE/feat.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
- **Tipo de implementação**: (refatoração/feature nova)
- **Tipo de implementação**: (refactor/feature)
- **Dependências**:

## Descrição:
Expand All @@ -13,4 +13,4 @@ a o problema a ser resolvido e/ou melhoria a ser feita.
Aqui você irá descrever a sua proposta (caso a tenha) de implementação para o
cenário apresentado acima. Pode ser um texto, uma lista de passos ou mesmo um
*sample* de código. A proposta deve ser clara e atender a todos os requisitos do
cenário apresentado.
cenário apresentado.
359 changes: 42 additions & 317 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,341 +1,66 @@
# payment-gateway 0.0.1

![GitHub top language](https://img.shields.io/github/languages/top/beerandcode-oficial/payment-gateway)
![GitHub Release Date](https://img.shields.io/github/release-date/beerandcode-oficial/payment-gateway)
![GitHub issues](https://img.shields.io/github/issues/beerandcode-oficial/payment-gateway)
![GitHub pull requests](https://img.shields.io/github/issues-pr/beerandcode-oficial/payment-gateway)
![GitHub contributors](https://img.shields.io/github/contributors/beerandcode-oficial/payment-gateway)
![GitHub All Releases](https://img.shields.io/github/downloads/beerandcode-oficial/payment-gateway/total)
![GitHub](https://img.shields.io/github/license/beerandcode-oficial/payment-gateway)
<!-- ![GitHub last commit](https://img.shields.io/github/last-commit/beerandcode-oficial/payment-gateway) -->
![GitHub top language](https://img.shields.io/github/languages/top/beerandcodeteam/paymentgateway)
![GitHub Release Date](https://img.shields.io/github/release-date/beerandcodeteam/paymentgateway)
![GitHub issues](https://img.shields.io/github/issues/beerandcodeteam/paymentgateway)
![GitHub pull requests](https://img.shields.io/github/issues-pr/beerandcodeteam/paymentgateway)
![GitHub contributors](https://img.shields.io/github/contributors/beerandcodeteam/paymentgateway)
![GitHub All Releases](https://img.shields.io/github/downloads/beerandcodeteam/paymentgateway/total)
![GitHub](https://img.shields.io/github/license/beerandcodeteam/paymentgateway)

An open source and free payment gateway for laravel created by Beer And Code Community
| **Laravel** | **paymentgateway** |
|-------------|--------------------|
| 7.x | sem release ativa |
| 8.x | sem release ativa |

Pacote Laravel 100% brasileiro e open-source para integração de gateways de pagamento, focado em agilizar o desenvolvimento.

## DIRETRIZES DE CODIFICAÇÃO PAYMENT GATEWAY
## Instalação

### Referências:
- https://flowframework.readthedocs.io/en/stable/TheDefinitiveGuide/PartV/CodingGuideLines/PHP.html
- https://github.com/PhpGt/StyleGuide
Você pode instalar o pacote via composer¹:

Este guia descreve o estilo de codificação PHP para a colaboração no projeto Payment Gateway da comunidade Beer And Code.
É provável que desenvolvedores e equipes individuais tenham suas próprias visões fortes sobre determinados estilos de codificação, portanto esse conjunto de documentos deve ser visto como um guia, não um livro de regras. Dito isto, tudo o que está documentado aqui é a preferência dos desenvolvedores principais, portanto, considere os pontos antes de enviar solicitações pull requests (PR).
O objetivo deste documento é ajudar a orientar o estilo das contribuições de código para manter um estilo consistente no repositório, definir e justificar as decisões tomadas dentro dele.
```bash
composer require beerandcodeteam/paymentgateway
```
O pacote vai automaticamente registrar um ServiceProvider e Alias.

## VISÃO GERAL
O código de exemplo a seguir mostra uma visão geral do estilo proposto neste guia:
<?php
namespace FastFood\Page;

use FastFood\Logic\OrderLogic;
use FastFood\Menu\MenuFactory;
use Vendor\Food\FoodOrderInterface;

class OrderPage extends OrderLogic implements FoodOrderInterface {
const TYPE_MAIN = "order-type-main";
const TYPE_VEGETARIAN = "order-type-vegetarian";
const TYPE_VEGAN = "order-type-vegan";
const TYPE_GLUTENFREE = "order-type-glutenfree";

private OtherClass $menu;

public function go():void
{
$this->menu = MenuFactory::create($_GET["type"]);
$this->sampleMethod($this->menu->getName(), $this->menu->getSize());
$output = $this->longMethodWithManyArgs(
$this->getDefaultSize(),
123,
"example"
);
}

private function sampleMethod(string $name, int $size = 0):void
{
$maxSize = OtherClass::getMaxSize($name);

if($size === 0) {
$this->menu->fillEmpty(OtherClass::getDefault());
}
elseif($size > $maxSize) {
$size = $maxSize;
}
else {
switch($size) {
case OtherClass::SIZE_INDIVIDUAL:
$this->menu->setStyle("individual");
break;

case OtherClass::SIZE_FAMILY:
$this->menu->setStyle("family");
break;

default:
$this->menu->setStyle(Menu::SIZE_DEFAULT);
break;
}
}
}

public function longMethodWithManyArgs(
int $firstNumber,
int $secondNumber = 0,
string $exampleString = null
):Menu
{
$duplicate = MenuFactory::create($this->menu->getType());

if($duplicate->getSize() !== 0
&& $duplicate->name === $exampleString)
{
return MenuFactory::createDefault();
}

return $duplicate;
}
}
## CONCEITOS DESTE GUIA DE ESTILO
Consulte uma lista com marcadores simplificada abaixo:
Caso queira, você pode publicar o arquivo de configuração do pacote executando:

## CONCEITOS GERAIS
- A primeira linha de todos os arquivos .php deve ser exatamente "<?php"
- Nunca use a tag PHP de fechamento (?>)
- Nunca use tags curtas (short tags) do PHP
- Todos os arquivos devem usar apenas UTF-8, sem BOM
- Sempre use o fuso horário America/Sao_Paulo para armazenar data e hora
- Todo arquivo de biblioteca .php deve conter exatamente uma classe
- Todo arquivo de biblioteca .php deve ser livre de efeitos colaterais
- Em arquivos e códigos, use palavras no singular (por exemplo, item, stylesheet, user) em vez de palavras no plural
- Evite notação húngara, onde nomes de arquivos / variáveis que indicam seu tipo
- Use camelCase para nomear variáveis
- Nunca use variáveis globais
- Propriedades sempre devem ser declaradas
- As variáveis sempre devem ser declaradas no topo do bloco em que são usadas
- Evite usar a palavra-chave final, a menos que seja necessário
- Evite chamar funções no namespace global
- Os códigos de programação, variáveis e funções deverão ser escritos em inglês
```bash
php artisan vendor:publish --tag=paymentgateway-config
```

## INDENTAÇÃO E ESPAÇO EM BRANCO
- Use 4 espaços ao invés de tabulação (PSR-12)
- Evite blocos de código com "dupla indentação" onde nenhuma indentação é necessária para facilitar a leitura
- Não deixe espaços em branco no final das linhas
- Seja o mais rigoroso possível para aplicar 80 linhas de caracteres
¹*pacote ainda sem release disponível no [Packagist](https://packagist.org/)*.

## CHAVES E COLCHETES
- As chaves de abertura DEVE seguir sua própria linha (PSR-12)
- As chaves de fechamento devem sempre ser colocadas no início de sua própria linha (PSR-12)
- Toda condicional if() deve conter chaves de abertura e fechamento, ainda que o corpo possua apenas 1 linha.
- Um nível de indentação deve ser aplicado dentro e somente dentro das chaves
- Os condicionais entre colchetes não devem obter indentação extra ao quebrar em linhas separadas
- Nunca deixe declarações condicionais sem restrições ou sem indentação
## Como usar

## ESPAÇOS
- Nenhum espaço extra deve ser colocado após uma palavra-chave da estrutura de controle ou nome da função
- Os colchetes de abertura não devem ter espaço depois; os colchetes de fechamento não devem ter espaço antes
- Vírgulas que separam listas de variáveis devem ter um espaço ou nova linha depois, sem espaço em branco antes
- Um espaço deve envolver operadores binários e ternários, mas não unários
- Um espaço deve envolver todos os operadores de tipo
``` php
// Em construção
```

## DIRETÓRIOS, ARQUIVOS E NAMESPACES
- Diretórios e arquivos devem ser mapeados para namespace ou web (view)
- Os espaços para nome devem ser mapeados para os caminhos de arquivo, conforme PSR-4
- Arquivos e diretórios devem estar em minúsculas com hífen onde não forem mapeados para namespace
- Os arquivos e diretórios mapeados para namespace devem usar UpperCamelCase
- Arquivos e diretórios mapeados na Web devem usar palavras em minúsculas e hifenizadas
## Testando

## CLASSES
- Uma classe só deve ser carregada automaticamente - nunca use require ou include
- Constantes só devem ser declaradas em uma classe (deve atender somente à classe declarada)
- As constantes devem usar UPPERCASE_UNDERSCORED
- As propriedades devem usar $camelCase
- Os métodos devem usar camelCase()
- As classes devem ter todos ou nenhum membro estático
- Todos os parâmetros devem definir seu tipo sempre que possível
- Todos os métodos devem definir seu tipo de retorno sempre que possível
- Os métodos devem evitar ficar mais de 20-50 linhas
``` bash
composer test
```

## COMENTÁRIOS
- Se possível evite comentários, pois um um bom código não precisa de comentários (se possível leia o livro Código Limpo)
- Para comentários embutidos, devem ser usados comentários com barra dupla (//)
- Comentários embutidos não devem ter indentação, começando na coluna 1
- Comentários embutidos podem abranger várias linhas, prefixadas com a barra dupla
- Os comentários de bloco devem ser usados apenas para fornecer documentação de classe e método na forma de blocos de documentos
- Os comentários, juntamente com os docblocks, devem ser esparsos e pesados para evitar documentação obsoleta
## Changelog

## ESTRUTURA DE DADOS
- As estruturas de dados que representam coleções devem ser acessíveis por array, collections e / ou iterables
- Estruturas de dados que representam itens individuais devem usar funções getter
- Arrays associativos devem ser usadas apenas para pares simples de valor-chave
- Mova arrays associativos para um object com getter / setter sempre que possível
- Classes estáticas devem ser usadas apenas quando verdadeiramente não tiverem estado
Por favor, leia o [CHANGELOG](CHANGELOG.md) para saber sobre as mais recentes alterações.

## PADRONIZAÇÃO EM MENSAGENS DE COMMIT (COMMIT SEM NTICO)
- A princípio vamos trabalhar apenas com feat (feature, novo recurso) e fix (hotfix, correção de problemas)
- O título (primeira linha do commit) deverá estar no imperativo (adiciona) e não adicionado.
- A mensagem do commit deverá ser obrigatoriamente em português, conforme definido por todos em live
- O commit deverá seguir a seguinte estrutura:
## Contribuição

<tipo>[escopo opcional]: <descrição>
<corpo opcional>
<rodapé opcional>
Caso queira reportar algum bug ou propor alguma funcionalidade/alteração para o pacote, por favor, consulte nossa [WIKI](https://github.com/beerandcodeteam/paymentgateway/wiki) para mais detalhes.

Com base nisso, um commit de hotfix ficaria assim:
fix(containers/profile.php): ajusta o argumento da função getPaymentMethods
## Créditos

getPaymentMethods usava o tipo XPTO para receber argumento.
Agora recebe o argumento correto do tipo FOO.
- [Beer and Code](https://github.com/beerandcodeteam)
- [Contributors](https://github.com/beerandcodeteam/paymentgateway/graphs/contributors)

Resolve a issue #132
## Licença

OBS.: o escopo está opcional, pois quando for um novo recurso (feat) pode ser que entre vários arquivos, inviabilizando informar todos no escopo.
Licença MIT. Por favor, consulte o [arquivo de licença](LICENSE.md) para mais informações.

## ATENÇÃO ESPECIAL PARA NOMEAÇÃO DE CLASSES E NAMESPACES
## Laravel Package Boilerplate

### Nomeação incorreta de namespaces e classes

<table class="table">
<thead>
<tr>
<th>
Nome completo da classe
</th>
<th>
Nome não qualificado
</th>
<th>
Observações
</th>
</tr>
</thead>
<tbody>
<tr>
<td>\Neos\Flow\Session\Php </td>
<td>Php</td>
<td>A classe não é uma representação do PHP</td>
</tr>
<tr>
<td>\Neos\Cache\Backend\File </td>
<td>Php</td>
<td>A classe não é uma representação do PHP</td>
</tr>
<tr>
<td>\Neos\Flow\Session\Php </td>
<td>File</td>
<td>A classe não representa um arquivo!</td>
</tr>
<tr>
<td>\Neos\Flow\Session\Interface </td>
<td>Interface</td>
<td>Não permitido, "Interface" é uma palavra-chave reservada</td>
</tr>
<tr>
<td>\Neos\Foo\Controller\Default </td>
<td>Default</td>
<td>Não permitido, "Default" é uma palavra-chave reservada</td>
</tr>
<tr>
<td>\Neos\Flow\Objects\Manager </td>
<td>Manager</td>
<td>Apenas "Manager" é muito confuso</td>
</tr>
</tbody>
</table>

### Nomeação correta de namespaces e classes

<table class="table">
<thead>
<tr>
<th>
Nome completo da classe
</th>
<th>
Nome qualificado
</th>
<th>
Observações
</th>
</tr>
</thead>
<tbody>
<tr>
<td>\Neos\Flow\Session\PhpSession</td>
<td>PhpSession</td>
<td>Essa é uma sessão PHP</td>
</tr>
<tr>
<td>\Neos\Flow\Cache\Backend\FileBackend </td>
<td>FileBackend</td>
<td>Um arquivo de back-end</td>
</tr>
<tr>
<td>\Neos\Flow\Session\SessionInterface </td>
<td>SessionInterface</td>
<td>Um controlador padrão</td>
</tr>
<tr>
<td>\Neos\Foo\Controller\StandardController</td>
<td>StandardController</td>
<td>Não permitido, "Interface" é uma palavra-chave reservada</td>
</tr>
<tr>
<td>\Neos\Flow\Objects\ObjectManager</td>
<td>ObjectManager</td>
<td>"ObjectManager" é mais claro</td>
</tr>
<tr>
<td>\Neos\Flow\Objects\Manager </td>
<td>Manager</td>
<td>Apenas "Manager" é muito confuso</td>
</tr>
</tbody>
</table>

### “Edge cases” na nomeação de namespaces e classes

<table class="table">
<thead>
<tr>
<th>
Nome completo da classe
</th>
<th>
Nome qualificado
</th>
<th>
Observações
</th>
</tr>
</thead>
<tbody>
<tr>
<td>\Neos\Flow\Mvc\ControllerInterface</td>
<td>ControllerInterface</td>
<td>Conseqüentemente, a interface pertence a todos os controladores no sub namespace Controller</td>
</tr>
<tr>
<td>\Neos\Flow\Mvc\Controller\ControllerInterface</td>
<td></td>
<td>Bem melhor!</td>
</tr>
<tr>
<td>\Neos\Cache\AbstractBackend</td>
<td>AbstractBackend</td>
<td>O mesmo aqui: na realidade, essa classe pertence aos back-ends</td>
</tr>
<tr>
<td>\Neos\Cache\Backend\AbstractBackend</td>
<td></td>
<td>Bem melhor!</td>
</tr>
</tbody>
</table>

Observação: Ao especificar nomes de classe para PHP, sempre faça referência ao espaço para nome global dentro do código no espaço de nomes usando uma barra invertida à esquerda. Ao fazer referência a um nome de classe dentro de uma string (por exemplo, dado ao método get do ObjectManager, em expressões pointcut ou em arquivos YAML), nunca use uma barra invertida à esquerda. Isso segue a noção nativa do PHP de nomes em strings sempre sendo vistos como totalmente qualificados.

## DIAS E HORÁRIOS DE REVISÃO
Toda terça-feira, das 20:00h as 21:00h

Canal do discord do Beer And Code (LIVES > payment gateway)

Discord: https://discord.gg/mhyKFgv
Esse pacote foi gerado usando [Laravel Package Boilerplate](https://laravelpackageboilerplate.com).
Loading