chris/OSVauco
1
0
Fork 0
Code Issues 1 Pull Requests Actions 2 Packages Projects Releases Wiki Activity
e732ee7355
OSVauco/docs/HANDOFF.md

6.9 KiB
Raw Blame History

HANDOFF — Vauco OS

Sist oppdatert: 2026-06-09 Skrevet av: Jason Vauger (via Perplexity) Status: CG3a (static/costguard.html) og første versjon av GCP billing-dashboardet er på plass. Neste steg er å gjøre CostGuard-UI klart for kunder og deretter ta CNAME.

✅ OQ-15: Implementering fullført

  • Live Data: get_summary-metoden i ml/billing_agent.py henter nå data direkte fra BigQuery billing_export-tabellen.
  • Build-fiks: Feilen i cloudbuild.yaml relatert til $COMMIT_SHA er rettet, og en ny versjon av osvauco-agent er vellykket deployet.
  • Verifisering gjenstår: Automatisk verifisering av selve endepunktet ble blokkert av IAP. SQL-spørringen er validert, men en full sjekk av UI gjenstår.

🎯 NESTE OPPGAVE

CG3b — CNAME costguard.oss.vauco.no til Cloud Run osvauco-agent i Proisp, ETTER at CostGuard-UI er ferdig første versjon.

Når du tar CNAME, skal følgende allerede være på plass:

  • static/costguard.html (landingsside med OAuth-knapp + CostGuard-embed)
  • static/billing-dashboard.html (GCP-only CostGuard-dashboard, ingen AWS-kobling)
  • Billing-dashboardet skal vise ekte GCP-data uten å falle tilbake til demo-data når API er oppe.

🏗 Hva er dette prosjektet?

Se docs/MASTERPLAN.md for full sannhet. Kortversjonen:

