Add the Cohesivo SaaS guide

docs/ibexa_products/cohesivo_saas_guide.md

@@ -0,0 +1,181 @@
+---
+description: Learn about all the main attributes, features, and benefits of the [[= product_name =]] SaaS version.
+month_change: false
+---
+
+# [[= product_name =]] SaaS product guide
+
+## What is [[= product_name =]] SaaS?
+
+[[= product_name =]] SaaS is the fully managed version of [[= product_name =]] for organizations that want to manage their content through the [[= product_name =]] back office and deliver it to websites and other digital channels through APIs.
+
+[[= product_name =]] SaaS is a good solution when you don't need custom platform code or heavy customization.
+It's designed for medium-sized mid-market B2B teams that run several brand sites across multiple languages.
+[[= product_name =]] SaaS is headless-only - you input and manage content through the back office, and deliver it through the REST and MCP APIs.
+An agency or in-house team can build the front end, for example, in Next.js, and host it independently of [[= product_name =]] SaaS.
+
+[[= product_name_base =]] operates the infrastructure and the application, while you provide the content and build your front end.
+You can configure everything that the back office exposes, including content types, Page Builder blocks, layout overrides, site settings, and other available configuration.
+
+There's no PHP to write, no Composer packages to install, no database scripts to run, and no server or filesystem access.
+
+## Availability
+
+To access the [[= product_name =]] SaaS instance, [contact the sales team](https://www.ibexa.co/about-ibexa/contact-us), who prepare a demo environment, and later provision the first account with administrator permissions during onboarding.
+The environment is ready for you within a single working day.
+Your administrator can then invite other members of the team, up to the number of seats included in the plan.
+
+To start using [[= product_name =]] SaaS, you need to purchase a product license.
+For more information, see [[[= product_name_base =]] license pricing](https://www.ibexa.co/products/pricing).
+
+## How does [[= product_name =]] SaaS work?
+
+[[= product_name =]] SaaS is a multi-tenant setup.
+Each organization uses an isolated database, search core, cache, and asset storage.
+[[= product_name_base =]] SSO provides preconfigured identity management and automatic user provisioning.
+Under the bonnet, [[= product_name_base =]] runs the infrastructure on [Upsun](https://upsun.com/) systems located in the EU and takes care of automatic upgrades, backups, disaster recovery, and monitoring.
+
+![[[= product_name =]] SaaS framework](img/saas_framework_purple.png "[[= product_name =]] SaaS framework")
+
+You access a single environment, which is always a production one.
+While there are no staging or preview environments, you can limit access to different parts of the content structure by using [user permissions]([[= user_doc =]]/permission_management/permission_system/).
+It's the same approach that is present in PaaS and on-premise projects, where you grant users access rights on the need-to-see basis, rather than by creating separate environments.
+
+From the administrator's standpoint, all configuration is done through the back office.
+This includes [content types]([[= user_doc =]]/content_management/content_model/), [Page Builder blocks]([[= user_doc =]]/content_management/block_reference/) and [layouts]([[= user_doc =]]/content_management/configure_ct_field_settings/#available-page-layouts) exposed by the available configuration screens.
+
+Content is authored in the back office and delivered through the REST API and MCP server, with both interfaces secured out-of-the-box with OAuth2.
+Once you've received the first administrator account created, you can start setting up the content model, creating content and making it available through the APIs.
+
+![[[= product_name =]] SaaS operating principle](img/saas_principle_purple.png "[[= product_name =]] SaaS operating principle")
+
+You're free to build and host your front end on a framework of your choice, which means that [[= product_name_base =]] can't estimate or control the time required to build the data-consuming application.
+
+## Capabilities
+
+The following capabilities are available to every [[= product_name =]] SaaS customer.
+Some capabilities integrate with other products in the wider [[= product_name_base =]] portfolio.
+In these cases, the integrated product, such as [[= product_name_cdp_base =]], [[= pim_product_name =]] or [[= product_name_engage =]], requires its own license.
+
+### Site Factory
+
+Configure, instantiate and manage websites [from the back office]([[= user_doc =]]/website_organization/work_with_sites/).
+Sites can share content and assets, while granular [user permissions]([[= user_doc =]]/permission_management/permission_system/) can be used to control access to particular parts of the content tree.
+
+### Agentic AI
+
+With [AI Assistant]([[= user_doc =]]/content_management/create_edit_content_items/#ai-assistant) as the entry point, you can use an [MCP tool set](mcp_usage.md#use-built-in-tools) identical across the [[= product_name_base =]] ecosystem.
+The MCP server allows AI tools and agents to interact with [[= product_name =]] capabilities through a standardized interface rather than requiring a separate integration for each agent or tool.
+
+### Secured remote MCP endpoint
+
+[[= product_name =]] SaaS provides a secured, bi-directional MCP server out of the box.
+[AI agents](mcp_guide.md) can use the available tools to retrieve information from [[= product_name =]] SaaS and, where supported, return modified content to the SaaS tenant.
+
+### Automated translation
+
+Translate your content with [language management tools]([[= user_doc =]]/content_management/translate_content/#manage-translation-services-and-language-pairs) such as AI-assisted machine translation, and use a [side-by-side editing view]([[= user_doc =]]/content_management/translate_content/#side-by-side-translation-view) to review and edit translated content.
+
+### Product catalog
+
+Use the built-in Product Information Management (PIM) capability to manage products and their specifications, attributes, variants, assets, pricing, availability, categories, catalogs, and completeness scoring.
+You can use the product catalog independently within [[= product_name =]] SaaS, or connect it to third-party commerce platforms, including [[[= pim_product_name =]]](https://www.quable.com/en).
+When the [[= pim_product_name =]] connector is enabled, you can view, select and embed its products in [[= product_name =]] SaaS, while you handle product management operations in [[= pim_product_name =]].
+
+### [[= product_name_cdp =]] integration
+
+The Raptor connector provides an integration with the [Raptor recommendation engine](https://www.raptorservices.com/) and [Customer Data Platform](https://www.raptorservices.com/) to help you deliver personalized experiences across digital channels.
+
+### Rich-text editing
+
+Use the advanced rich-text editing tools, such as the [Headless Page Builder]([[= user_doc =]]/content_management/create_edit_pages/).
+
+### Back office-based configuration
+
+Configure your instance by setting up Content Types and Page Builder through back-office features.
+Compared to other variants of the [[= product_name =]] range, there's no need to maintain YAML configuration or deploy platform changes.
+
+### Webhooks
+
+Transfer data to and from [[= product_name =]] SaaS in real time.
+
+### Migration and growth
+
+If you're an existing [[= product_name_base =]] customer and have a PaaS or on-premise [[= product_name =]] installation, or you're on a competitive solution, and you find [[= product_name =]] SaaS attractive, [[= product_name_base =]] Professional Services and/or Certified Partners can help you draw a migration path and support you throughout the process.
+[[= product_name =]] comes equipped with multiple remote APIs that can be used to streamline the migration where appropriate.
+
+In the future, should your project grow and need to be custom-tailored with broader than out-of-the-box functionality, migration to PaaS or on-premise installation is straightforward because [[= product_name =]] SaaS uses the same codebase and content model.
+
+
+## Benefits
+
+[[= product_name =]] SaaS lets you focus on managing digital content and experiences without having to operate the [[= product_name =]] platform itself.
+[[= product_name_base =]] takes care of the application and infrastructure, while you manage your content, configuration, and frontend applications.
+
+### No platform team required
+
+With configuration through the back office, you don't have to worry about platform code changes, deployments or infrastructure maintenance.
+[[= product_name_base =]] operates the application and underlying infrastructure, including upgrades, backups, disaster recovery, and monitoring.
+Your team can focus on content, configuration and the frontend applications that consume it.
+
+### Short time-to-value
+
+Onboarding is handled internally and can happen within one working day, including provisioning the tenant and setting up the first administrator account.
+From that point, you can start creating content immediately, and content can be consumed through the APIs as soon as it's available.
+While a complete client-facing website may take more time to be live, we call it "same-day time-to-first-content".
+
+### One platform for multiple sites and languages
+
+Site Factory, content management and language management features provide a common back office for organizations that manage several websites and languages.
+You can share content and assets across sites, while you use granular user permissions to control access to particular parts of the content tree.
+
+### Enterprise-grade reliability without overhead
+
+[[= product_name =]] SaaS provides minimal downtime, 24/7 support, backups and disaster recovery up to the [[[= product_name_base =]] Cloud](https://www.ibexa.co/products/ibexa-cloud) standard, together with managed infrastructure and monitoring.
+You don't have to provision or maintain the infrastructure yourself.
+
+### Secured APIs and MCP endpoint
+
+The REST API and MCP endpoints are secured and tenant-scoped out of the box.
+The authentication layer is provided by [[= product_name_base =]], so you don't have to deal with its configuration.
+
+### True multi-tenancy
+
+Each organization or tenant has isolated data, search and cache, as well as their own asset storage.
+This way you can use the service without having to operate a dedicated [[= product_name =]] infrastructure yourself.
+
+### Preconfigured identity
+
+[[= product_name_base =]] SSO provides preconfigured identity management and automatic user provisioning.
+Identity management is therefore available as part of the SaaS setup, so you don't need to configure it specifically for [[= product_name =]].
+
+### Faster access to new capabilities
+
+[[= product_name =]] SaaS follows the fastest release cycle, so new features land here before they reach PaaS and on-premise customers.
+
+### EU data residency
+
+[[= product_name =]] SaaS is always hosted on infrastructure located in the EU, ensuring strict legal compliance with the GDPR.
+This data residency model is specifically targeted at organizations that need to protect themselves from regulatory penalties, foreign government surveillance, and the loss of customer trust.
+
+Even if your company is located outside of the EU, it's a benefit rather than a limitation, as customers from anywhere in the world experience the same level of protection.
+
+## Use case
+
+### Mid-market B2B organization with multiple brand sites
+
+An EU-based hotelier company runs several boutique accommodations that are primarily targeted at B2B customers.
+A marketing team that consists of twelve people manages several websites that advertise their aesthetically distinct venues.
+Each of the websites is dedicated to a different clientele, but all must be available in multiple languages.
+With primarily visual storytelling in focus, websites that present photo galleries, room layouts, amenities, and dining menus, don't require custom code.
+At the same time, individual customer profiles can contain sensitive data, so the company prefers to use secure EU data residency.
+
+[[= product_name_base =]] provisions and manages the [[= product_name =]] SaaS instance.
+The company receives administrator access during onboarding.
+It can then invite the remaining users up to the number of seats included in their licensing plan.
+With [[= product_name =]] SaaS, the marketing team can add and edit content, and handle other configuration through the back office.
+The team can manage their websites through the Site Factory, share content and media assets between them where appropriate, and set user permissions to distinguish offerings and presences according to visitor type.
+Translation management tools help support the languages, while the available content and Page Builder templates allow the team to structure the sites without having to maintain any code.
+
+The company's digital agency builds the websites and hosts them independently.
+The agency builds and maintains Next.js-based front ends and consumes the content that comes from [[= product_name =]] through the REST API.

docs/ibexa_products/img/saas_framework.drawio

@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2026-09-15T19:16:35.124Z" agent="5.0 (Macintosh; Intel Mac OS X 26_5_2) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/14.6.13 Chrome/89.0.4389.128 Electron/12.0.7 Safari/537.36" etag="U2Z5LSRjscxJKYjftQtj" version="14.6.13" type="device"><diagram id="cohesivo-saas" name="Cohesivo SaaS">7Vptd6I4FP41PWf3QzkkvOYjIrTOttojOrv7aU4KKXIGiRNwbOfXb4JBpWItXa1du34Ac/N28+S5NzcJF5o7fbxieDa5pRFJL6AaPV5o3QsIgWlr/CUkT1ICVLCUxCyJpGwtCJJfRApVKZ0nEclrBQtK0yKZ1YUhzTISFjUZZowu6sUeaFrvdYZjsiUIQpxuS/9MomJSDcNE64xrksQT2bUNrWXGFFeF5UjyCY7oYkOkeReayygtlv+mjy5JBXoVLst6/o7clWKMZMVrKqQAkS/zVA+efpDJDHxZXAXDSyjn5ydO53LEUtviqYIgZnQ+k8UIK8hjE/D4viqubisGVsPlRCF0Sgr2xIvIhjSoaBLNNUuW6cUG5NC0FFN2OtlAHNqyMJZTHa96WKPB/0hA2oAD3gOcF+ZlG7LXAAL0YwEC0OkA2cGhDUBQNe6Dg1GQDHPttsduprybTjKNRQfpskvzx1yYdGeeE3Yp0ahkAioW1opNikK4MkcoA/2IhkpyTx6xElKeJBl/GAofgl+Q6SzFRZLFIrFI4m8P8ywsEpp9Y+SBcPhCwnNKXfyE45zz91oHJf8ZKzNRea2LGct3OYp7Vkluxzej3t2Nx9N4OuOC7D4Xr5HXd/qjYGvKeftZRARWgJda+TmRWEySggQzHIqiC75GlCOepjL7IUlTl6aUlQ1pXeQ5XU20UTD6nVQ5Gc2IKEyzYqOwWv6kXC4cAFZpqZ3oRNAw4R7dSZM447KCCi2wTIWcd4SVOLyKiCsbeE7uE3GzWUnrZIa6xGenswfCZ+nQNqzlU4c1z29uO36k6oq1UcfaBtI6mI33ciqMjGYtjT3CHCqck9OZeqVBG0PvBYMbZ+R1t3O6zsjpOIG3x9abzLtm/7tt3YO+2kVbts5zHNQFtvdKgwctLNfawfYXLZdbqaAfZ+HyaR+HfjnBLJzsYV2Y4jyvUWpKI5xecgoUYuyb5JMNVxKSpZjFJOpNRcB7MpYuh9mGo4HnDN3rT8pDmcudoIIQMqBmq+XT3vKS70TTEIcT8glYyvjktGGp67jXn9VZyly9Ye1+J1ZyvpEiP3taJqL7Nqx0gsDbG6+fOS1Nu+470alI2rytVT/cjlo2j4z16cIGWBo41kYmibi+SfF09mYsNuWtovSu1x/1Rn8fcd/d9Tq+9bH33StLaRW9H4+ueU7PnqkpDb+3YmrH+4trogbB4A2Lzgv8ND3dV5vWGbOLPK/TYp2pWcnhqVflGvtONYDWQMxDLDMzRn8mOZ/Xcqp3EHQ9ZedG2fLEE0dRG9qOA2/I9bwbDr72gt6g3+tffXL6mqfjb/MQ4OnCpB03MdVVVRM2O29m4CHipOyB4auNwZ7v+hOmdN5oyRvzXgnDpfWI5YfF978BVWBzATmc6rP/v4tE2Yqwrsu8NC9RjzvPx9f4i7sbZ+QPhre8Sq/vD51gNBy7o/Fw3wHAv4jQfNcz3O4Hj9DgDut74zXmIYylUVHjdM4Evuh3oanoqm3owJS//W643LwiiEC9xiaQxgFwnM/y+b47kf/9zZH8zfguGPd5eW/8/Eb2oGGK7/vQdZvCFM/s2CuHss/RqG8MU4wd5rbndsZUNA0i2wAGsoGlacfif8yw+BCp3bVg+QXSpax8Ol7X1GgVGd9dDZ2u95YjxDPgWeWVdSTurJENbcu0AKw4dgIa3uPwO3fFLVn4sS+nG3zrMz8JwOv8ZMdx/+C+8lOTVUdIgRAh07AMTYe6aZ6MrFGS41xEkOceNuSThKStThyGnjv46g33HemeN1Ut3VZsXUe6bWoq0Mymm5n3YeqUZklB2UsnZufC1XCCWXGZJlmrOOB20O+NBsNDH4z91xiLkK3oBkIaMFTT1tG7BQI8uf5QvMzb+N5e8/4B</diagram></mxfile>

docs/ibexa_products/img/saas_framework_purple.drawio

@@ -0,0 +1 @@
+<mxfile host="Electron" agent="5.0 (Macintosh; Intel Mac OS X 26_5_2) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/14.6.13 Chrome/89.0.4389.128 Electron/12.0.7 Safari/537.36" modified="2026-09-18T08:09:26.764Z" version="14.6.13" etag="tKvRzLSwtRzuZBr4VUTU" type="device"><diagram name="Tenants &amp; Infrastructure" id="n1116">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</diagram></mxfile>