{"id":18450120,"url":"https://github.com/mathleite/currency-php-test","last_synced_at":"2025-04-18T00:24:04.753Z","repository":{"id":59720010,"uuid":"538753655","full_name":"mathleite/currency-php-test","owner":"mathleite","description":null,"archived":false,"fork":false,"pushed_at":"2022-09-20T00:57:18.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T23:03:44.068Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mathleite.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-09-20T00:55:42.000Z","updated_at":"2022-09-20T00:57:23.000Z","dependencies_parsed_at":"2022-09-20T21:46:45.231Z","dependency_job_id":null,"html_url":"https://github.com/mathleite/currency-php-test","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fcurrency-php-test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fcurrency-php-test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fcurrency-php-test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathleite%2Fcurrency-php-test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mathleite","download_url":"https://codeload.github.com/mathleite/currency-php-test/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249167448,"owners_count":21223506,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T07:23:30.563Z","updated_at":"2025-04-16T23:54:08.972Z","avatar_url":"https://github.com/mathleite.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Paliari Engenharia de Software - Avaliação para programador PHP\nEste projeto é uma classe simples para avaliar programadores PHP. A classe Troco no arquivo Troco.php, possui apenas um método, getQtdeNotas, que retorna a um array contendo a quantidade de notas necessárias de cada cédula, para completar o valor em reais passado no parâmetro.\n\nLeia as informações à seguir com atenção, nelas serão dadas todas as instruções para seguir com o teste.\n\n## Importante\n- Não faça forks ou pull requests nesse repositório, faça um clone para a sua máquina e em seguida crie um repositório no seu GitHub.\n\n## Submeter a avaliação\nApós finalizar o teste, envie o link para o seu repositório e seus dados de contato para o e-mail `rh@paliari.com.br` para que ele seja avaliado, em seguida aguarde nosso contato.\n___\n\n### Caso de uso:\nUm cliente pediu uma funcionalidade para seu sistema de troco.\n\nEssa funcionalidade permite que se entre com um valor no sistema e retorne a quantidade de notas e moedas necessária para que se chegue nesse valor.\n\nPor exemplo:\n\nInformei ao sistema que precisso retornar R$ 50,15 de troco, o sistema deve me retornar o mínimo de notas e moedas necessário para chegar nesse valor, ou seja uma nota de R$50,00, uma moeda de R$ 0,10 e uma moeda de R$ 0,05.\n\nO sistema deve garantir o funcionamento dessa funcionalidade com um teste unitário para cada função adicionada.\n\n### Explicação técnica:\nA estrutura desse projeto segue os padrões de desenvolvimento disponíveis em https://www.php-fig.org/psr.\n\nO código deve funcionar com o **PHP 7**.\n\nDentro da pasta `app/` devem estar todos os arquivos necessários para o funcionamento do código.\n\nA funçao `getQtdeNotas(float $reais)` que está na classe `Troco` deve retornar a quantidade de notas e moedas em formato de `array` de chave e valor;\n\nExemplo:\n```php\n\u003c?php\n\n[\n    \"100\" =\u003e 2,\n    \"50\" =\u003e 0,\n    \"20\" =\u003e 1,\n    \"10\" =\u003e 0,\n    \"5\" =\u003e 1,\n    \"2\" =\u003e 0,\n    \"1\" =\u003e 0,\n    \"0.5\" =\u003e 1,\n    \"0.25\" =\u003e 0,\n    \"0.1\" =\u003e 0,\n    \"0.05\" =\u003e 0,\n    \"0.01\" =\u003e 0,\n]; \n// 225.50\n```\n\nOs testes devem cobrir as funções necessárias para o funcionamento correto.\n\n### Sobre os testes:\nSerá um diferencial a escrita de testes para cobrir as funções.\n\nA ferramenta utilizada é o `PHPUnit`, e a documentação está disponível nesse link: https://phpunit.readthedocs.io/pt_BR/latest/\n\nOs testes devem ser criados no namespace `Tests`, dentro da pasta `tests/`\n\n### Sobre a avaliação\nDentre os critérios de avaliação estão: qualidade do código escrito(clareza, manutenibilidade, organização), lógica utilizada para resolver o problema, testes.\n\nDentre o valor total de 10.0 da nota será distribuída da seguinte maneira:\n\n | Critério               | Valor         |\n | ---------------------- | ------------- |\n | Resolução do problema  | 4.0           |\n | Lógica                 | 2.0           |\n | Testes                 | 2.0           |\n | Qualidade do código    | 2.0           |\n \n ___\n \n ### Instruções para execução do exame\n #### Clonagem e instalação das dependências\n - Faça um clone do projeto para a sua máquina, e mande na sua conta do GitHub.\n - Para instalar as dependências execute o comando ```composer install```\n \n #### Desenvolvimento\n - Dentro da pasta `app/` existe uma classe chamada `Troco`, nela existe um método incompleto chamado `getQtdeNotas` e ele deve retornar a quantidade de notas.\n - Sinta-se a vontade para implementar a solução da maneira que quiser, mas lembre que esse método deve retornar um array de chave e valor com as quantidades de notas no modelo informado.\n - Na pasta `console/` existe o arquivo `troco.php` e você pode usá-lo para testar no seu console o retorno do método executando `php console/troco.php [valor]`(substitua [valor] pelo valor em reais. Ex: `php console/troco.php 10`)\n \n #### Testes\n - Os testes devem ser criados utilizando a ferramenta `PHPUnit` e colocados na pasta `tests/` no namespace `Tests` como a classe `TrocoTest`, você pode utilizar essa própria classe para testar.\n - A classe `TrocoTest` possui um teste de exemplo, que deverá ser atualizado ao final da prova.\n \n #### Lista de comandos\n - Para instalar as dependências navegue até a pasta do projeto e execute `composer install`\n - Para executar o arquivo pelo console navegue até a pasta do projto e execute `php console/troco.php [valor]`\n - Para executar os testes unitários navegue até a pasta do projeto e execute `./vendor/bin/phpunit`\n\n### Considerações\nOs candidatos com melhores avaliações receberão nosso contato marcando uma entrevista onde conheceremos melhor seu perfil.\n\nEntão vamos la: **Let's Coding**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathleite%2Fcurrency-php-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmathleite%2Fcurrency-php-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathleite%2Fcurrency-php-test/lists"}