# Website for printable building kits

A Symfony project

Install

System requirements

• PHP needs to be a minimum version of PHP 7.0
• PHP Extensions
  • FTP
  • SOAP
  • GD
  • PDO
  • Zip
• date.timezone setting set in php.ini

You can check if your system meets requirements by running $ bin/symfony_requirements

For full requirements see Symfony 3.2 docs.

Required

• Elasticsearch

  Instructions for installing and deploying Elasticsearch may be found here.

• POV-Ray

• stl2pov source.

• ADMesh source.

• LDView OSMesa >= 4.2.1 source.

Installing

Back-end

1. Make sure your system meets the application requirements
2. Install dependencies via Composer, $ composer install

Front-end

1. Install dependencies via npm, $ npm install
2. Install bower dependencies via bower, $ bower install
3. Compile assets by running Gulp, $ gulp

Initialization

Setup database

1. Set application parameters in app/config/parameters.yml
2. Generate an empty database by running command (if it does not yet exist) $ bin/console doctrine:database:create
3. Create database tables/schema by running command$ bin/console doctrine:schema:create
4. Load database fixtures $ bin/console doctrine:fixtures:load

Load data

You can load initial application data by running command $ bin/console app:init

This command consists of multiple subcommands that can be called separately:

1. Load LDraw models into database by running commad $ bin/console app:load:models [--ldraw=PATH] [--all] [--file=FILE] [--update]
2. Load Rebrickable data into database by running command $ bin/console app:load:rebrickable
3. Load relations between LDraw models and Rebrickable parts by running command $ bin/console app:load:relation
4. Download images of models from rebrickable.com $ bin/console app:load:images [--color=INT] [--rebrickable] [--missing]
5. Populate Elastisearch index $ bin/console fos:elastica:populate

Testing

You can run complete system tests by $ phpunit. These should cover the main system functions and the functionality of calling the third-party programs that are required are needed to seamlessly retrieve the necessary application data.