Vauco OS  (plattform)
  └── OPAX  (kommandosenter + salgsmodul-bygger, Cloud Run us-central1)
        ├── CostGuard  (Modul #1 — live på costguard.oss.vauco.no)
        ├── Threadstone  (Modul #2 — Q3 2026)
        └── [Modul #3+]

OPAX = kommandosenter for ALLE prosjekter (et prosjekt = en klient — samme ting). OPAX bygger, iscenesetter og publiserer prosjekter. OPAX er ikke bundet til noe enkelt prosjekts region.

Branding-konvensjon for prosjekter:

Subdomene Type
<prosjekt>.oss.vauco.no Staging / demo
<prosjekt>.os.vauco.no Live produksjon

(Klient kan videresende eget domene, men kanonisk merkevare-label er alltid *.vauco.no.)

Første betalende produkt: CostGuard (GCP-kostnadsanalyse via AI).

✅ Hva er faktisk ferdig (ikke spør om dette igjen)

Komponent Status
Cloud Run osvauco-agent ✅ Live, us-central1
opax.vauco.no (LB + SSL) ✅ Live, IP 34.98.77.173
IAP (@vauco.no only) ✅ Aktivert
PR #15 IAP /health-fix ✅ Merget til main (commit 7a09871)
CI/CD Cloud Build → Cloud Run ⚠️ IKKE operativt — ingen trigger, siste builds FAILURE. Deploy MANUELT.
RAG corpus osvauco-corpus ✅ Populert, europe-west1
OAuth2 (Google) ✅ I Secret Manager
AI-modell ✅ gemini-2.5-pro via Vertex AI (us-central1)
costguard.oss.vauco.no ✅ Live (Cloudflare Pages)
static/costguard.html ✅ Første versjon live via osvauco-agent
static/billing-dashboard.html ✅ Første versjon GCP-only, layout strammet inn, AWS-UI parkert

📋 Nøkkelinformasjon

Nøkkel Verdi
GCP Project propane-will-491900-m5
Region (OPAX, LÅST) us-central1
Vertex AI endpoint us-central1 (kjører GOOGLE_CLOUD_LOCATION=global i praksis)
Artifact Registry us-central1-docker.pkg.dev/propane-will-491900-m5/osvauco-repo
Cloud Run service osvauco-agent
Cloud Run URL (direkte) https://osvauco-agent-357036551735.us-central1.run.app
Public URL https://opax.vauco.no
LB IP 34.98.77.173
AI-modell gemini-2.5-pro
Repo vauco-saas/OSVauco
Eier / Operatør Chris Christiansen — chris.christiansen@vauco.no
Agent-konto jason.vauger@vauco.no

🩺 Medisinsk prosjekt (Medioteq) — SEPARAT, IKKE OPAX

Det medisinske prosjektet er et eget, fremtidig prosjekt som ikke er opprettet ennå og ikke er prioritert. Det påvirker IKKE OPAX sin region eller arkitektur. Når det opprettes, velges region (EU eller US) der og da, uavhengig av OPAX. Alle kliniske/europe-north1-regler gjelder KUN det prosjektet — ikke OPAX.

✅ Fullførte oppgaver i 'NOW'-seksjonen (denne sesjonen)

  • CG3a — CostGuard-landing: static/costguard.html opprettet i OSVauco, designet i Vauco-stil med Google OAuth-knapp + embed av /static/billing-dashboard.html. Commit 3a88bef4 på main, deployet til osvauco-agent og verifisert tilgjengelig via https://opax.vauco.no/static/costguard.html.
  • CG3 — CostGuard billing-dashboard (GCP-only): static/billing-dashboard.html er ryddet opp slik at:
    • GCP er eneste provider i UI (AWS-UI parkert til senere).
    • Demo-data brukes kun hvis kjerne-endepunktene (/billing/summary, /billing/live, /billing/anomalies) feiler.
    • History-endepunktet (/billing/history) er best-effort og gir ikke lenger rød feilbanner alene.
    • Layout er strammet inn med nøkkeltall-rad, daglig kostnad + tjeneste-fordeling, samt kostnad per tjeneste + budsjettstatus.
    • Anomali-visning er flyttet til en enkel topplinje-badge (grønn/gul/rød) i stedet for eget kort.

⚠️ Vanlige feil — ikke gjør disse

  • Ikke opprett nye HANDOFF_YYYYMMDD-filer. Det er kun denne. Overskriv den.
  • Ikke re-merge PR #15 — allerede merget.
  • Ikke sett opp CI/CD-triggere — deploy manuelt.
  • Ikke bytt til Claude før kvote er bekreftet + MODEL APPROVED fra Chris.
  • Ikke migrere fra us-central1 — regionen er låst for OPAX.
  • Ikke rør IAP, OAuth, eller Secret Manager uten eksplisitt DEPLOY GODKJENT.
  • Ikke oppdater OAuth-klient redirect URIs uten domeneavklaring — se Issue #16.

📁 Viktige filer å lese (i denne rekkefølgen)

  1. docs/MASTERPLAN.md — autoritativ sannhet
  2. docs/ROADMAP.md — hva som skjer akkurat nå
  3. docs/HANDOFF.md — denne filen
  4. docs/AGENT_RULEBOOK.md — regler for hvordan agenter oppfører seg
  5. agents/jason-vauger.md — Jason Vauger agentprofil
  6. AGENTS.md — oversikt over alle agenter i ML-laget
  7. .gemini/GEMINI.md — locked definitions og boot-protokoll
  8. docs/ARCHITECTURE.md — teknisk arkitektur
  9. docs/OSVAUCO_OPAX_SESSION_LOG.md — append-only sesjonshistorikk

⚠️ Vanlige feil — ikke gjør disse

  • Ikke opprett nye HANDOFF_YYYYMMDD-filer. Det er kun denne. Overskriv den.
  • Ikke gjenopplive VAUCO_OS_ROADMAP.md. Den er slettet 2026-05-31. Bruk ROADMAP.md.
  • Ikke bytt til Claude før kvote er bekreftet av Google Cloud-team + MODEL APPROVED fra Chris.
  • Ikke migrere fra us-central1 — regionen er låst.
  • Ikke rør IAP, OAuth, eller Secret Manager uten eksplisitt DEPLOY GODKJENT fra Chris.
  • Ikke opprett nye repos. Vurder mappe i OSVauco først. Krever REPO APPROVED.
  • Ikke hopp over HITL gates — hver fase avsluttes med et godkjenningssignal.
  • Ikke oppdater OAuth-klient redirect URIs uten domeneavklaring — se Issue #16.

Vauco AS · propane-will-491900-m5 · us-central1 · Powered by Jason, Crafted by Vauco ·