240 lines
8.4 KiB
Markdown
240 lines
8.4 KiB
Markdown
# VAUCO MASTERPLAN — Chris Christiansen
|
|
|
|
**Sist oppdatert: 2026-05-27 20:xx CEST**
|
|
**Status: ✅ FASE A KOMPLETT | ✅ FASE B KOMPLETT | ✅ ML-1 live | ✅ CG1+CG2 live | ✅ OAuth live | CG3 neste**
|
|
|
|
---
|
|
|
|
## KONTEKST — Hva vi bygger
|
|
|
|
To parallelle spor:
|
|
|
|
1. **OPAX** — AI-drevet operativsystem for deg selv (intern cockpit, `opax.vauco.no`).
|
|
Medioteq og andre kunder onboardes via OPAX/Terraform — **du styrer det selv innenfra OPAX, ikke her.**
|
|
|
|
2. **CostGuard** — Salgbart produkt. AI-drevet GCP-kostnadsovervåking som selges til andre bedrifter.
|
|
Stack: Dialogflow CX → OSVauco Cloud Run → Cloud Billing API → Gemini 2.5 Flash
|
|
Pris å drifte: ~$32-45/mnd. Salgspris: $99-299/mnd pr. kunde.
|
|
**Dette er fokus nå.**
|
|
|
|
**Repo-oversikt:**
|
|
| Repo | Hva det er |
|
|
|---|---|
|
|
| `OSVauco` | Kjerne: Cloud Run agent, GCP-scripts, ml/, auth/ |
|
|
| `vauco-gemini-tui-bridge` | Din TUI-cockpit |
|
|
| `vauco-os` | Arkitektur og kundedok |
|
|
| `vauco-bootstrap` | Terraform-modul for kunde-provisjonering (Fase C) |
|
|
| `deep-dream` | Strategisk visjon — aldri deploy herfra |
|
|
|
|
---
|
|
|
|
## AGENT-IDENTITET
|
|
|
|
| Identitet | E-post | Rolle | Formål |
|
|
|---|---|---|---|
|
|
| Eier / admin | `chris.christiansen@vauco.no` | `billing.admin` + `billing.viewer` | Full kontroll |
|
|
| Agent (OPAX) | `jason.vauger@vauco.no` | `billing.viewer` | Hente og rapportere kostnadsdata autonomt |
|
|
| Fremtidig gruppe | `billing@vauco.no` | `billing.viewer` (Fase C) | Delt innboks for team og kunder |
|
|
|
|
---
|
|
|
|
## DNS / DOMENE-ARKITEKTUR
|
|
|
|
| Domene | Type | Teknologi | Fase |
|
|
|---|---|---|---|
|
|
| `opax.vauco.no` | Intern cockpit (kun Chris) | CNAME → Cloud Run | ✅ Live |
|
|
| `costguard.vauco.no` | CostGuard salgsdemo | CNAME → Cloud Run /static/ | CG3 neste |
|
|
| `kunde1.vauco.no` / kundedomener | Kunde-instanser | LB + IAP (Terraform) | 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?client_id=X` | ✅ | Kostnad per tjeneste siste 30d |
|
|
| `GET /billing/forecast?client_id=X` | ✅ | Prognose basert på 7d snitt |
|
|
| `GET /billing/anomalies?client_id=X` | ✅ | Anomali-deteksjon + Pub/Sub |
|
|
| `GET /auth/login?client_id=X` | ✅ | Start OAuth2-flow for klient |
|
|
| `GET /auth/callback` | ✅ | Google redirect → lagrer token |
|
|
| `GET /static/billing-dashboard.html` | ✅ | Billing dashboard UI |
|
|
| `GET /state` | ✅ | Agent state snapshot |
|
|
| `GET /telemetry/history` | ✅ | Telemetri |
|
|
|
|
**OAuth credentials (Vauco OS Web App):**
|
|
- Client ID: `357036551735-ka7t2fv9ue2jp01bs826hpdctlvispuo.apps.googleusercontent.com`
|
|
- Redirect URI: `https://osvauco-agent-357036551735.europe-west1.run.app/auth/callback`
|
|
- Secrets i Secret Manager: `OAUTH_CLIENT_ID`, `OAUTH_CLIENT_SECRET`
|
|
|
|
**BigQuery billing export:**
|
|
- Dataset: `propane-will-491900-m5:billing_export`
|
|
- Tabell: ikke ankommet ennå (aktivert 2026-05-27, forventet innen 24t)
|
|
- Når tabell dukker opp: sett `BILLING_TABLE` env-var i Cloud Run
|
|
|
|
---
|
|
|
|
## FASE CG — CostGuard ← AKTIV SPRINT
|
|
|
|
```
|
|
[x] CG1 — Billing API-integrasjon
|
|
ml/billing_agent.py: GET /billing/summary, /forecast
|
|
BQ-spørring klar, venter på billing_export-tabell (i morgen)
|
|
|
|
[x] CG2 — Anomali-deteksjon
|
|
ml/anomaly_detector.py: forbruk > 2x 7d-snitt → Pub/Sub
|
|
|
|
[x] AUTH — OAuth2 klient-onboarding
|
|
auth/oauth_flow.py + auth/token_store.py
|
|
/auth/login + /auth/callback live i main.py
|
|
Token lagres per client_id i Secret Manager
|
|
|
|
[ ] CG3 — CostGuard landingsside
|
|
costguard.vauco.no: "Koble til GCP"-knapp → /auth/login
|
|
Dialogflow Messenger embed (Jason-v1 FAQ, DX1-DX3 ferdig)
|
|
Billing dashboard embed (/static/billing-dashboard.html ferdig)
|
|
CNAME costguard.vauco.no → Cloud Run
|
|
|
|
[ ] CG4 — Onboard første kunde via vauco-bootstrap Terraform-modul
|
|
|
|
[ ] CG5 — Salgsdemo klar
|
|
```
|
|
|
|
---
|
|
|
|
## FASE A — ✅ KOMPLETT
|
|
|
|
```
|
|
[x] A1-A9 — Alle ferdig. Se tidligere historikk.
|
|
[x] SMOKE — scripts/smoke-test.sh: 10/10 ✅ (2026-05-26 01:45 CEST)
|
|
RAG corpus: projects/357036551735/locations/europe-west1/ragCorpora/6917529027641081856
|
|
Memory Engine: projects/357036551735/locations/us-central1/reasoningEngines/2260229219579592704
|
|
```
|
|
|
|
---
|
|
|
|
## FASE A2 — Dialogflow CX FAQ-agent
|
|
|
|
```
|
|
[x] DX1 — Agent: OSVauco FAQ, us-central1, propane-will-491900-m5
|
|
[x] DX2 — Data Store: threadstone-faq-store, 39 Q&A-par
|
|
[x] DX3 — Norsk systemprompt, fungerer
|
|
[x] DX4 — Parkert til C4 (Medioteq) — Cloud Run URL: https://osvauco-agent-zjbqp3prqq-uc.a.run.app
|
|
[ ] DX5 — Publiser via Dialogflow Messenger (trigger: CG3)
|
|
[ ] DX6 — Budsjett-alert Dialogflow CX
|
|
[ ] 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 — Cloud Run live
|
|
[x] B2 — GitHub PAT i Secret Manager
|
|
[x] B3 — Cloud Build 2nd gen (trigger: osvauco-agent-deploy)
|
|
[x] B4 — GitHub App webhook
|
|
[x] B5 — Cost guard 500 NOK/mnd + GCS ML-telemetri
|
|
[x] B1-IAP — opax.vauco.no CNAME live
|
|
[ ] B6 — Eksporter Dialogflow CX (se DX-lista)
|
|
```
|
|
|
|
---
|
|
|
|
## FASE C — Kunde-onboarding (Medioteq og videre)
|
|
|
|
> **NB: Medioteq og fremtidige kunder onboardes av deg selv via OPAX innenfra.**
|
|
> Dette er ikke en oppgave for ekstern assistanse. Terraform-modulen er klar.
|
|
|
|
```
|
|
[x] C1 — vauco-bootstrap Terraform-modul klar (validate: PASS)
|
|
[x] C2 — vauco-os kundeflate + CUSTOMER_API.md
|
|
[x] C3 — billing@vauco.no Google Group
|
|
[ ] C4 — Medioteq: HITL-møte → velg project_id → terraform apply
|
|
C4.1: project_id + billing_account_id (HITL-gate)
|
|
C4.2: Auth (Google login → vurder BankID sluttfase)
|
|
```
|
|
|
|
---
|
|
|
|
## INFRASTRUKTUR
|
|
|
|
| Script | Rolle | Status |
|
|
|--------|-------|--------|
|
|
| `00-authcheck.sh` | Verifiser gcloud-innlogging | Klar |
|
|
| `01-setupenv.sh` | Aktiver APIs, SA, IAM, budsjetter, Pub/Sub | Klar |
|
|
| `02-deploy.sh` | IAP-deploy på eget domene | Klar |
|
|
| `03-teardown.sh` | Riv ned Cloud Run (kjør hver kveld) | Klar |
|
|
| `04-observability-setup.sh` | Cloud Monitoring + alerting | Klar |
|
|
| `05-cloudrun-deploy.sh` | ADK-agent til Cloud Run | Klar |
|
|
| `06-cicd-setup.sh` | GitHub → Cloud Build 2nd gen | Klar |
|
|
| `07-rag-setup.sh` | RAG Engine corpus + fallback | Klar |
|
|
| `08-memorybank-setup.sh` | Memory Bank + auto-install | Klar |
|
|
| `09-cost-check.sh` | Kostnadsoversikt + Artifact Registry | Klar |
|
|
| `10-cost-guard.sh` | Cloud Function auto-teardown + GCS telemetri sink | Klar |
|
|
| `11-billing-iam-hardening.sh` | Billing IAM hardening | Klar |
|
|
| `scripts/smoke-test.sh` | 10-case røyktest | Klar |
|
|
|
|
---
|
|
|
|
## KJENTE HULL
|
|
|
|
| ID | Hva | Status |
|
|
|---|---|---|
|
|
| OQ-01 | Memory Bank — ingen gcloud CLI | Python SDK only |
|
|
| OQ-02 | RAG Engine regional availability | Auto-fallback til us-east1 |
|
|
| OQ-03 | CMEK ikke for RAG Engine | VPC-SC only |
|
|
| OQ-04 | Cloud Build GitHub OAuth | **LØST** — 2nd gen |
|
|
| OQ-05 | gcloud alpha monitoring ustabil | Fallback til true |
|
|
| OQ-06 | Memory Bank auto-discovery | Eksplisitt env var |
|
|
| OQ-11 | Dialogflow CX Data Store norsk indeksering | Teste nb-NO i DX2 |
|
|
| OQ-12 | gemini-2.0-flash ikke tilgjengelig | **LØST** — gemini-2.5-flash/pro + LOCATION=global |
|
|
| OQ-13 | ML-telemetri /tmp/ flyktig | **LØST** — B5: GCS sink |
|
|
| OQ-14 | LB vs CNAME | **LØST** — CNAME intern, LB Terraform for kunder |
|
|
| OQ-15 | billing_export BQ-tabell ikke ankommet | Venter — aktivert 2026-05-27 |
|
|
|
|
---
|
|
|
|
## DRIFTSKOSTNADER
|
|
|
|
| Scenario | Kostnad/mnd |
|
|
|---|---|
|
|
| Bare deg (dev, teardown daglig) | ~$25-75 |
|
|
| Dev + Dialogflow CX FAQ (10k req) | ~$145-195 |
|
|
| 1 betalende kunde (lett prod) | ~$115-280 |
|
|
| Medioteq-type (klinisk, compliance) | ~$220-350 |
|
|
|
|
Breakeven: 1 kunde til $300-500/mnd dekker alle kostnader.
|
|
|
|
---
|
|
|
|
## LLM-RUTINGSSTRATEGI
|
|
|
|
| Modell | Pris (per 1M) | Bruksområde |
|
|
|---|---|---|
|
|
| `gemini-2.5-flash` | $0.30 / $2.50 | light — alle enkle kall |
|
|
| `gemini-2.5-pro` | $1.25 / $10.00 | heavy — reasoning, compliance |
|
|
|
|
Autoriserte heavy-brukere: `opax`, `admin`
|
|
|
|
---
|
|
|
|
*OSVauco-NMTMD-GCOS | propane-will-491900-m5 | global (modell) / europe-west1 (infra)*
|