Skip to content

Commit

Permalink
Merge pull request #787 from AdobeDocs/AC-11594-reference-architecture
Browse files Browse the repository at this point in the history
AC-11594: Enterprise architecture blueprint
  • Loading branch information
jeff-matthews authored and GitHub Enterprise committed Mar 24, 2024
2 parents e3f9384 + e16289c commit d33294d
Show file tree
Hide file tree
Showing 29 changed files with 94 additions and 320 deletions.
1 change: 0 additions & 1 deletion help/assets/playbooks/capabilities-map.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/capabilities-modules.svg

This file was deleted.

4 changes: 4 additions & 0 deletions help/assets/playbooks/commerce-architecture-source.svg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions help/assets/playbooks/commerce-architecture-v2.svg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 0 additions & 1 deletion help/assets/playbooks/coupled-storefront-architecture.svg

This file was deleted.

Binary file not shown.
1 change: 0 additions & 1 deletion help/assets/playbooks/headless-benefits.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/headless-diagram.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/headless-evolution-diagram.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/headless-evolution-table.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/headless-storefront-architecture.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/integration-headless.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/integration-monolith.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/integration-options.svg

This file was deleted.

1 change: 0 additions & 1 deletion help/assets/playbooks/journey-to-headless.svg

This file was deleted.

