# studio-products Architecture
<!-- wiki:featured -->

**Version:** 0.1.0  
**Track:** studio-products  
**Baseline:** 2026-10-07  
**Registry:** products/registry.yaml

## Overview

studio-products is the product layer of Venture Studio — SaaS applications, utilities, and platform services built on studio-engine and studio-infra. Products are registry-driven: each entry in products/registry.yaml defines health endpoints, systemd units, ports, and platform metadata, making every product discoverable by the console and ops tooling.

## Product Taxonomy

| launcher_kind | Description |
|---------------|-------------|
| (none) | Full SaaS product — own UI + backend, listed in the Launcher |
| utility | Internal tool — runs in Studio Shell or standalone |
| platform | Studio infrastructure (console, wiki, shell) |

## Active Products

### Platform

| Product | UI Port | API Port | Status | Path |
|---------|---------|----------|--------|------|
| Venture Studio Launcher | 3003 | 8000 | Platform Ready | dashboard/ |
| Studio Shell | 3020 | 8019 (shared) | Active | utilities/studio-shell/ |

### Utilities

| Product | UI Port | API Port | Status | Path |
|---------|---------|----------|--------|------|
| Nous | 3017 | 8019 | Active | utilities/nous/ |
| Blueprint Generator | 3209 | 8000 (shared) | Hibernated | utilities/blueprint/ |
| Athena | 3217 | 8017 | Hibernated | utilities/athena/ |

### SaaS Products

| Product | Vertical | UI Port | API Port | Status | Path |
|---------|----------|---------|----------|--------|------|
| Astra AI-CoS | Digital Command Center | 3101 | 8001 | Platform Ready (hibernated) | products/saas/astra-ai-cos/ |
| CaseVault | Legal Defense Intelligence | 3015 | 8015 | Platform Ready (hibernated) | products/saas/casevault/ |
| PropHunt | Real Estate Intelligence | 3103 | 8003 | Development (hibernated) | products/saas/prophunt/ |

## Registry Schema

products/registry.yaml is the single source of truth. Each product entry defines:

- id — unique slug used by ops tooling and console
- vertical — product category / market vertical
- status — Active | Platform Ready | Development | hibernated
- hibernate — when true, health checks are skipped, service is stopped
- platform — kit version, shell type, LLM tier, auth mode
- ports — API and UI port assignments (each product owns its ports)
- health — liveness probe URLs for API and UI
- systemd — list of systemd units to start/stop for this product
- devops — deploy, dev-run, and smoke-test script paths

## Platform Kit Conformance

| Level | Description |
|-------|-------------|
| native | Full @studio/ui tokens + components; semantically correct |
| partial | Some @studio/ui tokens applied; migration in progress |

Target for all active products: native at @studio/ui v3.3.0+.

## Port Allocation

| Range | Allocation |
|-------|-----------|
| 8000-8019 | API services (prod) |
| 3000-3020 | UI services (prod) |
| 9000-9219 | API services (dev) |
| 4000-4219 | UI services (dev) |

## Product Lifecycle

  Development → Platform Ready → Active
                     ↕
                 Hibernated

- Development — actively being built; not stable
- Platform Ready — feature-complete; hibernated pending business launch
- Active — running in prod with health checks enabled
- Hibernated — stopped; hibernate: true in registry; health checks skipped

## LLM Integration

All products use the Studio Engine LiteLLM proxy (:4000). LLM tier declared per product in platform.llm:

| Value | Routes to |
|-------|-----------|
| platform | tier/confidential-fast or tier/confidential-deep (intent-gated) |
| andi | tier/confidential-deep (always think-on) |

No product hardcodes a model name — tier aliases are resolved by LiteLLM config.

## Ops

- Console: https://studio-venky.duckdns.org/console/ — live health status for all products
- Registry: products/registry.yaml — version: 1, platform_version: 2.4.4
- Deploy: each product has .devops/deploy-prod.sh; all gate on git pull before restart
- Dev stack: .devops/run-dev-stack.sh with dev ports (9xxx/4xxx)
- Smoke tests: .devops/smoke-test.sh per product

## Pending

| Item | Status |
|------|--------|
| Healthcare IT products (9) | Specs in Nous memory; registry entries pending |
| Blueprint rebuild in Studio Shell | In progress |
| Athena rebuild in Studio Shell | In progress |
| PropHunt frontend polish | Development |
| Astra AI-CoS launch | Platform Ready; awaiting go-live decision |

---

_Generated: 2026-10-07 · studio-products v0.1.0_