DOC-2305: Solution Architect Guide (#40420)

* DOC-2305: Solution Architecture Guide

Author: kisakova

_themes/sphinx_rtd_theme/header.html

@@ -14,13 +14,15 @@
 {% if 'user/storefront' in pagename %}
 {%- set current_subitem = "storefront" %}
 {% endif %}
-{% if 'user/glossary' in pagename %}
-{%- set current_subitem = "glossary" %}
-{% endif %}
 {% if 'user/integrations' in pagename %}
 {%- set current_subitem = "integrations" %}
 {% endif %}
-
+{% if 'user/solution-artchitect' in pagename %}
+{%- set current_subitem = "solution-architect" %}
+{% endif %}
+{% if 'user/glossary' in pagename %}
+{%- set current_subitem = "glossary" %}
+{% endif %}
 {% if 'backend' in pagename %}
 {%- set current_item = "developers" %}
 {%- set current_subitem = "backend" %}
@@ -41,7 +43,6 @@
 {%- set current_item = "developers" %}
 {%- set current_subitem = "community" %}
 {% endif %}
-
 {% if 'cloud' in pagename %}
 {%- set current_item = "cloud" %}
 {% endif %}
@@ -169,6 +170,15 @@
                                         </span>
                                         </a>
                                     </li>
+                                    <li class="header__menu-list_desc level2-link  menu-item menu-item-type-custom menu-item-object-custom "
+                                        role="none">
+                                        <a href="{{ version_pref }}/user/solution-architect/"
+                                           class=" menu-item menu-item-type-custom menu-item-object-custom header__menu-link {{ 'current-menu-item' if 'solution-architect' == current_subitem }}"
+                                           role="menuitem">Solution Architecture<span class="header__menu-desc">Learn about the OroCommerce
+                                            architecture, integration points, and the infrastructure to implement it.
+                                        </span>
+                                        </a>
+                                    </li>
                                 </ul>
                                 <div class="header__menu-item banner">
                                     <div class="header__banner-content">

_themes/sphinx_rtd_theme/site-links.html

@@ -15,6 +15,7 @@ <h2><span>Business Users</span></h2>
     </div>
     <div class="footer-box">
       <ul>
+        <li><a href="{{ pathto(link_prefix ~ 'user/solution-architect/index') }}">Solution Architecture</a></li>
         <li><a href="{{ pathto(link_prefix ~ 'user/concept-guides/index') }}">Concept Guides</a></li>
         <li><a href="{{ pathto(link_prefix ~ 'user/back-office/index') }}">Back-Office</a></li>
         <li><a href="{{ pathto(link_prefix ~ 'user/storefront/index') }}">Commerce Storefront</a></li>

_themes/sphinx_rtd_theme/static/css/redesign.css

@@ -867,7 +867,7 @@ body {
     padding-right: 15px;
 }
 .showcase-section .showcase-section-heading {
-    background: #cf8109 linear-gradient(to right, #cf8109 0%,#ed930d 100%);
+    background: #7A6036 linear-gradient(to right, #B48C50 0%,#ECDFCB 100%);
     padding-top: 25px;
     padding-bottom: 115px;
     margin: 0 0 -98px;

cloud/security/index.rst

@@ -23,6 +23,8 @@ The following diagram illustrates the network segmentation of a typical Oro appl
 .. image:: /cloud/img/production_network_highlevel_public_diagram.png
    :alt: The network segmentation of an average Oro application deployment in OroCloud environment
 
+.. _cloud_security-application-subnet:
+
 Application Subnet
 ^^^^^^^^^^^^^^^^^^
 

cloud/support.rst

@@ -31,6 +31,8 @@ Oro support team continues to put in all possible efforts to provide an initial
 * 24 business hours for P2-P4 issues
 * 4 hours for P1 issues
 
+.. _cloud_support-process:
+
 Support Process
 ---------------
 

developer/index.rst

@@ -14,6 +14,11 @@ Developer Documentation
 
 Developer Documentation is intended for developers and contains information about OroPlatform architecture, guidance on customization and extension of the existing features in Oro applications. Browse the how-to articles to learn about configuration and setup necessary for development or future use of the application.
 
+.. raw:: html
+
+   <h2><a href="../solution-architect/">Solution Architecture</a></h2>
+   <p>The guide outlines the application concepts, architecture, integration points, and the necessary cloud and infrastructure required for the seamless implementation and integration of the OroCommerce application.</p>
+
 .. raw:: html
 
    <h2><a href="../backend/">Backend Developer Guide</a></h2>

img/solution-architect/1-permision-levels.png

@@ -6484,6 +6484,10 @@ Links (Dev)
 
     <a href="https://developer.mozilla.org/en-US/docs/Web/Privacy/Privacy_sandbox/Partitioned_cookies" target="_blank">Partitioned Cookies</a>
 
+.. |semantic versioning| raw:: html
+
+    <a href="https://semver.org/" target="_blank">semantic versioning</a>
+
 .. |AddressValidationBundle| raw:: html
 
     <a href="https://github.com/oroinc/customer-portal/tree/master/src/Oro/Bundle/AddressValidationBundle" target="_blank">AddressValidationBundle</a>

img/solution-architect/10-multi-level-config.png

@@ -1004,4 +1004,16 @@ Links (User)
 
 .. |MS Admin Panel|  raw:: html
 
-   <a href="https://admin.microsoft.com/" target="_blank">MS Admin Panel</a>
+   <a href="https://admin.microsoft.com/" target="_blank">MS Admin Panel</a>
+
+.. |Customer Management|  raw:: html
+
+   <a href="https://hive.oroinc.com/course/customer-management/" target="_blank">Customer Management</a>
+
+.. |Product Management|  raw:: html
+
+   <a href="https://hive.oroinc.com/course/product-management/" target="_blank">Product Management</a>
+
+.. |Sales Management|  raw:: html
+
+   <a href="https://hive.oroinc.com/course/sales-management/" target="_blank">Sales Management</a>

img/solution-architect/11-integration-points.png

@@ -1,5 +1,7 @@
 :title: Oro Application Back-Office User Documentation
 
+.. _user-guide--back-office:
+
 .. meta::
    :description: Back-office manuals for the Oro application and OroMarketplace users
 

img/solution-architect/12-integration-points-elements.png

@@ -5,8 +5,7 @@
 Configure Global Settings for Order External Status Management
 ==============================================================
 
-In addition to managing :ref:`an internal order status <user-guide--sales--orders>`, you can also manage an order status in an external system. By default, an external system cannot
-change the order status. To enable a modification of an external order status:
+In addition to managing :ref:`an internal order status <user-guide--sales--orders>`, you can also manage an order status in an external system. By default, an external system cannot change the order status. To enable a modification of an external order status:
 
 1. Navigate to **System > Configuration** in the main menu.
 2. Select **Commerce > Orders > Order Status Management** in the menu to the left.

img/solution-architect/13-integration-example.png

@@ -1,5 +1,7 @@
 :title: System Configuration Management in the Oro Application Back-Office
 
+.. _user-guide-system-setting:
+
 .. meta::
    :description: Extensive manuals on the Oro application back-office system configuration
 

img/solution-architect/14-implementation-approach.png

@@ -15,6 +15,15 @@ Oro User Documentation is split into five sections, each delivering user-specifi
 .. raw:: html
 
     <ul class="icons-list">
+         <li>
+            <div class="icon">
+                <img src="../_static/images/icon-business-users.png" alt="" role="presentation">
+            </div>
+            <div class="items-body">
+                <p class="first"><a class="reference internal" href="solution-architect/"><span class="std std-ref">Solution Architecture</span></a></p>
+                <p> Solution Architecture guide offers an overview of the application concepts, architectural framework, and key integration points that are essential for the successful deployment and integration of the OroCommerce application.</p>
+            </div>
+        </li>
         <li>
             <div class="icon">
                 <img src="../_static/images/business-and-finance.svg" alt="" role="presentation">
@@ -73,6 +82,7 @@ Oro User Documentation is split into five sections, each delivering user-specifi
    :titlesonly:
    :maxdepth: 7
 
+   solution-architect/index
    concept-guides/index
    back-office/index
    storefront/index

img/solution-architect/15-environment-diagram.png

@@ -1,5 +1,7 @@
 :title: OroCommerce Integrations Documentation
 
+.. _business-users--integrations:
+
 .. meta::
    :description: Integrations documentation for the Oro application users