12 changes: 1 addition & 11 deletions help/implementation-playbook/TOC.md
Expand Up @@ -26,24 +26,14 @@ mini-toc-levels: 3
- [Responsibility and ownership](planning/ownership.md)
- [Project governance](planning/governance.md)
- Architecture and integrations {#architecture}
- [Capabilities](architecture/capabilities.md)
- [Integration strategy](architecture/integration-strategy.md)
- [Extensibility strategy](architecture/extensibility-strategy.md)
- [Integration options](architecture/integration-options.md)
- [Enterprise reference](architecture/enterprise-blueprint.md)
- Global reference architecture {#global-reference-architecture}
- [Overview](architecture/global-reference/overview.md)
- [Examples](architecture/global-reference/examples.md)
- Composer development {#composer}
- [Overview](architecture/global-reference/composer/overview.md)
- [Project structure](architecture/global-reference/composer/project-structure.md)
- [Tips and tricks](architecture/global-reference/composer/tips-and-tricks.md)
- Headless commerce {#headless}
- [Benefits](architecture/headless/benefits.md)
- [Journey to headless](architecture/headless/journey-to-headless.md)
- [Microservices](architecture/headless/microservices.md)
- [Evolution of headless](architecture/headless/evolution.md)
- [Coupled storefront architecture](architecture/headless/legacy-storefront.md)
- [Headless architecture](architecture/headless/adobe-commerce.md)
- Infrastructure and deployment {#infrastructure}
- [Overview](infrastructure/overview.md)
- Self Hosting {#self-hosting}
Expand Down
32 changes: 0 additions & 32 deletions help/implementation-playbook/architecture/capabilities.md

This file was deleted.

74 changes: 74 additions & 0 deletions help/implementation-playbook/architecture/enterprise-blueprint.md
@@ -0,0 +1,74 @@
---
title: Enterprise reference architecture
description: Learn how to implement Adobe Commerce using Adobe's latest composable commerce technology.
feature: App Builder, Cloud, GraphQL, Integration, Paas, Saas
---

# Adobe Commerce enterprise reference architecture

Adobe Commerce is the experience-led platform that uniquely pairs technical flexibility with ease of use, all in service of creating exceptional experiences that drive business results.

Commerce has evolved to meet enterprise requirements for performance, scale, and security. Adopting a modern implementation approach that uses Adobe's latest composable commerce solutions is critical to the success of enterprise businesses. This page describes the modern Commerce implementation approach in technical detail.

The following architecture diagram illustrates the data flow between Adobe Commerce and all Adobe Experience Cloud solutions.

![Architectural diagram showing how Adobe Commerce connects to Experience Cloud solutions](../../assets/playbooks/commerce-architecture-v2.svg){zoomable="yes"}

>[!NOTE]
>
>The high-level data flows shown in the diagram are consistent across most enterprise implementations. The key component that can make implementations unique is the way you build your catalog (especially for B2B). You should carefully map your catalog architecture to the [Commerce web APIs](https://developer.adobe.com/commerce/webapi/get-started/).
## Cloud foundation

[Adobe Commerce on cloud infrastructure](https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/overview) is the foundation of your Commerce implementation. It provides a [secure](../../security-and-compliance/shared-responsibility.md) automated hosting platform with a self-service approach to building, deploying, monitoring, and managing your Commerce application in a cloud-native environment.

See the following cloud foundation technical details:

- [**Scaled architecture**](https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/architecture/scaled-architecture)—Automatically adjusted capacity to maintain steady, predictable performance
- [**Multiple environments**](https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/architecture/pro-architecture)—Pre-provisioned with PHP, MySQL (MariaDB), Redis, RabbitMQ, and supported search engine technologies to develop, test, and deploy your site
- [**Configuration management**](https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/configure/overview)—Customizable environment configuration files and command-line interface (CLI) to manage application settings, routes, build and deploy actions, and notifications.
- [**Git-based workflow**](https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/architecture/pro-develop-deploy-workflow)—Automatically build and deploy after pushing code changes for rapid development and continuous deployment
- [**Built-in observability**](https://experienceleague.adobe.com/en/docs/commerce-cloud-service/user-guide/monitor/performance)—Tools that combine log data from multiple sources to help you manage your site's performance and diagnose issues
- [**Comprehensive API coverage**](https://developer.adobe.com/commerce/webapi/get-started/)[GraphQL](https://developer.adobe.com/commerce/webapi/graphql/) and [REST](https://developer.adobe.com/commerce/webapi/rest) APIs for integrating the core Commerce application with third-party systems and extending Commerce capabilities

## Integration with Experience Cloud

Adobe Commerce integrates with all Experience Cloud solutions to deliver [personalized commerce experiences at scale](https://experienceleague.adobe.com/en/docs/commerce-admin/customers/customers-menu/personalize-scale#customers-menu).

[Data Connection](https://experienceleague.adobe.com/en/docs/commerce-merchant-services/data-connection/overview) unlocks insights about your shoppers' buying behavior so that you can create personalized shopping experiences across all channels with other Adobe Digital Experience products.

>[!NOTE]
>
>See [Digital Experience blueprints](https://experienceleague.adobe.com/en/docs/blueprints-learn/architecture/overview) for more technical detail.

## Integration with third-party systems

Adobe provides developers with comprehensive extension points and tools to build applications that extend core Commerce capabilities and integrate Commerce with third-party systems (such as CRMs, ERPS, and PIMS). These tools reduce your total cost of ownership of the platform in the following ways:

- **Scalability**—Applications can be scaled separately from the core software, allowing for greater efficiency and simplified upgrades.
- **Isolation**–An isolated environment means that developers can upgrade or modify their extensions at their discretion without relying on a core release.
- **Technological independence**–Developers can choose whichever technology stacks and coding languages that fit their needs.

Adobe provides the following developer tools for building integrations and customizations:

- [**API Mesh for Adobe Developer App Builder**](https://developer.adobe.com/graphql-mesh-gateway/)—Coordinate and combine multiple API, GraphQL, REST, and other sources into a single, queryable GraphQL endpoint.
- [**App Builder**](https://developer.adobe.com/app-builder/docs/overview/)—Build and deploy secure and scalable web applications that extend Commerce functionality and integrate with third-party solutions.
- [**Events**](https://developer.adobe.com/commerce/extensibility/events/)—Use custom event triggers to interact with other extensible development tools.
- [**Webhooks**](https://developer.adobe.com/commerce/extensibility/webhooks/)—Use webhooks to automatically trigger interactions between Commerce and third-party systems.
- [**Admin UI SDK**](https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/)—Customize and enhance the Commerce Admin with new pages and features for your merchants.

## Storefront services

Adobe provides a rich set of intelligent, composable merchandizing services to help you support your key business goals. These services also provide APIs that are critical to optimizing performance at scale.

- [Live Search](https://experienceleague.adobe.com/en/docs/commerce-merchant-services/live-search/overview)—Deliver smarter, faster and relevant results for shoppers with this AI-powered search tool.
- [Product Recommendations](https://experienceleague.adobe.com/en/docs/commerce-merchant-services/product-recommendations/overview)—Add AI-fueled recommendations based on shopper behavior, popular trends, product similarity, and more.
- [Catalog Service](https://experienceleague.adobe.com/en/docs/commerce-merchant-services/catalog-service/guide-overview)—Give your customers an optimized product experience while boosting performance, improving scalability, and increasing conversions.
- [Payment Services](https://experienceleague.adobe.com/en/docs/commerce-merchant-services/payment-services/guide-overview)—Drive customer satisfaction by offering various payment methods, including interest-free payment installments, and a single view into payment processing, orders, and invoices.

## Headless storefront

Headless commerce is API-first commerce. Adobe Commerce is fully headless with a decoupled architecture that provides all commerce services and data through a GraphQL API layer. This architecture allows teams to develop their frontends independently from the core application, providing the agility to quickly build and test new touchpoints with emerging technologies.

Adobe provides a modern headless storefront technology that includes the same benefits and capabilities delivered by [Edge Delivery Services](https://www.aem.live/home) with document-based authoring, a performance-first architecture, and out-of-the-box native experimentation. It leverages the scale and performance of Adobe Commerce [storefront services](#storefront-services) and the flexibility and convenience of [drop-in components](https://experienceleague.adobe.com/developer/commerce/storefront/) to deliver commerce capabilities.

This file was deleted.

0 comments on commit d33294d

Please sign in to comment.