Enhance repo collateral and visuals

README.md

@@ -9,8 +9,36 @@ the installer deploys the selected tier on the target server.
 Technical buyer-facing collateral lives in `docs/` for reuse in customer
 evaluation, partner enablement, and internal technical review.
 
+- `docs/README.md`
 - `docs/Nexus_One_AI_Datasheet.docx`
 - `docs/Nexus_One_AI_Datasheet.pdf`
+- `docs/architecture-overview.svg`
+
+## Why Nexus One AI
+
+- Private AI platform designed for customer-controlled infrastructure.
+- Packaged stack for portal access, local inference, document retrieval, and observability.
+- Deployment paths for both bootable ISO installs and scripted Ubuntu server installs.
+- Tiered packaging that scales from contained pilots to larger multi-team deployments.
+- Stronger technical buyer story than a simple demo stack because admin, audit, backup, and readiness surfaces are included.
+
+## Architecture Snapshot
+
+![Nexus One AI architecture overview](docs/architecture-overview.svg)
+
+## Visual Overview
+
+### Package Positioning
+
+![Nexus One AI package overview](docs/nexus-one-ai-package-overview.jpg)
+
+### Opportunity View
+
+![Nexus One AI opportunity view](docs/nexus-one-ai-opportunity.jpg)
+
+### Tier Comparison
+
+![Nexus One AI tier comparison](docs/nexus-one-ai-tier-comparison.jpg)
 
 ## 1. Choose The Install Path
 

docs/README.md

@@ -0,0 +1,28 @@
+# Nexus One AI Docs
+
+This folder holds buyer-facing and partner-facing collateral for Nexus One AI.
+Use it when the repository needs to function as both installer source and
+technical handoff point.
+
+## Core Collateral
+
+| File | Purpose |
+|---|---|
+| `Nexus_One_AI_Datasheet.docx` | Editable technical buyer datasheet. |
+| `Nexus_One_AI_Datasheet.pdf` | Shareable PDF export of the technical buyer datasheet. |
+| `architecture-overview.svg` | Simple stack view for repo pages, partner notes, and internal explainers. |
+
+## Visuals
+
+| File | Use |
+|---|---|
+| `nexus-one-ai-package-overview.jpg` | High-level package positioning visual. |
+| `nexus-one-ai-opportunity.jpg` | Business/problem framing visual. |
+| `nexus-one-ai-tier-comparison.jpg` | Tier and hardware comparison visual. |
+
+## Suggested Usage
+
+- Start with the main repo `README.md` for installation and deployment paths.
+- Use the datasheet for technical buyer review and partner follow-up.
+- Use the visuals in proposal notes, partner onboarding, and internal solutioning.
+

docs/architecture-overview.svg

