updating fleetController.php and adding some other game plan thoughts.

Author: harwoodr

LOGIC.md

@@ -15,3 +15,33 @@ Commands that simply read data from the system will return the data immediately.
 The original bnt performed system updates server side by executing the scheduler via cron.  The plan for bnt2 is to still use cron (or a cron-like service) to add a system update commands to the queue - which would then be executed by the queue runner.  
 This again removes the threat of some race conditions and also allows for dealing with the possibility of heavy system load.
 
+## Ship numbers
+
+- hull: is the size of the hull dictating cargo capacity but also target size
+- engines: motive forces for the ship aids in both defensive and offensive capabilities as well.
+- power: provides energy for engines, weapons, shields and cloak - too low and these dependent systems will suffer and perform at a degraded level
+- computer: enhances offensive capabilities and sensor analysis
+- sensors: provides scanning information and potentially sees past adversarial cloaks
+- weapons: primary offensive capabilities - directly affects damage inflicted
+- shields: regenerative defensive system - regenerates between combat sessions
+- armour: ablative defensive system - must be repaired to restore damage
+- cloak: a system that hides the ship from others
+
+## Planet numbers
+
+- planets with no player_id are unowned and can be claimed by players
+- shields and weapons are similar to the values for ships but can be much larger (in theory)
+- commodity quantities, production facilities are stored in the production table
+
+### Combat 
+
+- offensive and defensive are both a function of computer, engines, hull, sensors and cloak
+- offensive is modified by weapons
+- defensive is modified by shields and armour
+- damage inflicted is a direct function of weapons, modified by computer and sensors.
+- damage sustained is opponent's inflicted damage, modified by shields and armour.
+- damage is applied first to shields and then to armour.
+- if armour is reduced to zero, the ship is destroyed.
+- when a ship is destroyed, if the fleet's cargo capacity is reduced below the current cargo carried, random cargo is jettisoned until the capacity limit is met.
+- jettisoned cargo may be salvaged by the attacker
+- if there are defender aligned fleets or planets in the same sector as the combat - they join as defenders in the combat. 

src/Controller/fleetController.php

@@ -95,7 +95,7 @@ public function update(string $id): void
             Flight::status(404,'Fleet not found');
         }
         if($this->target->getOwnerID() == Flight::get('current_player_id')) {
-            //Flight::dump($this->request->data);
+            //player owns this fleet
             if(isset($this->request->data['sector_id']) && $this->request->data['sector_id'] != $this->target->sector->id) {
                 //use warp link to another sector TODO: ->Q
                 if (in_array($this->request->data['sector_id'],array_column($this->target->sector->link, 'destination_id'))) {
@@ -144,6 +144,9 @@ public function update(string $id): void
             } elseif(isset($this->request->data['purchase'])) {
                 //buy commodity from port and add it to the fleet
                 //TODO: lots (credits for one)
+                //is there an appropriate port in the same sector as the fleet?
+                //is there available commodity for sale?
+                //
             } else {
                 Flight::status(422,'No recognized operation');
             }