docs: add MASTERPLAN.md — Fase A/B/C, hurtigkommandoer, kostnader
Added a comprehensive master plan for the VAUCO project, detailing phases, tasks, and operational costs.
This commit is contained in:
GitHub
parent
4814447da4
commit
7e0f01063e
139
MASTERPLAN.md
Normal file
139
MASTERPLAN.md
Normal file
|
|
@ -0,0 +1,139 @@
|
||||||
|
# VAUCO MASTERPLAN — Chris Christiansen
|
||||||
|
**Sist oppdatert: 2026-05-23 03:00 CEST**
|
||||||
|
**Status: Repo ferdig — GCP gjenstår**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## KONTEKST — Hva vi bygger
|
||||||
|
|
||||||
|
Ett AI-drevet operativsystem (OPAX) som kjører på Google Cloud.
|
||||||
|
Du er første kunde. Når det virker for deg → selg det til andre.
|
||||||
|
|
||||||
|
**Repo-oversikt:**
|
||||||
|
| Repo | Hva det er |
|
||||||
|
|---|---|
|
||||||
|
| `OSVauco` | Regler, GCP-scripts, agenter, docs — KJERNEN |
|
||||||
|
| `vauco-gemini-tui-bridge` | Din TUI-cockpit |
|
||||||
|
| `vauco-os` | Det kundene bruker |
|
||||||
|
| `vauco-bootstrap` | Onboarding av nye kunder |
|
||||||
|
| `deep-dream` | Strategisk visjon — aldri deploy herfra |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## FASE A — Ferdigstill kjernen (GCP oppe)
|
||||||
|
**Mål: Agenten din er live på Google Cloud | Tid: Ca. 2 timer**
|
||||||
|
|
||||||
|
```
|
||||||
|
[ ] A1 — cp .env.example .env og fyll inn verdier
|
||||||
|
PROJECT_ID=propane-will-491900-m5
|
||||||
|
REGION=us-central1
|
||||||
|
BILLING_ACCOUNT_ID=0171F6-057E6B-A260BA
|
||||||
|
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
|
||||||
|
[ ] A5 — bash infrastructure/08-memorybank-setup.sh
|
||||||
|
[ ] A6 — bash infrastructure/05-cloudrun-deploy.sh
|
||||||
|
[ ] A7 — bash infrastructure/04-observability-setup.sh
|
||||||
|
[ ] 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**
|
||||||
|
|
||||||
|
```
|
||||||
|
[ ] 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
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## FASE C — Første salgsmodul
|
||||||
|
**Mål: Ny kunde oppe på 30 minutter | Tid: Ukesarbeid**
|
||||||
|
|
||||||
|
```
|
||||||
|
[ ] C1 — Pakk vauco-bootstrap som onboarding-produkt
|
||||||
|
[ ] C2 — Pakk vauco-os som kundens grensesnitt
|
||||||
|
[ ] 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" |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## HURTIGKOMMANDOER — bruk i alle fremtidige tråder
|
||||||
|
|
||||||
|
**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 |
|
||||||
|
| `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) |
|
||||||
|
| CI/CD `--no-traffic` | Manuell trafikkbytte — HITL |
|
||||||
|
| Idempotente scripts | Trygt å kjøre flere ganger |
|
||||||
|
| `03-teardown.sh` hver kveld | Agent Runtimes koster 24/7 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## DRIFTSKOSTNADER
|
||||||
|
|
||||||
|
| Scenario | Kostnad/mnd |
|
||||||
|
|---|---|
|
||||||
|
| 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.
|
||||||
|
Ikke bygg kost-analyse-system nå — spør agenten når GCP er oppe.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## KJENTE HULL
|
||||||
|
|
||||||
|
| ID | Hva | Workaround |
|
||||||
|
|---|---|---|
|
||||||
|
| OQ-01 | Memory Bank — ingen gcloud CLI | Python SDK only |
|
||||||
|
| OQ-02 | RAG Engine regional availability | Default us-central1 |
|
||||||
|
| 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-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 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*OSVauco-NMTMD-GCOS | propane-will-491900-m5 | us-central1*
|
||||||
|
*GitHub: chrischristiansen-glitch/OSVauco*
|
||||||
Loading…
Reference in New Issue
Block a user