* Actual interfaces should extend this.
 *

   Specific interface methods are described in BackEndInterface.php

   
   ***NOTE***
   These are described here primarily for the purposes of documentation.
   These are data-only objects rather than functional classes.
   Incomming (ie. from client) will be assoc arrays (via JSON of course)
   Outgoing will be converted into plain JSON data automatically.
   For example a LoginResponse will be coded in PHP something like
     $LogResp->message = 'foo';
   while a BatchReturn (from client) will be coded as
     $bid = $BatchRet['batchId'];
   Being arrays means the incomming data can be extracted() but note some
   data structures are nested arrays.

 *    Uses just the file system
 *    Method is single classification by moving files from unsorted to sorted bins
 * 
 * Architecture
 *    All code in this file.  Various functions are implemented with GET argument 'action'
 *    eg NoDB1.php?action=batchup
 * 
 * Notes
 *    This is not meant to be production-quality code

 *   USERS, SESSIONS, BATCHES, PICKS and LOGS

  Note:  All the public facing calls have the following structure
    public function Foo($A1,$A2...){
    if($A1==ARGS_IN_GET){
      return $this->StartBatch(Arg('A1'),Arg('A2')...);
    }
  The purpose of this is to allow the NoDB program to accept an 'Action' parameter from GET
  then in effect say "I can't be bothered fishing out the GETs, so you do it Foo().  I'll flag
  the need to do this with an out of band first arg."

 *  File tabulation through to screen and back.   
 * Basic CRUD eventually.  For now just display.

 * File access utilities   
 * Basic CRUD
 *  
 *

//======================================================================  
//  ooooo      ooo                           .o8                    
//  `888b.     `8'                          "888                    
//   8 `88b.    8   .ooooo.   .ooooo.   .oooo888   .oooo.o          
//   8   `88b.  8  d88' `88b d88' `88b d88' `888  d88(  "8          
//   8     `88b.8  888ooo888 888ooo888 888   888  `"Y88b.           
//   8       `888  888    .o 888    .o 888   888  o.  )88b          
//  o8o        `8  `Y8bod8P' `Y8bod8P' `Y8bod88P" 8""888P'          
//                  .o8   o8o      .    o8o                         
//                 "888   `"'    .o8    `"'                         
//   .ooooo.   .oooo888  oooo  .o888oo oooo  ooo. .oo.    .oooooooo 
//  d88' `88b d88' `888  `888    888   `888  `888P"Y88b  888' `88b  
//  888ooo888 888   888   888    888    888   888   888  888   888  
//  888    .o 888   888   888    888 .  888   888   888  `88bod8P'  
//  `Y8bod8P' `Y8bod88P" o888o   "888" o888o o888o o888o `8oooooo.  
//                                                       d"     YD  
//                                                       "Y88888P'  
//======================================================================

?>

require_once('common.php');

// read the slate name and make sure it is sensible
$slateName = $_GET['slate'];
if(!$slateName){$slateName='welcome';}
if(preg_match("/[a-z]{4,20}/i",$slateName)==0){$slateName='welcome';}

// find it in the slates
$fname  = SLATES . $slateName . '/slate.js';
if(!file_exists($fname)){
   header("HTTP/1.0 404 File $fname Not Found");
   die();
}

// read the data (JSON), strip comments
$slateArray = file($fname);
$slateText = '';
foreach($slateArray as $l){
  $split = explode('//',$l);
  if($split[0]){$slateText .= $split[0];}
}
//print('<hr>'.$slateText.'<hr>');

//  Decode/encode to tidy-up any json errors  
try{
  $slateData = json_decode($slateText);
  $slateJson = json_encode($slateData);
}catch(Exception $e) {
   header("HTTP/1.0 501 File $fname is faulty");
   exit;
}
//print_r($slateData);

// Read the template file and insert into the slate
$fname  = SLATES . $slateName . '/template.htm';
if(!file_exists($fname)){
   header("HTTP/1.0 404 File $fname Not Found");
   die();
}
$slateData->template=file_get_contents($fname);

// Read remaining optional slate files into the slate object
$fname  = SLATES . $slateName . '/help.htm';
if(file_exists($fname)){$slateData->help=file_get_contents($fname);}
$fname  = SLATES . $slateName . '/instruction.htm';
if(file_exists($fname)){$slateData->instruction=file_get_contents($fname);}
$fname  = SLATES . $slateName . '/completion.htm';
if(file_exists($fname)){$slateData->completion=file_get_contents($fname);}
$fname  = SLATES . $slateName . '/slate.css';
if(file_exists($fname)){$slateData->css=file_get_contents($fname);}

// return the slate to the client
send(json_encode($slateData));

?>