@@ -0,0 +1,105 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-labelledby="title desc">
+  <title id="title">Nexus One AI Architecture Overview</title>
+  <desc id="desc">High level view of Nexus One AI components from users through portal, services, and infrastructure.</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" x2="1" y1="0" y2="1">
+      <stop offset="0%" stop-color="#14213D"/>
+      <stop offset="100%" stop-color="#1F2F57"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="10" stdDeviation="18" flood-color="#091224" flood-opacity="0.28"/>
+    </filter>
+    <style>
+      .label { font: 700 18px Arial, sans-serif; letter-spacing: 0.08em; fill: #1BC5BD; }
+      .title { font: 700 58px Arial, sans-serif; fill: #F8FAFC; }
+      .subtitle { font: 400 24px Arial, sans-serif; fill: #CBD5E1; }
+      .boxTitle { font: 700 28px Arial, sans-serif; fill: #F8FAFC; }
+      .boxText { font: 400 20px Arial, sans-serif; fill: #D8E0EA; }
+      .pill { font: 700 18px Arial, sans-serif; fill: #E6FFFB; }
+      .small { font: 400 18px Arial, sans-serif; fill: #9FB1C7; }
+    </style>
+  </defs>
+
+  <rect width="1600" height="900" fill="url(#bg)"/>
+
+  <text x="90" y="92" class="label">NEXUS ONE AI · ARCHITECTURE OVERVIEW</text>
+  <text x="90" y="170" class="title">Private AI Platform On Customer-Controlled Infrastructure</text>
+  <text x="90" y="215" class="subtitle">Portal, inference, retrieval, administration, and observability packaged for on-premises deployment.</text>
+
+  <g filter="url(#shadow)">
+    <rect x="90" y="300" rx="26" ry="26" width="320" height="210" fill="#243B67" stroke="#36598C" stroke-width="2"/>
+    <text x="120" y="350" class="boxTitle">Users & Review Teams</text>
+    <text x="120" y="395" class="boxText">Admins</text>
+    <text x="120" y="430" class="boxText">Department Users</text>
+    <text x="120" y="465" class="boxText">Procurement / IT / Security</text>
+  </g>
+
+  <g filter="url(#shadow)">
+    <rect x="490" y="270" rx="26" ry="26" width="370" height="270" fill="#1A6B6A" stroke="#29B9B3" stroke-width="2"/>
+    <text x="525" y="325" class="boxTitle">Portal & Access Layer</text>
+    <text x="525" y="372" class="boxText">Nexus One AI Portal</text>
+    <text x="525" y="407" class="boxText">Open WebUI</text>
+    <text x="525" y="442" class="boxText">Authentication / Sessions</text>
+    <text x="525" y="477" class="boxText">Prompt Workflows / Admin UI</text>
+  </g>
+
+  <g filter="url(#shadow)">
+    <rect x="930" y="255" rx="26" ry="26" width="285" height="190" fill="#314873" stroke="#4A6698" stroke-width="2"/>
+    <text x="960" y="308" class="boxTitle">Inference</text>
+    <text x="960" y="353" class="boxText">Ollama</text>
+    <text x="960" y="388" class="boxText">Local Model Catalog</text>
+  </g>
+
+  <g filter="url(#shadow)">
+    <rect x="930" y="475" rx="26" ry="26" width="285" height="190" fill="#314873" stroke="#4A6698" stroke-width="2"/>
+    <text x="960" y="528" class="boxTitle">Knowledge Retrieval</text>
+    <text x="960" y="573" class="boxText">ChromaDB</text>
+    <text x="960" y="608" class="boxText">Upload / RAG Pipeline</text>
+  </g>
+
+  <g filter="url(#shadow)">
+    <rect x="1280" y="220" rx="26" ry="26" width="230" height="220" fill="#243B67" stroke="#36598C" stroke-width="2"/>
+    <text x="1310" y="274" class="boxTitle">Control Plane</text>
+    <text x="1310" y="320" class="boxText">FastAPI Backend</text>
+    <text x="1310" y="355" class="boxText">Audit / Backup</text>
+    <text x="1310" y="390" class="boxText">Settings / Licensing</text>
+  </g>
+
+  <g filter="url(#shadow)">
+    <rect x="1280" y="495" rx="26" ry="26" width="230" height="170" fill="#243B67" stroke="#36598C" stroke-width="2"/>
+    <text x="1310" y="548" class="boxTitle">Observability</text>
+    <text x="1310" y="593" class="boxText">Grafana / Prometheus</text>
+    <text x="1310" y="628" class="boxText">GPU & System Metrics</text>
+  </g>
+
+  <g filter="url(#shadow)">
+    <rect x="490" y="640" rx="26" ry="26" width="1020" height="155" fill="#0F1A31" stroke="#273A60" stroke-width="2"/>
+    <text x="525" y="695" class="boxTitle">Deployment Substrate</text>
+    <text x="525" y="735" class="boxText">Ubuntu 22.04 • Bootable ISO or Scripted Installer • CPU or NVIDIA GPU Infrastructure • Internal Network / Air-Gapped Friendly</text>
+  </g>
+
+  <line x1="410" y1="405" x2="490" y2="405" stroke="#6EE7E0" stroke-width="6" stroke-linecap="round"/>
+  <polygon points="490,405 468,392 468,418" fill="#6EE7E0"/>
+
+  <line x1="860" y1="360" x2="930" y2="350" stroke="#6EE7E0" stroke-width="6" stroke-linecap="round"/>
+  <polygon points="930,350 906,341 910,366" fill="#6EE7E0"/>
+
+  <line x1="860" y1="450" x2="930" y2="560" stroke="#6EE7E0" stroke-width="6" stroke-linecap="round"/>
+  <polygon points="930,560 907,548 928,533" fill="#6EE7E0"/>
+
+  <line x1="1215" y1="340" x2="1280" y2="330" stroke="#6EE7E0" stroke-width="6" stroke-linecap="round"/>
+  <polygon points="1280,330 1256,321 1260,346" fill="#6EE7E0"/>
+
+  <line x1="1215" y1="565" x2="1280" y2="580" stroke="#6EE7E0" stroke-width="6" stroke-linecap="round"/>
+  <polygon points="1280,580 1256,567 1251,591" fill="#6EE7E0"/>
+
+  <line x1="675" y1="540" x2="675" y2="640" stroke="#6EE7E0" stroke-width="6" stroke-linecap="round"/>
+  <polygon points="675,640 662,616 688,616" fill="#6EE7E0"/>
+
+  <line x1="1070" y1="665" x2="1070" y2="445" stroke="#314873" stroke-width="3" stroke-dasharray="8 10"/>
+  <line x1="1390" y1="665" x2="1390" y2="440" stroke="#314873" stroke-width="3" stroke-dasharray="8 10"/>
+
+  <rect x="92" y="820" rx="18" ry="18" width="248" height="42" fill="#1B8F88"/>
+  <text x="132" y="848" class="pill">PRIVATE AI · PACKAGED STACK</text>
+  <text x="1240" y="848" class="small">Powered by Cezen</text>
+</svg>