# VAUCO MASTERPLAN — Chris Christiansen

**Sist oppdatert: 2026-05-27 20:30 CEST**
**Status: ✅ FASE A | ✅ FASE B | ✅ ML-1 | ✅ CG1+CG2 live | ✅ OAuth live | CG3 neste**

> **Les dette først:** Autoritativ arkitektur er `vauco-os/VAUCO_OS_DOMAIN_ARCHITECTURE.md`.
> Ikke overstyr beslutninger som allerede er dokumentert der.

---

## ARKITEKTUR-HIERARKI (autoritetivt)

```
Vauco AS (935 989 779)
├── Vauco OS  ← internt operativsystem (kun Chris)
│   ├── os.vauco.no    ← LIVE PROD
│   ├── oss.vauco.no   ← STAGING (nåværende arbeidsområde)
│   ├── Jason (autonom agent)
│   ├── Vauco OS Hub (orchestrator)
│   └── Cloud Console ← salgsmoduler bygges herfra
│       └── CostGuard ← modul #1 (use case + første salgbar modul)
│           costguard.oss.vauco.no  ← nåværende
│           costguard.os.vauco.no   ← når live
│
└── Threadstone  ← separat SaaS-produkt til kunder
    threadstone.vauco.no
    app.threadstone.vauco.no
```

**CostGuard er et use case som beviste OPAX-arkitekturen.**
Det bygges simultant med OPAX som modul #1 i Cloud Console.
Medioteq og fremtidige kunder onboardes av deg selv via OPAX innenfra — ikke her.

---

## REPO-OVERSIKT

| Repo | Hva det er |
|---|---|
| `OSVauco` | Kjerne: Cloud Run agent, GCP-scripts, ml/, auth/ |
| `vauco-gemini-tui-bridge` | TUI-cockpit (langt arbeid → bruk Gemini TUI) |
| `vauco-os` | Arkitektur og kundedok (authoritative) |
| `vauco-bootstrap` | Terraform-modul for kunde-provisjonering |
| `deep-dream` | Strategisk visjon — aldri deploy herfra |

---

## AGENT-IDENTITET

| Identitet | E-post | Rolle |
|---|---|---|
| Eier / admin | `chris.christiansen@vauco.no` | `billing.admin` + `billing.viewer` |
| Agent (OPAX) | `jason.vauger@vauco.no` | `billing.viewer` |
| Fremtidig gruppe | `billing@vauco.no` | `billing.viewer` (Fase C) |

---

## CLOUD RUN — LIVE ENDEPUNKTER

**Service:** `osvauco-agent` | **Region:** `europe-west1`
**URL:** `https://osvauco-agent-357036551735.europe-west1.run.app`
**Siste revisjon:** `osvauco-agent-00064-p9h`

| Endepunkt | Status | Beskrivelse |
|---|---|---|
| `GET /health` | ✅ | Health check |
| `POST /run` | ✅ | Agent (light/heavy) |
| `POST /run/dag` | ✅ | Parallell DAG |
| `GET /billing/summary` | ✅ | Kostnad per tjeneste siste 30d |
| `GET /billing/forecast` | ✅ | Prognose 7d snitt |
| `GET /billing/anomalies` | ✅ | Anomali-deteksjon + Pub/Sub |
| `GET /auth/login?client_id=X` | ✅ | Start OAuth2-flow |
| `GET /auth/callback` | ✅ | Google redirect → token |
| `GET /static/billing-dashboard.html` | ✅ | Billing dashboard UI |
| `GET /state` | ✅ | Agent state |
| `GET /telemetry/history` | ✅ | Telemetri |

**OAuth (Vauco OS Web App):**
- Client ID: `357036551735-ka7t2fv9ue2jp01bs826hpdctlvispuo.apps.googleusercontent.com`
- Redirect URI: `https://osvauco-agent-357036551735.europe-west1.run.app/auth/callback`
- Secrets: `OAUTH_CLIENT_ID`, `OAUTH_CLIENT_SECRET` (Secret Manager)

**BigQuery:** `propane-will-491900-m5:billing_export` — tabell ventes innen 24t fra 2026-05-27

---

