chris/OSVauco
1
0
Fork 0
Code Issues 1 Pull Requests Actions 2 Packages Projects Releases Wiki Activity
b70eabe22c
OSVauco/MASTERPLAN.md
Chris Christiansen 351bc8299b feat(cg3): add costguard landing page
2026-05-27 18:36:37 +00:00

8.7 KiB
Raw Blame History

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 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

Agent-kapabiliteter med billing.viewer:

  • Svare på «Hva koster dette prosjektet denne måneden?»
  • Sende ukentlig kostnadsrapport til chat-appen
  • Reagere på Pub/Sub budget-alerts (via 10-cost-guard.sh)
  • Ikke: endre IAM, budsjetter eller koble prosjekter

DNS / DOMENE-ARKITEKTUR

Arkitekturavgjørelse — 2026-05-26

Domene Type Teknologi Fase
opax.vauco.no Intern cockpit (kun Chris) CNAME → Cloud Run (gratis) B1 nå
costguard.oss.vauco.no Standalone app CNAME → osvauco-agent-357036551735.europe-west1.run.app CG3
kunde1.vauco.no / kundedomener Kunde-instanser LB + IAP (Terraform) Fase C

Begrunnelse:

  • opax.vauco.no er et internt arbeidsverktøy for én bruker — Load Balancer ($18-20/mnd) er unødvendig overhead.
  • Kundeinstanser provisjoneres via vauco-bootstrap Terraform-modul i Fase C. LB + IAP bakes inn i modulen én gang og kjøres automatisk per kunde med terraform apply -var="customer_id=X".
  • Terraform-modulen (Fase C) skal inkludere: Cloud Run, Cloud Build, IAP, LB, budsjett, SA, Dialogflow CX, ML state store.

CLOUD SHELL QUICK-START (kopi-klipp)

Bruk Cloud Shell: https://shell.cloud.google.com

# Steg 1: Klon og sett opp miljø
gcloud config set project propane-will-491900-m5
git clone https://github.com/chrischristiansen-glitch/OSVauco.git ~/OSVauco
cd ~/OSVauco

# Steg 2: Kopier og rediger .env
cp .env.example .env
nano .env
# Fyll ut: BILLING_ACCOUNT_ID, ALERT_EMAIL, GITHUB_APP_INSTALLATION_ID

# Steg 3: Installer Python-avhengigheter
pip install google-adk google-cloud-aiplatform>=1.111.0 --quiet

# Steg 4: Kjør i rekkefølge
source .env
bash infrastructure/00-authcheck.sh
bash infrastructure/01-setupenv.sh
bash infrastructure/07-rag-setup.sh
# *** Kopier RAG_CORPUS_NAME fra output inn i .env ***
nano .env && source .env

bash infrastructure/08-memorybank-setup.sh
# *** Kopier MEMORY_ENGINE_NAME fra output inn i .env ***
nano .env && source .env

gcloud run deploy osvauco-agent 
  --source . --region europe-west1 
  --project propane-will-491900-m5 
  --set-secrets RAG_CORPUS=rag-corpus-name:latest 
  --set-env-vars GOOGLE_GENAI_USE_VERTEXAI=1,GOOGLE_CLOUD_PROJECT=propane-will-491900-m5,GOOGLE_CLOUD_LOCATION=global,MEMORY_ENGINE_NAME=$MEMORY_ENGINE_NAME 
  --no-allow-unauthenticated

bash infrastructure/04-observability-setup.sh
bash infrastructure/11-billing-iam-hardening.sh
bash scripts/smoke-test.sh

# Om kvelden (OBLIGATORISK):
bash infrastructure/03-teardown.sh

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