Spryker Hackathon Q1 2016

2016 Spryker Systems GmbH / Hackathon Q1/16 2
Introduc?on

About me
Fabian Wesner

>= 2015 Spryker Systems

2012 – 2014 Project A Ventures

2011 Rocket Internet

2010 Zalando

Contact me
Follow me on twiQer to get
#Spryker updates and
photos from this hackathon.

hQps://twiQer.com/FabianWesner

Ø  This presenta?on is available on Slideshare!

Spryker Bird’s eye view

Code principles
Spryker (pragma?cally) follows the
SOLID-‐Principles,
Principles of cohesion,
and Principles of Coupling.
Spryker welcomes Clean Code!
Highly recommended!

Code quality
h"ps://scru*nizer-‐ci.com/g/spryker/spryker/?branch=develop

Layered architecture

Four Layer Architecture

A bundle in a nutshell

Zed – Structure of a bundle

Zed – Presenta?on layer
Spryker uses Twig templa?ng
engine.

Zed – Presenta?on layer – Technologies
2016 Spryker Systems GmbH / Hackathon Q1/16
13
Twig templa?ng engine

NPM for packaging

Webpack for collec?ng all the assets, load them,
check them, compile and op?mize them

Zed – Communica?on layer
Controller, Tables, Forms and
Plugins.

Powered by Silex micro-‐
framework and some Symfony
components

Zed – Business layer
The facade is the API (entry point)
to this layer.

Here you implement your business
models!

Guideline:
-‐  Every model implements an
interface
-‐  Dependency Injec?on only

Zed – Business layer -‐ Facade
The facade acts like an internal API.
The main responsibility of the facade is to hide the internal implementa?on.
class CustomerFacade extends AbstractFacade!
{!
!
public function updateCustomer()!
{ ... }!
!
public function restorePassword()!
{ ... }!
!
public function setDefaultShippingAddress()!
{ ... }!
!
}!

Zed – Business layer -‐ Facade
The façade of the current bundle is available with
in Controllers and Plugins.
$this->getFacade()!

Spryker uses

Each bundle ships with a part
of the schema.

QueryContainer acts as API

En??es and query objects are
generated.
Zed – Persistence layer

Zed – Persistence layer – QueryContainer
The QueryContainer contains
all queries of a bundle.

QueryContainer is used by the
other layers with:!
$this->getQueryContainer()!

Zed – Persistence layer – Schema XML
<?xml version="1.0"?>!
<database name="zed”>!
!
<table name="spy_customer" idMethod="native" phpName="SpyCustomer">!
<column name="id_customer" required="true" type="INTEGER” />!
<column name="email" required="true" size="255" type="VARCHAR" />!
<column name="first_name" size="100" type="VARCHAR" />!
<column name="last_name" size="100" type="VARCHAR" />!
<unique>!
<unique-column name="email" />!
</unique>!
</table>!
!
</database> !

Zed – Persistence layer –En??es&Queries
// Entity!
$customerEntity = new SpyCustomer();!
$customerEntity->setFirstName('John')!
->setFirstName('John')!
->setLastName('Doe')!
->save();!
!
// Query object!
$customerQuery = new SpyCustomerQuery();!
$customerEntity = $customerQuery!
->filterByFirstName('John')!
->findOne();!
!

Packaging with bundles
-‐ The modular monolith -‐

Zed = Monolith?
Zed

Zed consists of bundles
A bundle is a “func?onal unit”.

Bundles are decoupled and provide an explicit API.

They follow the packaging principles!

Currently there are > 100 bundles.

Managed by

Zed = Modular Monolith

Each bundle consists of (up to) 4 layers

Connec?ng bundles

Dependency Provider
class CartDependencyProvider extends AbstractBundleDependencyProvider!
{!
!
public function provideBusinessLayerDependencies(Container $container)!
{!
$container[self::FACADE_CALCULATION] = function (Container $container)
{!
return $container->getLocator()->calculation()->facade();!
};!
!
return $container;!
}!
}!

Programming with Spryker

Yves client

Yves client – Usage
class CartOperationHandler extends BaseHandler!
{!
public function add($sku, $quantity, $optionValueUsageIds = [])!
{!
$itemTransfer = new ItemTransfer();!
$itemTransfer->setSku($sku);!
$itemTransfer->setQuantity($quantity);!
!
$this->addProductOptions($optionValueUsageIds, $itemTransfer);!
!
$quoteTransfer = $this->cartClient->addItem($itemTransfer);!
$this->cartClient->storeQuote($quoteTransfer);!
}!
}!

Transfer objects
$customerTransfer = new CustomerTransfer();!
$customerTransfer!
->setEmail('john.doe@spryker.com')!
->setFirstName('John')!
->setLastName('Doe');!
!
echo $customerTransfer->getFirstName(); // echos 'John'!
!
<transfer name="Customer">!
<property name="email" type="string" />!
<property name="firstName" type="string" />!
<property name="lastName" type="string" />!
</transfer>!

