Challenge FaleMais (Laravel 10 version)

Challenge description

English

The fictional telephone company VxTel, specialized in national long distance calls, will put a new product on the market called FaleMais. Normally a VxTel customer can make a call from one city to another paying a fixed rate per minute, with the price being pre-defined in a list with the origin and destination DDD codes:

With VxTel's new FaleMais product, the customer purchases a plan and can speak for free up to a certain time (in minutes) and only pays for the excess minutes. Excess minutes have a 10% increase over the normal minute rate. The plans are FaleMais 30 (30 minutes), FaleMais 60 (60 minutes) and FaleMais 120 (120 minutes).

VxTel, concerned about transparency with its customers, wants to provide a web page where the customer can calculate the cost of the call. There, the customer can choose the codes for the cities of origin and destination, the call time in minutes and choose the FaleMais plan. The application must show two values: (1) the call value with the plan and (2) without the plan. The initial cost of acquiring the plan must be disregarded for this problem.

Example of values:

The objective of the challenge is to provide an API that allows the simulation of call values following the proposed rules.

The following points must be taken into consideration during development:

• Use of framework features
• Object orientation
• Application architecture/internal design
• Tests
• Code clarity and organization
• API must be easy to use

The monetary values present in the example tables are in Real, the current currency of Brazil.

DDD means Direct Distance Dialing and is an automatic telephone call system between different urban areas in Brazil through the insertion of prefixes, always with 3 digits.

Portuguese/Português

A empresa de telefonia fictícia VxTel, especializada em chamadas de longa distância nacional, vai colocar um novo produto no mercado chamado FaleMais. Normalmente um cliente VxTel pode fazer uma chamada de uma cidade para outra pagando uma tarifa fixa por minuto, com o preço sendo pré-definido em uma lista com os códigos DDDs de origem e destino:

Com o novo produto FaleMais da VxTel o cliente adquire um plano e pode falar de graça até um determinado tempo (em minutos) e só paga os minutos excedentes. Os minutos excedentes tem um acrescimo de 10% sobre a tarifa normal do minuto. Os planos são FaleMais 30 (30 minutos), FaleMais 60 (60 minutos) e FaleMais 120 (120 minutos).

A VxTel, preocupada com a transparência junto aos seus clientes, quer disponibilizar uma página na web onde o cliente pode calcular o valor da ligação. Ali, o cliente pode escolher os códigos das cidades de origem e destino, o tempo da ligação em minutos e escolher qual o plano FaleMais. O sistema deve mostrar dois valores: (1) o valor da ligação com o plano e (2) sem o plano. O custo inicial de aquisição do plano deve ser desconsiderado para este problema.

Exemplo de valores:

O objetivo do desafio é disponibilizar uma API que permita a simulação de valores da ligação seguindo as regras propostas.

Os seguintes pontos devem ser levados em consideração durante o desenvolvimento:

• Uso de features do framework
• Orientação a objeto
• Arquitetura/Design interno da aplicação
• Testes
• Clareza e organização do código
• Facilidade de uso da API

Os valores monetários presentes nas tabelas de exemplo estão em Real, a moeda atual do Brasil.

DDD significa Discagem Direta à Distância e é um sistema de ligação telefônica automática entre diferentes àreas urbanas do Brasil por meio da inserção de prefixos, sempre com 3 dígitos.

Built with

Docs

• Answering the challenge
• Getting started
• Using the API
• Database