Degica on Spree

Copyright 2005 - 2014 Degica Co. Ltd. All rights reserved.
Degica on Spree Chris Salzberg

Outline 1. About Me 2. Degica and Spree 3. Spree and the State Machine 4. Extending Spree

About Me

About me Montreal, Canada Amsterdam Tokyo

@shioyama

Degica and Spree

Company Profile • Leading E-Commerce Solutions Provider in Japan • Over 50 stores serving thousands of products • Partnerships with Valve, AVG, Kadogawa Games • Offices in Kichojoji, Victoria, Paris, San Francisco • Over $16 million to partners

Partners & Products

Degica Stack Customer Support Customer Support Marketing Marketing Design / Localization Design / Localization Full-stack E-Commerce Solutions Provider Logistics Logistics Technology Platform Technology Platform Cart System Cart System Payment Processing Payment Processing Website Hosting Website Hosting

Spree: the before

Spree: the after

Spree: the after spree-flexible-weight-rate spree-license-key spree-multi-domain spree-i18n spree-kana spree-payment-method-fee spree-add-on spree-auth-devise

3. Spree and State Machines

State Machine

RESTful Rails SELECT CREATE UPDATE GET /items POST /item/123 PUT /item/123 GET /item/123 Item 1 Item 3 Item 20 Item 15 Item 123 Item 123 Item 123 SELECT

Stateful Spree • Spree breaks RESTful conventions to create a stateful checkout flow • Checkout GET and PUT requests processed according to session cookie and state of order core/config/routes.rb

Checkout State • State persistence: – Session cookie stores current order_id – Database stores current state of the order order_id: 123 order_id: 123 GET /checkout redirect_to '/checkout/cart/edit' SELECT session id state 122 ... 123 'cart' 124 ...

StateMachine • Spree uses StateMachine to persist state • Spree ActiveRecord models with state machines: – Spree::Order – Spree::Payment – Spree::Shipment

Order State Machine

Order Checkout Flow core/app/models/spree/order.rb

Transition Callbacks core/app/models/spree/order/checkout.rb

Payment Flow

Shipment Flow

Like Clockwork • Core components linked together via state transitions • Each part extendible, and also their connections Order Shipment Payment

4. Extending Spree

Flexibile and Extendible • Modular – api, frontend, backend, cmd, core, sample • Extendible – Checkout flow DSL, custom transition callbacks – Custom User class – Override elements of views – Extend base classes with class decorators v

Spree License Key • Support for electronic license keys – No shipping cost, immediate delivery by email – License keys pulled from database or external API app/models/spree/license_key.rb

Transition Callbacks app/models/spree/shipment_observer.rb

Model Decorators • Add methods to core Spree classes • Override core class methods app/models/spree/shipment_decorator.rb

View Overrides • Hooks to override elements of core views • Uses Deface gem

Built to Last • Designed based on feedback from real deployments • Imposes reasonable constraints, to give you maximum flexibility • Supported by large and growing open source community • And built on Ruby/Rails!

Thanks!

Degica on Spree

Degica on Spree

More Decks by Chris Salzberg

Other Decks in Programming

Featured

Transcript