deiverable template - tagitsmart architecture, api and use cases... · web viewsmarttag encoding,...

17
Section 1 - Use Case Descriptions The use cases for the TagItSmart project were created by combining expertise of consortium partners. Total five use cases will be implemented during the project. Table 1. summarises the use cases. Table 1. Summary of use cases to be implemented in TagItSmart! Project together with consortium partners. Use case Owner Partners Digital product UpCode FLE, UNIS, VTT, EVT, UNIPD, UPC, SIE, DUR Lifecycle management DONDE DNET, FLE, EVT, UNIPD, UPC, SIE, TF, UNILEVER, DONDE, DUR, UNIS Brand protection DURST DNET, VTT, EVT, UNIPD, UPC, SIE, TF, DURST, UNIS Condition dependent pricing Univerexport DNET, FLE, UNIS, VTT, EVT, UNIPD, UPC, TF, UNIEX, DUR, UNIS Home services PICOM DNET, UNIS, EVT, UNIPD, UPC, PICOM, DONDE, DUR The digital product use case is a kind of umbrella use case including the whole value chain from manufacturer to transport, retail, consumer and recycling, see Figure 1.. The other use cases concentrate more in detailed to one or two stages of the lifecycle of the product. Page 1/17

Upload: others

Post on 08-Sep-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Section 1 - Use Case Descriptions

The use cases for the TagItSmart project were created by combining expertise of consortium partners. Total five use cases will be implemented during the project. Table 1 summarises the use cases.

Table 1. Summary of use cases to be implemented in TagItSmart! Project together with consortium partners.

Use case Owner Partners

Digital product UpCode FLE, UNIS, VTT, EVT, UNIPD, UPC, SIE, DUR

Lifecycle management DONDE DNET, FLE, EVT, UNIPD, UPC, SIE, TF, UNILEVER, DONDE, DUR, UNIS

Brand protection DURST DNET, VTT, EVT, UNIPD, UPC, SIE, TF, DURST, UNIS

Condition dependent pricing Univerexport DNET, FLE, UNIS, VTT, EVT, UNIPD, UPC, TF, UNIEX, DUR, UNIS

Home services PICOM DNET, UNIS, EVT, UNIPD, UPC, PICOM, DONDE, DUR

The digital product use case is a kind of umbrella use case including the whole value chain from manufacturer to transport, retail, consumer and recycling, see Figure 1. The other use cases concentrate more in detailed to one or two stages of the lifecycle of the product.

Figure 1. The TagItSmart! use cases under the Digital product umbrella.

Page 1/13

Page 2: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

1.1 Digital product

This use case is based on fast-moving consumer goods (FMCG) that want to become “smart” via SmartTAG and TagItSmart. In this use case the manufacturers are able to control products that leave their factories throughout their lifecycle, e.g. where and how the products are transported and in which conditions, when they have been delivered to the retail stores and when sold to the consumers. This use case also creates a new channel for manufacturers to communicate with the consumer, so that they can enable easy access to related information on product and item-level which is not only static but depend on lifecycle and historical data of the item.

Figure below describes high-level features that Digital Products implements, these features act as guidelines when requirements for Digital Product are developed.

Figure 1.- Digital Products use case featuresDuring Digital Products lifecycle following events happen, each of these events gives information to requirements development, as shown in Figure 2.

Page 2/13

Page 3: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Figure 2.- Digital Products use case conceptual flow

1.2 Lifecycle Management/Recycling

The lifecycle management/recycling use case is built around the concept of consumers buying products in the supermarket and engaging with them in different ways, focusing on the recyclability of the product, creating an ecosystem where consumers are provided with information about how to recycle a product based on contextual information (location, local regulations) and product recyclability (materials); information that is linked to the SmartTags on the products.

SmartTags in this use case enable the creation of consumer oriented services that are based on information that has been generated at different stages of the lifecycle of a product, involving different stakeholders, from the brands, to the retailers as well as the ultimate focus, the consumers and the authorities that regulate the recycling policies.

Page 3/13

Page 4: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Figure 3.- Lifecycle Management/Recycling use case conceptual flow

1.3 Brand Protection

The brand protection use case aims at providing brands and consumers with a mechanism to test authenticity of their products and reduce counterfeiting. SmartTags and their capabilities to change based on environmental conditions (such as light, temperature) are used to first identify uniquely the item at hand and second to provide means to avoid fake or misplaced products, by enabling contextual scanning.

