Ecosystem
Overview

Ecosystem Overview

The AICR ecosystem spans 20+ projects in ~/dev, with 12 connected to Vercel for deployment. This document provides the master inventory and architecture overview.

Architecture Tiers

┌─────────────────────────────────────────────────────────────────────┐
│                           SUMMIT TIER                                │
│                    (Ports 3050-3059, Premium)                       │
│  ┌────────────────────────────────────────────────────────────────┐ │
│  │ Full platform capabilities, advanced governance, enterprise     │ │
│  └────────────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────────┤
│                            EDGE TIER                                 │
│                    (Ports 3030-3049, Standard)                      │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐       │
│  │    SGM    │  │    SDA    │  │    SCM    │  │  NP-Edge  │       │
│  │   :3030   │  │   :3041   │  │   :3042   │  │   :3040   │       │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘       │
├─────────────────────────────────────────────────────────────────────┤
│                           STUDIO TIER                                │
│                    (Ports 3000-3029, Development)                   │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐                      │
│  │   AICR    │  │   Docs    │  │ Playground│                      │
│  │   :3000   │  │   :3001   │  │   :3002   │                      │
│  └───────────┘  └───────────┘  └───────────┘                      │
└─────────────────────────────────────────────────────────────────────┘

Project Categories

Core Platform (aicr monorepo)

ProjectPortPurposeStatus
apps/aicr3000Main platform UIActive
apps/docs3001Documentation siteActive
apps/playground3002API testing UIActive
services/agent-conductor3010AI agent orchestrationV1.1 Complete
services/sda-api3041Document analysis APIActive

SPARCC Ecosystem

ProjectPortPurposeDeployment
SGM (Sales Governance Manager)3030Policy managementVercel
SDA (Sales Document Analyzer)3041Document analysisVercel
SCM (Sales Comp Manager)3042Compensation plansVercel

Independent Applications

ProjectLocationPurposeDeployment
IntelligentSPM~/dev/intelligentspmSPM knowledge platformintelligentspm.com (opens in a new tab)
sda-sparcc-demo~/dev/sda-sparcc-demoDemo environmentVercel

Shared Infrastructure

Database (Neon PostgreSQL)

All environments use Neon PostgreSQL branches:

  • Production: main branch
  • Preview: Auto-created per PR
  • Development: dev branch

Features enabled:

  • pgvector for embeddings
  • Row-level security
  • Branch-based isolation

AI Providers

ProviderPurposeConfiguration
OpenAIGPT-4o, embeddingsVia ai-router
AnthropicClaude modelsVia ai-router
OllamaLocal inferencelocalhost:11434
Vercel AI GatewayProduction routingai.vercel.com

Deployment Pipeline

Local Dev → Git Push → Vercel Preview → Production
     │                      │
     └── Neon branch ──────┘

Key Packages

@aicr/ai-router

Central AI routing with:

  • Provider abstraction
  • Budget management
  • Response caching
  • Rate limiting

@aicr/contracts

Shared TypeScript types:

  • Context envelopes
  • Event schemas
  • Decision tokens

@aicr/orbs

Reusable AI UI components:

  • AskOrb (chat interface)
  • KBOrb (knowledge search)

@aicr/sda-core

Document analysis engine:

  • PDF/DOCX parsing
  • Gap analysis
  • Coverage scoring

Environment Variable Strategy

Variables are stored in Vercel and propagated:

Vercel Project Settings
         │
         ├── Production Environment
         ├── Preview Environment
         └── Development Environment

Critical variables:

  • OPENAI_API_KEY - AI provider
  • DATABASE_URL - Neon connection
  • NEXTAUTH_SECRET - Auth encryption
  • AICR_API_KEY - Gateway access

Next Steps

Integration GuideProject Inventory