horse-race's Introduction

Horse Racing Simulator

Setup

Get the source code

git clone [email protected]:shadowinek/horse-race.git

Create local config file
```
cp .env.example .env
```
Set your APP_KEY and database connection in the .env file
Install the app dependencies
```
composer install
```
Run migrations
```
php artisan migrate
```
Run your local server
```
php -S localhost:8000 -t public
```
Open the app in your browser and enjoy

Notes/Diary

03.10.2019 0:15

I played around the math and the first functions for the horse calculations.
The first idea is to not save the race progress, but to calculate it on fly for every view.
Implementation will be probably done in Lumen.
Open questions:
- How to recognize/mark when the race is finished?

03.10.2019 11:35

Added base migrations and base classes
Working on the horse repository to randomly generate horses
On the horse creation I will calculate the final time and final step when the horse finish the race. This will allow me to mark the final step of the race and by the comparison, I can decide if the race is finished or not.
All floats will be saved as integers and divided by 10 afterwards.
TODO:
- remove not needed files from Lumen

03.10.2019 15:40

Functionality is finished
TODO:
- Improve the look
- Add pages for Race and Horse
- Add comments
- Extract time format function into helper function

03.10.2019 17:30

I am out of time, but the task is finished
Added documentation
What is missing:
- There are no tests. At least the calculation should be covered with tests
- There are no visible validations. But I consider this ok as far as there are no user value inputs.
Challenges:
- I wanted to avoid saving floats into the DB, but the calculations are less clear because of this.
- I have config file for the given restrictions, but the app is not really configurable, when there are already data in the DB. The old data would be broken when I would change the values.

horse-race's People

Contributors

horse-race's Issues

Late night thoughts on the core functions

<?php

class Test {

  private $speed;
  private $strength;
  private $endurance;

  private $baseSpeed = 5; // 5m/s
  private $distance = 1500; // 1500m

  public function __construct($speed, $strength, $endurance) {
    $this->speed = $speed;
    $this->strength = $strength;
    $this->endurance = $endurance;

    var_dump($speed, $strength, $endurance);
  }

  public function calculateSlowdown() {
    $reduction = $this->strength * 8 / 100;
    $slowdown = 5 * (1 - $reduction);

    return $slowdown;
  }

  public function calculateFullSpeedDistance() {
    return $this->endurance * 100;
  }

  public function calculateFullSpeedTime() {
    return $this->calculateFullSpeedDistance() / $this->calculateSpeed();
  }

  public function calculateSpeed() {
    return $this->speed + $this->baseSpeed;
  }

  public function calculateDistance($step) {
    $time = $step * 10; // each step in progress is 10s
    $distance = $time * $this->calculateSpeed();
    $fullSpeedDistance = $this->calculateFullSpeedDistance();

    if ($distance > $fullSpeedDistance) {
      $fullSpeedTime = $this->calculateFullSpeedTime();
      $reducedSpeedDistance = ($time - $fullSpeedTime) * ($this->calculateSpeed() - $this->calculateSlowdown());

      $distance = $fullSpeedDistance + $reducedSpeedDistance;
    }

    if ($distance > $this->distance) {
      return $this->distance;
    }

    return round($distance, 2) ;
  }

  public function calculateFinalTime() {
    $time = 0;
    $fullSpeedTime = $this->calculateFullSpeedTime();
    $fullSpeedDistance = $this->calculateFullSpeedDistance();

    $remainingDistance = $this->distance - $fullSpeedDistance;

    $remainingTime = $remainingDistance / ($this->calculateSpeed() - $this->calculateSlowdown());

    $time = $fullSpeedTime + $remainingTime;

    return round($time, 2);
  }
}

$test = new Test(10, 10, 9);

echo PHP_EOL;
echo 'slowdown: ' . $test->calculateSlowdown() . PHP_EOL;
echo 'fullspeeddistance: ' . $test->calculateFullSpeedDistance() . PHP_EOL;
echo 'fullspeedtime: ' . $test->calculateFullSpeedTime() . PHP_EOL;
echo 'speed: ' . $test->calculateSpeed() . PHP_EOL;
echo PHP_EOL;
for($i=1;$i<20;$i++) {
  echo '#' . $i .' distance: ' . $test->calculateDistance($i) . 'm' .  PHP_EOL;
}
echo PHP_EOL;
echo 'final time: ' . $test->calculateFinalTime() . 's' .  PHP_EOL;

Recommend Projects