How do we know thisparfume originates from

WellOdor Corp.?

??

?

Lets check the Smart Tag at the backside of

the bottle!!

!! By reading the QR-code on the label once

it guides me to the„Proof me if you can“

service fromTagItSmart!

Proof meif you can!

This is the TagItSmart! „Proof me if you can“ service for originality

proof.

Please read the codeagain by swithing on the

flashlight of yourhandheld device or

download the proper reader here.

Yes, I am“Parfum”

by

WellOdor Corp.

Proof meif you can!

After the 2nd read the„Proof me if you can“

service approvesoriginality of „Parfume“

by WellOdor Corp.

Figure 5.- Brand protection use case conceptual flow

1.4 Dynamic Pricing

Manufacturing first provide general information about the products (ingredients, recycling information, best before, consumable before, etc.) as well as reference thresholds for the

Page 4/13

Page 5: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

type of the product. Then the SmartTag (ID) is encoded and SmartTag is printed and attached to the product package. As a part of internal process control, the manufacturer scans SmartTag while the product is still in the factory (meat processing plant). Then the product is ready for transport to the retailer. Afterwards, the transport provider scans SmartTag as a part of the process control. In retail, retailer provides additional information about the products to support consumers (recipes, how to use etc.). Availability of information defined: general or when scanned at selected locations only (in their shops). Then the retailer scans SmartTag as a part of “supply chain control process “. Scanning results (pack ID and result) are forwarded to platform and dynamic price calculation process is invoked. Consumer scans SmartTags using a smartphone application and obtains information about the product (best before, price, recycling, recipes and other info approved by retailers). The retrieved information depends on the location and time of scanning.

Figure 6 Dynamic pricing use case conceptual flow

1.5 Home Services The Home Services use case has the following general scenarios and flows:

1) Purchase a. A Smart Tag needs to be installed by manufacturer and/or printed by retailer for

the customer to starts the warranty information.b. Retailer can gather information about purchaser.c. Manufacturer gets notification about purchase for statistics (price sold).d. Logistics gets notification about replenishment/relocation stocks.

2) Installationa. A technician scan tag and retrieves installation manuals.b. The user confirms authenticity/warranty via scan.c. The customer gets a user guide/application on his personal device via scan.

Page 5/13

Page 6: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

3) Correct Operation:a. Energy tips are given at scanning.b. Context information is gathered combining context readings and energy

consumption measures.4) Maintenance Operations:

a. Scans notify the time available to next maintenance action.b. Service Providers provide quotes/meeting dates.c. After maintenance, the tags are reset, or re-printed.

5) Water Qualitya. Read SmartTag about water quality/high temperature exposure and if contains

tartar/limestone.b. Order Tartar Limestone Inhibitorc. Reset the Tag after replacement.

6) Malfunctioning Alert:a. High temperature is recognized via scan and confirms whether warranty is in

place or not.b. Prove correct operations via scan tagc. Order repair service

7) Air Safety:a. Environmental Sensors provide information about gas leakages.b. Alert when reading Tag, Recommendation to open windows (trigger smart

actuator).c. Notification when air is safe.d. Replace Tag or reversible ink.

8) End of Life:a. Scan notifies that the end of life has been reached.b. Recycling services are informed and provide info for recycling point.

Page 6/13

Page 7: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Figure 4.- Home Services Use Case conceptual flow

Section 2 - Functional Components and Services

Page 7/13

Page 8: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Based on the use cases, we defined which platform components could fulfil the requirements for the different use cases. Based on the different aspects, we can group the different components in the following groups:

Service Management: defines components needed to access, discover and execute services in the platform.

Virtual Entities: defines components to work with virtual representations of the different objects defined in the use cases, from a CPG product to a sensor in a boiler.

SmartTags: defines the components to manage the creation, scanning and management of SmartTags.

Security: defines the components that will implement the authentication, authorisation, and any other security related aspects of the platform.

Domain Management: defines components that are specific to a use case domain.

Utility Services: defines utility components with services shared across use cases.

Application Development Tools: defines the SDKs and tools needed to implement applications on top of the platform.

Each group defines components to cover the different functional areas. Each component can be classified as one of the following types:

Service: software component with internal logic and providing an API. Data Store: any form of persistent storage technology. Semantic Model: semantic description of the related entity. Tools/Library: software component intended to be used in the development of

