### Start PhantomJS Server

Source: https://github.com/koolphp/koolreport/blob/master/tests/README.md

Initiates the PhantomJS browser automation server, typically on port 4444.

```bash
vendor/bin/phantomjs
```

--------------------------------

### Install KoolReport using Composer

Source: https://github.com/koolphp/koolreport/blob/master/README.md

Use this command to install the latest KoolReport version via Composer. This is the recommended installation method.

```bash
composer require koolreport/core
```

--------------------------------

### Install KoolReport using Composer (Legacy)

Source: https://github.com/koolphp/koolreport/blob/master/README.md

This command installs the legacy version of KoolReport. It is recommended to use the 'koolreport/core' package instead.

```bash
$ composer require koolphp/koolreport
```

--------------------------------

### KoolReport Project Structure

Source: https://github.com/koolphp/koolreport/blob/master/README.md

This illustrates the typical directory structure of a KoolReport project after installation.

```text
koolreport/
├── packages/
├── src/
│   ├── clients/
│   ├── core/
│   ├── datasources/
│   ├── processes/
│   └── widgets/
├── tests/
└── autoload.php
```

--------------------------------

### Run All Acceptance Tests

Source: https://github.com/koolphp/koolreport/blob/master/tests/README.md

Initiates the execution of all acceptance tests defined in the project.

```bash
vendor/bin/codecept run acceptance
```

--------------------------------

### Bootstrap File for a KoolReport Report

Source: https://github.com/koolphp/koolreport/blob/master/README.md

The index.php file acts as the entry point for your report. It requires the report class, instantiates it, runs the report, and renders the output.

```php
<?php
// index.php: Just a bootstrap file
require_once "SalesByCustomer.php";

$salesByCustomer = new SalesByCustomer;
$salesByCustomer->run()->render();

```

--------------------------------

### Run All Unit Tests

Source: https://github.com/koolphp/koolreport/blob/master/tests/README.md

Execute all defined unit tests.

```bash
vendor/bin/codecept run unit
```

--------------------------------

### SalesByCustomer.view.php - Table Visualization

Source: https://github.com/koolphp/koolreport/blob/master/README.md

Renders the 'sales_by_customer' data store as an HTML table. Configures column labels and currency prefixes for sales amounts, and applies a hover and bordered CSS class to the table.

```php
    <?php
    Table::create(array(
        "dataStore"=>$this->dataStore('sales_by_customer'),
            "columns"=>array(
                "customerName"=>array(
                    "label"=>"Customer"
                ),
                "dollar_sales"=>array(
                    "type"=>"number",
                    "label"=>"Amount",
                    "prefix"=>"$",
                )
            ),
        "cssClass"=>array(
            "table"=>"table table-hover table-bordered"
        )
    ));
    ?>
</div>

```

--------------------------------

### Generate Acceptance Test

Source: https://github.com/koolphp/koolreport/blob/master/tests/README.md

Command to create a new acceptance test suite.

```bash
vendor/bin/codecept generate:cest amazing\Theme
```

--------------------------------

### Run Specific Acceptance Test

Source: https://github.com/koolphp/koolreport/blob/master/tests/README.md

Execute a particular acceptance test suite.

```bash
vendor/bin/codecept run acceptance amazing\ThemeCest
```

--------------------------------

### SalesByCustomer.view.php - Bar Chart Visualization

Source: https://github.com/koolphp/koolreport/blob/master/README.md

Renders the 'sales_by_customer' data store as a Google Bar Chart. Configures chart dimensions, column labels, data types, currency prefixes, and emphasis for sales amounts.

```php
<?php 
    use \koolreport\widgets\koolphp\Table;
    use \koolreport\widgets\google\BarChart;
?>

<div class="report-content">
    <div class="text-center">
        <h1>Sales By Customer</h1>
        <p class="lead">This report shows top 10 sales by customer</p>
    </div>

    <?php
    BarChart::create(array(
        "dataStore"=>$this->dataStore('sales_by_customer'),
        "width"=>"100%",
        "height"=>"500px",
        "columns"=>array(
            "customerName"=>array(
                "label"=>"Customer"
            ),
            "dollar_sales"=>array(
                "type"=>"number",
                "label"=>"Amount",
                "prefix"=>"$",
                "emphasis"=>true
            )
        ),
        "options"=>array(
            "title"=>"Sales By Customer",
        )
    ));
    ?>
    
```

--------------------------------

### Generate Unit Test

Source: https://github.com/koolphp/koolreport/blob/master/tests/README.md

Use this command to generate a new unit test file for a specific class.

```bash
vendor/bin/codecept generate:test unit koolreport\amazing\AmazingTheme
```

--------------------------------

### Run Specific Unit Test

Source: https://github.com/koolphp/koolreport/blob/master/tests/README.md

Run a single unit test for a specified class.

```bash
vendor/bin/codecept run unit koolreport\amazing\AmazingThemeTest
```

--------------------------------

### SalesByCustomer.php - Data Processing Logic

Source: https://github.com/koolphp/koolreport/blob/master/README.md

Defines the data source and processing steps for the SalesByCustomer report. It groups sales by customer, sums their sales, sorts by sales in descending order, and limits to the top 10.

```php
<?php
require_once "../koolreport/autoload.php";

//Specify some data processes that will be used to process
use \koolreport\processes\Group;
use \koolreport\processes\Sort;
use \koolreport\processes\Limit;

//Define the class
class SalesByCustomer extends \koolreport\KoolReport
{
    protected function settings()
    {
        //Define the "sales" data source which is the orders.csv 
        return array(
            "dataSources"=>array(
                "sales"=>array(
                    "class"=>'\koolreport\datasources\CSVDataSource',
                    "filePath"=>"orders.csv",
                ),        
            )
        );
    }
  
    protected function setup()
    {
        //Select the data source then pipe data through various process
        //until it reach the end which is the dataStore named "sales_by_customer".
        $this->src('sales')
        ->pipe(new Group(array(
            "by"=>"customerName",
            "sum"=>"dollar_sales"
        )))
        ->pipe(new Sort(array(
            "dollar_sales"=>"desc"
        )))
        ->pipe(new Limit(array(10)))
        ->pipe($this->dataStore('sales_by_customer'));
    }
}

```

--------------------------------

### KoolReport Report File Structure

Source: https://github.com/koolphp/koolreport/blob/master/README.md

This shows the file organization for a simple report, including the main report class, its view file, and the index bootstrap file.

```text
/
├── koolreport/
├── SalesByCustomer.php
├── SalesByCustomer.view.php
└── index.php
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.