e6685203fe
- Added REPO_INVENTORY.md with all repos, branches, remotes, and staging info - Added .gitignore - Synced all existing docs from local workspace - Centralized documentation hub for GrowQR team
651 lines
19 KiB
HTML
651 lines
19 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>GrowQR — System Architecture</title>
|
|
<style>
|
|
:root {
|
|
--bg: #0b0f17;
|
|
--surface: #111827;
|
|
--surface-2: #1a2332;
|
|
--border: #1f2d3d;
|
|
--border-light: #2d3f54;
|
|
--text: #e2e8f0;
|
|
--text-dim: #94a3b8;
|
|
--accent-blue: #60a5fa;
|
|
--accent-purple: #a78bfa;
|
|
--accent-green: #34d399;
|
|
--accent-amber: #fbbf24;
|
|
--accent-rose: #fb7185;
|
|
--accent-cyan: #22d3ee;
|
|
--line: #334155;
|
|
--line-active: #60a5fa;
|
|
}
|
|
|
|
* { box-sizing: border-box; margin: 0; padding: 0; }
|
|
|
|
body {
|
|
background: var(--bg);
|
|
color: var(--text);
|
|
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
|
|
min-height: 100vh;
|
|
display: flex;
|
|
flex-direction: column;
|
|
align-items: center;
|
|
padding: 48px 24px 80px;
|
|
}
|
|
|
|
header {
|
|
text-align: center;
|
|
margin-bottom: 48px;
|
|
}
|
|
|
|
header h1 {
|
|
font-size: 2.4rem;
|
|
font-weight: 700;
|
|
letter-spacing: -0.03em;
|
|
margin-bottom: 8px;
|
|
}
|
|
|
|
header h1 span {
|
|
background: linear-gradient(135deg, var(--accent-blue), var(--accent-purple));
|
|
-webkit-background-clip: text;
|
|
-webkit-text-fill-color: transparent;
|
|
background-clip: text;
|
|
}
|
|
|
|
header p {
|
|
color: var(--text-dim);
|
|
font-size: 1.05rem;
|
|
}
|
|
|
|
.legend {
|
|
display: flex;
|
|
gap: 24px;
|
|
flex-wrap: wrap;
|
|
justify-content: center;
|
|
margin-bottom: 40px;
|
|
}
|
|
|
|
.legend-item {
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 8px;
|
|
font-size: 0.85rem;
|
|
color: var(--text-dim);
|
|
}
|
|
|
|
.legend-dot {
|
|
width: 12px;
|
|
height: 12px;
|
|
border-radius: 3px;
|
|
}
|
|
|
|
.diagram-wrapper {
|
|
position: relative;
|
|
width: 100%;
|
|
max-width: 1200px;
|
|
background: var(--surface);
|
|
border: 1px solid var(--border);
|
|
border-radius: 16px;
|
|
padding: 48px 40px 56px;
|
|
box-shadow: 0 20px 60px rgba(0,0,0,0.4);
|
|
}
|
|
|
|
/* SVG arrows layer */
|
|
.arrows-svg {
|
|
position: absolute;
|
|
top: 0;
|
|
left: 0;
|
|
width: 100%;
|
|
height: 100%;
|
|
pointer-events: none;
|
|
z-index: 0;
|
|
}
|
|
|
|
.arrows-svg path {
|
|
fill: none;
|
|
stroke: var(--line);
|
|
stroke-width: 1.5;
|
|
transition: stroke 0.3s;
|
|
}
|
|
|
|
.arrows-svg marker path {
|
|
fill: var(--line);
|
|
stroke: none;
|
|
transition: fill 0.3s;
|
|
}
|
|
|
|
/* Grid layout */
|
|
.grid {
|
|
position: relative;
|
|
z-index: 1;
|
|
display: grid;
|
|
grid-template-columns: 280px 1fr 280px;
|
|
grid-template-rows: auto auto auto auto;
|
|
gap: 36px 48px;
|
|
align-items: start;
|
|
}
|
|
|
|
.col-left { grid-column: 1; }
|
|
.col-center { grid-column: 2; }
|
|
.col-right { grid-column: 3; }
|
|
|
|
.row-1 { grid-row: 1; }
|
|
.row-2 { grid-row: 2; }
|
|
.row-3 { grid-row: 3; }
|
|
.row-4 { grid-row: 4; }
|
|
|
|
/* Group (cluster) boxes */
|
|
.group {
|
|
border: 1px solid var(--border-light);
|
|
border-radius: 12px;
|
|
padding: 20px 20px 16px;
|
|
position: relative;
|
|
background: rgba(17,24,39,0.7);
|
|
backdrop-filter: blur(4px);
|
|
}
|
|
|
|
.group-label {
|
|
position: absolute;
|
|
top: -10px;
|
|
left: 16px;
|
|
background: var(--surface);
|
|
padding: 0 10px;
|
|
font-size: 0.7rem;
|
|
font-weight: 700;
|
|
text-transform: uppercase;
|
|
letter-spacing: 0.08em;
|
|
color: var(--text-dim);
|
|
border-radius: 4px;
|
|
}
|
|
|
|
/* Node cards */
|
|
.node {
|
|
background: var(--surface-2);
|
|
border: 1px solid var(--border);
|
|
border-radius: 10px;
|
|
padding: 16px 18px;
|
|
transition: transform 0.2s, border-color 0.2s, box-shadow 0.2s;
|
|
cursor: default;
|
|
}
|
|
|
|
.node:hover {
|
|
transform: translateY(-2px);
|
|
border-color: var(--border-light);
|
|
box-shadow: 0 8px 24px rgba(0,0,0,0.3);
|
|
}
|
|
|
|
.node h3 {
|
|
font-size: 0.95rem;
|
|
font-weight: 600;
|
|
margin-bottom: 10px;
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 8px;
|
|
}
|
|
|
|
.node h3 .icon {
|
|
width: 22px;
|
|
height: 22px;
|
|
border-radius: 5px;
|
|
display: inline-flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
font-size: 0.75rem;
|
|
}
|
|
|
|
.node ul {
|
|
list-style: none;
|
|
font-size: 0.82rem;
|
|
color: var(--text-dim);
|
|
line-height: 1.7;
|
|
}
|
|
|
|
.node ul li {
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 8px;
|
|
}
|
|
|
|
.node ul li::before {
|
|
content: "";
|
|
width: 5px;
|
|
height: 5px;
|
|
border-radius: 50%;
|
|
background: var(--text-dim);
|
|
opacity: 0.5;
|
|
flex-shrink: 0;
|
|
}
|
|
|
|
.node .meta {
|
|
margin-top: 10px;
|
|
padding-top: 10px;
|
|
border-top: 1px solid var(--border);
|
|
font-size: 0.75rem;
|
|
color: var(--text-dim);
|
|
display: flex;
|
|
justify-content: space-between;
|
|
}
|
|
|
|
/* Color accents */
|
|
.accent-blue { color: var(--accent-blue); }
|
|
.accent-purple { color: var(--accent-purple); }
|
|
.accent-green { color: var(--accent-green); }
|
|
.accent-amber { color: var(--accent-amber); }
|
|
.accent-rose { color: var(--accent-rose); }
|
|
.accent-cyan { color: var(--accent-cyan); }
|
|
|
|
.bg-blue { background: rgba(96,165,250,0.12); }
|
|
.bg-purple { background: rgba(167,139,250,0.12); }
|
|
.bg-green { background: rgba(52,211,153,0.12); }
|
|
.bg-amber { background: rgba(251,191,36,0.12); }
|
|
.bg-rose { background: rgba(251,113,133,0.12); }
|
|
.bg-cyan { background: rgba(34,211,238,0.12); }
|
|
|
|
.border-blue { border-color: rgba(96,165,250,0.25); }
|
|
.border-purple { border-color: rgba(167,139,250,0.25); }
|
|
.border-green { border-color: rgba(52,211,153,0.25); }
|
|
.border-amber { border-color: rgba(251,191,36,0.25); }
|
|
.border-rose { border-color: rgba(251,113,133,0.25); }
|
|
.border-cyan { border-color: rgba(34,211,238,0.25); }
|
|
|
|
/* Special large center node */
|
|
.node-center {
|
|
text-align: center;
|
|
padding: 24px 28px;
|
|
}
|
|
|
|
.node-center h3 {
|
|
justify-content: center;
|
|
font-size: 1.1rem;
|
|
margin-bottom: 14px;
|
|
}
|
|
|
|
.node-center .sub-nodes {
|
|
display: flex;
|
|
gap: 12px;
|
|
justify-content: center;
|
|
flex-wrap: wrap;
|
|
}
|
|
|
|
.sub-node {
|
|
background: var(--surface);
|
|
border: 1px solid var(--border);
|
|
border-radius: 8px;
|
|
padding: 10px 16px;
|
|
font-size: 0.8rem;
|
|
font-weight: 500;
|
|
color: var(--text-dim);
|
|
}
|
|
|
|
/* DB bar */
|
|
.db-bar {
|
|
grid-column: 1 / -1;
|
|
justify-self: center;
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 16px;
|
|
background: var(--surface-2);
|
|
border: 1px solid var(--border);
|
|
border-radius: 12px;
|
|
padding: 18px 32px;
|
|
min-width: 380px;
|
|
justify-content: center;
|
|
}
|
|
|
|
.db-bar .icon {
|
|
width: 36px;
|
|
height: 36px;
|
|
border-radius: 8px;
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
font-size: 1.1rem;
|
|
}
|
|
|
|
.db-bar h3 {
|
|
font-size: 1rem;
|
|
font-weight: 600;
|
|
}
|
|
|
|
.db-bar .tech {
|
|
font-size: 0.8rem;
|
|
color: var(--text-dim);
|
|
}
|
|
|
|
/* External services row */
|
|
.externals {
|
|
display: flex;
|
|
gap: 12px;
|
|
justify-content: center;
|
|
}
|
|
|
|
.ext-pill {
|
|
background: var(--surface-2);
|
|
border: 1px solid var(--border);
|
|
border-radius: 8px;
|
|
padding: 10px 16px;
|
|
font-size: 0.8rem;
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 8px;
|
|
color: var(--text-dim);
|
|
}
|
|
|
|
/* Arrow labels */
|
|
.arrow-label {
|
|
position: absolute;
|
|
background: var(--surface);
|
|
border: 1px solid var(--border);
|
|
border-radius: 6px;
|
|
padding: 3px 10px;
|
|
font-size: 0.7rem;
|
|
color: var(--text-dim);
|
|
z-index: 2;
|
|
white-space: nowrap;
|
|
}
|
|
|
|
/* Responsive */
|
|
@media (max-width: 1000px) {
|
|
.grid {
|
|
grid-template-columns: 1fr 1fr;
|
|
gap: 24px;
|
|
}
|
|
.col-left, .col-center, .col-right { grid-column: auto; }
|
|
.node-center { grid-column: 1 / -1; }
|
|
.db-bar { grid-column: 1 / -1; min-width: unset; width: 100%; }
|
|
}
|
|
|
|
@media (max-width: 640px) {
|
|
.grid { grid-template-columns: 1fr; }
|
|
.diagram-wrapper { padding: 28px 20px; }
|
|
header h1 { font-size: 1.6rem; }
|
|
}
|
|
|
|
/* Print */
|
|
@media print {
|
|
body { background: white; color: black; }
|
|
.diagram-wrapper { box-shadow: none; border: 1px solid #ccc; }
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<header>
|
|
<h1><span>GrowQR</span> System Architecture</h1>
|
|
<p>Durable Agent-centric architecture with RivetKit actors, OpenCode runtime & Git-backed memory</p>
|
|
</header>
|
|
|
|
<div class="legend">
|
|
<div class="legend-item"><div class="legend-dot bg-blue"></div>Frontend / BFF</div>
|
|
<div class="legend-item"><div class="legend-dot bg-purple"></div>Control Plane (Actors)</div>
|
|
<div class="legend-item"><div class="legend-dot bg-green"></div>Runtime / Execution</div>
|
|
<div class="legend-item"><div class="legend-dot bg-amber"></div>Memory / Storage</div>
|
|
<div class="legend-item"><div class="legend-dot bg-rose"></div>Database</div>
|
|
<div class="legend-item"><div class="legend-dot bg-cyan"></div>External Services</div>
|
|
</div>
|
|
|
|
<div class="diagram-wrapper">
|
|
<!-- SVG Layer for arrows -->
|
|
<svg class="arrows-svg" id="arrowsSvg">
|
|
<defs>
|
|
<marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
|
|
<path d="M 0 0 L 10 5 L 0 10 z" />
|
|
</marker>
|
|
<marker id="arr-active" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
|
|
<path d="M 0 0 L 10 5 L 0 10 z" fill="#60a5fa" />
|
|
</marker>
|
|
</defs>
|
|
</svg>
|
|
|
|
<div class="grid" id="grid">
|
|
|
|
<!-- Row 1 -->
|
|
<div class="col-left row-1">
|
|
<div class="group border-blue">
|
|
<div class="group-label accent-blue">Frontend</div>
|
|
<div class="node border-blue" id="node-ui">
|
|
<h3><span class="icon bg-blue accent-blue">◈</span>React UI</h3>
|
|
<ul>
|
|
<li>Conversational interface</li>
|
|
<li>Real-time updates</li>
|
|
</ul>
|
|
</div>
|
|
<div style="height:12px"></div>
|
|
<div class="node border-blue" id="node-nextjs">
|
|
<h3><span class="icon bg-blue accent-blue">◇</span>Next.js BFF</h3>
|
|
<ul>
|
|
<li>Auth & session management</li>
|
|
<li>Payments webhooks</li>
|
|
<li>Actor management proxy</li>
|
|
</ul>
|
|
<div class="meta">
|
|
<span>Vercel / OpenNext</span>
|
|
<span class="accent-blue">BFF Layer</span>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div style="height:14px"></div>
|
|
<div class="externals">
|
|
<div class="ext-pill" id="node-clerk">
|
|
<span class="accent-cyan">🔐</span> Clerk Auth
|
|
</div>
|
|
<div class="ext-pill" id="node-stripe">
|
|
<span class="accent-cyan">💳</span> Stripe
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="col-center row-1 row-2">
|
|
<div class="node node-center border-purple" id="node-actor">
|
|
<h3><span class="icon bg-purple accent-purple">⚡</span>Actor Backend — RivetKit</h3>
|
|
<div class="sub-nodes">
|
|
<div class="sub-node">Actor Runner</div>
|
|
<div class="sub-node">Actor Engine</div>
|
|
<div class="sub-node">Actor Storage</div>
|
|
</div>
|
|
<div style="margin-top:12px; font-size:0.8rem; color:var(--text-dim);">
|
|
Durable control plane — manages lifecycle, routing & state
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="col-right row-1">
|
|
<div class="group border-green">
|
|
<div class="group-label accent-green">Sandboxed Runtime</div>
|
|
<div class="node border-green" id="node-runtime">
|
|
<h3><span class="icon bg-green accent-green">▣</span>Agent Runtime</h3>
|
|
<ul>
|
|
<li>Sub-agent orchestration</li>
|
|
<li>Skills loading</li>
|
|
<li>Tool execution</li>
|
|
<li>Dockerized isolation</li>
|
|
</ul>
|
|
<div class="meta">
|
|
<span>OpenCode / Container</span>
|
|
<span class="accent-green">Per-user sandbox</span>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Row 2 -->
|
|
<div class="col-left row-2"></div>
|
|
<div class="col-right row-2">
|
|
<div class="group border-amber">
|
|
<div class="group-label accent-amber">Git Memory</div>
|
|
<div class="node border-amber" id="node-git">
|
|
<h3><span class="icon bg-amber accent-amber">●</span>Users Repos</h3>
|
|
<ul>
|
|
<li>Profile & goals</li>
|
|
<li>Quest history</li>
|
|
<li>Channel memory</li>
|
|
<li>Artifact storage</li>
|
|
</ul>
|
|
<div class="meta">
|
|
<span>Git worktrees</span>
|
|
<span class="accent-amber">Source of truth</span>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Row 3 -->
|
|
<div class="col-left row-3"></div>
|
|
<div class="col-center row-3">
|
|
<div style="display:flex; gap:20px; justify-content:center;">
|
|
<div class="node border-purple" style="min-width:160px; text-align:center;" id="node-threads">
|
|
<h3 style="justify-content:center;"><span class="icon bg-purple accent-purple">🧵</span>Threads API</h3>
|
|
<ul style="text-align:left;">
|
|
<li>Session tracking</li>
|
|
<li>Message logs</li>
|
|
</ul>
|
|
</div>
|
|
<div class="node border-purple" style="min-width:160px; text-align:center;" id="node-memory">
|
|
<h3 style="justify-content:center;"><span class="icon bg-purple accent-purple">🧠</span>Memory API</h3>
|
|
<ul style="text-align:left;">
|
|
<li>Tracking memory</li>
|
|
<li>3-layer memory model</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="col-right row-3"></div>
|
|
|
|
<!-- Row 4 -->
|
|
<div class="col-left row-4"></div>
|
|
<div class="col-center row-4">
|
|
<div class="db-bar border-rose" id="node-db">
|
|
<div class="icon bg-rose accent-rose">🗄</div>
|
|
<div>
|
|
<h3>PostgreSQL <span style="color:var(--text-dim); font-weight:400;">/</span> AWS RDS</h3>
|
|
<div class="tech">Account metadata · Recovery pointers · Operational indexes</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="col-right row-4"></div>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<footer style="margin-top: 40px; color: var(--text-dim); font-size: 0.8rem; text-align: center;">
|
|
GrowQR Architecture — Agent-centric · Git-backed · RivetKit-durable
|
|
</footer>
|
|
|
|
<script>
|
|
// Arrow drawing system
|
|
const svg = document.getElementById('arrowsSvg');
|
|
const grid = document.getElementById('grid');
|
|
|
|
function getCenter(el) {
|
|
const rect = el.getBoundingClientRect();
|
|
const wrap = document.querySelector('.diagram-wrapper').getBoundingClientRect();
|
|
return {
|
|
x: rect.left + rect.width / 2 - wrap.left,
|
|
y: rect.top + rect.height / 2 - wrap.top,
|
|
top: rect.top - wrap.top,
|
|
bottom: rect.bottom - wrap.top,
|
|
left: rect.left - wrap.left,
|
|
right: rect.right - wrap.left,
|
|
width: rect.width,
|
|
height: rect.height
|
|
};
|
|
}
|
|
|
|
function edgePoint(from, to, target='to') {
|
|
const dx = to.x - from.x;
|
|
const dy = to.y - from.y;
|
|
const angle = Math.atan2(dy, dx);
|
|
const ref = target === 'to' ? to : from;
|
|
const hw = ref.width / 2;
|
|
const hh = ref.height / 2;
|
|
// intersection with rectangle
|
|
const tan = Math.tan(angle);
|
|
let ix, iy;
|
|
if (Math.abs(dx) * hh > Math.abs(dy) * hw) {
|
|
ix = hw * Math.sign(dx);
|
|
iy = ix * tan;
|
|
} else {
|
|
iy = hh * Math.sign(dy);
|
|
ix = iy / (tan || 1e-9);
|
|
}
|
|
return { x: ref.x + ix, y: ref.y + iy };
|
|
}
|
|
|
|
function drawArrow(fromId, toId, label='', options={}) {
|
|
const fromEl = document.getElementById(fromId);
|
|
const toEl = document.getElementById(toId);
|
|
if (!fromEl || !toEl) return;
|
|
const from = getCenter(fromEl);
|
|
const to = getCenter(toEl);
|
|
const p1 = edgePoint(from, to, 'from');
|
|
const p2 = edgePoint(from, to, 'to');
|
|
|
|
let d;
|
|
if (options.straight) {
|
|
d = `M ${p1.x} ${p1.y} L ${p2.x} ${p2.y}`;
|
|
} else if (options.curve === 'vertical') {
|
|
const midY = (p1.y + p2.y) / 2;
|
|
d = `M ${p1.x} ${p1.y} C ${p1.x} ${midY}, ${p2.x} ${midY}, ${p2.x} ${p2.y}`;
|
|
} else {
|
|
const midX = (p1.x + p2.x) / 2;
|
|
d = `M ${p1.x} ${p1.y} C ${midX} ${p1.y}, ${midX} ${p2.y}, ${p2.x} ${p2.y}`;
|
|
}
|
|
|
|
const path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
|
|
path.setAttribute('d', d);
|
|
path.setAttribute('marker-end', 'url(#arr)');
|
|
svg.appendChild(path);
|
|
|
|
if (label) {
|
|
const mid = { x: (p1.x + p2.x) / 2, y: (p1.y + p2.y) / 2 };
|
|
// simple adjustment to avoid overlapping
|
|
const lx = mid.x + (options.labelDx || 0);
|
|
const ly = mid.y + (options.labelDy || 0);
|
|
const lbl = document.createElement('div');
|
|
lbl.className = 'arrow-label';
|
|
lbl.textContent = label;
|
|
lbl.style.left = lx + 'px';
|
|
lbl.style.top = ly + 'px';
|
|
lbl.style.transform = 'translate(-50%, -50%)';
|
|
document.querySelector('.diagram-wrapper').appendChild(lbl);
|
|
}
|
|
}
|
|
|
|
function renderArrows() {
|
|
// Clear existing paths
|
|
svg.querySelectorAll('path:not(defs path)').forEach(p => p.remove());
|
|
document.querySelectorAll('.arrow-label').forEach(l => l.remove());
|
|
|
|
// Frontend -> Threads API
|
|
drawArrow('node-ui', 'node-threads', 'read/write');
|
|
// Frontend -> Actor Backend
|
|
drawArrow('node-nextjs', 'node-actor', 'RPC');
|
|
// Actor Backend -> Runtime
|
|
drawArrow('node-actor', 'node-runtime', 'spawn / exec');
|
|
// Actor Backend -> Threads API
|
|
drawArrow('node-actor', 'node-threads', 'manage');
|
|
// Actor Backend -> Memory API
|
|
drawArrow('node-actor', 'node-memory', 'track');
|
|
// Actor Backend -> DB
|
|
drawArrow('node-actor', 'node-db', 'persist');
|
|
// Memory API -> Git
|
|
drawArrow('node-memory', 'node-git', 'commit / diff');
|
|
// Git -> DB
|
|
drawArrow('node-git', 'node-db', 'sync pointers');
|
|
// Next.js -> Clerk
|
|
drawArrow('node-nextjs', 'node-clerk', 'auth', {straight:true, labelDy:-14});
|
|
// Next.js -> Stripe
|
|
drawArrow('node-nextjs', 'node-stripe', 'billing', {straight:true, labelDy:-14});
|
|
}
|
|
|
|
// Render on load and resize
|
|
window.addEventListener('load', renderArrows);
|
|
window.addEventListener('resize', () => { requestAnimationFrame(renderArrows); });
|
|
</script>
|
|
|
|
</body>
|
|
</html>
|