chris/OSVauco
1
0
Fork 0
Code Issues 1 Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs(MASTERPLAN): add Cloud Shell Quick-Start, update OQ-02 workaround, infra status table

Browse Source 
Updated the last modified date and status in the master plan. Added a quick-start guide for Cloud Shell and made various adjustments to the task list and notes.
This commit is contained in:
chrischristiansen-glitch 2026-05-23 05:38:27 +02:00 committed by GitHub
parent fb9113cd62
commit 7575ee3844
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 85 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

131
MASTERPLAN.md
View File

@ -1,6 +1,7 @@
# VAUCO MASTERPLAN — Chris Christiansen # VAUCO MASTERPLAN — Chris Christiansen
**Sist oppdatert: 2026-05-23 03:00 CEST**
**Status: Repo ferdig — GCP gjenstår** **Sist oppdatert: 2026-05-23 CEST**
**Status: Repo ferdig — GCP gjenstår (A4–A8 neste)**
--- ---
@ -20,7 +21,50 @@ Du er første kunde. Når det virker for deg → selg det til andre.
--- ---
## CLOUD SHELL QUICK-START (kopi-klipp)
> Bruk Cloud Shell: https://shell.cloud.google.com
```bash
# 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 og ALERT_EMAIL
# Alle andre verdier er ferdig-forhåndsutfylt
# Steg 3: Installer Python-avhengigheter
pip install google-adk google-cloud-aiplatform>=1.111.0 --quiet
# Steg 4: Kjør i rekkefølge (kilde .env først)
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 # Legg til: export RAG_CORPUS_NAME="..."
source .env
bash infrastructure/08-memorybank-setup.sh
# *** Kopier MEMORY_ENGINE_NAME fra output inn i .env ***
nano .env # Legg til: export MEMORY_ENGINE_NAME="..."
source .env
bash infrastructure/05-cloudrun-deploy.sh
bash infrastructure/04-observability-setup.sh
# Om kvelden (OBLIGATORISK — unngå 24/7-fakturering):
bash infrastructure/03-teardown.sh
```
---
## FASE A — Ferdigstill kjernen (GCP oppe) ## FASE A — Ferdigstill kjernen (GCP oppe)
**Mål: Agenten din er live på Google Cloud | Tid: Ca. 2 timer** **Mål: Agenten din er live på Google Cloud | Tid: Ca. 2 timer**
``` ```
@ -31,73 +75,66 @@ Du er første kunde. Når det virker for deg → selg det til andre.
ALERT_EMAIL=chris.christiansen@vauco.no ALERT_EMAIL=chris.christiansen@vauco.no
ORCHESTRATOR_MODEL=gemini-2.0-flash ORCHESTRATOR_MODEL=gemini-2.0-flash
SUBAGENT_MODEL=gemini-2.0-flash SUBAGENT_MODEL=gemini-2.0-flash
[ ] A2 — bash infrastructure/00-authcheck.sh [ ] A2 — bash infrastructure/00-authcheck.sh
[ ] A3 — bash infrastructure/01-setupenv.sh [ ] A3 — bash infrastructure/01-setupenv.sh
[ ] A4 — bash infrastructure/07-rag-setup.sh [ ] A4 — bash infrastructure/07-rag-setup.sh
OQ-02: Script faller automatisk tilbake til us-east1 om nødvendig
ACTION: Kopier RAG_CORPUS_NAME til .env
[ ] A5 — bash infrastructure/08-memorybank-setup.sh [ ] A5 — bash infrastructure/08-memorybank-setup.sh
OQ-01: Python SDK only (auto-installert av script)
ACTION: Kopier MEMORY_ENGINE_NAME til .env
[ ] A6 — bash infrastructure/05-cloudrun-deploy.sh [ ] A6 — bash infrastructure/05-cloudrun-deploy.sh
[ ] A7 — bash infrastructure/04-observability-setup.sh [ ] A7 — bash infrastructure/04-observability-setup.sh
[ ] A8 — bash infrastructure/03-teardown.sh <- KJØR HVER KVELD [ ] A8 — bash infrastructure/03-teardown.sh (kjør hver kveld)
``` ```
--- ---
## FASE B — Sikring og CI/CD ## FASE B — Sikring og CI/CD
**Mål: Bare du kan nå agenten. CI/CD oppe. | Tid: Ca. 1 time**
**Mål: Begrenset tilgang og aktiv CI/CD | Tid: 1 time**
``` ```
[ ] B1 — bash infrastructure/02-deploy.sh (IAP på opax.vauco.no) [ ] B1 — bash infrastructure/02-deploy.sh (IAP på opax.vauco.no)
[ ] B2 — bash infrastructure/06-cicd-setup.sh (GitHub → Cloud Build) [ ] B2 — bash infrastructure/06-cicd-setup.sh
OBS: Krever manuelt steg i GCP Console for GitHub OAuth OQ-04: GitHub OAuth må settes opp manuelt i GCP Console
https://console.cloud.google.com/cloud-build/triggers
``` ```
--- ---
## FASE C — Første salgsmodul ## FASE C — Første salgsmodul
**Mål: Ny kunde oppe på 30 minutter | Tid: Ukesarbeid**
**Mål: Ny kunde onboardet på 30 minutter | Tid: Ukentlig arbeid**
``` ```
[ ] C1 — Pakk vauco-bootstrap som onboarding-produkt [ ] C1 — Pakk `vauco-bootstrap` som onboardingprodukt
[ ] C2 — Pakk vauco-os som kundens grensesnitt [ ] C2 — Pakk `vauco-os` som kundeflate
[ ] C3 — Første kunde: Medioteq (europe-north1, separat GCP-prosjekt) [ ] C3 — Første kunde: Medioteq (europe-north1, separat GCP-prosjekt)
``` ```
**Salgspitch per modul:** ---
| Modul | Pitch |
|---|---| ## INFRASTRUKTUR
| OPAX-MCP | "AI-assistent som driver GCP-infrastrukturen din — uten DevOps" |
| vauco-os | "Ferdig AI-operativsystem for din bedrift — oppe på 30 min" | | Script | Rolle | Status |
| Gemini TUI bridge | "Chat med Gemini i terminalen — ingen nettleser" | |--------|-------|--------|
| vauco-bootstrap | "Nytt GCP-miljø fra null til live — automatisk" | | `00-authcheck.sh` | Verifiser gcloud-innlogging | Klar |
| `01-setupenv.sh` | Aktiver APIs, SA, IAM, budsjett | Klar |
| `02-deploy.sh` | IAP-deploy på eget domene | Klar |
| `03-teardown.sh` | Riv ned Cloud Run | Klar |
| `04-observability-setup.sh` | Monitoring + alerting | Klar |
| `05-cloudrun-deploy.sh` | ADK-agent til Cloud Run | Klar |
| `06-cicd-setup.sh` | GitHub → Cloud Build | Klar |
| `07-rag-setup.sh` | RAG Engine corpus + fallback | Oppdatert |
| `08-memorybank-setup.sh` | Memory Bank + auto-install | Oppdatert |
--- ---
## HURTIGKOMMANDOER — bruk i alle fremtidige tråder ## BEKREFTET GA-API
**Gjenoppta sesjon:** | API | Status | Bekreftet fra |
> "Act as OSVauco-NMTMD-GCOS. Resume from [FASE X / STEG Y]. Repo: chrischristiansen-glitch/OSVauco. Project: propane-will-491900-m5, Region: us-central1. Follow HITL, 50k credit budget, 7d progress reporting." |-----|--------|---------------|
**Statusrapport:**
> "Give me an OSVauco Status Report using the 7c template."
**Fortsett uten pause:**
> "Start a new browsing phase under the current 50 000-credit budget and continue the plan."
**Hång / 404:**
> "Skip the current page/URL, log it as invalid source, and continue the plan using other sources."
**Push til repo:**
> "Push [filnavn] directly to chrischristiansen-glitch/OSVauco on branch main."
---
## HUSKELISTE — Viktige valg
| Valg | Hvorfor |
|---|---|
| `us-central1` alltid | ALDRI `us-west1` — låst i AGENT_RULEBOOK |
| `gemini-2.0-flash` | Rask og billig |
| `google.adk.Agent` (ikke LlmAgent) | Bekreftet GA-API | | `google.adk.Agent` (ikke LlmAgent) | Bekreftet GA-API |
| `load_memory_tool` | Bekreftet fra adk-python samples | | `load_memory_tool` | Bekreftet fra adk-python samples |
| CMEK ikke for RAG Engine | Ikke støttet (OQ-03) | | CMEK ikke for RAG Engine | Ikke støttet (OQ-03) |
@ -111,11 +148,11 @@ Du er første kunde. Når det virker for deg → selg det til andre.
| Scenario | Kostnad/mnd | | Scenario | Kostnad/mnd |
|---|---| |---|---|
| Bare deg (dev, teardown daglig) | ~$25–75 | | Bare deg (dev, teardown daglig) | ~$25-75 |
| 1 betalende kunde (lett prod) | ~$115–280 | | 1 betalende kunde (lett prod) | ~$115-280 |
| Medioteq-type (klinisk, compliance) | ~$220–350 | | Medioteq-type (klinisk, compliance) | ~$220-350 |
Breakeven: 1 kunde til $300–500/mnd dekker alle kostnader. Breakeven: 1 kunde til $300-500/mnd dekker alle kostnader.
Ikke bygg kost-analyse-system nå — spør agenten når GCP er oppe. Ikke bygg kost-analyse-system nå — spør agenten når GCP er oppe.
--- ---
@ -125,10 +162,10 @@ Ikke bygg kost-analyse-system nå — spør agenten når GCP er oppe.
| ID | Hva | Workaround | | ID | Hva | Workaround |
|---|---|---| |---|---|---|
| OQ-01 | Memory Bank — ingen gcloud CLI | Python SDK only | | OQ-01 | Memory Bank — ingen gcloud CLI | Python SDK only |
| OQ-02 | RAG Engine regional availability | Default us-central1 | | OQ-02 | RAG Engine regional availability | Auto-fallback til us-east1 |
| OQ-03 | CMEK ikke for RAG Engine | VPC-SC only | | OQ-03 | CMEK ikke for RAG Engine | VPC-SC only |
| OQ-04 | Cloud Build GitHub OAuth | Manuelt i Console | | OQ-04 | Cloud Build GitHub OAuth | Manuelt i Console |
| OQ-05 | gcloud alpha monitoring ustabil | Fallback || true | | OQ-05 | gcloud alpha monitoring ustabil | Fallback til true |
| OQ-06 | Memory Bank auto-discovery | Eksplisitt env var | | OQ-06 | Memory Bank auto-discovery | Eksplisitt env var |
| OQ-07 | Monitoring email flag-format | Teste i dev | | OQ-07 | Monitoring email flag-format | Teste i dev |
| OQ-08 | VPC connector e2-micro regional | Default us-central1 | | OQ-08 | VPC connector e2-micro regional | Default us-central1 |