applications using TagItSmart technology. UI: visual component that serves as the interface for users of different roles to interact

with the rest of the components.

Section 3 - Architecture

The TagItSmart! platform from the functional point of view is composed from User/Developer level that provides front end for the different components, Service level for provisioning of the services and related functionalities and Virtual Entity level which is actual representations of the objects and provides access to the data and defined actions based on the semantic models.

From the current reference Architecture model defined, the SmartTag (blue box), the Data Access (orange box) and the User/Developer environment (green box) are planned to be released as separate open source modules. In this manner, anyone should be able to use its own platform and or/modules and plug on top of it components developed by TagItSmart!.

Page 8/13

Page 9: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

The components defined in are the set of components needed to fulfil the requirements extracted from the different use cases, while enabling the creation and lifecycle management of the SmartTags.

Based on the chosen integration strategy the mapping of some of the components to real implementations and deployments in a specific IoT platform will be different. However, TagItSmart components will define a common API to guarantee interoperability and seamless integration, as well as enabling the creation of third party applications on top of its components.

We propose the definition of the functionality needs in a simple HTTP REST based API for the main components that will govern the composition of services and the management of the SmartTags. Once the models developed in WP2, 3 and 4 are consolidated, the payloads and additional resources will be formalised. Additionally, the API can be mapped to other transport protocols, like MQTT, which will give support for push messaging to the different components.

Table 2.- Preliminary API Design Component HTTP

methodResource Purpose Input

PayloadOutput Payload

Service Access

Interface

GET /services List all available services

N.A. Array of available service descriptions

Page 9/13

Page 10: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Component HTTP method

Resource Purpose Input Payload

Output Payload

POST /services Create a new service description and make it available in the platform

Service Description

Service Identifier

GET

PUT

DELETE

/services/{id} Retrieve

Update

and Delete

a service description in the platform

N.A.

Service Description updates

N.A.

Status

GET /templates List all available templates in the platform

N.A. Array of available templates

POST /templates Create a new template and make it available in the platform

Template description

Template Identifier

GET

PUT

DELETE

/templates/{id} Retrieve

Update

and Delete

a template description in the platform

N.A.

Service Description updates

N.A.

Status

Service Manager

POST /services/query Create a semantic query for services or templates

Query Description Inputs and Outputs needed

Array of Services matching the query

POST /templates/query Create a query to resolve correspondent services needed for the execution will be selected.

Query description type of template needed.

Returns the correspondent workflow to execute.

Workflow Manager

POST /workflows/{id}/action/execute

Executes a workflow as defined by the Service Manager

Workflow template filled with all the needed information for the execution

Workflow Identifier

GET /workflows/{id} Gets the information of a workflow and its state

N.A. Workflow description and status

Virtual Entity Access

Interface

GET /virtualentities List all available entities N.A. Array of Virtual Entities matching the query

GET

PUT

DELETE

/virtualentitites/{id}

Retrieve

Update

and Delete

a virtual entity in the platform

N.A.

VE Description updates

N.A.

Status

POST /virtualentities/query

Create a semantic query for virtual entities

Query Description

Array of virtual entities matching

Page 10/13

Page 11: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Component HTTP method

Resource Purpose Input Payload

Output Payload

the query

Identity Management

POST /virtualentities Create a new entity assigning a unique identity

Virtual Entity Description

Web Identifier

SmartTag Creation

POST /virtualentities/{id}/smarttags

Creates a new SmartTag and assigns it to the correspondent Virtual Entity

SmartTag Description

Identifier

GET

PUT

DELETE

/virtualentities/{id}/smartags/{id}

Retrieve

Update

and Delete

a SmartTag in the platform

N.A.

VE Description updates

N.A.

Status

SmartTag Printing

GET /virtualentities /printers

List all available printers N.A. Array of printers available

POST /virtualentities/preprint

Registers a printer description

Printer Description

Identifier

POST /virtualentities/printers/query

Create a semantic query for printers

Query Description

Array of printers’ entities matching the query

POST /virtualentities/printers/{id}/action/print

Sends a print action and returns the corresponding printing results

Print action description

Status and identifier

GET /virtualentities /printers/{id}/action/print/{id}

Gets the status of a printing action

N.A. Status of the printing process

1 TagItSmart components available for the Open CallComponent DescriptionSmartTag Encoding, Creation and FC-Scanner (Javascript Web based SKD) for EVRYTHNG platform.

