{"id":31043229,"url":"https://github.com/dfop02/tech-interview-backend","last_synced_at":"2025-09-14T13:54:16.041Z","repository":{"id":312167671,"uuid":"1046413102","full_name":"dfop02/tech-interview-backend","owner":"dfop02","description":"Code challenge for an interview","archived":false,"fork":false,"pushed_at":"2025-08-28T22:56:40.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-29T03:54:22.397Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/dfop02.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":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-28T16:45:04.000Z","updated_at":"2025-08-28T22:56:44.000Z","dependencies_parsed_at":"2025-08-29T03:54:27.354Z","dependency_job_id":"ff0d818e-f6a2-4c0a-933e-95318083681f","html_url":"https://github.com/dfop02/tech-interview-backend","commit_stats":null,"previous_names":["dfop02/tech-interview-backend"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dfop02/tech-interview-backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfop02%2Ftech-interview-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfop02%2Ftech-interview-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfop02%2Ftech-interview-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfop02%2Ftech-interview-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dfop02","download_url":"https://codeload.github.com/dfop02/tech-interview-backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dfop02%2Ftech-interview-backend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275114820,"owners_count":25407928,"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","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2025-09-14T13:54:10.825Z","updated_at":"2025-09-14T13:54:16.033Z","avatar_url":"https://github.com/dfop02.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Desafio técnico e-commerce\n\n## Nossas expectativas\n\nA equipe de engenharia da RD Station tem alguns princípios nos quais baseamos nosso trabalho diário. Um deles é: projete seu código para ser mais fácil de entender, não mais fácil de escrever.\n\nPortanto, para nós, é mais importante um código de fácil leitura do que um que utilize recursos complexos e/ou desnecessários.\n\nO que gostaríamos de ver:\n\n- O código deve ser fácil de ler. Clean Code pode te ajudar.\n- Notas gerais e informações sobre a versão da linguagem e outras informações importantes para executar seu código.\n- Código que se preocupa com a performance (complexidade de algoritmo).\n- O seu código deve cobrir todos os casos de uso presentes no README, mesmo que não haja um teste implementado para tal.\n- A adição de novos testes é sempre bem-vinda.\n- Você deve enviar para nós o link do repositório público com a aplicação desenvolvida (GitHub, BitBucket, etc.).\n\n## O Desafio - Carrinho de compras\nO desafio consiste em uma API para gerenciamento do um carrinho de compras de e-commerce.\n\nVocê deve desenvolver utilizando a linguagem Ruby e framework Rails, uma API Rest que terá 3 endpoins que deverão implementar as seguintes funcionalidades:\n\n### 1. Registrar um produto no carrinho\nCriar um endpoint para inserção de produtos no carrinho.\n\nSe não existir um carrinho para a sessão, criar o carrinho e salvar o ID do carrinho na sessão.\n\nAdicionar o produto no carrinho e devolver o payload com a lista de produtos do carrinho atual.\n\n\nROTA: `/cart`\nPayload:\n```js\n{\n  \"product_id\": 345, // id do produto sendo adicionado\n  \"quantity\": 2, // quantidade de produto a ser adicionado\n}\n```\n\nResponse\n```js\n{\n  \"id\": 789, // id do carrinho\n  \"products\": [\n    {\n      \"id\": 645,\n      \"name\": \"Nome do produto\",\n      \"quantity\": 2,\n      \"unit_price\": 1.99, // valor unitário do produto\n      \"total_price\": 3.98, // valor total do produto\n    },\n    {\n      \"id\": 646,\n      \"name\": \"Nome do produto 2\",\n      \"quantity\": 2,\n      \"unit_price\": 1.99,\n      \"total_price\": 3.98,\n    },\n  ],\n  \"total_price\": 7.96 // valor total no carrinho\n}\n```\n\n### 2. Listar itens do carrinho atual\nCriar um endpoint para listar os produtos no carrinho atual.\n\nROTA: `/cart`\n\nResponse:\n```js\n{\n  \"id\": 789, // id do carrinho\n  \"products\": [\n    {\n      \"id\": 645,\n      \"name\": \"Nome do produto\",\n      \"quantity\": 2,\n      \"unit_price\": 1.99, // valor unitário do produto\n      \"total_price\": 3.98, // valor total do produto\n    },\n    {\n      \"id\": 646,\n      \"name\": \"Nome do produto 2\",\n      \"quantity\": 2,\n      \"unit_price\": 1.99,\n      \"total_price\": 3.98,\n    },\n  ],\n  \"total_price\": 7.96 // valor total no carrinho\n}\n```\n\n### 3. Alterar a quantidade de produtos no carrinho \nUm carrinho pode ter _N_ produtos, se o produto já existir no carrinho, apenas a quantidade dele deve ser alterada\n\nROTA: `/cart/add_item`\n\nPayload\n```json\n{\n  \"product_id\": 1230,\n  \"quantity\": 1\n}\n```\nResponse:\n```json\n{\n  \"id\": 1,\n  \"products\": [\n    {\n      \"id\": 1230,\n      \"name\": \"Nome do produto X\",\n      \"quantity\": 2, // considerando que esse produto já estava no carrinho\n      \"unit_price\": 7.00, \n      \"total_price\": 14.00, \n    },\n    {\n      \"id\": 01020,\n      \"name\": \"Nome do produto Y\",\n      \"quantity\": 1,\n      \"unit_price\": 9.90, \n      \"total_price\": 9.90, \n    },\n  ],\n  \"total_price\": 23.9\n}\n```\n\n### 3. Remover um produto do carrinho \n\nCriar um endpoint para excluir um produto do do carrinho. \n\nROTA: `/cart/:product_id`\n\n\n#### Detalhes adicionais:\n\n- Verifique se o produto existe no carrinho antes de tentar removê-lo.\n- Se o produto não estiver no carrinho, retorne uma mensagem de erro apropriada.\n- Após remover o produto, retorne o payload com a lista atualizada de produtos no carrinho.\n- Certifique-se de que o endpoint lida corretamente com casos em que o carrinho está vazio após a remoção do produto.\n\n### 5. Excluir carrinhos abandonados\nUm carrinho é considerado abandonado quando estiver sem interação (adição ou remoção de produtos) há mais de 3 horas.\n\n- Quando este cenário ocorrer, o carrinho deve ser marcado como abandonado.\n- Se o carrinho estiver abandonado há mais de 7 dias, remover o carrinho.\n- Utilize um Job para gerenciar (marcar como abandonado e remover) carrinhos sem interação.\n- Configure a aplicação para executar este Job nos períodos especificados acima.\n\n### Detalhes adicionais:\n- O Job deve ser executado regularmente para verificar e marcar carrinhos como abandonados após 3 horas de inatividade.\n- O Job também deve verificar periodicamente e excluir carrinhos que foram marcados como abandonados por mais de 7 dias.\n\n### Como resolver\n\n#### Implementação\nVocê deve usar como base o código disponível nesse repositório e expandi-lo para que atenda as funcionalidade descritas acima.\n\nHá trechos parcialmente implementados e também sugestões de locais para algumas das funcionalidades sinalizados com um `# TODO`. Você pode segui-los ou fazer da maneira que julgar ser a melhor a ser feita, desde que atenda os contratos de API e funcionalidades descritas.\n\n#### Testes\nExistem testes pendentes, eles estão marcados como \u003cspan style=\"color:green;\"\u003ePending\u003c/span\u003e, e devem ser implementados para garantir a cobertura dos trechos de código implementados por você.\nAlguns testes já estão passando e outros estão com erro. Com a sua implementação os testes com erro devem passar a funcionar. \nA adição de novos testes é sempre bem-vinda, mas sem alterar os já implementados.\n\n\n### O que esperamos\n- Implementação dos testes faltantes e de novos testes para os métodos/serviços/entidades criados\n- Construção das 4 rotas solicitadas\n- Implementação de um job para controle dos carrinhos abandonados\n\n\n### Itens adicionais / Legais de ter\n- Utilização de factory na construção dos testes\n- Desenvolvimento do docker-compose / dockerização da app\n\nA aplicação já possui um Dockerfile, que define como a aplicação deve ser configurada dentro de um contêiner Docker. No entanto, para completar a dockerização da aplicação, é necessário criar um arquivo `docker-compose.yml`. O arquivo irá definir como os vários serviços da aplicação (por exemplo, aplicação web, banco de dados, etc.) interagem e se comunicam.\n\n- Adicione tratamento de erros para situações excepcionais válidas, por exemplo: garantir que um produto não possa ter quantidade negativa. \n\n- Se desejar você pode adicionar a configuração faltante no arquivo `docker-compose.yml` e garantir que a aplicação rode de forma correta utilizando Docker. \n\n## Informações técnicas\n\n### Dependências\n- ruby 3.3.1\n- rails 7.1.3.2\n- postgres 16\n- redis 7.0.15\n\n### Como executar o projeto\n\n## Executando a app sem o docker\nDado que todas as as ferramentas estão instaladas e configuradas:\n\nInstalar as dependências do:\n```bash\nbundle install\n```\n\nExecutar o sidekiq:\n```bash\nbundle exec sidekiq\n```\n\nExecutar projeto:\n```bash\nbundle exec rails server\n```\n\nExecutar os testes:\n```bash\nbundle exec rspec\n```\n\n### Como enviar seu projeto\nSalve seu código em um versionador de código (GitHub, GitLab, Bitbucket) e nos envie o link publico. Se achar necessário, informe no README as instruções para execução ou qualquer outra informação relevante para correção/entendimento da sua solução.\n\n### Como Testar\nEu criei o projeto e testei principalmente com o Docker Compose, você pode testar apenas utilizando:\n```bash\ndocker-compose build\ndocker-compose run web bundle exec rspec # Para rodar os testes\ndocker-compose run web bundle exec rails s # Para rodar o servidor\n```\nOptei por não utilizar nenhuma outra gem para evitar novas dependencias, e também foquei em realizar o projeto de maneira otimizada e limpa.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfop02%2Ftech-interview-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdfop02%2Ftech-interview-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdfop02%2Ftech-interview-backend/lists"}