Neosperience Cloud empowering product development on AWS
Tags: cloud, productmanagement, microservices, aws
Published: 2020-08-30 21:54:28

---
title: Neosperience Cloud empowering product development on AWS
published: true
date: 2020-07-06 15:16:00 UTC
tags: cloud,productmanagement,microservices,aws
canonical_url: https://medium.com/@aletheia/neosperience-cloud-empowering-product-development-on-aws-900fcab84663
---

![](https://cdn-images-1.medium.com/max/1024/1*yNfNxazxsIYEG-zDolyVSA.jpeg)<figcaption>Neosperience aims to become the foundation of partners' product strategy and the backbone of our services. Photo by <a href="https://unsplash.com/photos/V_y81v_lI4k">Mirko Blicke</a> from <a href="https://unsplash.com/">Unsplash</a></figcaption>

Some of the companies joining us in the last few months brought non only strong domain expertise and technical competencies in their field (i.e., [MIkamai](https://www.mikamai.com/), [LinkMe](https://www.linkme.it/)) but also widely adopted products, like [Workup RubinRed](https://www.rubinred.com/ita/) Digital Commerce platform. Many to come in the next months as soon as we find top performers in their fields, willing to scale up and join our family. On a product strategy basis, it has not been easy to think which evolution model was the best to provide the best value for our customers.  
On one side, we could adopt a centralized model with firm product feature decisions coming from a steering committee, including domain experts from our subsidiaries, at the risk of losing some particular point of view that gets flooded into an enormous backlog. On the other side, a decentralized model could empower teams taking ownership, but integration issues could become an issue.

### The ruling or serving dilemma

Company growth often means acquiring new teams that join your dream. The most challenging part of this process is to set up the relation between the leading company and its subsidiaries. Here at Neosperience, we developed through the years a sound technological structure that empowers several innovative solutions and their evolution through years while remaining with a modern approach and a strong knowledge of our customer experience domain. Every acquisition we made has been on an industrial basis, forecasting which companies we would like to join us bringing their domain knowledge to our family. Domain knowledge is an incredible value we would like to build into our products. So it comes to how we could make these reality express their full potential into Neosperience products.   
We decided to make Neosperience Cloud the backbone of our products while letting them be great at what they already are with no external constraints. Our microservices architecture and wide adoption of technological standards make us able to provide powerful tools to our teammates. They could make a product more robust and interoperable.

### Neosperience as the backbone of our products

Neosperience Cloud is the foundation of solutions such as Unbreakable Community, Image Memorability and Nudging, and Gamification. We plan to make this happen for every product within our family. In the next months, we are going to expose Neosperience Cloud architectural services and design principles to let other products integrate with us, obtaining a set of ready-to-use AI services while getting seamless integration between every product.

![](https://cdn-images-1.medium.com/max/800/1*SGgidWbv8Wznjgj0uKyKrQ.png)<figcaption>Neosperience Cloud becomes the foundation of Neosperience products, standardizing principles, libraries, and tools to ensure interoperability between our solutions.</figcaption>

In 2020, we plan to let Neosperience become the backbone of our products, developing support among four distinct paths: guidelines, events, architecture, and tools. An ambitious outcome achieved through four pillars: guidelines, events, architecture, and tools.

#### 1. Guidelines

Neosperience Cloud is the expression of many best practices in software engineering carved through the last decade of product development. Such expertise is a value we have to share with our peers. Sometimes these guidelines should be suggested even vigorously because they seem time-consuming at first sight but become valuable in the long run. We propose the adoption of the following modern software development principles:

- a **shared unified Design Library** , to provide our customers with a consistent experience through our solutions. Interaction principles adopt easy to use metaphors, and a consolidated design of UI components makes our user feel comfortable with any of our product flattening the learning curve.
- An architecture made of **microservices** , to encourage integrations either between Neosperience solutions and with 3rd party ecosystem. Microservices allow adopting service composition into new products and projects. Breaking monolithic services into smaller components means increased flexibility and interoperation.
- The use as much as possible of **managed computing resources** as containers or, even better, **serverless** is suggested **.** It avoids the need to manage infrastructure scalability and focus on providing the most value to customers instead of handling servers. This requirement matches a strong focus on cloud providers, especially Amazon Web Services (AWS), which offers a set of quick out-of-the-box services to build modern apps.
- A shared layer for **authentication** is required **,** leveraging [OAuth2](https://oauth.net/2/) to authenticate users and a [**JWT**](https://tools.ietf.org/html/rfc7519) token with a standard structure for **authorization.** The usage of Amazon Cognito is encouraged since it eases the need to write a lot of boilerplate code.
- The support of **events** emitted and consumed by every entity within a product architecture to allow other solutions (either Neosperience or 3rd party) is encouraged. Services can react to them, getting notified of data changes without the need for direct communication. Events represent the preferred way of communication and provide many advantages such as standardization, validation, and fast webhooks development. AWS EventBridge is the reference technology for event handling within Neosperience. Still, in some specific contexts, Apache Kafka, Amazon SNS, or MQTT could be used to support event transport when AWS is not a viable choice.
- An **API First** approach that makes every product expose a set of APIs. We ask our teams to start designing a product or a feature from the business and move downward to its interfaces. If the domain is unclear to _every_ stakeholder, they could use mapping techniques such as [event storming](https://www.eventstorming.com/). Defining APIs means stating what happens between our product and the external world. It also has the benefit of easing a lot of work with integrations because no one has to build them on top, specifically for clients. A robust API strategy also empowers the [separation of concerns](https://en.wikipedia.org/wiki/Separation_of_concerns) and pushes companies to avoid monolithic architectures.

![](https://cdn-images-1.medium.com/max/740/1*IupqPV5LmcOkhkxwPBa29Q.png)<figcaption>A summary of the six pillars within the guidelines domain</figcaption>

These guidelines can be adopted incrementally, having a minimum impact on product roadmap but enable a lot of the benefits we would like to leverage within Neosperience products and 3rd party partners.

#### 2. Interfaces

Integration between different software products means building a mechanism to exchange data between them. Interfaces play a fundamental role because they guarantee a standard communication pattern to transfer data. In Neosperience Cloud, we plan to have two kinds of interfaces: REST APIs and Events.

**Application Programming Interfaces (API)**

Web APIs allow clients to invoke HTTP URLs and obtain data in a _pull_ fashion. [REST](https://en.wikipedia.org/wiki/Representational_state_transfer) emerged in the last few years as a standard for domain entities representation using simple URL paths and HTTP methods (GET, POST, DELETE, PUT). Upon this standard, software developers defined some protocols to overload simple web links into full-fledged APIs. One of the most adopted protocol is **OAuth2** for data access control. Neosperience Cloud exposes its API with a well-documented structure, utilizing a standard fashion to describe API. Every API within Neosperience Core and Business Services should expose a regularly maintained Swagger file, describing API structure and how to invoke any of them: params, expected data in and out as well as authorization support and error codes expected when performing operations.

![](https://cdn-images-1.medium.com/max/1024/1*eb5R4hIyKsC571H1PITghg.png)<figcaption>An example of a Swagger definition of an API</figcaption>

Beside APIs, there is the need to document and also standardize the structure handled by services. Since the de-facto syntax of data follows JSON as a representation protocol, we adopted [JSON-schema](https://json-schema.org/) as its validation language. JSON-like syntax and a defined set of properties describe **semantically** the structure of a payload of data expected or returned by a service within Neosperience Cloud.

![](https://cdn-images-1.medium.com/max/1024/1*xl6AiR-BsNeXnTY70PXgXA.png)<figcaption>An example of JSON-schema to enforce payload structure validation.</figcaption>

**Events**

Web and mobile applications usually interact with a backend service, often via an API. Many frontend applications pass requests for processing, wait for a result, and then display this to the user. A synchronous architecture is only one way to handle messages, but modern applications have alternatives to provide a better user experience.

In recent years, [reactive software architectures](https://www.reactivemanifesto.org/en) obtained a lot of hype due to their strong reliability and the efficient usage of server resources. One of the main cornerstones of reactive designs is to pull API invocations, in favor of message-passing solutions,

Neosperience Cloud has an event-based architecture implementing communication between different services. Each domain entity publishes events in response to state changes. Events are small JSON payloads that resemble a flexible structure.

![](https://cdn-images-1.medium.com/max/1024/1*fEQYlZG0a80r-ObZnpwB9A.png)<figcaption>Example for “product added to cart” event</figcaption>

Neosperience Cloud exposes events for several actions on domain objects: _e-commerce, chatbot, the voice of the customer, notification, user-insight, customer, content, store, profile._

Publishing and subscribing to events allows communication between different services and data synchronization with an [eventual consistency](https://en.wikipedia.org/wiki/Eventual_consistency) pattern. Event-based architectures are preferable to direct remote calls through RPC because they offer many advantages in scalability and fault tolerance as well as allow for interesting patterns such as event sourcing and fan-in / fan-out.

![](https://cdn-images-1.medium.com/max/800/1*RgfFrr5GzVrszbPjgrr3Tg.png)<figcaption>APIs and events represent the interfaces between Neosperience Cloud and Solutions</figcaption>

#### 3. Services

Neosperience Cloud becomes the foundation of any SaaS strategy, offering several ready available infrastructure services that enable cross-cutting behavior between different products. Thanks to the adoption of the **Infrastructure-as-Code (IaC)** pattern, we can leverage AWS capabilities in cloud-native application deployments. The ubiquitous adoption of serverless technologies makes these services readily available, scalable, and cost-effective independently from their usage. We were able to build some infrastructure services that empowered Neosperience Solutions in the last decade and [evolved throughout all the technological advancements of cloud computing](https://medium.com/@aletheia/neosperience-journey-to-microservices-f900277987d5). Today we’re opening up these services to our partners and companies, allowing a fast time-to-market, interoperability with Neosperience existing **business services** such as [Image Memorability](https://www.neosperience.com/solutions/image-memorability/), [Nudging/Gamification](https://www.neosperience.com/solutions/nudging-gamification/), and [Unbreakable Community](https://www.neosperience.com/solutions/unbreakable-community/).

![](https://cdn-images-1.medium.com/max/841/1*CDnrkU4-W01lpSuuBcAPAQ.png)

Specifically, we are going to make our **core** services available such as:

- **nsp-identity** : a service developed specifically to handle service authorization independently from the entity being authorized. You could be a human, a backend service, or a toaster and can call every service with identity, roles, and permissions. Identities implement all **OAuth2** fashion to offer access control to any REST service through _HTTP_ _Authorization_ header tokens. nsp-identity also provides service helpers to get tokens from social accounts, AWS credentials, username and passwords, third party providers, and machine-to-machine. Tokens can also be exchanged between all of them. In 2018, we added support for [Auth0](https://auth0.com/) credential providers, thus enabling 40+ additional providers. It relies on Amazon Cognito Identity management to allow data segregation but adds a standard layer that supports OAuth2 header management, roles, and token standardization through [JSON Web Token (JWT)](https://jwt.io/).
- **nsp-user:** user credentials management is the foundation of many Neosperience services, which is provided as a standard layer on Amazon Cognito User Pools, thus making its internal workflow entirely transparent to services, even when they do not rely on AWS. Moreover, login/registration flow is implemented as well with frontend components wrapping all the required service calls.
- **nsp-organization:** Neosperience built a B2B2C platform, which means data should be segregated within different instances of any service, and a given identity must belong to only one of them. At the same time, a user could join multiple instances. This result is achieved through the development of the Neosperience Organization, which supports multi-tenant data handling and offers the capability to create a new organization, subscribe users, add licenses to them, and org-specific metadata (such as company-wide preferences and configurations) which can be retrieved by specific services. Neosperience Organization makes SaaS scalability independent for its underlying AWS account, thus allowing for multi orgs within the same account which relies on better management of cloud resources.
- **Customer Data Platform (CDP):** is a data platform capable of storing and querying user data even in unstructured form. It supports an event-based collector and management, and data can be stored raw or aggregated in events within a user profile. Users can be queried by their attributes or timelines, thus offering and aggregated time-based evolution of a customer base. CDP support sources such as Salesforce, Shopify, SAP, and many more, as well as Neosperience Solutions, through a number of connectors. Integrations can be leveraged through service APIs, custom events (either published or subscribed by CDP), and [Zapier](https://zapier.com/).
- Neosperience Cloud offers a **service registry** to provide relevant information about deployed microservices. It stores service health and status information about Neosperience as well as third-party services, through a health update and health check event bus and Amazon CloudWatch log analyzer which extracts metrics and usage insights. A **Service Health Dashboard** is offered to publish a summarized overview about service quality for a given account or organization.
- An integrated **Developer Portal** offers third party teams the capability to obtain their Neosperience Cloud AccessKeyId and SecretAccessKey as well as to access service documentation.

On the deployment aspect, we offer to every team support through Neosperience CI/CD architecture, built on [Gitlab](https://about.gitlab.com/) and AWS CloudFormation with [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) and [Serverless Framework](https://www.serverless.com/).

#### 4. Tools

Neosperience aims to become the starting point for product development leveraging serverless technologies and forecast this important duty through an offering than includes not only ready to use services, but also tools to speed up teams building their next product.

Neosperience provides its partners support in adopting the aforementioned guidelines, with a set of **libraries** , offering services middleware, and project bootstrap code to ease starting building stuff. On the frontend, our complete design library offers support to UX/UI development with a consistent look and feels as well as interaction principles. Language-specific **SDK** s are the starting point for teams to integrate our services without the hassle of handling APIs and authentication. We plan to support React, NodeJS, iOS, and Android. Finally, we envision the release of a **Command-Line Input (CLI)** tool to be used by teams to scaffold a new project (either client or service) with middleware, libraries, and our design library with no need to dive into dependency management or library download and built-in support for service deployment within a Neosperience Cloud dedicated instance.

![](https://cdn-images-1.medium.com/max/821/1*meQOWBOgnq2bjFbp24Y6ig.png)

### Where to go from here?

In 2020 Neosperience plans to take a huge leap towards partner ecosystem support while maintaining our strong focus on our solutions making our technology more accessible and inclusive to diverse teams. We value the personal point of view everyone could provide to the ambitious goal of bringing empathy in technology and we can’t wait to see what amazing things our partners are going to build together.

My name is **Luca Bianchi**. I am **Chief Technology Officer** at [**Neosperience**](https://www.neosperience.com/) and, the author of [**Serverless Design Patterns and Best Practices**](https://www.packtpub.com/application-development/serverless-design-patterns-and-best-practices-video). I have built software architectures for production workload at scale on AWS for nearly a decade.

**Neosperience Cloud** is the one-stop SaaS solution for brands aiming to bring _Empathy in Technology_, leveraging innovation in machine learning to provide support for 1:1 customer experiences.

You can contact me via [Twitter](https://twitter.com/bianchiluca) and [LinkedIn](https://www.linkedin.com/in/lucabianchipavia/).