## FASE CG — CostGuard (OPAX modul #1) ← AKTIV

```
[x] CG1 — ml/billing_agent.py: /billing/summary, /forecast
[x] CG2 — ml/anomaly_detector.py: anomali → Pub/Sub
[x] AUTH — OAuth2 flow live

[ ] CG3 — costguard.oss.vauco.no landingsside
        static/costguard.html i OSVauco-repo
        "Koble til GCP" → /auth/login
        Billing dashboard embed
        CNAME costguard.oss.vauco.no → Cloud Run
        (promoveres til costguard.os.vauco.no når klar)

[ ] CG4 — Første ekstern kunde via vauco-bootstrap
[ ] CG5 — Salgsdemo klar
```

---

## FASE A — ✅ KOMPLETT

```
[x] A1-A9 + SMOKE 10/10 ✅ (2026-05-26 01:45 CEST)
RAG:    projects/357036551735/locations/europe-west1/ragCorpora/6917529027641081856
Memory: projects/357036551735/locations/us-central1/reasoningEngines/2260229219579592704
```

---

## FASE A2 — Dialogflow CX (Jason-v1 FAQ)

```
[x] DX1-DX3 — Agent live, Data Store, norsk systemprompt
[x] DX4 — Parkert (Cloud Run-webhook til C4)
[ ] DX5 — Dialogflow Messenger (trigger: CG3)
[ ] DX6 — Budsjett-alert
[ ] DX7 — Voice-kanal (trigger: etter DX5)
[ ] B6  — Eksporter Dialogflow CX til versjonskontroll
```

---

## FASE ML

```
[x] ML-1 — DAG, state store, telemetri ✅ (2026-05-25)
[ ] ML-2 — Adaptiv intelligens (trigger: >500 telemetri-kall)
[ ] ML-3 — Strategisk innsikt (trigger: ML-2 + første kunde)
```

---

## FASE B — ✅ KOMPLETT

```
[x] B1-B5, B1-IAP (opax.vauco.no CNAME live)
[ ] B6 — Dialogflow CX versjonskontroll (se DX-lista)
```

---

## FASE C — Kunde-onboarding

> Medioteq og fremtidige kunder håndteres av deg selv via OPAX.

```
[x] C1 — vauco-bootstrap Terraform-modul (validate: PASS)
[x] C2 — CUSTOMER_API.md
[x] C3 — billing@vauco.no Google Group
[ ] C4 — Medioteq: HITL-møte → project_id → terraform apply
```

---

## INFRASTRUKTUR

| Script | Rolle |
|--------|-------|
| `00-authcheck.sh` | Verifiser innlogging |
| `01-setupenv.sh` | APIs, SA, IAM, Pub/Sub |
| `03-teardown.sh` | Riv ned Cloud Run (kjør hver kveld) |
| `04-observability-setup.sh` | Cloud Monitoring |
| `07-rag-setup.sh` | RAG corpus |
| `08-memorybank-setup.sh` | Memory Bank |
| `10-cost-guard.sh` | Auto-teardown + GCS telemetri |
| `11-billing-iam-hardening.sh` | IAM hardening |
| `scripts/smoke-test.sh` | 10-case røyktest |

---

## KJENTE HULL

| ID | Hva | Status |
|---|---|---|
| OQ-01 | Memory Bank — ingen gcloud CLI | Python SDK only |
| OQ-02 | RAG regional | Auto-fallback us-east1 |
| OQ-15 | billing_export BQ-tabell | Venter — aktivert 2026-05-27 |

---

## DRIFTSKOSTNADER

| Scenario | Kostnad/mnd |
|---|---|
| Dev (teardown daglig) | ~$25-75 |
| Dev + Dialogflow CX (10k req) | ~$145-195 |
| 1 betalende kunde | ~$115-280 |

Breakeven: 1 kunde à $300-500/mnd.

---

## LLM-RUTING

| Modell | Bruksområde |
|---|---|
| `gemini-2.5-flash` | light — alle enkle kall |
| `gemini-2.5-pro` | heavy — reasoning, compliance |

`LOCATION=global` | Autoriserte heavy: `opax`, `admin`

---

*OSVauco | propane-will-491900-m5 | europe-west1*