You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@unomi.apache.org by sh...@apache.org on 2026/07/17 12:13:25 UTC
(unomi-site) branch UNOMI-932-unomi3-major-release-story updated (876fc75 -> fb5eba3)
This is an automated email from the ASF dual-hosted git repository.
sergehuber pushed a change to branch UNOMI-932-unomi3-major-release-story
in repository https://gitbox.apache.org/repos/asf/unomi-site.git
from 876fc75 Set up default protection ruleset for default and release branches (#41)
new cc8ad4e Prep site for Unomi 3.1 GA story (UNOMI-932)
new 99ac7ea Add Unomi 3 quality/ops blog wave with SVGs (UNOMI-932)
new c695e4d Fix shell blog examples to match live Unomi 3 CRUD syntax (UNOMI-932)
new 45d33cc Fix Unomi 3.1 site examples against live API behavior (UNOMI-932)
new fb5eba3 feat: add Unomi 3 in numbers blog, CDN/Matomo charts, and Netlify preview (UNOMI-932)
The 5 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.gitignore | 1 +
README.md | 107 ++++
netlify.toml | 13 +
preview.sh | 306 ++++++++++
src/main/webapp/_data/unomi.yml | 30 +-
src/main/webapp/_layouts/default.html | 11 +-
src/main/webapp/assets/css/unomi.css | 75 ++-
.../assets/images/unomi3/ai-agents-unomi.svg | 79 +++
.../images/unomi3/api-stability-v2compat.svg | 73 +++
.../assets/images/unomi3/architecture-flow.svg | 72 +++
src/main/webapp/assets/images/unomi3/build-sh.svg | 89 +++
.../images/unomi3/extensions-architecture.svg | 69 +++
.../images/unomi3/it-progress-before-after.svg | 123 ++++
.../assets/images/unomi3/manual-plantuml-theme.svg | 94 +++
.../webapp/assets/images/unomi3/multitenancy.svg | 83 +++
.../assets/images/unomi3/numbers-contributors.svg | 76 +++
.../assets/images/unomi3/numbers-downloads-map.svg | 75 +++
.../assets/images/unomi3/numbers-downloads.svg | 53 ++
.../webapp/assets/images/unomi3/numbers-hero.svg | 74 +++
.../webapp/assets/images/unomi3/numbers-loc.svg | 78 +++
.../webapp/assets/images/unomi3/numbers-tests.svg | 83 +++
.../images/unomi3/numbers-visits-countries.svg | 60 ++
.../webapp/assets/images/unomi3/numbers-visits.svg | 31 +
.../assets/images/unomi3/openapi-enrichment.svg | 77 +++
.../assets/images/unomi3/opensearch-dual.svg | 67 +++
.../assets/images/unomi3/platform-foundation.svg | 73 +++
.../assets/images/unomi3/request-tracing.svg | 65 +++
.../webapp/assets/images/unomi3/shell-commands.svg | 80 +++
.../webapp/assets/images/unomi3/task-scheduler.svg | 71 +++
.../assets/images/unomi3/unit-harness-vs-it.svg | 70 +++
.../webapp/assets/images/unomi3/unomi3-journey.svg | 85 +++
.../images/unomi3/usecase-centralized-profiles.svg | 73 +++
.../webapp/assets/images/unomi3/usecase-mobile.svg | 65 +++
.../assets/images/unomi3/usecase-multitenancy.svg | 62 ++
.../images/unomi3/usecase-web-personalization.svg | 57 ++
src/main/webapp/blog/index.html | 633 +++++++++++++++++++++
.../webapp/blog/introducing-apache-unomi-3.html | 58 ++
src/main/webapp/blog/migrating-to-unomi-3.html | 42 ++
src/main/webapp/blog/unomi-3-ai-agents.html | 51 ++
src/main/webapp/blog/unomi-3-build-sh.html | 86 +++
src/main/webapp/blog/unomi-3-in-numbers.html | 139 +++++
src/main/webapp/blog/unomi-3-it-execution.html | 103 ++++
src/main/webapp/blog/unomi-3-manual.html | 109 ++++
src/main/webapp/blog/unomi-3-multitenancy.html | 61 ++
.../webapp/blog/unomi-3-openapi-enrichment.html | 77 +++
src/main/webapp/blog/unomi-3-opensearch.html | 82 +++
.../webapp/blog/unomi-3-platform-foundation.html | 57 ++
src/main/webapp/blog/unomi-3-request-tracing.html | 199 +++++++
src/main/webapp/blog/unomi-3-shell-commands.html | 219 +++++++
src/main/webapp/blog/unomi-3-task-scheduler.html | 109 ++++
.../webapp/blog/unomi-3-unit-testing-harness.html | 91 +++
.../blog/welcome-to-the-apache-unomi-blog.html | 44 ++
src/main/webapp/community/events/index.html | 2 +-
src/main/webapp/documentation.html | 37 +-
src/main/webapp/download.html | 6 +-
src/main/webapp/get-started.html | 262 +++++++--
src/main/webapp/index.html | 273 +++++----
src/main/webapp/integrations.html | 29 +-
src/main/webapp/llms-full.txt | 164 ++++--
src/main/webapp/llms.txt | 63 +-
src/main/webapp/resources.html | 2 +-
src/main/webapp/sitemap.xml | 156 ++++-
src/main/webapp/stories.html | 2 +-
src/main/webapp/tutorial.html | 230 +++++---
src/main/webapp/use-cases.html | 81 ++-
65 files changed, 5620 insertions(+), 447 deletions(-)
create mode 100644 netlify.toml
create mode 100755 preview.sh
create mode 100644 src/main/webapp/assets/images/unomi3/ai-agents-unomi.svg
create mode 100644 src/main/webapp/assets/images/unomi3/api-stability-v2compat.svg
create mode 100644 src/main/webapp/assets/images/unomi3/architecture-flow.svg
create mode 100644 src/main/webapp/assets/images/unomi3/build-sh.svg
create mode 100644 src/main/webapp/assets/images/unomi3/extensions-architecture.svg
create mode 100644 src/main/webapp/assets/images/unomi3/it-progress-before-after.svg
create mode 100644 src/main/webapp/assets/images/unomi3/manual-plantuml-theme.svg
create mode 100644 src/main/webapp/assets/images/unomi3/multitenancy.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-contributors.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-downloads-map.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-downloads.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-hero.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-loc.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-tests.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-visits-countries.svg
create mode 100644 src/main/webapp/assets/images/unomi3/numbers-visits.svg
create mode 100644 src/main/webapp/assets/images/unomi3/openapi-enrichment.svg
create mode 100644 src/main/webapp/assets/images/unomi3/opensearch-dual.svg
create mode 100644 src/main/webapp/assets/images/unomi3/platform-foundation.svg
create mode 100644 src/main/webapp/assets/images/unomi3/request-tracing.svg
create mode 100644 src/main/webapp/assets/images/unomi3/shell-commands.svg
create mode 100644 src/main/webapp/assets/images/unomi3/task-scheduler.svg
create mode 100644 src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg
create mode 100644 src/main/webapp/assets/images/unomi3/unomi3-journey.svg
create mode 100644 src/main/webapp/assets/images/unomi3/usecase-centralized-profiles.svg
create mode 100644 src/main/webapp/assets/images/unomi3/usecase-mobile.svg
create mode 100644 src/main/webapp/assets/images/unomi3/usecase-multitenancy.svg
create mode 100644 src/main/webapp/assets/images/unomi3/usecase-web-personalization.svg
create mode 100644 src/main/webapp/blog/index.html
create mode 100644 src/main/webapp/blog/introducing-apache-unomi-3.html
create mode 100644 src/main/webapp/blog/migrating-to-unomi-3.html
create mode 100644 src/main/webapp/blog/unomi-3-ai-agents.html
create mode 100644 src/main/webapp/blog/unomi-3-build-sh.html
create mode 100644 src/main/webapp/blog/unomi-3-in-numbers.html
create mode 100644 src/main/webapp/blog/unomi-3-it-execution.html
create mode 100644 src/main/webapp/blog/unomi-3-manual.html
create mode 100644 src/main/webapp/blog/unomi-3-multitenancy.html
create mode 100644 src/main/webapp/blog/unomi-3-openapi-enrichment.html
create mode 100644 src/main/webapp/blog/unomi-3-opensearch.html
create mode 100644 src/main/webapp/blog/unomi-3-platform-foundation.html
create mode 100644 src/main/webapp/blog/unomi-3-request-tracing.html
create mode 100644 src/main/webapp/blog/unomi-3-shell-commands.html
create mode 100644 src/main/webapp/blog/unomi-3-task-scheduler.html
create mode 100644 src/main/webapp/blog/unomi-3-unit-testing-harness.html
create mode 100644 src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html
(unomi-site) 01/05: Prep site for Unomi 3.1 GA story (UNOMI-932)
Posted by sh...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
sergehuber pushed a commit to branch UNOMI-932-unomi3-major-release-story
in repository https://gitbox.apache.org/repos/asf/unomi-site.git
commit cc8ad4e7a4d9e1146e6e61565cf4acec0aa8e98f
Author: Serge Huber <sh...@apache.org>
AuthorDate: Tue Jul 14 09:55:46 2026 +0200
Prep site for Unomi 3.1 GA story (UNOMI-932)
Pin versions and content to 3.1.0 with multi-tenancy and AI messaging,
Docker-first get-started, blog posts, and SVG diagrams — keep local until
release so CI does not publish early.
---
src/main/webapp/_data/unomi.yml | 30 ++-
src/main/webapp/_layouts/default.html | 9 +-
src/main/webapp/assets/css/unomi.css | 27 ++
.../assets/images/unomi3/ai-agents-unomi.svg | 79 ++++++
.../images/unomi3/api-stability-v2compat.svg | 73 ++++++
.../assets/images/unomi3/architecture-flow.svg | 72 ++++++
.../images/unomi3/extensions-architecture.svg | 69 ++++++
.../webapp/assets/images/unomi3/multitenancy.svg | 83 +++++++
.../assets/images/unomi3/unit-harness-vs-it.svg | 70 ++++++
.../webapp/assets/images/unomi3/unomi3-journey.svg | 85 +++++++
.../images/unomi3/usecase-centralized-profiles.svg | 73 ++++++
.../webapp/assets/images/unomi3/usecase-mobile.svg | 65 +++++
.../assets/images/unomi3/usecase-multitenancy.svg | 62 +++++
.../images/unomi3/usecase-web-personalization.svg | 57 +++++
src/main/webapp/blog/index.html | 198 +++++++++++++++
.../webapp/blog/introducing-apache-unomi-3.html | 51 ++++
src/main/webapp/blog/migrating-to-unomi-3.html | 35 +++
src/main/webapp/blog/unomi-3-ai-agents.html | 44 ++++
src/main/webapp/blog/unomi-3-multitenancy.html | 54 ++++
.../blog/welcome-to-the-apache-unomi-blog.html | 37 +++
src/main/webapp/community/events/index.html | 2 +-
src/main/webapp/documentation.html | 37 +--
src/main/webapp/download.html | 6 +-
src/main/webapp/get-started.html | 247 +++++++++++++++----
src/main/webapp/index.html | 273 ++++++++++++---------
src/main/webapp/integrations.html | 29 +--
src/main/webapp/llms-full.txt | 155 ++++++++----
src/main/webapp/llms.txt | 62 +++--
src/main/webapp/resources.html | 2 +-
src/main/webapp/sitemap.xml | 101 +++++---
src/main/webapp/stories.html | 2 +-
src/main/webapp/tutorial.html | 188 +++++++++-----
src/main/webapp/use-cases.html | 81 +++---
33 files changed, 2030 insertions(+), 428 deletions(-)
diff --git a/src/main/webapp/_data/unomi.yml b/src/main/webapp/_data/unomi.yml
index a7b5a77..4c2c57b 100644
--- a/src/main/webapp/_data/unomi.yml
+++ b/src/main/webapp/_data/unomi.yml
@@ -1,15 +1,33 @@
latest:
stable:
- version: 3.0.0
- date: 2025-11-10
+ version: 3.1.0
+ # Set to the real GA calendar date when you publish the site with the release.
+ date: 2026-07-14
+ jira_version_id: "12356384"
development:
- version: 3.1.0-SNAPSHOT
+ version: 3.2.0-SNAPSHOT
next:
+ # Next version for contrib release-guide templates (post-3.1.0).
stable:
- version: 3.1.0
+ version: 3.2.0
development:
- version: 3.1.0-SNAPSHOT
+ version: 3.2.0-SNAPSHOT
+previous:
+ stable:
+ version: 3.0.0
+ date: 2025-11-10
+ jira_version_id: "12355172"
branch:
version: master
doc:
- version: master
+ # Published docs folder name (manual/3_1_x) after docs are deployed with the release.
+ version: 3_1_x
+manual:
+ published_stable: "https://unomi.apache.org/manual/3_1_x/index.html"
+ published_latest: "https://unomi.apache.org/manual/latest/index.html"
+ whats_new: "https://unomi.apache.org/manual/latest/index.html#_whats_new_3_1"
+ quick_start: "https://unomi.apache.org/manual/latest/index.html#_quick_start"
+ multitenancy: "https://unomi.apache.org/manual/latest/index.html#_multitenancy"
+ v2_compat: "https://unomi.apache.org/manual/latest/index.html#_v2_compatibility_mode"
+ es_to_os: "https://unomi.apache.org/manual/latest/index.html#_migrate_from_elasticsearch_to_opensearch"
+ security: "https://unomi.apache.org/manual/latest/index.html#_securing_a_production_environment"
diff --git a/src/main/webapp/_layouts/default.html b/src/main/webapp/_layouts/default.html
index fb50c71..bc6aad3 100644
--- a/src/main/webapp/_layouts/default.html
+++ b/src/main/webapp/_layouts/default.html
@@ -111,7 +111,10 @@
"Full REST/JSON API",
"GraphQL API for flexible querying",
"Plugin architecture (OSGi, Groovy actions)",
- "Elasticsearch storage backend (OpenSearch support coming soon)",
+ "Elasticsearch storage backend (OpenSearch supported in Unomi 3.1)",
+ "True multi-tenancy with public/private API keys (major Unomi 3.1 platform refactor)",
+ "AI-agent-ready customer memory (retrieve, store, summarize, segment)",
+ "V2 API compatibility mode for upgrades from Unomi 2.x",
"Connectors (MailChimp, custom via plugin API)",
"Bill of Materials (BOM) for dependency management",
"OASIS CDP standard reference implementation"
@@ -208,6 +211,9 @@
<li class="nav-item">
<a class="nav-link fw-medium" href="/get-started.html">Get Started</a>
</li>
+ <li class="nav-item">
+ <a class="nav-link fw-medium" href="/blog/">Blog</a>
+ </li>
<!-- Documentation Dropdown -->
<li class="nav-item dropdown">
@@ -294,6 +300,7 @@
<li class="mb-2"><a href="/get-started.html" class="footer-link">Getting Started</a></li>
<li class="mb-2"><a href="/get-started.html#quickstart" class="footer-link">Quick Start</a></li>
<li class="mb-2"><a href="/download.html" class="footer-link">Download</a></li>
+ <li class="mb-2"><a href="/blog/" class="footer-link">Blog</a></li>
<li class="mb-2"><a href="/integrations.html" class="footer-link">Integrations</a></li>
</ul>
</div>
diff --git a/src/main/webapp/assets/css/unomi.css b/src/main/webapp/assets/css/unomi.css
index c5a1971..b1abb69 100644
--- a/src/main/webapp/assets/css/unomi.css
+++ b/src/main/webapp/assets/css/unomi.css
@@ -334,6 +334,15 @@ textarea:focus-visible,
transform: translateY(-1px);
}
+/* Same contrast guards for homepage hero */
+.hero .text-muted,
+.hero .text-secondary,
+.hero .text-body,
+.hero .text-dark {
+ color: var(--unomi-hero-muted) !important;
+}
+
+
/* ---------- Sections ---------- */
.section {
padding: 5rem 0;
@@ -791,6 +800,24 @@ code {
max-width: 40rem;
}
+/* Bootstrap muted/body/dark utilities are for light surfaces — force contrast on purple headers */
+.page-header .text-muted,
+.page-header .text-secondary,
+.page-header .text-body,
+.page-header .text-dark {
+ color: var(--unomi-hero-muted) !important;
+}
+
+.page-header a:not(.btn) {
+ color: var(--unomi-hero-link);
+ text-decoration: underline;
+ text-underline-offset: 2px;
+}
+
+.page-header a:not(.btn):hover {
+ color: var(--unomi-white);
+}
+
/* ---------- Version badges ---------- */
.version-card {
border: 1px solid var(--unomi-border);
diff --git a/src/main/webapp/assets/images/unomi3/ai-agents-unomi.svg b/src/main/webapp/assets/images/unomi3/ai-agents-unomi.svg
new file mode 100644
index 0000000..01df366
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/ai-agents-unomi.svg
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 900 320" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="AI agents read and write customer context through Apache Unomi 3">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .flow-rev { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite reverse; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.flow-rev,.float,.glow { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="900" height="320" rx="20" fill="var(--unomi-primary-subtle)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">AI agents ↔ Apache Unomi 3</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Retrieve context · store memory · summarize profiles · build segments — with consent</text>
+
+ <!-- Agent -->
+ <g class="float">
+ <rect x="40" y="100" width="200" height="160" rx="18" fill="var(--unomi-primary)" class="glow"/>
+ <text x="140" y="140" text-anchor="middle" fill="var(--unomi-white)" font-size="15" font-weight="700">AI Agent / LLM</text>
+ <text x="140" y="168" text-anchor="middle" fill="var(--unomi-on-dark)" font-size="12">copilots · MCP tools</text>
+ <text x="140" y="196" text-anchor="middle" fill="var(--unomi-on-dark)" font-size="12">chat · recommend · act</text>
+ <text x="140" y="230" text-anchor="middle" fill="var(--unomi-accent)" font-size="11" font-weight="600">read + write</text>
+ </g>
+
+ <!-- arrows -->
+ <line x1="250" y1="150" x2="340" y2="150" stroke="var(--unomi-primary)" stroke-width="2.5" class="flow"/>
+ <text x="295" y="138" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="11" font-weight="600">retrieve</text>
+ <line x1="340" y1="210" x2="250" y2="210" stroke="var(--unomi-accent)" stroke-width="2.5" class="flow-rev"/>
+ <text x="295" y="232" text-anchor="middle" fill="var(--unomi-accent)" font-size="11" font-weight="600">write / act</text>
+
+ <!-- Unomi core -->
+ <rect x="350" y="90" width="220" height="180" rx="18" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="460" y="125" text-anchor="middle" fill="var(--unomi-text)" font-size="15" font-weight="700">Unomi 3 CDP</text>
+ <text x="460" y="150" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">REST · GraphQL</text>
+ <text x="460" y="178" text-anchor="middle" fill="var(--unomi-text)" font-size="12">profiles · events</text>
+ <text x="460" y="200" text-anchor="middle" fill="var(--unomi-text)" font-size="12">segments · rules</text>
+ <text x="460" y="222" text-anchor="middle" fill="var(--unomi-text)" font-size="12">consent gates</text>
+ <text x="460" y="248" text-anchor="middle" fill="var(--unomi-success)" font-size="11" font-weight="600">privacy-first memory</text>
+
+ <!-- capabilities -->
+ <g class="float" style="animation-delay:.4s">
+ <rect x="610" y="95" width="250" height="42" rx="12" fill="var(--unomi-white)" stroke="var(--unomi-border)"/>
+ <text x="735" y="121" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">Personalize with live context</text>
+ </g>
+ <g class="float" style="animation-delay:.6s">
+ <rect x="610" y="150" width="250" height="42" rx="12" fill="var(--unomi-white)" stroke="var(--unomi-border)"/>
+ <text x="735" y="176" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">Store agent observations</text>
+ </g>
+ <g class="float" style="animation-delay:.8s">
+ <rect x="610" y="205" width="250" height="42" rx="12" fill="var(--unomi-white)" stroke="var(--unomi-border)"/>
+ <text x="735" y="231" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">Summarize → profile props</text>
+ </g>
+ <g class="float" style="animation-delay:1s">
+ <rect x="610" y="260" width="250" height="42" rx="12" fill="var(--unomi-white)" stroke="var(--unomi-border)"/>
+ <text x="735" y="286" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">Build / query segments</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/api-stability-v2compat.svg b/src/main/webapp/assets/images/unomi3/api-stability-v2compat.svg
new file mode 100644
index 0000000..253751a
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/api-stability-v2compat.svg
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 320" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3 API stability: all 119 OpenAPI 2.x paths retained plus V2 compatibility mode">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ @keyframes dot-move { 0%{offset-distance:0%;opacity:0} 10%{opacity:1} 90%{opacity:1} 100%{offset-distance:100%;opacity:0} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="840" height="320" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Stable REST · additive growth</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">119 / 119 documented 2.x OpenAPI paths retained in 3.1</text>
+
+ <!-- outer 3.1 surface -->
+ <rect x="40" y="90" width="480" height="190" rx="20" fill="var(--unomi-primary-light)" stroke="var(--unomi-primary)" stroke-width="2" class="pulse"/>
+ <text x="60" y="118" fill="var(--unomi-primary-dark)" font-size="13" font-weight="700">Unomi 3.1 OpenAPI surface</text>
+ <text x="60" y="138" fill="var(--unomi-text-muted)" font-size="12">131 paths · 179 operations</text>
+
+ <!-- inner 2.x retained -->
+ <rect x="70" y="158" width="300" height="96" rx="14" fill="var(--unomi-white)" stroke="var(--unomi-success)" stroke-width="2.5"/>
+ <text x="220" y="195" text-anchor="middle" fill="var(--unomi-success)" font-size="28" font-weight="700">119 / 119</text>
+ <text x="220" y="222" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="600">2.x paths retained (100%)</text>
+
+ <!-- additive badge -->
+ <g class="float">
+ <rect x="390" y="170" width="110" height="72" rx="14" fill="var(--unomi-accent)" opacity=".92"/>
+ <text x="445" y="202" text-anchor="middle" fill="var(--unomi-white)" font-size="22" font-weight="700">+12</text>
+ <text x="445" y="224" text-anchor="middle" fill="var(--unomi-white)" font-size="11">new paths</text>
+ </g>
+
+ <!-- V2 bridge panel -->
+ <rect x="560" y="90" width="240" height="190" rx="20" fill="var(--unomi-white)" stroke="var(--unomi-amber)" stroke-width="2"/>
+ <rect x="560" y="90" width="240" height="40" rx="20" fill="var(--unomi-amber-bg)"/>
+ <rect x="560" y="110" width="240" height="20" fill="var(--unomi-amber-bg)"/>
+ <text x="680" y="116" text-anchor="middle" fill="var(--unomi-amber)" font-size="13" font-weight="700">V2 compatibility mode</text>
+ <text x="680" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="600">Phased client migration</text>
+ <text x="680" y="192" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">legacy auth bridge</text>
+ <text x="680" y="214" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">+ default tenant</text>
+ <text x="680" y="248" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">disable when ready</text>
+
+ <line x1="520" y1="185" x2="560" y2="185" stroke="var(--unomi-amber)" stroke-width="2" class="flow"/>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/architecture-flow.svg b/src/main/webapp/assets/images/unomi3/architecture-flow.svg
new file mode 100644
index 0000000..e0c68ff
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/architecture-flow.svg
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 920 260" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Data flows into Apache Unomi via REST and out to personalization, scoring, and AI agents">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.float { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="920" height="260" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="36" fill="var(--unomi-text)" font-size="16" font-weight="700">How Apache Unomi works</text>
+ <text x="40" y="56" fill="var(--unomi-text-muted)" font-size="12">Sources → REST API → profiles, segments, rules → actions</text>
+
+ <!-- sources -->
+ <g class="float">
+ <rect x="40" y="90" width="100" height="44" rx="12" fill="var(--unomi-primary)"/>
+ <text x="90" y="117" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Web</text>
+ </g>
+ <g class="float" style="animation-delay:.2s">
+ <rect x="40" y="146" width="100" height="44" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="90" y="173" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Mobile</text>
+ </g>
+ <g class="float" style="animation-delay:.4s">
+ <rect x="40" y="202" width="100" height="40" rx="12" fill="var(--unomi-hero-accent)"/>
+ <text x="90" y="227" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">CRM · IoT</text>
+ </g>
+
+ <line x1="150" y1="160" x2="210" y2="160" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+
+ <!-- core -->
+ <rect x="220" y="90" width="360" height="140" rx="18" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="400" y="122" text-anchor="middle" fill="var(--unomi-text)" font-size="14" font-weight="700">Apache Unomi</text>
+ <text x="400" y="148" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">REST API · Processing</text>
+ <text x="400" y="172" text-anchor="middle" fill="var(--unomi-text)" font-size="12">Profiles · Segmentation · Rules</text>
+ <text x="400" y="200" text-anchor="middle" fill="var(--unomi-accent)" font-size="12" font-weight="600">Privacy & consent</text>
+
+ <line x1="590" y1="160" x2="650" y2="160" stroke="var(--unomi-accent)" stroke-width="2" class="flow"/>
+
+ <!-- outputs -->
+ <g class="float">
+ <rect x="660" y="90" width="220" height="40" rx="12" fill="var(--unomi-accent)"/>
+ <text x="770" y="115" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Personalization</text>
+ </g>
+ <g class="float" style="animation-delay:.25s">
+ <rect x="660" y="142" width="220" height="40" rx="12" fill="var(--unomi-primary)"/>
+ <text x="770" y="167" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Scoring · Export</text>
+ </g>
+ <g class="float" style="animation-delay:.5s">
+ <rect x="660" y="194" width="220" height="40" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="770" y="219" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">AI Agents</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/extensions-architecture.svg b/src/main/webapp/assets/images/unomi3/extensions-architecture.svg
new file mode 100644
index 0000000..aabcb00
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/extensions-architecture.svg
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 900 260" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Groovy actions and Java plugins extend Unomi through the plugin API into products and services">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ --unomi-success: #059669;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.float { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="900" height="260" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="32" y="36" fill="var(--unomi-text)" font-size="15" font-weight="700">Extend Apache Unomi</text>
+ <text x="32" y="56" fill="var(--unomi-text-muted)" font-size="12">Groovy / Java plugins → Plugin API → core → products & services</text>
+
+ <text x="110" y="88" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11" font-weight="600">EXTEND</text>
+ <g class="float">
+ <rect x="40" y="100" width="140" height="48" rx="12" fill="var(--unomi-primary)"/>
+ <text x="110" y="130" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Groovy Actions</text>
+ </g>
+ <g class="float" style="animation-delay:.2s">
+ <rect x="40" y="164" width="140" height="48" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="110" y="194" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Java Plugins</text>
+ </g>
+
+ <line x1="190" y1="156" x2="250" y2="156" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+
+ <text x="360" y="88" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11" font-weight="600">APACHE UNOMI</text>
+ <g class="float" style="animation-delay:.25s">
+ <rect x="260" y="100" width="200" height="120" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="360" y="145" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Plugin API</text>
+ <text x="360" y="172" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">Core Engine</text>
+ <text x="360" y="196" text-anchor="middle" fill="var(--unomi-accent)" font-size="11" font-weight="600">Profiles · Rules · Events</text>
+ </g>
+
+ <line x1="470" y1="156" x2="530" y2="156" stroke="var(--unomi-accent)" stroke-width="2" class="flow"/>
+
+ <text x="690" y="88" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11" font-weight="600">PRODUCTS & SERVICES</text>
+ <g class="float">
+ <rect x="540" y="100" width="120" height="40" rx="12" fill="var(--unomi-accent)"/>
+ <text x="600" y="125" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">UI</text>
+ </g>
+ <g class="float" style="animation-delay:.2s">
+ <rect x="680" y="100" width="160" height="40" rx="12" fill="var(--unomi-primary)"/>
+ <text x="760" y="125" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">SaaS</text>
+ </g>
+ <g class="float" style="animation-delay:.4s">
+ <rect x="540" y="160" width="300" height="48" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="690" y="190" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Analytics & integrations</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/multitenancy.svg b/src/main/webapp/assets/images/unomi3/multitenancy.svg
new file mode 100644
index 0000000..bda6c76
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/multitenancy.svg
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 300" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Multi-tenancy: API keys map clients to isolated tenant data in Elasticsearch or OpenSearch">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ @keyframes dot-move { 0%{offset-distance:0%;opacity:0} 10%{opacity:1} 90%{opacity:1} 100%{offset-distance:100%;opacity:0} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="840" height="300" rx="20" fill="var(--unomi-primary-subtle)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Multi-tenancy in Unomi 3.1</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Public / private API keys → tenant boundary → isolated profiles & events</text>
+
+ <!-- clients -->
+ <g class="float">
+ <rect x="40" y="110" width="120" height="56" rx="12" fill="var(--unomi-primary)"/>
+ <text x="100" y="144" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Client A</text>
+ </g>
+ <g class="float" style="animation-delay:.5s">
+ <rect x="40" y="186" width="120" height="56" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="100" y="220" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Client B</text>
+ </g>
+
+ <line x1="160" y1="138" x2="220" y2="170" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+ <line x1="160" y1="214" x2="220" y2="190" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+
+ <!-- gateway -->
+ <rect x="220" y="130" width="160" height="100" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2" class="glow"/>
+ <text x="300" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">API keys</text>
+ <text x="300" y="190" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">public / private</text>
+ <text x="300" y="210" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">tenant resolve</text>
+
+ <line x1="380" y1="180" x2="430" y2="180" stroke="var(--unomi-accent)" stroke-width="2.5" class="flow"/>
+
+ <!-- tenants -->
+ <rect x="430" y="100" width="160" height="70" rx="14" fill="var(--unomi-accent)" opacity=".9"/>
+ <text x="510" y="130" text-anchor="middle" fill="var(--unomi-white)" font-size="14" font-weight="700">Tenant A</text>
+ <text x="510" y="150" text-anchor="middle" fill="var(--unomi-white)" font-size="11">profiles · events · rules</text>
+
+ <rect x="430" y="190" width="160" height="70" rx="14" fill="var(--unomi-hero-accent)" opacity=".95"/>
+ <text x="510" y="220" text-anchor="middle" fill="var(--unomi-white)" font-size="14" font-weight="700">Tenant B</text>
+ <text x="510" y="240" text-anchor="middle" fill="var(--unomi-white)" font-size="11">isolated data plane</text>
+
+ <line x1="590" y1="135" x2="640" y2="160" stroke="var(--unomi-text-muted)" stroke-width="2" class="flow"/>
+ <line x1="590" y1="225" x2="640" y2="200" stroke="var(--unomi-text-muted)" stroke-width="2" class="flow"/>
+
+ <rect x="640" y="120" width="160" height="120" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-border)" stroke-width="1.5"/>
+ <text x="720" y="160" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">ES or OS</text>
+ <text x="720" y="184" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">shared cluster</text>
+ <text x="720" y="206" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">tenant-aware</text>
+ <text x="720" y="226" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">indexes / filters</text>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg b/src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg
new file mode 100644
index 0000000..043fdcd
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 340" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unit tests with InMemoryPersistenceServiceImpl versus full integration tests">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ @keyframes dot-move { 0%{offset-distance:0%;opacity:0} 10%{opacity:1} 90%{opacity:1} 100%{offset-distance:100%;opacity:0} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="840" height="340" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Two layers of quality</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">New in Unomi 3: fast unit tests that do not need Karaf or Elasticsearch</text>
+
+ <!-- Unit track -->
+ <g>
+ <rect x="40" y="90" width="360" height="210" rx="18" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="60" y="122" fill="var(--unomi-success)" font-size="14" font-weight="700">UNIT · seconds</text>
+ <rect x="60" y="140" width="320" height="44" rx="12" fill="var(--unomi-white)" class="glow"/>
+ <text x="220" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="600">InMemoryPersistenceServiceImpl</text>
+ <text x="80" y="210" fill="var(--unomi-text)" font-size="12">→ TestHelper wires real *ServiceImpl</text>
+ <text x="80" y="232" fill="var(--unomi-text)" font-size="12">→ conditions · refresh simulation</text>
+ <text x="80" y="254" fill="var(--unomi-text)" font-size="12">→ no Docker · no Karaf boot</text>
+ <text x="80" y="280" fill="var(--unomi-success)" font-size="12" font-weight="600">Independent · high-signal</text>
+ </g>
+
+ <!-- IT track -->
+ <g>
+ <rect x="440" y="90" width="360" height="210" rx="18" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="460" y="122" fill="var(--unomi-info)" font-size="14" font-weight="700">INTEGRATION · minutes+</text>
+ <rect x="460" y="140" width="140" height="44" rx="12" fill="var(--unomi-white)" class="float"/>
+ <text x="530" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">Karaf</text>
+ <rect x="620" y="140" width="160" height="44" rx="12" fill="var(--unomi-white)" class="float" style="animation-delay:.4s"/>
+ <text x="700" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">ES / OpenSearch</text>
+ <text x="480" y="210" fill="var(--unomi-text)" font-size="12">→ Pax Exam + Docker stack</text>
+ <text x="480" y="232" fill="var(--unomi-text)" font-size="12">→ full REST · clustering · tenants</text>
+ <text x="480" y="254" fill="var(--unomi-text)" font-size="12">→ proves the live platform</text>
+ <text x="480" y="280" fill="var(--unomi-info)" font-size="12" font-weight="600">End-to-end confidence</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/unomi3-journey.svg b/src/main/webapp/assets/images/unomi3/unomi3-journey.svg
new file mode 100644
index 0000000..1a5a5e4
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/unomi3-journey.svg
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 280" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Apache Unomi 3 journey from 2.x platform foundation to 3.1 product features">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ @keyframes dot-move { 0%{offset-distance:0%;opacity:0} 10%{opacity:1} 90%{opacity:1} 100%{offset-distance:100%;opacity:0} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+
+ <linearGradient id="j-bg" x1="0" y1="0" x2="840" y2="280" gradientUnits="userSpaceOnUse">
+ <stop stop-color="var(--unomi-primary-subtle)"/>
+ <stop offset="1" stop-color="var(--unomi-bg-soft)"/>
+ </linearGradient>
+ </defs>
+ <rect width="840" height="280" rx="20" fill="url(#j-bg)"/>
+ <text x="40" y="42" fill="var(--unomi-text)" font-size="18" font-weight="700">Apache Unomi 3 — release journey</text>
+ <text x="40" y="64" fill="var(--unomi-text-muted)" font-size="13">One major story: platform (3.0) + product leap (3.1)</text>
+
+ <!-- spine -->
+ <line x1="80" y1="160" x2="760" y2="160" stroke="var(--unomi-primary)" stroke-width="3" class="flow" opacity=".45"/>
+
+ <!-- 2.x -->
+ <g class="float">
+ <rect x="60" y="110" width="150" height="100" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-border)" stroke-width="1.5"/>
+ <text x="135" y="142" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12" font-weight="600">LAST 2.x</text>
+ <text x="135" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="20" font-weight="700">2.7</text>
+ <text x="135" y="190" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Java 11 · ES7</text>
+ </g>
+
+ <!-- 3.0 -->
+ <g class="float" style="animation-delay:.3s">
+ <rect x="290" y="100" width="180" height="120" rx="18" fill="var(--unomi-primary)" class="glow"/>
+ <text x="380" y="132" text-anchor="middle" fill="var(--unomi-on-dark)" font-size="12" font-weight="600">FOUNDATION</text>
+ <text x="380" y="160" text-anchor="middle" fill="var(--unomi-white)" font-size="22" font-weight="700">3.0</text>
+ <text x="380" y="186" text-anchor="middle" fill="var(--unomi-on-dark)" font-size="11">Karaf 4.4 · ES9 · Java 17+ min</text>
+ <text x="380" y="204" text-anchor="middle" fill="var(--unomi-on-dark)" font-size="11">persistence clustering</text>
+ </g>
+
+ <!-- 3.1 -->
+ <g class="float" style="animation-delay:.6s">
+ <rect x="560" y="90" width="220" height="140" rx="18" fill="var(--unomi-white)" stroke="var(--unomi-accent)" stroke-width="2.5"/>
+ <rect x="560" y="90" width="220" height="36" rx="18" fill="var(--unomi-accent)"/>
+ <rect x="560" y="108" width="220" height="18" fill="var(--unomi-accent)"/>
+ <text x="670" y="114" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="700">PRODUCT LEAP</text>
+ <text x="670" y="150" text-anchor="middle" fill="var(--unomi-text)" font-size="22" font-weight="700">3.1</text>
+ <text x="670" y="174" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Multi-tenancy · OpenSearch</text>
+ <text x="670" y="192" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Tasks · V2 compat · unit harness</text>
+ <text x="670" y="212" text-anchor="middle" fill="var(--unomi-success)" font-size="11" font-weight="600">current stable</text>
+ </g>
+
+ <!-- arrows labels -->
+ <text x="245" y="150" text-anchor="middle" fill="var(--unomi-primary)" font-size="11" font-weight="600">upgrade</text>
+ <text x="510" y="150" text-anchor="middle" fill="var(--unomi-accent)" font-size="11" font-weight="600">+ features</text>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/usecase-centralized-profiles.svg b/src/main/webapp/assets/images/unomi3/usecase-centralized-profiles.svg
new file mode 100644
index 0000000..017399f
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/usecase-centralized-profiles.svg
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 720 300" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="CRM, forum, CMS, and commerce feed Unomi to build a unified profile">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ --unomi-success: #059669;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.float { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="720" height="300" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="32" y="36" fill="var(--unomi-text)" font-size="15" font-weight="700">Centralized profiles</text>
+ <text x="32" y="56" fill="var(--unomi-text-muted)" font-size="12">Many systems → one unified customer view</text>
+
+ <g class="float">
+ <rect x="40" y="90" width="100" height="40" rx="12" fill="var(--unomi-primary)"/>
+ <text x="90" y="115" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">CRM</text>
+ </g>
+ <g class="float" style="animation-delay:.15s">
+ <rect x="40" y="142" width="100" height="40" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="90" y="167" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Forum</text>
+ </g>
+ <g class="float" style="animation-delay:.3s">
+ <rect x="40" y="194" width="100" height="40" rx="12" fill="var(--unomi-hero-accent)"/>
+ <text x="90" y="219" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">CMS</text>
+ </g>
+ <g class="float" style="animation-delay:.45s">
+ <rect x="40" y="246" width="100" height="36" rx="12" fill="var(--unomi-accent)"/>
+ <text x="90" y="269" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Commerce</text>
+ </g>
+
+ <line x1="150" y1="170" x2="220" y2="170" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+
+ <g class="float" style="animation-delay:.2s">
+ <rect x="230" y="120" width="220" height="100" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="340" y="165" text-anchor="middle" fill="var(--unomi-text)" font-size="14" font-weight="700">Apache Unomi</text>
+ <text x="340" y="190" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">Identity merge · REST</text>
+ </g>
+
+ <line x1="460" y1="170" x2="520" y2="170" stroke="var(--unomi-accent)" stroke-width="2" class="flow"/>
+
+ <g class="float">
+ <rect x="530" y="100" width="150" height="56" rx="14" fill="var(--unomi-accent)"/>
+ <text x="605" y="134" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Unified Profile</text>
+ </g>
+ <g class="float" style="animation-delay:.25s">
+ <rect x="530" y="172" width="150" height="40" rx="12" fill="var(--unomi-primary)"/>
+ <text x="605" y="197" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Segments</text>
+ </g>
+ <g class="float" style="animation-delay:.4s">
+ <rect x="530" y="226" width="150" height="40" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="605" y="251" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Export / Sync</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/usecase-mobile.svg b/src/main/webapp/assets/images/unomi3/usecase-mobile.svg
new file mode 100644
index 0000000..905e2bb
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/usecase-mobile.svg
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 720 280" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Mobile app and beacons send events to Unomi for profiles, segments, and scores">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ --unomi-success: #059669;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.float { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="720" height="280" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="32" y="36" fill="var(--unomi-text)" font-size="15" font-weight="700">Mobile analytics</text>
+ <text x="32" y="56" fill="var(--unomi-text-muted)" font-size="12">Apps & beacons → Unomi → profiles, segments, scores</text>
+
+ <g class="float">
+ <rect x="40" y="100" width="130" height="56" rx="14" fill="var(--unomi-primary)"/>
+ <text x="105" y="134" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Mobile App</text>
+ </g>
+ <g class="float" style="animation-delay:.25s">
+ <rect x="40" y="180" width="130" height="48" rx="14" fill="var(--unomi-hero-accent)"/>
+ <text x="105" y="209" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Beacons</text>
+ </g>
+ <line x1="180" y1="128" x2="250" y2="150" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+ <line x1="180" y1="204" x2="250" y2="170" stroke="var(--unomi-hero-accent)" stroke-width="2" class="flow"/>
+
+ <g class="float" style="animation-delay:.35s">
+ <rect x="260" y="110" width="200" height="90" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="360" y="150" text-anchor="middle" fill="var(--unomi-text)" font-size="14" font-weight="700">Apache Unomi</text>
+ <text x="360" y="174" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">Auth + Events (REST)</text>
+ </g>
+
+ <line x1="470" y1="155" x2="520" y2="155" stroke="var(--unomi-accent)" stroke-width="2" class="flow"/>
+
+ <g class="float">
+ <rect x="530" y="90" width="150" height="40" rx="12" fill="var(--unomi-accent)"/>
+ <text x="605" y="115" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Profiles</text>
+ </g>
+ <g class="float" style="animation-delay:.2s">
+ <rect x="530" y="142" width="150" height="40" rx="12" fill="var(--unomi-primary)"/>
+ <text x="605" y="167" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Segments</text>
+ </g>
+ <g class="float" style="animation-delay:.4s">
+ <rect x="530" y="194" width="150" height="40" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="605" y="219" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Scoring</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/usecase-multitenancy.svg b/src/main/webapp/assets/images/unomi3/usecase-multitenancy.svg
new file mode 100644
index 0000000..84a663d
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/usecase-multitenancy.svg
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 720 260" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="One Unomi cluster hosting isolated tenants for SaaS and agency deployments">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ --unomi-success: #059669;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.float { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="720" height="260" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="32" y="36" fill="var(--unomi-text)" font-size="15" font-weight="700">Multi-tenant / SaaS CDP</text>
+ <text x="32" y="56" fill="var(--unomi-text-muted)" font-size="12">One cluster · many isolated tenants · public & private API keys</text>
+
+ <g class="float">
+ <rect x="40" y="100" width="140" height="48" rx="12" fill="var(--unomi-primary)"/>
+ <text x="110" y="130" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Customer A</text>
+ </g>
+ <g class="float" style="animation-delay:.2s">
+ <rect x="40" y="160" width="140" height="48" rx="12" fill="var(--unomi-primary-dark)"/>
+ <text x="110" y="190" text-anchor="middle" fill="var(--unomi-white)" font-size="12" font-weight="600">Customer B</text>
+ </g>
+
+ <line x1="190" y1="150" x2="250" y2="150" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+
+ <g class="float" style="animation-delay:.3s">
+ <rect x="260" y="90" width="200" height="120" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-accent)" stroke-width="2.5"/>
+ <text x="360" y="135" text-anchor="middle" fill="var(--unomi-text)" font-size="14" font-weight="700">Apache Unomi 3.1</text>
+ <text x="360" y="160" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">Tenant isolation</text>
+ <text x="360" y="182" text-anchor="middle" fill="var(--unomi-accent)" font-size="12" font-weight="600">API keys</text>
+ </g>
+
+ <line x1="470" y1="150" x2="530" y2="150" stroke="var(--unomi-accent)" stroke-width="2" class="flow"/>
+
+ <g class="float">
+ <rect x="540" y="100" width="140" height="40" rx="12" fill="var(--unomi-accent)"/>
+ <text x="610" y="125" text-anchor="middle" fill="var(--unomi-white)" font-size="11" font-weight="600">Tenant A data</text>
+ </g>
+ <g class="float" style="animation-delay:.25s">
+ <rect x="540" y="156" width="140" height="40" rx="12" fill="var(--unomi-primary)"/>
+ <text x="610" y="181" text-anchor="middle" fill="var(--unomi-white)" font-size="11" font-weight="600">Tenant B data</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/usecase-web-personalization.svg b/src/main/webapp/assets/images/unomi3/usecase-web-personalization.svg
new file mode 100644
index 0000000..83f7acf
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/usecase-web-personalization.svg
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 640 280" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Visitor events flow through a CMS into Unomi, returning personalized content">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-on-dark: rgba(255,255,255,.85);
+ --unomi-success: #059669;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-4px)} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.float { animation: none !important; }
+ }
+</style>
+</defs>
+ <rect width="640" height="280" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="32" y="36" fill="var(--unomi-text)" font-size="15" font-weight="700">Web personalization</text>
+ <text x="32" y="56" fill="var(--unomi-text-muted)" font-size="12">Visitor → CMS → Unomi → personalized page</text>
+
+ <g class="float">
+ <rect x="40" y="110" width="110" height="60" rx="14" fill="var(--unomi-primary)"/>
+ <text x="95" y="145" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Visitor</text>
+ </g>
+ <line x1="160" y1="140" x2="210" y2="140" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+ <text x="185" y="128" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="10">page view</text>
+
+ <g class="float" style="animation-delay:.2s">
+ <rect x="220" y="110" width="120" height="60" rx="14" fill="var(--unomi-primary-dark)"/>
+ <text x="280" y="145" text-anchor="middle" fill="var(--unomi-white)" font-size="13" font-weight="600">Web CMS</text>
+ </g>
+ <line x1="350" y1="140" x2="400" y2="140" stroke="var(--unomi-accent)" stroke-width="2" class="flow"/>
+ <text x="375" y="128" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="10">events</text>
+
+ <g class="float" style="animation-delay:.4s">
+ <rect x="410" y="90" width="190" height="100" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="505" y="130" text-anchor="middle" fill="var(--unomi-text)" font-size="14" font-weight="700">Apache Unomi</text>
+ <text x="505" y="154" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Profile · Segments</text>
+ <text x="505" y="174" text-anchor="middle" fill="var(--unomi-accent)" font-size="11" font-weight="600">API key auth (3.1)</text>
+ </g>
+
+ <path d="M505 190 C505 230 280 230 280 170" stroke="var(--unomi-accent)" stroke-width="2" fill="none" class="flow"/>
+ <text x="400" y="248" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">personalized content</text>
+</svg>
diff --git a/src/main/webapp/blog/index.html b/src/main/webapp/blog/index.html
new file mode 100644
index 0000000..174b9f7
--- /dev/null
+++ b/src/main/webapp/blog/index.html
@@ -0,0 +1,198 @@
+---
+title: Blog
+description: "Apache Unomi Blog — Unomi 3 release stories, AI agents and CDP guidance, migrations, and community updates."
+keywords: "Apache Unomi blog, Unomi 3, open source CDP, AI agents CDP"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Blog</p>
+ <h1>Apache Unomi Blog</h1>
+ <p class="lead">Release stories, AI/CDP guidance, upgrades, and community — from the Apache Unomi project.</p>
+ </div>
+</section>
+
+<!-- Featured: Unomi 3 -->
+<section class="section">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6">
+ <span class="badge badge-primary mb-3">Featured · Primary story</span>
+ <h2 class="h3 fw-bold mb-3">
+ <a href="/blog/introducing-apache-unomi-3.html" class="text-decoration-none text-body">Introducing Apache Unomi 3</a>
+ </h2>
+ <p class="text-muted mb-4">The major open-source CDP release — platform foundation in 3.0, product leap in 3.1, stable REST, and a leap in quality. Start here for the full story.</p>
+ <ul class="list-unstyled small text-muted mb-4">
+ <li class="mb-2"><i class="bi bi-buildings text-primary me-2"></i><strong>Multi-tenancy</strong> — major platform refactor</li>
+ <li class="mb-2"><i class="bi bi-check2 text-primary me-2"></i>119/119 OpenAPI paths retained from 2.x</li>
+ <li class="mb-2"><i class="bi bi-check2 text-primary me-2"></i>Tests grew faster than production code</li>
+ </ul>
+ <a href="/blog/introducing-apache-unomi-3.html" class="btn btn-primary">
+ Read the Unomi 3 story <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ <div class="col-lg-6">
+ <a href="/blog/introducing-apache-unomi-3.html" class="d-block rounded-3 overflow-hidden shadow-sm" aria-label="Read Introducing Apache Unomi 3">
+ <img src="/assets/images/unomi3/unomi3-journey.svg" class="img-fluid w-100" alt="Unomi 3 journey from 2.x to 3.1" loading="lazy">
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+
+<!-- Multi-tenancy highlight -->
+<section class="section section-alt">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6">
+ <span class="badge badge-primary mb-3">Major investment</span>
+ <h2 class="h3 fw-bold mb-3">
+ <a href="/blog/unomi-3-multitenancy.html" class="text-decoration-none text-body">Multi-tenancy in Unomi 3</a>
+ </h2>
+ <p class="text-muted mb-4">A <strong>platform-wide refactor</strong> — tenant isolation for profiles, events, segments, rules, and schemas, with public and private API keys. One of the largest efforts in Unomi 3.</p>
+ <a href="/blog/unomi-3-multitenancy.html" class="btn btn-primary">
+ Read the multi-tenancy post <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ <div class="col-lg-6">
+ <a href="/blog/unomi-3-multitenancy.html" class="d-block rounded-3 overflow-hidden shadow-sm" aria-label="Read multi-tenancy post">
+ <img src="/assets/images/unomi3/multitenancy.svg" class="img-fluid w-100" alt="Multi-tenancy diagram" loading="lazy">
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- AI + Migrate pair -->
+<section class="section">
+ <div class="container">
+ <div class="row justify-content-center text-center mb-4">
+ <div class="col-lg-7">
+ <p class="section-label">Go deeper</p>
+ <h2 class="h4 mb-0">Second message & upgrades</h2>
+ </div>
+ </div>
+ <div class="row g-4">
+ <div class="col-lg-6">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/unomi-3-ai-agents.html" class="d-block" aria-label="Read Unomi 3 for AI agents">
+ <img src="/assets/images/unomi3/ai-agents-unomi.svg" class="img-fluid w-100" alt="AI agents and Unomi 3" loading="lazy">
+ </a>
+ <div class="p-4">
+ <span class="badge badge-primary mb-2">AI agents</span>
+ <h3 class="h5 fw-semibold mb-2">
+ <a href="/blog/unomi-3-ai-agents.html" class="text-decoration-none text-body">Unomi 3 for AI agents</a>
+ </h3>
+ <p class="small text-muted mb-3">Privacy-first customer memory — retrieve, store, summarize, and build segments. Unomi is not an LLM; it is the data layer agents plug into.</p>
+ <span class="small fw-semibold text-primary">Read post <i class="bi bi-arrow-right"></i></span>
+ <a href="/blog/unomi-3-ai-agents.html" class="stretched-link" aria-label="Read Unomi 3 for AI agents"></a>
+ </div>
+ </article>
+ </div>
+ <div class="col-lg-6">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/migrating-to-unomi-3.html" class="d-block" aria-label="Read Migrating to Unomi 3">
+ <img src="/assets/images/unomi3/api-stability-v2compat.svg" class="img-fluid w-100" alt="API stability and V2 compatibility" loading="lazy">
+ </a>
+ <div class="p-4">
+ <span class="badge badge-success mb-2">Upgrades</span>
+ <h3 class="h5 fw-semibold mb-2">
+ <a href="/blog/migrating-to-unomi-3.html" class="text-decoration-none text-body">Migrating from Unomi 2.x</a>
+ </h3>
+ <p class="small text-muted mb-3">Familiar REST map, additive APIs, and V2 compatibility mode for a phased auth cutover.</p>
+ <span class="small fw-semibold text-primary">Read post <i class="bi bi-arrow-right"></i></span>
+ <a href="/blog/migrating-to-unomi-3.html" class="stretched-link" aria-label="Read Migrating to Unomi 3"></a>
+ </div>
+ </article>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- Welcome + topics -->
+<section class="section">
+ <div class="container">
+ <div class="row g-4 align-items-stretch">
+ <div class="col-lg-7">
+ <article class="feature-card h-100">
+ <div class="d-flex align-items-start gap-3">
+ <div class="feature-icon flex-shrink-0"><i class="bi bi-journal-richtext"></i></div>
+ <div>
+ <span class="badge badge-secondary mb-2">Inaugural</span>
+ <h3 class="h5 fw-semibold mb-2">
+ <a href="/blog/welcome-to-the-apache-unomi-blog.html" class="text-decoration-none text-body">Welcome to the Apache Unomi Blog</a>
+ </h3>
+ <p class="small text-muted mb-3">Why this Blog exists, what you will find here, and how we treat history without backfilling a fake archive.</p>
+ <a href="/blog/welcome-to-the-apache-unomi-blog.html" class="btn btn-outline-primary btn-sm">
+ Open welcome post <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ </div>
+ </article>
+ </div>
+ <div class="col-lg-5">
+ <div class="feature-card h-100">
+ <p class="section-label mb-3">Browse by topic</p>
+ <div class="d-flex flex-wrap gap-2 mb-4">
+ <a href="/blog/introducing-apache-unomi-3.html" class="badge badge-primary text-decoration-none px-3 py-2">Unomi 3</a>
+ <a href="/blog/unomi-3-multitenancy.html" class="badge badge-primary text-decoration-none px-3 py-2">Multi-tenancy</a>
+ <a href="/blog/unomi-3-ai-agents.html" class="badge badge-primary text-decoration-none px-3 py-2">AI agents</a>
+ <a href="/blog/migrating-to-unomi-3.html" class="badge badge-primary text-decoration-none px-3 py-2">Migration</a>
+ <a href="/use-cases.html" class="badge badge-secondary text-decoration-none px-3 py-2">Use cases</a>
+ <a href="/community/events/index.html" class="badge badge-secondary text-decoration-none px-3 py-2">Events</a>
+ </div>
+ <p class="small text-muted mb-0">Past talks and releases stay on the <a href="/">homepage News</a> and <a href="/community/events/index.html">events</a> pages.</p>
+ </div>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- Reading order -->
+<section class="section section-alt">
+ <div class="container">
+ <div class="row justify-content-center text-center mb-4">
+ <div class="col-lg-7">
+ <p class="section-label">Start here</p>
+ <h2 class="h4 mb-0">Suggested reading order</h2>
+ </div>
+ </div>
+ <div class="row g-3 justify-content-center">
+ <div class="col-md-3">
+ <a href="/blog/welcome-to-the-apache-unomi-blog.html" class="feature-card h-100 text-decoration-none d-block text-center">
+ <div class="display-6 text-primary fw-bold mb-2">1</div>
+ <h3 class="h6 fw-semibold text-body mb-1">Welcome</h3>
+ <p class="small text-muted mb-0">What this Blog is for</p>
+ </a>
+ </div>
+ <div class="col-md-3">
+ <a href="/blog/introducing-apache-unomi-3.html" class="feature-card h-100 text-decoration-none d-block text-center">
+ <div class="display-6 text-primary fw-bold mb-2">2</div>
+ <h3 class="h6 fw-semibold text-body mb-1">Unomi 3</h3>
+ <p class="small text-muted mb-0">The major release story</p>
+ </a>
+ </div>
+ <div class="col-md-3">
+ <a href="/blog/unomi-3-multitenancy.html" class="feature-card h-100 text-decoration-none d-block text-center">
+ <div class="display-6 text-primary fw-bold mb-2">3</div>
+ <h3 class="h6 fw-semibold text-body mb-1">Multi-tenancy</h3>
+ <p class="small text-muted mb-0">Major platform refactor</p>
+ </a>
+ </div>
+ <div class="col-md-3">
+ <a href="/blog/unomi-3-ai-agents.html" class="feature-card h-100 text-decoration-none d-block text-center">
+ <div class="display-6 text-primary fw-bold mb-2">4</div>
+ <h3 class="h6 fw-semibold text-body mb-1">AI agents</h3>
+ <p class="small text-muted mb-0">Customer memory for agents</p>
+ </a>
+ </div>
+ </div>
+ <p class="text-center small text-muted mt-4 mb-0">
+ Then: <a href="/blog/migrating-to-unomi-3.html">Migrating from 2.x</a> ·
+ <a href="/download.html">Download</a> ·
+ <a href="/get-started.html">Get started</a>
+ </p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/introducing-apache-unomi-3.html b/src/main/webapp/blog/introducing-apache-unomi-3.html
new file mode 100644
index 0000000..1bb690e
--- /dev/null
+++ b/src/main/webapp/blog/introducing-apache-unomi-3.html
@@ -0,0 +1,51 @@
+---
+title: Introducing Apache Unomi 3
+description: "Apache Unomi 3 is a major open-source CDP release — Elasticsearch 9 / OpenSearch, multi-tenancy, stable REST, quality investment, and AI-ready customer memory."
+keywords: "Apache Unomi 3, open source CDP, multi-tenancy, OpenSearch, V2 API compatibility, CDP tests"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3</p>
+ <h1>Introducing Apache Unomi 3</h1>
+ <p class="lead">A major Customer Data Platform release — platform foundation (3.0) and product leap (3.1) as one story.</p>
+ </div>
+</section>
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Apache Unomi 3 is a <strong>major</strong> open-source CDP release. It spans the <strong>3.0 platform modernization</strong> and the <strong>3.1 product capabilities</strong> operators need for multi-tenant production — told as one Unomi 3 story.</p>
+ <p>A strong second theme: Unomi 3 is also built for <strong>AI agents</strong> that need real customer memory (retrieve, store, summarize, segment) over a stable open API. See <a href="/blog/unomi-3-ai-agents.html">Unomi 3 for AI agents</a>.</p>
+ <p>Unomi 3 steps up the search client (Elasticsearch 9), the runtime (Karaf 4.4; <strong>Java 17+ is the minimum</strong>, not a headline feature), and — across 3.1 — a <strong>platform-wide multi-tenancy refactor</strong>, OpenSearch, cluster-aware tasks, safer validation, and stronger tests.</p>
+ <p>The familiar REST map stays put: <strong>all 119 documented Unomi 2.x OpenAPI paths are still present in 3.1</strong>, with new endpoints added alongside. Optional <strong>V2 compatibility mode</strong> lets you phase authentication changes. Details in <a href="/blog/migrating-to-unomi-3.html">Migrating from Unomi 2.x</a>.</p>
+
+ <h2 class="h4 mt-5 mb-3">The Unomi 3 journey</h2>
+ <img src="/assets/images/unomi3/unomi3-journey.svg" class="img-fluid mb-4" alt="Unomi 3 journey diagram"/>
+<h2 class="h4 mt-5 mb-3">By the numbers (since ~2.7)</h2>
+ <ul>
+ <li><strong>Tests outpaced implementation:</strong> test Java LOC ~10k → 53k (~5.3×) while production Java grew ~60k → 101k (~1.7×)</li>
+ <li>Test/impl LOC ratio ~0.17 → <strong>0.52</strong></li>
+ <li><code>@Test</code> annotations ~235 → <strong>1,524</strong></li>
+ <li><strong>API stability:</strong> 119 / 119 OpenAPI paths retained in 3.1; +12 additive paths</li>
+ <li><strong>Unit tests, not only ITs:</strong> new in-memory <code>PersistenceService</code> harness for fast, independent service tests</li>
+ </ul>
+ <p class="small text-muted">Stats from a pre-GA snapshot — regenerate at 3.1.0 GA before treating numbers as final. Do not cite stale JaCoCo %. Current downloadable stable: v{{ site.data.unomi.latest.stable.version }}.</p>
+
+ <h2 class="h4 mt-5 mb-3">What’s in the box</h2>
+ <ul>
+ <li><strong>Platform:</strong> ES9 client, Karaf 4.4, persistence clustering, health checks (requires Java 17+)</li>
+ <li><strong>Product:</strong> <a href="/blog/unomi-3-multitenancy.html">multi-tenancy & API keys</a> (major platform refactor), OpenSearch, task scheduler, condition validation, request tracing</li>
+ <li><strong>Upgrade bridge:</strong> V2 compatibility mode for phased 2.x client migration</li>
+ <li><strong>Docs:</strong> migration and platform-upgrade runbooks in the official manual</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Try it</h2>
+ <p><a class="btn btn-primary" href="/download.html">Download current stable</a>
+ <a class="btn btn-outline-primary ms-2" href="/get-started.html">Get started</a>
+ <a class="btn btn-outline-primary ms-2" href="https://unomi.apache.org/manual/latest/index.html">Manual</a></p>
+
+ <h2 class="h4 mt-5 mb-3">Community</h2>
+ <p>Apache Unomi 3 is community-built software of the Apache Software Foundation. Among the many contributions, we especially want to thank <strong>Serge Huber (Inoyu)</strong> for an exceptional volume of engineering on this major release, alongside <strong>Jérôme Blanchard</strong>, <strong>Jonathan Sinovassin-Naik</strong>, and <strong>François G. (Jahia)</strong>, and other community contributors.</p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/migrating-to-unomi-3.html b/src/main/webapp/blog/migrating-to-unomi-3.html
new file mode 100644
index 0000000..83520ad
--- /dev/null
+++ b/src/main/webapp/blog/migrating-to-unomi-3.html
@@ -0,0 +1,35 @@
+---
+title: Migrating from Unomi 2.x to Unomi 3
+description: "Unomi 3 retains 100% of documented 2.x OpenAPI paths and offers V2 compatibility mode for phased client auth migration."
+keywords: "Unomi 3 migration, V2 compatibility mode, OpenAPI stability, upgrade from Unomi 2"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Upgrades</p>
+ <h1>Migrating from Unomi 2.x to Unomi 3</h1>
+ <p class="lead">Familiar REST map, additive APIs, and an optional V2 compatibility bridge.</p>
+ </div>
+</section>
+<section class="section">
+ <div class="container col-lg-8">
+ <h2 class="h4 mb-3">The API stays familiar</h2>
+ <p>Unomi 3 does not rip out the 2.x REST map. In the OpenAPI specs tracked for testing, <strong>every one of the 119 Unomi 2.x paths is still present in 3.1</strong> — new capabilities (tenants, tasks, …) are <strong>additive</strong>.</p>
+ <p>Native Unomi 3.1 authentication expects tenant API keys. For a calm cutover, enable <strong>V2 compatibility mode</strong> so existing clients keep working while you migrate traffic, then disable the mode when ready.</p>
+
+ <img src="/assets/images/unomi3/api-stability-v2compat.svg" class="img-fluid my-4" alt="API stability and V2 compatibility"/>
+<h2 class="h4 mt-5 mb-3">Migration paths</h2>
+ <ol>
+ <li><strong>2.x → 3.0</strong> — Java 17+ minimum, QueryBuilder ID renames, ES7→ES9 data migration</li>
+ <li><strong>3.0 → 3.1</strong> — tenant auth model, new APIs</li>
+ <li><strong>V2 compatibility mode</strong> — phased client transition</li>
+ <li>Optional <strong>Elasticsearch → OpenSearch</strong> migration</li>
+ </ol>
+ <p>Follow the official manual chapters (including V2 compatibility) rather than duplicating long procedures here:</p>
+ <p><a class="btn btn-primary" href="https://unomi.apache.org/manual/latest/index.html">Open the manual</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/introducing-apache-unomi-3.html">Unomi 3 intro</a></p>
+ <p class="small text-muted mt-4">Path stability does not mean authentication never changes. Prefer tenant API keys in 3.1; use compatibility mode as the bridge.</p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-ai-agents.html b/src/main/webapp/blog/unomi-3-ai-agents.html
new file mode 100644
index 0000000..2a9d3e1
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-ai-agents.html
@@ -0,0 +1,44 @@
+---
+title: Apache Unomi 3 for AI agents — privacy-first customer memory
+description: "Apache Unomi 3 is an open-source CDP AI agents can query and update — retrieve customer context, store observations, summarize profiles, and build segments with built-in consent."
+keywords: "Apache Unomi 3, AI agents CDP, LLM customer context, open source CDP for AI, agentic personalization, consent-aware AI data layer"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">AI agents · Second message</p>
+ <h1>Apache Unomi 3 for AI agents</h1>
+ <p class="lead">Privacy-first customer memory — retrieve, store, summarize, and build segments. Unomi is not an LLM; it is the data layer agents plug into.</p>
+ </div>
+</section>
+<section class="section">
+ <div class="container col-lg-8">
+ <p class="small text-muted">Primary site story remains <a href="/blog/introducing-apache-unomi-3.html">Introducing Apache Unomi 3</a>. This post is the strong second message for AI builders and SEO/AEO.</p>
+ <p>AI agents are only as useful as the <strong>customer context</strong> they can see — and only as trustworthy as the <strong>consent</strong> behind that data. Apache Unomi 3 gives agents a real, queryable, updatable customer memory over REST/JSON (and GraphQL).</p>
+
+ <img src="/assets/images/unomi3/ai-agents-unomi.svg" class="img-fluid my-4" alt="AI agents and Apache Unomi 3"/>
+
+ <h2 class="h4 mt-4 mb-3">1. Retrieve</h2>
+ <p>Pull profiles, recent events, segments, scores, and personalization outcomes to ground copilots and personalize replies.</p>
+ <h2 class="h4 mt-4 mb-3">2. Store</h2>
+ <p>Write preferences, intent, and conversation-derived facts as <strong>events</strong> and/or <strong>profile properties</strong> so agent memory is inspectable and governed like any other CDP data.</p>
+ <h2 class="h4 mt-4 mb-3">3. Summarize</h2>
+ <p>Process history into profile briefs or enrichment fields — synchronously via agents, or asynchronously with Unomi’s task scheduler.</p>
+ <h2 class="h4 mt-4 mb-3">4. Operate</h2>
+ <p>Propose or create segments, adjust scores, suggest rules, and drive personalization — agents can help <em>operate</em> the CDP, not only read it.</p>
+
+ <h2 class="h4 mt-5 mb-3">Why Unomi 3 for AI builders</h2>
+ <ul>
+ <li>Stable, additive REST (119/119 documented 2.x paths retained) + optional V2 compatibility</li>
+ <li>Multi-tenancy & API keys for SaaS-style agent platforms</li>
+ <li>Elasticsearch or OpenSearch</li>
+ <li>Cluster-aware tasks for enrichment jobs</li>
+ <li>Open source and model-vendor-neutral — bring your own LLMs / MCP tools</li>
+ </ul>
+<p class="mt-4"><a class="btn btn-primary" href="/use-cases.html">Use cases</a>
+ <a class="btn btn-outline-primary ms-2" href="/get-started.html">Get started</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/introducing-apache-unomi-3.html">Unomi 3 intro</a></p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-multitenancy.html b/src/main/webapp/blog/unomi-3-multitenancy.html
new file mode 100644
index 0000000..9b32c47
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-multitenancy.html
@@ -0,0 +1,54 @@
+---
+title: Multi-tenancy in Apache Unomi 3
+description: "Unomi 3 multi-tenancy was a major platform refactor — tenant isolation for profiles, events, segments, rules, and schemas with public and private API keys."
+keywords: "Unomi 3 multi-tenancy, tenant API keys, SaaS CDP, Apache Unomi tenants, multi-tenant CDP"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Multi-tenancy</p>
+ <h1>Multi-tenancy in Apache Unomi 3</h1>
+ <p class="lead">A major platform refactoring — not a bolt-on flag. Isolate customer spaces with API keys on one cluster.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Among the Unomi 3.1 changes, <strong>multi-tenancy stands out for scope and effort</strong>. The work cut across persistence, APIs, security, schemas, rules, segments, events, and operations so a single Unomi cluster can host many isolated tenants.</p>
+ <p>This is foundational for SaaS control planes and agencies running many customer spaces — without bolting on a separate Unomi per customer.</p>
+
+ <img src="/assets/images/unomi3/multitenancy.svg" class="img-fluid my-4" alt="Multi-tenancy architecture with API keys and isolated tenants"/>
+
+ <h2 class="h4 mt-4 mb-3">What is isolated</h2>
+ <ul>
+ <li>Profiles, events, and sessions</li>
+ <li>Segments, scores, and rules</li>
+ <li>Schemas and definitions scoped per tenant</li>
+ </ul>
+
+ <h2 class="h4 mt-4 mb-3">How access works</h2>
+ <ul>
+ <li><strong>Public and private API keys</strong> resolve requests to a tenant</li>
+ <li>Administrative vs public traffic can be separated by key type</li>
+ <li>Native 3.1 auth expects tenant API keys; <a href="/blog/migrating-to-unomi-3.html">V2 compatibility mode</a> helps phase older clients</li>
+ </ul>
+
+ <h2 class="h4 mt-4 mb-3">Operations</h2>
+ <ul>
+ <li>Tenant usage metrics for upstream control planes</li>
+ <li>Event retention / purge APIs for lifecycle management</li>
+ <li>Works with Elasticsearch or OpenSearch persistence</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Why it matters</h2>
+ <p>Multi-tenancy was one of the largest engineering investments in Unomi 3 — a deep refactor so isolation is correct end-to-end, not a superficial namespace prefix. Pair it with the rest of the <a href="/blog/introducing-apache-unomi-3.html">Unomi 3 story</a> for the platform and quality context.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="https://unomi.apache.org/manual/latest/index.html">Open the manual</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/introducing-apache-unomi-3.html">Unomi 3 intro</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/migrating-to-unomi-3.html">Migration guide</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html b/src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html
new file mode 100644
index 0000000..380ce95
--- /dev/null
+++ b/src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html
@@ -0,0 +1,37 @@
+---
+title: Welcome to the Apache Unomi Blog
+description: "The Apache Unomi project launches an official blog — Unomi 3 deep dives, AI/CDP guidance, and community updates."
+keywords: "Apache Unomi blog, Unomi 3, community"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Blog</p>
+ <h1>Welcome to the Apache Unomi Blog</h1>
+ <p class="lead">Longer-form writing for Unomi 3, AI/CDP builders, and the community.</p>
+ </div>
+</section>
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Apache Unomi has long shared news through the homepage, <a href="/community/events/index.html">events & talks</a>, mailing lists, and release announcements. As <strong>Unomi 3</strong> lands — a major CDP release with a modern platform, multi-tenancy, OpenSearch, and a stronger role as customer memory for <strong>AI agents</strong> — we want a home for longer-form writing.</p>
+ <p>This Blog is that home.</p>
+ <h2 class="h4 mt-5 mb-3">What you will find here</h2>
+ <ul>
+ <li><strong>Unomi 3</strong> — what changed since 2.x, and what it means for operators and builders</li>
+ <li><strong>AI & CDP</strong> — using Unomi as privacy-first context for agents and personalization</li>
+ <li><strong>Upgrades & API stability</strong> — including V2 compatibility mode</li>
+ <li><strong>Community</strong> — contributors, meetings, and how to get involved</li>
+ </ul>
+ <h2 class="h4 mt-5 mb-3">Looking back (without rewriting history)</h2>
+ <p>We are <strong>not</strong> republishing every past meetup or release as a Blog article. Those already live on the <a href="/">homepage News</a>, <a href="/community/events/index.html">events</a>, and <a href="/resources.html">resources</a> pages. Where the past helps explain Unomi 3, we may write selective retrospectives that end with what to do <em>today</em>.</p>
+ <h2 class="h4 mt-5 mb-3">Start here</h2>
+ <ol>
+ <li><a href="/blog/introducing-apache-unomi-3.html">Introducing Apache Unomi 3</a> — the major release story</li>
+ <li><a href="/blog/unomi-3-ai-agents.html">Unomi 3 for AI agents</a> — customer memory for the agentic stack</li>
+ <li><a href="/blog/migrating-to-unomi-3.html">Migrating from Unomi 2.x</a> — API stability & V2 compatibility</li>
+ </ol>
+ <p class="mt-5">Apache Unomi is community-built software of the Apache Software Foundation. Subscribe to <a href="mailto:users-subscribe@unomi.apache.org">users@</a>, join <a href="/community/index.html#slack-access">#unomi on ASF Slack</a>, and watch <a href="https://issues.apache.org/jira/browse/UNOMI">JIRA</a>.</p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/community/events/index.html b/src/main/webapp/community/events/index.html
index 1f04225..5afaf12 100644
--- a/src/main/webapp/community/events/index.html
+++ b/src/main/webapp/community/events/index.html
@@ -108,7 +108,7 @@ structured_data: >
<span class="position-absolute top-50 start-50 translate-middle d-flex align-items-center justify-content-center rounded-circle play-overlay"><i class="bi bi-play-fill text-white play-icon-sm"></i></span>
</a>
<h4 class="h6 fw-semibold mb-1">Apache Unomi OpenSearch Contribution</h4>
- <p class="small text-muted mb-0">The changes proposed to add OpenSearch support to Apache Unomi, including the dual persistence architecture and new tooling.</p>
+ <p class="small text-muted mb-0">Dual-persistence architecture that shipped as OpenSearch support in Unomi 3.1, including tooling for Elasticsearch and OpenSearch.</p>
</div>
</div>
</div>
diff --git a/src/main/webapp/documentation.html b/src/main/webapp/documentation.html
index 444144e..074da68 100644
--- a/src/main/webapp/documentation.html
+++ b/src/main/webapp/documentation.html
@@ -15,7 +15,7 @@ structured_data: >
"@type": "ItemList",
"name": "Apache Unomi Documentation Resources",
"itemListElement": [
- { "@type": "ListItem", "position": 1, "name": "Latest Manual", "url": "https://unomi.apache.org/manual/latest/index.html" },
+ { "@type": "ListItem", "position": 1, "name": "Latest Manual", "url": "https://unomi.apache.org/manual/3_1_x/index.html" },
{ "@type": "ListItem", "position": 2, "name": "REST API Reference", "url": "https://unomi.apache.org/rest-api-doc/index.html" },
{ "@type": "ListItem", "position": 3, "name": "Java API (Javadoc)", "url": "https://unomi.apache.org/unomi-api/apidocs/index.html" },
{ "@type": "ListItem", "position": 4, "name": "Tutorials", "url": "https://unomi.apache.org/tutorial.html" }
@@ -42,15 +42,15 @@ structured_data: >
<div class="col-md-6 col-lg-3">
<a href="/get-started.html" class="feature-card d-block text-decoration-none h-100">
<div class="feature-icon"><i class="bi bi-rocket-takeoff"></i></div>
- <h3 class="h6 fw-semibold text-dark">Getting Started</h3>
+ <h3 class="h6 fw-semibold text-dark">Getting Started (Unomi 3.1)</h3>
<p class="small text-muted mb-0">New to Unomi? Start here with a quick overview and Docker setup.</p>
</a>
</div>
<div class="col-md-6 col-lg-3">
- <a href="https://unomi.apache.org/manual/3_0_x/index.html" class="feature-card d-block text-decoration-none h-100">
+ <a href="{{ site.data.unomi.manual.published_stable }}" class="feature-card d-block text-decoration-none h-100">
<div class="feature-icon"><i class="bi bi-book"></i></div>
- <h3 class="h6 fw-semibold text-dark">Stable Manual <span class="text-muted fw-normal">3.0.x</span></h3>
- <p class="small text-muted mb-0">The comprehensive guide for the current stable release.</p>
+ <h3 class="h6 fw-semibold text-dark">Stable Manual <span class="text-muted fw-normal">{{ site.data.unomi.latest.stable.version }}</span></h3>
+ <p class="small text-muted mb-0">Comprehensive guide for the current stable release, including multi-tenancy, OpenSearch, and API keys.</p>
</a>
</div>
<div class="col-md-6 col-lg-3">
@@ -87,7 +87,7 @@ structured_data: >
<div class="feature-card h-100">
<div class="feature-icon icon-success"><i class="bi bi-box-seam"></i></div>
<h3 class="h6 fw-semibold">Installation & Configuration</h3>
- <p class="small text-muted mb-2">Docker setup, manual installation, Elasticsearch configuration, and production deployment.</p>
+ <p class="small text-muted mb-2">Docker setup, tenants and API keys (3.1), Elasticsearch or OpenSearch, and production deployment.</p>
<a href="https://unomi.apache.org/manual/latest/index.html#_quick_start" class="small fw-semibold">Installation guide <i class="bi bi-arrow-right"></i></a>
</div>
</div>
@@ -155,11 +155,11 @@ structured_data: >
<span class="badge badge-success me-2"><i class="bi bi-circle-fill me-1 badge-dot-sm"></i> Stable</span>
<span class="fw-semibold">Recommended</span>
</div>
- <h3 class="h5 fw-bold mb-1">Unomi 3.0.x</h3>
+ <h3 class="h5 fw-bold mb-1">Unomi 3.1.x</h3>
<div class="d-flex flex-wrap gap-2 mt-3">
- <a href="https://unomi.apache.org/manual/3_0_x/index.html" class="btn btn-primary btn-sm">Read Online</a>
- <a href="https://dist.apache.org/repos/dist/release/unomi/3.0.0/unomi-manual-3_0_x.zip" target="_blank" rel="noopener" class="btn btn-outline-primary btn-sm">HTML (zip)</a>
- <a href="https://dist.apache.org/repos/dist/release/unomi/3.0.0/unomi-manual-3_0_x.pdf" target="_blank" rel="noopener" class="btn btn-outline-primary btn-sm">PDF</a>
+ <a href="{{ site.data.unomi.manual.published_stable }}" class="btn btn-primary btn-sm">Read Online</a>
+ <a href="https://dist.apache.org/repos/dist/release/unomi/{{ site.data.unomi.latest.stable.version }}/unomi-manual-{{ site.data.unomi.doc.version }}.zip" target="_blank" rel="noopener" class="btn btn-outline-primary btn-sm">HTML (zip)</a>
+ <a href="https://dist.apache.org/repos/dist/release/unomi/{{ site.data.unomi.latest.stable.version }}/unomi-manual-{{ site.data.unomi.doc.version }}.pdf" target="_blank" rel="noopener" class="btn btn-outline-primary btn-sm">PDF</a>
</div>
</div>
</div>
@@ -168,9 +168,9 @@ structured_data: >
<div class="d-flex align-items-center mb-2">
<span class="badge badge-warning me-2"><i class="bi bi-circle-fill me-1 badge-dot-sm"></i> Development</span>
</div>
- <h3 class="h5 fw-bold mb-1">Unomi {{ site.data.unomi.latest.development.version }}</h3>
- <p class="small text-muted mb-2">In development — may contain unreleased features.</p>
- <a href="https://unomi.apache.org/manual/latest/index.html" class="btn btn-outline-primary btn-sm">Read Online</a>
+ <h3 class="h5 fw-bold mb-1">Latest / development</h3>
+ <p class="small text-muted mb-2">Tracks <code>manual/latest</code> (usually the current line). Deep links: <a href="{{ site.data.unomi.manual.whats_new }}">What’s new in 3.1</a>.</p>
+ <a href="{{ site.data.unomi.manual.published_latest }}" class="btn btn-outline-primary btn-sm">Read Online</a>
</div>
</div>
</div>
@@ -180,7 +180,7 @@ structured_data: >
<div class="col-lg-10">
<details class="mt-3">
<summary class="fw-semibold text-primary cursor-pointer">
- <i class="bi bi-archive me-1"></i> Archived Versions (2.7.x – 1.1.x)
+ <i class="bi bi-archive me-1"></i> Archived Versions (3.0.x – 1.1.x)
</summary>
<div class="table-responsive mt-3">
<table class="table table-sm align-middle">
@@ -193,6 +193,12 @@ structured_data: >
</tr>
</thead>
<tbody>
+ <tr>
+ <td class="fw-semibold">3.0.x</td>
+ <td><a href="https://unomi.apache.org/manual/3_0_x/index.html">Online</a></td>
+ <td><a href="https://dist.apache.org/repos/dist/release/unomi/3.0.0/unomi-manual-3_0_x.zip" target="_blank" rel="noopener">Download</a></td>
+ <td><a href="https://dist.apache.org/repos/dist/release/unomi/3.0.0/unomi-manual-3_0_x.pdf" target="_blank" rel="noopener">Download</a></td>
+ </tr>
<tr>
<td class="fw-semibold">2.7.x</td>
<td><a href="https://unomi.apache.org/manual/2_7_x/index.html">Online</a></td>
@@ -346,11 +352,12 @@ structured_data: >
<div class="container">
<div class="row g-5">
<div class="col-lg-6">
- <h2 class="h4 mb-3"><i class="bi bi-database-gear me-2 text-primary"></i>Elasticsearch Migration</h2>
+ <h2 class="h4 mb-3"><i class="bi bi-database-gear me-2 text-primary"></i>Search Engine Migration</h2>
<p class="small text-muted">When migrating between Elasticsearch versions used by Unomi:</p>
<ul class="small text-muted">
<li class="mb-2"><strong>Standalone:</strong> Copy the data directory and custom <code>elasticsearch.yml</code> settings to the new version.</li>
<li class="mb-2"><strong>Cluster:</strong> Use Elasticsearch <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html" target="_blank" rel="noopener">Snapshot and Restore</a> functionality.</li>
+ <li class="mb-2"><strong>OpenSearch (Unomi 3.1):</strong> Unomi supports OpenSearch 3.x as an alternate backend. See <a href="/blog/migrating-to-unomi-3.html">Migrating to Unomi 3</a> and the <a href="{{ site.data.unomi.manual.es_to_os }}" target="_blank" rel="noopener">ES → OpenSearch</a> manual section.</li>
</ul>
</div>
<div class="col-lg-6">
diff --git a/src/main/webapp/download.html b/src/main/webapp/download.html
index 309dd0d..a193a6c 100644
--- a/src/main/webapp/download.html
+++ b/src/main/webapp/download.html
@@ -24,6 +24,7 @@ structured_data: >
<p class="section-label text-hero-label">Download</p>
<h1>Download Apache Unomi</h1>
<p class="lead">Get the latest stable release or browse the archive of previous versions.</p>
+ <p class="text-hero-muted">Apache Unomi <strong>{{ site.data.unomi.latest.stable.version }}</strong> is the current stable release of the <strong>Unomi 3</strong> line — multi-tenancy, OpenSearch, task scheduling, V2 compatibility, and the Elasticsearch 9 platform from 3.0. Requires <strong>Java 17+</strong> (runtime baseline). Read <a href="/blog/introducing-apache-unomi-3.html">Introducing Unomi 3</a> for the story.</p>
</div>
</section>
@@ -67,7 +68,7 @@ structured_data: >
<a href="https://www.apache.org/dist/unomi/{{ site.data.unomi.latest.stable.version }}/unomi-{{ site.data.unomi.latest.stable.version }}-src.zip.sha512" target="_blank" rel="noopener">SHA512</a>
</p>
- <a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&version=12355172" target="_blank" rel="noopener" class="btn btn-outline-primary btn-sm">
+ <a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&version={{ site.data.unomi.latest.stable.jira_version_id }}" target="_blank" rel="noopener" class="btn btn-outline-primary btn-sm">
<i class="bi bi-journal-text me-1"></i> Release Notes
</a>
</div>
@@ -83,7 +84,7 @@ structured_data: >
<div class="col-lg-5">
<div class="feature-icon mb-3"><i class="bi bi-rocket-takeoff"></i></div>
<h2 class="h5 fw-semibold">Installation</h2>
- <p class="small text-muted">Get up and running quickly with our <a href="/get-started.html#quickstart">Docker Quick Start</a> or follow the <a href="https://unomi.apache.org/manual/latest/index.html#_quick_start" target="_blank" rel="noopener">manual installation guide</a>.</p>
+ <p class="small text-muted">Try Unomi with Docker via the <a href="/get-started.html#quickstart">Getting Started</a> guide or follow the <a href="{{ site.data.unomi.manual.quick_start }}" target="_blank" rel="noopener">manual installation guide</a>.</p>
</div>
<div class="col-lg-5">
<div class="feature-icon mb-3"><i class="bi bi-shield-check"></i></div>
@@ -114,6 +115,7 @@ gpg --verify unomi-{{ site.data.unomi.latest.stable.version }}-bin.tar.gz.asc \
<tr><th>Version</th><th>Binary</th><th>Source</th><th>Notes</th></tr>
</thead>
<tbody>
+ <tr><td class="fw-semibold">3.0.0</td><td><a href="https://archive.apache.org/dist/unomi/3.0.0/unomi-3.0.0-bin.tar.gz" target="_blank" rel="noopener">tar.gz</a> • <a href="https://archive.apache.org/dist/unomi/3.0.0/unomi-3.0.0-bin.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://archive.apache.org/dist/unomi/3.0.0/unomi-3.0.0-src.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://issues.ap [...]
<tr><td class="fw-semibold">2.7.0</td><td><a href="https://archive.apache.org/dist/unomi/2.7.0/unomi-2.7.0-bin.tar.gz" target="_blank" rel="noopener">tar.gz</a> • <a href="https://archive.apache.org/dist/unomi/2.7.0/unomi-2.7.0-bin.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://archive.apache.org/dist/unomi/2.7.0/unomi-2.7.0-src.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://issues.apache.org/jira/secure/Release [...]
<tr><td class="fw-semibold">2.6.1</td><td><a href="https://archive.apache.org/dist/unomi/2.6.1/unomi-2.6.1-bin.tar.gz" target="_blank" rel="noopener">tar.gz</a> • <a href="https://archive.apache.org/dist/unomi/2.6.1/unomi-2.6.1-bin.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://archive.apache.org/dist/unomi/2.6.1/unomi-2.6.1-src.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://issues.apache.org/jira/secure/Release [...]
<tr><td class="fw-semibold">2.6.0</td><td><a href="https://archive.apache.org/dist/unomi/2.6.0/unomi-2.6.0-bin.tar.gz" target="_blank" rel="noopener">tar.gz</a> • <a href="https://archive.apache.org/dist/unomi/2.6.0/unomi-2.6.0-bin.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://archive.apache.org/dist/unomi/2.6.0/unomi-2.6.0-src.zip" target="_blank" rel="noopener">zip</a></td><td><a href="https://issues.apache.org/jira/secure/Release [...]
diff --git a/src/main/webapp/get-started.html b/src/main/webapp/get-started.html
index 9716559..4c2ef2b 100644
--- a/src/main/webapp/get-started.html
+++ b/src/main/webapp/get-started.html
@@ -1,17 +1,16 @@
---
-title: Getting Started
-description: "Get started with Apache Unomi in minutes. Learn what Unomi does, run it with Docker, and start building with the REST API."
-keywords: "Apache Unomi quickstart, getting started, Docker setup, installation guide, CDP setup, first steps"
+title: Getting Started with Apache Unomi 3.1
+description: "Get started with Apache Unomi 3.1 in minutes. Docker with Elasticsearch or OpenSearch, create a tenant, use API keys, and call the REST API."
+keywords: "Apache Unomi 3.1 quickstart, getting started, Docker, OpenSearch, multi-tenancy, API keys, CDP setup"
layout: default
-mermaid: true
structured_data: >
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
- "name": "How to Get Started with Apache Unomi using Docker",
- "description": "Run Apache Unomi Customer Data Platform in minutes using Docker Compose with Elasticsearch.",
- "totalTime": "PT5M",
+ "name": "How to Get Started with Apache Unomi 3.1 using Docker",
+ "description": "Run Apache Unomi 3.1 with Docker Compose (Elasticsearch or OpenSearch), create a tenant, and call the REST API with API keys.",
+ "totalTime": "PT10M",
"tool": [
{ "@type": "HowToTool", "name": "Docker" },
{ "@type": "HowToTool", "name": "Docker Compose" }
@@ -21,19 +20,25 @@ structured_data: >
"@type": "HowToStep",
"position": 1,
"name": "Create a docker-compose.yml file",
- "text": "Create a docker-compose.yml file with Elasticsearch 9.1.3 and Apache Unomi services configured."
+ "text": "Create a docker-compose.yml with Elasticsearch 9.4.3 or OpenSearch 3.x and Apache Unomi 3.1."
},
{
"@type": "HowToStep",
"position": 2,
"name": "Start the environment",
- "text": "Run 'docker-compose up' from the same folder and wait for startup to complete (1-2 minutes)."
+ "text": "Run 'docker compose up' and wait for startup (1-2 minutes)."
},
{
"@type": "HowToStep",
"position": 3,
- "name": "Verify it's running",
- "text": "Access https://localhost:9443/cxs/cluster with username/password karaf/karaf to verify the server is running."
+ "name": "Create a tenant",
+ "text": "POST /cxs/tenants as karaf/karaf and save the public and private API keys from the response."
+ },
+ {
+ "@type": "HowToStep",
+ "position": 4,
+ "name": "Call a public endpoint",
+ "text": "Request /cxs/context.json with the X-Unomi-Api-Key header set to your tenant public API key."
}
]
}
@@ -43,9 +48,27 @@ structured_data: >
<!-- Page Header -->
<section class="page-header">
<div class="container">
- <p class="section-label text-hero-label">Get Started</p>
- <h1>Getting Started with Apache Unomi</h1>
- <p class="lead">From zero to a running Customer Data Platform in minutes.</p>
+ <p class="section-label text-hero-label">Get Started · Unomi 3.1</p>
+ <h1>Getting Started with Apache Unomi 3.1</h1>
+ <p class="lead">From zero to a running Customer Data Platform — with multi-tenancy and API keys.</p>
+ </div>
+</section>
+
+
+<!-- Prerequisites -->
+<section class="section section-alt">
+ <div class="container">
+ <div class="row justify-content-center">
+ <div class="col-lg-9">
+ <p class="section-label">Prerequisites</p>
+ <h2 class="h4 mb-3">What you need for Unomi 3.1</h2>
+ <ul class="list-unstyled small mb-0">
+ <li class="mb-2"><i class="bi bi-check2 text-primary me-2"></i><strong>Docker</strong> (recommended path) — or <strong>Java 17+</strong> for a manual install</li>
+ <li class="mb-2"><i class="bi bi-check2 text-primary me-2"></i><strong>Elasticsearch 9.x</strong> (e.g. 9.4.3) <em>or</em> <strong>OpenSearch 3.x</strong></li>
+ <li class="mb-0"><i class="bi bi-buildings text-primary me-2"></i>After startup you <strong>create a tenant</strong> and use its <strong>public / private API keys</strong> for API calls</li>
+ </ul>
+ </div>
+ </div>
</div>
</section>
@@ -56,7 +79,7 @@ structured_data: >
<div class="col-lg-6">
<p class="section-label">Overview</p>
<h2>What is Apache Unomi?</h2>
- <p>Apache Unomi is a <strong>REST server</strong> that manages user profiles and events. It integrates personalization and profile management into any system — CMS, CRM, mobile apps, or custom platforms.</p>
+ <p>Apache Unomi is a <strong>REST server</strong> that manages user profiles and events. It integrates personalization and profile management into any system — CMS, CRM, mobile apps, custom platforms, or <strong>AI agents</strong>.</p>
<ul class="list-unstyled mt-3">
<li class="d-flex align-items-start mb-3">
<i class="bi bi-check-circle-fill text-primary me-2 mt-1"></i>
@@ -64,15 +87,15 @@ structured_data: >
</li>
<li class="d-flex align-items-start mb-3">
<i class="bi bi-check-circle-fill text-primary me-2 mt-1"></i>
- <span>Built-in rule engine triggers actions when events occur on a profile</span>
+ <span><strong>Multi-tenancy</strong> (Unomi 3.1) — isolate profiles, events, segments, rules, and schemas per tenant</span>
</li>
<li class="d-flex align-items-start mb-3">
<i class="bi bi-check-circle-fill text-primary me-2 mt-1"></i>
- <span>Dynamic segmentation classifies profiles into groups for personalization</span>
+ <span>Built-in rule engine, dynamic segmentation, and privacy / GDPR APIs</span>
</li>
<li class="d-flex align-items-start mb-3">
<i class="bi bi-check-circle-fill text-primary me-2 mt-1"></i>
- <span>OSGi plugin architecture on <a href="https://karaf.apache.org" target="_blank" rel="noopener">Apache Karaf</a> — extensible and scalable</span>
+ <span>OSGi plugin architecture on <a href="https://karaf.apache.org" target="_blank" rel="noopener">Apache Karaf</a> — Elasticsearch or OpenSearch backend</span>
</li>
<li class="d-flex align-items-start mb-3">
<i class="bi bi-check-circle-fill text-primary me-2 mt-1"></i>
@@ -81,17 +104,7 @@ structured_data: >
</ul>
</div>
<div class="col-lg-6">
- <!-- Mermaid: How Unomi works -->
- <pre class="mermaid">
-graph TD
- A["👤 Visitor"] -->|Events| B["Apache Unomi"]
- B --> C["Profile Store"]
- B --> D["Rules Engine"]
- D --> E["🎯 Personalization"]
- D --> F["📊 Segmentation"]
- D --> G["📈 Scoring"]
- C --> H["Privacy Controls"]
- </pre>
+ <img src="/assets/images/unomi3/architecture-flow.svg" class="img-fluid" alt="How Apache Unomi works: sources via REST into profiles, segments, rules, and outputs"/>
</div>
</div>
</div>
@@ -118,10 +131,10 @@ graph TD
<section class="section" id="quickstart">
<div class="container">
<div class="row justify-content-center text-center mb-5">
- <div class="col-lg-7">
+ <div class="col-lg-8">
<p class="section-label">Quick Start</p>
- <h2>Run with Docker</h2>
- <p class="text-muted">The fastest way to try Apache Unomi. Only Docker is required.</p>
+ <h2>Run Unomi 3.1 with Docker</h2>
+ <p class="text-muted">The fastest way to try Apache Unomi. Only Docker is required. Choose Elasticsearch or OpenSearch.</p>
</div>
</div>
@@ -131,11 +144,14 @@ graph TD
<div class="d-flex mb-4">
<div class="step-number me-3 flex-shrink-0">1</div>
<div class="flex-grow-1">
- <h3 class="h6 fw-semibold mb-2">Create a <code>docker-compose.yml</code> file</h3>
+ <h3 class="h6 fw-semibold mb-2">Create a <code>docker-compose.yml</code></h3>
+ <p class="small text-muted mb-3">Pick one backend. Image tag matches the current stable release (<code>{{ site.data.unomi.latest.stable.version }}</code>).</p>
+
+ <h4 class="h6 fw-semibold mb-2">Option A — Elasticsearch 9.4.3</h4>
<pre><code>version: '3.8'
services:
elasticsearch:
- image: docker.elastic.co/elasticsearch/elasticsearch:9.1.3
+ image: docker.elastic.co/elasticsearch/elasticsearch:9.4.3
environment:
- discovery.type=single-node
- xpack.security.enabled=false
@@ -150,10 +166,51 @@ services:
- 8181:8181
- 9443:9443
- 8102:8102
- links:
- - elasticsearch
depends_on:
- elasticsearch</code></pre>
+
+ <h4 class="h6 fw-semibold mt-4 mb-2">Option B — OpenSearch 3.x</h4>
+ <pre><code>version: '3.8'
+services:
+ opensearch-node1:
+ image: opensearchproject/opensearch:3
+ environment:
+ - cluster.name=opensearch-cluster
+ - node.name=opensearch-node1
+ - discovery.type=single-node
+ - bootstrap.memory_lock=true
+ - "OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m"
+ - OPENSEARCH_INITIAL_ADMIN_PASSWORD=${OPENSEARCH_INITIAL_ADMIN_PASSWORD:-admin}
+ ulimits:
+ memlock:
+ soft: -1
+ hard: -1
+ nofile:
+ soft: 65536
+ hard: 65536
+ volumes:
+ - opensearch-data1:/usr/share/opensearch/data
+ ports:
+ - 9200:9200
+ - 9600:9600
+
+ unomi:
+ image: apache/unomi:{{ site.data.unomi.latest.stable.version }}
+ environment:
+ - UNOMI_DISTRIBUTION=unomi-distribution-opensearch
+ - UNOMI_OPENSEARCH_ADDRESSES=opensearch-node1:9200
+ - UNOMI_OPENSEARCH_USERNAME=admin
+ - UNOMI_OPENSEARCH_PASSWORD=${OPENSEARCH_INITIAL_ADMIN_PASSWORD:-admin}
+ - UNOMI_HEALTHCHECK_PROVIDERS=cluster,opensearch,unomi,persistence
+ ports:
+ - 8181:8181
+ - 9443:9443
+ - 8102:8102
+ depends_on:
+ - opensearch-node1
+
+volumes:
+ opensearch-data1:</code></pre>
</div>
</div>
@@ -162,8 +219,8 @@ services:
<div class="step-number me-3 flex-shrink-0">2</div>
<div class="flex-grow-1">
<h3 class="h6 fw-semibold mb-2">Start the environment</h3>
- <pre><code>docker-compose up</code></pre>
- <p class="small text-muted mt-2">Wait for the startup to complete (usually 1–2 minutes).</p>
+ <pre><code>docker compose up</code></pre>
+ <p class="small text-muted mt-2">Wait for startup to complete (usually 1–2 minutes).</p>
</div>
</div>
@@ -171,9 +228,44 @@ services:
<div class="d-flex mb-4">
<div class="step-number me-3 flex-shrink-0">3</div>
<div class="flex-grow-1">
- <h3 class="h6 fw-semibold mb-2">Verify it’s running</h3>
+ <h3 class="h6 fw-semibold mb-2">Create a tenant (required in 3.1)</h3>
+ <p class="small text-muted">System admin credentials create tenants. Save both API keys from the JSON response.</p>
+ <pre><code>curl -X POST http://localhost:8181/cxs/tenants \
+ --user karaf:karaf \
+ -H "Content-Type: application/json" \
+ -d '{
+ "requestedId": "default",
+ "properties": {
+ "name": "Default Tenant",
+ "description": "Default tenant for quick start"
+ }
+ }'</code></pre>
+ <ul class="small text-muted mt-2 mb-0">
+ <li><strong>PUBLIC</strong> key — use as <code>X-Unomi-Api-Key</code> on <code>/cxs/context.json</code> and <code>/cxs/eventcollector</code></li>
+ <li><strong>PRIVATE</strong> key — basic auth <code>default:<private-key></code> for admin APIs (scopes, rules, schemas, …)</li>
+ </ul>
+ </div>
+ </div>
+
+ <!-- Step 4 -->
+ <div class="d-flex mb-4">
+ <div class="step-number me-3 flex-shrink-0">4</div>
+ <div class="flex-grow-1">
+ <h3 class="h6 fw-semibold mb-2">Verify cluster & request context</h3>
+ <p class="small text-muted mb-2">Cluster (system admin):</p>
<pre><code>curl -k https://localhost:9443/cxs/cluster -u karaf:karaf</code></pre>
- <p class="small text-muted mt-2">Default credentials: <code>karaf</code> / <code>karaf</code>. You may see a certificate warning — this is expected in development.</p>
+ <p class="small text-muted mt-3 mb-2">First context request (public API key required):</p>
+ <pre><code>curl -X POST "http://localhost:8181/cxs/context.json?sessionId=1234" \
+ -H "Content-Type: application/json" \
+ -H "X-Unomi-Api-Key: YOUR_PUBLIC_API_KEY" \
+ -d '{
+ "source": {
+ "itemId": "homepage",
+ "itemType": "page",
+ "scope": "default"
+ }
+ }'</code></pre>
+ <p class="small text-muted mt-2 mb-0">Default system credentials: <code>karaf</code> / <code>karaf</code>. Certificate warnings on port 9443 are expected in development.</p>
</div>
</div>
</div>
@@ -182,16 +274,58 @@ services:
<div class="row justify-content-center mt-2">
<div class="col-lg-9">
<div class="p-3 rounded-3 bg-primary-light">
- <p class="small mb-1"><strong><i class="bi bi-info-circle me-1"></i>Production note:</strong> This configuration is for development only. See the <a href="https://unomi.apache.org/manual/latest/index.html#_securing_a_production_environment">production security guide</a> before deploying.</p>
- <p class="small mb-0"><strong>Prefer manual install?</strong> Follow the <a href="https://unomi.apache.org/manual/latest/index.html#_quick_start">manual quick start guide</a> for Java-based installation.</p>
+ <p class="small mb-1"><strong><i class="bi bi-info-circle me-1"></i>Production note:</strong> This configuration is for development only. See the <a href="{{ site.data.unomi.manual.security }}">production security guide</a> before deploying.</p>
+ <p class="small mb-1"><strong>Manual install?</strong> Java 17+, Elasticsearch 9.4.3 or OpenSearch 3.x — follow the <a href="{{ site.data.unomi.manual.quick_start }}">manual quick start</a> (same tenant + API key steps).</p>
+ <p class="small mb-0"><strong>Upgrading from 2.x?</strong> See <a href="/blog/migrating-to-unomi-3.html">Migrating to Unomi 3</a> and optional <a href="{{ site.data.unomi.manual.v2_compat }}">V2 compatibility mode</a>.</p>
</div>
</div>
</div>
</div>
</section>
+<!-- Auth cheat sheet -->
+<section class="section section-alt" id="auth">
+ <div class="container">
+ <div class="row justify-content-center">
+ <div class="col-lg-9">
+ <p class="section-label">Unomi 3.1 authentication</p>
+ <h2 class="h4 mb-3">How API access works</h2>
+ <div class="table-responsive">
+ <table class="table table-sm align-middle small">
+ <thead>
+ <tr>
+ <th>Audience</th>
+ <th>Credential</th>
+ <th>Typical use</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>System admin</td>
+ <td><code>karaf:karaf</code> (basic)</td>
+ <td>Create / list tenants, cluster ops</td>
+ </tr>
+ <tr>
+ <td>Tenant admin</td>
+ <td><code>tenantId:privateApiKey</code> (basic)</td>
+ <td>Scopes, rules, schemas, searches</td>
+ </tr>
+ <tr>
+ <td>Public apps / trackers</td>
+ <td><code>X-Unomi-Api-Key: <public></code></td>
+ <td><code>/cxs/context.json</code>, <code>/cxs/eventcollector</code></td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <p class="small text-muted mb-0">Details: <a href="/blog/unomi-3-multitenancy.html">Multi-tenancy in Unomi 3</a> · <a href="{{ site.data.unomi.manual.multitenancy }}">Manual — Multi-tenancy</a></p>
+ </div>
+ </div>
+ </div>
+</section>
+
<!-- Next Steps -->
-<section class="section section-alt">
+<section class="section">
<div class="container">
<div class="row justify-content-center text-center mb-5">
<div class="col-lg-7">
@@ -200,25 +334,32 @@ services:
</div>
</div>
<div class="row g-4 justify-content-center">
- <div class="col-md-6 col-lg-4">
+ <div class="col-md-6 col-lg-3">
+ <a href="/tutorial.html" class="feature-card d-block text-decoration-none h-100 text-center">
+ <div class="feature-icon mx-auto"><i class="bi bi-mortarboard"></i></div>
+ <h3 class="h6 fw-semibold text-dark">Tutorials</h3>
+ <p class="small text-muted mb-0">API calls, web tracking, rules, and personalization with 3.1 keys.</p>
+ </a>
+ </div>
+ <div class="col-md-6 col-lg-3">
<a href="/documentation.html" class="feature-card d-block text-decoration-none h-100 text-center">
<div class="feature-icon mx-auto"><i class="bi bi-book"></i></div>
- <h3 class="h6 fw-semibold text-dark">Read the Documentation</h3>
- <p class="small text-muted mb-0">Dive into the full manual for configuration, APIs, and extending Unomi.</p>
+ <h3 class="h6 fw-semibold text-dark">Documentation</h3>
+ <p class="small text-muted mb-0">Full manual for configuration, APIs, and extending Unomi.</p>
</a>
</div>
- <div class="col-md-6 col-lg-4">
- <a href="/use-cases.html" class="feature-card d-block text-decoration-none h-100 text-center">
- <div class="feature-icon mx-auto"><i class="bi bi-lightbulb"></i></div>
- <h3 class="h6 fw-semibold text-dark">Explore Use Cases</h3>
- <p class="small text-muted mb-0">Web personalization, mobile analytics, profile management, and more.</p>
+ <div class="col-md-6 col-lg-3">
+ <a href="/blog/unomi-3-multitenancy.html" class="feature-card d-block text-decoration-none h-100 text-center">
+ <div class="feature-icon mx-auto"><i class="bi bi-buildings"></i></div>
+ <h3 class="h6 fw-semibold text-dark">Multi-tenancy</h3>
+ <p class="small text-muted mb-0">Why 3.1 was rebuilt for tenants and API keys.</p>
</a>
</div>
- <div class="col-md-6 col-lg-4">
+ <div class="col-md-6 col-lg-3">
<a href="/community/index.html" class="feature-card d-block text-decoration-none h-100 text-center">
<div class="feature-icon mx-auto"><i class="bi bi-chat-dots"></i></div>
<h3 class="h6 fw-semibold text-dark">Get Help</h3>
- <p class="small text-muted mb-0">Join the mailing list, chat on Slack, or attend a monthly community meeting.</p>
+ <p class="small text-muted mb-0">Mailing list, Slack, and monthly community meetings.</p>
</a>
</div>
</div>
diff --git a/src/main/webapp/index.html b/src/main/webapp/index.html
index 482cc64..698bf64 100644
--- a/src/main/webapp/index.html
+++ b/src/main/webapp/index.html
@@ -1,9 +1,8 @@
---
-title: Open Source Customer Data Platform
-description: "Apache Unomi is an open source CDP that unifies customer data from web, mobile, CRM, and IoT. Privacy-first for AI, personalization, and real-time."
-keywords: "Apache Unomi, Customer Data Platform, CDP, open source CDP, personalization engine, GDPR compliant CDP, customer profiles, segmentation, Java CDP, privacy platform, first-party data, OASIS CXS, AI customer data, CDP for AI, AI agents customer context"
+title: Apache Unomi 3 — Open Source Customer Data Platform
+description: "Apache Unomi 3 is a major open-source CDP release — true multi-tenancy, Elasticsearch 9 / OpenSearch, stable REST, and a privacy-first data layer AI agents can query and update."
+keywords: "Apache Unomi 3, open source CDP, Customer Data Platform, multi-tenancy, OpenSearch, CDP for AI agents, LLM customer context, agentic personalization, V2 API compatibility, OASIS CXS, GDPR CDP"
layout: default
-mermaid: true
structured_data: >
<script type="application/ld+json">
{
@@ -39,7 +38,23 @@ structured_data: >
"name": "What technologies does Apache Unomi use?",
"acceptedAnswer": {
"@type": "Answer",
- "text": "Apache Unomi is built in Java, runs on Apache Karaf (OSGi runtime), uses Elasticsearch for data storage, and communicates via a REST/JSON API. It has a plugin architecture supporting OSGi bundles and Groovy actions."
+ "text": "Apache Unomi is built in Java, runs on Apache Karaf (OSGi runtime), uses Elasticsearch or OpenSearch for data storage, and communicates via a REST/JSON API. It has a plugin architecture supporting OSGi bundles and Groovy actions."
+ }
+ },
+ {
+ "@type": "Question",
+ "name": "What is Apache Unomi 3?",
+ "acceptedAnswer": {
+ "@type": "Answer",
+ "text": "Apache Unomi 3 is a major Customer Data Platform release. Unomi 3.0 modernizes the platform (Elasticsearch 9 client, Karaf 4.4, persistence-based clustering; Java 17+ required). Unomi 3.1 centers on a major multi-tenancy refactoring with API keys, plus OpenSearch persistence, a cluster-aware task scheduler, V2 API compatibility for upgrades from 2.x, and a much larger automated test investment."
+ }
+ },
+ {
+ "@type": "Question",
+ "name": "How do AI agents use Apache Unomi?",
+ "acceptedAnswer": {
+ "@type": "Answer",
+ "text": "Apache Unomi is not an LLM — it is privacy-first customer memory for agents. Agents retrieve profiles, events, segments, and scores to personalize responses; store observations and preferences back as events or profile properties; summarize history into profile briefs; and can propose or query segments and rules via the REST/GraphQL APIs. Built-in consent management gates what agents may access."
}
},
{
@@ -47,7 +62,7 @@ structured_data: >
"name": "How does a CDP like Apache Unomi help with AI and machine learning?",
"acceptedAnswer": {
"@type": "Answer",
- "text": "AI models and agents are only as good as the data they can access. Apache Unomi serves as the real-time customer data foundation for AI systems — feeding unified profiles, segments, and behavioral event streams to LLMs, chatbots, recommendation engines, and predictive models via its REST API. Its built-in GDPR consent management ensures AI systems only process data customers have explicitly consented to share, making it a privacy-safe data layer for AI-first [...]
+ "text": "AI models and agents are only as good as the data they can access. Apache Unomi serves as the real-time customer data foundation for AI systems — feeding unified profiles, segments, and behavioral event streams to LLMs, chatbots, recommendation engines, and predictive models via its REST API, and accepting writes so agent-derived facts become durable profile memory. Its built-in GDPR consent management ensures AI systems only process data customers have expli [...]
}
}
]
@@ -60,22 +75,24 @@ structured_data: >
<div class="container">
<div class="row align-items-center">
<div class="col-lg-6 mb-5 mb-lg-0">
- <p class="section-label mb-3 text-hero-link">Apache Unomi™</p>
- <h1 class="display-title mb-4">The Open Source<br><span class="text-hero-accent">Customer Data Platform</span></h1>
- <p class="lead mb-4">Unify data from web, mobile, CRM, support systems, and more. The privacy-first data foundation for AI agents, personalization engines, and real-time customer intelligence — built on open standards.</p>
+ <p class="section-label mb-3 text-hero-link">Introducing Apache Unomi™ 3</p>
+ <h1 class="display-title mb-4">Apache Unomi <span class="text-hero-accent">3</span></h1>
+ <p class="lead mb-4">The major open-source Customer Data Platform release — true <strong>multi-tenancy</strong>, Elasticsearch 9 / OpenSearch, stable REST, and a leap in quality. Built as real customer memory for modern apps <strong>and AI agents</strong>.</p>
<div class="d-flex flex-wrap gap-3">
- <a class="btn btn-primary btn-lg" href="/get-started.html">
- <i class="bi bi-rocket-takeoff me-2"></i>Get Started
+ <a class="btn btn-primary btn-lg" href="/get-started.html#quickstart">
+ <i class="bi bi-rocket-takeoff me-2"></i>Get started with Docker
</a>
- <a class="btn btn-outline-light btn-lg" href="/documentation.html">
- <i class="bi bi-book me-2"></i>Read the Docs
+ <a class="btn btn-outline-light btn-lg" href="/blog/introducing-apache-unomi-3.html">
+ <i class="bi bi-journal-richtext me-2"></i>Read the Unomi 3 story
</a>
</div>
<p class="small mt-3 text-hero-muted">
- Latest: v{{ site.data.unomi.latest.stable.version }} •
+ Current stable: v{{ site.data.unomi.latest.stable.version }} (Unomi 3 line) •
<a href="/download.html" class="text-hero-link">Download</a> •
- <a href="https://www.apache.org/licenses/LICENSE-2.0" target="_blank" rel="noopener" class="text-hero-link">Apache 2.0 License</a>
+ <a href="/blog/" class="text-hero-link">Blog</a> •
+ <a href="https://www.apache.org/licenses/LICENSE-2.0" target="_blank" rel="noopener" class="text-hero-link">Apache 2.0</a>
</p>
+ <p class="small mt-2 text-hero-muted">Requires Java 17+ (runtime baseline).</p>
</div>
<div class="col-lg-6 text-center">
<!-- Inline SVG Illustration: Data flowing into a unified profile -->
@@ -199,6 +216,85 @@ structured_data: >
</div>
</section>
+
+<!-- Unomi 3 major release (teaser — details on Blog) -->
+<section class="section" id="unomi-3">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6">
+ <p class="section-label">Apache Unomi 3</p>
+ <h2 class="mb-3">A major CDP release</h2>
+ <p class="text-muted mb-3">Platform foundation in <strong>3.0</strong>, product leap in <strong>3.1</strong>. At the heart of that leap: a <strong>platform-wide multi-tenancy refactor</strong> — plus OpenSearch, cluster tasks, API stability, and a leap in quality.</p>
+ <ul class="list-unstyled small mb-4">
+ <li class="mb-2"><i class="bi bi-buildings text-primary me-2"></i><strong>Multi-tenancy</strong> — isolate profiles, events, segments, rules & schemas per tenant</li>
+ <li class="mb-2"><i class="bi bi-check2 text-primary me-2"></i><strong>119/119</strong> documented 2.x OpenAPI paths retained</li>
+ <li class="mb-2"><i class="bi bi-check2 text-primary me-2"></i>Tests grew faster than production code (~5.3× vs ~1.7× LOC)</li>
+ </ul>
+ <div class="d-flex flex-wrap gap-2">
+ <a class="btn btn-primary" href="/blog/introducing-apache-unomi-3.html">Read the Unomi 3 story</a>
+ <a class="btn btn-outline-primary" href="/blog/unomi-3-multitenancy.html">Multi-tenancy deep dive</a>
+ <a class="btn btn-outline-primary" href="/download.html">Download v{{ site.data.unomi.latest.stable.version }}</a>
+ </div>
+ </div>
+ <div class="col-lg-6">
+ <a href="/blog/introducing-apache-unomi-3.html" class="d-block" aria-label="Read Introducing Apache Unomi 3">
+ <img src="/assets/images/unomi3/unomi3-journey.svg" class="img-fluid illustration w-100" alt="Apache Unomi 3 journey from 2.x to 3.1"/>
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+
+<!-- Multi-tenancy (major Unomi 3.1 investment — tease) -->
+<section class="section section-alt" id="multi-tenancy">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6 order-lg-2">
+ <p class="section-label">Multi-tenancy</p>
+ <h2 class="mb-3">A platform rebuilt for tenants</h2>
+ <p class="text-muted mb-3">Multi-tenancy in Unomi 3.1 is not a thin wrapper — it was a <strong>major refactoring of the platform</strong>: tenant-aware persistence, public and private API keys, isolation of profiles, events, segments, rules, and schemas, plus usage and retention APIs for control planes.</p>
+ <ul class="list-unstyled small mb-4">
+ <li class="mb-2"><i class="bi bi-key text-primary me-2"></i>Public & private API keys per tenant</li>
+ <li class="mb-2"><i class="bi bi-shield-lock text-primary me-2"></i>Data plane isolation across the CDP</li>
+ <li class="mb-2"><i class="bi bi-cloud text-primary me-2"></i>Built for SaaS and multi-customer deployments</li>
+ </ul>
+ <div class="d-flex flex-wrap gap-2">
+ <a class="btn btn-primary" href="/blog/unomi-3-multitenancy.html">How multi-tenancy works</a>
+ <a class="btn btn-outline-primary" href="{{ site.data.unomi.manual.multitenancy }}">Manual — Multi-tenancy</a>
+ </div>
+ </div>
+ <div class="col-lg-6 order-lg-1">
+ <a href="/blog/unomi-3-multitenancy.html" class="d-block" aria-label="Read Unomi 3 multi-tenancy post">
+ <img src="/assets/images/unomi3/multitenancy.svg" class="img-fluid" alt="Multi-tenancy: API keys map clients to isolated tenants on Elasticsearch or OpenSearch"/>
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- AI agents teaser (after multi-tenancy — details on Blog / Use cases) -->
+<section class="section" id="ai-agents">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6 order-lg-2">
+ <p class="section-label">AI agents</p>
+ <h2 class="mb-3">Also: customer memory for the agentic stack</h2>
+ <p class="text-muted mb-3">Unomi is not an LLM. It is the open-source CDP agents <strong>query and update</strong> — retrieve context, store observations, summarize profiles, and build segments, with consent built in.</p>
+ <div class="d-flex flex-wrap gap-2">
+ <a class="btn btn-primary" href="/blog/unomi-3-ai-agents.html">Unomi 3 for AI agents</a>
+ <a class="btn btn-outline-primary" href="/use-cases.html">Explore use cases</a>
+ </div>
+ </div>
+ <div class="col-lg-6 order-lg-1">
+ <a href="/blog/unomi-3-ai-agents.html" class="d-block" aria-label="Read Unomi 3 for AI agents">
+ <img src="/assets/images/unomi3/ai-agents-unomi.svg" class="img-fluid" alt="AI agents reading and writing customer context through Apache Unomi 3"/>
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
<!-- What is a CDP -->
<section class="section">
<div class="container">
@@ -250,108 +346,34 @@ structured_data: >
</div>
</section>
-<!-- CDP in the AI Era -->
-<section class="section section-alt">
+<!-- CDP in the AI Era — short bridge; detail on Use cases + Blog -->
+<section class="section">
<div class="container">
- <div class="row justify-content-center text-center mb-5">
+ <div class="row justify-content-center text-center">
<div class="col-lg-8">
- <p class="section-label">AI-Ready Data</p>
- <h2 class="mb-3">Your CDP is the foundation<br>for an AI-first world</h2>
- <p class="lead">AI agents, copilots, and recommendation engines are only as good as the data they operate on. A CDP gives them what they need: clean, unified, real-time customer context — with privacy built in.</p>
- </div>
- </div>
- <div class="row g-4">
- <div class="col-md-6 col-lg-4">
- <div class="feature-card h-100">
- <div class="feature-icon"><i class="bi bi-robot"></i></div>
- <h3 class="h6 fw-semibold mb-2">Feed AI Agents with Context</h3>
- <p class="small text-muted mb-0">LLMs and autonomous agents need customer context to be relevant. Unomi’s REST API feeds real-time profiles, segments, and event history to any AI system — chatbots, support copilots, or recommendation engines.</p>
- </div>
- </div>
- <div class="col-md-6 col-lg-4">
- <div class="feature-card h-100">
- <div class="feature-icon"><i class="bi bi-database-lock"></i></div>
- <h3 class="h6 fw-semibold mb-2">First-Party Data Is King</h3>
- <p class="small text-muted mb-0">Third-party cookies are gone. Privacy regulations are tightening. The most valuable AI training and context data is first-party data you collect and control through your own CDP.</p>
- </div>
- </div>
- <div class="col-md-6 col-lg-4">
- <div class="feature-card h-100">
- <div class="feature-icon"><i class="bi bi-shield-check"></i></div>
- <h3 class="h6 fw-semibold mb-2">Privacy-Safe AI</h3>
- <p class="small text-muted mb-0">AI processing customer data raises serious privacy concerns. Unomi’s GDPR consent management ensures your AI systems only use data customers have explicitly consented to share.</p>
- </div>
- </div>
- </div>
- <div class="row g-4 mt-1 justify-content-center">
- <div class="col-md-6 col-lg-4">
- <div class="feature-card h-100">
- <div class="feature-icon"><i class="bi bi-lightning-charge"></i></div>
- <h3 class="h6 fw-semibold mb-2">Real-Time Decisioning</h3>
- <p class="small text-muted mb-0">AI-powered personalization requires millisecond-level customer context. Unomi processes events and updates profiles in real time, so your models always work with the freshest data.</p>
- </div>
- </div>
- <div class="col-md-6 col-lg-4">
- <div class="feature-card h-100">
- <div class="feature-icon"><i class="bi bi-plug"></i></div>
- <h3 class="h6 fw-semibold mb-2">Plug In Any AI</h3>
- <p class="small text-muted mb-0">Unlike proprietary CDPs that lock you into specific vendors, Unomi is open. Connect OpenAI, Anthropic, local models, or custom ML pipelines — your choice, your infrastructure.</p>
- </div>
+ <p class="section-label">AI-ready data</p>
+ <h2 class="mb-3">Privacy-first context for AI systems</h2>
+ <p class="text-muted mb-4">Feed agents and models with unified profiles and events — and write durable customer memory back into the CDP. Open, consent-aware, model-vendor-neutral.</p>
+ <a class="btn btn-outline-primary" href="/use-cases.html">AI & personalization use cases</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-ai-agents.html">Deep dive on the Blog</a>
</div>
</div>
</div>
</section>
-<!-- Architecture Diagram (Mermaid) -->
-<section class="section">
+<!-- Architecture (SVG teaser — docs for depth) -->
+<section class="section section-alt">
<div class="container">
- <div class="row justify-content-center text-center mb-5">
- <div class="col-lg-8">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-5">
<p class="section-label">Architecture</p>
<h2 class="mb-3">How Apache Unomi works</h2>
- <p class="lead">All communication happens via REST/JSON. Data flows in from any source, gets unified into profiles, and drives real-time decisions.</p>
+ <p class="text-muted mb-4">REST/JSON in, unified profiles out — personalization, scoring, export, and AI agents. Dive into the docs for APIs, plugins, and deployment.</p>
+ <a class="btn btn-primary" href="/documentation.html">Documentation</a>
+ <a class="btn btn-outline-primary ms-2" href="/get-started.html">Get started</a>
</div>
- </div>
- <div class="row justify-content-center">
- <div class="col-lg-10">
- <pre class="mermaid">
-graph LR
- subgraph Sources["Data Sources"]
- WEB["🌐 Web"]
- MOB["📱 Mobile"]
- CRM["💼 CRM"]
- IOT["📡 IoT"]
- end
-
- subgraph Unomi["Apache Unomi"]
- API["REST API"]
- PE["Processing Engine"]
- PROF["Profile Store"]
- SEG["Segmentation"]
- RULES["Rules Engine"]
- end
-
- subgraph Outputs["Actions"]
- PERS["🎯 Personalization"]
- SCORE["📊 Scoring"]
- EXPORT["📤 Data Export"]
- AIAGENT["🤖 AI Agents"]
- end
-
- WEB --> API
- MOB --> API
- CRM --> API
- IOT --> API
- API --> PE
- PE --> PROF
- PE --> SEG
- PE --> RULES
- SEG --> PERS
- RULES --> SCORE
- PROF --> EXPORT
- PROF --> AIAGENT
- SEG --> AIAGENT
- </pre>
+ <div class="col-lg-7">
+ <img src="/assets/images/unomi3/architecture-flow.svg" class="img-fluid" alt="Apache Unomi architecture: sources, CDP core, and actions"/>
</div>
</div>
</div>
@@ -369,7 +391,7 @@ graph LR
<ul class="list-unstyled mt-3">
<li class="d-flex align-items-start mb-3">
<i class="bi bi-check-circle-fill text-primary me-2 mt-1"></i>
- <span>Elasticsearch backend with dynamic, schema-free data structures</span>
+ <span>Elasticsearch or OpenSearch (Unomi 3.1) backend with dynamic, schema-free data structures</span>
</li>
<li class="d-flex align-items-start mb-3">
<i class="bi bi-check-circle-fill text-primary me-2 mt-1"></i>
@@ -434,22 +456,22 @@ graph LR
<div class="col-md-4">
<div class="text-center">
<div class="step-number mx-auto mb-3">1</div>
- <h3 class="h6 fw-semibold mb-2">Download</h3>
- <p class="small text-muted">Grab the latest release or use our Docker image to spin up instantly.</p>
+ <h3 class="h6 fw-semibold mb-2">Start Unomi 3.1</h3>
+ <p class="small text-muted">Docker Compose with Elasticsearch 9.x or OpenSearch 3.x — or install with Java 17+.</p>
</div>
</div>
<div class="col-md-4">
<div class="text-center">
<div class="step-number mx-auto mb-3">2</div>
- <h3 class="h6 fw-semibold mb-2">Configure</h3>
- <p class="small text-muted">Point to your Elasticsearch instance and customize settings as needed.</p>
+ <h3 class="h6 fw-semibold mb-2">Create a tenant</h3>
+ <p class="small text-muted">Generate public and private API keys so every profile and event is tenant-scoped.</p>
</div>
</div>
<div class="col-md-4">
<div class="text-center">
<div class="step-number mx-auto mb-3">3</div>
<h3 class="h6 fw-semibold mb-2">Integrate</h3>
- <p class="small text-muted">Use the REST API to send events, query profiles, and build personalized experiences.</p>
+ <p class="small text-muted">Call the REST API with <code>X-Unomi-Api-Key</code> — events, profiles, segments, personalization.</p>
</div>
</div>
</div>
@@ -566,12 +588,33 @@ graph LR
<h2 class="mb-4">What’s New</h2>
<div class="news-item">
- <span class="news-date">2025-11-10</span>
+ <span class="news-date">{{ site.data.unomi.latest.stable.date }}</span>
<i class="bi bi-rocket-takeoff news-icon text-success-var"></i>
<div>
<strong class="small">Apache Unomi {{ site.data.unomi.latest.stable.version }} released</strong>
- <span class="small text-muted">— Karaf upgrade, new ES Java client, bug fixes.</span>
+ <span class="small text-muted">— Unomi 3 product leap: multi-tenancy, OpenSearch, tasks, V2 compat.</span>
<a href="/download.html" class="news-link">Download</a>
+ <a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&version={{ site.data.unomi.latest.stable.jira_version_id }}" target="_blank" rel="noopener" class="news-link">Release notes</a>
+ <a href="/blog/introducing-apache-unomi-3.html" class="news-link">Unomi 3 story</a>
+ </div>
+ </div>
+
+ <div class="news-item">
+ <span class="news-date">2026-07-14</span>
+ <i class="bi bi-journal-richtext news-icon text-primary"></i>
+ <div>
+ <strong class="small">Apache Unomi Blog</strong>
+ <span class="small text-muted">— Major release narrative, multi-tenancy, AI agents, migration guidance.</span>
+ <a href="/blog/" class="news-link">Read the Blog</a>
+ </div>
+ </div>
+
+ <div class="news-item">
+ <span class="news-date">2025-11-10</span>
+ <i class="bi bi-rocket-takeoff news-icon"></i>
+ <div>
+ <strong class="small">Apache Unomi 3.0.0 released</strong>
+ <span class="small text-muted">— Platform foundation: Karaf 4.4, Elasticsearch 9 client, persistence clustering.</span>
<a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&version=12355172" target="_blank" rel="noopener" class="news-link">Release notes</a>
</div>
</div>
@@ -620,7 +663,7 @@ graph LR
<i class="bi bi-camera-video news-icon"></i>
<div>
<strong class="small">OpenSearch contribution presentation</strong>
- <span class="small text-muted">— Presentation on the upcoming OpenSearch persistence support.</span>
+ <span class="small text-muted">— OpenSearch persistence — part of the Unomi 3.1 product leap (see Blog).</span>
<a href="/community/events/index.html#opensearch-2025" class="news-link">Watch</a>
</div>
</div>
diff --git a/src/main/webapp/integrations.html b/src/main/webapp/integrations.html
index 8279edc..e75565a 100644
--- a/src/main/webapp/integrations.html
+++ b/src/main/webapp/integrations.html
@@ -3,7 +3,6 @@ title: Integrations & Ecosystem
description: "Discover products built on Apache Unomi, extensions, connectors, and companies offering commercial support for the open source Customer Data Platform."
keywords: "Apache Unomi integrations, Unomi connectors, Groovy actions, custom plugins, Jahia jExperience, Dropsolid, Inoyu SaaS, CDP integrations, Unomi plugins, commercial support"
layout: default
-mermaid: true
structured_data: >
<script type="application/ld+json">
{
@@ -50,7 +49,7 @@ structured_data: >
<p class="small text-muted mb-3">Jahia is the initial contributor of Apache Unomi, using it as the core engine for their Customer Data Platform (jExperience) and Digital Experience Platform with native GDPR support.</p>
<blockquote class="small fst-italic text-muted border-start border-3 border-primary ps-3 mb-3">
“Apache Unomi is a very important foundation of our products. We love Apache Unomi and are deeply committed to helping our customers succeed with it.”
- <footer class="mt-1 fw-semibold" class="quote-attribution">Serge Huber, Jahia CTO</footer>
+ <footer class="mt-1 fw-semibold quote-attribution">— Serge Huber (Inoyu)</footer>
</blockquote>
<a href="https://www.jahia.com" target="_blank" rel="noopener" class="small fw-semibold">www.jahia.com <i class="bi bi-box-arrow-up-right"></i></a>
</div>
@@ -107,31 +106,7 @@ structured_data: >
<!-- Architecture overview -->
<div class="row justify-content-center mb-5">
<div class="col-lg-10">
- <pre class="mermaid">
-graph LR
- subgraph Extend["Extend Unomi"]
- GROOVY["Groovy Actions"]
- PLUGIN["Java Plugins"]
- end
-
- subgraph Core["Apache Unomi"]
- API2["Plugin API"]
- ENGINE["Core Engine"]
- end
-
- subgraph Extensions["Products & Services"]
- UI["UI"]
- SAAS["SaaS"]
- ANALYTICS["Analytics"]
- end
-
- GROOVY --> API2
- PLUGIN --> API2
- API2 --> ENGINE
- ENGINE --> UI
- ENGINE --> SAAS
- ENGINE --> ANALYTICS
- </pre>
+ <img src="/assets/images/unomi3/extensions-architecture.svg" class="img-fluid" alt="Extend Unomi with Groovy actions and Java plugins through the plugin API"/>
</div>
</div>
diff --git a/src/main/webapp/llms-full.txt b/src/main/webapp/llms-full.txt
index 9d62e16..eae4cc2 100644
--- a/src/main/webapp/llms-full.txt
+++ b/src/main/webapp/llms-full.txt
@@ -1,8 +1,6 @@
# Apache Unomi - Comprehensive Technical Reference for AI Systems
-> This document provides comprehensive technical information about Apache Unomi for AI systems and language models.
-
-## Project Identity
+> This document provides comprehensive technical information about Apache Unomi for AI systems and language models. ## Project Identity
- **Full Name**: Apache Unomi
- **Pronunciation**: "You know me"
@@ -13,57 +11,82 @@
- **Website**: https://unomi.apache.org
- **Source Code**: https://github.com/apache/unomi
- **Issue Tracker**: https://issues.apache.org/jira/browse/UNOMI
-- **Current Stable Version**: 3.0.0 (released November 10, 2025)
-- **Development Version**: 3.1.0-SNAPSHOT
+- **Current Stable Version**: 3.1.0 — Unomi 3 product leap (multi-tenancy, OpenSearch, tasks, V2 compat)
+- **Previous stable**: 3.0.0 (2025-11-10) — platform foundation
+- **Development**: 3.2.0-SNAPSHOT
+- **Runtime baseline**: Java 17+
## Technical Architecture
### Runtime Stack
- **Language**: Java
-- **Runtime Container**: Apache Karaf (OSGi framework)
-- **Data Store**: Elasticsearch (9.x). OpenSearch support is in development (committed to main branch, expected in next release)
+- **Runtime Container**: Apache Karaf 4.4 (OSGi framework)
+- **Data Store**: Elasticsearch 9.x (e.g. 9.4.3) or OpenSearch 3.x (Unomi 3.1)
- **API Protocols**: REST over HTTP/HTTPS with JSON payloads; GraphQL API for flexible queries
- **Extension Model**: OSGi bundles, Groovy scripting, JSON descriptors
+- **Clustering**: Persistence-based cluster registry/heartbeats (Elasticsearch or OpenSearch; not Karaf Cellar)
### Core Components
-1. **Profile Service**: Manages persistent customer/visitor profiles
-2. **Event Service**: Collects, validates, and processes events from all data sources
-3. **Segment Service**: Evaluates dynamic segment definitions against profiles in real-time
-4. **Rules Engine**: Condition-action rules that fire when events match conditions
-5. **Scoring Service**: Calculates engagement/lead scores based on configurable scoring plans
-6. **Privacy Service**: Manages consent, anonymization, data export, and profile deletion
-7. **Plugin System**: OSGi-based plugins with JSON metadata for extending conditions, actions, and types
-8. **GraphQL API**: Flexible query interface for profiles, events, segments, and rules with field-level selection
+1. **Tenant Service** (Unomi 3.1): Tenant isolation, public/private API keys, usage and event-retention APIs
+2. **Profile Service**: Manages persistent customer/visitor profiles (tenant-scoped)
+3. **Event Service**: Collects, validates, and processes events from all data sources
+4. **Segment Service**: Evaluates dynamic segment definitions against profiles in real-time
+5. **Rules Engine**: Condition-action rules that fire when events match conditions
+6. **Scoring Service**: Calculates engagement/lead scores based on configurable scoring plans
+7. **Privacy Service**: Manages consent, anonymization, data export, and profile deletion
+8. **Task Scheduler** (Unomi 3.1): Cluster-aware background tasks (`/cxs/tasks`)
+9. **Plugin System**: OSGi-based plugins with JSON metadata for extending conditions, actions, and types
+10. **GraphQL API**: Flexible query interface for profiles, events, segments, and rules with field-level selection
### Data Flow
-1. External systems (web, mobile, CRM, IoT) send events to the REST API
-2. Events are validated and associated with a profile (identified by cookie, ID, or custom identifier)
+1. External systems (web, mobile, CRM, IoT, AI agents) send events to the REST API with **tenant resolution** (public API key header or private-key basic auth in native 3.1 mode)
+2. Events are validated (JSON Schema) and associated with a profile (identified by cookie, ID, or custom identifier)
3. Rules engine evaluates conditions and triggers actions (update profile, send to segment, etc.)
4. Segments are re-evaluated in real-time when profile properties change
5. Scores are recalculated based on segment membership and event history
6. External systems query profiles and segments to deliver personalized experiences
-### REST API Endpoints
+### Authentication (Unomi 3.1)
+
+| Audience | Credential | Typical use |
+|---|---|---|
+| System admin | `karaf:karaf` (basic) | Create/list tenants, cluster ops |
+| Tenant admin | `tenantId:privateApiKey` (basic) | Scopes, rules, schemas, searches |
+| Public apps / trackers | `X-Unomi-Api-Key: <public>` | `/cxs/context.json`, `/cxs/eventcollector` |
+
+Optional **V2 compatibility mode** helps phase older Unomi 2.x clients during upgrades. See https://unomi.apache.org/blog/migrating-to-unomi-3.html
+
+### REST API Endpoints (selected)
+- `/cxs/tenants` - Tenant CRUD and API key management (system admin)
+- `/cxs/tenants/{tenantId}/usage` - Per-tenant usage metrics
+- `/cxs/tenants/{tenantId}/purge/events` - Event retention purge
- `/cxs/profiles` - Profile CRUD operations
- `/cxs/events` - Event collection and querying
+- `/cxs/eventcollector` - Public event collector (requires public API key in 3.1)
- `/cxs/segments` - Segment management
- `/cxs/rules` - Rules management
- `/cxs/scoring` - Scoring plans
- `/cxs/campaigns` - Campaign tracking
- `/cxs/goals` - Goal tracking
- `/cxs/definitions` - Type definitions
+- `/cxs/jsonSchema` - JSON Schema registration for custom events
+- `/cxs/tasks` - Cluster-aware task scheduler
- `/cxs/cluster` - Cluster management
- `/cxs/privacy` - Privacy operations (consent, anonymize, delete)
-- `/cxs/context.json` - Context servlet (main entry point for web tracking, returns personalized content)
+- `/cxs/context.json` - Context servlet (main public entry for web tracking; requires public API key in 3.1)
- `/graphql` - GraphQL API endpoint for flexible queries
+OpenAPI stability note: all **119** documented Unomi 2.x OpenAPI paths remain present in 3.1; new capabilities are additive.
+
### Key Concepts
+- **Tenant**: Isolated data space (profiles, events, segments, rules, schemas) with public and private API keys
- **Profile**: A persistent record of a visitor/customer with properties, segments, and scores
- **Event**: An action or occurrence associated with a profile (page view, click, form submit, purchase, custom)
- **Segment**: A dynamic group of profiles matching certain conditions (e.g., "visited pricing page AND from France")
- **Rule**: A condition-action pair that fires when an event matches (e.g., "when login event → merge anonymous profile")
- **Scoring Plan**: A set of rules that add/subtract points to a profile score
- **Consent**: GDPR consent record with type, status, and timestamp
+- **Scope**: Digital property namespace for events (website, app, …) under a tenant
## Standards Compliance
@@ -76,7 +99,7 @@ Apache Unomi is the **reference implementation** of the OASIS Customer Data Plat
- Profile deletion (complete removal of all profile data)
- Data portability (export profile data in JSON)
- Server-side DoNotTrack support
-- Configurable data retention policies
+- Configurable data retention policies (including tenant event purge APIs in 3.1)
- Cookie-less tracking option
## Connectors & Integrations
@@ -87,28 +110,30 @@ Apache Unomi is the **reference implementation** of the OASIS Customer Data Plat
### Extension Points
- Custom actions (Groovy recommended, Java for advanced cases)
-- Custom conditions (Java)
+- Custom conditions (Java) — Elasticsearch and OpenSearch query-builder variants
- Custom property types
- Custom event types
- REST API extensions
## CDP in an AI-First World
-AI models and autonomous agents require clean, unified, real-time customer data. Apache Unomi serves as the **customer data backbone for AI-first architectures**:
+**Message hierarchy:** (1) Apache Unomi 3 major release · (2) Multi-tenancy platform leap · (3) AI agents as customer-memory use case.
+
+AI models and autonomous agents require clean, unified, real-time customer data. Apache Unomi serves as the **customer data backbone for AI-first architectures**. Unomi is **not an LLM** — it is privacy-first customer memory agents query and update.
### Why a CDP Matters for AI
-- **Context is everything**: LLMs, chatbots, support copilots, and recommendation engines produce dramatically better results when they have access to real customer context (profile properties, segments, recent events, purchase history). Unomi's REST API (`/cxs/context.json`, `/cxs/profiles`) makes this data available in real time.
-- **First-party data advantage**: Third-party cookies are deprecated. Privacy regulations (GDPR, CCPA) restrict data sharing. The most valuable and legally defensible data for AI training and prompt augmentation is first-party data that you collect and control through your own CDP.
-- **Privacy-safe AI processing**: AI processing customer data raises serious compliance risks. Unomi's built-in consent management, anonymization, and data deletion capabilities ensure your AI systems only operate on data customers have explicitly consented to share.
-- **Real-time feedback loop**: AI-powered personalization requires a closed loop — events feed into profiles, profiles feed into AI models, AI decisions feed back as new events. Unomi's event-profile-rules-segment pipeline processes this in real time.
-- **Vendor-neutral architecture**: Unlike proprietary CDPs locked to specific AI providers, Unomi is open source. Connect OpenAI, Anthropic, Google AI, local/self-hosted models, or custom ML pipelines — all via standard REST/JSON.
+- **Context is everything**: LLMs, chatbots, support copilots, and recommendation engines need real customer context via REST (`/cxs/context.json`, `/cxs/profiles`) with tenant API keys in 3.1.
+- **First-party data advantage**: Privacy regulations restrict data sharing; first-party CDP data is the defensible source for AI context.
+- **Privacy-safe AI processing**: Consent management, anonymization, and deletion gate what agents may access.
+- **Real-time feedback loop**: Events → profiles → AI → events; Unomi processes this pipeline in real time.
+- **Vendor-neutral**: OpenAI, Anthropic, Google AI, local models, MCP tools, or custom pipelines via REST/JSON.
### AI Integration Patterns
-1. **RAG (Retrieval-Augmented Generation)**: Query Unomi profiles and segments to enrich LLM prompts with customer context
-2. **AI agent tools**: Expose Unomi API as a tool for AI agents (e.g., "look up customer profile", "check segment membership")
-3. **Predictive scoring**: Feed event streams to ML models, write predictions back as profile properties via rules
-4. **Smart segmentation**: Use AI to discover segments from behavioral patterns, create them in Unomi via the segments API
-5. **Conversational AI**: Give chatbots access to the full customer journey for context-aware, personalized conversations
+1. **RAG**: Query Unomi profiles/segments to enrich LLM prompts
+2. **AI agent tools**: Expose Unomi APIs as agent tools
+3. **Predictive scoring**: ML predictions written back as profile properties
+4. **Smart segmentation**: Discover segments, create via segments API
+5. **Conversational AI**: Chatbots with full customer-journey context
## Ecosystem
@@ -119,7 +144,7 @@ AI models and autonomous agents require clean, unified, real-time customer data.
- **Inoyu SaaS**: Fully managed cloud-hosted Unomi service (coming soon)
### Commercial Support Providers
-- **Inoyu** (https://www.inoyu.dev): Founded by original Unomi developer, CDP implementations and extensions
+- **Inoyu** (https://www.inoyu.dev): CDP implementations, commercial extensions and support
- **Yupiik** (https://www.yupiik.com): Apache expert team, multiple ASF project contributors
## Community Resources
@@ -134,46 +159,68 @@ AI models and autonomous agents require clean, unified, real-time customer data.
## Bill of Materials (BOM)
Starting with Unomi 3.0, the project uses a two-layer BOM for dependency management:
-- **unomi-bom** (https://github.com/apache/unomi/blob/master/bom/pom.xml): Main BOM importing Karaf BOM and managing all third-party dependency versions (Jackson, CXF, Elasticsearch, Groovy, GraphQL, etc.)
-- **unomi-bom-artifacts** (https://github.com/apache/unomi/blob/master/bom/artifacts/pom.xml): Manages all Unomi module artifacts for consistent versioning in custom extensions
+- **unomi-bom** (https://github.com/apache/unomi/blob/master/bom/pom.xml): Main BOM importing Karaf BOM and managing all third-party dependency versions
+- **unomi-bom-artifacts** (https://github.com/apache/unomi/blob/master/bom/artifacts/pom.xml): Manages all Unomi module artifacts for custom extensions
-Extension developers can import `unomi-bom` in their `pom.xml` to automatically align with tested dependency versions.
+## Quick Start (Docker — Unomi 3.1)
-## Quick Start (Docker)
+Elasticsearch path (OpenSearch compose: https://unomi.apache.org/get-started.html#quickstart):
```yaml
version: '3.8'
services:
elasticsearch:
- image: docker.elastic.co/elasticsearch/elasticsearch:9.1.3
+ image: docker.elastic.co/elasticsearch/elasticsearch:9.4.3
environment:
- discovery.type=single-node
- xpack.security.enabled=false
ports:
- 9200:9200
unomi:
- image: apache/unomi:3.0.0
+ image: apache/unomi:3.1.0
environment:
- UNOMI_ELASTICSEARCH_ADDRESSES=elasticsearch:9200
+ - UNOMI_THIRDPARTY_PROVIDER1_IPADDRESSES=0.0.0.0/0,::1,127.0.0.1
ports:
- 8181:8181
- 9443:9443
+ - 8102:8102
depends_on:
- elasticsearch
```
-Run with `docker-compose up`, verify at https://localhost:9443/cxs/cluster (credentials: karaf/karaf).
+```
+docker compose up
+```
+
+Create a tenant, then call context with the public API key:
+
+```
+curl -X POST http://localhost:8181/cxs/tenants \
+ --user karaf:karaf \
+ -H "Content-Type: application/json" \
+ -d '{"requestedId":"default","properties":{"name":"Default Tenant"}}'
+
+curl -X POST "http://localhost:8181/cxs/context.json?sessionId=1234" \
+ -H "Content-Type: application/json" \
+ -H "X-Unomi-Api-Key: YOUR_PUBLIC_API_KEY" \
+ -d '{"source":{"itemId":"homepage","itemType":"page","scope":"default"}}'
+```
+
+Cluster check: `https://localhost:9443/cxs/cluster` (`karaf`/`karaf`).
+Guides: https://unomi.apache.org/get-started.html · https://unomi.apache.org/tutorial.html
## Frequently Asked Questions
-- **What is Apache Unomi?** An open source Customer Data Platform (CDP) managed by the Apache Software Foundation. It collects customer data from any source, builds unified profiles, enables real-time segmentation and personalization, and includes built-in GDPR compliance.
-- **How does Unomi differ from proprietary CDPs?** It is 100% open source (Apache License 2.0), self-hosted, vendor-neutral, and extensible through OSGi plugins. No vendor lock-in, no per-profile pricing.
-- **What storage backends are supported?** Elasticsearch (9.x) in the current release. OpenSearch support has been committed to the main branch and is expected in the next release.
-- **Does Unomi have a GraphQL API?** Yes, Unomi 3.0 includes a GraphQL API alongside the REST API for flexible querying of profiles, events, segments, and rules.
-- **Can I use Unomi with AI systems?** Yes. Feed unified customer profiles, segments, and event streams to AI agents, LLMs, chatbots, recommendation engines, and ML models via REST or GraphQL API. Built-in consent management ensures AI only processes consented data.
-- **What is the OASIS CXS standard?** A Customer Data Platform specification from OASIS. Apache Unomi is its reference implementation.
-- **How do I extend Unomi?** Through OSGi bundles (Java), Groovy scripts, JSON descriptors for custom conditions/actions, and REST API extensions.
-- **What is the Bill of Materials (BOM)?** Starting with Unomi 3.0, the project provides a Maven BOM (`unomi-bom`) to centralize dependency versions for extension developers.
+- **What is Apache Unomi?** An open source Customer Data Platform (CDP) managed by the Apache Software Foundation.
+- **What is Unomi 3 vs 3.1?** 3.0 is the platform foundation (ES9 client, Karaf 4.4, Java 17+, persistence clustering). 3.1 is the product leap: multi-tenancy/API keys (major platform refactor), OpenSearch, task scheduler, V2 compatibility mode, stronger tests.
+- **How does Unomi differ from proprietary CDPs?** 100% open source (Apache License 2.0), self-hosted, vendor-neutral, extensible through OSGi plugins.
+- **What storage backends are supported?** Elasticsearch 9.x and OpenSearch 3.x (Unomi 3.1).
+- **Does Unomi have a GraphQL API?** Yes, alongside REST.
+- **Can I use Unomi with AI systems?** Yes — privacy-first customer memory for agents (not an LLM), via REST/GraphQL with consent gates and tenant API keys in 3.1.
+- **What is the OASIS CXS standard?** A CDP specification from OASIS; Apache Unomi is its reference implementation.
+- **How do I extend Unomi?** OSGi bundles (Java), Groovy scripts, JSON descriptors, REST extensions.
+- **What is the Bill of Materials (BOM)?** Maven BOM (`unomi-bom`) since Unomi 3.0 for extension dependency alignment.
## History
@@ -181,4 +228,14 @@ Run with `docker-compose up`, verify at https://localhost:9443/cxs/cluster (cred
- **2015**: Entered Apache Incubator
- **2019**: Graduated to Apache Top-Level Project
- **2022**: Version 2.0.0 released (major architecture update)
-- **2025**: Version 3.0.0 released (current stable, major upgrade to Karaf 4.4, new Elasticsearch Java client 9.x, GraphQL API, Bill of Materials for dependency management). OpenSearch support committed to main branch (expected in next release)
+- **2025**: Version 3.0.0 released (Unomi 3 foundation — Karaf 4.4, Elasticsearch Java client 9.x, GraphQL API, BOM, persistence clustering)
+- **2026**: Version 3.1.0 released (current stable — multi-tenancy major refactor, OpenSearch 3.x, cluster task scheduler, V2 API compatibility)
+
+## Unomi 3 Blog (UNOMI-932)
+
+- https://unomi.apache.org/blog/
+- https://unomi.apache.org/blog/welcome-to-the-apache-unomi-blog.html
+- https://unomi.apache.org/blog/introducing-apache-unomi-3.html
+- https://unomi.apache.org/blog/unomi-3-multitenancy.html
+- https://unomi.apache.org/blog/unomi-3-ai-agents.html
+- https://unomi.apache.org/blog/migrating-to-unomi-3.html
diff --git a/src/main/webapp/llms.txt b/src/main/webapp/llms.txt
index c0af81f..3979623 100644
--- a/src/main/webapp/llms.txt
+++ b/src/main/webapp/llms.txt
@@ -8,10 +8,10 @@
- **Type**: Customer Data Platform (CDP)
- **License**: Apache License 2.0
- **Language**: Java
-- **Runtime**: Apache Karaf (OSGi)
-- **Storage**: Elasticsearch (9.x); OpenSearch support coming in next release
+- **Runtime**: Apache Karaf (OSGi); Java 17+ required (runtime baseline, not a marketed feature)
+- **Storage**: Elasticsearch 9.x (e.g. 9.4.3) or OpenSearch 3.x (Unomi 3.1)
- **API**: REST/JSON & GraphQL
-- **Current Stable Version**: 3.0.0
+- **Current Stable Version**: 3.1.0 (Apache Unomi 3 product leap)
- **Website**: https://unomi.apache.org
- **Source Code**: https://github.com/apache/unomi
- **Issue Tracker**: https://issues.apache.org/jira/browse/UNOMI
@@ -28,37 +28,58 @@
- **Plugin Architecture**: Extend functionality through OSGi plugins, Groovy actions, and JSON descriptors
- **Connectors**: MailChimp and custom connectors via plugin API (Salesforce connector was deprecated)
- **GraphQL API**: Flexible query API for profiles, events, segments, and rules
-- **Multi-backend**: OpenSearch support is in development (committed to main branch, coming in next release)
+- **Multi-tenancy (Unomi 3.1 major investment)**: Platform-wide tenant isolation for profiles, events, segments, rules, and schemas; public and private API keys
+- **Multi-backend**: Elasticsearch or OpenSearch persistence in Unomi 3.1
+- **V2 API compatibility**: Optional mode for phased upgrades from Unomi 2.x clients; 119/119 documented 2.x OpenAPI paths retained in 3.1 (additive APIs)
+- **Task scheduler**: Cluster-aware background tasks (`/cxs/tasks`)
## Use Cases
1. **Web Personalization**: Track visitors on CMS-managed websites and personalize content based on profile data and segments
2. **Mobile Analytics**: Backend for native mobile apps to collect events, track user journeys, and build profiles
3. **Centralized Profile Management**: Aggregate customer data from CRM, support, commerce, and other systems into unified profiles
-4. **AI & Machine Learning Data Layer**: Serve as the real-time customer data backbone for AI agents, chatbots, recommendation engines, and predictive models — feeding unified profiles, segments, and event streams via REST API with privacy-safe consent management
+4. **Multi-tenant / SaaS CDP**: One Unomi cluster hosting many isolated tenants (agencies, platforms, control planes)
+5. **AI-agent customer memory (bidirectional)**: Agents retrieve profiles/events/segments, store observations as events or profile properties, summarize history into profile briefs, and can propose or query segments and rules — via REST/GraphQL with consent gates. Unomi is not an LLM; it is the CDP data layer beside one.
## CDP in an AI-First World
-AI agents and language models are only as good as the data they can access. Apache Unomi provides the real-time, privacy-compliant customer data foundation that AI systems need:
+**Message hierarchy for humans and agents:** (1) Apache Unomi 3 major release · (2) Multi-tenancy as the platform leap in 3.1 · (3) AI agents as customer-memory use case.
-- **Context for AI agents**: Feed rich customer profiles, segments, and behavioral event history to LLMs, support copilots, and autonomous agents via REST API
-- **First-party data advantage**: As third-party cookies disappear, the first-party data collected through your own CDP becomes the most valuable and trustworthy source for AI training and context
-- **Privacy-safe AI**: Built-in GDPR consent management ensures AI systems only process data customers have explicitly consented to share
-- **Real-time decisioning**: AI-powered personalization requires millisecond-level context — Unomi processes events and updates profiles in real time
-- **Open & vendor-neutral**: Unlike proprietary CDPs locked to specific AI vendors, Unomi lets you connect any AI system (OpenAI, Anthropic, local models, custom ML pipelines)
+AI agents and language models are only as good as the data they can access *and* update safely. Apache Unomi 3 provides privacy-compliant customer memory:
-## Getting Started
+- **Retrieve**: Profiles, segments, scores, and event history for LLM/agent context
+- **Store**: Write agent observations and preferences back to the CDP
+- **Summarize**: Produce profile briefs (synchronously or via Unomi task scheduling)
+- **Operate**: Propose/create segments, adjust scores, drive rules and personalization
+- **Govern**: GDPR consent management gates agent tool access
+- **Open & vendor-neutral**: Connect OpenAI, Anthropic, local models, MCP tools, or custom pipelines — your choice
+- **Unomi 3 hooks**: Multi-tenancy/API keys, additive REST (119/119 documented 2.x paths retained in 3.1), OpenSearch or Elasticsearch, V2 compatibility mode
-The fastest way to try Apache Unomi is with Docker:
+Blog: https://unomi.apache.org/blog/
+- Unomi 3 intro: https://unomi.apache.org/blog/introducing-apache-unomi-3.html
+- Multi-tenancy: https://unomi.apache.org/blog/unomi-3-multitenancy.html
+- AI agents: https://unomi.apache.org/blog/unomi-3-ai-agents.html
+- Migrate from 2.x: https://unomi.apache.org/blog/migrating-to-unomi-3.html
+
+## Getting Started (Unomi 3.1)
+
+The fastest way to try Apache Unomi 3.1 is with Docker Compose (Elasticsearch 9.4.3 or OpenSearch 3.x):
```
-docker-compose up
+docker compose up
```
-Using the provided docker-compose.yml with Elasticsearch and Apache Unomi 3.0.0.
+Then create a tenant (`POST /cxs/tenants` as `karaf:karaf`) and save the returned API keys:
+
+- **Public key** → header `X-Unomi-Api-Key` for `/cxs/context.json` and `/cxs/eventcollector`
+- **Private key** → basic auth `tenantId:privateApiKey` for admin APIs (scopes, rules, schemas, searches)
+
+System admin (`karaf:karaf`) is for tenant management and cluster operations, not for public context/event calls in native 3.1 mode.
Full getting started guide: https://unomi.apache.org/get-started.html
Docker quick start: https://unomi.apache.org/get-started.html#quickstart
+Auth overview: https://unomi.apache.org/get-started.html#auth
+Tutorials: https://unomi.apache.org/tutorial.html
## Documentation
@@ -89,14 +110,15 @@ Docker quick start: https://unomi.apache.org/get-started.html#quickstart
## Architecture
-Apache Unomi is a REST server. Data sources (web, mobile, CRM, IoT) send events via the REST API. The processing engine stores data in Elasticsearch, evaluates segments and rules in real-time, and outputs personalization decisions, scores, and data exports. All communication is JSON over HTTP/HTTPS. A GraphQL API is also available for flexible querying of profiles, events, segments, and rules.
+Apache Unomi is a REST server. Data sources (web, mobile, CRM, IoT, AI agents) send events via the REST API with tenant resolution (public API key or private-key basic auth in 3.1). The processing engine stores data in Elasticsearch or OpenSearch, evaluates segments and rules in real-time, and outputs personalization decisions, scores, and data exports. All communication is JSON over HTTP/HTTPS. A GraphQL API is also available for flexible querying of profiles, events, segments, and rules.
## Frequently Asked Questions
- **What is Apache Unomi?** An open source Customer Data Platform (CDP) managed by the Apache Software Foundation that unifies customer data, enables real-time segmentation and personalization, and provides built-in GDPR compliance.
-- **How do I get started?** Use Docker Compose for the fastest setup: https://unomi.apache.org/get-started.html#quickstart
-- **What storage does it use?** Elasticsearch (9.x). OpenSearch support is in development and will be available in the next release.
-- **Does it have a GraphQL API?** Yes, Unomi 3.0 includes a GraphQL API alongside the REST API.
+- **What is Apache Unomi 3?** Major CDP release: 3.0 modernizes the platform (Elasticsearch 9 client, Karaf 4.4, persistence clustering; Java 17+). 3.1 is the product leap — especially a platform-wide multi-tenancy refactor with API keys, plus OpenSearch, task scheduler, and V2 compatibility.
+- **How do I get started?** Docker Compose, then create a tenant and use API keys: https://unomi.apache.org/get-started.html#quickstart
+- **What storage does it use?** Elasticsearch 9.x or OpenSearch 3.x (Unomi 3.1).
+- **Does it have a GraphQL API?** Yes — GraphQL alongside REST.
- **Is it GDPR compliant?** Yes, with built-in consent management, data anonymization, profile deletion, and data portability.
-- **Can I use it with AI?** Yes — feed unified customer profiles and event data to AI agents, LLMs, recommendation engines, and predictive models via the REST or GraphQL API.
+- **Can I use it with AI?** Yes — Unomi is privacy-first customer memory for agents (retrieve, store, summarize, operate), not an LLM. REST or GraphQL with consent gates.
- **What is the OASIS CXS standard?** A Customer Data Platform specification from OASIS. Apache Unomi is its reference implementation.
diff --git a/src/main/webapp/resources.html b/src/main/webapp/resources.html
index 9e437da..42b573b 100644
--- a/src/main/webapp/resources.html
+++ b/src/main/webapp/resources.html
@@ -93,7 +93,7 @@ structured_data: >
</a>
<span class="badge badge-primary mb-2">Technical Deep Dive • Jan 2025</span>
<h3 class="h6 fw-semibold">Apache Unomi OpenSearch Contribution</h3>
- <p class="small text-muted mb-3">Presents the changes proposed to add OpenSearch support to Apache Unomi, including the dual persistence architecture and new tooling.</p>
+ <p class="small text-muted mb-3">Presented the dual-persistence architecture that became OpenSearch support in Unomi 3.1, including tooling for Elasticsearch and OpenSearch.</p>
<a href="https://www.youtube.com/watch?v=uNbKW29FCnE" target="_blank" rel="noopener" class="btn btn-primary btn-sm"><i class="bi bi-play-circle me-1"></i> Watch</a>
</div>
</div>
diff --git a/src/main/webapp/sitemap.xml b/src/main/webapp/sitemap.xml
index 82d3c74..69901b5 100644
--- a/src/main/webapp/sitemap.xml
+++ b/src/main/webapp/sitemap.xml
@@ -3,7 +3,7 @@
<!-- Homepage -->
<url>
<loc>https://unomi.apache.org/</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>weekly</changefreq>
<priority>1.0</priority>
</url>
@@ -11,49 +11,49 @@
<!-- Primary navigation pages -->
<url>
<loc>https://unomi.apache.org/get-started.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
<url>
<loc>https://unomi.apache.org/documentation.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
<url>
<loc>https://unomi.apache.org/download.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.9</priority>
</url>
<url>
<loc>https://unomi.apache.org/use-cases.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
<url>
<loc>https://unomi.apache.org/integrations.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
<url>
<loc>https://unomi.apache.org/tutorial.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.7</priority>
</url>
<url>
<loc>https://unomi.apache.org/resources.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.7</priority>
</url>
<url>
<loc>https://unomi.apache.org/stories.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.6</priority>
</url>
@@ -61,43 +61,43 @@
<!-- Community section -->
<url>
<loc>https://unomi.apache.org/community/</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
</url>
<url>
<loc>https://unomi.apache.org/community/team.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.6</priority>
</url>
<url>
<loc>https://unomi.apache.org/community/events/</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.6</priority>
</url>
<url>
<loc>https://unomi.apache.org/community/events/apachecon/</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.4</priority>
</url>
<url>
<loc>https://unomi.apache.org/community/events/meetups/2021-11-18.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.3</priority>
</url>
<url>
<loc>https://unomi.apache.org/community/policies.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.4</priority>
</url>
<url>
<loc>https://unomi.apache.org/community/maturity-model-report.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.3</priority>
</url>
@@ -105,73 +105,73 @@
<!-- Contribute section -->
<url>
<loc>https://unomi.apache.org/contribute/</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>monthly</changefreq>
<priority>0.7</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/become-a-committer.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.5</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/committer-guide.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.5</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/testing.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.5</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/dependencies-guide.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.5</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/release-guide.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.4</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/manual-release-guide.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.4</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/website.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.4</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/post-commit-guides.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.3</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/post-commit-policies-details.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.3</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/post-commit-test-policies.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.3</priority>
</url>
<url>
<loc>https://unomi.apache.org/contribute/pre-commit-test-policies.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.3</priority>
</url>
@@ -179,8 +179,51 @@
<!-- Other pages -->
<url>
<loc>https://unomi.apache.org/privacy-policy.html</loc>
- <lastmod>2026-02-09</lastmod>
+ <lastmod>2026-07-14</lastmod>
<changefreq>yearly</changefreq>
<priority>0.2</priority>
</url>
+
+ <url>
+ <loc>https://unomi.apache.org/blog/</loc>
+ <changefreq>weekly</changefreq>
+ <priority>0.8</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/welcome-to-the-apache-unomi-blog.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.7</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/introducing-apache-unomi-3.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.9</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-ai-agents.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.85</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/migrating-to-unomi-3.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-multitenancy.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.85</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/llms.txt</loc>
+ <lastmod>2026-07-14</lastmod>
+ <changefreq>weekly</changefreq>
+ <priority>0.5</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/llms-full.txt</loc>
+ <lastmod>2026-07-14</lastmod>
+ <changefreq>weekly</changefreq>
+ <priority>0.4</priority>
+ </url>
</urlset>
diff --git a/src/main/webapp/stories.html b/src/main/webapp/stories.html
index 805a520..8aee008 100644
--- a/src/main/webapp/stories.html
+++ b/src/main/webapp/stories.html
@@ -45,7 +45,7 @@ layout: default
<p class="small text-muted mb-3">The initial contributor of Apache Unomi, using it as the engine for their Customer Data Platform and Digital Experience Platform with native GDPR support.</p>
<blockquote class="small fst-italic text-muted border-start border-3 border-primary ps-3 mb-3">
“Apache Unomi is a very important foundation of our products. We love it and are deeply committed to helping our customers succeed with it.”
- <footer class="mt-1 fw-semibold quote-attribution">— Serge Huber, Jahia CTO</footer>
+ <footer class="mt-1 fw-semibold quote-attribution">— Serge Huber (Inoyu)</footer>
</blockquote>
<a href="https://www.jahia.com" target="_blank" rel="noopener" class="small fw-semibold">www.jahia.com <i class="bi bi-box-arrow-up-right"></i></a>
</div>
diff --git a/src/main/webapp/tutorial.html b/src/main/webapp/tutorial.html
index 5db0517..5219309 100644
--- a/src/main/webapp/tutorial.html
+++ b/src/main/webapp/tutorial.html
@@ -1,40 +1,40 @@
---
-title: Tutorials — Getting Started with Apache Unomi 3
-description: "Step-by-step tutorials for Apache Unomi 3.0: Docker quick start, manual installation, REST API basics, web tracking integration, and profile personalization."
-keywords: "Apache Unomi tutorial, step by step, beginner guide, CDP tutorial, profiles, events, segments, rules"
+title: Tutorials — Getting Started with Apache Unomi 3.1
+description: "Step-by-step tutorials for Apache Unomi 3.1: Docker (Elasticsearch or OpenSearch), tenants and API keys, REST API, web tracking, and personalization."
+keywords: "Apache Unomi 3.1 tutorial, API keys, multi-tenancy, Docker, OpenSearch, CDP tutorial, profiles, events, segments, rules"
layout: default
structured_data: >
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
- "name": "Getting Started with Apache Unomi 3",
- "description": "Learn how to set up and use Apache Unomi 3.0 as a Customer Data Platform with Docker, REST APIs, and web tracking.",
+ "name": "Getting Started with Apache Unomi 3.1",
+ "description": "Learn how to set up and use Apache Unomi 3.1 as a Customer Data Platform with Docker, tenants, API keys, REST APIs, and web tracking.",
"totalTime": "PT30M",
"step": [
{
"@type": "HowToStep",
"position": 1,
- "name": "Start Unomi with Docker",
- "text": "Create a docker-compose.yml and run docker-compose up to start Unomi with Elasticsearch."
+ "name": "Start Unomi 3.1 with Docker",
+ "text": "Create a docker-compose.yml and run docker compose up with Elasticsearch 9.4.3 or OpenSearch 3.x."
},
{
"@type": "HowToStep",
"position": 2,
- "name": "Verify the cluster",
- "text": "Access https://localhost:9443/cxs/cluster with credentials karaf/karaf to verify the installation."
+ "name": "Create a tenant",
+ "text": "POST /cxs/tenants as karaf/karaf and save the public and private API keys."
},
{
"@type": "HowToStep",
"position": 3,
"name": "Create a scope and send events",
- "text": "Use the REST API to create scopes, send events, and query profiles."
+ "text": "Use tenant private API key for admin APIs and X-Unomi-Api-Key for public endpoints."
},
{
"@type": "HowToStep",
"position": 4,
"name": "Integrate the web tracker",
- "text": "Add the Unomi web tracker to your web pages for automatic event collection and personalization."
+ "text": "Add tracking that sends the tenant public API key on context and event requests."
}
]
}
@@ -45,8 +45,8 @@ structured_data: >
<section class="page-header">
<div class="container">
<p class="section-label text-hero-label">Tutorials</p>
- <h1>Getting Started with Apache Unomi 3</h1>
- <p class="lead">From zero to a running CDP in minutes. Pick the path that suits you.</p>
+ <h1>Getting Started with Apache Unomi 3.1</h1>
+ <p class="lead">From zero to a running CDP with multi-tenancy and API keys. Pick the path that suits you.</p>
</div>
</section>
@@ -61,15 +61,15 @@ structured_data: >
<div class="col-md-6">
<ol class="small mb-0">
<li><a href="#docker-quickstart">Quick Start with Docker</a> <span class="badge badge-success">Recommended</span></li>
- <li><a href="#manual-install">Manual Installation</a></li>
+ <li><a href="#create-tenant">Create a Tenant</a> <span class="badge badge-primary">3.1</span></li>
<li><a href="#first-api-calls">Your First API Calls</a></li>
</ol>
</div>
<div class="col-md-6">
<ol class="small mb-0" start="4">
+ <li><a href="#manual-install">Manual Installation</a></li>
<li><a href="#web-tracking">Web Tracking Tutorial</a></li>
<li><a href="#rules-personalization">Rules & Personalization</a></li>
- <li><a href="#next-steps">Next Steps</a></li>
</ol>
</div>
</div>
@@ -88,14 +88,13 @@ structured_data: >
<div class="col-lg-10">
<span class="badge badge-primary mb-3">Step 1</span>
<h2>Quick Start with Docker</h2>
- <p class="text-muted">The fastest way to get Unomi running. You only need <a href="https://docs.docker.com/get-docker/" target="_blank" rel="noopener">Docker</a> installed.</p>
+ <p class="text-muted">The fastest way to get Unomi 3.1 running. You only need <a href="https://docs.docker.com/get-docker/" target="_blank" rel="noopener">Docker</a>. Full compose options (including OpenSearch) are on the <a href="/get-started.html#quickstart">Getting Started</a> page.</p>
- <h3 class="h6 fw-semibold mt-4 mb-3">Create <code>docker-compose.yml</code></h3>
- <p>Create a new directory and add a <code>docker-compose.yml</code> file with the following content:</p>
+ <h3 class="h6 fw-semibold mt-4 mb-3">Create <code>docker-compose.yml</code> (Elasticsearch)</h3>
<pre><code>version: '3.8'
services:
elasticsearch:
- image: docker.elastic.co/elasticsearch/elasticsearch:9.1.3
+ image: docker.elastic.co/elasticsearch/elasticsearch:9.4.3
environment:
- discovery.type=single-node
- xpack.security.enabled=false
@@ -103,7 +102,7 @@ services:
- 9200:9200
unomi:
- image: apache/unomi:3.0.0
+ image: apache/unomi:{{ site.data.unomi.latest.stable.version }}
environment:
- UNOMI_ELASTICSEARCH_ADDRESSES=elasticsearch:9200
- UNOMI_THIRDPARTY_PROVIDER1_IPADDRESSES=0.0.0.0/0,::1,127.0.0.1
@@ -111,28 +110,21 @@ services:
- 8181:8181
- 9443:9443
- 8102:8102
- links:
- - elasticsearch
depends_on:
- elasticsearch</code></pre>
<h3 class="h6 fw-semibold mt-4 mb-3">Start the environment</h3>
- <p>From the same directory, run:</p>
<pre><code>docker compose up</code></pre>
<div class="alert alert-warning small" role="alert">
- <i class="bi bi-hourglass-split me-1"></i> Wait 1–2 minutes for both Elasticsearch and Unomi to fully initialize before testing.
+ <i class="bi bi-hourglass-split me-1"></i> Wait 1–2 minutes for both Elasticsearch and Unomi to fully initialize before continuing.
</div>
<h3 class="h6 fw-semibold mt-4 mb-3">Verify the cluster</h3>
- <p>Open your browser and navigate to:</p>
-<pre><code>https://localhost:9443/cxs/cluster</code></pre>
- <p class="small text-muted">Default credentials: <code>karaf</code> / <code>karaf</code>. Accept the self-signed certificate warning — it is expected in development mode.</p>
-
- <p>You can also verify Elasticsearch is running:</p>
-<pre><code>curl http://localhost:9200/_cat/health?format=json</code></pre>
+<pre><code>curl -k https://localhost:9443/cxs/cluster -u karaf:karaf</code></pre>
+ <p class="small text-muted">Default system credentials: <code>karaf</code> / <code>karaf</code>. Accept the self-signed certificate warning in development.</p>
<div class="alert alert-info small" role="alert">
- <i class="bi bi-info-circle me-1"></i> This Docker setup is for <strong>development and learning only</strong>. For production deployments, see the <a href="https://unomi.apache.org/manual/latest/index.html#_securing_a_production_environment">production security guide</a>.
+ <i class="bi bi-info-circle me-1"></i> Development only. Prefer OpenSearch? See <a href="/get-started.html#quickstart">Getting Started — Option B</a>. Production: <a href="https://unomi.apache.org/manual/latest/index.html#_securing_a_production_environment">security guide</a>.
</div>
</div>
</div>
@@ -141,6 +133,43 @@ services:
<hr class="section-divider">
+
+<hr class="section-divider">
+
+<!-- ============================================================ -->
+<!-- Create Tenant (Unomi 3.1) -->
+<!-- ============================================================ -->
+<section id="create-tenant" class="section">
+ <div class="container">
+ <div class="row justify-content-center">
+ <div class="col-lg-10">
+ <span class="badge badge-primary mb-3">Step 2 · Unomi 3.1</span>
+ <h2>Create a Tenant</h2>
+ <p class="text-muted">In Unomi 3.1, data lives under a <strong>tenant</strong>. Create one with the system admin user, then use the returned API keys for everything else.</p>
+<pre><code>curl -X POST http://localhost:8181/cxs/tenants \
+ --user karaf:karaf \
+ -H "Content-Type: application/json" \
+ -d '{
+ "requestedId": "default",
+ "properties": {
+ "name": "Default Tenant",
+ "description": "Tutorial tenant"
+ }
+ }'</code></pre>
+ <p class="small text-muted mt-3">From the response, copy:</p>
+ <ul class="small">
+ <li><code>YOUR_PUBLIC_API_KEY</code> — header <code>X-Unomi-Api-Key</code> for <code>/cxs/context.json</code> and <code>/cxs/eventcollector</code></li>
+ <li><code>YOUR_PRIVATE_API_KEY</code> — basic auth <code>default:YOUR_PRIVATE_API_KEY</code> for scopes, rules, schemas, searches</li>
+ </ul>
+ <div class="alert alert-warning small" role="alert">
+ <i class="bi bi-exclamation-triangle me-1"></i> Public endpoints reject requests without a valid public API key. Do not use <code>karaf:karaf</code> for context or event collector calls in native 3.1 mode.
+ </div>
+ <p class="small mb-0">More: <a href="/get-started.html#auth">Getting Started auth table</a> · <a href="/blog/unomi-3-multitenancy.html">Multi-tenancy post</a></p>
+ </div>
+ </div>
+ </div>
+</section>
+
<!-- ============================================================ -->
<!-- 2. Manual Installation -->
<!-- ============================================================ -->
@@ -148,41 +177,30 @@ services:
<div class="container">
<div class="row justify-content-center">
<div class="col-lg-10">
- <span class="badge badge-primary mb-3">Step 2 (alternative)</span>
+ <span class="badge badge-primary mb-3">Alternative to Docker</span>
<h2>Manual Installation</h2>
- <p class="text-muted">Prefer running Unomi directly on your machine? Follow these steps.</p>
+ <p class="text-muted">Prefer running Unomi 3.1 on your machine? Match the versions used in the project quick start.</p>
<h3 class="h6 fw-semibold mt-4 mb-3">Prerequisites</h3>
<ul class="small">
- <li><strong>Java 17</strong> or later — set <code>JAVA_HOME</code> accordingly. OpenJDK distributions work fine.</li>
- <li><strong>Elasticsearch 9.x</strong> — <a href="https://www.elastic.co/downloads/elasticsearch" target="_blank" rel="noopener">Download Elasticsearch</a></li>
+ <li><strong>Java 17</strong> or later — set <code>JAVA_HOME</code>. OpenJDK works fine.</li>
+ <li><strong>Elasticsearch 9.4.3</strong> <em>or</em> <strong>OpenSearch 3.x</strong></li>
</ul>
- <h3 class="h6 fw-semibold mt-4 mb-3">1. Configure & start Elasticsearch</h3>
- <p>After extracting Elasticsearch, edit <code>config/elasticsearch.yml</code>:</p>
-<pre><code>cluster.name: contextElasticSearch</code></pre>
- <p>Then start it:</p>
-<pre><code>bin/elasticsearch</code></pre>
+ <h3 class="h6 fw-semibold mt-4 mb-3">1. Start the search engine</h3>
+ <p><strong>Elasticsearch:</strong> set <code>cluster.name: contextElasticSearch</code> in <code>config/elasticsearch.yml</code>, then <code>bin/elasticsearch</code>.</p>
+ <p><strong>OpenSearch:</strong> set <code>cluster.name: opensearch-cluster</code> and <code>discovery.type: single-node</code>, then <code>bin/opensearch</code>. In Karaf use <code>unomi:setup -d=unomi-distribution-opensearch -f=true</code> before <code>unomi:start</code>.</p>
<h3 class="h6 fw-semibold mt-4 mb-3">2. Download & start Apache Unomi</h3>
- <p>Download the latest binary from the <a href="/download.html">download page</a>, extract it, then:</p>
-<pre><code># Start Apache Karaf
-./bin/karaf
-
-# In the Karaf shell, start Unomi
+ <p>Download the Unomi {{ site.data.unomi.latest.stable.version }} binary from the <a href="/download.html">download page</a>, extract it, then:</p>
+<pre><code>./bin/karaf
karaf@root()> unomi:start</code></pre>
- <p>Wait until you see the service initialization messages:</p>
-<pre><code>Initializing profile service endpoint...
-Initializing cluster service endpoint...</code></pre>
-
- <h3 class="h6 fw-semibold mt-4 mb-3">3. Verify</h3>
- <p>Open <a href="https://localhost:9443/cxs/cluster">https://localhost:9443/cxs/cluster</a> (credentials: <code>karaf</code>/<code>karaf</code>).</p>
- <p>Request your first context:</p>
-<pre><code>http://localhost:8181/cxs/context.json?sessionId=1234</code></pre>
+ <h3 class="h6 fw-semibold mt-4 mb-3">3. Tenant + context</h3>
+ <p>Create a tenant as in <a href="#create-tenant">Step 2</a>, then call context with <code>X-Unomi-Api-Key</code>. Cluster check: <code>https://localhost:9443/cxs/cluster</code> (<code>karaf</code>/<code>karaf</code>).</p>
<div class="alert alert-info small" role="alert">
- <i class="bi bi-terminal me-1"></i> <strong>Tip:</strong> Connect to the Karaf SSH console at any time with <code>ssh -p 8102 karaf@localhost</code> (password: <code>karaf</code>) for useful commands like <code>profile-list</code>, <code>event-tail</code>, and <code>rule-list</code>.
+ <i class="bi bi-terminal me-1"></i> <strong>Tip:</strong> SSH console <code>ssh -p 8102 karaf@localhost</code> — <code>profile-list</code>, <code>event-tail</code>, <code>rule-list</code>. Full detail: <a href="https://unomi.apache.org/manual/latest/index.html#_quick_start">manual quick start</a>.
</div>
</div>
</div>
@@ -200,18 +218,19 @@ Initializing cluster service endpoint...</code></pre>
<div class="col-lg-10">
<span class="badge badge-primary mb-3">Step 3</span>
<h2>Your First API Calls</h2>
- <p class="text-muted">With Unomi running, let’s explore the REST API using <code>curl</code>.</p>
+ <p class="text-muted">With Unomi 3.1 running and a tenant created, explore the REST API. Replace <code>YOUR_PUBLIC_API_KEY</code> / <code>YOUR_PRIVATE_API_KEY</code> with values from <a href="#create-tenant">Step 2</a>.</p>
<!-- Read context -->
<h3 class="h6 fw-semibold mt-4 mb-3">Read the current context</h3>
- <p>The <code>/cxs/context.json</code> endpoint is the primary public-facing endpoint. It returns the current visitor’s profile, session, segments, and scores:</p>
-<pre><code>curl -X POST http://localhost:8181/cxs/context.json?sessionId=1234 \
+ <p>The <code>/cxs/context.json</code> endpoint is the primary public endpoint. In 3.1 it requires a <strong>public API key</strong>:</p>
+<pre><code>curl -X POST "http://localhost:8181/cxs/context.json?sessionId=1234" \
-H "Content-Type: application/json" \
+ -H "X-Unomi-Api-Key: YOUR_PUBLIC_API_KEY" \
--data-raw '{
"source": {
"itemId": "homepage",
"itemType": "page",
- "scope": "example"
+ "scope": "default"
},
"requiredProfileProperties": ["*"],
"requiredSessionProperties": ["*"],
@@ -223,7 +242,7 @@ Initializing cluster service endpoint...</code></pre>
<h3 class="h6 fw-semibold mt-4 mb-3">Create a scope</h3>
<p>Events in Unomi must be associated with a <strong>scope</strong>. Create one before sending events:</p>
<pre><code>curl -X POST http://localhost:8181/cxs/scopes \
- -u karaf:karaf \
+ -u "default:YOUR_PRIVATE_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"itemId": "my-website",
@@ -238,7 +257,7 @@ Initializing cluster service endpoint...</code></pre>
<h3 class="h6 fw-semibold mt-4 mb-3">Send a custom event</h3>
<p>Before sending a custom event, register a <strong>JSON Schema</strong> to validate it (required since Unomi 2.0):</p>
<pre><code>curl -X POST http://localhost:8181/cxs/jsonSchema \
- -u karaf:karaf \
+ -u "default:YOUR_PRIVATE_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"$id": "https://unomi.apache.org/schemas/json/events/contactInfoSubmitted/1-0-0",
@@ -271,6 +290,7 @@ Initializing cluster service endpoint...</code></pre>
<p>Now send the event via the <strong>event collector</strong> (the public endpoint for submitting events):</p>
<pre><code>curl -X POST http://localhost:8181/cxs/eventcollector \
-H "Content-Type: application/json" \
+ -H "X-Unomi-Api-Key: YOUR_PUBLIC_API_KEY" \
--data-raw '{
"sessionId": "1234",
"events": [{
@@ -298,7 +318,7 @@ Initializing cluster service endpoint...</code></pre>
<h3 class="h6 fw-semibold mt-4 mb-3">Search events</h3>
<p>Retrieve events matching a condition:</p>
<pre><code>curl -X POST http://localhost:8181/cxs/events/search \
- -u karaf:karaf \
+ -u "default:YOUR_PRIVATE_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"offset": 0,
@@ -318,7 +338,7 @@ Initializing cluster service endpoint...</code></pre>
<h3 class="h6 fw-semibold mt-4 mb-3">View a profile</h3>
<p>Use the profile UUID (from the <code>context-profile-id</code> cookie or event response) to look up profile details:</p>
<pre><code>curl http://localhost:8181/cxs/profiles/PROFILE_UUID \
- -u karaf:karaf</code></pre>
+ -u "default:YOUR_PRIVATE_API_KEY"</code></pre>
<div class="alert alert-info small" role="alert">
<i class="bi bi-terminal me-1"></i> <strong>SSH Console shortcuts:</strong> <code>event-tail</code> watches events in real time, <code>event-list</code> shows recent events, <code>profile-list</code> lists recently modified profiles, <code>profile-view PROFILE_UUID</code> shows profile details.
@@ -339,11 +359,14 @@ Initializing cluster service endpoint...</code></pre>
<div class="col-lg-10">
<span class="badge badge-primary mb-3">Step 4</span>
<h2>Web Tracking Tutorial</h2>
- <p class="text-muted">Integrate the built-in Unomi web tracker into any web page to automatically collect page views and enable personalization.</p>
+ <p class="text-muted">Collect page views and enable personalization. Unomi 3.1 public endpoints require your tenant <strong>public API key</strong> on every context / event request.</p>
+ <div class="alert alert-info small" role="alert">
+ <i class="bi bi-key me-1"></i> If your tracker build accepts an API key option, set it to <code>YOUR_PUBLIC_API_KEY</code>. Otherwise ensure requests send header <code>X-Unomi-Api-Key</code> (see the <a href="https://unomi.apache.org/manual/latest/index.html#_how_to_build_a_javascript_web_tracker">JavaScript tracker guide</a> in the manual).
+ </div>
<!-- Install tracker -->
<h3 class="h6 fw-semibold mt-4 mb-3">Add the tracker to your page</h3>
- <p>Include the tracker script and initialize it:</p>
+ <p>Include the tracker script and initialize it (scope must exist under your tenant):</p>
<pre><code><!-- Load the Unomi web tracker -->
<script src="/tracker/unomi-web-tracker.min.js"></script>
@@ -375,7 +398,22 @@ Initializing cluster service endpoint...</code></pre>
"activateWem": true,
"trackerSessionIdCookieName": "my-website-session-id",
"trackerProfileIdCookieName": "my-website-profile-id"
+ // If supported by your tracker build, also set apiKey: "YOUR_PUBLIC_API_KEY"
+ }
+ };
+
+ // Unomi 3.1: ensure public endpoints receive the tenant public API key
+ var originalOpen = XMLHttpRequest.prototype.open;
+ var originalSend = XMLHttpRequest.prototype.send;
+ XMLHttpRequest.prototype.open = function() {
+ this._unomiUrl = arguments[1];
+ return originalOpen.apply(this, arguments);
+ };
+ XMLHttpRequest.prototype.send = function() {
+ if (this._unomiUrl && String(this._unomiUrl).indexOf("/cxs/") !== -1) {
+ this.setRequestHeader("X-Unomi-Api-Key", "YOUR_PUBLIC_API_KEY");
}
+ return originalSend.apply(this, arguments);
};
// Generate a new session if needed
@@ -430,7 +468,7 @@ const unomiWebTracker = useTracker();
<h3 class="h6 fw-semibold mt-4 mb-3">Create a rule that counts page views</h3>
<p>This rule increments a <code>pageViewCount</code> property on the visitor’s profile every time a <code>view</code> event is received:</p>
<pre><code>curl -X POST http://localhost:8181/cxs/rules \
- -u karaf:karaf \
+ -u "default:YOUR_PRIVATE_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"metadata": {
@@ -457,7 +495,7 @@ const unomiWebTracker = useTracker();
<h3 class="h6 fw-semibold mt-4 mb-3">Map event data to a profile</h3>
<p>This rule listens for the <code>contactInfoSubmitted</code> event (from Step 3) and copies its properties to the profile:</p>
<pre><code>curl -X POST http://localhost:8181/cxs/rules \
- -u karaf:karaf \
+ -u "default:YOUR_PRIVATE_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"metadata": {
@@ -556,7 +594,7 @@ unomiWebTracker.registerPersonalizationObject({
<div class="row justify-content-center">
<div class="col-lg-10">
<h2>Next Steps</h2>
- <p class="text-muted mb-4">You now have a working Unomi environment with event tracking, profile management, rules, and personalization. Here’s where to go next.</p>
+ <p class="text-muted mb-4">You now have a working Unomi 3.1 environment with a tenant, event tracking, profile management, rules, and personalization. Here’s where to go next.</p>
<div class="row g-4">
<div class="col-md-6">
@@ -575,6 +613,22 @@ unomiWebTracker.registerPersonalizationObject({
<a href="https://unomi.apache.org/rest-api-doc/index.html" class="small fw-semibold">Browse the API <i class="bi bi-arrow-right"></i></a>
</div>
</div>
+ <div class="col-md-6">
+ <div class="feature-card h-100">
+ <div class="feature-icon"><i class="bi bi-rocket-takeoff"></i></div>
+ <h3 class="h6 fw-semibold mb-2">Getting Started</h3>
+ <p class="small text-muted mb-2">Docker + OpenSearch paths, auth cheat sheet, and production notes.</p>
+ <a href="/get-started.html" class="small fw-semibold">Open Getting Started <i class="bi bi-arrow-right"></i></a>
+ </div>
+ </div>
+ <div class="col-md-6">
+ <div class="feature-card h-100">
+ <div class="feature-icon"><i class="bi bi-buildings"></i></div>
+ <h3 class="h6 fw-semibold mb-2">Multi-tenancy</h3>
+ <p class="small text-muted mb-2">How tenants and API keys work across the CDP.</p>
+ <a href="/blog/unomi-3-multitenancy.html" class="small fw-semibold">Read the deep dive <i class="bi bi-arrow-right"></i></a>
+ </div>
+ </div>
<div class="col-md-6">
<div class="feature-card h-100">
<div class="feature-icon"><i class="bi bi-puzzle"></i></div>
diff --git a/src/main/webapp/use-cases.html b/src/main/webapp/use-cases.html
index 6333da6..746f14d 100644
--- a/src/main/webapp/use-cases.html
+++ b/src/main/webapp/use-cases.html
@@ -1,9 +1,8 @@
---
title: Use Cases
description: "Apache Unomi use cases: web personalization, mobile analytics, profile management, and data backbone for AI agents and machine learning."
-keywords: "Apache Unomi use cases, web personalization, mobile analytics, customer profiles, AI CDP, machine learning, segmentation"
+keywords: "Apache Unomi use cases, AI agents CDP, LLM customer context, web personalization, mobile analytics, customer profiles, machine learning, segmentation"
layout: default
-mermaid: true
structured_data: >
<script type="application/ld+json">
{
@@ -62,24 +61,21 @@ structured_data: >
<div class="row g-5 align-items-center">
<div class="col-lg-6">
<span class="badge badge-primary mb-3">AI & Machine Learning</span>
- <h2>Data backbone for AI agents & copilots</h2>
- <p class="text-muted">In an AI-first world, models are only as good as the data they can access. Use Unomi as the real-time customer data layer that feeds AI agents, chatbots, recommendation engines, and predictive models with rich, privacy-compliant context.</p>
+ <h2>Customer memory for AI agents & copilots</h2>
+ <p class="text-muted">In an AI-first world, models are only as good as the data they can access <em>and</em> update safely. Use Apache Unomi 3 as privacy-first customer memory: agents retrieve context, store observations, summarize profiles, and operate segments — with consent built in. Unomi is not an LLM; it is the CDP data layer beside one.</p>
<ul class="list-unstyled small">
- <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Feed customer profiles and segments to LLMs for context-aware responses</span></li>
- <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Power recommendation engines with real-time behavioral data</span></li>
- <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Use rules to trigger AI workflows when specific events occur</span></li>
- <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Built-in consent management ensures AI only processes consented data</span></li>
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span><strong>Retrieve</strong> profiles, events, segments, and scores for context-aware responses</span></li>
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span><strong>Store</strong> preferences and conversation-derived facts as events / profile properties</span></li>
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span><strong>Summarize</strong> history into profile briefs (live or via scheduled tasks)</span></li>
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span><strong>Operate</strong> the CDP — propose segments, scores, and rules via API</span></li>
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Built-in consent management gates what agents may access</span></li>
</ul>
+ <p class="small mb-0"><a href="/blog/unomi-3-ai-agents.html">Read: Unomi 3 for AI agents</a></p>
</div>
<div class="col-lg-6 d-flex align-items-center justify-content-center">
- <pre class="mermaid">
-graph TD
- U["Apache Unomi"] -->|Profiles & Segments| AI["🤖 AI Agent / LLM"]
- U -->|Event Stream| ML["📊 ML Pipeline"]
- AI -->|Personalized Actions| APP["🌐 App / Website"]
- ML -->|Predictions| U
- APP -->|Events| U
- </pre>
+ <a href="/blog/unomi-3-ai-agents.html" class="d-block w-100" aria-label="Read Unomi 3 for AI agents">
+ <img src="/assets/images/unomi3/ai-agents-unomi.svg" class="img-fluid" alt="AI agents and Apache Unomi 3"/>
+ </a>
</div>
</div>
</div>
@@ -102,13 +98,7 @@ graph TD
</ul>
</div>
<div class="col-lg-6 d-flex align-items-center justify-content-center">
- <pre class="mermaid">
-graph TD
- V["🌐 Visitor"] -->|Page view| CMS["Web CMS"]
- CMS -->|Event| U["Apache Unomi"]
- U -->|Profile + Segments| CMS
- CMS -->|Personalized Content| V
- </pre>
+ <img src="/assets/images/unomi3/usecase-web-personalization.svg" class="img-fluid" alt="Web personalization flow with CMS and Apache Unomi"/>
</div>
</div>
</div>
@@ -131,14 +121,7 @@ graph TD
</ul>
</div>
<div class="col-lg-6 d-flex align-items-center justify-content-center">
- <pre class="mermaid">
-graph LR
- M["📱 Mobile App"] -->|Auth + Events| U["Apache Unomi"]
- U --> P["Profile Store"]
- U --> S["Segmentation"]
- U --> SC["Scoring"]
- B["📡 Beacons"] -->|Proximity| M
- </pre>
+ <img src="/assets/images/unomi3/usecase-mobile.svg" class="img-fluid" alt="Mobile app and beacons sending events to Apache Unomi"/>
</div>
</div>
</div>
@@ -161,16 +144,32 @@ graph LR
</ul>
</div>
<div class="col-lg-6 d-flex align-items-center justify-content-center">
- <pre class="mermaid">
-graph TD
- CRM["💼 CRM"] --> U["Apache Unomi"]
- FORUM["💬 Forum"] --> U
- CMS2["🌐 CMS"] --> U
- SHOP["🛒 Commerce"] --> U
- U --> PROFILE["Unified Profile"]
- PROFILE --> SEG["Segments"]
- PROFILE --> EXPORT["Export / Sync"]
- </pre>
+ <img src="/assets/images/unomi3/usecase-centralized-profiles.svg" class="img-fluid" alt="Centralized profile aggregation into Apache Unomi"/>
+ </div>
+ </div>
+ </div>
+</section>
+
+
+<hr class="section-divider">
+
+<!-- Use Case: Multi-tenancy -->
+<section class="section">
+ <div class="container">
+ <div class="row g-5 align-items-center">
+ <div class="col-lg-6">
+ <span class="badge badge-primary mb-3">Multi-tenancy · Unomi 3.1</span>
+ <h2>SaaS and multi-customer CDP deployments</h2>
+ <p class="text-muted">Unomi 3.1’s <strong>platform-wide multi-tenancy refactor</strong> lets one cluster host many isolated customer spaces — with public and private API keys, tenant-scoped profiles/events/segments/rules/schemas, and usage / retention APIs for control planes.</p>
+ <ul class="list-unstyled small">
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Public API keys for trackers and agent tools</span></li>
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Private keys for tenant admin APIs</span></li>
+ <li class="d-flex align-items-start mb-2"><i class="bi bi-check2 text-primary me-2 mt-1"></i><span>Elasticsearch or OpenSearch persistence</span></li>
+ </ul>
+ <p class="small mb-0"><a href="/blog/unomi-3-multitenancy.html">Read: Multi-tenancy in Unomi 3</a> · <a href="/get-started.html#auth">Auth overview</a></p>
+ </div>
+ <div class="col-lg-6 d-flex align-items-center justify-content-center">
+ <img src="/assets/images/unomi3/usecase-multitenancy.svg" class="img-fluid" alt="Multi-tenant Unomi cluster isolating customer data"/>
</div>
</div>
</div>
(unomi-site) 02/05: Add Unomi 3 quality/ops blog wave with SVGs (UNOMI-932)
Posted by sh...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
sergehuber pushed a commit to branch UNOMI-932-unomi3-major-release-story
in repository https://gitbox.apache.org/repos/asf/unomi-site.git
commit 99ac7ead4297964cf79b3379d6b8b3972eba75a2
Author: Serge Huber <sh...@apache.org>
AuthorDate: Wed Jul 15 09:50:09 2026 +0200
Add Unomi 3 quality/ops blog wave with SVGs (UNOMI-932)
Ship platform, OpenSearch, unit harness, shell, scheduler, tracing,
OpenAPI, IT/manual/build.sh posts plus index/sitemap wiring and
code-block contrast fixes.
---
src/main/webapp/assets/css/unomi.css | 24 ++-
src/main/webapp/assets/images/unomi3/build-sh.svg | 89 ++++++++
.../images/unomi3/it-progress-before-after.svg | 123 +++++++++++
.../assets/images/unomi3/manual-plantuml-theme.svg | 94 +++++++++
.../assets/images/unomi3/openapi-enrichment.svg | 77 +++++++
.../assets/images/unomi3/opensearch-dual.svg | 67 ++++++
.../assets/images/unomi3/platform-foundation.svg | 73 +++++++
.../assets/images/unomi3/request-tracing.svg | 65 ++++++
.../webapp/assets/images/unomi3/shell-commands.svg | 80 ++++++++
.../webapp/assets/images/unomi3/task-scheduler.svg | 71 +++++++
.../assets/images/unomi3/unit-harness-vs-it.svg | 18 +-
src/main/webapp/blog/index.html | 225 ++++++++++++++++++++-
src/main/webapp/blog/unomi-3-build-sh.html | 79 ++++++++
src/main/webapp/blog/unomi-3-it-execution.html | 96 +++++++++
src/main/webapp/blog/unomi-3-manual.html | 102 ++++++++++
.../webapp/blog/unomi-3-openapi-enrichment.html | 70 +++++++
src/main/webapp/blog/unomi-3-opensearch.html | 75 +++++++
.../webapp/blog/unomi-3-platform-foundation.html | 50 +++++
src/main/webapp/blog/unomi-3-request-tracing.html | 168 +++++++++++++++
src/main/webapp/blog/unomi-3-shell-commands.html | 116 +++++++++++
src/main/webapp/blog/unomi-3-task-scheduler.html | 102 ++++++++++
.../webapp/blog/unomi-3-unit-testing-harness.html | 84 ++++++++
src/main/webapp/sitemap.xml | 50 +++++
23 files changed, 1986 insertions(+), 12 deletions(-)
diff --git a/src/main/webapp/assets/css/unomi.css b/src/main/webapp/assets/css/unomi.css
index b1abb69..6e9de89 100644
--- a/src/main/webapp/assets/css/unomi.css
+++ b/src/main/webapp/assets/css/unomi.css
@@ -598,8 +598,8 @@ pre, code {
}
pre {
- background: var(--unomi-text);
- color: var(--unomi-border);
+ background: var(--unomi-text); /* slate-800 */
+ color: #f1f5f9; /* high-contrast light slate */
border-radius: var(--unomi-radius-sm);
padding: 1.25rem;
font-size: 0.85rem;
@@ -608,6 +608,26 @@ pre {
-webkit-overflow-scrolling: touch;
}
+pre code {
+ color: inherit;
+ background: transparent;
+ font-size: inherit;
+ padding: 0;
+}
+
+/* Light surface variant (opt-in) — keep text dark for contrast */
+pre.code-block-light,
+pre.bg-light {
+ background: var(--unomi-bg-soft) !important;
+ color: var(--unomi-text) !important;
+ border: 1px solid var(--unomi-border);
+}
+
+pre.code-block-light code,
+pre.bg-light code {
+ color: inherit;
+}
+
code {
font-size: 0.85em;
}
diff --git a/src/main/webapp/assets/images/unomi3/build-sh.svg b/src/main/webapp/assets/images/unomi3/build-sh.svg
new file mode 100644
index 0000000..ff949f5
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/build-sh.svg
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 380" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi build.sh: one entry point for preflight, Maven build, integration tests, and deploy">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ --term-bg: #0f172a;
+ --term-ok: #34d399;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+ </defs>
+
+ <rect width="840" height="380" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">One build entry point</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">./build.sh replaces scattered scripts | same path locally and in CI</text>
+
+ <rect x="300" y="100" width="240" height="72" rx="16" fill="var(--unomi-primary)" class="glow"/>
+ <text x="420" y="132" text-anchor="middle" fill="#ffffff" font-size="16" font-weight="700">./build.sh</text>
+ <text x="420" y="154" text-anchor="middle" fill="rgba(255,255,255,.85)" font-size="11">UNOMI-887 | build.ps1 twin</text>
+
+ <g class="float">
+ <rect x="40" y="210" width="170" height="120" rx="14" fill="var(--unomi-amber-bg)" stroke="var(--unomi-amber)" stroke-width="2"/>
+ <text x="125" y="242" text-anchor="middle" fill="var(--unomi-amber)" font-size="13" font-weight="700">Preflight</text>
+ <text x="125" y="268" text-anchor="middle" fill="var(--unomi-text)" font-size="11">Java | Maven | GraphViz</text>
+ <text x="125" y="290" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">memory | disk | ports</text>
+ <text x="125" y="312" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">clear failure output</text>
+ </g>
+
+ <g class="float" style="animation-delay:.3s">
+ <rect x="235" y="210" width="170" height="120" rx="14" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="320" y="242" text-anchor="middle" fill="var(--unomi-info)" font-size="13" font-weight="700">Build</text>
+ <text x="320" y="268" text-anchor="middle" fill="var(--unomi-text)" font-size="11">install | -B -ntp in --ci</text>
+ <text x="320" y="290" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">distributions | ES / OS</text>
+ <text x="320" y="312" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">optional --javadoc</text>
+ </g>
+
+ <g class="float" style="animation-delay:.6s">
+ <rect x="430" y="210" width="170" height="120" rx="14" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="515" y="242" text-anchor="middle" fill="var(--unomi-success)" font-size="13" font-weight="700">Test</text>
+ <text x="515" y="268" text-anchor="middle" fill="var(--unomi-text)" font-size="11">--integration-tests</text>
+ <text x="515" y="290" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">--single-test | --it-debug</text>
+ <text x="515" y="312" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">memory sampler</text>
+ </g>
+
+ <g class="float" style="animation-delay:.9s">
+ <rect x="625" y="210" width="175" height="120" rx="14" fill="var(--unomi-primary-light)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="712" y="242" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="13" font-weight="700">Run / Deploy</text>
+ <text x="712" y="268" text-anchor="middle" fill="var(--unomi-text)" font-size="11">--deploy | --karaf-home</text>
+ <text x="712" y="290" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">--debug | --auto-start</text>
+ <text x="712" y="312" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">GitHub Actions --ci</text>
+ </g>
+
+ <path d="M340 172 L 125 210" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+ <path d="M390 172 L 320 210" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+ <path d="M450 172 L 515 210" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+ <path d="M500 172 L 712 210" stroke="var(--unomi-primary)" stroke-width="2" class="flow"/>
+
+ <rect x="40" y="345" width="760" height="22" rx="6" fill="var(--term-bg)"/>
+ <text x="56" y="360" fill="var(--term-ok)" font-size="11" font-family="ui-monospace, Menlo, monospace">$ ./build.sh --ci --integration-tests --use-opensearch</text>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/it-progress-before-after.svg b/src/main/webapp/assets/images/unomi3/it-progress-before-after.svg
new file mode 100644
index 0000000..e7fb85e
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/it-progress-before-after.svg
@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 420" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Before and after Unomi integration test console output: noisy downloads versus progress bar with ETA">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-danger: #dc2626;
+ --unomi-danger-bg: #fef2f2;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ --term-bg: #0f172a;
+ --term-muted: #94a3b8;
+ --term-noise: #64748b;
+ --term-ok: #34d399;
+ --term-warn: #fbbf24;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes bar-grow {
+ 0% { width: 42px; }
+ 50% { width: 118px; }
+ 100% { width: 42px; }
+ }
+ @keyframes scroll-noise {
+ 0% { transform: translateY(0); opacity: .9; }
+ 100% { transform: translateY(-28px); opacity: .9; }
+ }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .bar-fill { animation: bar-grow 4.5s ease-in-out infinite; }
+ .noise-scroll { animation: scroll-noise 3.8s linear infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.bar-fill,.noise-scroll { animation: none !important; }
+ }
+</style>
+ <clipPath id="beforeClip">
+ <rect x="56" y="148" width="328" height="196" rx="8"/>
+ </clipPath>
+ <clipPath id="afterClip">
+ <rect x="456" y="148" width="328" height="196" rx="8"/>
+ </clipPath>
+ </defs>
+
+ <rect width="840" height="420" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">IT execution you can read</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Progress bars, quieter Maven/Docker noise, and signal when a long suite is moving</text>
+
+ <g>
+ <rect x="40" y="92" width="360" height="280" rx="18" fill="var(--unomi-danger-bg)" stroke="var(--unomi-danger)" stroke-width="2"/>
+ <text x="60" y="122" fill="var(--unomi-danger)" font-size="14" font-weight="700">BEFORE</text>
+ <text x="140" y="122" fill="var(--unomi-text-muted)" font-size="12">transfer spam | no ETA</text>
+
+ <rect x="56" y="138" width="328" height="212" rx="12" fill="var(--term-bg)"/>
+ <circle cx="74" cy="154" r="4" fill="#f87171"/>
+ <circle cx="88" cy="154" r="4" fill="#fbbf24"/>
+ <circle cx="102" cy="154" r="4" fill="#4ade80"/>
+ <text x="118" y="158" fill="var(--term-muted)" font-size="10" font-family="ui-monospace, SFMono-Regular, Menlo, monospace">ci | itests (old)</text>
+
+ <g clip-path="url(#beforeClip)">
+ <g class="noise-scroll" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="10">
+ <text x="68" y="178" fill="var(--term-noise)">Downloading from central: junit.jar</text>
+ <text x="68" y="194" fill="var(--term-noise)">Progress (1): 4.1/384 kB</text>
+ <text x="68" y="210" fill="var(--term-noise)">Progress (1): 48/384 kB</text>
+ <text x="68" y="226" fill="var(--term-noise)">Progress (2): 128 kB | 3.2/512 kB</text>
+ <text x="68" y="242" fill="var(--term-noise)">Downloaded from central: junit.jar</text>
+ <text x="68" y="258" fill="var(--term-noise)">Downloading from central: hamcrest.jar</text>
+ <text x="68" y="274" fill="var(--term-noise)">Progress (1): 7.2/45 kB</text>
+ <text x="68" y="290" fill="var(--term-noise)">[INFO] --- docker:start (elasticsearch)</text>
+ <text x="68" y="306" fill="var(--term-noise)">... thousands of identical lines ...</text>
+ <text x="68" y="322" fill="var(--term-noise)">Downloading from central: bundle.jar</text>
+ <text x="68" y="338" fill="var(--term-noise)">Progress (1): 16/902 kB</text>
+ <text x="68" y="354" fill="var(--term-muted)">Tests run: ??? ETA: unknown</text>
+ </g>
+ </g>
+ </g>
+
+ <g>
+ <rect x="440" y="92" width="360" height="280" rx="18" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="460" y="122" fill="var(--unomi-success)" font-size="14" font-weight="700">AFTER</text>
+ <text x="528" y="122" fill="var(--unomi-text-muted)" font-size="12">progress | ETA | slowest CSV</text>
+
+ <rect x="456" y="138" width="328" height="212" rx="12" fill="var(--term-bg)"/>
+ <circle cx="474" cy="154" r="4" fill="#f87171"/>
+ <circle cx="488" cy="154" r="4" fill="#fbbf24"/>
+ <circle cx="502" cy="154" r="4" fill="#4ade80"/>
+ <text x="518" y="158" fill="var(--term-muted)" font-size="10" font-family="ui-monospace, SFMono-Regular, Menlo, monospace">ci | itests (Unomi 3)</text>
+
+ <g clip-path="url(#afterClip)" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="10">
+ <text x="468" y="182" fill="var(--unomi-accent)">Apache Unomi | Integration tests</text>
+ <text x="468" y="200" fill="var(--term-muted)">Total tests: 412 | Search: Elasticsearch</text>
+
+ <rect x="468" y="216" width="304" height="28" rx="6" fill="#1e293b" stroke="#334155"/>
+ <rect x="472" y="220" width="118" height="20" rx="4" fill="var(--term-ok)" class="bar-fill float"/>
+ <text x="478" y="234" fill="#0f172a" font-size="9" font-weight="700">38%</text>
+
+ <text x="468" y="268" fill="var(--term-ok)">Progress: 38.11% (157/412)</text>
+ <text x="468" y="284" fill="var(--term-warn)">ETA: 18m 42s | OK: 157 Failed: 0</text>
+ <text x="468" y="310" fill="var(--term-muted)">Maven: -B -ntp | Docker logs to files</text>
+ <text x="468" y="326" fill="var(--unomi-hero-accent)">Top 10 slowest - CSV at finish</text>
+ </g>
+ </g>
+
+ <path d="M 408 232 L 432 232" stroke="var(--unomi-primary)" stroke-width="2.5" stroke-linecap="round" class="flow"/>
+ <path d="M 424 224 L 436 232 L 424 240" fill="var(--unomi-primary)" class="pulse"/>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/manual-plantuml-theme.svg b/src/main/webapp/assets/images/unomi3/manual-plantuml-theme.svg
new file mode 100644
index 0000000..eae593c
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/manual-plantuml-theme.svg
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3 manual: AsciiDoc with PlantUML sources builds into a branded HTML manual with diagrams">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ --term-bg: #0f172a;
+ --term-muted: #94a3b8;
+ --term-ok: #34d399;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+ </defs>
+
+ <rect width="840" height="400" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Manual as code</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">PlantUML in AsciiDoc | branded HTML/PDF | diagrams rebuild with the docs</text>
+
+ <g>
+ <rect x="40" y="88" width="310" height="270" rx="18" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="60" y="118" fill="var(--unomi-info)" font-size="14" font-weight="700">AsciiDoc source</text>
+ <rect x="56" y="136" width="278" height="200" rx="12" fill="var(--term-bg)"/>
+ <text x="72" y="162" fill="var(--unomi-accent)" font-size="11" font-family="ui-monospace, Menlo, monospace">[plantuml]</text>
+ <text x="72" y="182" fill="var(--term-muted)" font-size="10" font-family="ui-monospace, Menlo, monospace">----</text>
+ <text x="72" y="202" fill="var(--term-ok)" font-size="10" font-family="ui-monospace, Menlo, monospace">@startuml</text>
+ <text x="72" y="220" fill="#e2e8f0" font-size="10" font-family="ui-monospace, Menlo, monospace">!include C4_Component.puml</text>
+ <text x="72" y="238" fill="#e2e8f0" font-size="10" font-family="ui-monospace, Menlo, monospace">Container(unomi, "Unomi")</text>
+ <text x="72" y="256" fill="#e2e8f0" font-size="10" font-family="ui-monospace, Menlo, monospace">Component(rest, "REST")</text>
+ <text x="72" y="274" fill="var(--term-ok)" font-size="10" font-family="ui-monospace, Menlo, monospace">@enduml</text>
+ <text x="72" y="294" fill="var(--term-muted)" font-size="10" font-family="ui-monospace, Menlo, monospace">----</text>
+ <text x="72" y="318" fill="var(--unomi-hero-accent)" font-size="11" font-family="ui-monospace, Menlo, monospace">+ GraphViz | reviewable diffs</text>
+ </g>
+
+ <g>
+ <path d="M 368 220 L 412 220" stroke="var(--unomi-primary)" stroke-width="2.5" stroke-linecap="round" class="flow"/>
+ <path d="M 404 212 L 416 220 L 404 228" fill="var(--unomi-primary)" class="pulse"/>
+ <text x="390" y="204" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="11" font-weight="600">build</text>
+ </g>
+
+ <g class="float">
+ <rect x="430" y="88" width="370" height="270" rx="18" fill="var(--unomi-primary-light)" stroke="var(--unomi-primary)" stroke-width="2" class="glow"/>
+ <text x="450" y="118" fill="var(--unomi-primary-dark)" font-size="14" font-weight="700">Branded manual</text>
+ <rect x="450" y="136" width="330" height="198" rx="12" fill="var(--unomi-white)" stroke="var(--unomi-border)"/>
+ <rect x="450" y="136" width="330" height="36" rx="12" fill="var(--unomi-primary)"/>
+ <rect x="450" y="158" width="330" height="14" fill="var(--unomi-primary)"/>
+ <text x="468" y="158" fill="#ffffff" font-size="11" font-weight="600">Apache Unomi 3.x | Documentation</text>
+ <rect x="458" y="184" width="88" height="140" rx="8" fill="var(--unomi-primary-subtle)"/>
+ <text x="468" y="204" fill="var(--unomi-primary-dark)" font-size="9" font-weight="700">Contents</text>
+ <text x="468" y="222" fill="var(--unomi-text-muted)" font-size="8">What's new</text>
+ <text x="468" y="238" fill="var(--unomi-text)" font-size="8" font-weight="600">Architecture</text>
+ <text x="468" y="254" fill="var(--unomi-text-muted)" font-size="8">Migrations</text>
+ <text x="468" y="270" fill="var(--unomi-text-muted)" font-size="8">Scheduler</text>
+ <text x="468" y="286" fill="var(--unomi-text-muted)" font-size="8">Security</text>
+ <rect x="560" y="184" width="100" height="64" rx="8" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)"/>
+ <circle cx="590" cy="208" r="10" fill="var(--unomi-success)" opacity=".85"/>
+ <rect x="610" y="200" width="36" height="10" rx="3" fill="var(--unomi-success)" opacity=".5"/>
+ <rect x="610" y="216" width="28" height="10" rx="3" fill="var(--unomi-success)" opacity=".35"/>
+ <text x="610" y="238" fill="var(--unomi-success)" font-size="8" font-weight="600">C4 | PNG</text>
+ <rect x="672" y="184" width="96" height="64" rx="8" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)"/>
+ <path d="M690 208 H 748 M 710 196 V 232" stroke="var(--unomi-info)" stroke-width="2" class="flow"/>
+ <circle cx="700" cy="208" r="5" fill="var(--unomi-info)"/>
+ <circle cx="748" cy="208" r="5" fill="var(--unomi-accent)"/>
+ <text x="700" y="238" fill="var(--unomi-info)" font-size="8" font-weight="600">sequence</text>
+ <text x="560" y="278" fill="var(--unomi-text)" font-size="11" font-weight="600">Inter | brand tokens</text>
+ <text x="560" y="296" fill="var(--unomi-text-muted)" font-size="10">Responsive nav + TOC | PDF theme</text>
+ <text x="560" y="314" fill="var(--unomi-primary-dark)" font-size="10" font-weight="600">62 PlantUML diagrams | text in git</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/openapi-enrichment.svg b/src/main/webapp/assets/images/unomi3/openapi-enrichment.svg
new file mode 100644
index 0000000..d11d93a
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/openapi-enrichment.svg
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3.1 OpenAPI enrichment: Javadoc packs merge into CXF openapi.json">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+ </defs>
+ <rect width="840" height="400" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Richer OpenAPI from Javadoc</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Unomi 3.1: build-time packs + runtime CXF merge (UNOMI-963)</text>
+
+ <g class="float">
+ <rect x="40" y="100" width="220" height="240" rx="14" fill="var(--unomi-amber-bg)" stroke="var(--unomi-amber)" stroke-width="2"/>
+ <text x="150" y="140" text-anchor="middle" fill="var(--unomi-amber)" font-size="13" font-weight="700">1. Sources</text>
+ <text x="150" y="172" text-anchor="middle" fill="var(--unomi-text)" font-size="12">JAX-RS endpoints</text>
+ <text x="150" y="198" text-anchor="middle" fill="var(--unomi-text)" font-size="12">@param / @return</text>
+ <text x="150" y="224" text-anchor="middle" fill="var(--unomi-text)" font-size="12">@api.status</text>
+ <text x="150" y="250" text-anchor="middle" fill="var(--unomi-text)" font-size="12">@api.example</text>
+ <text x="150" y="290" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">rest + extensions</text>
+ </g>
+
+ <path d="M275 220 H325" stroke="var(--unomi-primary)" stroke-width="3" class="flow"/>
+
+ <g class="float" style="animation-delay:.3s">
+ <rect x="335" y="100" width="170" height="240" rx="14" fill="var(--unomi-primary)" class="glow"/>
+ <text x="420" y="160" text-anchor="middle" fill="#fff" font-size="13" font-weight="700">Maven Mojo</text>
+ <text x="420" y="190" text-anchor="middle" fill="rgba(255,255,255,.9)" font-size="11">enrichment pack</text>
+ <text x="420" y="220" text-anchor="middle" fill="rgba(255,255,255,.9)" font-size="11">META-INF/...</text>
+ <text x="420" y="250" text-anchor="middle" fill="rgba(255,255,255,.9)" font-size="11">openapi-doc.json</text>
+ <text x="420" y="300" text-anchor="middle" fill="rgba(255,255,255,.75)" font-size="11">per module JAR</text>
+ </g>
+
+ <path d="M520 220 H570" stroke="var(--unomi-primary)" stroke-width="3" class="flow"/>
+
+ <g class="float" style="animation-delay:.6s">
+ <rect x="580" y="100" width="220" height="240" rx="14" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="690" y="140" text-anchor="middle" fill="var(--unomi-success)" font-size="13" font-weight="700">2. Runtime</text>
+ <text x="690" y="172" text-anchor="middle" fill="var(--unomi-text)" font-size="12">CXF OpenApiFeature</text>
+ <text x="690" y="198" text-anchor="middle" fill="var(--unomi-text)" font-size="12">merge all packs</text>
+ <text x="690" y="224" text-anchor="middle" fill="var(--unomi-text)" font-size="12">/cxs/openapi.json</text>
+ <text x="690" y="262" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">summaries | statuses</text>
+ <text x="690" y="286" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">examples | schemas</text>
+ <text x="690" y="318" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="12" font-weight="600">Agent / IDE friendly</text>
+ </g>
+
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/opensearch-dual.svg b/src/main/webapp/assets/images/unomi3/opensearch-dual.svg
new file mode 100644
index 0000000..75321d9
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/opensearch-dual.svg
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 380" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3: Elasticsearch 9 and OpenSearch as dual persistence backends">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+ </defs>
+ <rect width="840" height="380" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">One CDP, two search backends</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Unomi 3 ships Elasticsearch 9 and first-class OpenSearch distributions</text>
+
+ <g class="float">
+ <rect x="40" y="100" width="340" height="220" rx="16" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="210" y="140" text-anchor="middle" fill="var(--unomi-info)" font-size="15" font-weight="700">Elasticsearch 9</text>
+ <text x="210" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="12">persistence-elasticsearch</text>
+ <text x="210" y="196" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">Java API Client (no HLRC)</text>
+ <text x="210" y="220" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">org.apache.unomi.elasticsearch.*</text>
+ <text x="210" y="252" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">Default distribution</text>
+ <text x="210" y="280" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Pin e.g. 9.4.x in 3.1</text>
+ </g>
+
+ <g class="float" style="animation-delay:.4s">
+ <rect x="460" y="100" width="340" height="220" rx="16" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="630" y="140" text-anchor="middle" fill="var(--unomi-success)" font-size="15" font-weight="700">OpenSearch</text>
+ <text x="630" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="12">persistence-opensearch</text>
+ <text x="630" y="196" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">Same PersistenceService SPI</text>
+ <text x="630" y="220" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12">org.apache.unomi.opensearch.*</text>
+ <text x="630" y="252" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">-Duse.opensearch=true</text>
+ <text x="630" y="280" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Migrate guide in the manual</text>
+ </g>
+
+ <path d="M390 210 H450" stroke="var(--unomi-primary)" stroke-width="3" class="flow"/>
+ <circle cx="420" cy="210" r="18" fill="var(--unomi-primary)" class="glow"/>
+ <text x="420" y="215" text-anchor="middle" fill="#fff" font-size="10" font-weight="700">SPI</text>
+
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/platform-foundation.svg b/src/main/webapp/assets/images/unomi3/platform-foundation.svg
new file mode 100644
index 0000000..b20f50b
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/platform-foundation.svg
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3 platform foundation: Java 17, Karaf 4.4, ES9, persistence clustering">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+ </defs>
+ <rect width="840" height="400" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Platform foundation (3.0 floor)</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">The runtime that makes multi-tenancy and ops tooling possible</text>
+
+ <g class="float">
+ <rect x="40" y="100" width="175" height="120" rx="14" fill="var(--unomi-primary-light)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="127" y="145" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="14" font-weight="700">Java 17+</text>
+ <text x="127" y="172" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Java 11 retired</text>
+ <text x="127" y="196" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">installer baseline</text>
+ </g>
+ <g class="float" style="animation-delay:.2s">
+ <rect x="235" y="100" width="175" height="120" rx="14" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="322" y="145" text-anchor="middle" fill="var(--unomi-info)" font-size="14" font-weight="700">Karaf 4.4</text>
+ <text x="322" y="172" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">OSGi runtime</text>
+ <text x="322" y="196" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">4.4.11 in 3.1</text>
+ </g>
+ <g class="float" style="animation-delay:.4s">
+ <rect x="430" y="100" width="175" height="120" rx="14" fill="var(--unomi-amber-bg)" stroke="var(--unomi-amber)" stroke-width="2"/>
+ <text x="517" y="145" text-anchor="middle" fill="var(--unomi-amber)" font-size="14" font-weight="700">Search 9.x</text>
+ <text x="517" y="172" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">ES Java API client</text>
+ <text x="517" y="196" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">OpenSearch option</text>
+ </g>
+ <g class="float" style="animation-delay:.6s">
+ <rect x="625" y="100" width="175" height="120" rx="14" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="712" y="145" text-anchor="middle" fill="var(--unomi-success)" font-size="14" font-weight="700">Clustering</text>
+ <text x="712" y="172" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">No Cellar/Hazelcast</text>
+ <text x="712" y="196" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">index heartbeats</text>
+ </g>
+
+ <rect x="40" y="250" width="760" height="110" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-border)" stroke-width="2"/>
+ <text x="60" y="290" fill="var(--unomi-primary-dark)" font-size="14" font-weight="700">Persistence-based cluster nodes</text>
+ <text x="60" y="318" fill="var(--unomi-text)" font-size="12">ClusterNode docs in Elasticsearch / OpenSearch | heartbeats + stats | peer discovery via shared index</text>
+ <text x="60" y="342" fill="var(--unomi-text-muted)" font-size="12">UNOMI-877 | also powers cluster-aware task scheduler locks</text>
+
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/request-tracing.svg b/src/main/webapp/assets/images/unomi3/request-tracing.svg
new file mode 100644
index 0000000..66171b4
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/request-tracing.svg
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi request tracing: explain=true returns a requestTracing tree">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+ </defs>
+ <rect width="840" height="400" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Request tracing with explain=true</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Admin / tenant-admin only | tree of conditions, rules, and actions</text>
+
+ <rect x="40" y="95" width="280" height="260" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-border)" stroke-width="2"/>
+ <text x="60" y="128" fill="var(--unomi-primary-dark)" font-size="13" font-weight="700">Your request</text>
+ <text x="60" y="156" fill="var(--unomi-text)" font-size="12">POST /cxs/context.json</text>
+ <text x="60" y="178" fill="var(--unomi-text)" font-size="12">POST /cxs/eventcollector</text>
+ <text x="60" y="210" fill="var(--unomi-accent)" font-size="12" font-weight="700">?explain=true</text>
+ <text x="60" y="242" fill="var(--unomi-text-muted)" font-size="11">Auth: tenantId:privateKey</text>
+ <text x="60" y="266" fill="var(--unomi-text-muted)" font-size="11">(Basic) TENANT_ADMIN</text>
+ <text x="60" y="300" fill="var(--unomi-amber)" font-size="11" font-weight="600">Public key alone => 403</text>
+ <text x="60" y="324" fill="var(--unomi-text-muted)" font-size="11">UNOMI-873</text>
+
+ <path d="M340 220 H400" stroke="var(--unomi-primary)" stroke-width="3" class="flow"/>
+
+ <rect x="410" y="95" width="390" height="260" rx="16" fill="#0f172a"/>
+ <text x="430" y="128" fill="#94a3b8" font-size="12" font-weight="700">response.requestTracing</text>
+ <text x="430" y="160" fill="#34d399" font-size="12">event-collection</text>
+ <text x="450" y="186" fill="#a78bfa" font-size="11">condition-evaluation</text>
+ <text x="470" y="210" fill="#94a3b8" font-size="11">property | boolean</text>
+ <text x="450" y="240" fill="#a78bfa" font-size="11">action-execution</text>
+ <text x="470" y="264" fill="#94a3b8" font-size="11">increment-property</text>
+ <text x="470" y="288" fill="#94a3b8" font-size="11">evaluate-segments</text>
+ <text x="430" y="322" fill="#64748b" font-size="11">startTime / endTime / traces[]</text>
+
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/shell-commands.svg b/src/main/webapp/assets/images/unomi3/shell-commands.svg
new file mode 100644
index 0000000..54f6e9f
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/shell-commands.svg
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3 Karaf shell: unomi:crud, tenant context, cache, and task commands">
+ <defs><style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-accent: #00cec9;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.float,.glow { animation: none !important; }
+ }
+</style></defs>
+ <rect width="840" height="400" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Karaf shell: unomi:*</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Unified CRUD, tenant session, cache ops, and task scheduler commands</text>
+
+ <rect x="40" y="95" width="250" height="70" rx="14" fill="var(--unomi-primary)" class="glow"/>
+ <text x="165" y="125" text-anchor="middle" fill="#fff" font-size="15" font-weight="700">ssh -p 8102</text>
+ <text x="165" y="148" text-anchor="middle" fill="rgba(255,255,255,.85)" font-size="11">karaf@localhost</text>
+
+ <path d="M300 130 H360" stroke="var(--unomi-primary)" stroke-width="3" class="flow"/>
+
+ <g class="float">
+ <rect x="370" y="90" width="200" height="100" rx="14" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="470" y="125" text-anchor="middle" fill="var(--unomi-info)" font-size="13" font-weight="700">unomi:crud</text>
+ <text x="470" y="150" text-anchor="middle" fill="var(--unomi-text)" font-size="11">create read update</text>
+ <text x="470" y="172" text-anchor="middle" fill="var(--unomi-text)" font-size="11">delete list help</text>
+ </g>
+
+ <g class="float" style="animation-delay:.25s">
+ <rect x="590" y="90" width="210" height="100" rx="14" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="695" y="125" text-anchor="middle" fill="var(--unomi-success)" font-size="13" font-weight="700">tenant-get / set</text>
+ <text x="695" y="150" text-anchor="middle" fill="var(--unomi-text)" font-size="11">session tenant context</text>
+ <text x="695" y="172" text-anchor="middle" fill="var(--unomi-text)" font-size="11">for CRUD + cache</text>
+ </g>
+
+ <g class="float" style="animation-delay:.5s">
+ <rect x="40" y="230" width="250" height="130" rx="14" fill="var(--unomi-amber-bg)" stroke="var(--unomi-amber)" stroke-width="2"/>
+ <text x="165" y="270" text-anchor="middle" fill="var(--unomi-amber)" font-size="13" font-weight="700">unomi:cache</text>
+ <text x="165" y="298" text-anchor="middle" fill="var(--unomi-text)" font-size="11">stats | clear | inspect</text>
+ <text x="165" y="322" text-anchor="middle" fill="var(--unomi-text)" font-size="11">view | remove | watch</text>
+ <text x="165" y="346" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">per tenant / type</text>
+ </g>
+
+ <g class="float" style="animation-delay:.75s">
+ <rect x="310" y="230" width="250" height="130" rx="14" fill="var(--unomi-primary-light)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="435" y="270" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="13" font-weight="700">unomi:task-*</text>
+ <text x="435" y="298" text-anchor="middle" fill="var(--unomi-text)" font-size="11">list show cancel</text>
+ <text x="435" y="322" text-anchor="middle" fill="var(--unomi-text)" font-size="11">retry purge executor</text>
+ <text x="435" y="346" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">UNOMI-879 / 880</text>
+ </g>
+
+ <g class="float" style="animation-delay:1s">
+ <rect x="580" y="230" width="220" height="130" rx="14" fill="#0f172a"/>
+ <text x="690" y="270" text-anchor="middle" fill="#94a3b8" font-size="12" font-weight="700">Also</text>
+ <text x="690" y="298" text-anchor="middle" fill="#34d399" font-size="11">list-invalid-objects</text>
+ <text x="690" y="322" text-anchor="middle" fill="#a78bfa" font-size="11">rule-tail | event-tail</text>
+ <text x="690" y="346" text-anchor="middle" fill="#94a3b8" font-size="11">lifecycle | deploy</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/task-scheduler.svg b/src/main/webapp/assets/images/unomi3/task-scheduler.svg
new file mode 100644
index 0000000..4d0c4b5
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/task-scheduler.svg
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3.1 cluster-aware task scheduler with REST and shell">
+ <defs>
+<style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes dash-flow { to { stroke-dashoffset: -24; } }
+ @keyframes pulse-soft { 0%,100%{opacity:.55} 50%{opacity:.9} }
+ @keyframes float-y { 0%,100%{transform:translateY(0)} 50%{transform:translateY(-3px)} }
+ @keyframes glow { 0%,100%{filter:drop-shadow(0 0 4px rgba(109,92,231,.35))} 50%{filter:drop-shadow(0 0 10px rgba(109,92,231,.55))} }
+ .flow { stroke-dasharray: 6 5; animation: dash-flow 1.6s linear infinite; }
+ .pulse { animation: pulse-soft 3s ease-in-out infinite; }
+ .float { animation: float-y 3.2s ease-in-out infinite; }
+ .glow { animation: glow 3s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .flow,.pulse,.float,.glow { animation: none !important; }
+ }
+</style>
+ </defs>
+ <rect width="840" height="400" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text x="40" y="40" fill="var(--unomi-text)" font-size="18" font-weight="700">Cluster-aware task scheduler</text>
+ <text x="40" y="62" fill="var(--unomi-text-muted)" font-size="13">Durable tasks, locks, retry and resume across Unomi nodes</text>
+
+ <rect x="300" y="95" width="240" height="70" rx="14" fill="var(--unomi-primary)" class="glow"/>
+ <text x="420" y="125" text-anchor="middle" fill="#fff" font-size="15" font-weight="700">SchedulerService</text>
+ <text x="420" y="148" text-anchor="middle" fill="rgba(255,255,255,.85)" font-size="11">persisted tasks + locks</text>
+
+ <g class="float">
+ <rect x="40" y="200" width="230" height="150" rx="14" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="155" y="235" text-anchor="middle" fill="var(--unomi-info)" font-size="13" font-weight="700">REST /cxs/tasks</text>
+ <text x="155" y="262" text-anchor="middle" fill="var(--unomi-text)" font-size="11">list | show | cancel</text>
+ <text x="155" y="286" text-anchor="middle" fill="var(--unomi-text)" font-size="11">retry | resume</text>
+ <text x="155" y="318" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">admin / tenant-admin</text>
+ </g>
+ <g class="float" style="animation-delay:.3s">
+ <rect x="305" y="200" width="230" height="150" rx="14" fill="var(--unomi-amber-bg)" stroke="var(--unomi-amber)" stroke-width="2"/>
+ <text x="420" y="235" text-anchor="middle" fill="var(--unomi-amber)" font-size="13" font-weight="700">Built-in types</text>
+ <text x="420" y="262" text-anchor="middle" fill="var(--unomi-text)" font-size="11">profile-purge</text>
+ <text x="420" y="286" text-anchor="middle" fill="var(--unomi-text)" font-size="11">segment-date-recalculation</text>
+ <text x="420" y="310" text-anchor="middle" fill="var(--unomi-text)" font-size="11">rules-statistics-refresh</text>
+ <text x="420" y="334" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">cache-refresh-* | task-purge</text>
+ </g>
+ <g class="float" style="animation-delay:.6s">
+ <rect x="570" y="200" width="230" height="150" rx="14" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="685" y="235" text-anchor="middle" fill="var(--unomi-success)" font-size="13" font-weight="700">Karaf shell</text>
+ <text x="685" y="262" text-anchor="middle" fill="var(--unomi-text)" font-size="11">unomi:task-list</text>
+ <text x="685" y="286" text-anchor="middle" fill="var(--unomi-text)" font-size="11">task-show | task-retry</text>
+ <text x="685" y="310" text-anchor="middle" fill="var(--unomi-text)" font-size="11">task-cancel | task-purge</text>
+ <text x="685" y="334" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">task-executor</text>
+ </g>
+
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg b/src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg
index 043fdcd..6c4b19f 100644
--- a/src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg
+++ b/src/main/webapp/assets/images/unomi3/unit-harness-vs-it.svg
@@ -45,26 +45,26 @@
<!-- Unit track -->
<g>
<rect x="40" y="90" width="360" height="210" rx="18" fill="var(--unomi-success-bg)" stroke="var(--unomi-success)" stroke-width="2"/>
- <text x="60" y="122" fill="var(--unomi-success)" font-size="14" font-weight="700">UNIT · seconds</text>
+ <text x="60" y="122" fill="var(--unomi-success)" font-size="14" font-weight="700">UNIT | seconds</text>
<rect x="60" y="140" width="320" height="44" rx="12" fill="var(--unomi-white)" class="glow"/>
<text x="220" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="600">InMemoryPersistenceServiceImpl</text>
- <text x="80" y="210" fill="var(--unomi-text)" font-size="12">→ TestHelper wires real *ServiceImpl</text>
- <text x="80" y="232" fill="var(--unomi-text)" font-size="12">→ conditions · refresh simulation</text>
- <text x="80" y="254" fill="var(--unomi-text)" font-size="12">→ no Docker · no Karaf boot</text>
- <text x="80" y="280" fill="var(--unomi-success)" font-size="12" font-weight="600">Independent · high-signal</text>
+ <text x="80" y="210" fill="var(--unomi-text)" font-size="12">-> TestHelper wires real *ServiceImpl</text>
+ <text x="80" y="232" fill="var(--unomi-text)" font-size="12">-> conditions | refresh simulation</text>
+ <text x="80" y="254" fill="var(--unomi-text)" font-size="12">-> no Docker | no Karaf boot</text>
+ <text x="80" y="280" fill="var(--unomi-success)" font-size="12" font-weight="600">Independent | high-signal</text>
</g>
<!-- IT track -->
<g>
<rect x="440" y="90" width="360" height="210" rx="18" fill="var(--unomi-info-bg)" stroke="var(--unomi-info)" stroke-width="2"/>
- <text x="460" y="122" fill="var(--unomi-info)" font-size="14" font-weight="700">INTEGRATION · minutes+</text>
+ <text x="460" y="122" fill="var(--unomi-info)" font-size="14" font-weight="700">INTEGRATION | minutes+</text>
<rect x="460" y="140" width="140" height="44" rx="12" fill="var(--unomi-white)" class="float"/>
<text x="530" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">Karaf</text>
<rect x="620" y="140" width="160" height="44" rx="12" fill="var(--unomi-white)" class="float" style="animation-delay:.4s"/>
<text x="700" y="168" text-anchor="middle" fill="var(--unomi-text)" font-size="12" font-weight="600">ES / OpenSearch</text>
- <text x="480" y="210" fill="var(--unomi-text)" font-size="12">→ Pax Exam + Docker stack</text>
- <text x="480" y="232" fill="var(--unomi-text)" font-size="12">→ full REST · clustering · tenants</text>
- <text x="480" y="254" fill="var(--unomi-text)" font-size="12">→ proves the live platform</text>
+ <text x="480" y="210" fill="var(--unomi-text)" font-size="12">-> Pax Exam + Docker stack</text>
+ <text x="480" y="232" fill="var(--unomi-text)" font-size="12">-> full REST | clustering | tenants</text>
+ <text x="480" y="254" fill="var(--unomi-text)" font-size="12">-> proves the live platform</text>
<text x="480" y="280" fill="var(--unomi-info)" font-size="12" font-weight="600">End-to-end confidence</text>
</g>
</svg>
diff --git a/src/main/webapp/blog/index.html b/src/main/webapp/blog/index.html
index 174b9f7..c83f6e5 100644
--- a/src/main/webapp/blog/index.html
+++ b/src/main/webapp/blog/index.html
@@ -111,6 +111,210 @@ layout: default
</div>
</section>
+<!-- DX: build.sh -->
+<section class="section section-alt">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6">
+ <span class="badge badge-primary mb-3">Developer experience</span>
+ <h2 class="h3 fw-bold mb-3">
+ <a href="/blog/unomi-3-build-sh.html" class="text-decoration-none text-body">One entry point: build.sh</a>
+ </h2>
+ <p class="text-muted mb-4">Preflight, Maven build, integration tests, and deploy — one script locally and on GitHub Actions, with a <code>build.ps1</code> twin for Windows.</p>
+ <a href="/blog/unomi-3-build-sh.html" class="btn btn-primary">
+ Read the build.sh post <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ <div class="col-lg-6">
+ <a href="/blog/unomi-3-build-sh.html" class="d-block rounded-3 overflow-hidden shadow-sm" aria-label="Read build.sh post">
+ <img src="/assets/images/unomi3/build-sh.svg" class="img-fluid w-100" alt="build.sh hub for preflight build test deploy" loading="lazy">
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- Docs: Manual -->
+<section class="section">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6 order-lg-2">
+ <span class="badge badge-primary mb-3">Documentation</span>
+ <h2 class="h3 fw-bold mb-3">
+ <a href="/blog/unomi-3-manual.html" class="text-decoration-none text-body">Unomi 3 manual improvements</a>
+ </h2>
+ <p class="text-muted mb-4">PlantUML diagrams in AsciiDoc, an Unomi-branded HTML/PDF theme, and deep chapters for migrations, multi-tenancy, upgrades, and conditions.</p>
+ <a href="/blog/unomi-3-manual.html" class="btn btn-primary">
+ Read the manual post <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ <div class="col-lg-6 order-lg-1">
+ <a href="/blog/unomi-3-manual.html" class="d-block rounded-3 overflow-hidden shadow-sm" aria-label="Read Unomi 3 manual improvements">
+ <img src="/assets/images/unomi3/manual-plantuml-theme.svg" class="img-fluid w-100" alt="PlantUML source to branded Unomi manual" loading="lazy">
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- Quality: IT execution -->
+<section class="section section-alt">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6">
+ <span class="badge badge-primary mb-3">Quality · Developer experience</span>
+ <h2 class="h3 fw-bold mb-3">
+ <a href="/blog/unomi-3-it-execution.html" class="text-decoration-none text-body">Clearer integration test runs</a>
+ </h2>
+ <p class="text-muted mb-4">Live progress bars with ETA, quieter Maven/Docker CI output, and tooling to archive and compare long IT suites — before / after from real GitHub Actions runs.</p>
+ <a href="/blog/unomi-3-it-execution.html" class="btn btn-primary">
+ Read the IT execution post <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ <div class="col-lg-6">
+ <a href="/blog/unomi-3-it-execution.html" class="d-block rounded-3 overflow-hidden shadow-sm" aria-label="Read clearer integration test runs">
+ <img src="/assets/images/unomi3/it-progress-before-after.svg" class="img-fluid w-100" alt="IT console before and after progress bars" loading="lazy">
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- Quality: unit harness -->
+<section class="section">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6 order-lg-2">
+ <span class="badge badge-primary mb-3">Quality · Unit tests</span>
+ <h2 class="h3 fw-bold mb-3">
+ <a href="/blog/unomi-3-unit-testing-harness.html" class="text-decoration-none text-body">Faster service unit tests</a>
+ </h2>
+ <p class="text-muted mb-4"><code>InMemoryPersistenceServiceImpl</code> — a full PersistenceService on the test classpath so Profile, Event, Rules, and Segment logic runs in seconds without Karaf.</p>
+ <a href="/blog/unomi-3-unit-testing-harness.html" class="btn btn-primary">
+ Read the unit harness post <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ <div class="col-lg-6 order-lg-1">
+ <a href="/blog/unomi-3-unit-testing-harness.html" class="d-block rounded-3 overflow-hidden shadow-sm" aria-label="Read unit testing harness">
+ <img src="/assets/images/unomi3/unit-harness-vs-it.svg" class="img-fluid w-100" alt="Unit harness versus integration tests" loading="lazy">
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- Platform + OpenSearch pair -->
+<section class="section section-alt">
+ <div class="container">
+ <div class="row justify-content-center text-center mb-4">
+ <div class="col-lg-7">
+ <p class="section-label">Platform & ops</p>
+ <h2 class="h4 mb-0">Foundation, search, shell, scheduler, tracing</h2>
+ </div>
+ </div>
+ <div class="row g-4">
+ <div class="col-md-6 col-lg-3">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/unomi-3-platform-foundation.html" class="d-block" aria-label="Read platform foundation">
+ <img src="/assets/images/unomi3/platform-foundation.svg" class="img-fluid w-100" alt="Unomi 3 platform foundation" loading="lazy">
+ </a>
+ <div class="p-3">
+ <span class="badge badge-primary mb-2">Platform</span>
+ <h3 class="h6 fw-semibold mb-2">
+ <a href="/blog/unomi-3-platform-foundation.html" class="text-decoration-none text-body">Platform foundation</a>
+ </h3>
+ <p class="small text-muted mb-0">Java 17, Karaf 4.4, ES9, persistence clustering.</p>
+ <a href="/blog/unomi-3-platform-foundation.html" class="stretched-link" aria-label="Read platform foundation"></a>
+ </div>
+ </article>
+ </div>
+ <div class="col-md-6 col-lg-3">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/unomi-3-opensearch.html" class="d-block" aria-label="Read OpenSearch post">
+ <img src="/assets/images/unomi3/opensearch-dual.svg" class="img-fluid w-100" alt="Elasticsearch and OpenSearch" loading="lazy">
+ </a>
+ <div class="p-3">
+ <span class="badge badge-primary mb-2">Ops</span>
+ <h3 class="h6 fw-semibold mb-2">
+ <a href="/blog/unomi-3-opensearch.html" class="text-decoration-none text-body">ES9 & OpenSearch</a>
+ </h3>
+ <p class="small text-muted mb-0">Dual backends, same SPI, migrate guide.</p>
+ <a href="/blog/unomi-3-opensearch.html" class="stretched-link" aria-label="Read OpenSearch post"></a>
+ </div>
+ </article>
+ </div>
+ <div class="col-md-6 col-lg-3">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/unomi-3-shell-commands.html" class="d-block" aria-label="Read shell commands">
+ <img src="/assets/images/unomi3/shell-commands.svg" class="img-fluid w-100" alt="Unomi Karaf shell commands" loading="lazy">
+ </a>
+ <div class="p-3">
+ <span class="badge badge-primary mb-2">Ops</span>
+ <h3 class="h6 fw-semibold mb-2">
+ <a href="/blog/unomi-3-shell-commands.html" class="text-decoration-none text-body">Shell commands</a>
+ </h3>
+ <p class="small text-muted mb-0"><code>unomi:crud</code>, tenant, cache, tasks.</p>
+ <a href="/blog/unomi-3-shell-commands.html" class="stretched-link" aria-label="Read shell commands"></a>
+ </div>
+ </article>
+ </div>
+ <div class="col-md-6 col-lg-3">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/unomi-3-task-scheduler.html" class="d-block" aria-label="Read task scheduler">
+ <img src="/assets/images/unomi3/task-scheduler.svg" class="img-fluid w-100" alt="Task scheduler" loading="lazy">
+ </a>
+ <div class="p-3">
+ <span class="badge badge-primary mb-2">3.1</span>
+ <h3 class="h6 fw-semibold mb-2">
+ <a href="/blog/unomi-3-task-scheduler.html" class="text-decoration-none text-body">Task scheduler</a>
+ </h3>
+ <p class="small text-muted mb-0">REST <code>/cxs/tasks</code>, shell, cluster locks.</p>
+ <a href="/blog/unomi-3-task-scheduler.html" class="stretched-link" aria-label="Read task scheduler"></a>
+ </div>
+ </article>
+ </div>
+ <div class="col-md-6 col-lg-3">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/unomi-3-request-tracing.html" class="d-block" aria-label="Read request tracing">
+ <img src="/assets/images/unomi3/request-tracing.svg" class="img-fluid w-100" alt="Request tracing explain" loading="lazy">
+ </a>
+ <div class="p-3">
+ <span class="badge badge-primary mb-2">Debug</span>
+ <h3 class="h6 fw-semibold mb-2">
+ <a href="/blog/unomi-3-request-tracing.html" class="text-decoration-none text-body">Request tracing</a>
+ </h3>
+ <p class="small text-muted mb-0"><code>explain=true</code> with verified curl examples.</p>
+ <a href="/blog/unomi-3-request-tracing.html" class="stretched-link" aria-label="Read request tracing"></a>
+ </div>
+ </article>
+ </div>
+ </div>
+ </div>
+</section>
+
+<!-- OpenAPI enrichment -->
+<section class="section">
+ <div class="container">
+ <div class="row align-items-center g-4 g-lg-5">
+ <div class="col-lg-6">
+ <span class="badge badge-primary mb-3">Unomi 3.1 · REST</span>
+ <h2 class="h3 fw-bold mb-3">
+ <a href="/blog/unomi-3-openapi-enrichment.html" class="text-decoration-none text-body">Richer OpenAPI from Javadoc</a>
+ </h2>
+ <p class="text-muted mb-4">Unomi 3.1 merges endpoint Javadoc into <code>/cxs/openapi.json</code> — summaries, statuses, examples, and schema notes for humans and agents (UNOMI-963).</p>
+ <a href="/blog/unomi-3-openapi-enrichment.html" class="btn btn-primary">
+ Read the OpenAPI post <i class="bi bi-arrow-right ms-1"></i>
+ </a>
+ </div>
+ <div class="col-lg-6">
+ <a href="/blog/unomi-3-openapi-enrichment.html" class="d-block rounded-3 overflow-hidden shadow-sm" aria-label="Read OpenAPI enrichment">
+ <img src="/assets/images/unomi3/openapi-enrichment.svg" class="img-fluid w-100" alt="OpenAPI enrichment pipeline" loading="lazy">
+ </a>
+ </div>
+ </div>
+ </div>
+</section>
+
<!-- Welcome + topics -->
<section class="section">
<div class="container">
@@ -140,6 +344,16 @@ layout: default
<a href="/blog/unomi-3-multitenancy.html" class="badge badge-primary text-decoration-none px-3 py-2">Multi-tenancy</a>
<a href="/blog/unomi-3-ai-agents.html" class="badge badge-primary text-decoration-none px-3 py-2">AI agents</a>
<a href="/blog/migrating-to-unomi-3.html" class="badge badge-primary text-decoration-none px-3 py-2">Migration</a>
+ <a href="/blog/unomi-3-it-execution.html" class="badge badge-primary text-decoration-none px-3 py-2">IT execution</a>
+ <a href="/blog/unomi-3-manual.html" class="badge badge-primary text-decoration-none px-3 py-2">Manual</a>
+ <a href="/blog/unomi-3-build-sh.html" class="badge badge-primary text-decoration-none px-3 py-2">build.sh</a>
+ <a href="/blog/unomi-3-unit-testing-harness.html" class="badge badge-primary text-decoration-none px-3 py-2">Unit harness</a>
+ <a href="/blog/unomi-3-platform-foundation.html" class="badge badge-primary text-decoration-none px-3 py-2">Platform</a>
+ <a href="/blog/unomi-3-opensearch.html" class="badge badge-primary text-decoration-none px-3 py-2">OpenSearch</a>
+ <a href="/blog/unomi-3-shell-commands.html" class="badge badge-primary text-decoration-none px-3 py-2">Shell</a>
+ <a href="/blog/unomi-3-task-scheduler.html" class="badge badge-primary text-decoration-none px-3 py-2">Scheduler</a>
+ <a href="/blog/unomi-3-request-tracing.html" class="badge badge-primary text-decoration-none px-3 py-2">Tracing</a>
+ <a href="/blog/unomi-3-openapi-enrichment.html" class="badge badge-primary text-decoration-none px-3 py-2">OpenAPI</a>
<a href="/use-cases.html" class="badge badge-secondary text-decoration-none px-3 py-2">Use cases</a>
<a href="/community/events/index.html" class="badge badge-secondary text-decoration-none px-3 py-2">Events</a>
</div>
@@ -151,7 +365,7 @@ layout: default
</section>
<!-- Reading order -->
-<section class="section section-alt">
+<section class="section">
<div class="container">
<div class="row justify-content-center text-center mb-4">
<div class="col-lg-7">
@@ -191,6 +405,15 @@ layout: default
</div>
<p class="text-center small text-muted mt-4 mb-0">
Then: <a href="/blog/migrating-to-unomi-3.html">Migrating from 2.x</a> ·
+ <a href="/blog/unomi-3-platform-foundation.html">Platform</a> ·
+ <a href="/blog/unomi-3-opensearch.html">OpenSearch</a> ·
+ <a href="/blog/unomi-3-shell-commands.html">Shell</a> ·
+ <a href="/blog/unomi-3-unit-testing-harness.html">Unit harness</a> ·
+ <a href="/blog/unomi-3-request-tracing.html">Tracing</a> ·
+ <a href="/blog/unomi-3-openapi-enrichment.html">OpenAPI</a> ·
+ <a href="/blog/unomi-3-build-sh.html">build.sh</a> ·
+ <a href="/blog/unomi-3-manual.html">Manual</a> ·
+ <a href="/blog/unomi-3-it-execution.html">IT execution</a> ·
<a href="/download.html">Download</a> ·
<a href="/get-started.html">Get started</a>
</p>
diff --git a/src/main/webapp/blog/unomi-3-build-sh.html b/src/main/webapp/blog/unomi-3-build-sh.html
new file mode 100644
index 0000000..e06759e
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-build-sh.html
@@ -0,0 +1,79 @@
+---
+title: One entry point — Unomi 3 build.sh
+description: "How Apache Unomi 3 replaced scattered build scripts with a single build.sh — preflight checks, CI mode, integration tests, deploy, and Windows build.ps1 parity."
+keywords: "Unomi build.sh, Apache Unomi developer experience, UNOMI-887, Maven CI, OpenSearch integration tests"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Developer experience</p>
+ <h1>One entry point: <code>build.sh</code></h1>
+ <p class="lead">Preflight, build, test, and deploy — the same script locally and on GitHub Actions.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Before Unomi 3, contributors juggled several ad-hoc scripts (<code>buildAndRun.sh</code>, <code>compileDeploy.sh</code>, and friends).
+ <a href="https://issues.apache.org/jira/browse/UNOMI-887">UNOMI-887</a>
+ /
+ <a href="https://github.com/apache/unomi/pull/737">#737</a>
+ folded those workflows into a single
+ <strong><code>./build.sh</code></strong>
+ at the repository root — with clearer errors, colorized output, and flags that match how people actually work.</p>
+
+ <img src="/assets/images/unomi3/build-sh.svg" class="img-fluid my-4" alt="build.sh as one hub for preflight, build, test, and deploy"/>
+
+ <h2 class="h4 mt-4 mb-3">What it replaced</h2>
+ <p>Legacy one-off scripts for “build and run,” “build without tests,” packaging, and deploy were removed in favor of one maintained entry point.
+ The PowerShell twin
+ <code>build.ps1</code>
+ tracks the same flags for Windows contributors.</p>
+
+ <h2 class="h4 mt-5 mb-3">What you get</h2>
+ <ul>
+ <li><strong>Preflight</strong> — Java, Maven, GraphViz; memory/disk heuristics; ports for debug sessions; fail early with readable messages</li>
+ <li><strong>Build flexibility</strong> — skip tests, OpenSearch vs Elasticsearch, named distributions, offline / Maven debug, optional Javadoc gate</li>
+ <li><strong>Integration tests</strong> — <code>--integration-tests</code>, <code>--single-test</code>, IT debug/suspend, keep container, stream search logs when needed, memory sampler</li>
+ <li><strong>Run & deploy</strong> — <code>--deploy --karaf-home</code>, Karaf debug ports, <code>--auto-start</code> for search engines, <code>--no-karaf</code> for package-only builds</li>
+ <li><strong>CI mode</strong> — <code>--ci</code> is non-interactive, batch Maven (<code>-B -ntp</code>), no Karaf side-trips; GitHub Actions calls the same script as you do locally (<a href="https://github.com/apache/unomi/pull/764">#764</a>)</li>
+ <li><strong>UX details</strong> — section headers, traps with line/context on failure, <code>NO_COLOR</code> respected, optional <code>--log-file</code> tee</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Try it</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>./build.sh --help
+
+# Default install
+./build.sh
+
+# Match GitHub Actions shape
+./build.sh --ci
+
+# Full IT matrix flavors
+./build.sh --integration-tests
+./build.sh --integration-tests --use-opensearch
+
+# One flaky test under a debugger
+./build.sh --integration-tests \
+ --single-test org.apache.unomi.itests.graphql.GraphQLEventIT \
+ --it-debug --it-debug-suspend
+
+# Deploy KAR into an existing Karaf
+./build.sh --deploy --karaf-home ~/apache-karaf</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Why it matters</h2>
+ <p>Contributor friction kills review velocity. One documented command that validates the environment, builds the right distribution, and runs the same gates as CI means less “works on my machine” archaeology — and pairs with the
+ <a href="/blog/unomi-3-it-execution.html">clearer IT console</a>
+ and
+ <a href="/blog/unomi-3-manual.html">manual</a>
+ investments in Unomi 3.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="https://github.com/apache/unomi/blob/master/build.sh">View build.sh on GitHub</a>
+ <a class="btn btn-outline-primary ms-2" href="{{ site.data.unomi.manual.published_latest }}#_using_the_build_script">Manual: using the build script</a>
+ <a class="btn btn-outline-primary ms-2" href="/contribute/testing.html">Contribute · Testing</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-it-execution.html b/src/main/webapp/blog/unomi-3-it-execution.html
new file mode 100644
index 0000000..e620d92
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-it-execution.html
@@ -0,0 +1,96 @@
+---
+title: Clearer integration test runs in Unomi 3
+description: "How Unomi 3 improved IT execution — live progress bars with ETA, quieter Maven and Docker output, and tooling for diagnosing long CI suites."
+keywords: "Unomi 3 integration tests, ProgressListener, CI logs, Apache Unomi IT, build.sh"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Quality</p>
+ <h1>Clearer integration test runs in Unomi 3</h1>
+ <p class="lead">Progress bars, quieter CI output, and tools that turn a 90–minute suite into something you can actually follow.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Apache Unomi’s integration tests are deliberately heavy: Pax Exam boots a real Karaf, Docker starts Elasticsearch or OpenSearch, and Failsafe walks a large end-to-end suite. That work takes on the order of
+ <strong>one to two hours</strong> on
+ <a href="https://github.com/apache/unomi/actions/workflows/unomi-ci-build-tests.yml">GitHub Actions</a>
+ (for example
+ <a href="https://github.com/apache/unomi/actions/runs/29200354118">run #29200354118</a>
+ on <code>master</code>, ~1h 52m wall time). For years the console mostly said “still downloading” or “still running” — with almost no sense of
+ <em>how far</em>
+ or
+ <em>what was left</em>.</p>
+ <p>Unomi 3 invested in the
+ <strong>execution experience</strong>
+ of that suite: live progress, quieter logs, and developer tooling around archives and memory. The goal is not fewer tests — it is being able to watch (and debug) the ones we already run.</p>
+
+ <img src="/assets/images/unomi3/it-progress-before-after.svg" class="img-fluid my-4" alt="Before and after IT console: Maven download spam versus progress bar with ETA"/>
+
+ <h2 class="h4 mt-4 mb-3">What changed</h2>
+ <ul>
+ <li><strong>Live progress</strong> — <a href="https://issues.apache.org/jira/browse/UNOMI-912">UNOMI-912</a> / <a href="https://github.com/apache/unomi/pull/735">#735</a> added <code>ProgressSuite</code> + <code>ProgressListener</code>: accurate total, percentage, ETA, pass/fail counters, and a CSV of the slowest tests at the end.</li>
+ <li><strong>Quieter Maven in CI</strong> — <a href="https://github.com/apache/unomi/pull/764">#764</a> aligned Actions with <code>./build.sh --ci</code>; follow-up work forces <code>-B -ntp</code> so transfer “Progress (1): … kB” lines stop drowning the log.</li>
+ <li><strong>Docker search logs off the console</strong> — Elasticsearch/OpenSearch container logs go to files under <code>itests/target/</code> by default; opt in with <code>--search-engine-logs</code> when you need them live.</li>
+ <li><strong>Diagnose, don’t re-run blindly</strong> — <a href="https://github.com/apache/unomi/pull/770">#770</a> (archive / compare / <code>kt.sh</code>) and <a href="https://github.com/apache/unomi/pull/782">#782</a> (memory sampling + CI artifacts) make flaky vs systematic failures easier to classify.</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Before / after (CI console)</h2>
+ <p>Raw job log downloads from Actions require repository privileges, so the excerpts below are
+ <strong>representative reconstructions</strong>
+ of what contributors and committers see in the “Execute integration tests” job — anchored to real public runs and the UNOMI-912 acceptance output.</p>
+
+ <p class="small text-muted mb-2"><strong>Before</strong> — typical shape of an older IT job before progress-aware running and transfer quieting (see e.g.
+ <a href="https://github.com/apache/unomi/actions/runs/19324846828">run #19324846828</a>,
+ 2025-11-13, pre–UNOMI-912 merge). Walls of Maven transfer progress, little suite-level signal:</p>
+ <pre class="p-3 rounded-3 small overflow-auto" style="max-height: 14rem;"><code>Downloading from central: https://repo.maven.apache.org/.../junit-4.13.2.jar
+Progress (1): 4.1/384 kB
+Progress (1): 48/384 kB
+Progress (1): 128/384 kB
+Downloaded from central: .../junit-4.13.2.jar (0.4 s)
+Downloading from central: https://repo.maven.apache.org/.../hamcrest-core-1.3.jar
+Progress (1): 7.2/45 kB
+...
+[INFO] --- docker-maven-plugin: start (elasticsearch)
+... thousands of similar lines ...
+# Suite still running - no % complete, no ETA, no live fail list</code></pre>
+
+ <p class="small text-muted mb-2 mt-4"><strong>After</strong> — same class of job on Unomi 3 tip (e.g.
+ <a href="https://github.com/apache/unomi/actions/runs/29200354118">run #29200354118</a>,
+ 2026-07-12). Transfer UI suppressed; <code>ProgressListener</code> owns the “are we stuck?” question. Format from
+ <a href="https://issues.apache.org/jira/browse/UNOMI-912">UNOMI-912</a>:</p>
+ <pre class="p-3 rounded-3 small overflow-auto" style="max-height: 14rem;"><code>[#######-----------------------] Progress: 23.33% (35/150 tests).
+ Estimated time remaining: 4m 12s. Successful: 35, Failed: 0
+
+# ... later ...
+
+Top 10 Slowest Tests:
+Rank,Test Name,Duration (ms)
+1,"GraphQLProfileIT.testUpdateProperty",18234
+2,"ProfileMergeIT.testMerge",14925
+...</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Try it locally</h2>
+ <pre class="code-block-light p-3 rounded-3 small"><code>./build.sh --integration-tests
+# CI-shaped (batch + no transfer progress):
+./build.sh --ci --integration-tests</code></pre>
+ <p>After a run, see <code>itests/README.md</code> for <code>archive-it-run.sh</code>, <code>compare-it-runs.sh</code>, <code>kt.sh</code>, and memory sampling. On Actions, download the <code>it-memory-metrics-*</code> artifact from a completed IT job.</p>
+
+ <h2 class="h4 mt-5 mb-3">How this fits the Unomi 3 quality story</h2>
+ <p>Progress and cleaner logs make the
+ <em>long</em>
+ path usable. Unomi 3 also added a
+ <em>short</em>
+ path — the in-memory persistence harness for fast service unit tests without Karaf or Docker. Different layers, same idea: confidence without guessing.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="https://github.com/apache/unomi/tree/master/itests">Browse itests on GitHub</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/introducing-apache-unomi-3.html">Unomi 3 intro</a>
+ <a class="btn btn-outline-primary ms-2" href="/contribute/testing.html">Contribute · Testing</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-manual.html b/src/main/webapp/blog/unomi-3-manual.html
new file mode 100644
index 0000000..cebe055
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-manual.html
@@ -0,0 +1,102 @@
+---
+title: Unomi 3 manual — PlantUML, branded theme, deeper docs
+description: "How the Apache Unomi 3 manual gained PlantUML/GraphViz diagrams, an Unomi-branded HTML/PDF theme, and major content expansions for migrations, multi-tenancy, and platform upgrades."
+keywords: "Apache Unomi manual, PlantUML AsciiDoc, Unomi 3 documentation, AsciiDoctor diagrams, Unomi CSS theme"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Documentation</p>
+ <h1>Unomi 3 manual: diagrams, theme, and depth</h1>
+ <p class="lead">PlantUML in AsciiDoc, a brand-aligned HTML/PDF look, and chapters that finally match the Unomi 3 platform.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Shipping Unomi 3 without a manual that looks and reads like Unomi 3 would leave operators guessing. Over several
+ <a href="https://issues.apache.org/jira/browse/UNOMI-882">UNOMI-882</a>
+ and
+ <a href="https://issues.apache.org/jira/browse/UNOMI-960">UNOMI-960</a>
+ efforts, the project rebuilt how the official manual is
+ <em>authored</em>,
+ <em>rendered</em>, and
+ <em>navigated</em>
+ — from diagram toolchain to CSS theme to whole new chapters.</p>
+
+ <img src="/assets/images/unomi3/manual-plantuml-theme.svg" class="img-fluid my-4" alt="AsciiDoc PlantUML source builds into a branded Unomi 3 manual with diagrams"/>
+
+ <h2 class="h4 mt-4 mb-3">PlantUML (and GraphViz) in the build</h2>
+ <p><a href="https://github.com/apache/unomi/pull/753">#753</a> wired
+ <strong>AsciiDoctor Diagram</strong>
+ into <code>manual/pom.xml</code>: <code>asciidoctorj-diagram</code> + PlantUML, with GraphViz available via
+ <code>GRAPHVIZ_DOT</code> / <code>graphvizdot</code>. CI installs GraphViz so HTML and PDF builds stay reproducible.</p>
+ <p>Diagrams live
+ <strong>in the AsciiDoc</strong>
+ as <code>[plantuml]</code> blocks — reviewable in pull requests, regenerated on every docs build, no orphaned PNGs in git.
+ Tip today has on the order of
+ <strong>62 PlantUML diagrams</strong>
+ across ~24 chapters (architecture C4, sequences, upgrade flows, condition evaluation, scheduler, past-event strategies, and more).</p>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>[plantuml]
+----
+@startuml
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml
+Container(unomi, "Apache Unomi")
+Component(restApi, "REST API", "JAX-RS")
+@enduml
+----</code></pre>
+ <p class="small text-muted">Local tip: install GraphViz (<code>brew install graphviz</code> / <code>apt-get install graphviz</code>), then
+ <code>cd manual && mvn -ntp clean install</code>.
+ <code>build.sh</code> also checks for <code>dot</code>.</p>
+
+ <h2 class="h4 mt-5 mb-3">Branded HTML & PDF theme</h2>
+ <p>A later slice of
+ <a href="https://github.com/apache/unomi/pull/821">#821</a>
+ (UNOMI-960) replaced the default AsciiDoctor chrome with an
+ <strong>Unomi-branded</strong>
+ stylesheet that tracks
+ <a href="https://unomi.apache.org/">unomi.apache.org</a>:</p>
+ <ul>
+ <li><strong>Design tokens</strong> — <code>--unomi-primary</code> (<code>#6d5ce7</code>), accent purple, Inter typography</li>
+ <li><strong>Site nav & footer</strong> via docinfo, version badge, hero cover for the HTML book</li>
+ <li><strong>Responsive UX</strong> — burger nav + bottom TOC sheet under 1024px; desktop sidebar TOC from 1024px</li>
+ <li><strong>PDF</strong> — dedicated <code>unomi-theme.yml</code> under <code>manual/src/theme/</code> with matching brand assets</li>
+ </ul>
+ <p>Reading the published manual should feel continuous with the project website, not like a separate default book skin.</p>
+
+ <h2 class="h4 mt-5 mb-3">Content that matches Unomi 3</h2>
+ <p><a href="https://github.com/apache/unomi/pull/783">#783</a> synced the book to
+ <strong>Apache Unomi 3.x</strong>
+ and expanded (or heavily refreshed) material that operators actually need:</p>
+ <ul>
+ <li><strong>Platform story</strong> — architecture, security, configuration, clustering, data structures</li>
+ <li><strong>3.1 product</strong> — multi-tenancy, task scheduler, OpenSearch notes, condition validation / evaluation, property types</li>
+ <li><strong>Migrations</strong> — 2.x→3.0, 3.0→3.1, ES7→ES9, Elasticsearch→OpenSearch, V2 compatibility mode, script authoring</li>
+ <li><strong>Platform upgrades</strong> — dedicated <code>upgrades/</code> runbooks (Java, Karaf, Elasticsearch, Log4j, CXF/Jackson/Jetty, dependency hygiene, ITs)</li>
+ <li><strong>Day-to-day APIs</strong> — request examples (including explain/tracing), GraphQL, shell commands, JavaScript tracker guide, recipes</li>
+ <li><strong>Reference depth</strong> — conditions guide and builtin type catalogs (UNOMI-960), past-event conditions, profile tracking</li>
+ </ul>
+ <p>“What’s new” for 3.1 now points readers straight into these chapters instead of leaving gaps between release notes and the old 2.x-shaped manual.</p>
+
+ <h2 class="h4 mt-5 mb-3">How to add a diagram</h2>
+ <ol>
+ <li>Edit the relevant <code>.adoc</code> under <code>manual/src/main/asciidoc/</code></li>
+ <li>Add a <code>[plantuml]</code> (or GraphViz) block next to the prose it illustrates</li>
+ <li>Build the manual module (GraphViz required for some diagrams)</li>
+ <li>Review the generated PNG in the PR like any other source change</li>
+ </ol>
+ <p>Website promotional diagrams stay animated SVG / Mermaid on
+ <a href="/blog/">unomi.apache.org</a>;
+ the
+ <strong>manual</strong>
+ sticks to PlantUML→PNG so AsciiDoctor HTML/PDF stay self-contained.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="{{ site.data.unomi.manual.published_latest }}">Open the latest manual</a>
+ <a class="btn btn-outline-primary ms-2" href="{{ site.data.unomi.manual.whats_new }}">What’s new in 3.1</a>
+ <a class="btn btn-outline-primary ms-2" href="https://github.com/apache/unomi/tree/master/manual/src/main/asciidoc">Browse AsciiDoc on GitHub</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-openapi-enrichment.html b/src/main/webapp/blog/unomi-3-openapi-enrichment.html
new file mode 100644
index 0000000..e400418
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-openapi-enrichment.html
@@ -0,0 +1,70 @@
+---
+title: Richer OpenAPI docs in Unomi 3.1
+description: "How Unomi 3.1 enriches /cxs/openapi.json from JAX-RS Javadoc — summaries, statuses, examples, and schemas without duplicating Swagger annotations (UNOMI-963)."
+keywords: "Unomi OpenAPI, openapi.json, UNOMI-963, CXF OpenAPI, Javadoc enrichment, Unomi 3.1 REST"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3.1 · Developer experience</p>
+ <h1>Richer OpenAPI docs from Javadoc</h1>
+ <p class="lead">Unomi 3.1 ships an enriched <code>/cxs/openapi.json</code> — summaries, status codes, examples, and schema notes merged from endpoint Javadoc.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Stock CXF OpenAPI generation is a great skeleton and a thin reading experience: operation ids, parameter names, and “default response.”
+ Unomi 3.1 (
+ <a href="https://issues.apache.org/jira/browse/UNOMI-963">UNOMI-963</a>)
+ keeps a <strong>single source of truth in Javadoc</strong> and merges richer documentation into the live OpenAPI document at runtime.</p>
+
+ <img src="/assets/images/unomi3/openapi-enrichment.svg" class="img-fluid my-4" alt="Javadoc to enrichment pack to CXF openapi.json pipeline"/>
+
+ <h2 class="h4 mt-4 mb-3">How the pipeline works</h2>
+ <ol>
+ <li><strong>Build time</strong> — a Maven Mojo scans JAX-RS sources and writes an enrichment pack (<code>openapi-doc.json</code>) into each REST module JAR</li>
+ <li><strong>Runtime</strong> — Unomi’s CXF OpenAPI customizer loads every pack on the classpath and merges summaries, parameters, named statuses, examples, and schema field docs into <code>/cxs/openapi.json</code></li>
+ </ol>
+ <p>Authors document once on the Java method / type; agents, Swagger UI, and humans all see the same result.</p>
+
+ <h2 class="h4 mt-5 mb-3">Capabilities</h2>
+ <ul>
+ <li><strong>Build-time Mojo</strong> — scan JAX-RS sources; emit enrichment pack JSON into each REST module JAR</li>
+ <li><strong>Multi-pack merge</strong> — runtime loader merges packs from core <code>rest</code> and extension modules</li>
+ <li><strong>CXF OpenApiFeature customizer</strong> — merges into live <code>/cxs/openapi.json</code> (and Swagger UI)</li>
+ <li><strong>Operation summary / description</strong> — from the first Javadoc sentences</li>
+ <li><strong>Parameter docs</strong> — <code>@param</code> Java names remapped to <code>@PathParam</code> / <code>@QueryParam</code> values</li>
+ <li><strong>Return / success docs</strong> — from <code>@return</code></li>
+ <li><strong>Named HTTP statuses</strong> — <code>@api.status</code> for realistic 2xx / 4xx / 5xx (not only “default response”)</li>
+ <li><strong>Examples</strong> — <code>@api.example</code> on operations and on schema properties</li>
+ <li><strong>Schema field docs</strong> — Javadoc on DTO fields (enums as string + values; maps document expected keys)</li>
+ <li><strong>Request / response models</strong> — enrichment for types used by hot paths (tenants, context, profiles, rules, segments, privacy, extensions, …)</li>
+ <li><strong>extraSourceRoots</strong> — document DTOs that live in a sibling <code>api</code> module</li>
+ <li><strong>Servlet endpoints</strong> — optional enrichment for documented <code>HttpServlet</code> paths (class-level tags)</li>
+ <li><strong>Single source of truth</strong> — no duplicate Swagger annotation tax on every method</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Try it on a running 3.1 server</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>curl -u karaf:karaf http://localhost:8181/cxs/openapi.json | jq '.paths["/tenants/{tenantId}"].get'</code></pre>
+ <p>Compare operation descriptions, response maps, and examples against a 2.x or early-3.0 baseline — the inventory stays stable; the documentation density is what changes.</p>
+
+ <h2 class="h4 mt-5 mb-3">Why publish this with 3.1</h2>
+ <p>Unomi 3 kept the REST surface familiar for migrations. Enrichment makes that surface
+ <em>discoverable</em>
+ for contributors, customer engineers, and LLM / agent tooling that already prefer OpenAPI over tribal knowledge.
+ It pairs with the
+ <a href="/blog/unomi-3-manual.html">manual</a>
+ and
+ <a href="/blog/unomi-3-request-tracing.html">request tracing</a>
+ investments: docs you can read, traces you can run, schemas you can generate clients from.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="{{ site.data.unomi.manual.published_latest }}">Unomi 3.1 manual</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/migrating-to-unomi-3.html">API stability / migrate</a>
+ <a class="btn btn-outline-primary ms-2" href="https://issues.apache.org/jira/browse/UNOMI-963">UNOMI-963</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-opensearch.html b/src/main/webapp/blog/unomi-3-opensearch.html
new file mode 100644
index 0000000..02db882
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-opensearch.html
@@ -0,0 +1,75 @@
+---
+title: Elasticsearch 9 and OpenSearch in Unomi 3
+description: "Unomi 3 runs on Elasticsearch 9 by default and ships a first-class OpenSearch persistence distribution — same SPI, migrate guide, and build flags."
+keywords: "Unomi OpenSearch, Elasticsearch 9, Apache Unomi persistence, UNOMI-828, migrate Elasticsearch to OpenSearch"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Operations</p>
+ <h1>Elasticsearch 9 and OpenSearch in Unomi 3</h1>
+ <p class="lead">One CDP runtime, two supported search backends — pick the distribution that matches your ops constraints.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Unomi 3 modernized the search tier on both sides of the fork.
+ Elasticsearch moved to the <strong>9.x Java API client</strong> (the legacy High Level REST Client path is gone), and
+ <a href="https://issues.apache.org/jira/browse/UNOMI-828">UNOMI-828</a>
+ /
+ <a href="https://github.com/apache/unomi/pull/715">#715</a>
+ made <strong>OpenSearch a first-class persistence module</strong> with its own distribution packaging.</p>
+
+ <img src="/assets/images/unomi3/opensearch-dual.svg" class="img-fluid my-4" alt="Elasticsearch 9 and OpenSearch dual backends sharing Unomi PersistenceService SPI"/>
+
+ <h2 class="h4 mt-4 mb-3">Capabilities</h2>
+ <ul>
+ <li><strong>Dual distributions</strong> — <code>unomi-distribution-elasticsearch</code> and <code>unomi-distribution-opensearch</code></li>
+ <li><strong>Shared PersistenceService SPI</strong> — profiles, events, segments, rules, clustering, and the task scheduler stay on the same application paths</li>
+ <li><strong>Elasticsearch 9 Java API client</strong> — HLRC retired; config prefix <code>org.apache.unomi.elasticsearch.*</code></li>
+ <li><strong>OpenSearch module</strong> — <code>persistence-opensearch</code>; config prefix <code>org.apache.unomi.opensearch.*</code> (addresses, cluster name, credentials, SSL, index prefix)</li>
+ <li><strong>Build flags</strong> — Maven / <code>build.sh --use-opensearch</code>; IT matrix can run either engine</li>
+ <li><strong>Docker / env</strong> — <code>UNOMI_DISTRIBUTION=...</code> selects packaging</li>
+ <li><strong>Migration guide</strong> — documented ES → OpenSearch path (index naming, clients, verification)</li>
+ <li><strong>Version pins in 3.1</strong> — Elasticsearch 9.4.x line and OpenSearch 3.7.x companion pins in the reactor</li>
+ </ul>
+
+ <h2 class="h4 mt-4 mb-3">What you choose</h2>
+ <ul>
+ <li><strong>Elasticsearch</strong> — <code>persistence-elasticsearch</code>, config prefix <code>org.apache.unomi.elasticsearch.*</code> (addresses, cluster name, credentials, SSL, index prefix)</li>
+ <li><strong>OpenSearch</strong> — <code>persistence-opensearch</code>, config prefix <code>org.apache.unomi.opensearch.*</code> with the same conceptual shape</li>
+ </ul>
+ <p>Both implement the Unomi <code>PersistenceService</code> SPI, so profiles, events, segments, rules, clustering, and the task scheduler stay on the same application paths.</p>
+
+ <h2 class="h4 mt-5 mb-3">Build and run flavors</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code># Maven / build.sh
+./build.sh
+./build.sh --use-opensearch
+./build.sh --integration-tests --use-opensearch
+
+# Docker distribution hint
+UNOMI_DISTRIBUTION=unomi-distribution-elasticsearch
+UNOMI_DISTRIBUTION=unomi-distribution-opensearch</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Migrating engines</h2>
+ <p>Moving an existing deployment from Elasticsearch to OpenSearch is documented as its own migration path (index naming, client settings, verification).
+ Start from
+ <a href="{{ site.data.unomi.manual.es_to_os }}">Migrate from Elasticsearch to OpenSearch</a>
+ in the Unomi 3 manual.</p>
+
+ <h2 class="h4 mt-5 mb-3">Why it matters</h2>
+ <p>Regulated and cloud-restricted environments often need an OpenSearch footprint; others stay on Elasticsearch.
+ Unomi 3 stops treating that as a fork of the product — it is a packaging and configuration choice on a shared SPI, alongside the
+ <a href="/blog/unomi-3-platform-foundation.html">platform foundation</a>
+ upgrade (Java 17, Karaf 4.4, persistence clustering).</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="{{ site.data.unomi.manual.es_to_os }}">Manual: ES to OpenSearch</a>
+ <a class="btn btn-outline-primary ms-2" href="{{ site.data.unomi.manual.published_latest }}#_configuration">Manual: configuration</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-build-sh.html">build.sh</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-platform-foundation.html b/src/main/webapp/blog/unomi-3-platform-foundation.html
new file mode 100644
index 0000000..cc67d10
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-platform-foundation.html
@@ -0,0 +1,50 @@
+---
+title: Unomi 3 platform foundation
+description: "What Unomi 3.0 changed under the hood — Java 17, Karaf 4.4, Elasticsearch 9, and persistence-based clustering without Cellar or Hazelcast."
+keywords: "Unomi 3 platform, Java 17, Karaf 4.4, UNOMI-877, persistence clustering, Elasticsearch 9"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Platform</p>
+ <h1>Unomi 3 platform foundation</h1>
+ <p class="lead">The 3.0 runtime floor — Java 17, Karaf 4.4, Elasticsearch 9, and clustering without Cellar or Hazelcast.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Before multi-tenancy and the Unomi 3.1 product leap could stick, the project needed a boring, modern runtime.
+ That is what the 3.0 line delivered: fewer legacies, clearer installers, and a cluster model that matches how Unomi already stores data.</p>
+
+ <img src="/assets/images/unomi3/platform-foundation.svg" class="img-fluid my-4" alt="Unomi 3 platform tiles: Java 17, Karaf 4.4, search clients, persistence clustering"/>
+
+ <h2 class="h4 mt-4 mb-3">Baseline upgrades</h2>
+ <ul>
+ <li><strong>Java 17+</strong> — Java 11 is retired for Unomi 3 installers and CI</li>
+ <li><strong>Apache Karaf 4.4</strong> — continued into 3.1 with current patch lines (for example 4.4.11)</li>
+ <li><strong>Elasticsearch 9</strong> — Java API client; HLRC retired; OpenSearch as a peer distribution (see
+ <a href="/blog/unomi-3-opensearch.html">Elasticsearch 9 and OpenSearch</a>)</li>
+ <li><strong>Log / dependency pins</strong> — platform bump PRs keep Log4j and client stacks on supported lines</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Persistence-based clustering (UNOMI-877)</h2>
+ <p>Cellar and Hazelcast are gone. Nodes register <code>ClusterNode</code> documents in Elasticsearch or OpenSearch, publish heartbeats and stats, and discover peers through the shared index.
+ The same mechanism underpins executor selection and locking for the
+ <a href="/blog/unomi-3-task-scheduler.html">cluster-aware task scheduler</a>.</p>
+
+ <h2 class="h4 mt-5 mb-3">What operators should do</h2>
+ <p>Treat 3.0 as the platform cutover: confirm Java 17 hosts, pick an ES9 or OpenSearch distribution, and read the clustering and health-check chapters before stacking tenants and tasks.
+ The
+ <a href="/blog/migrating-to-unomi-3.html">migrating from 2.x</a>
+ post covers the REST and auth cutover; the manual holds the day-two runbooks.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="{{ site.data.unomi.manual.published_latest }}#_clustering">Manual: clustering</a>
+ <a class="btn btn-outline-primary ms-2" href="{{ site.data.unomi.manual.whats_new }}">What’s new</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/introducing-apache-unomi-3.html">Introducing Unomi 3</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-request-tracing.html b/src/main/webapp/blog/unomi-3-request-tracing.html
new file mode 100644
index 0000000..f5bfdf8
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-request-tracing.html
@@ -0,0 +1,168 @@
+---
+title: Request tracing with explain=true in Unomi 3
+description: "Debug context and eventcollector requests with explain=true — admin-gated requestTracing trees, verified curl examples, and what 403 means for public API keys."
+keywords: "Unomi explain, requestTracing, Unomi tracing, UNOMI-873, eventcollector explain, context.json explain"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Debugging</p>
+ <h1>Request tracing with <code>explain=true</code></h1>
+ <p class="lead">See condition evaluations, rule actions, and timings on <code>/cxs/context.json</code> and <code>/cxs/eventcollector</code>.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>When a rule “should have fired” or a session update looks wrong, guessing from logs is slow.
+ Unomi 3 adds query-parameter tracing (
+ <a href="https://issues.apache.org/jira/browse/UNOMI-873">UNOMI-873</a>
+ /
+ <a href="https://github.com/apache/unomi/pull/775">#775</a>):
+ append <code>explain=true</code> and the response includes a <code>requestTracing</code> tree.</p>
+
+ <img src="/assets/images/unomi3/request-tracing.svg" class="img-fluid my-4" alt="explain=true producing a requestTracing tree of conditions and actions"/>
+
+ <h2 class="h4 mt-4 mb-3">Where it works</h2>
+ <ul>
+ <li><code>POST</code>/<code>GET</code> <code>/cxs/context.json</code> and <code>/cxs/context.js</code></li>
+ <li><code>POST</code>/<code>GET</code> <code>/cxs/eventcollector</code></li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Capabilities</h2>
+ <ul>
+ <li><strong>Opt-in per request</strong> — <code>?explain=true</code> enables tracing for that call only</li>
+ <li><strong>Response field</strong> — <code>requestTracing</code> on <code>ContextResponse</code> / <code>EventCollectorResponse</code></li>
+ <li><strong>Hierarchical tree</strong> — nested <code>TraceNode</code> children for nested work</li>
+ <li><strong>Per-node fields</strong> — <code>operationType</code>, <code>description</code>, <code>context</code>, <code>result</code>, <code>startTime</code>, <code>endTime</code>, <code>traces[]</code>, <code>children[]</code></li>
+ <li><strong>What gets traced</strong> — request processing, event validation, rule evaluation, condition evaluation (property/boolean/…), action execution (visit counters, segment eval, age, …), personalization / content-filter evaluation on context requests</li>
+ <li><strong>Timings</strong> — wall-clock start/end on every node for latency hunting</li>
+ <li><strong>Auth gate</strong> — <code>ROLE_UNOMI_ADMIN</code> / <code>ROLE_UNOMI_TENANT_ADMIN</code> only; public API key alone returns HTTP 403</li>
+ <li><strong>Low overhead when off</strong> — tracer disabled unless <code>explain=true</code>; reset after the request</li>
+ <li><strong>Programmatic API</strong> — <code>TracerService</code> / <code>RequestTracer</code> for services that start nested operations</li>
+ <li><strong>IT coverage</strong> — authorized explain success + unauthorized 403 paths</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Auth: tenant admin, not the public key</h2>
+ <p>Tracing is restricted to <strong>ADMINISTRATOR</strong> / <strong>TENANT_ADMINISTRATOR</strong>.
+ In practice that means authenticate with the tenant <strong>private</strong> API key (Basic <code>tenantId:privateApiKey</code>), not the public track key.</p>
+ <p>We verified the following against a local <strong>Unomi 3.1.0-SNAPSHOT</strong> (HTTPS). Public-key + <code>explain=true</code> returned HTTP <strong>403</strong> with:</p>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>{"errorMessage":"Insufficient privileges to access tracing information"}</code></pre>
+ <p>Integration coverage: <code>EventsCollectorIT#testEventsCollectorWithExplain</code> and <code>#testEventsCollectorWithExplainUnauthorized</code>.</p>
+
+ <h2 class="h4 mt-5 mb-3">Example: event collector</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>curl -X POST 'http://localhost:8181/cxs/eventcollector?explain=true' \
+ -u 'YOUR_TENANT_ID:YOUR_PRIVATE_API_KEY' \
+ -H 'Content-Type: application/json' \
+ -d @- <<'EOF'
+{
+ "sessionId": "trace-demo-1",
+ "events": [
+ {
+ "eventType": "view",
+ "scope": "myscope",
+ "source": {
+ "itemType": "site",
+ "scope": "myscope",
+ "itemId": "mysite"
+ },
+ "target": {
+ "itemType": "page",
+ "scope": "myscope",
+ "itemId": "homepage"
+ }
+ }
+ ]
+}
+EOF</code></pre>
+ <p>Verified excerpt (trimmed) from a live 3.1 response — session create, condition checks, visit counters:</p>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>{
+ "updated": 6,
+ "requestTracing": {
+ "operationType": "event-collection",
+ "description": "Event collection request processed successfully",
+ "startTime": 1784099217601,
+ "endTime": 1784099217629,
+ "traces": [
+ "Sending event: sessionCreated - Context: …",
+ "Processing event for profile: …"
+ ],
+ "children": [
+ {
+ "operationType": "condition-evaluation",
+ "description": "Condition evaluation completed",
+ "result": "true",
+ "children": [
+ {
+ "operationType": "boolean",
+ "description": "OR condition succeeded on subcondition",
+ "result": "true"
+ }
+ ]
+ },
+ {
+ "operationType": "action-execution",
+ "description": "Action execution completed",
+ "children": [
+ {
+ "operationType": "increment-property",
+ "description": "Property incremented successfully",
+ "traces": [
+ "Processing property increment - Context: {propertyName=nbOfVisits, …}",
+ "Property increment result - Context: {newValue=1, isUpdated=true}"
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Example: context.json</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>curl -X POST \
+ 'http://localhost:8181/cxs/context.json?sessionId=trace-demo-1&explain=true' \
+ -u 'YOUR_TENANT_ID:YOUR_PRIVATE_API_KEY' \
+ -H 'Content-Type: application/json' \
+ -d @- <<'EOF'
+{
+ "source": {
+ "itemId": "homepage",
+ "itemType": "page",
+ "scope": "myscope"
+ },
+ "requiredProfileProperties": ["*"],
+ "requireSegments": true
+}
+EOF</code></pre>
+ <p>Live trace root on the same stack:</p>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>"requestTracing": {
+ "operationType": "context-request",
+ "description": "Context request processed successfully",
+ "children": [
+ { "operationType": "condition-evaluation", … },
+ { "operationType": "action-execution",
+ "children": [
+ { "operationType": "evaluate-age", "description": "No changes needed" },
+ { "operationType": "evaluate-segments", "description": "No changes needed" }
+ ]
+ }
+ ]
+}</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">How to read the tree</h2>
+ <ul>
+ <li><strong>Timings</strong> — subtract <code>endTime - startTime</code> on hot nodes when hunting latency</li>
+ <li><strong>Conditions</strong> — look for <code>result: false</code> on rules you expected to match</li>
+ <li><strong>Actions</strong> — <code>increment-property</code>, <code>evaluate-segments</code>, visit helpers show whether profile state actually changed</li>
+ </ul>
+ <p>For save-time condition checks (before runtime), use condition validation in the manual; tracing is the runtime companion.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="{{ site.data.unomi.manual.published_latest }}#_request_tracing_explain">Manual: explain / tracing</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-manual.html">Manual improvements</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-task-scheduler.html">Task scheduler</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-shell-commands.html b/src/main/webapp/blog/unomi-3-shell-commands.html
new file mode 100644
index 0000000..1e1b6e8
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-shell-commands.html
@@ -0,0 +1,116 @@
+---
+title: Unomi 3 Karaf shell commands
+description: "Unomi 3 expands the unomi:* Karaf shell — unified unomi:crud, tenant session context, cache ops, task scheduler commands, and list-invalid-objects (UNOMI-879 / 880)."
+keywords: "Unomi shell, unomi:crud, Karaf shell, unomi:cache, unomi:task-list, tenant-set, UNOMI-879, UNOMI-880"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Operator experience</p>
+ <h1>Karaf shell commands in Unomi 3</h1>
+ <p class="lead"><code>unomi:crud</code>, tenant session context, cache tools, and task commands — operate without leaving SSH.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>The Unomi Karaf shell (<code>ssh -p 8102 karaf@localhost</code>, namespace <code>unomi:</code>) has always been the fastest way to inspect rules, tail events, and manage lifecycle.
+ Unomi 3 (
+ <a href="https://issues.apache.org/jira/browse/UNOMI-879">UNOMI-879</a>
+ /
+ <a href="https://issues.apache.org/jira/browse/UNOMI-880">UNOMI-880</a>
+ /
+ <a href="https://github.com/apache/unomi/pull/755">#755</a>
+ /
+ <a href="https://github.com/apache/unomi/pull/763">#763</a>)
+ widens that toolkit for multi-tenancy, caches, and the cluster-aware scheduler — with a unified CRUD surface instead of one-off list/view/remove commands for every type.</p>
+
+ <img src="/assets/images/unomi3/shell-commands.svg" class="img-fluid my-4" alt="Unomi 3 shell: crud, tenant, cache, and task command families"/>
+
+ <h2 class="h4 mt-4 mb-3">Capabilities at a glance</h2>
+ <ul>
+ <li><strong>Unified <code>unomi:crud</code></strong> — <code>create</code> / <code>read</code> / <code>update</code> / <code>delete</code> / <code>list</code> / <code>help</code> for many object types</li>
+ <li><strong>JSON or file input</strong> — inline JSON, <code>file://</code> paths, or positional id + body patterns</li>
+ <li><strong>Tabular + CSV lists</strong> — ASCII tables with <code>--csv</code> and <code>-n</code> / <code>--max-entries</code></li>
+ <li><strong>Completers</strong> — operation, type, and id completion for faster operator workflows</li>
+ <li><strong>Tenant session</strong> — <code>unomi:tenant-get</code> / <code>unomi:tenant-set</code> so following commands run in a tenant (or <code>system</code>)</li>
+ <li><strong>Tenant & API key CRUD</strong> — create/list/update tenants and API keys from the shell</li>
+ <li><strong>Cache management</strong> — <code>unomi:cache</code> stats, reset, clear, inspect, view, remove, watch, filters by tenant/type, CSV</li>
+ <li><strong>Scheduler ops</strong> — <code>unomi:task-list|show|cancel|retry|purge|executor</code> (see
+ <a href="/blog/unomi-3-task-scheduler.html">task scheduler</a>)</li>
+ <li><strong>Validation assist</strong> — <code>unomi:list-invalid-objects</code> for rules/segments/goals/campaigns/scoring with unresolved types</li>
+ <li><strong>Classic live debugging</strong> — <code>rule-tail</code>, <code>rule-watch</code>, <code>event-tail</code>, <code>rule-reset-stats</code></li>
+ <li><strong>Lifecycle</strong> — <code>setup</code>, <code>migrate</code>, <code>start</code>, <code>stop</code>, <code>version</code></li>
+ <li><strong>Definition deploy</strong> — <code>deploy-definition</code> / <code>undeploy-definition</code> with bundle/type wildcards</li>
+ <li><strong>Extension types</strong> — e.g. JSON Schema via <code>unomi:crud ... schema</code> when the extension is installed</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Connect and discover</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>ssh -p 8102 karaf@localhost
+# default user/pass: karaf/karaf (change etc/users.properties ASAP)
+
+unomi:<TAB> # list commands
+help unomi:crud
+help unomi:cache</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Tenant context first</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:tenant-set acme
+unomi:tenant-get
+# subsequent CRUD / cache commands use this tenant</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Unified CRUD</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:crud help rule
+unomi:crud list rule --csv -n 50
+unomi:crud read rule my-rule-id
+unomi:crud create rule --file /tmp/rule.json
+unomi:crud update rule my-rule-id -d='{"itemId":"my-rule-id","enabled":false}'
+unomi:crud delete rule my-rule-id
+
+unomi:crud list tenant
+unomi:crud create apikey -d='{"tenantId":"acme","keyType":"PRIVATE"}'
+unomi:crud list profile -n 20
+unomi:crud list schema # when json-schema extension is present</code></pre>
+
+ <h3 class="h6 mt-4 mb-2">Object types registered for <code>unomi:crud</code></h3>
+ <p class="small text-muted"><code>actiontype</code>, <code>apikey</code>, <code>campaign</code>, <code>campaignevent</code>, <code>conditiontype</code>, <code>consent</code>, <code>event</code>, <code>goal</code>, <code>persona</code>, <code>profile</code>, <code>profilealias</code>, <code>propertytype</code>, <code>rule</code>, <code>rulestats</code>, <code>scope</code>, <code>scoring</code>, <code>segment</code>, <code>session</code>, <code>tenant</code>, <code>topic</code>, pl [...]
+
+ <h2 class="h4 mt-5 mb-3">Cache</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:cache --stats
+unomi:cache --stats --detailed --tenant acme
+unomi:cache --stats --type profile --csv
+unomi:cache --clear --tenant acme
+unomi:cache --inspect
+unomi:cache --view --id ENTRY_ID --type … --tenant acme
+unomi:cache --remove --id ENTRY_ID --type … --tenant acme
+unomi:cache --watch 5</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Scheduler (shell twin of REST)</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:task-list -s RUNNING
+unomi:task-list -t profile-purge --limit 20
+unomi:task-show TASK_ID
+unomi:task-retry TASK_ID --reset
+unomi:task-cancel TASK_ID
+unomi:task-purge --days 14 --force
+unomi:task-executor</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Still there: live debugging & lifecycle</h2>
+ <ul>
+ <li><code>rule-list|view|remove|reset-stats|tail|watch</code></li>
+ <li><code>event-tail|view|list|search</code></li>
+ <li><code>action-list|view</code>, <code>condition-list|view</code></li>
+ <li><code>profile-list|view|remove</code>, <code>segment-*</code>, <code>session-*</code></li>
+ <li><code>list-invalid-objects</code></li>
+ <li><code>deploy-definition</code> / <code>undeploy-definition</code></li>
+ <li><code>setup</code>, <code>migrate</code>, <code>start</code>, <code>stop</code>, <code>version</code></li>
+ </ul>
+ <p>Many day-to-day inspect/edit flows now go through <code>unomi:crud</code>; the dedicated list/view/remove commands remain useful for scripting habits and live tails.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="{{ site.data.unomi.manual.published_latest }}#_shell_commands">Manual: shell commands</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-task-scheduler.html">Task scheduler</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-multitenancy.html">Multi-tenancy</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-task-scheduler.html b/src/main/webapp/blog/unomi-3-task-scheduler.html
new file mode 100644
index 0000000..47be3ac
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-task-scheduler.html
@@ -0,0 +1,102 @@
+---
+title: Cluster-aware task scheduler in Unomi 3.1
+description: "Unomi 3.1 durable task scheduler — full capability list: persistence, cluster locks, lifecycle, fluent builder, REST ops, shell, metrics, resume, and built-in jobs."
+keywords: "Unomi task scheduler, /cxs/tasks, unomi:task-list, Unomi 3.1, profile-purge, cluster tasks, TaskExecutor"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3.1 · Operations</p>
+ <h1>Cluster-aware task scheduler</h1>
+ <p class="lead">Durable background work with persistence, locks, retry/resume, REST, shell, and a plugin-friendly fluent API.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Unomi 3.1 introduces a first-class <strong>task scheduler</strong> for work that must run reliably on a single node or across a cluster:
+ maintenance timers, request offload (for example profile-merge follow-up), and operator-visible retry/cancel.</p>
+ <p>It sits on the
+ <a href="/blog/unomi-3-platform-foundation.html">persistence-based clustering</a>
+ model — executor nodes and locks use the shared search index rather than Cellar or Hazelcast.</p>
+
+ <img src="/assets/images/unomi3/task-scheduler.svg" class="img-fluid my-4" alt="SchedulerService with REST, built-in task types, and Karaf shell"/>
+
+ <h2 class="h4 mt-4 mb-3">Capabilities at a glance</h2>
+ <ul>
+ <li><strong>Task types + executors</strong> — each logical <code>taskType</code> is handled by a registered <code>TaskExecutor</code> (core services or plugins)</li>
+ <li><strong>Persistent or in-memory</strong> — cluster-visible <code>scheduledTask</code> items in Elasticsearch/OpenSearch, or <code>nonPersistent()</code> node-local tasks (typical for cache refresh)</li>
+ <li><strong>One-shot and recurring</strong> — <code>asOneShot()</code>, or period + <code>withFixedDelay()</code> / <code>withFixedRate()</code>, with optional <code>withInitialDelay</code></li>
+ <li><strong>Cluster coordination</strong> — executor nodes (<code>scheduler.executorNode</code>), cluster locks, optional <code>runOnAllNodes()</code>, parallel execution control via <code>disallowParallelExecution()</code></li>
+ <li><strong>Lifecycle</strong> — statuses <code>SCHEDULED</code>, <code>WAITING</code>, <code>RUNNING</code>, <code>COMPLETED</code>, <code>FAILED</code>, <code>CANCELLED</code>, <code>CRASHED</code></li>
+ <li><strong>Retries</strong> — <code>withMaxRetries</code> / <code>withRetryDelay</code> (auto); manual retry via REST/shell (optional failure-count reset)</li>
+ <li><strong>Dependencies</strong> — <code>withDependencies(taskId…)</code> so a task waits until prior work is <code>COMPLETED</code></li>
+ <li><strong>Checkpoints / resume</strong> — long jobs save <code>checkpointData</code> / <code>currentStep</code>; operators resume <code>CRASHED</code> tasks when the executor implements <code>canResume</code> / <code>resume</code></li>
+ <li><strong>Parameters</strong> — JSON-serializable map passed into the executor (include <code>tenantId</code> and run under <code>executeAsTenant</code> for tenant isolation)</li>
+ <li><strong>System tasks</strong> — <code>asSystemTask()</code> for jobs created at init that should be preserved across restarts</li>
+ <li><strong>Fluent API</strong> — <code>schedulerService.newTask(type)</code> builder; also <code>createRecurringTask</code> / <code>createTask</code> helpers</li>
+ <li><strong>Plugin registration</strong> — register/unregister <code>TaskExecutor</code> from OSGi DS <code>activate</code> / <code>deactivate</code></li>
+ <li><strong>REST ops</strong> — list (filter by status/type, pagination), get, cancel, retry, resume (admin / tenant-admin); task <em>creation</em> stays in Java services/plugins</li>
+ <li><strong>Karaf shell</strong> — <code>unomi:task-list|show|cancel|retry|purge|executor</code></li>
+ <li><strong>Built-in purge</strong> — periodic <code>task-purge</code> of old <code>COMPLETED</code> records (<code>scheduler.purgeTaskEnabled</code>, TTL days)</li>
+ <li><strong>Metrics</strong> — <code>getMetric</code> / <code>getAllMetrics</code> (completed, failed, crashed, running, lock conflicts, recovery attempts, …)</li>
+ <li><strong>Config</strong> — thread pool size, stable <code>scheduler.nodeId</code>, lock timeout, executor vs API-only node roles in <code>org.apache.unomi.services.cfg</code></li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">REST surface</h2>
+ <p>Base path <code>/cxs/tasks</code> (roles <code>ROLE_UNOMI_ADMIN</code> / <code>ROLE_UNOMI_TENANT_ADMIN</code>) — monitoring and operations, not create:</p>
+ <ul>
+ <li><code>GET /cxs/tasks</code> — paginated list; filters <code>status=</code>, <code>type=</code>, <code>offset</code>, <code>limit</code></li>
+ <li><code>GET /cxs/tasks/{id}</code> — detail (parameters, checkpoint, errors)</li>
+ <li><code>DELETE /cxs/tasks/{id}</code> — cancel (HTTP 204; record kept as <code>CANCELLED</code>)</li>
+ <li><code>POST /cxs/tasks/{id}/retry</code> — optional <code>?resetFailureCount=true</code></li>
+ <li><code>POST /cxs/tasks/{id}/resume</code> — for <code>CRASHED</code> + checkpoint-capable executors</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">Karaf shell</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:task-list [-s STATUS] [-t TYPE] [--limit N]
+unomi:task-show <id>
+unomi:task-cancel <id>
+unomi:task-retry <id> [--reset]
+unomi:task-purge [--days N] [--force]
+unomi:task-executor # is this node an executor? nodeId?</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Fluent scheduling (plugins / services)</h2>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>schedulerService.newTask("cache-refresh-segment")
+ .nonPersistent()
+ .withPeriod(1, TimeUnit.SECONDS)
+ .withFixedDelay()
+ .disallowParallelExecution()
+ .withSimpleExecutor(() -> refreshSegmentCache())
+ .schedule();
+
+schedulerService.newTask("export-tenant-snapshot")
+ .withParameters(Map.of("tenantId", "acme"))
+ .asOneShot()
+ .withMaxRetries(3)
+ .withRetryDelay(2, TimeUnit.MINUTES)
+ .disallowParallelExecution()
+ .withExecutor(myExportExecutor)
+ .schedule();</code></pre>
+
+ <h2 class="h4 mt-5 mb-3">Built-in task types you will see</h2>
+ <ul>
+ <li><code>cache-refresh-*</code> — reload segments, rules, property types, scopes, … into memory</li>
+ <li><code>profile-purge</code></li>
+ <li><code>segment-date-recalculation</code></li>
+ <li><code>rules-statistics-refresh</code></li>
+ <li><code>task-purge</code> — purge old completed scheduler tasks</li>
+ <li><code>merge-profiles-reassign-data</code> — async session/event reassignment after profile merge (<code>baseplugin</code>)</li>
+ <li><code>clusterNodeStatisticsUpdate</code> / <code>clusterStaleNodesCleanup</code> — clustering maintenance</li>
+ </ul>
+ <p>Async enrichment-style jobs can reuse the same model instead of ad-hoc threads — register an executor, schedule with the builder, operate via REST/shell.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="{{ site.data.unomi.manual.published_latest }}#_scheduler">Manual: scheduler</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-platform-foundation.html">Platform foundation</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-request-tracing.html">Request tracing</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-unit-testing-harness.html b/src/main/webapp/blog/unomi-3-unit-testing-harness.html
new file mode 100644
index 0000000..9e4135b
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-unit-testing-harness.html
@@ -0,0 +1,84 @@
+---
+title: Faster Unomi service unit tests — InMemoryPersistenceServiceImpl
+description: "How Unomi 3’s in-memory PersistenceService test harness lets Profile, Event, Rules, and Segment services run real unit tests in seconds without Karaf or Elasticsearch."
+keywords: "Unomi unit tests, InMemoryPersistenceServiceImpl, UNOMI-881, Unomi TestHelper, Surefire"
+layout: default
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Quality</p>
+ <h1>Faster service unit tests</h1>
+ <p class="lead"><code>InMemoryPersistenceServiceImpl</code> — a full PersistenceService on the test classpath so service logic no longer waits on Karaf.</p>
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>In Unomi 2.x, most confidence meant <strong>integration tests</strong>: boot Karaf, talk to Elasticsearch (or Docker), wait.
+ That still matters for the live stack. It is the wrong loop for “does <code>ProfileServiceImpl</code> handle this edge case?”</p>
+ <p>
+ <a href="https://issues.apache.org/jira/browse/UNOMI-881">UNOMI-881</a>
+ /
+ <a href="https://github.com/apache/unomi/pull/772">#772</a>
+ /
+ <a href="https://github.com/apache/unomi/pull/776">#776</a>
+ added a unit-test harness centered on one class:</p>
+
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>services/src/test/java/org/apache/unomi/services/impl/InMemoryPersistenceServiceImpl.java</code></pre>
+
+ <img src="/assets/images/unomi3/unit-harness-vs-it.svg" class="img-fluid my-4" alt="Unit tests with InMemoryPersistenceServiceImpl versus full integration tests"/>
+
+ <h2 class="h4 mt-4 mb-3">What it is (and is not)</h2>
+ <p>It is <strong>not</strong> a production persistence engine. It is a complete <code>PersistenceService</code> implementation living only on the <strong>test</strong> classpath.</p>
+
+ <h2 class="h4 mt-5 mb-3">Capabilities</h2>
+ <ul>
+ <li><strong>Full SPI surface</strong> — save/load/remove, query (condition + field), range query, paginated <code>PartialList</code>, remove-by-query</li>
+ <li><strong>Real condition evaluation</strong> — <code>ConditionEvaluatorDispatcher</code> (not a stubbed query layer)</li>
+ <li><strong>In-memory store</strong> — <code>ConcurrentHashMap</code> keyed items; optional JSON file mirror under <code>target/persistence-data</code> (pretty-print, clear-on-init)</li>
+ <li><strong>Refresh simulation</strong> — optional refresh delay thread; per-item-type policies <code>FALSE</code> / <code>TRUE</code> / <code>WAIT_FOR</code>; <code>refresh()</code> API</li>
+ <li><strong>Scroll</strong> — scroll id + time validity like ES/OS style paging</li>
+ <li><strong>Default query limit</strong> — mirrors search-engine default size when callers pass negative size</li>
+ <li><strong>Property mappings</strong> — set/get property mapping metadata used by services</li>
+ <li><strong>Aggregates</strong> — persistence aggregate SPI support used by analytics-style service tests</li>
+ <li><strong>Sequences / primary terms</strong> — index sequence helpers for ID generation scenarios</li>
+ <li><strong>System-item ID conventions</strong> — same <code>tenantId_itemId_itemType</code> rules as ES/OS for system types (rules, segments, schemas, …)</li>
+ <li><strong>Tenant transformation listeners</strong> — register listeners like production persistence</li>
+ <li><strong>Batching / overwrite flags</strong> — <code>save(item, useBatching, alwaysOverwrite)</code> overloads</li>
+ <li><strong>Lifecycle</strong> — <code>shutdown()</code> to stop refresh threads between tests</li>
+ </ul>
+
+ <h2 class="h4 mt-5 mb-3">How tests use it</h2>
+ <p>Typical Surefire tests construct the harness, wire a real <code>*ServiceImpl</code>, and assert behavior without OSGi:</p>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>persistenceService = new InMemoryPersistenceServiceImpl(
+ executionContextManager, conditionEvaluatorDispatcher);
+
+// then inject into ProfileServiceImpl, EventServiceImpl,
+// RulesServiceImpl, SegmentServiceImpl, …</code></pre>
+ <p>Concrete adopters in-tree include <code>ProfileServiceImplTest</code>, <code>EventServiceImplTest</code>, <code>RulesServiceImplTest</code>, <code>SegmentServiceImplTest</code>, and the self-test <code>InMemoryPersistenceServiceImplTest</code>.</p>
+
+ <h2 class="h4 mt-5 mb-3">Unit vs integration</h2>
+ <div class="table-responsive">
+ <table class="table table-sm align-middle">
+ <thead><tr><th></th><th>Integration tests</th><th>Harness unit tests</th></tr></thead>
+ <tbody>
+ <tr><td>Speed</td><td>Minutes+</td><td>Seconds</td></tr>
+ <tr><td>Isolation</td><td>Shared cluster state</td><td>Fresh store per test</td></tr>
+ <tr><td>Scope</td><td>Full platform</td><td>One service / scenario</td></tr>
+ <tr><td>Fidelity</td><td>Production ES/OS</td><td>SPI + conditions + refresh simulation</td></tr>
+ </tbody>
+ </table>
+ </div>
+ <p>ITs prove the live stack (and pair with the
+ <a href="/blog/unomi-3-it-execution.html">clearer IT console</a>).
+ The harness is why Unomi 3 could grow high-signal <code>@Test</code> coverage around services without waiting on Docker every time.</p>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="https://github.com/apache/unomi/blob/master/services/src/test/java/org/apache/unomi/services/impl/InMemoryPersistenceServiceImpl.java">View on GitHub</a>
+ <a class="btn btn-outline-primary ms-2" href="/contribute/testing.html">Contribute · Testing</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-it-execution.html">IT execution</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/sitemap.xml b/src/main/webapp/sitemap.xml
index 69901b5..e2030eb 100644
--- a/src/main/webapp/sitemap.xml
+++ b/src/main/webapp/sitemap.xml
@@ -214,6 +214,56 @@
<changefreq>monthly</changefreq>
<priority>0.85</priority>
</url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-it-execution.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.75</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-manual.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-build-sh.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.75</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-platform-foundation.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-opensearch.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-unit-testing-harness.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.75</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-shell-commands.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-task-scheduler.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.75</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-request-tracing.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-openapi-enrichment.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.8</priority>
+ </url>
<url>
<loc>https://unomi.apache.org/llms.txt</loc>
<lastmod>2026-07-14</lastmod>
(unomi-site) 04/05: Fix Unomi 3.1 site examples against live API behavior (UNOMI-932)
Posted by sh...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
sergehuber pushed a commit to branch UNOMI-932-unomi3-major-release-story
in repository https://gitbox.apache.org/repos/asf/unomi-site.git
commit 45d33ccef93f5c1c48e66a7531a8209f53a07673
Author: Serge Huber <sh...@apache.org>
AuthorDate: Thu Jul 16 12:10:59 2026 +0200
Fix Unomi 3.1 site examples against live API behavior (UNOMI-932)
Document API key regen for plainTextKey, require scopes before context/events, and put view pageInfo under target.properties so built-in referrer rules stay quiet.
---
src/main/webapp/blog/unomi-3-request-tracing.html | 26 ++++++++++-
src/main/webapp/blog/unomi-3-shell-commands.html | 19 ++++++--
src/main/webapp/get-started.html | 25 ++++++++--
src/main/webapp/llms-full.txt | 11 ++++-
src/main/webapp/llms.txt | 3 +-
src/main/webapp/tutorial.html | 56 +++++++++++++----------
6 files changed, 103 insertions(+), 37 deletions(-)
diff --git a/src/main/webapp/blog/unomi-3-request-tracing.html b/src/main/webapp/blog/unomi-3-request-tracing.html
index f5bfdf8..faf1858 100644
--- a/src/main/webapp/blog/unomi-3-request-tracing.html
+++ b/src/main/webapp/blog/unomi-3-request-tracing.html
@@ -51,7 +51,21 @@ layout: default
<pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>{"errorMessage":"Insufficient privileges to access tracing information"}</code></pre>
<p>Integration coverage: <code>EventsCollectorIT#testEventsCollectorWithExplain</code> and <code>#testEventsCollectorWithExplainUnauthorized</code>.</p>
+ <h2 class="h4 mt-5 mb-3">Prerequisite: create the scope</h2>
+ <p>JSON Schema validation rejects events whose <code>scope</code> is unknown for the tenant
+ (<code>Unknown scope value … for value myscope</code>). Create the scope first:</p>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>curl -X POST http://localhost:8181/cxs/scopes \
+ -u 'YOUR_TENANT_ID:YOUR_PRIVATE_API_KEY' \
+ -H 'Content-Type: application/json' \
+ -d '{
+ "itemId": "myscope",
+ "itemType": "scope",
+ "metadata": { "id": "myscope", "name": "My scope" }
+ }'</code></pre>
+
<h2 class="h4 mt-5 mb-3">Example: event collector</h2>
+ <p class="small text-muted">Include <code>target.properties.pageInfo</code> (at least <code>referringURL</code> / <code>pagePath</code>).
+ Built-in rules such as <code>sessionReferrer</code> read those fields; omitting them still works but logs noisy WARNs.</p>
<pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>curl -X POST 'http://localhost:8181/cxs/eventcollector?explain=true' \
-u 'YOUR_TENANT_ID:YOUR_PRIVATE_API_KEY' \
-H 'Content-Type: application/json' \
@@ -70,7 +84,17 @@ layout: default
"target": {
"itemType": "page",
"scope": "myscope",
- "itemId": "homepage"
+ "itemId": "homepage",
+ "properties": {
+ "pageInfo": {
+ "pageID": "homepage",
+ "pagePath": "/home",
+ "pageName": "Home",
+ "destinationURL": "https://example.com/home",
+ "referringURL": "https://example.com/",
+ "language": "en"
+ }
+ }
}
}
]
diff --git a/src/main/webapp/blog/unomi-3-shell-commands.html b/src/main/webapp/blog/unomi-3-shell-commands.html
index 148e6ed..83497da 100644
--- a/src/main/webapp/blog/unomi-3-shell-commands.html
+++ b/src/main/webapp/blog/unomi-3-shell-commands.html
@@ -56,8 +56,11 @@ unomi:version
unomi:cache --stats</code></pre>
<h2 class="h4 mt-5 mb-3">Tenant context first</h2>
- <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code># Create a tenant (generates public + private API keys)
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code># Create a tenant (hashed keys are stored; plaintext only via create apikey)
unomi:crud create tenant '{"itemId":"acme","name":"Acme Corp"}'
+unomi:crud create apikey '{"tenantId":"acme","keyType":"PUBLIC"}'
+unomi:crud create apikey '{"tenantId":"acme","keyType":"PRIVATE"}'
+# plaintext key is printed once for each create apikey — store it immediately
unomi:crud list tenant
unomi:tenant-set acme
@@ -115,6 +118,13 @@ unomi:crud update profile demo-ada '{"firstName":"Ada","lastName":"Lovelace","em
unomi:crud delete profile demo-ada</code></pre>
<p class="small text-muted">There are no separate <code>profile-list</code> / <code>profile-view</code> commands in Unomi 3 — use <code>unomi:crud list|read|delete profile</code>.</p>
+ <h3 class="h6 mt-4 mb-2">Scope first</h3>
+ <p class="small text-muted">Sessions and events must reference a scope that already exists for the tenant.
+ Without it, event schema validation logs <code>Unknown scope value</code> and rejects the payload.</p>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code># Scope name lives under metadata (not a top-level "name" field)
+unomi:crud create scope '{"itemId":"myscope","metadata":{"id":"myscope","name":"My scope"}}'
+unomi:crud list scope</code></pre>
+
<h3 class="h6 mt-4 mb-2">Sessions</h3>
<pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:crud help session
unomi:crud list session -n 20
@@ -134,11 +144,10 @@ unomi:crud delete session demo-session-1</code></pre>
unomi:crud list event -n 50
unomi:crud read event EVENT_ID
-# Send / persist a view event (create goes through EventService.send)
-unomi:crud create event '{"itemId":"demo-event-1","eventType":"view","scope":"myscope","profileId":"demo-ada","sessionId":"demo-session-1","source":{"itemType":"site","scope":"myscope","itemId":"mysite"},"target":{"itemType":"page","scope":"myscope","itemId":"homepage"},"properties":{"pageInfo":{"pagePath":"/home"}},"persistent":true}'
+# View events: put pageInfo under target.properties (built-in sessionReferrer reads referringURL there)
+unomi:crud create event '{"itemId":"demo-event-1","eventType":"view","scope":"myscope","profileId":"demo-ada","sessionId":"demo-session-1","source":{"itemType":"site","scope":"myscope","itemId":"mysite"},"target":{"itemType":"page","scope":"myscope","itemId":"homepage","properties":{"pageInfo":{"pagePath":"/home","pageName":"Home","destinationURL":"https://example.com/home","referringURL":"https://example.com/","language":"en"}}},"persistent":true}'
-# Re-send / update the same event id with new properties
-unomi:crud update event demo-event-1 '{"itemId":"demo-event-1","eventType":"view","scope":"myscope","profileId":"demo-ada","sessionId":"demo-session-1","source":{"itemType":"site","scope":"myscope","itemId":"mysite"},"target":{"itemType":"page","scope":"myscope","itemId":"checkout"},"properties":{"pageInfo":{"pagePath":"/checkout"}},"persistent":true}'
+unomi:crud update event demo-event-1 '{"itemId":"demo-event-1","eventType":"view","scope":"myscope","profileId":"demo-ada","sessionId":"demo-session-1","source":{"itemType":"site","scope":"myscope","itemId":"mysite"},"target":{"itemType":"page","scope":"myscope","itemId":"checkout","properties":{"pageInfo":{"pagePath":"/checkout","pageName":"Checkout","destinationURL":"https://example.com/checkout","referringURL":"https://example.com/home","language":"en"}}},"persistent":true}'
unomi:crud delete event demo-event-1
diff --git a/src/main/webapp/get-started.html b/src/main/webapp/get-started.html
index 4c2ef2b..ede669f 100644
--- a/src/main/webapp/get-started.html
+++ b/src/main/webapp/get-started.html
@@ -32,7 +32,7 @@ structured_data: >
"@type": "HowToStep",
"position": 3,
"name": "Create a tenant",
- "text": "POST /cxs/tenants as karaf/karaf and save the public and private API keys from the response."
+ "text": "POST /cxs/tenants as karaf/karaf, then POST /cxs/tenants/{id}/apikeys?type=PUBLIC and type=PRIVATE and save each plainTextKey."
},
{
"@type": "HowToStep",
@@ -229,7 +229,7 @@ volumes:
<div class="step-number me-3 flex-shrink-0">3</div>
<div class="flex-grow-1">
<h3 class="h6 fw-semibold mb-2">Create a tenant (required in 3.1)</h3>
- <p class="small text-muted">System admin credentials create tenants. Save both API keys from the JSON response.</p>
+ <p class="small text-muted">System admin credentials create tenants. Creation stores hashed keys only (<code>maskedKey</code> in the response) — regenerate each key once and save <code>plainTextKey</code> immediately.</p>
<pre><code>curl -X POST http://localhost:8181/cxs/tenants \
--user karaf:karaf \
-H "Content-Type: application/json" \
@@ -239,10 +239,16 @@ volumes:
"name": "Default Tenant",
"description": "Default tenant for quick start"
}
- }'</code></pre>
+ }'
+
+# One-time plaintext secrets (replaces any existing key of that type)
+curl -X POST 'http://localhost:8181/cxs/tenants/default/apikeys?type=PUBLIC' \
+ --user karaf:karaf
+curl -X POST 'http://localhost:8181/cxs/tenants/default/apikeys?type=PRIVATE' \
+ --user karaf:karaf</code></pre>
<ul class="small text-muted mt-2 mb-0">
- <li><strong>PUBLIC</strong> key — use as <code>X-Unomi-Api-Key</code> on <code>/cxs/context.json</code> and <code>/cxs/eventcollector</code></li>
- <li><strong>PRIVATE</strong> key — basic auth <code>default:<private-key></code> for admin APIs (scopes, rules, schemas, …)</li>
+ <li><strong>PUBLIC</strong> <code>plainTextKey</code> — use as <code>X-Unomi-Api-Key</code> on <code>/cxs/context.json</code> and <code>/cxs/eventcollector</code></li>
+ <li><strong>PRIVATE</strong> <code>plainTextKey</code> — basic auth <code>default:<private-key></code> for admin APIs (scopes, rules, schemas, …)</li>
</ul>
</div>
</div>
@@ -254,6 +260,15 @@ volumes:
<h3 class="h6 fw-semibold mb-2">Verify cluster & request context</h3>
<p class="small text-muted mb-2">Cluster (system admin):</p>
<pre><code>curl -k https://localhost:9443/cxs/cluster -u karaf:karaf</code></pre>
+ <p class="small text-muted mt-3 mb-2">Create a scope before context or events (schema validation rejects unknown scopes):</p>
+ <pre><code>curl -X POST http://localhost:8181/cxs/scopes \
+ -u "default:YOUR_PRIVATE_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "itemId": "default",
+ "itemType": "scope",
+ "metadata": { "id": "default", "name": "Default scope" }
+ }'</code></pre>
<p class="small text-muted mt-3 mb-2">First context request (public API key required):</p>
<pre><code>curl -X POST "http://localhost:8181/cxs/context.json?sessionId=1234" \
-H "Content-Type: application/json" \
diff --git a/src/main/webapp/llms-full.txt b/src/main/webapp/llms-full.txt
index eae4cc2..6b1ae4d 100644
--- a/src/main/webapp/llms-full.txt
+++ b/src/main/webapp/llms-full.txt
@@ -193,7 +193,7 @@ services:
docker compose up
```
-Create a tenant, then call context with the public API key:
+Create a tenant, regenerate API keys for plaintext secrets, create a scope, then call context with the public API key:
```
curl -X POST http://localhost:8181/cxs/tenants \
@@ -201,6 +201,15 @@ curl -X POST http://localhost:8181/cxs/tenants \
-H "Content-Type: application/json" \
-d '{"requestedId":"default","properties":{"name":"Default Tenant"}}'
+curl -X POST 'http://localhost:8181/cxs/tenants/default/apikeys?type=PUBLIC' --user karaf:karaf
+curl -X POST 'http://localhost:8181/cxs/tenants/default/apikeys?type=PRIVATE' --user karaf:karaf
+# Save plainTextKey from each response (tenant create only returns maskedKey)
+
+curl -X POST http://localhost:8181/cxs/scopes \
+ -u 'default:YOUR_PRIVATE_API_KEY' \
+ -H "Content-Type: application/json" \
+ -d '{"itemId":"default","itemType":"scope","metadata":{"id":"default","name":"Default scope"}}'
+
curl -X POST "http://localhost:8181/cxs/context.json?sessionId=1234" \
-H "Content-Type: application/json" \
-H "X-Unomi-Api-Key: YOUR_PUBLIC_API_KEY" \
diff --git a/src/main/webapp/llms.txt b/src/main/webapp/llms.txt
index 3979623..8525ea2 100644
--- a/src/main/webapp/llms.txt
+++ b/src/main/webapp/llms.txt
@@ -69,10 +69,11 @@ The fastest way to try Apache Unomi 3.1 is with Docker Compose (Elasticsearch 9.
docker compose up
```
-Then create a tenant (`POST /cxs/tenants` as `karaf:karaf`) and save the returned API keys:
+Then create a tenant (`POST /cxs/tenants` as `karaf:karaf`), regenerate keys via `POST /cxs/tenants/{id}/apikeys?type=PUBLIC|PRIVATE` (save each `plainTextKey` — create only returns `maskedKey`), and create a scope before context/events:
- **Public key** → header `X-Unomi-Api-Key` for `/cxs/context.json` and `/cxs/eventcollector`
- **Private key** → basic auth `tenantId:privateApiKey` for admin APIs (scopes, rules, schemas, searches)
+- **Scope** → `POST /cxs/scopes` before any context or event that references that scope id
System admin (`karaf:karaf`) is for tenant management and cluster operations, not for public context/event calls in native 3.1 mode.
diff --git a/src/main/webapp/tutorial.html b/src/main/webapp/tutorial.html
index 5219309..ce34cd3 100644
--- a/src/main/webapp/tutorial.html
+++ b/src/main/webapp/tutorial.html
@@ -22,7 +22,7 @@ structured_data: >
"@type": "HowToStep",
"position": 2,
"name": "Create a tenant",
- "text": "POST /cxs/tenants as karaf/karaf and save the public and private API keys."
+ "text": "POST /cxs/tenants as karaf/karaf, then regenerate PUBLIC and PRIVATE keys via /cxs/tenants/{id}/apikeys and save each plainTextKey."
},
{
"@type": "HowToStep",
@@ -145,7 +145,7 @@ services:
<div class="col-lg-10">
<span class="badge badge-primary mb-3">Step 2 · Unomi 3.1</span>
<h2>Create a Tenant</h2>
- <p class="text-muted">In Unomi 3.1, data lives under a <strong>tenant</strong>. Create one with the system admin user, then use the returned API keys for everything else.</p>
+ <p class="text-muted">In Unomi 3.1, data lives under a <strong>tenant</strong>. Create one with the system admin user, then regenerate API keys to obtain the one-time plaintext values.</p>
<pre><code>curl -X POST http://localhost:8181/cxs/tenants \
--user karaf:karaf \
-H "Content-Type: application/json" \
@@ -155,8 +155,14 @@ services:
"name": "Default Tenant",
"description": "Tutorial tenant"
}
- }'</code></pre>
- <p class="small text-muted mt-3">From the response, copy:</p>
+ }'
+
+# Tenant create only returns maskedKey. Regenerate to get plainTextKey (shown once):
+curl -X POST 'http://localhost:8181/cxs/tenants/default/apikeys?type=PUBLIC' \
+ --user karaf:karaf
+curl -X POST 'http://localhost:8181/cxs/tenants/default/apikeys?type=PRIVATE' \
+ --user karaf:karaf</code></pre>
+ <p class="small text-muted mt-3">From each apikeys response, copy <code>plainTextKey</code>:</p>
<ul class="small">
<li><code>YOUR_PUBLIC_API_KEY</code> — header <code>X-Unomi-Api-Key</code> for <code>/cxs/context.json</code> and <code>/cxs/eventcollector</code></li>
<li><code>YOUR_PRIVATE_API_KEY</code> — basic auth <code>default:YOUR_PRIVATE_API_KEY</code> for scopes, rules, schemas, searches</li>
@@ -200,7 +206,7 @@ karaf@root()> unomi:start</code></pre>
<p>Create a tenant as in <a href="#create-tenant">Step 2</a>, then call context with <code>X-Unomi-Api-Key</code>. Cluster check: <code>https://localhost:9443/cxs/cluster</code> (<code>karaf</code>/<code>karaf</code>).</p>
<div class="alert alert-info small" role="alert">
- <i class="bi bi-terminal me-1"></i> <strong>Tip:</strong> SSH console <code>ssh -p 8102 karaf@localhost</code> — <code>profile-list</code>, <code>event-tail</code>, <code>rule-list</code>. Full detail: <a href="https://unomi.apache.org/manual/latest/index.html#_quick_start">manual quick start</a>.
+ <i class="bi bi-terminal me-1"></i> <strong>Tip:</strong> SSH console <code>ssh -p 8102 karaf@localhost</code> — <code>unomi:crud list profile</code>, <code>unomi:event-tail</code>, <code>unomi:crud list rule</code>. Full detail: <a href="/blog/unomi-3-shell-commands.html">shell commands post</a> · <a href="https://unomi.apache.org/manual/latest/index.html#_quick_start">manual quick start</a>.
</div>
</div>
</div>
@@ -220,6 +226,22 @@ karaf@root()> unomi:start</code></pre>
<h2>Your First API Calls</h2>
<p class="text-muted">With Unomi 3.1 running and a tenant created, explore the REST API. Replace <code>YOUR_PUBLIC_API_KEY</code> / <code>YOUR_PRIVATE_API_KEY</code> with values from <a href="#create-tenant">Step 2</a>.</p>
+ <!-- Create a scope first -->
+ <h3 class="h6 fw-semibold mt-4 mb-3">Create a scope</h3>
+ <p>Context requests and events must use a <strong>scope</strong> that already exists for the tenant.
+ Schema validation rejects unknown scopes (<code>Unknown scope value</code> in the logs):</p>
+<pre><code>curl -X POST http://localhost:8181/cxs/scopes \
+ -u "default:YOUR_PRIVATE_API_KEY" \
+ -H "Content-Type: application/json" \
+ --data-raw '{
+ "itemId": "my-website",
+ "itemType": "scope",
+ "metadata": {
+ "id": "my-website",
+ "name": "My Website Scope"
+ }
+ }'</code></pre>
+
<!-- Read context -->
<h3 class="h6 fw-semibold mt-4 mb-3">Read the current context</h3>
<p>The <code>/cxs/context.json</code> endpoint is the primary public endpoint. In 3.1 it requires a <strong>public API key</strong>:</p>
@@ -230,7 +252,7 @@ karaf@root()> unomi:start</code></pre>
"source": {
"itemId": "homepage",
"itemType": "page",
- "scope": "default"
+ "scope": "my-website"
},
"requiredProfileProperties": ["*"],
"requiredSessionProperties": ["*"],
@@ -238,21 +260,6 @@ karaf@root()> unomi:start</code></pre>
"requireScores": true
}'</code></pre>
- <!-- Create a scope -->
- <h3 class="h6 fw-semibold mt-4 mb-3">Create a scope</h3>
- <p>Events in Unomi must be associated with a <strong>scope</strong>. Create one before sending events:</p>
-<pre><code>curl -X POST http://localhost:8181/cxs/scopes \
- -u "default:YOUR_PRIVATE_API_KEY" \
- -H "Content-Type: application/json" \
- --data-raw '{
- "itemId": "my-website",
- "itemType": "scope",
- "metadata": {
- "id": "my-website",
- "name": "My Website Scope"
- }
- }'</code></pre>
-
<!-- Send a custom event -->
<h3 class="h6 fw-semibold mt-4 mb-3">Send a custom event</h3>
<p>Before sending a custom event, register a <strong>JSON Schema</strong> to validate it (required since Unomi 2.0):</p>
@@ -341,7 +348,7 @@ karaf@root()> unomi:start</code></pre>
-u "default:YOUR_PRIVATE_API_KEY"</code></pre>
<div class="alert alert-info small" role="alert">
- <i class="bi bi-terminal me-1"></i> <strong>SSH Console shortcuts:</strong> <code>event-tail</code> watches events in real time, <code>event-list</code> shows recent events, <code>profile-list</code> lists recently modified profiles, <code>profile-view PROFILE_UUID</code> shows profile details.
+ <i class="bi bi-terminal me-1"></i> <strong>SSH Console shortcuts:</strong> <code>unomi:event-tail</code> watches events in real time, <code>unomi:crud list event</code> / <code>unomi:crud list profile</code> list recent items, <code>unomi:crud read profile PROFILE_UUID</code> shows profile details.
</div>
</div>
</div>
@@ -383,6 +390,7 @@ karaf@root()> unomi:start</code></pre>
"pageName": document.title,
"pagePath": document.location.pathname,
"destinationURL": document.location.origin + document.location.pathname,
+ "referringURL": document.referrer || document.location.origin + "/",
"language": "en",
"categories": [],
"tags": []
@@ -489,7 +497,7 @@ const unomiWebTracker = useTracker();
}
}]
}'</code></pre>
- <p class="small text-muted">After creating this rule, reload your tracked page a few times, then check the profile with <code>profile-view PROFILE_UUID</code> in the SSH console to see the counter increase.</p>
+ <p class="small text-muted">After creating this rule, reload your tracked page a few times, then check the profile with <code>unomi:crud read profile PROFILE_UUID</code> in the SSH console to see the counter increase.</p>
<!-- Copy event properties to profile -->
<h3 class="h6 fw-semibold mt-4 mb-3">Map event data to a profile</h3>
@@ -667,7 +675,7 @@ karaf@root()> log:set DEBUG org.apache.unomi.schema.impl.SchemaServiceImpl
# Watch logs in real-time
karaf@root()> log:tail</code></pre>
- <p class="small text-muted mb-0">Useful commands: <code>event-tail</code>, <code>event-list</code>, <code>rule-list</code>, <code>rule-tail</code>, <code>profile-list</code>, <code>profile-view <ID></code></p>
+ <p class="small text-muted mb-0">Useful commands: <code>unomi:event-tail</code>, <code>unomi:rule-tail</code>, <code>unomi:crud list event|rule|profile</code>, <code>unomi:crud read profile <ID></code></p>
</div>
</div>
</div>
(unomi-site) 05/05: feat: add Unomi 3 in numbers blog, CDN/Matomo charts, and Netlify preview (UNOMI-932)
Posted by sh...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
sergehuber pushed a commit to branch UNOMI-932-unomi3-major-release-story
in repository https://gitbox.apache.org/repos/asf/unomi-site.git
commit fb5eba30d32a101f48b05717f430ecf9ae50cdc1
Author: Serge Huber <sh...@apache.org>
AuthorDate: Fri Jul 17 14:11:43 2026 +0200
feat: add Unomi 3 in numbers blog, CDN/Matomo charts, and Netlify preview (UNOMI-932)
Add metrics post with download/visit charts, blog publish dates and archive,
plus preview.sh for personal Netlify staging with prerequisite checks.
---
.gitignore | 1 +
README.md | 107 +++++++
netlify.toml | 13 +
preview.sh | 306 +++++++++++++++++++++
.../assets/images/unomi3/numbers-contributors.svg | 76 +++++
.../assets/images/unomi3/numbers-downloads-map.svg | 75 +++++
.../assets/images/unomi3/numbers-downloads.svg | 53 ++++
.../webapp/assets/images/unomi3/numbers-hero.svg | 74 +++++
.../webapp/assets/images/unomi3/numbers-loc.svg | 78 ++++++
.../webapp/assets/images/unomi3/numbers-tests.svg | 83 ++++++
.../images/unomi3/numbers-visits-countries.svg | 60 ++++
.../webapp/assets/images/unomi3/numbers-visits.svg | 31 +++
src/main/webapp/blog/index.html | 214 +++++++++++++-
.../webapp/blog/introducing-apache-unomi-3.html | 7 +
src/main/webapp/blog/migrating-to-unomi-3.html | 7 +
src/main/webapp/blog/unomi-3-ai-agents.html | 7 +
src/main/webapp/blog/unomi-3-build-sh.html | 7 +
src/main/webapp/blog/unomi-3-in-numbers.html | 139 ++++++++++
src/main/webapp/blog/unomi-3-it-execution.html | 7 +
src/main/webapp/blog/unomi-3-manual.html | 7 +
src/main/webapp/blog/unomi-3-multitenancy.html | 7 +
.../webapp/blog/unomi-3-openapi-enrichment.html | 7 +
src/main/webapp/blog/unomi-3-opensearch.html | 7 +
.../webapp/blog/unomi-3-platform-foundation.html | 7 +
src/main/webapp/blog/unomi-3-request-tracing.html | 7 +
src/main/webapp/blog/unomi-3-shell-commands.html | 7 +
src/main/webapp/blog/unomi-3-task-scheduler.html | 7 +
.../webapp/blog/unomi-3-unit-testing-harness.html | 7 +
.../blog/welcome-to-the-apache-unomi-blog.html | 7 +
src/main/webapp/sitemap.xml | 5 +
30 files changed, 1419 insertions(+), 1 deletion(-)
diff --git a/.gitignore b/.gitignore
index ec2086a..60e1e40 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,4 @@ target/
/.mvn/wrapper/maven-wrapper.jar
Gemfile.lock
.bundle/
+.netlify/
diff --git a/README.md b/README.md
index 3b173b4..7d95ee7 100644
--- a/README.md
+++ b/README.md
@@ -68,11 +68,118 @@ Or serve locally with live-reload:
bundle exec jekyll serve
```
+## Staging preview (Netlify)
+
+`./preview.sh` builds the site with Docker Jekyll and can publish a **personal/community** staging URL on Netlify (same approach as the UNOMI-932 preview at `https://unomi-v3-site.netlify.app/`).
+
+This is **not** how `https://unomi.apache.org/` is published. Production still uses Maven scm-publish (see [Publish](#publish) below). Do not commit Netlify tokens or `.netlify/` state into git.
+
+### Prerequisites
+
+| Requirement | Needed for | Notes |
+|---|---|---|
+| [Docker](https://docs.docker.com/get-docker/) + running daemon | All modes | Pulls `bretfisher/jekyll` / `bretfisher/jekyll-serve` |
+| [Node.js](https://nodejs.org/) (includes `npx`) **or** [Netlify CLI](https://docs.netlify.com/cli/get-started/) | Netlify deploy (`./preview.sh`, `--prod`) | Script uses `netlify` if installed, otherwise `npx netlify-cli` |
+| Netlify account | Netlify deploy | Free personal account is enough |
+| Network access | Image pull + Netlify API | First build downloads the Jekyll image |
+
+Optional:
+
+- `curl` — used in prerequisite checks for Netlify reachability
+- `open` (macOS) — used with `--open` to launch the preview URL
+- `lsof` — warns if port 4000 is already taken for `--local`
+
+Verify tooling before building:
+
+```shell
+./preview.sh --check-only
+```
+
+### Credentials and configuration
+
+**Auth (pick one):**
+
+1. **Interactive login** (simplest):
+
+ ```shell
+ npx netlify-cli login
+ # or: netlify login
+ ```
+
+ Opens a browser and stores credentials in your user Netlify CLI config (`~/.netlify` / `~/.config/netlify`).
+
+2. **Personal access token** (CI / non-interactive):
+
+ Create a token in the Netlify UI: **User settings → Applications → Personal access tokens**, then:
+
+ ```shell
+ export NETLIFY_AUTH_TOKEN=your_token_here
+ ```
+
+**Site linking (pick one):**
+
+| Variable / file | Purpose |
+|---|---|
+| (default) | Script creates/links a site named `unomi-v3-site` on first deploy |
+| `NETLIFY_SITE_NAME` | Override the Netlify site name (default: `unomi-v3-site`) |
+| `NETLIFY_SITE_ID` | Use an existing site id and skip interactive link |
+| `.netlify/state.json` | Created after a successful link; reused on later runs (gitignored) |
+
+Example:
+
+```shell
+export NETLIFY_AUTH_TOKEN=... # optional if already logged in
+export NETLIFY_SITE_NAME=unomi-v3-site # optional
+export NETLIFY_SITE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # optional
+```
+
+Other optional env vars:
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `JEKYLL_IMAGE` | `bretfisher/jekyll` | Docker image used to build |
+| `JEKYLL_SERVE_IMAGE` | `bretfisher/jekyll-serve` | Docker image used for `--local` |
+
+`netlify.toml` in this repo sets `publish = "target/site"`. The script builds locally first; Netlify only hosts the static output.
+
+### Usage
+
+From the repository root:
+
+```shell
+chmod +x ./preview.sh # once
+
+./preview.sh --check-only # validate Docker, layout, Netlify tooling/auth hints
+./preview.sh # build + Netlify *draft* deploy (unique preview URL)
+./preview.sh --prod # build + deploy to the linked site’s production URL
+./preview.sh --local # build + serve at http://localhost:4000 (no Netlify)
+./preview.sh --build-only # build only → target/site
+./preview.sh --open # after a Netlify deploy, open the URL (macOS)
+```
+
+Flags can be combined where it makes sense, e.g. `./preview.sh --prod --open`.
+
+Typical first-time flow:
+
+1. Start Docker Desktop (or your Docker daemon).
+2. `./preview.sh --check-only` and fix any `[FAIL]` lines.
+3. `./preview.sh` — complete Netlify login / site link if prompted.
+4. Share the printed `https://….netlify.app/` URL for review.
+5. Later deploys to the same linked site: `./preview.sh --prod`.
+
+### What the script does
+
+1. Runs prerequisite checks (`[ok]` / `[warn]` / `[FAIL]`).
+2. Builds with Docker Jekyll into `target/site`.
+3. For Netlify modes: authenticates, links/creates the site if needed, deploys `target/site`, prints the preview URL.
+
## Publish
To publish the local website to the production location (https://unomi.apache.org/), you have to use:
Do not use the `clean` maven goal to not remove the previous generated site.
+Credentials: your **ASF LDAP username and password** (not Netlify).
+
```shell
mvn install scm-publish:publish-scm -Dusername=YOUR_APACHE_USERNAME -Dpassword=YOUR_APACHE_PASSWORD
```
diff --git a/netlify.toml b/netlify.toml
new file mode 100644
index 0000000..5e35b2e
--- /dev/null
+++ b/netlify.toml
@@ -0,0 +1,13 @@
+# Personal/community staging only (see preview.sh).
+# Production for unomi.apache.org is Maven scm-publish, not Netlify.
+
+[build]
+ publish = "target/site"
+ # Built by preview.sh (Docker Jekyll) before deploy — do not rely on Netlify CI.
+ command = "echo 'Build with ./preview.sh locally; Netlify only hosts the static output.'"
+
+[[headers]]
+ for = "/*"
+ [headers.values]
+ X-Frame-Options = "SAMEORIGIN"
+ X-Content-Type-Options = "nosniff"
diff --git a/preview.sh b/preview.sh
new file mode 100755
index 0000000..f74eda0
--- /dev/null
+++ b/preview.sh
@@ -0,0 +1,306 @@
+#!/usr/bin/env bash
+# Build the Apache Unomi website and publish a Netlify staging preview.
+#
+# This mirrors the earlier UNOMI-932 staging flow (unomi-v3-site.netlify.app).
+# It is for personal/community review only — production remains:
+# mvn install scm-publish:publish-scm ...
+#
+# Usage:
+# ./preview.sh # Docker build + Netlify draft deploy (unique URL)
+# ./preview.sh --prod # Docker build + deploy to the linked site URL
+# ./preview.sh --local # Docker build + serve at http://localhost:4000
+# ./preview.sh --build-only # Docker build only (output: target/site)
+# ./preview.sh --check-only # Prerequisite checks only (no build/deploy)
+# ./preview.sh --open # After deploy, open the preview URL (macOS)
+#
+# Optional environment:
+# NETLIFY_AUTH_TOKEN Personal access token (or run: npx netlify-cli login)
+# NETLIFY_SITE_ID Existing site id (skips interactive link)
+# NETLIFY_SITE_NAME Site name when creating/linking (default: unomi-v3-site)
+# JEKYLL_IMAGE Docker image (default: bretfisher/jekyll)
+# JEKYLL_SERVE_IMAGE Serve image (default: bretfisher/jekyll-serve)
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$ROOT"
+
+MODE="draft" # draft | prod | local | build-only | check-only
+OPEN_URL=0
+JEKYLL_IMAGE="${JEKYLL_IMAGE:-bretfisher/jekyll}"
+JEKYLL_SERVE_IMAGE="${JEKYLL_SERVE_IMAGE:-bretfisher/jekyll-serve}"
+NETLIFY_SITE_NAME="${NETLIFY_SITE_NAME:-unomi-v3-site}"
+SITE_DIR="target/site"
+
+usage() {
+ sed -n '2,23p' "$0" | sed 's/^# \{0,1\}//'
+ exit "${1:-0}"
+}
+
+while [[ $# -gt 0 ]]; do
+ case "$1" in
+ --prod) MODE="prod"; shift ;;
+ --local) MODE="local"; shift ;;
+ --build-only) MODE="build-only"; shift ;;
+ --check-only) MODE="check-only"; shift ;;
+ --open) OPEN_URL=1; shift ;;
+ -h|--help) usage 0 ;;
+ *)
+ echo "Unknown option: $1" >&2
+ usage 1
+ ;;
+ esac
+done
+
+need_cmd() {
+ if ! command -v "$1" >/dev/null 2>&1; then
+ echo "Missing required command: $1" >&2
+ return 1
+ fi
+ return 0
+}
+
+have_cmd() {
+ command -v "$1" >/dev/null 2>&1
+}
+
+check_pass() { echo " [ok] $1"; }
+check_fail() { echo " [FAIL] $1" >&2; CHECKS_FAILED=1; }
+check_warn() { echo " [warn] $1" >&2; }
+
+CHECKS_FAILED=0
+
+check_prerequisites() {
+ echo "==> Prerequisite checks (mode: ${MODE})"
+ CHECKS_FAILED=0
+
+ # --- Project layout ---
+ if [[ -f "${ROOT}/_config.yml" ]]; then
+ check_pass "_config.yml present"
+ else
+ check_fail "_config.yml missing — run from the unomi-site repo root"
+ fi
+
+ if [[ -d "${ROOT}/src/main/webapp" ]]; then
+ check_pass "src/main/webapp present"
+ else
+ check_fail "src/main/webapp missing — unexpected project layout"
+ fi
+
+ if [[ -f "${ROOT}/netlify.toml" ]]; then
+ check_pass "netlify.toml present"
+ else
+ check_warn "netlify.toml missing (deploy still works with --dir=${SITE_DIR})"
+ fi
+
+ # --- Docker (required for all modes that build) ---
+ if have_cmd docker; then
+ check_pass "docker found ($(command -v docker))"
+ if docker info >/dev/null 2>&1; then
+ check_pass "Docker daemon is running"
+ else
+ check_fail "Docker daemon is not running — start Docker Desktop / dockerd"
+ fi
+ else
+ check_fail "docker not found — install Docker (required to build with ${JEKYLL_IMAGE})"
+ fi
+
+ # Writable output dir
+ if mkdir -p "${ROOT}/target" 2>/dev/null && [[ -w "${ROOT}/target" ]]; then
+ check_pass "target/ is writable"
+ else
+ check_fail "cannot create/write ${ROOT}/target"
+ fi
+
+ # --- Mode-specific ---
+ case "${MODE}" in
+ draft|prod|check-only)
+ if have_cmd netlify; then
+ check_pass "netlify CLI found ($(netlify --version 2>/dev/null | head -1 || echo ok))"
+ elif have_cmd npx; then
+ check_pass "npx found (will use: npx netlify-cli)"
+ if have_cmd node; then
+ check_pass "node found ($(node --version 2>/dev/null))"
+ else
+ check_warn "node not found — npx may still work depending on your Node install"
+ fi
+ else
+ check_fail "neither 'netlify' nor 'npx' found — install Netlify CLI or Node.js (npx)"
+ fi
+
+ if [[ -n "${NETLIFY_AUTH_TOKEN:-}" ]]; then
+ check_pass "NETLIFY_AUTH_TOKEN is set"
+ elif [[ -f "${HOME}/.netlify/config.json" ]] || [[ -d "${HOME}/.config/netlify" ]]; then
+ check_pass "Netlify CLI config present (will verify auth at deploy time)"
+ else
+ check_warn "no NETLIFY_AUTH_TOKEN / Netlify config yet — script will run 'netlify login' if needed"
+ fi
+
+ if [[ -n "${NETLIFY_SITE_ID:-}" ]]; then
+ check_pass "NETLIFY_SITE_ID is set"
+ elif [[ -f "${ROOT}/.netlify/state.json" ]]; then
+ check_pass "site already linked (.netlify/state.json)"
+ else
+ check_warn "site not linked yet — will create/link '${NETLIFY_SITE_NAME}'"
+ fi
+
+ if have_cmd curl; then
+ if curl -fsS --connect-timeout 5 -o /dev/null https://api.netlify.com/api/v1/ 2>/dev/null \
+ || curl -fsS --connect-timeout 5 -o /dev/null https://www.netlify.com/ 2>/dev/null; then
+ check_pass "network reachability to Netlify"
+ else
+ check_warn "could not reach Netlify APIs — deploy may fail offline"
+ fi
+ fi
+ ;;
+ local)
+ if have_cmd lsof && lsof -iTCP:4000 -sTCP:LISTEN >/dev/null 2>&1; then
+ check_warn "port 4000 is already in use — jekyll-serve may fail to bind"
+ else
+ check_pass "port 4000 appears free"
+ fi
+ ;;
+ build-only)
+ ;;
+ esac
+
+ if [[ "${OPEN_URL}" -eq 1 ]]; then
+ if have_cmd open; then
+ check_pass "open found (will open preview URL)"
+ else
+ check_warn "'open' not found — --open will be ignored"
+ fi
+ fi
+
+ if [[ "${CHECKS_FAILED}" -ne 0 ]]; then
+ echo "" >&2
+ echo "Prerequisite checks failed. Fix the items marked [FAIL] and re-run." >&2
+ exit 1
+ fi
+ echo "==> Prerequisites OK"
+ echo ""
+}
+
+build_site() {
+ echo "==> Building site with Docker (${JEKYLL_IMAGE})"
+ mkdir -p target
+ docker run --rm \
+ --volume="${ROOT}:/site" \
+ -w /site \
+ "${JEKYLL_IMAGE}" \
+ build
+
+ if [[ ! -d "${SITE_DIR}" ]] || [[ -z "$(ls -A "${SITE_DIR}" 2>/dev/null || true)" ]]; then
+ echo "Build failed: ${SITE_DIR} is missing or empty" >&2
+ exit 1
+ fi
+ echo "==> Build OK → ${SITE_DIR}"
+}
+
+netlify_cli() {
+ if have_cmd netlify; then
+ netlify "$@"
+ else
+ npx --yes netlify-cli "$@"
+ fi
+}
+
+ensure_netlify_auth() {
+ if [[ -n "${NETLIFY_AUTH_TOKEN:-}" ]]; then
+ return 0
+ fi
+ if netlify_cli status >/dev/null 2>&1; then
+ return 0
+ fi
+ echo "==> Netlify auth required (browser login)"
+ netlify_cli login
+}
+
+link_or_create_site() {
+ if [[ -n "${NETLIFY_SITE_ID:-}" ]]; then
+ echo "==> Using NETLIFY_SITE_ID=${NETLIFY_SITE_ID}"
+ return 0
+ fi
+ if [[ -f .netlify/state.json ]]; then
+ echo "==> Using existing Netlify link (.netlify/state.json)"
+ return 0
+ fi
+
+ echo "==> Linking/creating Netlify site '${NETLIFY_SITE_NAME}'"
+ if netlify_cli sites:list --json 2>/dev/null | grep -q "\"name\":\"${NETLIFY_SITE_NAME}\""; then
+ netlify_cli link --name "${NETLIFY_SITE_NAME}"
+ else
+ netlify_cli sites:create --name "${NETLIFY_SITE_NAME}" --disable-linking || true
+ netlify_cli link --name "${NETLIFY_SITE_NAME}" || netlify_cli init
+ fi
+}
+
+deploy_netlify() {
+ ensure_netlify_auth
+ link_or_create_site
+
+ local args=(deploy --dir="${SITE_DIR}" --message "unomi-site preview $(date -u +%Y-%m-%dT%H:%MZ)")
+ if [[ "${MODE}" == "prod" ]]; then
+ args+=(--prod)
+ echo "==> Deploying to Netlify production URL for linked site"
+ else
+ echo "==> Deploying Netlify draft preview (unique URL)"
+ fi
+
+ local log
+ log="$(mktemp)"
+ if ! netlify_cli "${args[@]}" 2>&1 | tee "${log}"; then
+ echo "Netlify deploy failed" >&2
+ rm -f "${log}"
+ exit 1
+ fi
+
+ local url
+ url="$(grep -Eo 'https://[^ ]+\.netlify\.app/?[^ ]*' "${log}" | tail -1 || true)"
+ rm -f "${log}"
+
+ if [[ -n "${url}" ]]; then
+ echo ""
+ echo "==> Preview URL: ${url}"
+ if [[ "${OPEN_URL}" -eq 1 ]] && command -v open >/dev/null 2>&1; then
+ open "${url}"
+ fi
+ else
+ echo "==> Deploy finished (check netlify output above for the URL)"
+ fi
+}
+
+serve_local() {
+ echo "==> Serving with Docker (${JEKYLL_SERVE_IMAGE}) at http://localhost:4000/"
+ echo " Ctrl+C to stop"
+ docker run --rm \
+ --volume="${ROOT}:/site" \
+ -p 4000:4000 \
+ -w /site \
+ "${JEKYLL_SERVE_IMAGE}"
+}
+
+check_prerequisites
+
+if [[ "${MODE}" == "check-only" ]]; then
+ echo "==> Done (check only)"
+ exit 0
+fi
+
+build_site
+
+case "${MODE}" in
+ build-only)
+ echo "==> Done (build only)"
+ ;;
+ local)
+ serve_local
+ ;;
+ draft|prod)
+ deploy_netlify
+ ;;
+ *)
+ echo "Internal error: unknown mode ${MODE}" >&2
+ exit 1
+ ;;
+esac
diff --git a/src/main/webapp/assets/images/unomi3/numbers-contributors.svg b/src/main/webapp/assets/images/unomi3/numbers-contributors.svg
new file mode 100644
index 0000000..d65d94d
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-contributors.svg
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Line chart of cumulative unique contributors from Unomi 1 through 3.1">
+ <defs>
+ <style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-accent-dark: #0d9488;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes grow-bar { from { transform: scaleY(0); } to { transform: scaleY(1); } }
+ @keyframes fade-up { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+ @keyframes dash-flow { to { stroke-dashoffset: -20; } }
+ @keyframes pulse-dot { 0%,100%{opacity:.7;r:5} 50%{opacity:1;r:7} }
+ .bar { transform-box: fill-box; transform-origin: bottom; animation: grow-bar 0.9s ease-out both; }
+ .fade { animation: fade-up 0.7s ease-out both; }
+ .flow { stroke-dasharray: 5 4; animation: dash-flow 1.8s linear infinite; }
+ .dot { animation: pulse-dot 2.4s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .bar,.fade,.flow,.dot { animation: none !important; }
+ }
+</style>
+ <linearGradient id="areaFill" x1="0" y1="100" x2="0" y2="300" gradientUnits="userSpaceOnUse">
+ <stop stop-color="#6d5ce7" stop-opacity="0.35"/>
+ <stop offset="1" stop-color="#6d5ce7" stop-opacity="0.02"/>
+ </linearGradient>
+ </defs>
+ <rect width="840" height="400" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text class="fade" x="40" y="36" fill="var(--unomi-text)" font-size="18" font-weight="700">Cumulative contributors</text>
+ <text class="fade" style="animation-delay:.08s" x="40" y="58" fill="var(--unomi-text-muted)" font-size="12">Unique git authors through each release tag (name-based; aliases not merged)</text>
+ <line x1="80" y1="300" x2="760" y2="300" stroke="var(--unomi-border)" stroke-width="1.5"/>
+ <polygon class="fade" style="animation-delay:.15s" points="120,300 120,220.0 300,153.3 480,140.0 660,120.0 660,300" fill="url(#areaFill)"/>
+ <polyline class="fade flow" style="animation-delay:.2s" points="120,220.0 300,153.3 480,140.0 660,120.0" fill="none" stroke="var(--unomi-primary)" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+
+ <g class="fade" style="animation-delay:0.20s">
+ <circle class="dot" style="animation-delay:0.0s" cx="120" cy="220.0" r="6" fill="var(--unomi-primary)"/>
+ <text x="120" y="204.0" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="16" font-weight="800">62</text>
+ <text x="120" y="328" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 1</text>
+ <text x="120" y="346" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">2,255 commits</text>
+ </g>
+ <g class="fade" style="animation-delay:0.32s">
+ <circle class="dot" style="animation-delay:0.3s" cx="300" cy="153.3" r="6" fill="var(--unomi-primary)"/>
+ <text x="300" y="137.3" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="16" font-weight="800">72</text>
+ <text x="300" y="328" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 2</text>
+ <text x="300" y="346" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">2,657 commits</text>
+ </g>
+ <g class="fade" style="animation-delay:0.44s">
+ <circle class="dot" style="animation-delay:0.6s" cx="480" cy="140.0" r="6" fill="var(--unomi-primary)"/>
+ <text x="480" y="124.0" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="16" font-weight="800">74</text>
+ <text x="480" y="328" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 3.0</text>
+ <text x="480" y="346" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">2,682 commits</text>
+ </g>
+ <g class="fade" style="animation-delay:0.56s">
+ <circle class="dot" style="animation-delay:0.9s" cx="660" cy="120.0" r="6" fill="var(--unomi-primary)"/>
+ <text x="660" y="104.0" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="16" font-weight="800">77</text>
+ <text x="660" y="328" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 3.1</text>
+ <text x="660" y="346" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">2,769 commits</text>
+ </g>
+ <text class="fade" style="animation-delay:.8s" x="40" y="375" fill="var(--unomi-text-muted)" font-size="12">Steady community growth across a decade - 77 authors and 2,769 commits on master ancestry.</text>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/numbers-downloads-map.svg b/src/main/webapp/assets/images/unomi3/numbers-downloads-map.svg
new file mode 100644
index 0000000..497224b
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-downloads-map.svg
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 960 560" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="World map of human Unomi software package downloads by country, bots excluded">
+ <defs>
+ <style>
+ svg {
+ --unomi-primary: #6d5ce7; --unomi-text: #1e293b; --unomi-text-muted: #64748b;
+ --unomi-bg-soft: #f8fafc; font-family: Inter, system-ui, sans-serif;
+ }
+ path:hover { stroke: #6d5ce7; stroke-width: 1.2; }
+ @keyframes fade-up { from { opacity: 0; } to { opacity: 1; } }
+ .fade { animation: fade-up 0.7s ease-out both; }
+ @media (prefers-reduced-motion: reduce) { .fade { animation: none !important; } }
+</style>
+ <linearGradient id="dlScale" x1="0" y1="0" x2="1" y2="0"><stop offset="0.0" stop-color="#e2e8f0"/><stop offset="0.25" stop-color="#8878ee"/><stop offset="0.5" stop-color="#6453da"/><stop offset="0.75" stop-color="#5443bf"/><stop offset="1.0" stop-color="#3b2d8f"/></linearGradient>
+ </defs>
+ <rect width="960" height="560" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text class="fade" x="28" y="34" fill="var(--unomi-text)" font-size="18" font-weight="700">Downloads by country (bots excluded)</text>
+ <text class="fade" style="animation-delay:.08s" x="28" y="54" fill="var(--unomi-text-muted)" font-size="12">Human browser share of software packages - ASF CDN geo - Jul 2023 to Jul 2026</text>
+ <g class="fade" style="animation-delay:.15s"><path d="M740.0,305.7L740.0,306.8L738.7,307.3L737.5,307.8L737.2,307.0L738.2,306.5L738.8,306.4L740.0,305.7Z M736.3,308.9L736.7,308.5L737.4,309.2L737.1,310.3L735.9,310.6L734.8,310.4L734.6,309.4L735.3,308.6L736.3,308.9Z M20.4,305.6L20.2,306.7L20.0,306.8L20.0,305.7L20.4,305.6Z" fill="#e2e8f0" stroke="#ffffff" stroke-width="0.6" data-cc="FJ"><title>Fiji</title></path><path d="M447.8,272.1L448.1,272.4L455.4,276.9L455.5,278.2L458.4,280.4L457.5,283. [...]
+ <text x="750" y="62" fill="var(--unomi-text)" font-size="13" font-weight="700">Top countries</text>
+
+ <text x="750" y="108" fill="var(--unomi-text-muted)" font-size="11">01</text>
+ <text x="772" y="108" fill="var(--unomi-text)" font-size="12" font-weight="600">Brazil</text>
+ <text x="944" y="108" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">3,627</text>
+ <rect x="772" y="113" width="120" height="4" rx="2" fill="#3b2d8f"/>
+ <text x="750" y="136" fill="var(--unomi-text-muted)" font-size="11">02</text>
+ <text x="772" y="136" fill="var(--unomi-text)" font-size="12" font-weight="600">China</text>
+ <text x="944" y="136" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">2,816</text>
+ <rect x="772" y="141" width="116" height="4" rx="2" fill="#3e2f94"/>
+ <text x="750" y="164" fill="var(--unomi-text-muted)" font-size="11">03</text>
+ <text x="772" y="164" fill="var(--unomi-text)" font-size="12" font-weight="600">Russia</text>
+ <text x="944" y="164" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">2,583</text>
+ <rect x="772" y="169" width="115" height="4" rx="2" fill="#3f3097"/>
+ <text x="750" y="192" fill="var(--unomi-text-muted)" font-size="11">04</text>
+ <text x="772" y="192" fill="var(--unomi-text)" font-size="12" font-weight="600">United States</text>
+ <text x="944" y="192" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">1,771</text>
+ <rect x="772" y="197" width="109" height="4" rx="2" fill="#44349f"/>
+ <text x="750" y="220" fill="var(--unomi-text-muted)" font-size="11">05</text>
+ <text x="772" y="220" fill="var(--unomi-text)" font-size="12" font-weight="600">Germany</text>
+ <text x="944" y="220" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">1,258</text>
+ <rect x="772" y="225" width="104" height="4" rx="2" fill="#4838a7"/>
+ <text x="750" y="248" fill="var(--unomi-text-muted)" font-size="11">06</text>
+ <text x="772" y="248" fill="var(--unomi-text)" font-size="12" font-weight="600">Netherlands</text>
+ <text x="944" y="248" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">912</text>
+ <rect x="772" y="253" width="99" height="4" rx="2" fill="#4c3caf"/>
+ <text x="750" y="276" fill="var(--unomi-text-muted)" font-size="11">07</text>
+ <text x="772" y="276" fill="var(--unomi-text)" font-size="12" font-weight="600">India</text>
+ <text x="944" y="276" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">280</text>
+ <rect x="772" y="281" width="82" height="4" rx="2" fill="#5a48ca"/>
+ <text x="750" y="304" fill="var(--unomi-text-muted)" font-size="11">08</text>
+ <text x="772" y="304" fill="var(--unomi-text)" font-size="12" font-weight="600">Austria</text>
+ <text x="944" y="304" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">246</text>
+ <rect x="772" y="309" width="80" height="4" rx="2" fill="#5b49cb"/>
+ <text x="750" y="332" fill="var(--unomi-text-muted)" font-size="11">09</text>
+ <text x="772" y="332" fill="var(--unomi-text)" font-size="12" font-weight="600">Singapore</text>
+ <text x="944" y="332" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">218</text>
+ <rect x="772" y="337" width="78" height="4" rx="2" fill="#5c4acc"/>
+ <text x="750" y="360" fill="var(--unomi-text-muted)" font-size="11">10</text>
+ <text x="772" y="360" fill="var(--unomi-text)" font-size="12" font-weight="600">France</text>
+ <text x="944" y="360" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">188</text>
+ <rect x="772" y="365" width="76" height="4" rx="2" fill="#5d4bce"/>
+ <text x="750" y="388" fill="var(--unomi-text-muted)" font-size="11">11</text>
+ <text x="772" y="388" fill="var(--unomi-text)" font-size="12" font-weight="600">Italy</text>
+ <text x="944" y="388" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">122</text>
+ <rect x="772" y="393" width="70" height="4" rx="2" fill="#604ed2"/>
+ <text x="750" y="416" fill="var(--unomi-text-muted)" font-size="11">12</text>
+ <text x="772" y="416" fill="var(--unomi-text)" font-size="12" font-weight="600">Spain</text>
+ <text x="944" y="416" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">91</text>
+ <rect x="772" y="421" width="66" height="4" rx="2" fill="#6250d5"/>
+ <rect x="30" y="505" width="220" height="12" rx="3" fill="url(#dlScale)"/>
+ <text x="30" y="499" fill="var(--unomi-text-muted)" font-size="10">Fewer</text>
+ <text x="250" y="499" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">More (log scale)</text>
+ <text x="30" y="533" fill="var(--unomi-text-muted)" font-size="10">Countries scaled by each file's human-browser UA share · ~15,345 attributed</text>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/numbers-downloads.svg b/src/main/webapp/assets/images/unomi3/numbers-downloads.svg
new file mode 100644
index 0000000..457b388
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-downloads.svg
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 460" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Cumulative Unomi software package downloads: human browsers, all packages including bots, and known bots">
+ <defs>
+ <style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-accent: #00cec9;
+ --unomi-accent-dark: #0d9488;
+ --unomi-bot: #8b83b8;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-amber: #d97706;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes fade-up { from { opacity: 0; } to { opacity: 1; } }
+ .fade { animation: fade-up 0.8s ease-out both; }
+ @media (prefers-reduced-motion: reduce) { .fade { animation: none !important; } }
+</style>
+ <linearGradient id="softFill" x1="0" y1="80" x2="0" y2="360" gradientUnits="userSpaceOnUse">
+ <stop stop-color="#6d5ce7" stop-opacity="0.28"/>
+ <stop offset="1" stop-color="#6d5ce7" stop-opacity="0.02"/>
+ </linearGradient>
+ </defs>
+ <rect width="840" height="460" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text class="fade" x="40" y="36" fill="var(--unomi-text)" font-size="18" font-weight="700">Cumulative software-package downloads</text>
+ <text class="fade" style="animation-delay:.08s" x="40" y="58" fill="var(--unomi-text-muted)" font-size="12">Purple = human only · Teal = all package hits · Dotted = known bots - ASF CDN Jul 2023 to Jul 2026</text>
+ <line x1="70" y1="360.0" x2="800" y2="360.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="62" y="364.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">0</text><line x1="70" y1="290.0" x2="800" y2="290.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="62" y="294.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">12k</text><line x1="70" y1="220.0" x2="800" y2="220.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="62" y="224.0" [...]
+
+ <line x1="597.2" y1="80" x2="597.2" y2="360" stroke="var(--unomi-accent-dark)" stroke-width="1.5" stroke-dasharray="4 3"/>
+ <text x="591.2" y="94" text-anchor="end" fill="var(--unomi-accent-dark)" font-size="11" font-weight="700">2.7.0</text>
+ <line x1="637.8" y1="80" x2="637.8" y2="360" stroke="var(--unomi-amber)" stroke-width="1.5" stroke-dasharray="4 3"/>
+ <text x="643.8" y="94" fill="var(--unomi-amber)" font-size="11" font-weight="700">3.0</text>
+ <line x1="698.6" y1="80" x2="698.6" y2="360" stroke="var(--unomi-primary-dark)" stroke-width="1.5" stroke-dasharray="4 3"/>
+ <text x="704.6" y="94" fill="var(--unomi-primary-dark)" font-size="11" font-weight="700">Site refresh</text>
+ <polygon class="fade" style="animation-delay:.15s" points="70.0,360.0 70.0,360.0 90.3,359.2 110.6,358.4 130.8,357.5 151.1,355.9 171.4,354.6 191.7,353.8 211.9,352.6 232.2,351.8 252.5,350.7 272.8,349.4 293.1,348.3 313.3,347.2 333.6,346.0 353.9,344.7 374.2,343.7 394.4,342.5 414.7,340.7 435.0,338.5 455.3,337.0 475.6,335.6 495.8,333.2 516.1,332.0 536.4,316.7 556.7,306.3 576.9,303.3 597.2,287.0 617.5,282.5 637.8,278.9 658.1,276.4 678.3,273.7 698.6,269.7 718.9,267.2 739.2,264.2 759.4,260.2 77 [...]
+ <polyline class="fade" style="animation-delay:.2s" points="70.0,358.0 90.3,349.0 110.6,339.3 130.8,330.0 151.1,320.6 171.4,309.2 191.7,299.0 211.9,289.6 232.2,284.0 252.5,278.5 272.8,270.1 293.1,262.9 313.3,258.3 333.6,251.1 353.9,240.7 374.2,228.2 394.4,223.0 414.7,218.5 435.0,215.1 455.3,213.5 475.6,212.0 495.8,209.3 516.1,208.1 536.4,191.5 556.7,180.4 576.9,176.5 597.2,155.7 617.5,148.3 637.8,141.4 658.1,136.9 678.3,129.8 698.6,124.2 718.9,116.9 739.2,112.7 759.4,108.5 779.7,102.5 8 [...]
+ <polyline class="fade" style="animation-delay:.22s" points="70.0,358.0 90.3,349.9 110.6,341.0 130.8,332.3 151.1,324.0 171.4,314.0 191.7,304.7 211.9,296.6 232.2,291.6 252.5,287.2 272.8,280.2 293.1,274.3 313.3,270.9 333.6,265.2 353.9,256.0 374.2,244.8 394.4,241.4 414.7,238.6 435.0,236.5 455.3,236.3 475.6,236.2 495.8,236.0 516.1,235.9 536.4,235.0 556.7,234.9 576.9,233.7 597.2,229.8 617.5,227.0 637.8,223.6 658.1,222.1 678.3,219.1 698.6,217.5 718.9,212.6 739.2,210.5 759.4,210.1 779.7,209.0 [...]
+ <polyline class="fade" style="animation-delay:.25s" points="70.0,360.0 90.3,359.2 110.6,358.4 130.8,357.5 151.1,355.9 171.4,354.6 191.7,353.8 211.9,352.6 232.2,351.8 252.5,350.7 272.8,349.4 293.1,348.3 313.3,347.2 333.6,346.0 353.9,344.7 374.2,343.7 394.4,342.5 414.7,340.7 435.0,338.5 455.3,337.0 475.6,335.6 495.8,333.2 516.1,332.0 536.4,316.7 556.7,306.3 576.9,303.3 597.2,287.0 617.5,282.5 637.8,278.9 658.1,276.4 678.3,273.7 698.6,269.7 718.9,267.2 739.2,264.2 759.4,260.2 779.7,255.1 [...]
+ <text x="70.0" y="382" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Jul 23</text><line x1="70.0" y1="360" x2="70.0" y2="366" stroke="var(--unomi-border)" stroke-width="1"/><text x="191.7" y="382" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Jan 24</text><line x1="191.7" y1="360" x2="191.7" y2="366" stroke="var(--unomi-border)" stroke-width="1"/><text x="313.3" y="382" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Jul 24</ [...]
+ <circle cx="800.0" cy="253.6" r="5" fill="var(--unomi-primary)"/>
+ <g class="fade" style="animation-delay:.5s">
+ <rect x="40" y="420" width="14" height="14" rx="3" fill="var(--unomi-primary)"/>
+ <text x="62" y="431" fill="var(--unomi-text)" font-size="12">Human browsers - 17,785</text>
+ <rect x="280" y="420" width="14" height="14" rx="3" fill="var(--unomi-accent)"/>
+ <text x="302" y="431" fill="var(--unomi-text)" font-size="12">All packages (incl. bots) - 43,320</text>
+ <line x1="500" y1="427" x2="526" y2="427" stroke="var(--unomi-bot)" stroke-width="2" stroke-dasharray="2 5" stroke-linecap="round"/>
+ <text x="534" y="431" fill="var(--unomi-text)" font-size="12">Known bots / scripts - 25,295</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/numbers-hero.svg b/src/main/webapp/assets/images/unomi3/numbers-hero.svg
new file mode 100644
index 0000000..b7ef64b
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-hero.svg
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 400" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Unomi 3 in numbers: lines of code, tests, and contributors at a glance">
+ <defs><style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-accent-dark: #0d9488;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes grow-bar { from { transform: scaleY(0); } to { transform: scaleY(1); } }
+ @keyframes fade-up { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+ @keyframes dash-flow { to { stroke-dashoffset: -20; } }
+ @keyframes pulse-dot { 0%,100%{opacity:.7;r:5} 50%{opacity:1;r:7} }
+ .bar { transform-box: fill-box; transform-origin: bottom; animation: grow-bar 0.9s ease-out both; }
+ .fade { animation: fade-up 0.7s ease-out both; }
+ .flow { stroke-dasharray: 5 4; animation: dash-flow 1.8s linear infinite; }
+ .dot { animation: pulse-dot 2.4s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .bar,.fade,.flow,.dot { animation: none !important; }
+ }
+</style>
+ <linearGradient id="heroGrad" x1="0" y1="0" x2="840" y2="400" gradientUnits="userSpaceOnUse">
+ <stop stop-color="#f5f3ff"/><stop offset="1" stop-color="#ecfeff"/>
+ </linearGradient>
+ </defs>
+ <rect width="840" height="400" rx="20" fill="url(#heroGrad)"/>
+ <text class="fade" x="40" y="42" fill="var(--unomi-text)" font-size="20" font-weight="700">Unomi 3 in numbers</text>
+ <text class="fade" style="animation-delay:.1s" x="40" y="66" fill="var(--unomi-text-muted)" font-size="13">From 1.x to 3.1 - codebase, tests, and community growth</text>
+
+ <g class="fade" style="animation-delay:.15s">
+ <rect x="40" y="100" width="175" height="150" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-primary)" stroke-width="2"/>
+ <text x="127" y="145" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12" font-weight="600">JAVA LOC</text>
+ <text x="127" y="190" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="36" font-weight="800">181k</text>
+ <text x="127" y="220" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">3.1 WIP (was 54k in 1.x)</text>
+ </g>
+ <g class="fade" style="animation-delay:.25s">
+ <rect x="235" y="100" width="175" height="150" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-accent)" stroke-width="2"/>
+ <text x="322" y="145" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12" font-weight="600">UNIT @Test</text>
+ <text x="322" y="190" text-anchor="middle" fill="var(--unomi-accent-dark)" font-size="36" font-weight="800">1,148</text>
+ <text x="322" y="220" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">up from 34 in Unomi 1.x</text>
+ </g>
+ <g class="fade" style="animation-delay:.35s">
+ <rect x="430" y="100" width="175" height="150" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-info)" stroke-width="2"/>
+ <text x="517" y="145" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12" font-weight="600">IT @Test</text>
+ <text x="517" y="190" text-anchor="middle" fill="var(--unomi-info)" font-size="36" font-weight="800">388</text>
+ <text x="517" y="220" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">up from 128 in Unomi 1.x</text>
+ </g>
+ <g class="fade" style="animation-delay:.45s">
+ <rect x="625" y="100" width="175" height="150" rx="16" fill="var(--unomi-white)" stroke="var(--unomi-success)" stroke-width="2"/>
+ <text x="712" y="145" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="12" font-weight="600">CONTRIBUTORS</text>
+ <text x="712" y="190" text-anchor="middle" fill="var(--unomi-success)" font-size="36" font-weight="800">77</text>
+ <text x="712" y="220" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">cumulative unique authors</text>
+ </g>
+
+ <rect x="40" y="280" width="760" height="90" rx="14" fill="var(--unomi-white)" stroke="var(--unomi-border)" stroke-width="2"/>
+ <text x="60" y="318" fill="var(--unomi-primary-dark)" font-size="14" font-weight="700">The story in one line</text>
+ <text x="60" y="344" fill="var(--unomi-text)" font-size="13">Production code nearly tripled since 1.x - test code grew ~7x, with the steepest climb after Unomi 3.0 into 3.1.</text>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/numbers-loc.svg b/src/main/webapp/assets/images/unomi3/numbers-loc.svg
new file mode 100644
index 0000000..7eebd24
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-loc.svg
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 420" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Stacked bar chart of Java lines of code from Unomi 1 through Unomi 3.1">
+ <defs><style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-accent-dark: #0d9488;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes grow-bar { from { transform: scaleY(0); } to { transform: scaleY(1); } }
+ @keyframes fade-up { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+ @keyframes dash-flow { to { stroke-dashoffset: -20; } }
+ @keyframes pulse-dot { 0%,100%{opacity:.7;r:5} 50%{opacity:1;r:7} }
+ .bar { transform-box: fill-box; transform-origin: bottom; animation: grow-bar 0.9s ease-out both; }
+ .fade { animation: fade-up 0.7s ease-out both; }
+ .flow { stroke-dasharray: 5 4; animation: dash-flow 1.8s linear infinite; }
+ .dot { animation: pulse-dot 2.4s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .bar,.fade,.flow,.dot { animation: none !important; }
+ }
+</style></defs>
+ <rect width="840" height="420" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text class="fade" x="40" y="36" fill="var(--unomi-text)" font-size="18" font-weight="700">Java lines of code</text>
+ <text class="fade" style="animation-delay:.08s" x="40" y="58" fill="var(--unomi-text-muted)" font-size="12">Physical LOC at release tags (production stacked on tests)</text>
+ <line x1="70" y1="330.0" x2="780" y2="330.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="64" y="334.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">0</text><line x1="70" y1="270.0" x2="780" y2="270.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="64" y="274.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">46k</text><line x1="70" y1="210.0" x2="780" y2="210.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="64" y="214.0" [...]
+
+ <g class="fade" style="animation-delay:0.10s">
+ <rect class="bar" style="animation-delay:0.10s" x="110" y="318.7" width="70" height="11.3" rx="4" fill="var(--unomi-accent)"/>
+ <rect class="bar" style="animation-delay:0.15s" x="110" y="260.1" width="70" height="58.6" rx="4" fill="var(--unomi-primary)"/>
+ <text x="145.0" y="250.1" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">54k</text>
+ <text x="145.0" y="354" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 1</text>
+ <text x="145.0" y="372" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">1.9.1</text>
+ </g>
+ <g class="fade" style="animation-delay:0.22s">
+ <rect class="bar" style="animation-delay:0.22s" x="290" y="314.8" width="70" height="15.2" rx="4" fill="var(--unomi-accent)"/>
+ <rect class="bar" style="animation-delay:0.27s" x="290" y="223.9" width="70" height="90.9" rx="4" fill="var(--unomi-primary)"/>
+ <text x="325.0" y="213.9" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">82k</text>
+ <text x="325.0" y="354" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 2</text>
+ <text x="325.0" y="372" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">2.7.0</text>
+ </g>
+ <g class="fade" style="animation-delay:0.34s">
+ <rect class="bar" style="animation-delay:0.34s" x="470" y="314.4" width="70" height="15.6" rx="4" fill="var(--unomi-accent)"/>
+ <rect class="bar" style="animation-delay:0.39s" x="470" y="221.7" width="70" height="92.6" rx="4" fill="var(--unomi-primary)"/>
+ <text x="505.0" y="211.7" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">83k</text>
+ <text x="505.0" y="354" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 3.0</text>
+ <text x="505.0" y="372" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">3.0.1</text>
+ </g>
+ <g class="fade" style="animation-delay:0.46s">
+ <rect class="bar" style="animation-delay:0.46s" x="650" y="248.6" width="70" height="81.4" rx="4" fill="var(--unomi-accent)"/>
+ <rect class="bar" style="animation-delay:0.51s" x="650" y="95.6" width="70" height="153.0" rx="4" fill="var(--unomi-primary)"/>
+ <text x="685.0" y="85.6" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">181k</text>
+ <text x="685.0" y="354" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 3.1</text>
+ <text x="685.0" y="372" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">HEAD</text>
+ </g>
+ <g class="fade" style="animation-delay:.6s">
+ <rect x="40" y="385" width="14" height="14" rx="3" fill="var(--unomi-primary)"/>
+ <text x="62" y="396" fill="var(--unomi-text)" font-size="12">Production (main)</text>
+ <rect x="200" y="385" width="14" height="14" rx="3" fill="var(--unomi-accent)"/>
+ <text x="222" y="396" fill="var(--unomi-text)" font-size="12">Tests</text>
+ <text x="780" y="396" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">~3.4x total Java since Unomi 1</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/numbers-tests.svg b/src/main/webapp/assets/images/unomi3/numbers-tests.svg
new file mode 100644
index 0000000..2b39861
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-tests.svg
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 420" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Grouped bar chart of unit and integration @Test methods from Unomi 1 through 3.1">
+ <defs><style>
+ svg {
+ --unomi-primary: #6d5ce7;
+ --unomi-primary-dark: #5a48c9;
+ --unomi-primary-light: #ede9fe;
+ --unomi-primary-subtle: #f5f3ff;
+ --unomi-accent: #00cec9;
+ --unomi-accent-dark: #0d9488;
+ --unomi-hero-accent: #a78bfa;
+ --unomi-text: #1e293b;
+ --unomi-text-muted: #64748b;
+ --unomi-white: #ffffff;
+ --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0;
+ --unomi-success: #059669;
+ --unomi-success-bg: #ecfdf5;
+ --unomi-amber: #d97706;
+ --unomi-amber-bg: #fef3c7;
+ --unomi-info: #2563eb;
+ --unomi-info-bg: #dbeafe;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes grow-bar { from { transform: scaleY(0); } to { transform: scaleY(1); } }
+ @keyframes fade-up { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
+ @keyframes dash-flow { to { stroke-dashoffset: -20; } }
+ @keyframes pulse-dot { 0%,100%{opacity:.7;r:5} 50%{opacity:1;r:7} }
+ .bar { transform-box: fill-box; transform-origin: bottom; animation: grow-bar 0.9s ease-out both; }
+ .fade { animation: fade-up 0.7s ease-out both; }
+ .flow { stroke-dasharray: 5 4; animation: dash-flow 1.8s linear infinite; }
+ .dot { animation: pulse-dot 2.4s ease-in-out infinite; }
+ @media (prefers-reduced-motion: reduce) {
+ .bar,.fade,.flow,.dot { animation: none !important; }
+ }
+</style></defs>
+ <rect width="840" height="420" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text class="fade" x="40" y="36" fill="var(--unomi-text)" font-size="18" font-weight="700">Unit and integration tests</text>
+ <text class="fade" style="animation-delay:.08s" x="40" y="58" fill="var(--unomi-text-muted)" font-size="12">Approximate @Test method counts (JUnit annotations)</text>
+ <text class="fade" style="animation-delay:.12s" x="40" y="78" fill="var(--unomi-text-muted)" font-size="11">Unomi 1: 11 unit / 25 IT classes | Unomi 2: 12 unit / 44 IT classes | Unomi 3.0: 15 unit / 43 IT classes | Unomi 3.1: 66 unit / 63 IT classes</text>
+ <line x1="70" y1="320.0" x2="780" y2="320.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="64" y="324.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">0</text><line x1="70" y1="265.0" x2="780" y2="265.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="64" y="269.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">300</text><line x1="70" y1="210.0" x2="780" y2="210.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="64" y="214.0" [...]
+
+ <g class="fade" style="animation-delay:0.10s">
+ <rect class="bar" style="animation-delay:0.10s" x="100" y="313.8" width="36" height="6.2" rx="4" fill="var(--unomi-primary)"/>
+ <rect class="bar" style="animation-delay:0.15s" x="142" y="296.5" width="36" height="23.5" rx="4" fill="var(--unomi-info)"/>
+ <text x="118" y="305.8" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="11" font-weight="700">34</text>
+ <text x="160" y="288.5" text-anchor="middle" fill="var(--unomi-info)" font-size="11" font-weight="700">128</text>
+ <text x="139" y="344" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 1</text>
+ <text x="139" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">1.9.1</text>
+ </g>
+ <g class="fade" style="animation-delay:0.22s">
+ <rect class="bar" style="animation-delay:0.22s" x="280" y="312.3" width="36" height="7.7" rx="4" fill="var(--unomi-primary)"/>
+ <rect class="bar" style="animation-delay:0.27s" x="322" y="284.6" width="36" height="35.4" rx="4" fill="var(--unomi-info)"/>
+ <text x="298" y="304.3" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="11" font-weight="700">42</text>
+ <text x="340" y="276.6" text-anchor="middle" fill="var(--unomi-info)" font-size="11" font-weight="700">193</text>
+ <text x="319" y="344" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 2</text>
+ <text x="319" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">2.7.0</text>
+ </g>
+ <g class="fade" style="animation-delay:0.34s">
+ <rect class="bar" style="animation-delay:0.34s" x="460" y="303.3" width="36" height="16.7" rx="4" fill="var(--unomi-primary)"/>
+ <rect class="bar" style="animation-delay:0.39s" x="502" y="284.6" width="36" height="35.4" rx="4" fill="var(--unomi-info)"/>
+ <text x="478" y="295.3" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="11" font-weight="700">91</text>
+ <text x="520" y="276.6" text-anchor="middle" fill="var(--unomi-info)" font-size="11" font-weight="700">193</text>
+ <text x="499" y="344" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 3.0</text>
+ <text x="499" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">3.0.1</text>
+ </g>
+ <g class="fade" style="animation-delay:0.46s">
+ <rect class="bar" style="animation-delay:0.46s" x="640" y="109.5" width="36" height="210.5" rx="4" fill="var(--unomi-primary)"/>
+ <rect class="bar" style="animation-delay:0.51s" x="682" y="248.9" width="36" height="71.1" rx="4" fill="var(--unomi-info)"/>
+ <text x="658" y="101.5" text-anchor="middle" fill="var(--unomi-primary-dark)" font-size="11" font-weight="700">1,148</text>
+ <text x="700" y="240.9" text-anchor="middle" fill="var(--unomi-info)" font-size="11" font-weight="700">388</text>
+ <text x="679" y="344" text-anchor="middle" fill="var(--unomi-text)" font-size="13" font-weight="700">Unomi 3.1</text>
+ <text x="679" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">HEAD</text>
+ </g>
+ <g class="fade" style="animation-delay:.7s">
+ <rect x="40" y="385" width="14" height="14" rx="3" fill="var(--unomi-primary)"/>
+ <text x="62" y="396" fill="var(--unomi-text)" font-size="12">Unit @Test methods</text>
+ <rect x="230" y="385" width="14" height="14" rx="3" fill="var(--unomi-info)"/>
+ <text x="252" y="396" fill="var(--unomi-text)" font-size="12">Integration @Test methods</text>
+ <text x="780" y="396" text-anchor="end" fill="var(--unomi-text-muted)" font-size="11">Unit methods ~34x since 1.x</text>
+ </g>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/numbers-visits-countries.svg b/src/main/webapp/assets/images/unomi3/numbers-visits-countries.svg
new file mode 100644
index 0000000..ae3c884
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-visits-countries.svg
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 420" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Top visitor countries for unomi.apache.org from ASF Matomo">
+ <defs><style>
+ svg {
+ --unomi-primary: #6d5ce7; --unomi-primary-dark: #5a48c9; --unomi-accent: #00cec9;
+ --unomi-text: #1e293b; --unomi-text-muted: #64748b; --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0; --unomi-amber: #d97706;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes fade-up { from { opacity: 0; } to { opacity: 1; } }
+ .fade { animation: fade-up 0.7s ease-out both; }
+ @media (prefers-reduced-motion: reduce) { .fade { animation: none !important; } }
+</style></defs>
+ <rect width="840" height="420" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text class="fade" x="40" y="36" fill="var(--unomi-text)" font-size="18" font-weight="700">Visitors by country</text>
+ <text class="fade" style="animation-delay:.08s" x="40" y="56" fill="var(--unomi-text-muted)" font-size="12">ASF Matomo geo for unomi.apache.org - tracking window through Jul 2026</text>
+ <g class="fade" style="animation-delay:.15s">
+ <text x="40" y="90" fill="var(--unomi-text)" font-size="13" font-weight="600">United States</text>
+ <text x="800" y="90" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">12,941 (45%)</text>
+ <rect x="40" y="96" width="520.0" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="96" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+
+ <text x="40" y="126" fill="var(--unomi-text)" font-size="13" font-weight="600">China</text>
+ <text x="800" y="126" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">2,127 (7%)</text>
+ <rect x="40" y="132" width="85.5" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="132" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+
+ <text x="40" y="162" fill="var(--unomi-text)" font-size="13" font-weight="600">India</text>
+ <text x="800" y="162" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">1,658 (6%)</text>
+ <rect x="40" y="168" width="66.6" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="168" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+
+ <text x="40" y="198" fill="var(--unomi-text)" font-size="13" font-weight="600">United Kingdom</text>
+ <text x="800" y="198" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">1,320 (5%)</text>
+ <rect x="40" y="204" width="53.0" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="204" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+
+ <text x="40" y="234" fill="var(--unomi-text)" font-size="13" font-weight="600">Vietnam</text>
+ <text x="800" y="234" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">809 (3%)</text>
+ <rect x="40" y="240" width="32.5" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="240" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+
+ <text x="40" y="270" fill="var(--unomi-text)" font-size="13" font-weight="600">Russia</text>
+ <text x="800" y="270" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">707 (2%)</text>
+ <rect x="40" y="276" width="28.4" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="276" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+
+ <text x="40" y="306" fill="var(--unomi-text)" font-size="13" font-weight="600">France</text>
+ <text x="800" y="306" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">700 (2%)</text>
+ <rect x="40" y="312" width="28.1" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="312" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+
+ <text x="40" y="342" fill="var(--unomi-text)" font-size="13" font-weight="600">Germany</text>
+ <text x="800" y="342" text-anchor="end" fill="var(--unomi-text-muted)" font-size="12">672 (2%)</text>
+ <rect x="40" y="348" width="27.0" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.85"/>
+ <rect x="40" y="348" width="520" height="10" rx="5" fill="var(--unomi-primary)" fill-opacity="0.08"/>
+</g>
+ <text x="40" y="400" fill="var(--unomi-text-muted)" font-size="11">Desktop-heavy traffic (~88%) · mostly direct and search · Matomo bot filtering differs from CDN download logs</text>
+</svg>
diff --git a/src/main/webapp/assets/images/unomi3/numbers-visits.svg b/src/main/webapp/assets/images/unomi3/numbers-visits.svg
new file mode 100644
index 0000000..bfc473c
--- /dev/null
+++ b/src/main/webapp/assets/images/unomi3/numbers-visits.svg
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg viewBox="0 0 840 420" fill="none" xmlns="http://www.w3.org/2000/svg" role="img"
+ aria-label="Monthly visits to unomi.apache.org from Matomo, January 2025 through July 2026">
+ <defs>
+ <style>
+ svg {
+ --unomi-primary: #6d5ce7; --unomi-primary-dark: #5a48c9; --unomi-accent: #00cec9;
+ --unomi-text: #1e293b; --unomi-text-muted: #64748b; --unomi-bg-soft: #f8fafc;
+ --unomi-border: #e2e8f0; --unomi-amber: #d97706;
+ font-family: Inter, system-ui, sans-serif;
+ }
+ @keyframes fade-up { from { opacity: 0; } to { opacity: 1; } }
+ .fade { animation: fade-up 0.7s ease-out both; }
+ @media (prefers-reduced-motion: reduce) { .fade { animation: none !important; } }
+</style>
+ <linearGradient id="visitFill" x1="0" y1="80" x2="0" y2="340" gradientUnits="userSpaceOnUse">
+ <stop stop-color="#6d5ce7" stop-opacity="0.25"/>
+ <stop offset="1" stop-color="#6d5ce7" stop-opacity="0.02"/>
+ </linearGradient>
+ </defs>
+ <rect width="840" height="420" rx="20" fill="var(--unomi-bg-soft)"/>
+ <text class="fade" x="40" y="36" fill="var(--unomi-text)" font-size="18" font-weight="700">Website visits</text>
+ <text class="fade" style="animation-delay:.08s" x="40" y="56" fill="var(--unomi-text-muted)" font-size="12">unomi.apache.org via ASF Matomo - monthly series Jan 2025 to Jul 2026</text>
+ <line x1="70" y1="340.0" x2="800" y2="340.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="62" y="344.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">0</text><line x1="70" y1="275.0" x2="800" y2="275.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="62" y="279.0" text-anchor="end" fill="var(--unomi-text-muted)" font-size="10">542</text><line x1="70" y1="210.0" x2="800" y2="210.0" stroke="var(--unomi-border)" stroke-width="1"/><text x="62" y="214.0" [...]
+ <g class="fade" style="animation-delay:.12s"><rect x="57.5" y="269.3" width="25.0" height="70.7" rx="3" fill="var(--unomi-primary)" fill-opacity="0.35"/><rect x="98.1" y="141.2" width="25.0" height="198.8" rx="3" fill="var(--unomi-primary)" fill-opacity="0.35"/><rect x="138.6" y="113.9" width="25.0" height="226.1" rx="3" fill="var(--unomi-primary)" fill-opacity="0.35"/><rect x="179.2" y="133.3" width="25.0" height="206.7" rx="3" fill="var(--unomi-primary)" fill-opacity="0.35"/><rect x= [...]
+ <polygon class="fade" style="animation-delay:.18s" points="70.0,340.0 70.0,269.3 110.6,141.2 151.1,113.9 191.7,133.3 232.2,141.2 272.8,148.7 313.3,155.8 353.9,146.7 394.4,135.6 435.0,151.9 475.6,148.7 516.1,163.6 556.7,142.2 597.2,166.9 637.8,123.3 678.3,182.8 718.9,158.6 759.4,141.6 800.0,241.6 800.0,340.0" fill="url(#visitFill)"/>
+ <polyline class="fade" style="animation-delay:.22s" points="70.0,269.3 110.6,141.2 151.1,113.9 191.7,133.3 232.2,141.2 272.8,148.7 313.3,155.8 353.9,146.7 394.4,135.6 435.0,151.9 475.6,148.7 516.1,163.6 556.7,142.2 597.2,166.9 637.8,123.3 678.3,182.8 718.9,158.6 759.4,141.6 800.0,241.6" fill="none" stroke="var(--unomi-primary)" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+ <text x="70.0" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Jan 25</text><text x="191.7" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Apr 25</text><text x="313.3" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Jul 25</text><text x="435.0" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" font-size="11">Oct 25</text><text x="556.7" y="362" text-anchor="middle" fill="var(--unomi-text-muted)" [...]
+ <circle cx="800.0" cy="241.6" r="5" fill="var(--unomi-primary)"/>
+ <text x="40" y="402" fill="var(--unomi-text-muted)" font-size="12">28,795 visits total · 62,762 actions · ~91s avg · bounce 67%</text>
+</svg>
diff --git a/src/main/webapp/blog/index.html b/src/main/webapp/blog/index.html
index c83f6e5..1f861d8 100644
--- a/src/main/webapp/blog/index.html
+++ b/src/main/webapp/blog/index.html
@@ -213,6 +213,22 @@ layout: default
</div>
</div>
<div class="row g-4">
+ <div class="col-md-6 col-lg-3">
+ <article class="feature-card h-100 overflow-hidden p-0 position-relative">
+ <a href="/blog/unomi-3-in-numbers.html" class="d-block" aria-label="Read Unomi 3 in numbers">
+ <img src="/assets/images/unomi3/numbers-hero.svg" class="img-fluid w-100" alt="Unomi 3 metrics charts" loading="lazy">
+ </a>
+ <div class="p-3">
+ <span class="badge badge-primary mb-2">Metrics</span>
+ <h3 class="h6 fw-semibold mb-2">
+ <a href="/blog/unomi-3-in-numbers.html" class="text-decoration-none text-body">Unomi 3 in numbers</a>
+ </h3>
+ <p class="small text-muted mb-0">LOC, tests, and contributors — 1.x to 3.1.</p>
+ <a href="/blog/unomi-3-in-numbers.html" class="stretched-link" aria-label="Read Unomi 3 in numbers"></a>
+ </div>
+ </article>
+ </div>
+
<div class="col-md-6 col-lg-3">
<article class="feature-card h-100 overflow-hidden p-0 position-relative">
<a href="/blog/unomi-3-platform-foundation.html" class="d-block" aria-label="Read platform foundation">
@@ -339,8 +355,11 @@ layout: default
<div class="col-lg-5">
<div class="feature-card h-100">
<p class="section-label mb-3">Browse by topic</p>
+ <p class="small mb-3"><a href="#all-posts">View all posts by date</a></p>
<div class="d-flex flex-wrap gap-2 mb-4">
<a href="/blog/introducing-apache-unomi-3.html" class="badge badge-primary text-decoration-none px-3 py-2">Unomi 3</a>
+ <a href="/blog/unomi-3-in-numbers.html" class="badge badge-primary text-decoration-none px-3 py-2">In numbers</a>
+
<a href="/blog/unomi-3-multitenancy.html" class="badge badge-primary text-decoration-none px-3 py-2">Multi-tenancy</a>
<a href="/blog/unomi-3-ai-agents.html" class="badge badge-primary text-decoration-none px-3 py-2">AI agents</a>
<a href="/blog/migrating-to-unomi-3.html" class="badge badge-primary text-decoration-none px-3 py-2">Migration</a>
@@ -364,6 +383,198 @@ layout: default
</div>
</section>
+
+
+
+<!-- Chronological archive (featured layout above stays as-is) -->
+<section class="section section-alt" id="all-posts">
+ <div class="container">
+ <div class="row justify-content-center">
+ <div class="col-lg-9">
+ <div class="bg-white rounded-3 shadow-sm overflow-hidden">
+ <button class="btn btn-link text-decoration-none text-body w-100 text-start px-4 py-3 d-flex align-items-center justify-content-between collapsed"
+ type="button"
+ data-bs-toggle="collapse"
+ data-bs-target="#blog-archive-list"
+ aria-expanded="false"
+ aria-controls="blog-archive-list">
+ <span>
+ <span class="section-label d-block mb-1">Archive</span>
+ <span class="h5 mb-0 fw-semibold">All posts by date</span>
+ <span class="d-block small text-muted mt-1">Newest first · 16 posts</span>
+ </span>
+ <i class="bi bi-chevron-down fs-5 text-muted" aria-hidden="true"></i>
+ </button>
+ <div class="collapse" id="blog-archive-list">
+ <div class="list-group list-group-flush border-top">
+ <a href="/blog/unomi-3-in-numbers.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">16</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Unomi 3 in numbers</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-17T10:00:00Z">Jul 17, 2026 · 10:00 UTC</time>
+ </div>
+ <div class="small text-muted">LOC, tests, downloads, visitors</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-openapi-enrichment.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">15</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Richer OpenAPI docs in Unomi 3.1</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-15T13:58:00Z">Jul 15, 2026 · 13:58 UTC</time>
+ </div>
+ <div class="small text-muted">Javadoc-enriched OpenAPI</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-manual.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">14</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Unomi 3 manual improvements</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-13T12:51:00Z">Jul 13, 2026 · 12:51 UTC</time>
+ </div>
+ <div class="small text-muted">Branded docs and PlantUML</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-build-sh.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">13</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">One entry point — Unomi 3 build.sh</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-11T11:44:00Z">Jul 11, 2026 · 11:44 UTC</time>
+ </div>
+ <div class="small text-muted">One script for build and deploy</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-it-execution.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">12</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Clearer integration test runs in Unomi 3</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-09T10:37:00Z">Jul 09, 2026 · 10:37 UTC</time>
+ </div>
+ <div class="small text-muted">Clearer IT progress and CI</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-unit-testing-harness.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">11</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Faster Unomi service unit tests</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-07T09:30:00Z">Jul 07, 2026 · 09:30 UTC</time>
+ </div>
+ <div class="small text-muted">Fast in-memory unit tests</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-request-tracing.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">10</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Request tracing with explain=true in Unomi 3</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-05T13:23:00Z">Jul 05, 2026 · 13:23 UTC</time>
+ </div>
+ <div class="small text-muted">Debug with explain=true</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-task-scheduler.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">09</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Cluster-aware task scheduler in Unomi 3.1</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-03T12:16:00Z">Jul 03, 2026 · 12:16 UTC</time>
+ </div>
+ <div class="small text-muted">Cluster-aware scheduled work</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-shell-commands.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">08</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Unomi 3 Karaf shell commands</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-07-01T11:59:00Z">Jul 01, 2026 · 11:59 UTC</time>
+ </div>
+ <div class="small text-muted">Ops via Karaf shell</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-opensearch.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">07</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Elasticsearch 9 and OpenSearch in Unomi 3</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-06-29T10:52:00Z">Jun 29, 2026 · 10:52 UTC</time>
+ </div>
+ <div class="small text-muted">Dual search backends</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-platform-foundation.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">06</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Unomi 3 platform foundation</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-06-27T09:45:00Z">Jun 27, 2026 · 09:45 UTC</time>
+ </div>
+ <div class="small text-muted">Java 17, Karaf 4.4, ES9, clustering</div>
+ </div>
+ </a>
+ <a href="/blog/migrating-to-unomi-3.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">05</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Migrating from Unomi 2.x to Unomi 3</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-06-25T13:38:00Z">Jun 25, 2026 · 13:38 UTC</time>
+ </div>
+ <div class="small text-muted">Upgrade path from 2.x</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-ai-agents.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">04</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Apache Unomi 3 for AI agents</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-06-23T12:31:00Z">Jun 23, 2026 · 12:31 UTC</time>
+ </div>
+ <div class="small text-muted">Privacy-first customer memory for agents</div>
+ </div>
+ </a>
+ <a href="/blog/unomi-3-multitenancy.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">03</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Multi-tenancy in Apache Unomi 3</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-06-21T11:24:00Z">Jun 21, 2026 · 11:24 UTC</time>
+ </div>
+ <div class="small text-muted">Platform-wide tenant isolation</div>
+ </div>
+ </a>
+ <a href="/blog/introducing-apache-unomi-3.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">02</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Introducing Apache Unomi 3</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-06-19T10:17:00Z">Jun 19, 2026 · 10:17 UTC</time>
+ </div>
+ <div class="small text-muted">The major Unomi 3 release story</div>
+ </div>
+ </a>
+ <a href="/blog/welcome-to-the-apache-unomi-blog.html" class="list-group-item list-group-item-action d-flex gap-3 py-3 border-0 border-bottom rounded-0">
+ <span class="text-primary fw-bold" style="min-width:2rem">01</span>
+ <div class="flex-grow-1">
+ <div class="d-flex flex-wrap justify-content-between gap-2">
+ <strong class="text-body">Welcome to the Apache Unomi Blog</strong>
+ <time class="small text-muted text-nowrap" datetime="2026-06-17T09:10:00Z">Jun 17, 2026 · 09:10 UTC</time>
+ </div>
+ <div class="small text-muted">Why this Blog exists</div>
+ </div>
+ </a>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+ </div>
+</section>
+
<!-- Reading order -->
<section class="section">
<div class="container">
@@ -404,7 +615,8 @@ layout: default
</div>
</div>
<p class="text-center small text-muted mt-4 mb-0">
- Then: <a href="/blog/migrating-to-unomi-3.html">Migrating from 2.x</a> ·
+ Then: <a href="/blog/unomi-3-in-numbers.html">In numbers</a> ·
+ <a href="/blog/migrating-to-unomi-3.html">Migrating from 2.x</a> ·
<a href="/blog/unomi-3-platform-foundation.html">Platform</a> ·
<a href="/blog/unomi-3-opensearch.html">OpenSearch</a> ·
<a href="/blog/unomi-3-shell-commands.html">Shell</a> ·
diff --git a/src/main/webapp/blog/introducing-apache-unomi-3.html b/src/main/webapp/blog/introducing-apache-unomi-3.html
index 1bb690e..e0e0525 100644
--- a/src/main/webapp/blog/introducing-apache-unomi-3.html
+++ b/src/main/webapp/blog/introducing-apache-unomi-3.html
@@ -3,6 +3,7 @@ title: Introducing Apache Unomi 3
description: "Apache Unomi 3 is a major open-source CDP release — Elasticsearch 9 / OpenSearch, multi-tenancy, stable REST, quality investment, and AI-ready customer memory."
keywords: "Apache Unomi 3, open source CDP, multi-tenancy, OpenSearch, V2 API compatibility, CDP tests"
layout: default
+date: 2026-06-19 10:17:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3</p>
<h1>Introducing Apache Unomi 3</h1>
<p class="lead">A major Customer Data Platform release — platform foundation (3.0) and product leap (3.1) as one story.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
<section class="section">
diff --git a/src/main/webapp/blog/migrating-to-unomi-3.html b/src/main/webapp/blog/migrating-to-unomi-3.html
index 83520ad..c0d31de 100644
--- a/src/main/webapp/blog/migrating-to-unomi-3.html
+++ b/src/main/webapp/blog/migrating-to-unomi-3.html
@@ -3,6 +3,7 @@ title: Migrating from Unomi 2.x to Unomi 3
description: "Unomi 3 retains 100% of documented 2.x OpenAPI paths and offers V2 compatibility mode for phased client auth migration."
keywords: "Unomi 3 migration, V2 compatibility mode, OpenAPI stability, upgrade from Unomi 2"
layout: default
+date: 2026-06-25 13:38:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Upgrades</p>
<h1>Migrating from Unomi 2.x to Unomi 3</h1>
<p class="lead">Familiar REST map, additive APIs, and an optional V2 compatibility bridge.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
<section class="section">
diff --git a/src/main/webapp/blog/unomi-3-ai-agents.html b/src/main/webapp/blog/unomi-3-ai-agents.html
index 2a9d3e1..b6f4a33 100644
--- a/src/main/webapp/blog/unomi-3-ai-agents.html
+++ b/src/main/webapp/blog/unomi-3-ai-agents.html
@@ -3,6 +3,7 @@ title: Apache Unomi 3 for AI agents — privacy-first customer memory
description: "Apache Unomi 3 is an open-source CDP AI agents can query and update — retrieve customer context, store observations, summarize profiles, and build segments with built-in consent."
keywords: "Apache Unomi 3, AI agents CDP, LLM customer context, open source CDP for AI, agentic personalization, consent-aware AI data layer"
layout: default
+date: 2026-06-23 12:31:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">AI agents · Second message</p>
<h1>Apache Unomi 3 for AI agents</h1>
<p class="lead">Privacy-first customer memory — retrieve, store, summarize, and build segments. Unomi is not an LLM; it is the data layer agents plug into.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
<section class="section">
diff --git a/src/main/webapp/blog/unomi-3-build-sh.html b/src/main/webapp/blog/unomi-3-build-sh.html
index e06759e..c835d1e 100644
--- a/src/main/webapp/blog/unomi-3-build-sh.html
+++ b/src/main/webapp/blog/unomi-3-build-sh.html
@@ -3,6 +3,7 @@ title: One entry point — Unomi 3 build.sh
description: "How Apache Unomi 3 replaced scattered build scripts with a single build.sh — preflight checks, CI mode, integration tests, deploy, and Windows build.ps1 parity."
keywords: "Unomi build.sh, Apache Unomi developer experience, UNOMI-887, Maven CI, OpenSearch integration tests"
layout: default
+date: 2026-07-11 11:44:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Developer experience</p>
<h1>One entry point: <code>build.sh</code></h1>
<p class="lead">Preflight, build, test, and deploy — the same script locally and on GitHub Actions.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-in-numbers.html b/src/main/webapp/blog/unomi-3-in-numbers.html
new file mode 100644
index 0000000..f6a6254
--- /dev/null
+++ b/src/main/webapp/blog/unomi-3-in-numbers.html
@@ -0,0 +1,139 @@
+---
+title: Unomi 3 in numbers
+description: "Unomi 1 vs 2 vs 3 in numbers — lines of code, tests, contributors, ASF downloads, and unomi.apache.org Matomo visits."
+keywords: "Unomi 3 metrics, lines of code, unit tests, integration tests, contributors, downloads, website visits, Matomo, Apache Unomi statistics"
+layout: default
+date: 2026-07-17 10:00:00 +0000
+---
+
+<section class="page-header">
+ <div class="container">
+ <p class="section-label text-hero-label">Unomi 3 · Metrics</p>
+ <h1>Unomi 3 in numbers</h1>
+ <p class="lead">How the codebase, tests, community, downloads, and website traffic grew from Unomi 1 through Unomi 3.1.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
+ </div>
+</section>
+
+<section class="section">
+ <div class="container col-lg-8">
+ <p>Unomi 3 is not only new features — multi-tenancy, OpenSearch, shell CRUD, tracing, and the task scheduler.
+ It is also a step-change in how much of the platform is covered by automated tests, and how the Java surface area evolved across a decade of releases.</p>
+ <p>The charts below use <strong>release tags</strong> as waypoints:
+ Unomi 1 = <code>unomi-root-1.9.1</code>,
+ Unomi 2 = <code>unomi-root-2.7.0</code>,
+ Unomi 3.0 = <code>unomi-root-3.0.1</code>,
+ Unomi 3.1 = current <code>master</code> (work in progress after 3.0.1).
+ Counts are physical lines of code and approximate JUnit <code>@Test</code> annotations from the git tree at each tag.</p>
+
+ <img src="/assets/images/unomi3/numbers-hero.svg" class="img-fluid my-4" alt="Unomi 3 headline metrics: 181k Java LOC, 1148 unit tests, 388 IT tests, 77 contributors"/>
+
+ <h2 class="h4 mt-5 mb-3">Lines of code</h2>
+ <p>Production Java grew from about <strong>45k</strong> lines in late Unomi 1 to about <strong>70k</strong> in Unomi 2 and <strong>71k</strong> at Unomi 3.0.1 — then jumped to about <strong>118k</strong> on the 3.1 line.
+ Test Java stayed modest through 3.0 (~12k) and then leapt to about <strong>63k</strong> with the unit harness, multi-tenancy coverage, and related work.</p>
+ <img src="/assets/images/unomi3/numbers-loc.svg" class="img-fluid my-4" alt="Stacked bar chart of Java production and test lines of code across Unomi 1, 2, 3.0, and 3.1"/>
+ <p class="small text-muted">Methodology: physical line counts over <code>.java</code> (and primary companion sources for totals elsewhere) from <code>git archive</code> at each tag; paths under <code>target/</code> excluded.
+ “Main” is everything outside <code>src/test/</code> and <code>itests/</code>; “Tests” is those trees.</p>
+
+ <h2 class="h4 mt-5 mb-3">Unit and integration tests</h2>
+ <p>Integration tests have been Unomi’s historical strength — growing from roughly <strong>128</strong> IT <code>@Test</code> methods in 1.9.1 to about <strong>388</strong> on 3.1.
+ The dramatic change is on the unit side: from a few dozen methods through Unomi 2 to about <strong>1,148</strong> on 3.1, driven by the in-memory persistence harness and denser service-level coverage.</p>
+ <img src="/assets/images/unomi3/numbers-tests.svg" class="img-fluid my-4" alt="Grouped bars of unit versus integration @Test method counts across Unomi versions"/>
+ <ul>
+ <li><strong>Unit classes</strong> — 11 → 12 → 15 → <strong>66</strong></li>
+ <li><strong>IT classes</strong> — 25 → 44 → 43 → <strong>63</strong></li>
+ <li><strong>Test / main Java ratio</strong> — ~0.19 in 1.x, ~0.17 in 2.x, ~<strong>0.53</strong> on 3.1</li>
+ </ul>
+ <p>That ratio shift is intentional: Unomi 3 invests in fast feedback for rules, persistence, and tenancy while keeping the heavier IT suite for end-to-end confidence.
+ See also
+ <a href="/blog/unomi-3-unit-testing-harness.html">the unit testing harness</a>
+ and
+ <a href="/blog/unomi-3-it-execution.html">clearer IT execution</a>.</p>
+
+ <h2 class="h4 mt-5 mb-3">Contributors</h2>
+ <p>The project has grown to <strong>77</strong> unique authors on the master ancestry (name-based; some people appear under multiple spellings), with about <strong>2,769</strong> commits through current <code>master</code>.
+ Late Unomi 1 already had a broad base (~62 authors); Unomi 2 and 3 continue that trajectory rather than restarting it.</p>
+ <img src="/assets/images/unomi3/numbers-contributors.svg" class="img-fluid my-4" alt="Line chart of cumulative unique contributors from Unomi 1 through 3.1"/>
+ <p class="small text-muted">Top committers historically include Serge Huber, Thomas Draier, Abdelkader Midani, Sergiy Shyrkov, and many others who shaped incubating 1.x through the 3.x platform leap.</p>
+
+ <h2 class="h4 mt-5 mb-3">Downloads</h2>
+ <p>Apache Infra publishes monthly CDN hit logs for Unomi on
+ <a href="https://infra-reports.apache.org/download_stats/unomi/">infra-reports.apache.org</a>
+ (hosts <code>dlcdn.apache.org</code> and <code>downloads.apache.org</code>).
+ From July 2023 through mid-July 2026 that is about
+ <strong>43k</strong> software-package hits in total (binary + source archives) —
+ that figure <em>includes</em> bots.
+ Of those, about <strong>25k</strong> (~58%) are identifiable as bots or scripts
+ (Python Requests, scrapers, GPTBot, curl/wget, HeadlessChrome, and similar),
+ leaving about <strong>18k</strong> from recognizable human browsers
+ (the purple series below).
+ ASF’s coarse UA labels will miss some bots, so the human count is likely still a bit high.</p>
+ <img src="/assets/images/unomi3/numbers-downloads.svg" class="img-fluid my-4" alt="Cumulative Unomi software package downloads: human browsers only, all packages including bots, and known bots, July 2023 through July 2026"/>
+ <p class="small text-muted">Methodology: classify each file’s <code>useragents</code> labels into human browsers vs known bots/scripts
+ (plus a small unknown bucket), then cumulate over the available months.
+ Solid purple = human browsers only (bots excluded);
+ solid teal = all software-package hits (bots included);
+ dotted muted purple = identified bots/scripts only.
+ Manuals/PDFs are excluded from all three series. Stats start mid-2023; July 2026 is partial.
+ Vertical markers: teal <strong>2.7.0</strong> (Sep 2025 release), amber <strong>3.0</strong> (Nov 2025),
+ and purple <strong>Site refresh</strong> (Feb 2026 website modernization).
+ Bot detection is only as good as the coarse UA labels ASF publishes — some automated clients
+ (or bots spoofing a normal browser) will not be flagged, so the human series is a best-effort lower-noise estimate,
+ not a guarantee of bot-free traffic.</p>
+
+ <h3 class="h5 mt-4 mb-3">Where downloads come from</h3>
+ <p>Country totals use the same bot filter: each file’s <code>cca2</code> hits are scaled by that file’s human-browser share
+ (ASF does not publish a full country×UA cross-tab).
+ After filtering, the densest human-attributed package volume is
+ <strong>Brazil</strong> (~24%), <strong>China</strong> (~18%), <strong>Russia</strong> (~17%),
+ the <strong>United States</strong> (~12%), and <strong>Germany</strong> (~8%),
+ with a long tail across Europe and Asia (~102 countries with attributed human traffic).</p>
+ <img src="/assets/images/unomi3/numbers-downloads-map.svg" class="img-fluid my-4" alt="World map of human Unomi software package downloads by country with bots excluded"/>
+ <p class="small text-muted">Map colors use a log scale. Geo still comes from CDN IP attribution, so mirrors, cloud egress, and VPNs can skew rankings
+ even after UA filtering. Hover a country in a supporting browser for its estimate.</p>
+
+ <h2 class="h4 mt-5 mb-3">Website visitors</h2>
+ <p>Separately from CDN package logs, ASF runs
+ <a href="https://analytics.apache.org/index.php?module=CoreHome&action=index&idSite=61&period=day&date=yesterday">Matomo analytics</a>
+ for <a href="https://unomi.apache.org">unomi.apache.org</a> (site id 61).
+ Across the available reporting window that is about
+ <strong>29k</strong> visits and <strong>63k</strong> actions,
+ with roughly <strong>2.2</strong> actions per visit, about
+ <strong>91</strong> seconds average time on site, and a
+ <strong>67%</strong> bounce rate.
+ Monthly series in Matomo are populated from January 2025 onward
+ (the site record was created mid-2024; earlier months are empty in the API).</p>
+ <img src="/assets/images/unomi3/numbers-visits.svg" class="img-fluid my-4" alt="Monthly visits to unomi.apache.org from ASF Matomo, January 2025 through July 2026"/>
+ <p>Traffic is mostly <strong>desktop</strong> (~88%), arrives primarily via
+ <strong>direct entry</strong> and <strong>search engines</strong>,
+ and is led by visitors attributed to the <strong>United States</strong> (~45%),
+ then China, India, and the United Kingdom.
+ Top content is the home page, Getting Started, Documentation, Use Cases, and Download.</p>
+ <img src="/assets/images/unomi3/numbers-visits-countries.svg" class="img-fluid my-4" alt="Top visitor countries for unomi.apache.org from ASF Matomo"/>
+ <p class="small text-muted">Source:
+ <a href="https://analytics.apache.org/index.php?module=CoreHome&action=index&idSite=61">analytics.apache.org</a>
+ (public Matomo Reporting API). Matomo applies its own bot filtering, so country mix here will not match CDN download geography.
+ Figures are visits (not unique visitors for the full range — Matomo disables that metric on long ranges).</p>
+
+ <h2 class="h4 mt-5 mb-3">What the numbers mean</h2>
+ <ul>
+ <li><strong>3.0 was the platform cut</strong> — LOC and IT counts look close to late 2.x; the runtime floor (Java 17, ES9, clustering) landed without ballooning the tree.</li>
+ <li><strong>3.1 is the product + quality leap</strong> — multi-tenancy and ops features arrive together with a much denser unit suite.</li>
+ <li><strong>Community continuity</strong> — contributor growth is cumulative; Unomi remains a long-running ASF codebase with steady authorship.</li>
+ <li><strong>Steady distribution</strong> — after excluding known bots/scripts (~58% of package hits), human browser downloads still show continuous uptake across three years of logged CDN data.</li>
+ <li><strong>Site interest holds</strong> — Matomo shows a steady ~1.5–1.9k visits/month through 2025–2026, concentrated on getting-started and docs paths.</li>
+ </ul>
+
+ <p class="mt-4">
+ <a class="btn btn-primary" href="/blog/introducing-apache-unomi-3.html">Introducing Unomi 3</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-unit-testing-harness.html">Unit harness</a>
+ <a class="btn btn-outline-primary ms-2" href="/blog/unomi-3-platform-foundation.html">Platform foundation</a>
+ </p>
+ <p><a href="/blog/">← All posts</a></p>
+ </div>
+</section>
diff --git a/src/main/webapp/blog/unomi-3-it-execution.html b/src/main/webapp/blog/unomi-3-it-execution.html
index e620d92..8592d44 100644
--- a/src/main/webapp/blog/unomi-3-it-execution.html
+++ b/src/main/webapp/blog/unomi-3-it-execution.html
@@ -3,6 +3,7 @@ title: Clearer integration test runs in Unomi 3
description: "How Unomi 3 improved IT execution — live progress bars with ETA, quieter Maven and Docker output, and tooling for diagnosing long CI suites."
keywords: "Unomi 3 integration tests, ProgressListener, CI logs, Apache Unomi IT, build.sh"
layout: default
+date: 2026-07-09 10:37:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Quality</p>
<h1>Clearer integration test runs in Unomi 3</h1>
<p class="lead">Progress bars, quieter CI output, and tools that turn a 90–minute suite into something you can actually follow.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-manual.html b/src/main/webapp/blog/unomi-3-manual.html
index cebe055..258b8e2 100644
--- a/src/main/webapp/blog/unomi-3-manual.html
+++ b/src/main/webapp/blog/unomi-3-manual.html
@@ -3,6 +3,7 @@ title: Unomi 3 manual — PlantUML, branded theme, deeper docs
description: "How the Apache Unomi 3 manual gained PlantUML/GraphViz diagrams, an Unomi-branded HTML/PDF theme, and major content expansions for migrations, multi-tenancy, and platform upgrades."
keywords: "Apache Unomi manual, PlantUML AsciiDoc, Unomi 3 documentation, AsciiDoctor diagrams, Unomi CSS theme"
layout: default
+date: 2026-07-13 12:51:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Documentation</p>
<h1>Unomi 3 manual: diagrams, theme, and depth</h1>
<p class="lead">PlantUML in AsciiDoc, a brand-aligned HTML/PDF look, and chapters that finally match the Unomi 3 platform.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-multitenancy.html b/src/main/webapp/blog/unomi-3-multitenancy.html
index 9b32c47..96f2563 100644
--- a/src/main/webapp/blog/unomi-3-multitenancy.html
+++ b/src/main/webapp/blog/unomi-3-multitenancy.html
@@ -3,6 +3,7 @@ title: Multi-tenancy in Apache Unomi 3
description: "Unomi 3 multi-tenancy was a major platform refactor — tenant isolation for profiles, events, segments, rules, and schemas with public and private API keys."
keywords: "Unomi 3 multi-tenancy, tenant API keys, SaaS CDP, Apache Unomi tenants, multi-tenant CDP"
layout: default
+date: 2026-06-21 11:24:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Multi-tenancy</p>
<h1>Multi-tenancy in Apache Unomi 3</h1>
<p class="lead">A major platform refactoring — not a bolt-on flag. Isolate customer spaces with API keys on one cluster.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-openapi-enrichment.html b/src/main/webapp/blog/unomi-3-openapi-enrichment.html
index e400418..4abe8bd 100644
--- a/src/main/webapp/blog/unomi-3-openapi-enrichment.html
+++ b/src/main/webapp/blog/unomi-3-openapi-enrichment.html
@@ -3,6 +3,7 @@ title: Richer OpenAPI docs in Unomi 3.1
description: "How Unomi 3.1 enriches /cxs/openapi.json from JAX-RS Javadoc — summaries, statuses, examples, and schemas without duplicating Swagger annotations (UNOMI-963)."
keywords: "Unomi OpenAPI, openapi.json, UNOMI-963, CXF OpenAPI, Javadoc enrichment, Unomi 3.1 REST"
layout: default
+date: 2026-07-15 13:58:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3.1 · Developer experience</p>
<h1>Richer OpenAPI docs from Javadoc</h1>
<p class="lead">Unomi 3.1 ships an enriched <code>/cxs/openapi.json</code> — summaries, status codes, examples, and schema notes merged from endpoint Javadoc.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-opensearch.html b/src/main/webapp/blog/unomi-3-opensearch.html
index 02db882..537b1e0 100644
--- a/src/main/webapp/blog/unomi-3-opensearch.html
+++ b/src/main/webapp/blog/unomi-3-opensearch.html
@@ -3,6 +3,7 @@ title: Elasticsearch 9 and OpenSearch in Unomi 3
description: "Unomi 3 runs on Elasticsearch 9 by default and ships a first-class OpenSearch persistence distribution — same SPI, migrate guide, and build flags."
keywords: "Unomi OpenSearch, Elasticsearch 9, Apache Unomi persistence, UNOMI-828, migrate Elasticsearch to OpenSearch"
layout: default
+date: 2026-06-29 10:52:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Operations</p>
<h1>Elasticsearch 9 and OpenSearch in Unomi 3</h1>
<p class="lead">One CDP runtime, two supported search backends — pick the distribution that matches your ops constraints.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-platform-foundation.html b/src/main/webapp/blog/unomi-3-platform-foundation.html
index cc67d10..57243a3 100644
--- a/src/main/webapp/blog/unomi-3-platform-foundation.html
+++ b/src/main/webapp/blog/unomi-3-platform-foundation.html
@@ -3,6 +3,7 @@ title: Unomi 3 platform foundation
description: "What Unomi 3.0 changed under the hood — Java 17, Karaf 4.4, Elasticsearch 9, and persistence-based clustering without Cellar or Hazelcast."
keywords: "Unomi 3 platform, Java 17, Karaf 4.4, UNOMI-877, persistence clustering, Elasticsearch 9"
layout: default
+date: 2026-06-27 09:45:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Platform</p>
<h1>Unomi 3 platform foundation</h1>
<p class="lead">The 3.0 runtime floor — Java 17, Karaf 4.4, Elasticsearch 9, and clustering without Cellar or Hazelcast.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-request-tracing.html b/src/main/webapp/blog/unomi-3-request-tracing.html
index faf1858..b1513e5 100644
--- a/src/main/webapp/blog/unomi-3-request-tracing.html
+++ b/src/main/webapp/blog/unomi-3-request-tracing.html
@@ -3,6 +3,7 @@ title: Request tracing with explain=true in Unomi 3
description: "Debug context and eventcollector requests with explain=true — admin-gated requestTracing trees, verified curl examples, and what 403 means for public API keys."
keywords: "Unomi explain, requestTracing, Unomi tracing, UNOMI-873, eventcollector explain, context.json explain"
layout: default
+date: 2026-07-05 13:23:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Debugging</p>
<h1>Request tracing with <code>explain=true</code></h1>
<p class="lead">See condition evaluations, rule actions, and timings on <code>/cxs/context.json</code> and <code>/cxs/eventcollector</code>.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-shell-commands.html b/src/main/webapp/blog/unomi-3-shell-commands.html
index 83497da..73a874d 100644
--- a/src/main/webapp/blog/unomi-3-shell-commands.html
+++ b/src/main/webapp/blog/unomi-3-shell-commands.html
@@ -3,6 +3,7 @@ title: Unomi 3 Karaf shell commands
description: "Unomi 3 expands the unomi:* Karaf shell — unified unomi:crud, tenant session context, cache ops, task scheduler commands, and list-invalid-objects (UNOMI-879 / 880)."
keywords: "Unomi shell, unomi:crud, Karaf shell, unomi:cache, unomi:task-list, tenant-set, UNOMI-879, UNOMI-880"
layout: default
+date: 2026-07-01 11:59:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Operator experience</p>
<h1>Karaf shell commands in Unomi 3</h1>
<p class="lead"><code>unomi:crud</code>, tenant session context, cache tools, and task commands — operate without leaving SSH.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-task-scheduler.html b/src/main/webapp/blog/unomi-3-task-scheduler.html
index 47be3ac..648a754 100644
--- a/src/main/webapp/blog/unomi-3-task-scheduler.html
+++ b/src/main/webapp/blog/unomi-3-task-scheduler.html
@@ -3,6 +3,7 @@ title: Cluster-aware task scheduler in Unomi 3.1
description: "Unomi 3.1 durable task scheduler — full capability list: persistence, cluster locks, lifecycle, fluent builder, REST ops, shell, metrics, resume, and built-in jobs."
keywords: "Unomi task scheduler, /cxs/tasks, unomi:task-list, Unomi 3.1, profile-purge, cluster tasks, TaskExecutor"
layout: default
+date: 2026-07-03 12:16:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3.1 · Operations</p>
<h1>Cluster-aware task scheduler</h1>
<p class="lead">Durable background work with persistence, locks, retry/resume, REST, shell, and a plugin-friendly fluent API.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/unomi-3-unit-testing-harness.html b/src/main/webapp/blog/unomi-3-unit-testing-harness.html
index 9e4135b..2b09332 100644
--- a/src/main/webapp/blog/unomi-3-unit-testing-harness.html
+++ b/src/main/webapp/blog/unomi-3-unit-testing-harness.html
@@ -3,6 +3,7 @@ title: Faster Unomi service unit tests — InMemoryPersistenceServiceImpl
description: "How Unomi 3’s in-memory PersistenceService test harness lets Profile, Event, Rules, and Segment services run real unit tests in seconds without Karaf or Elasticsearch."
keywords: "Unomi unit tests, InMemoryPersistenceServiceImpl, UNOMI-881, Unomi TestHelper, Surefire"
layout: default
+date: 2026-07-07 09:30:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Unomi 3 · Quality</p>
<h1>Faster service unit tests</h1>
<p class="lead"><code>InMemoryPersistenceServiceImpl</code> — a full PersistenceService on the test classpath so service logic no longer waits on Karaf.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
diff --git a/src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html b/src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html
index 380ce95..0e815b4 100644
--- a/src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html
+++ b/src/main/webapp/blog/welcome-to-the-apache-unomi-blog.html
@@ -3,6 +3,7 @@ title: Welcome to the Apache Unomi Blog
description: "The Apache Unomi project launches an official blog — Unomi 3 deep dives, AI/CDP guidance, and community updates."
keywords: "Apache Unomi blog, Unomi 3, community"
layout: default
+date: 2026-06-17 09:10:00 +0000
---
<section class="page-header">
@@ -10,6 +11,12 @@ layout: default
<p class="section-label text-hero-label">Blog</p>
<h1>Welcome to the Apache Unomi Blog</h1>
<p class="lead">Longer-form writing for Unomi 3, AI/CDP builders, and the community.</p>
+ {% if page.date %}
+ <p class="small text-muted mt-2 mb-0">
+ <time datetime="{{ page.date | date_to_xmlschema }}">Published {{ page.date | date: "%B %d, %Y at %H:%M UTC" }}</time>
+ </p>
+ {% endif %}
+
</div>
</section>
<section class="section">
diff --git a/src/main/webapp/sitemap.xml b/src/main/webapp/sitemap.xml
index e2030eb..baf988f 100644
--- a/src/main/webapp/sitemap.xml
+++ b/src/main/webapp/sitemap.xml
@@ -245,6 +245,11 @@
<priority>0.75</priority>
</url>
<url>
+ <url>
+ <loc>https://unomi.apache.org/blog/unomi-3-in-numbers.html</loc>
+ <changefreq>monthly</changefreq>
+ <priority>0.85</priority>
+ </url>
<loc>https://unomi.apache.org/blog/unomi-3-shell-commands.html</loc>
<changefreq>monthly</changefreq>
<priority>0.8</priority>
(unomi-site) 03/05: Fix shell blog examples to match live Unomi 3 CRUD syntax (UNOMI-932)
Posted by sh...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
sergehuber pushed a commit to branch UNOMI-932-unomi3-major-release-story
in repository https://gitbox.apache.org/repos/asf/unomi-site.git
commit c695e4db506269e574a5cb3d7dcb3558eb607481
Author: Serge Huber <sh...@apache.org>
AuthorDate: Thu Jul 16 11:46:43 2026 +0200
Fix shell blog examples to match live Unomi 3 CRUD syntax (UNOMI-932)
Expand profile/session/event walkthroughs, drop removed classic commands, and add a compact Blog "New" nav badge.
---
src/main/webapp/_layouts/default.html | 4 +-
src/main/webapp/assets/css/unomi.css | 24 +++++
src/main/webapp/blog/unomi-3-shell-commands.html | 125 +++++++++++++++++++----
3 files changed, 133 insertions(+), 20 deletions(-)
diff --git a/src/main/webapp/_layouts/default.html b/src/main/webapp/_layouts/default.html
index bc6aad3..194efe5 100644
--- a/src/main/webapp/_layouts/default.html
+++ b/src/main/webapp/_layouts/default.html
@@ -212,7 +212,9 @@
<a class="nav-link fw-medium" href="/get-started.html">Get Started</a>
</li>
<li class="nav-item">
- <a class="nav-link fw-medium" href="/blog/">Blog</a>
+ <a class="nav-link fw-medium" href="/blog/" aria-label="Blog (new)">
+ Blog<span class="nav-badge-new" aria-hidden="true">New</span>
+ </a>
</li>
<!-- Documentation Dropdown -->
diff --git a/src/main/webapp/assets/css/unomi.css b/src/main/webapp/assets/css/unomi.css
index 6e9de89..1a28f81 100644
--- a/src/main/webapp/assets/css/unomi.css
+++ b/src/main/webapp/assets/css/unomi.css
@@ -201,6 +201,30 @@ textarea:focus-visible,
background: var(--unomi-primary-light);
}
+/* Compact "New" indicator on nav items (e.g. Blog) */
+.nav-badge-new {
+ display: inline-block;
+ margin-left: 0.4rem;
+ padding: 0.15em 0.4em;
+ font-size: 0.6rem;
+ font-weight: 700;
+ letter-spacing: 0.05em;
+ line-height: 1;
+ vertical-align: 0.12em;
+ text-transform: uppercase;
+ color: var(--unomi-primary-dark);
+ background: var(--unomi-primary-light);
+ border: 1px solid var(--unomi-primary-border-light);
+ border-radius: 0.25rem;
+}
+
+.navbar-nav .nav-link:hover .nav-badge-new,
+.navbar-nav .nav-link.active .nav-badge-new {
+ color: var(--unomi-primary-dark);
+ background: var(--unomi-white);
+ border-color: var(--unomi-primary-border-light);
+}
+
.dropdown-menu {
min-width: 16rem;
border: 1px solid var(--unomi-border);
diff --git a/src/main/webapp/blog/unomi-3-shell-commands.html b/src/main/webapp/blog/unomi-3-shell-commands.html
index 1e1b6e8..148e6ed 100644
--- a/src/main/webapp/blog/unomi-3-shell-commands.html
+++ b/src/main/webapp/blog/unomi-3-shell-commands.html
@@ -50,30 +50,117 @@ layout: default
<pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>ssh -p 8102 karaf@localhost
# default user/pass: karaf/karaf (change etc/users.properties ASAP)
-unomi:<TAB> # list commands
-help unomi:crud
-help unomi:cache</code></pre>
+unomi:<TAB> # list commands
+unomi:crud help profile # type cheat-sheet (also: rule, session, event, tenant, ...)
+unomi:version
+unomi:cache --stats</code></pre>
<h2 class="h4 mt-5 mb-3">Tenant context first</h2>
- <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:tenant-set acme
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code># Create a tenant (generates public + private API keys)
+unomi:crud create tenant '{"itemId":"acme","name":"Acme Corp"}'
+unomi:crud list tenant
+
+unomi:tenant-set acme
unomi:tenant-get
# subsequent CRUD / cache commands use this tenant</code></pre>
<h2 class="h4 mt-5 mb-3">Unified CRUD</h2>
- <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:crud help rule
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code># Verbs: create | read | update | delete | list | help
+# Bodies are positional JSON or a file:// URL (not --file / -d flags)
+
+unomi:crud help rule
unomi:crud list rule --csv -n 50
unomi:crud read rule my-rule-id
-unomi:crud create rule --file /tmp/rule.json
-unomi:crud update rule my-rule-id -d='{"itemId":"my-rule-id","enabled":false}'
+
+# Rules use metadata for name/enabled (not top-level name/enabled)
+unomi:crud create rule file:///tmp/rule.json
+unomi:crud create rule '{"itemId":"my-rule-id","metadata":{"id":"my-rule-id","name":"My rule","enabled":true},"condition":{"type":"matchAllCondition","parameterValues":{}},"actions":[]}'
+unomi:crud update rule my-rule-id '{"itemId":"my-rule-id","metadata":{"id":"my-rule-id","name":"My rule","enabled":false},"condition":{"type":"matchAllCondition","parameterValues":{}},"actions":[]}'
unomi:crud delete rule my-rule-id
-unomi:crud list tenant
-unomi:crud create apikey -d='{"tenantId":"acme","keyType":"PRIVATE"}'
+unomi:crud create apikey '{"tenantId":"acme","keyType":"PRIVATE"}'
+# plaintext key is printed once — store it immediately
+
unomi:crud list profile -n 20
unomi:crud list schema # when json-schema extension is present</code></pre>
<h3 class="h6 mt-4 mb-2">Object types registered for <code>unomi:crud</code></h3>
<p class="small text-muted"><code>actiontype</code>, <code>apikey</code>, <code>campaign</code>, <code>campaignevent</code>, <code>conditiontype</code>, <code>consent</code>, <code>event</code>, <code>goal</code>, <code>persona</code>, <code>profile</code>, <code>profilealias</code>, <code>propertytype</code>, <code>rule</code>, <code>rulestats</code>, <code>scope</code>, <code>scoring</code>, <code>segment</code>, <code>session</code>, <code>tenant</code>, <code>topic</code>, pl [...]
+ <p class="small text-muted mb-0">Use <code>unomi:crud help <type></code> for the property cheat-sheet of that type (required fields, optional maps, common event types).</p>
+
+ <h2 class="h4 mt-5 mb-3">Profiles, sessions, and events</h2>
+ <p>Day-to-day operator work often means inspecting or patching customer data in a tenant.
+ Set the tenant once, then use the same <code>unomi:crud</code> verbs on <code>profile</code>, <code>session</code>, and <code>event</code>.</p>
+
+ <h3 class="h6 mt-4 mb-2">Profiles</h3>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code># Discover shape + recent profiles (sorted by lastUpdated / lastVisit)
+unomi:crud help profile
+unomi:crud list profile -n 20
+unomi:crud list profile --csv -n 50
+
+# Full JSON dump of one profile
+unomi:crud read profile PROFILE_ID
+
+# Create (top-level keys become profile properties; itemId is the profile id)
+unomi:crud create profile '{"itemId":"demo-ada","firstName":"Ada","lastName":"Lovelace","email":"ada@example.com"}'
+
+# Or from a file
+unomi:crud create profile file:///tmp/profile-ada.json
+
+# Update replaces the profile properties map with the JSON you pass
+# (include every property you want to keep)
+unomi:crud update profile demo-ada '{"firstName":"Ada","lastName":"Lovelace","email":"ada@apache.org","company":"Analytical Engines"}'
+
+# Remove
+unomi:crud delete profile demo-ada</code></pre>
+ <p class="small text-muted">There are no separate <code>profile-list</code> / <code>profile-view</code> commands in Unomi 3 — use <code>unomi:crud list|read|delete profile</code>.</p>
+
+ <h3 class="h6 mt-4 mb-2">Sessions</h3>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:crud help session
+unomi:crud list session -n 20
+unomi:crud read session SESSION_ID
+
+# Create a session bound to a profile (ISO-8601 timestamps)
+unomi:crud create session '{"itemId":"demo-session-1","profileId":"demo-ada","scope":"myscope","timeStamp":"2026-07-15T10:00:00Z","properties":{"origin":"shell-demo"}}'
+
+# Update session metadata / properties (full session document)
+unomi:crud update session demo-session-1 '{"itemId":"demo-session-1","profileId":"demo-ada","scope":"myscope","timeStamp":"2026-07-15T10:00:00Z","lastEventDate":"2026-07-15T10:05:00Z","properties":{"origin":"shell-demo","channel":"web"}}'
+
+unomi:crud delete session demo-session-1</code></pre>
+ <p class="small text-muted">Required fields for create: <code>itemId</code>, <code>profileId</code>, <code>timeStamp</code>, <code>scope</code>. Use <code>unomi:crud list|read session</code> (the old <code>session-list</code> / <code>session-view</code> commands are gone).</p>
+
+ <h3 class="h6 mt-4 mb-2">Events</h3>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:crud help event
+unomi:crud list event -n 50
+unomi:crud read event EVENT_ID
+
+# Send / persist a view event (create goes through EventService.send)
+unomi:crud create event '{"itemId":"demo-event-1","eventType":"view","scope":"myscope","profileId":"demo-ada","sessionId":"demo-session-1","source":{"itemType":"site","scope":"myscope","itemId":"mysite"},"target":{"itemType":"page","scope":"myscope","itemId":"homepage"},"properties":{"pageInfo":{"pagePath":"/home"}},"persistent":true}'
+
+# Re-send / update the same event id with new properties
+unomi:crud update event demo-event-1 '{"itemId":"demo-event-1","eventType":"view","scope":"myscope","profileId":"demo-ada","sessionId":"demo-session-1","source":{"itemType":"site","scope":"myscope","itemId":"mysite"},"target":{"itemType":"page","scope":"myscope","itemId":"checkout"},"properties":{"pageInfo":{"pagePath":"/checkout"}},"persistent":true}'
+
+unomi:crud delete event demo-event-1
+
+# Prefer file:// for larger payloads
+unomi:crud create event file:///tmp/view-event.json</code></pre>
+ <p class="small text-muted">Common <code>eventType</code> values include <code>view</code>, <code>form</code>, <code>login</code>, <code>identify</code>, <code>modifyConsent</code>, <code>sessionCreated</code>, <code>profileUpdated</code>.
+ For live traffic use <code>unomi:event-tail</code>; for history use <code>unomi:crud list|read event</code> (legacy <code>event-list</code> / <code>event-search</code> were replaced by CRUD).</p>
+
+ <h3 class="h6 mt-4 mb-2">Typical inspect loop</h3>
+ <pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:tenant-set acme
+
+# Who showed up recently?
+unomi:crud list profile -n 10
+
+# Open one profile, then its latest sessions / events
+unomi:crud read profile demo-ada
+unomi:crud list session -n 10
+unomi:crud list event -n 20
+
+# Live: watch events and rule hits while you reproduce in the browser
+unomi:event-tail
+unomi:rule-tail</code></pre>
<h2 class="h4 mt-5 mb-3">Cache</h2>
<pre class="code-block-light p-3 rounded-3 small overflow-auto"><code>unomi:cache --stats
@@ -81,8 +168,8 @@ unomi:cache --stats --detailed --tenant acme
unomi:cache --stats --type profile --csv
unomi:cache --clear --tenant acme
unomi:cache --inspect
-unomi:cache --view --id ENTRY_ID --type … --tenant acme
-unomi:cache --remove --id ENTRY_ID --type … --tenant acme
+unomi:cache --view --id ENTRY_ID --type TYPE --tenant acme
+unomi:cache --remove --id ENTRY_ID --type TYPE --tenant acme
unomi:cache --watch 5</code></pre>
<h2 class="h4 mt-5 mb-3">Scheduler (shell twin of REST)</h2>
@@ -95,16 +182,16 @@ unomi:task-purge --days 14 --force
unomi:task-executor</code></pre>
<h2 class="h4 mt-5 mb-3">Still there: live debugging & lifecycle</h2>
+ <p>Dedicated list/view/remove commands for profiles, sessions, events, rules, segments, actions, and conditions were folded into <code>unomi:crud</code>.
+ What remains as first-class commands:</p>
<ul>
- <li><code>rule-list|view|remove|reset-stats|tail|watch</code></li>
- <li><code>event-tail|view|list|search</code></li>
- <li><code>action-list|view</code>, <code>condition-list|view</code></li>
- <li><code>profile-list|view|remove</code>, <code>segment-*</code>, <code>session-*</code></li>
- <li><code>list-invalid-objects</code></li>
- <li><code>deploy-definition</code> / <code>undeploy-definition</code></li>
- <li><code>setup</code>, <code>migrate</code>, <code>start</code>, <code>stop</code>, <code>version</code></li>
+ <li><code>unomi:rule-reset-stats</code>, <code>unomi:rule-tail</code>, <code>unomi:rule-watch RULE_ID…</code></li>
+ <li><code>unomi:event-tail</code> (live stream; Ctrl+C to stop)</li>
+ <li><code>unomi:list-invalid-objects</code></li>
+ <li><code>unomi:deploy-definition</code> / <code>unomi:undeploy-definition</code></li>
+ <li><code>unomi:setup</code>, <code>unomi:migrate</code>, <code>unomi:start</code>, <code>unomi:stop</code>, <code>unomi:version</code></li>
</ul>
- <p>Many day-to-day inspect/edit flows now go through <code>unomi:crud</code>; the dedicated list/view/remove commands remain useful for scripting habits and live tails.</p>
+ <p>Day-to-day inspect/edit for profiles, sessions, events, rules, segments, and the rest goes through <code>unomi:crud</code>; use the tails when you need a live console feed.</p>
<p class="mt-4">
<a class="btn btn-primary" href="{{ site.data.unomi.manual.published_latest }}#_shell_commands">Manual: shell commands</a>