DOC-3498: tinymceai on-prem documentation.

Author: kemister85

-scripts/render-mermaid.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+#
+# Re-renders all .mmd Mermaid sources to .svg in the on-premises images folder.
+#
+# Usage (from repo root):
+#   ./-scripts/render-mermaid.sh
+#
+# Requirements:
+#   Node.js (npx downloads @mermaid-js/mermaid-cli automatically)
+#
+set -euo pipefail
+
+DIAGRAM_DIR="modules/ROOT/images/tinymceai-on-premises"
+CONFIG_FILE=$(mktemp)
+
+cat > "$CONFIG_FILE" << 'JSON'
+{
+  "htmlLabels": false,
+  "flowchart": { "htmlLabels": false, "useMaxWidth": true },
+  "sequence": { "useMaxWidth": true },
+  "theme": "default"
+}
+JSON
+
+trap 'rm -f "$CONFIG_FILE"' EXIT
+
+count=0
+for mmd in "$DIAGRAM_DIR"/*.mmd; do
+  [ -f "$mmd" ] || continue
+  svg="${mmd%.mmd}.svg"
+  name=$(basename "$mmd")
+  printf "  Rendering %s\n" "$name"
+  npx -y @mermaid-js/mermaid-cli -i "$mmd" -o "$svg" \
+    -c "$CONFIG_FILE" --backgroundColor white 2>/dev/null
+
+  # Mermaid outputs width="100%" which has no intrinsic size in <img> tags.
+  # Replace with the actual pixel width from the viewBox so browsers can
+  # calculate the correct aspect ratio when the page scales the image.
+  vb_width=$(grep -o 'viewBox="[^"]*"' "$svg" | head -1 | awk -F'[ "]' '{print $4}')
+  if [ -n "$vb_width" ]; then
+    vb_int=$(printf "%.0f" "$vb_width")
+    perl -i -pe "s/width=\"100%\"/width=\"${vb_int}\"/" "$svg"
+  fi
+
+  count=$((count + 1))
+done
+
+printf "\nRendered %d diagrams in %s\n" "$count" "$DIAGRAM_DIR"

modules/ROOT/images/tinymceai-on-premises/advanced-scenarios-fig-1.mmd

@@ -0,0 +1,4 @@
+flowchart LR
+    Editor[TinyMCE editor] <-->|chat / quick actions| AI[AI Service]
+    AI -->|MCP tools/call| MCP[MCP Server<br>knowledge-hub]
+    MCP -->|read| KB[Confluence ·<br>Notion ·<br>GitBook ·<br>internal wiki]

modules/ROOT/images/tinymceai-on-premises/advanced-scenarios-fig-1.svg

@@ -0,0 +1,14 @@
+flowchart LR
+    subgraph Tenants[Your SaaS customers]
+        CA[Customer A users]
+        CB[Customer B users]
+        CC[Customer C users]
+    end
+    subgraph AISvc[Single AI service deployment]
+        EA[Environment A<br>access keys A<br>isolated conversations]
+        EB[Environment B<br>access keys B<br>isolated conversations]
+        EC[Environment C<br>access keys C<br>isolated conversations]
+    end
+    CA --> EA --> OpenAI[OpenAI]
+    CB --> EB --> Anthropic[Anthropic]
+    CC --> EC --> Azure[Azure OpenAI]

modules/ROOT/images/tinymceai-on-premises/advanced-scenarios-fig-2.mmd

@@ -0,0 +1,8 @@
+flowchart LR
+    Lawyer[TinyMCE editor<br>used by lawyer] <--> AI[AI Service]
+    AI -->|tools/call| MCP1[MCP: contract-db]
+    AI -->|tools/call| MCP2[MCP: compliance-checker]
+    AI -->|tools/call| MCP3[MCP: precedent-search]
+    MCP1 --> ContractDB[(Contract clause<br>repository)]
+    MCP2 --> ComplianceRules[(Regulatory<br>rule sets)]
+    MCP3 --> PrecedentIdx[(Precedent<br>search index)]

modules/ROOT/images/tinymceai-on-premises/advanced-scenarios-fig-2.svg

@@ -0,0 +1,42 @@
+flowchart TB
+    Browser["Browser<br>TinyMCE editor + tinymceai plugin"]
+    TokenEP["Your token endpoint<br>signs HS256 JWTs"]
+    Browser -->|"fetch JWT"| TokenEP
+    Browser -->|"HTTPS + Bearer JWT"| LB
+
+    subgraph App["Application layer (stateless, N replicas)"]
+        LB["Reverse proxy / Load balancer<br>nginx · ALB · K8s Ingress<br>TLS termination · SSE pass-through"]
+        AI1["ai-service replica 1"]
+        AI2["ai-service replica 2"]
+        AIN["ai-service replica N"]
+        LB --> AI1
+        LB --> AI2
+        LB --> AIN
+    end
+
+    subgraph Data["Shared data layer"]
+        DB[("SQL database<br>MySQL 8.0+ or<br>PostgreSQL 13+")]
+        Cache[("Redis 3.2.6+<br>single node or cluster")]
+        Storage[("File storage<br>database · filesystem ·<br>S3 · Azure Blob")]
+    end
+
+    AI1 --> DB
+    AI1 --> Cache
+    AI1 --> Storage
+    AI2 --> DB
+    AI2 --> Cache
+    AI2 --> Storage
+    AIN --> DB
+    AIN --> Cache
+    AIN --> Storage
+
+    AI1 -->|HTTPS| LLM["LLM provider<br>OpenAI · Anthropic · Google ·<br>Azure · Bedrock · Vertex · self-hosted"]
+    AI2 -->|HTTPS| LLM
+    AIN -->|HTTPS| LLM
+
+    AI1 -.-> Obs["OpenTelemetry · Langfuse ·<br>log aggregator"]
+    AI2 -.-> Obs
+    AIN -.-> Obs
+
+    AI1 -.->|tool calls| MCP["MCP servers<br>internal knowledge bases"]
+    AI2 -.-> MCP