HV Hub v2 — System Architecture

Internal ops hub · NestJS 11 API + Next.js 15 · Maestro sales pipeline + Hermes (Bedrock AgentCore) · DynamoDB + Airtable · AWS us-east-2

HV Hub v2 — System Architecture Internal ops hub · NestJS 11 API + Next.js 15 · Maestro sales pipeline + Hermes (Bedrock AgentCore) · DynamoDB + Airtable · AWS us-east-2 AWS us-east-2 · ECS · Lambda · Bedrock Auth.js · Google OAuth · @happenventures.com only Chat Ops · Slack · Telegram · Discord · Architecture component Chat Ops Slack · Telegram · Discord Hermes · Router Lambda + AgentCore · AWS us-east-2 · ECS · Lambda · Bedrock · arm64 Hermes Router Lambda + AgentCore arm64 Claude · API + Bedrock · Architecture component · SSE Claude API + Bedrock SSE Airtable · config / governance SSOT · Architecture component Airtable config / governance SSOT Staff Browser · @happenventures.com · Architecture component Staff Browser @happenventures.com Web · Next.js 15 · apps/web · AWS us-east-2 · ECS · Lambda · Bedrock › Auth.js · Google OAuth · @happenventures.com only Web Next.js 15 · apps/web API · NestJS 11 · /api · AWS us-east-2 · ECS · Lambda · Bedrock › Auth.js · Google OAuth · @happenventures.com only · ECS Fargate API NestJS 11 · /api ECS Fargate DynamoDB · task queue + audit · AWS us-east-2 · ECS · Lambda · Bedrock DynamoDB task queue + audit Send Worker · Lambda → Gmail · AWS us-east-2 · ECS · Lambda · Bedrock Send Worker Lambda → Gmail Producer · Lambda /generate · AWS us-east-2 · ECS · Lambda · Bedrock Producer Lambda /generate SQS · tasks-ingest · AWS us-east-2 · ECS · Lambda · Bedrock SQS tasks-ingest Consumer · Bedrock drafts + Governor · AWS us-east-2 · ECS · Lambda · Bedrock Consumer Bedrock drafts + Governor HTTPS REST + SSE chat · SSE tasks + audit config / SSOT approved → send enqueue drain drafts webhook Bedrock Legend Frontend Backend Database Cloud Message bus External

Main app

  • • Next.js 15 web (apps/web :3001) → NestJS 11 API (/api)
  • • ECS Fargate behind ALB; TanStack Query + Zustand
  • • Chat over SSE: /chat/wiki (HV Bot) + /chat/robin

Maestro sales pipeline (LIVE)

  • • n8n crons → producer Lambda (/generate)
  • • SQS tasks-ingest → consumer (Bedrock drafts + dedup)
  • • Governor gate ALLOW/HOLD/DEFER → human /queue approve → Gmail

Hermes (Bedrock AgentCore)

  • • Slack / Telegram / Discord → router Lambda
  • • AgentCore runtime (arm64) reasons with Claude on Bedrock
  • • Conversation history in DynamoDB; memory + skills in S3

Data & config

  • • DynamoDB hv-hub-v2-development-tasks — queue + audit
  • • Airtable = config / governance SSOT + Audit_Log mirror
  • • ElastiCache Redis cache · HubSpot · Notion · Google

Security / trust

  • • Auth.js v5 + Google OAuth, @happenventures.com only
  • • JwtAuthGuard global; secrets in AWS Secrets Manager
  • • All AWS in us-east-2; domain hubv2.apphappenventures.com

Architecture diagram • Built with Archify • Create yours ↗ • Hover to trace • R route • Click to focus • +/− zoom • M radar • [/] views • P play story • T theme • E export