docs(MASTERPLAN): add Cloud Shell Quick-Start, update OQ-02 workaround, infra status table
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:
GitHub
parent
fb9113cd62
commit
7575ee3844
133
MASTERPLAN.md
133
MASTERPLAN.md
|
|
@ -1,6 +1,7 @@
|
|||
# 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)
|
||||
|
||||
**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
|
||||
ORCHESTRATOR_MODEL=gemini-2.0-flash
|
||||
SUBAGENT_MODEL=gemini-2.0-flash
|
||||
|
||||
[ ] A2 — bash infrastructure/00-authcheck.sh
|
||||
[ ] A3 — bash infrastructure/01-setupenv.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
|
||||
OQ-01: Python SDK only (auto-installert av script)
|
||||
ACTION: Kopier MEMORY_ENGINE_NAME til .env
|
||||
[ ] A6 — bash infrastructure/05-cloudrun-deploy.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
|
||||
**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)
|
||||
[ ] B2 — bash infrastructure/06-cicd-setup.sh (GitHub → Cloud Build)
|
||||
OBS: Krever manuelt steg i GCP Console for GitHub OAuth
|
||||
[ ] B1 — bash infrastructure/02-deploy.sh (IAP på opax.vauco.no)
|
||||
[ ] B2 — bash infrastructure/06-cicd-setup.sh
|
||||
OQ-04: GitHub OAuth må settes opp manuelt i GCP Console
|
||||
https://console.cloud.google.com/cloud-build/triggers
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
[ ] C2 — Pakk vauco-os som kundens grensesnitt
|
||||
[ ] C1 — Pakk `vauco-bootstrap` som onboardingprodukt
|
||||
[ ] C2 — Pakk `vauco-os` som kundeflate
|
||||
[ ] C3 — Første kunde: Medioteq (europe-north1, separat GCP-prosjekt)
|
||||
```
|
||||
|
||||
**Salgspitch per modul:**
|
||||
| Modul | Pitch |
|
||||
|---|---|
|
||||
| OPAX-MCP | "AI-assistent som driver GCP-infrastrukturen din — uten DevOps" |
|
||||
| vauco-os | "Ferdig AI-operativsystem for din bedrift — oppe på 30 min" |
|
||||
| Gemini TUI bridge | "Chat med Gemini i terminalen — ingen nettleser" |
|
||||
| vauco-bootstrap | "Nytt GCP-miljø fra null til live — automatisk" |
|
||||
---
|
||||
|
||||
## INFRASTRUKTUR
|
||||
|
||||
| Script | Rolle | Status |
|
||||
|--------|-------|--------|
|
||||
| `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:**
|
||||
> "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 |
|
||||
| API | Status | Bekreftet fra |
|
||||
|-----|--------|---------------|
|
||||
| `google.adk.Agent` (ikke LlmAgent) | Bekreftet GA-API |
|
||||
| `load_memory_tool` | Bekreftet fra adk-python samples |
|
||||
| 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 |
|
||||
|---|---|
|
||||
| Bare deg (dev, teardown daglig) | ~$25–75 |
|
||||
| 1 betalende kunde (lett prod) | ~$115–280 |
|
||||
| Medioteq-type (klinisk, compliance) | ~$220–350 |
|
||||
| Bare deg (dev, teardown daglig) | ~$25-75 |
|
||||
| 1 betalende kunde (lett prod) | ~$115-280 |
|
||||
| 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.
|
||||
|
||||
---
|
||||
|
|
@ -125,10 +162,10 @@ Ikke bygg kost-analyse-system nå — spør agenten når GCP er oppe.
|
|||
| ID | Hva | Workaround |
|
||||
|---|---|---|
|
||||
| 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-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-07 | Monitoring email flag-format | Teste i dev |
|
||||
| OQ-08 | VPC connector e2-micro regional | Default us-central1 |
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user