Factories -‐ Usage
class CartFacade extends AbstractFacade!
{!
public function add(CartChangeTransfer $cartChangeTransfer)!
{!
return $this->getFactory()->createCartOperation()!
->add($cartChangeTransfer);!
}!
!
public function remove(CartChangeTransfer $cartChangeTransfer)!
{!
return $this->getFactory()->createCartOperation()!
->remove($cartChangeTransfer);!
}!

Factories -‐ Example
class CartBusinessFactory extends AbstractBusinessFactory!
{!
/**!
* @return SprykerZedCartBusinessModelOperationInterface!
*/!
public function createCartOperation()!
{!
return new Operation(!
$this->createStorageProvider(),!
$this->getCalculatorFacade(),!
$this->getItemGrouperFacade()!
);!
}!
}!

Dependency Injec?on with Interfaces
class Operation implements OperationInterface!
{!
protected $cartStorageProvider;!
protected $calculationFacade;!
protected $itemGrouperFacade;!
!
public function __construct(!
StorageProviderInterface $cartStorageProvider,!
CartToCalculationInterface $calculationFacade,!
CartToItemGrouperInterface $itemGrouperFacade,!
) {!
$this->cartStorageProvider = $cartStorageProvider;!
$this->calculationFacade = $calculationFacade;!
$this->itemGrouperFacade = $itemGrouperFacade;!
}!
}!
!
!

Extension with Plugins
class CalculationDependencyProvider extends SprykerCalculationDependencyProvider!
{!
protected function getCalculatorStack (Container $container)!
{!
return [!
#Item calculators!
new ItemGrossAmountsCalculatorPlugin(),!
new ProductOptionGrossSumCalculatorPlugin(),!
!
#GrandTotal!
new GrandTotalTotalsCalculatorPlugin(),!
new GrandTotalWithDiscountsCalculatorPlugin(),!
!
#TaxTotal!
new TaxTotalsCalculatorPlugin(),!
];!
}!

Plugin example
class GrandTotalTotalsCalculatorPlugin extends AbstractPlugin !
implements CalculatorPluginInterface!
{!
public function recalculate(QuoteTransfer $quoteTransfer)!
{!
$this->getFacade()->calculateGrandTotalTotals($quoteTransfer);!
}!
}!
Plugins are the most important concept for extension in Spryker. They are everywhere!
Thurday

Important concepts

Order Management in Spryker

Cronjob scheduling
2016 Spryker Systems GmbH / Hackathon Q1/16
Cronjobs are executed via Jenkins.
// See jobs.php!
// Send emails every 10 minutes !
$jobs[] = [!
'name' => 'send-mails',!
'command' => '$PHP_BIN vendor/
bin/console mail:send-mail',!
'schedule' => '*/10 * * * *',!
'enable' => true,!
'run_on_non_production' => true,!
'stores' => ['DE', 'FR'],!
];!
vendor/bin/console setup:jenkins:generate!
41
h"p://zed.de.spryker.dev:10007/

Mul? store
A store is a business unit
Osen a country shop

The code is shared and localizable
You can extend classes and templates for each store.
One team ó n Stores

Dedicated database per store

A store can have mul?ple locales
Mul?-‐language

Release management (Preview)
No global version for Spryker!
Spryker V2

Each bundle has a version number
> 100 bundles
Seman?c versioning

Con?nuous delivery of atomic releases
Monday: Cart 2.0.0
Tuesday: Cms 3.1.0
Thursday: Cart 2.1.0

Scaling (implementa?on example)
Yves load-‐balancer
Zed load-‐balancer
Yves
phpApp
Yves
phpApp
Yves
phpApp
Zed Main
phpApp*
Zed
phpApp
DB
Redis
Elas?c
search
scale
read / write read / write write
read
read
*Zed main server only:
run cronjobs and post
deployment hooks
scale
Master-‐master or
master-‐slave
conﬁgura@on

Spryker hos?ng
Spryker follows The Twelve-‐Factor App methodology
Runs on any cloud environment and bare-‐metal

Solu?on partners for hos?ng available
Talk to us

Out-‐of-‐the-‐box integra?on with Heroku (coming soon)
Seamless con?nuous delivery with Github and Heroku Pipelines

Spryker documenta?on
hQp://spryker.github.io

A proven technology built in real-‐
world projects for ambi?ous and
non-‐standard business models.

Spryker Systems GmbH
Julie-‐Wolshorn-‐Strasse 1
10115 Berlin
Germany
info@spryker.com
Phone: +49 40 328 929 631
Fax: +49 40 328 929 699
www.spryker.com
www.kassenzone.de
www.digitalkaufmann.de
www.goto.project-‐a.com
48 2016 Spryker Systems GmbH / Hackathon Q1/16

Spryker Hackathon Q1 2016

More Related Content

Viewers also liked

Similar to Spryker Hackathon Q1 2016

Recently uploaded

Spryker Hackathon Q1 2016