improved invoices with new renderer (#306)

* added docx renderer and demo template
* added csv renderer and demo template
* added xlsx renderer and demo template
* added ods renderer and demo template
* added user calculator
* added invoice documentation

src/Model/Statistic/Month.php

@@ -10,7 +10,7 @@
 namespace App\Model\Statistic;
 
 /**
- * Yearly statistics
+ * Monthly statistics
  */
 class Month
 {
@@ -28,11 +28,14 @@ class Month
     protected $totalRate = 0;
 
     /**
-     * Month constructor.
      * @param string $month
      */
-    public function __construct($month)
+    public function __construct(string $month)
     {
+        $monthNumber = (int) $month;
+        if ($monthNumber < 1 || $monthNumber > 12) {
+            throw new \InvalidArgumentException('Invalid month given, expected 01-12 but given: ' . $monthNumber);
+        }
         $this->month = $month;
     }
 

src/Model/Statistic/Year.php

@@ -21,7 +21,7 @@ class Year
     /**
      * @var Month[]
      */
-    protected $months;
+    protected $months = [];
 
     /**
      * Year constructor.
@@ -52,10 +52,10 @@ class Year
     }
 
     /**
-     * @param $month
+     * @param int $month
      * @return null|Month
      */
-    public function getMonth($month)
+    public function getMonth(int $month)
     {
         if (isset($this->months[$month])) {
             return $this->months[$month];