Web based components that enables the development of web applications that use SmartTags (functional inks and NFC) (Javascript SDK).

Virtual Entity Access Interface API endpoints to create Virtual Entities that have SmartTags associated. EVRYTHNG will provide backend support with free access to their IoT Smart Products Platform. Documentation can be found here: https://developers.evrythng.com/docs/

Stream Processing Ability to process the SmartTags information in real time and send events. EVRYTHNG will provide backend support with free access to their IoT Smart Products Platform. Documentation can be found here: https://developers.evrythng.com/docs/

Page 11/13

Page 12: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

Identity Management Ability to create unique Web Identities of Virtual Entities to be used with the SmartTags. EVRYTHNG will provide backend support with free access to their IoT Smart Products Platform. Documentation can be found here: https://developers.evrythng.com/docs/

User Management/Authentication/Access Control

Ability to capture interactions from the applications and the SmartTags and define custom analytics that can be used in applications. EVRYTHNG will provide backend support with free access to their IoT Smart Products Platform. Documentation can be found here: https://developers.evrythng.com/docs/

Data Analytics Ability to capture interactions from the applications and the SmartTags and define custom analytics that can be used in applications. EVRYTHNG will provide backend support with free access to their IoT Smart Products Platform. Documentation can be found here: https://developers.evrythng.com/docs/

SmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK).

QR code SmartTag Scanner SDK is component that takes QR code as an input and gives alphanumeric string as an output. SmartTag QR code building SDK is component that supports generation of the QR code by enabling its customized creation based on input alphanumeric (SmartTag value) string and number of sensors. As an output SDK will generate QR code with embedded alphanumeric value and sensor positioned in defined space.Web Provisioning tool is a SDK developed as a web application with following functionalities:

access control and user management (CRUD - username, pass, phone, email, gender, age);

product creation (with QR code building module: number of sensors (printed ink parts), product specification, price, "how to use manual", description, etc);

retail accounts management, product management, etc.

create batch QR codes for selected product

Fujitsu’s Coelition Date Engine A secure, cloud based, Coelition standards compliant repository for storing information about human behaviour. In the context of TagItSmart, the Data Engine can be used to store the results of a tag scan, but more importantly it can store the context information (time, location, social context, etc.) of the scan event. This can include GDPR-Ready consent and related functionality (e.g. the right to be erased). The Coelition Data Engine is also available for commercial use following a successful trial. For more information about Coelition, see www.coelition.org.

Workflow Enforcer and SmartTag Scanning Module

Open Call participants can choose to build their application on Fujitsu RunMyProcess business

Page 12/13

Page 13: Deiverable template - TagItSmart Architecture, API and Use Cases... · Web viewSmartTag Encoding, Creation and FC-Scanner (Xamarin Mobile based SKD and ASP.NET MVC Web based SDK)

process integration platform. Integrating 1000s of existing business components into a single deployable application. The mobile app includes a built in smart tag reader to capture the contents of TagItSmart smart tags. For details see: www.runmyprocess.com

Smart Tag Design service The design of a QR code that can be read by standard QR code readers in two different ways (before and after exposure to an environmental influence) requires a complicated technical process. Based on a root URL (e.g. www.example.com/product002/) we will generate on request two URLs and corresponding QR codes. We will provide example codes for both the before and after states and the mask that would need to be printed in reactive ink. For example:

SmartTag module (creation, scanning, decoding)

Code creation (VE’s). Scanning FC (DM) codes in mobile

Android based user authentication An authentication method which uses the user location and location history to authenticate a user.

Semantic parser A biometric technique to authenticate users on mobile devices by using their typing behaviour.

NFC opensense, SpeedTap, Temperature labelsPrinting of inks and information about the availability

Analog printing (flexography) of thermochromic and photochromic inks. Partners also free to print at other places. Recommendations on where to find suitable commercial inks.

Inkjet printing of tags (1) CMYK inkjet printing of tags with standard ink set using Durst "Roh" printer series (Lienz) on customer substrates; if customer substrates are not available, then f.e. standard R2R self-adhesive tag materials or flatbed media (PVC, PP, PS) is recommended(2) R&D on functional inkjet inks (focus: thermochromic and photochromic inks); if available then inkjet printing of those using the Durst Rho printer series

Product materials recyclability API (Europe) and Recycling locations API (on demand)

API Endpoints to obtain recycling information and disposal locations based on materials of products in Europe.

Page 13/13